Your IP : 216.73.216.189
#!/usr/bin/env php
<?php
Phar::mapPhar('phpstan.phar');
require 'phar://phpstan.phar/bin/phpstan';
__HALT_COMPILER(); ?>
�� o conf/config.stubValidator.neon- �+g- ��k� conf/parametersSchema.neon� �+g� ��9A� conf/config.level6.neon� �+g� ?��~� conf/config.level3.neonF �+gF ��D~� conf/config.level7.neonY �+gY ^b�Z� conf/config.level0.neon<+ �+g<+ {0�ޤ conf/config.level5.neonB �+gB ��O'� conf/config.level2.neon� �+g�
��<� conf/config.level4.neon�- �+g�- 'ϟ � conf/config.level1.neon� �+g� �?�$� conf/config.level9.neonH �+gH �u�� conf/config.levelmax.neon! �+g! � h� conf/bleedingEdge.neon� �+g� ��D� conf/config.level8.neonD �+gD s�Jc� conf/config.neon� �+g� �Po9� 1 resources/functionMap_php80delta_bleedingEdge.php� �+g� E�.� $ resources/functionMap_php83delta.php� �+g� �5F� $ resources/functionMap_php82delta.php� �+g� Hb� & resources/functionMap_bleedingEdge.phpWL �+gWL O��� $ resources/functionMap_php74delta.phpA �+gA z1X-� resources/functionMetadata.php[ �+g[ >I� resources/functionMap.phpv �+gv );�m� resources/RegexGrammar.pp� �+g� �0� $ resources/functionMap_php84delta.php �+g .{�\� $ resources/functionMap_php81delta.php� �+g� 6�� $ resources/functionMap_php80delta.php�i �+g�i �Ό� bin/phpstan �+g �@L�� src/File/FileExcluder.php^ �+g^ �:UH� . src/File/ParentDirectoryRelativePathHelper.php� �+g� �Bh�� src/File/FileFinderResult.phpZ �+gZ �{� # src/File/NullRelativePathHelper.php� �+g� z�� $ src/File/FuzzyRelativePathHelper.phpP �+gP � src/File/FileHelper.php� �+g� �o�[� & src/File/CouldNotReadFileException.php� �+g� x1g� % src/File/SimpleRelativePathHelper.php. �+g. �cq� 3 src/File/SystemAgnosticSimpleRelativePathHelper.php� �+g� ���ͤ src/File/FileWriter.php� �+g� R���� ' src/File/CouldNotWriteFileException.php� �+g� � �� src/File/FileExcluderFactory.phpK �+gK �[� # src/File/FileExcluderRawFactory.php� �+g� ) f�� src/File/RelativePathHelper.php� �+g� ��+l� src/File/FileMonitorResult.php� �+g� �.� " src/File/PathNotFoundException.php� �+g� OJ5�� src/File/FileMonitor.php� �+g� 9,*� src/File/FileFinder.php� �+g� ��� src/File/FileReader.php �+g BW�ͤ src/autoloadFunctions.php� �+g� �Ѥ 9 src/Rules/Functions/MissingFunctionReturnTypehintRule.php
�+g
�8�:� . src/Rules/Functions/FunctionAttributesRule.php �+g ��� ? src/Rules/Functions/InvalidLexicalVariablesInClosureUseRule.php� �+g� d�u�� + src/Rules/Functions/ImplodeFunctionRule.php
�+g
C�R�� 4 src/Rules/Functions/CallToFunctionParametersRule.php�
�+g�
-�l� < src/Rules/Functions/IncompatibleDefaultParameterTypeRule.php� �+g� �ƈ�� < src/Rules/Functions/ArrowFunctionReturnNullsafeByRefRule.php� �+g� 6 � � 5 src/Rules/Functions/ParameterCastableToStringRule.php�
�+g�
��鸤 E src/Rules/Functions/CallToFunctionStatementWithoutSideEffectsRule.phpH �+gH �'�>� 1 src/Rules/Functions/PrintfArrayParametersRule.php� �+g� ۤ - src/Rules/Functions/ClosureReturnTypeRule.php@ �+g@ f��n� 6 src/Rules/Functions/UselessFunctionReturnValueRule.php� �+g� h�5� / src/Rules/Functions/RandomIntParametersRule.php� �+g� ����� - src/Rules/Functions/ClosureAttributesRule.php �+g 7f�9� ' src/Rules/Functions/ArrayFilterRule.php� �+g� ;.�Ӥ = src/Rules/Functions/ExistingClassesInClosureTypehintsRule.php\ �+g\ �(�l� 3 src/Rules/Functions/ArrowFunctionAttributesRule.php �+g m�0� ) src/Rules/Functions/CallCallablesRule.phpP �+gP ��� C src/Rules/Functions/ExistingClassesInArrowFunctionTypehintsRule.php� �+g� �U�$� , src/Rules/Functions/DefineParametersRule.php� �+g� x�� � ' src/Rules/Functions/ArrayValuesRule.phpT �+gT ��.� 3 src/Rules/Functions/ArrowFunctionReturnTypeRule.php� �+g� \�M� & src/Rules/Functions/ReturnTypeRule.php( �+g( t$7Ϥ 9 src/Rules/Functions/SortParameterCastableToStringRule.php �+g 2%l{� / src/Rules/Functions/RedefinedParametersRule.php� �+g� 4�� + src/Rules/Functions/ParamAttributesRule.php� �+g� g�$Ϥ , src/Rules/Functions/PrintfParametersRule.phps
�+gs
�G� C src/Rules/Functions/IncompatibleClosureDefaultParameterTypeRule.php� �+g� W�)�� $ src/Rules/Functions/PrintfHelper.php@ �+g@ '�ͦ� < src/Rules/Functions/ImplodeParameterCastableToStringRule.php�
�+g�
����� 5 src/Rules/Functions/CallToNonExistentFunctionRule.php' �+g' ���.� ( src/Rules/Functions/CallUserFuncRule.php� �+g� �K� / src/Rules/Functions/ReturnNullsafeByRefRule.phpZ �+gZ �ן�� 9 src/Rules/Functions/VariadicParametersDeclarationRule.php2 �+g2 �k�� 6 src/Rules/Functions/ExistingClassesInTypehintsRule.php� �+g� ���Τ - src/Rules/Functions/UnusedClosureUsesRule.php� �+g� ���M� I src/Rules/Functions/IncompatibleArrowFunctionDefaultParameterTypeRule.php� �+g� �D�� , src/Rules/Functions/FunctionCallableRule.php� �+g� � �֤ 8 src/Rules/Functions/DuplicateFunctionDeclarationRule.php� �+g� 7ҭ� < src/Rules/Functions/MissingFunctionParameterTypehintRule.php� �+g� �{�� ) src/Rules/Functions/InnerFunctionRule.phpe �+ge E��l� % src/Rules/ClassForbiddenNameCheck.php� �+g� �=s� src/Rules/FileRuleError.php� �+g� !�v� - src/Rules/Keywords/DeclareStrictTypesRule.php� �+g� �[�B� . src/Rules/Keywords/ContinueBreakInLoopRule.php� �+g� �0�r� , src/Rules/Keywords/RequireFileExistsRule.php �+g �(�� 7 src/Rules/Api/PhpStanNamespaceIn3rdPartyPackageRule.php� �+g� Ӓ Ӥ ) src/Rules/Api/ApiInterfaceExtendsRule.php) �+g) z�6ݤ ( src/Rules/Api/ApiClassConstFetchRule.phpf �+gf �_2z� 5 src/Rules/Api/NodeConnectingVisitorAttributesRule.php�
�+g�
`�b� % src/Rules/Api/ApiClassExtendsRule.php� �+g� �R� & src/Rules/Api/ApiInstantiationRule.php� �+g� �ױ� ! src/Rules/Api/ApiTraitUseRule.php� �+g� �L� & src/Rules/Api/BcUncoveredInterface.php� �+g� �� ٤ ( src/Rules/Api/ApiClassImplementsRule.php+ �+g+ ��Y�� / src/Rules/Api/RuntimeReflectionFunctionRule.php �+g �U
� # src/Rules/Api/ApiStaticCallRule.php� �+g� ����� src/Rules/Api/ApiRuleHelper.phph �+gh ��1J� # src/Rules/Api/ApiMethodCallRule.php>
�+g>
+`|�� ' src/Rules/Api/ApiInstanceofTypeRule.php� �+g� �H�� % src/Rules/Api/GetTemplateTypeRule.php� �+g� ��� 4 src/Rules/Api/RuntimeReflectionInstantiationRule.php:
�+g:
Mh%� # src/Rules/Api/ApiInstanceofRule.php[ �+g[ �jlZ� % src/Rules/FunctionReturnTypeCheck.phpP �+gP Ȯ��� + src/Rules/UnusedFunctionParametersCheck.php�
�+g�
ʐ�Ԥ src/Rules/Registry.phpj �+gj z�쿤 ) src/Rules/Ignore/IgnoreParseErrorRule.phpB �+gB b�-� src/Rules/MetadataRuleError.php� �+g� ��h� ) src/Rules/FunctionCallParametersCheck.phpmd �+gmd k��� / src/Rules/Arrays/OffsetAccessAssignmentRule.php�
�+g�
:� �� 9 src/Rules/Arrays/OffsetAccessWithoutDimForReadingRule.php� �+g� �?� . src/Rules/Arrays/InvalidKeyInArrayItemRule.php� �+g� >Zf�� . src/Rules/Arrays/UnpackIterableInArrayRule.php� �+g� r���� 9 src/Rules/Arrays/NonexistentOffsetInArrayDimFetchRule.php�
�+g�
r}{o� ' src/Rules/Arrays/ArrayUnpackingRule.phpg �+gg ��⩤ + src/Rules/Arrays/ArrayDestructuringRule.phpZ
�+gZ
�1s� 4 src/Rules/Arrays/OffsetAccessValueAssignmentRule.php
�+g
U�V� $ src/Rules/Arrays/DeadForeachRule.php �+g A�Ȥ - src/Rules/Arrays/OffsetAccessAssignOpRule.php�
�+g�
,7(� 2 src/Rules/Arrays/InvalidKeyInArrayDimFetchRule.php �+g M� 5 src/Rules/Arrays/DuplicateKeysInLiteralArraysRule.phpi �+gi
�P�� * src/Rules/Arrays/AllowedArrayKeysTypes.php{ �+g{ ~�mB� * src/Rules/Arrays/IterableInForeachRule.phpB �+gB pz��� . src/Rules/Arrays/AppendedArrayItemTypeRule.php�
�+g�
�ģ�� - src/Rules/Arrays/AppendedArrayKeyTypeRule.php�
�+g�
��e� ' src/Rules/Arrays/EmptyArrayItemRule.php: �+g: �Yr:� : src/Rules/Arrays/NonexistentOffsetInArrayDimFetchCheck.php �+g y��� + src/Rules/Variables/VariableCloningRule.php� �+g� ��-� 8 src/Rules/Variables/ParameterOutExecutionEndTypeRule.php� �+g� jt�� ! src/Rules/Variables/IssetRule.php� �+g� �� ! src/Rules/Variables/EmptyRule.phpU �+gU ��eR� 4 src/Rules/Variables/ParameterOutAssignedTypeRule.php�
�+g�
�@�� + src/Rules/Variables/DefinedVariableRule.php� �+g� ��^ɤ % src/Rules/Variables/ThrowTypeRule.phpQ �+gQ ���O� ! src/Rules/Variables/UnsetRule.php� �+g� S�Y5� ( src/Rules/Variables/NullCoalesceRule.php� �+g� 1�T[� , src/Rules/Variables/CompactVariablesRule.php�
�+g�
���A� * src/Rules/Classes/LocalTypeAliasesRule.php� �+g� U�G}� 5 src/Rules/Classes/UnusedConstructorParametersRule.php� �+g� ��� ( src/Rules/Classes/RequireExtendsRule.php� �+g� ә�i� 2 src/Rules/Classes/LocalTypeTraitUseAliasesRule.php �+g �_v� ; src/Rules/Classes/ExistingClassesInInterfaceExtendsRule.php �+g '2�1� - src/Rules/Classes/PropertyTagTraitUseRule.php �+g w�bv� 1 src/Rules/Classes/ExistingClassInTraitUseRule.php�
�+g�
BկԤ # src/Rules/Classes/NewStaticRule.php� �+g� O��� ( src/Rules/Classes/MethodTagTraitRule.php� �+g� jy�K� src/Rules/Classes/MixinRule.php� �+g� c��� % src/Rules/Classes/PropertyTagRule.php� �+g� �?� 1 src/Rules/Classes/ClassConstantAttributesRule.php$ �+g$ � �p� & src/Rules/Classes/PropertyTagCheck.php\' �+g\'
�9� 3 src/Rules/Classes/DuplicateClassDeclarationRule.php �+g 1=L�� # src/Rules/Classes/MethodTagRule.php� �+g� �F��� ' src/Rules/Classes/ClassConstantRule.php� �+g� ��`ä $ src/Rules/Classes/EnumSanityRule.php^ �+g^ ��8� / src/Rules/Classes/InstantiationCallableRule.php� �+g� ݦ�� $ src/Rules/Classes/MixinTraitRule.phpw �+gw ���� ) src/Rules/Classes/AllowedSubTypesRule.php �+g 7�D� / src/Rules/Classes/LocalTypeTraitAliasesRule.php� �+g� �{ج� src/Rules/Classes/MixinCheck.php� �+g� ��߫� - src/Rules/Classes/TraitAttributeClassRule.phpP �+gP �E\w� * src/Rules/Classes/PropertyTagTraitRule.php� �+g� ���� < src/Rules/Classes/AccessPrivateConstantThroughStaticRule.php� �+g� ⌵� + src/Rules/Classes/MethodTagTraitUseRule.php� �+g� )D� 5 src/Rules/Classes/ExistingClassInClassExtendsRule.php+ �+g+ "Pw-� + src/Rules/Classes/LocalTypeAliasesCheck.php6; �+g6; (��u� . src/Rules/Classes/ImpossibleInstanceOfRule.php� �+g� wO� 9 src/Rules/Classes/ExistingClassesInEnumImplementsRule.php�
�+g�
aV� ' src/Rules/Classes/ReadOnlyClassRule.php� �+g� �iB� 0 src/Rules/Classes/NonClassAttributeClassRule.phpf �+gf -�Y�� ' src/Rules/Classes/MixinTraitUseRule.php� �+g� �~�� $ src/Rules/Classes/MethodTagCheck.phpH/ �+gH/ }��9� + src/Rules/Classes/RequireImplementsRule.php� �+g� ���ʤ 3 src/Rules/Classes/InvalidPromotedPropertiesRule.php
�+g
cؕ�� ' src/Rules/Classes/InstantiationRule.php $ �+g $ �f�X� ) src/Rules/Classes/ClassAttributesRule.php �+g ��+y� : src/Rules/Classes/ExistingClassesInClassImplementsRule.php5 �+g5 ^�.�� . src/Rules/Classes/DuplicateDeclarationRule.php� �+g� / �� 3 src/Rules/Classes/ExistingClassInInstanceOfRule.php�
�+g�
@�.�� ! src/Rules/Names/UsedNamesRule.php� �+g� v�� . src/Rules/EnumCases/EnumCaseAttributesRule.php �+g 8]�*� ! src/Rules/Pure/PureMethodRule.php �+g ��h � & src/Rules/Pure/FunctionPurityCheck.php
�+g
��[�� # src/Rules/Pure/PureFunctionRule.php� �+g� >Ehe� 1 src/Rules/Regexp/RegularExpressionQuotingRule.php� �+g� �]pĤ 1 src/Rules/Regexp/RegularExpressionPatternRule.php� �+g� )�<� src/Rules/RuleError.php� �+g� t@�Ф 9 src/Rules/Constants/AlwaysUsedClassConstantsExtension.php� �+g� ޡr� 8 src/Rules/Constants/MissingClassConstantTypehintRule.phpE �+gE
��ݤ E src/Rules/Constants/LazyAlwaysUsedClassConstantsExtensionProvider.php! �+g! �j�� $ src/Rules/Constants/ConstantRule.php� �+g� o^ک� 5 src/Rules/Constants/DynamicClassConstantFetchRule.php� �+g� 0�a�� 0 src/Rules/Constants/MagicConstantContextRule.phpv �+gv ɺ�� 8 src/Rules/Constants/ValueAssignedToClassConstantRule.php� �+g� ��Y� . src/Rules/Constants/OverridingConstantRule.php �+g Z�k� 4 src/Rules/Constants/NativeTypedClassConstantRule.php �+g x�L� A src/Rules/Constants/AlwaysUsedClassConstantsExtensionProvider.phpE �+gE R��?� ) src/Rules/Constants/FinalConstantRule.php� �+g� a2��� src/Rules/IssetCheck.php/ �+g/ �c쑤 2 src/Rules/Comparison/ImpossibleCheckTypeHelper.php"F �+g"F E�xǤ : src/Rules/Comparison/ImpossibleCheckTypeMethodCallRule.php� �+g� {��� 8 src/Rules/Comparison/BooleanNotConstantConditionRule.php� �+g� ��Y]� 7 src/Rules/Comparison/BooleanOrConstantConditionRule.php� �+g�
k�b� 4 src/Rules/Comparison/ConstantLooseComparisonRule.php� �+g� Du Ӥ @ src/Rules/Comparison/ImpossibleCheckTypeStaticMethodCallRule.php� �+g� S��� < src/Rules/Comparison/ImpossibleCheckTypeFunctionCallRule.php� �+g� 8|�Ф 0 src/Rules/Comparison/IfConstantConditionRule.php� �+g� �E�W� 7 src/Rules/Comparison/UsageOfVoidMatchExpressionRule.php" �+g" ���� = src/Rules/Comparison/TernaryOperatorConstantConditionRule.php� �+g� 2< � G src/Rules/Comparison/NumberComparisonOperatorsConstantConditionRule.phpp �+gp ,� � 9 src/Rules/Comparison/DoWhileLoopConstantConditionRule.php� �+g� E�b� 4 src/Rules/Comparison/ConstantConditionRuleHelper.php� �+g� k��� 4 src/Rules/Comparison/ElseIfConstantConditionRule.php� �+g� ��� 8 src/Rules/Comparison/BooleanAndConstantConditionRule.php� �+g� ��� = src/Rules/Comparison/StrictComparisonOfDifferentTypesRule.phpc �+gc \�� 9 src/Rules/Comparison/UnreachableTernaryElseBranchRule.php� �+g� �^� 2 src/Rules/Comparison/UnreachableIfBranchesRule.php
�+g
cI�K� 9 src/Rules/Comparison/WhileLoopAlwaysTrueConditionRule.php� �+g� x�8c� 8 src/Rules/Comparison/LogicalXorConstantConditionRule.php �+g ��I� : src/Rules/Comparison/WhileLoopAlwaysFalseConditionRule.php2 �+g2 �P4�� , src/Rules/Comparison/MatchExpressionRule.php> �+g> �Y(@� % src/Rules/FunctionDefinitionCheck.php�e �+g�e $�T � ! src/Rules/IdentifierRuleError.php� �+g� MT3� ' src/Rules/ClassCaseSensitivityCheck.php� �+g� �P�� 6 src/Rules/Operators/InvalidComparisonOperationRule.php �+g �� 2 src/Rules/Operators/InvalidBinaryOperationRule.php# �+g# '8�P� , src/Rules/Operators/InvalidAssignVarRule.php
�+g
��[�� 2 src/Rules/Operators/InvalidIncDecOperationRule.php� �+g� n)iĤ 1 src/Rules/Operators/InvalidUnaryOperationRule.php� �+g� ��U`� src/Rules/NullsafeCheck.php� �+g� �ì�� / src/Rules/Namespaces/ExistingNamesInUseRule.phph �+gh I��� 4 src/Rules/Namespaces/ExistingNamesInGroupUseRule.php� �+g� 6�� ' src/Rules/Missing/MissingReturnRule.phpp �+gp ��6� , src/Rules/ParameterCastableToStringCheck.phpj �+gj � L� src/Rules/DirectRegistry.php� �+g� w��� src/Rules/TipRuleError.php� �+g� ��|� # src/Rules/RuleErrors/RuleError5.php� �+g� k��*� $ src/Rules/RuleErrors/RuleError95.php* �+g* �&�J� $ src/Rules/RuleErrors/RuleError99.php3 �+g3 ?��� $ src/Rules/RuleErrors/RuleError71.php� �+g� Ⳡ�� $ src/Rules/RuleErrors/RuleError37.php� �+g� �b
�� % src/Rules/RuleErrors/RuleError107.php� �+g� U)��� % src/Rules/RuleErrors/RuleError119.php_ �+g_ y��� # src/Rules/RuleErrors/RuleError3.php �+g ��``� $ src/Rules/RuleErrors/RuleError35.php� �+g� h��"� $ src/Rules/RuleErrors/RuleError65.php� �+g� ��<� $ src/Rules/RuleErrors/RuleError75.php� �+g� 䎀� % src/Rules/RuleErrors/RuleError111.php< �+g< g0!:� $ src/Rules/RuleErrors/RuleError53.phpp �+gp J�*� $ src/Rules/RuleErrors/RuleError47.php� �+g� ��1� $ src/Rules/RuleErrors/RuleError23.php; �+g; �[D�� $ src/Rules/RuleErrors/RuleError73.phpQ �+gQ U�q<� $ src/Rules/RuleErrors/RuleError33.phpE �+gE �
�M� % src/Rules/RuleErrors/RuleError127.php �+g �V`L� $ src/Rules/RuleErrors/RuleError25.php� �+g� -�$Ť $ src/Rules/RuleErrors/RuleError69.php� �+g� R%�� % src/Rules/RuleErrors/RuleError121.php �+g 2�
ܤ $ src/Rules/RuleErrors/RuleError15.php �+g �� �� % src/Rules/RuleErrors/RuleError117.php� �+g� �d>� $ src/Rules/RuleErrors/RuleError61.php �+g ��yY� $ src/Rules/RuleErrors/RuleError57.php� �+g� c�� � $ src/Rules/RuleErrors/RuleError79.phpX �+gX Y *�� % src/Rules/RuleErrors/RuleError123.php� �+g� ��� % src/Rules/RuleErrors/RuleError115.php �+g ��
|� % src/Rules/RuleErrors/RuleError125.php` �+g` ��+�� # src/Rules/RuleErrors/RuleError9.php �+g q&�� $ src/Rules/RuleErrors/RuleError77.php� �+g� �FTФ $ src/Rules/RuleErrors/RuleError39.phpL �+gL �� �� $ src/Rules/RuleErrors/RuleError31.php� �+g� ��ȵ� $ src/Rules/RuleErrors/RuleError83.php" �+g" ��S� $ src/Rules/RuleErrors/RuleError45.phpM �+gM ��;�� % src/Rules/RuleErrors/RuleError109.php� �+g� ��6:� $ src/Rules/RuleErrors/RuleError41.php� �+g� y{z�� % src/Rules/RuleErrors/RuleError113.phpX �+gX kOȜ� % src/Rules/RuleErrors/RuleError105.php5 �+g5 �b0�� $ src/Rules/RuleErrors/RuleError63.php� �+g� iL �� % src/Rules/RuleErrors/RuleError101.php� �+g� �ޮx� $ src/Rules/RuleErrors/RuleError97.php� �+g�
�B� $ src/Rules/RuleErrors/RuleError21.php� �+g� R#x�� $ src/Rules/RuleErrors/RuleError81.phpt �+gt ȃ�e� $ src/Rules/RuleErrors/RuleError13.phpj �+gj ���Ť $ src/Rules/RuleErrors/RuleError87.php{ �+g{ �oY� $ src/Rules/RuleErrors/RuleError27.php� �+g� �G:� $ src/Rules/RuleErrors/RuleError29.php< �+g< F��� # src/Rules/RuleErrors/RuleError7.phph �+gh <O.ɤ $ src/Rules/RuleErrors/RuleError51.php� �+g� �0�� $ src/Rules/RuleErrors/RuleError19.php� �+g� .~�U� $ src/Rules/RuleErrors/RuleError49.php �+g +ݫ`� # src/Rules/RuleErrors/RuleError1.phpa �+ga �i�~� $ src/Rules/RuleErrors/RuleError91.php� �+g� �
�*� $ src/Rules/RuleErrors/RuleError93.php| �+g| �J
� $ src/Rules/RuleErrors/RuleError89.php# �+g# �l�-� $ src/Rules/RuleErrors/RuleError55.php �+g �t�i� $ src/Rules/RuleErrors/RuleError67.phpP �+gP �Զߤ % src/Rules/RuleErrors/RuleError103.php� �+g� ���� $ src/Rules/RuleErrors/RuleError11.php� �+g� �3�J� $ src/Rules/RuleErrors/RuleError17.php4 �+g4 ȹ� $ src/Rules/RuleErrors/RuleError85.php� �+g� �@9� $ src/Rules/RuleErrors/RuleError43.php� �+g� ��W� $ src/Rules/RuleErrors/RuleError59.phpt �+gt �� 2 src/Rules/Traits/ConflictingTraitConstantsRule.php�# �+g�# $Pפ & src/Rules/Traits/TraitUseCollector.php� �+g� ��8� ) src/Rules/Traits/NotAnalysedTraitRule.php� �+g� x^�*� * src/Rules/Traits/ConstantsInTraitsRule.php* �+g* ��٤ . src/Rules/Traits/TraitDeclarationCollector.php[ �+g[ ��놤 src/Rules/Rule.php� �+g� -�Ӥ 6 src/Rules/DeadCode/PossiblyPureStaticCallCollector.php� �+g� �j�� / src/Rules/DeadCode/UnreachableStatementRule.php� �+g� !� > src/Rules/DeadCode/ConstructorWithoutImpurePointsCollector.php> �+g> D�
�� 0 src/Rules/DeadCode/UnusedPrivatePropertyRule.phpC! �+gC! 5��0� 0 src/Rules/DeadCode/UnusedPrivateConstantRule.phpT �+gT �8K� C src/Rules/DeadCode/CallToMethodStatementWithoutImpurePointsRule.phph �+gh �ʩ� 9 src/Rules/DeadCode/MethodWithoutImpurePointsCollector.phpI �+gI �g�� H src/Rules/DeadCode/CallToConstructorStatementWithoutImpurePointsRule.php� �+g� �B�� src/Rules/DeadCode/NoopRule.php� �+g� �� . src/Rules/DeadCode/UnusedPrivateMethodRule.php� �+g� 2�� E src/Rules/DeadCode/CallToFunctionStatementWithoutImpurePointsRule.php� �+g� |�� / src/Rules/DeadCode/PossiblyPureNewCollector.php3 �+g3 ��٤ 6 src/Rules/DeadCode/PossiblyPureMethodCallCollector.php� �+g� ˒ �� ; src/Rules/DeadCode/FunctionWithoutImpurePointsCollector.php �+g i�� 4 src/Rules/DeadCode/PossiblyPureFuncCallCollector.php� �+g� +fY� I src/Rules/DeadCode/CallToStaticMethodStatementWithoutImpurePointsRule.php� �+g� �u�� % src/Rules/DeadCode/BetterNoopRule.phpK �+gK ���\� src/Rules/LazyRegistry.php� �+g� ���[� B src/Rules/Exceptions/MissingCheckedExceptionInMethodThrowsRule.php� �+g� g� � . src/Rules/Exceptions/ExceptionTypeResolver.php� �+g� �s�� 3 src/Rules/Exceptions/TooWideMethodThrowTypeRule.php� �+g� �_~� , src/Rules/Exceptions/ThrowExpressionRule.php� �+g� �]�� 5 src/Rules/Exceptions/TooWideFunctionThrowTypeRule.phpZ �+gZ Sڱ�� C src/Rules/Exceptions/ThrowsVoidMethodWithExplicitThrowPointRule.php� �+g� /�zh� . src/Rules/Exceptions/NoncapturingCatchRule.php �+g $��� : src/Rules/Exceptions/OverwrittenExitPointByFinallyRule.php$ �+g$ ��9}� 5 src/Rules/Exceptions/CaughtExceptionExistenceRule.php �+g ~�w)� D src/Rules/Exceptions/MissingCheckedExceptionInFunctionThrowsRule.php} �+g} � 煤 5 src/Rules/Exceptions/DefaultExceptionTypeResolver.php� �+g� ���?� = src/Rules/Exceptions/MissingCheckedExceptionInThrowsCheck.php� �+g� �~��� 7 src/Rules/Exceptions/CatchWithUnthrownExceptionRule.phpT �+gT �X�� E src/Rules/Exceptions/ThrowsVoidFunctionWithExplicitThrowPointRule.php� �+g� ӗ�� * src/Rules/Exceptions/ThrowExprTypeRule.phpV �+gV M(K� . src/Rules/Exceptions/TooWideThrowTypeCheck.php� �+g� � VѤ / src/Rules/Methods/ConsistentConstructorRule.php6 �+g6 �>�Ф = src/Rules/Methods/DirectAlwaysUsedMethodExtensionProvider.php �+g �A�� , src/Rules/Methods/FinalPrivateMethodRule.php �+g �'ߙ� 5 src/Rules/Methods/MethodParameterComparisonHelper.php�8 �+g�8 ��?� 5 src/Rules/Methods/MissingMethodReturnTypehintRule.php �+g g7�� : src/Rules/Methods/IncompatibleDefaultParameterTypeRule.php �+g ��� : src/Rules/Methods/AbstractMethodInNonAbstractClassRule.phpS �+gS �� 5 src/Rules/Methods/MissingMethodImplementationRule.php� �+g� }�Ť F src/Rules/Methods/CallToConstructorStatementWithoutSideEffectsRule.php� �+g� цꑤ G src/Rules/Methods/CallToStaticMethodStatementWithoutSideEffectsRule.phpI �+gI �� � * src/Rules/Methods/OverridingMethodRule.php�? �+g�? 瑎^� 7 src/Rules/Methods/AlwaysUsedMethodExtensionProvider.php) �+g) ���E� ; src/Rules/Methods/LazyAlwaysUsedMethodExtensionProvider.php� �+g� ���ܤ . src/Rules/Methods/StaticMethodCallableRule.php< �+g< ��n� * src/Rules/Methods/MethodAttributesRule.php �+g � U9� ) src/Rules/Methods/MethodSignatureRule.php\, �+g\, ��� A src/Rules/Methods/CallToMethodStatementWithoutSideEffectsRule.php� �+g� >[Ф / src/Rules/Methods/ConstructorReturnTypeRule.php� �+g� :m��� 8 src/Rules/Methods/MissingMethodParameterTypehintRule.php� �+g� �@�b� 6 src/Rules/Methods/IllegalConstructorMethodCallRule.php� �+g� �x<� 5 src/Rules/Methods/MethodVisibilityInInterfaceRule.php? �+g? ���� $ src/Rules/Methods/ReturnTypeRule.php� �+g� �Dۊ� : src/Rules/Methods/MissingMagicSerializationMethodsRule.php
�+g
)�� / src/Rules/Methods/AlwaysUsedMethodExtension.phpK �+gK �G�e� , src/Rules/Methods/NullsafeMethodCallRule.phpp �+gp �u(Ť 6 src/Rules/Methods/IllegalConstructorStaticCallRule.php� �+g� %g�� % src/Rules/Methods/MethodCallCheck.php� �+g� � �� / src/Rules/Methods/AbstractPrivateMethodRule.php� �+g� ~)��� 2 src/Rules/Methods/MissingMethodSelfOutTypeRule.phpM
�+gM
p~� + src/Rules/Methods/CallStaticMethodsRule.php� �+g� ��ӆ� 4 src/Rules/Methods/ExistingClassesInTypehintsRule.php� �+g� j 3
� + src/Rules/Methods/StaticMethodCallCheck.php�' �+g�' _�P� ( src/Rules/Methods/MethodCallableRule.php �+g ^�oN� 8 src/Rules/Methods/CallPrivateMethodThroughStaticRule.php� �+g� 1y
�� % src/Rules/Methods/CallMethodsRule.php �+g �Wb�� 5 src/Rules/Properties/AccessPropertiesInAssignRule.php� �+g� )��� 2 src/Rules/Properties/NullsafePropertyFetchRule.php
�+g
�:̑� A src/Rules/Properties/LazyReadWritePropertiesExtensionProvider.php �+g �Á� B src/Rules/Properties/DefaultValueTypesAssignedToPropertiesRule.php) �+g) ��[�� 5 src/Rules/Properties/ReadWritePropertiesExtension.php� �+g� ���� / src/Rules/Properties/PropertyAttributesRule.php �+g r��7� 8 src/Rules/Properties/WritingToReadOnlyPropertiesRule.php� �+g� �8Ġ� 5 src/Rules/Properties/ReadOnlyByPhpDocPropertyRule.php� �+g� �۫G� 2 src/Rules/Properties/UninitializedPropertyRule.php� �+g� :UpФ ; src/Rules/Properties/ReadOnlyByPhpDocPropertyAssignRule.php� �+g� �z�� 8 src/Rules/Properties/ExistingClassesInPropertiesRule.php� �+g� �yt�� 1 src/Rules/Properties/PropertyReflectionFinder.php� �+g� ��� - src/Rules/Properties/AccessPropertiesRule.php6 �+g6 ���٤ 6 src/Rules/Properties/ReadOnlyPropertyAssignRefRule.php< �+g< ���� ; src/Rules/Properties/AccessStaticPropertiesInAssignRule.php �+g �.ڤ C src/Rules/Properties/DirectReadWritePropertiesExtensionProvider.phph �+gh � e*� + src/Rules/Properties/PropertyDescriptor.php� �+g� �OVQ� : src/Rules/Properties/MissingReadOnlyPropertyAssignRule.phpO �+gO m��y� 3 src/Rules/Properties/ReadOnlyPropertyAssignRule.php� �+g� �S� = src/Rules/Properties/ReadWritePropertiesExtensionProvider.php. �+g. _���� 0 src/Rules/Properties/FoundPropertyReflection.php0 �+g0 _HĤ 2 src/Rules/Properties/PropertiesInInterfaceRule.php� �+g� �Z鎤 B src/Rules/Properties/MissingReadOnlyByPhpDocPropertyAssignRule.php� �+g� �ź� 6 src/Rules/Properties/TypesAssignedToPropertiesRule.php �+g � >>� / src/Rules/Properties/OverridingPropertyRule.php� �+g� �" ؤ 3 src/Rules/Properties/AccessStaticPropertiesRule.phpE" �+gE" 1u�� 7 src/Rules/Properties/ReadingWriteOnlyPropertiesRule.php� �+g� ��@�� > src/Rules/Properties/ReadOnlyByPhpDocPropertyAssignRefRule.phpx �+gx �1�� 4 src/Rules/Properties/MissingPropertyTypehintRule.phpB �+gB �H�� ? src/Rules/Properties/AccessPrivatePropertyThroughStaticRule.php= �+g= ��uɤ 8 src/Rules/Properties/InvalidCallablePropertyTypeRule.php� �+g� ��h� - src/Rules/Properties/ReadOnlyPropertyRule.php� �+g� �8��� src/Rules/RuleLevelHelper.phpMB �+gMB x�RG� + src/Rules/Types/InvalidTypesInUnionRule.phpL
�+gL
K��0� * src/Rules/Playground/FunctionNeverRule.phpU �+gU ��{٤ ( src/Rules/Playground/NeverRuleHelper.php� �+g� @��.� - src/Rules/Playground/NotAnalysedTraitRule.php� �+g� �Zʆ� & src/Rules/Playground/NoPhpCodeRule.phpV �+gV :E
Ԥ ( src/Rules/Playground/MethodNeverRule.phpw �+gw �]r� src/Rules/FoundTypeResult.php� �+g� h[g� src/Rules/RuleErrorBuilder.php� �+g� ��/� " src/Rules/MissingTypehintCheck.php� �+g� ,�ݤ src/Rules/AttributesCheck.phpk �+gk |�,Ԥ * src/Rules/RuleLevelHelperAcceptsResult.php� �+g� z�J � # src/Rules/NonIgnorableRuleError.php� �+g� 6�y̤ / src/Rules/Generics/FunctionTemplateTypeRule.php� �+g� faI,� , src/Rules/Generics/GenericAncestorsCheck.phpB �+gB o?�� 5 src/Rules/Generics/MethodTagTemplateTypeTraitRule.php+ �+g+ +�\�� - src/Rules/Generics/MethodTemplateTypeRule.php) �+g) �<;� 0 src/Rules/Generics/MethodTagTemplateTypeRule.phpt �+gt ӛ:� 1 src/Rules/Generics/MethodTagTemplateTypeCheck.php�
�+g�
��� % src/Rules/Generics/UsedTraitsRule.php�
�+g�
[�� � + src/Rules/Generics/EnumTemplateTypeRule.php �+g ���� ( src/Rules/Generics/EnumAncestorsRule.phpn
�+gn
�ۻ� , src/Rules/Generics/TraitTemplateTypeRule.phpZ �+gZ �3� , src/Rules/Generics/ClassTemplateTypeRule.php� �+g� �訤 0 src/Rules/Generics/InterfaceTemplateTypeRule.php� �+g� a1�� - src/Rules/Generics/InterfaceAncestorsRule.php�
�+g�
=ps�� 2 src/Rules/Generics/MethodSignatureVarianceRule.php �+g
� 4 src/Rules/Generics/FunctionSignatureVarianceRule.php� �+g� jr2� - src/Rules/Generics/GenericObjectTypeCheck.php �+g �{#I� ( src/Rules/Generics/TemplateTypeCheck.php�& �+g�& �K�=� $ src/Rules/Generics/VarianceCheck.php, �+g, %��6� ) src/Rules/Generics/ClassAncestorsRule.php� �+g� xM7I� 1 src/Rules/Generics/CrossCheckInterfacesHelper.php
�+g
��Ԥ + src/Rules/Generics/PropertyVarianceRule.php� �+g� �?�� + src/Rules/Whitespace/FileWhitespaceRule.php_ �+g_ zc� src/Rules/LineRuleError.php� �+g� �[%7� ' src/Rules/DateTimeInstantiationRule.php/ �+g/ �+^� * src/Rules/Generators/YieldFromTypeRule.php" �+g" �Q�Ҥ - src/Rules/Generators/YieldInGeneratorRule.php" �+g" }!
�� & src/Rules/Generators/YieldTypeRule.phpU �+gU �b� src/Rules/ClassNameCheck.php� �+g� ��cH� src/Rules/Cast/EchoRule.php� �+g� ��v� 2 src/Rules/Cast/InvalidPartOfEncapsedStringRule.php� �+g� �<�� src/Rules/Cast/UnsetCastRule.php �+g �|Ҥ " src/Rules/Cast/InvalidCastRule.php� �+g� (��y� src/Rules/Cast/PrintRule.phpY �+gY Qf�¤ src/Rules/ClassNameNodePair.php �+g �$hͤ " src/Rules/Debug/FileAssertRule.php� �+g� ~��� " src/Rules/Debug/DebugScopeRule.phpH �+gH �� �� & src/Rules/Debug/DumpPhpDocTypeRule.php* �+g* zB� src/Rules/Debug/DumpTypeRule.php� �+g� ��Ӥ 2 src/Rules/PhpDoc/WrongVariableNameInVarTagRule.php�6 �+g�6 l�a� 6 src/Rules/PhpDoc/RequireExtendsDefinitionClassRule.php0 �+g0 �B�F� ( src/Rules/PhpDoc/RequireExtendsCheck.phpD �+gD �5� 4 src/Rules/PhpDoc/VarTagChangedExpressionTypeRule.phph �+gh �ˊ� D src/Rules/PhpDoc/IncompatibleParamImmediatelyInvokedCallableRule.php� �+g� �U� 7 src/Rules/PhpDoc/IncompatiblePropertyPhpDocTypeRule.php �+g ��ޤ + src/Rules/PhpDoc/UnresolvableTypeHelper.phpE �+gE �
�u� 6 src/Rules/PhpDoc/FunctionConditionalReturnTypeRule.php� �+g� ���F� . src/Rules/PhpDoc/InvalidPhpDocTagValueRule.php �+g s(p�� 6 src/Rules/PhpDoc/RequireExtendsDefinitionTraitRule.php
�+g
FC�=� 9 src/Rules/PhpDoc/RequireImplementsDefinitionClassRule.php� �+g� �[�� . src/Rules/PhpDoc/GenericCallableRuleHelper.php� �+g�
�� % src/Rules/PhpDoc/AssertRuleHelper.php�% �+g�% v�Z� 4 src/Rules/PhpDoc/ConditionalReturnTypeRuleHelper.php� �+g� yƐ� % src/Rules/PhpDoc/MethodAssertRule.php� �+g� �χ� 1 src/Rules/PhpDoc/InvalidThrowsPhpDocValueRule.php� �+g� �#�� 4 src/Rules/PhpDoc/MethodConditionalReturnTypeRule.php� �+g� !̷ܤ % src/Rules/PhpDoc/PhpDocLineHelper.php: �+g: 6�}� 9 src/Rules/PhpDoc/RequireImplementsDefinitionTraitRule.php� �+g� q��f� 0 src/Rules/PhpDoc/InvalidPhpDocVarTagTypeRule.php �+g Q�գ� - src/Rules/PhpDoc/InvalidPHPStanDocTagRule.php� �+g� �aB� ) src/Rules/PhpDoc/VarTagTypeRuleHelper.php� �+g� ���L� 0 src/Rules/PhpDoc/IncompatibleSelfOutTypeRule.phpd
�+gd
��O� ' src/Rules/PhpDoc/FunctionAssertRule.php� �+g� �U ֤ / src/Rules/PhpDoc/IncompatiblePhpDocTypeRule.phpc. �+gc. )A�3� < src/Rules/PhpDoc/IncompatibleClassConstantPhpDocTypeRule.php
�+g
j逘� ? src/Rules/TooWideTypehints/TooWideClosureReturnTypehintRule.php� �+g� i
�Ф B src/Rules/TooWideTypehints/TooWideFunctionParameterOutTypeRule.php� �+g� g���� > src/Rules/TooWideTypehints/TooWideMethodReturnTypehintRule.php� �+g� �K|� @ src/Rules/TooWideTypehints/TooWideMethodParameterOutTypeRule.php� �+g� ͉�� ; src/Rules/TooWideTypehints/TooWideParameterOutTypeCheck.php?
�+g?
o �|� 6 src/Rules/TooWideTypehints/TooWidePropertyTypeRule.php� �+g� �;'� E src/Rules/TooWideTypehints/TooWideArrowFunctionReturnTypehintRule.php� �+g� ]
W� @ src/Rules/TooWideTypehints/TooWideFunctionReturnTypehintRule.php
�+g
#���� 7 src/Reflection/MissingMethodFromReflectionException.phpv �+gv Cz�b� 5 src/Reflection/CallableFunctionVariantWithPhpDocs.php�
�+g�
4*Zޤ 5 src/Reflection/PropertiesClassReflectionExtension.phpS �+gS -=�[� % src/Reflection/FunctionReflection.php� �+g� ����� O src/Reflection/PHPStan/NativeReflectionEnumReturnDynamicReturnTypeExtension.php� �+g� ���G� % src/Reflection/ConstantReflection.php| �+g| , = � 5 src/Reflection/Constant/RuntimeConstantReflection.php� �+g� `@ � % src/Reflection/PropertyReflection.phpW �+gW <�zW� Q src/Reflection/RequireExtension/RequireExtendsMethodsClassReflectionExtension.phpF �+gF ���ޤ T src/Reflection/RequireExtension/RequireExtendsPropertiesClassReflectionExtension.phpl �+gl >���� . src/Reflection/Mixin/MixinMethodReflection.php4 �+g4 �#]� @ src/Reflection/Mixin/MixinPropertiesClassReflectionExtension.php� �+g� D^�פ = src/Reflection/Mixin/MixinMethodsClassReflectionExtension.php: �+g: jV�ޤ ) src/Reflection/InitializerExprContext.php �+g �"�� % src/Reflection/ConstantNameHelper.php� �+g� �B�� % src/Reflection/ConstructorsHelper.php�
�+g�
(Q�� - src/Reflection/ResolvedPropertyReflection.phpK �+gK ^�p� , src/Reflection/TrivialParametersAcceptor.phpF �+gF .?Rg� - src/Reflection/ParametersAcceptorSelector.php�� �+g�� ��і� " src/Reflection/ClassReflection.php�� �+g�� 3>�+� $ src/Reflection/NamespaceAnswerer.php� �+g� \�w� . src/Reflection/Callables/SimpleImpurePoint.php �+g � �n� - src/Reflection/Callables/SimpleThrowPoint.php� �+g� �kC� 4 src/Reflection/Callables/FunctionCallableVariant.phpt �+gt �,N1� 7 src/Reflection/Callables/CallableParametersAcceptor.php� �+g� �"R� < src/Reflection/BetterReflection/BetterReflectionProvider.php#T �+g#T 9�l�� P src/Reflection/BetterReflection/SourceStubber/ReflectionSourceStubberFactory.php� �+g� h���� S src/Reflection/BetterReflection/SourceStubber/PhpStormStubsSourceStubberFactory.php� �+g� �Ԋ�� P src/Reflection/BetterReflection/SourceLocator/AutoloadFunctionsSourceLocator.php� �+g� ��[H� R src/Reflection/BetterReflection/SourceLocator/PhpVersionBlacklistSourceLocator.php� �+g� ��� = src/Reflection/BetterReflection/SourceLocator/FetchedNode.php
�+g
���� Q src/Reflection/BetterReflection/SourceLocator/OptimizedDirectorySourceLocator.php�4 �+g�4 ��=� P src/Reflection/BetterReflection/SourceLocator/RewriteClassAliasSourceLocator.php� �+g� �,��� V src/Reflection/BetterReflection/SourceLocator/OptimizedPsrAutoloaderLocatorFactory.phps �+gs ǣ/`� X src/Reflection/BetterReflection/SourceLocator/OptimizedDirectorySourceLocatorFactory.phpi �+gi ���� B src/Reflection/BetterReflection/SourceLocator/FileNodesFetcher.php� �+g� jn̤ [ src/Reflection/BetterReflection/SourceLocator/OptimizedDirectorySourceLocatorRepository.php� �+g� bĥ� Y src/Reflection/BetterReflection/SourceLocator/OptimizedSingleFileSourceLocatorFactory.php �+g i��� O src/Reflection/BetterReflection/SourceLocator/OptimizedPsrAutoloaderLocator.php� �+g� [bB� ` src/Reflection/BetterReflection/SourceLocator/ComposerJsonAndInstalledJsonSourceLocatorMaker.php�* �+g�* ��� K src/Reflection/BetterReflection/SourceLocator/FileReadTrapStreamWrapper.php) �+g) �q|�� D src/Reflection/BetterReflection/SourceLocator/FetchedNodesResult.php' �+g' �Q� G src/Reflection/BetterReflection/SourceLocator/AutoloadSourceLocator.phpo6 �+go6 ��%z� @ src/Reflection/BetterReflection/SourceLocator/PhpFileCleaner.php�" �+g�" �`� @ src/Reflection/BetterReflection/SourceLocator/CachingVisitor.php� �+g� c$fV� T src/Reflection/BetterReflection/SourceLocator/NewOptimizedDirectorySourceLocator.php �+g Rp}� N src/Reflection/BetterReflection/SourceLocator/ReflectionClassSourceLocator.phpL �+gL ��+?� M src/Reflection/BetterReflection/SourceLocator/SkipClassAliasSourceLocator.php� �+g� s��Ф R src/Reflection/BetterReflection/SourceLocator/OptimizedSingleFileSourceLocator.php%% �+g%% K��!� \ src/Reflection/BetterReflection/SourceLocator/OptimizedSingleFileSourceLocatorRepository.php� �+g� ?B�� @ src/Reflection/BetterReflection/Reflector/MemoizingReflector.php� �+g� �'b� H src/Reflection/BetterReflection/BetterReflectionSourceLocatorFactory.phpm �+gm �Bd� C src/Reflection/BetterReflection/BetterReflectionProviderFactory.php# �+g# �)y� , src/Reflection/WrapperPropertyReflection.php� �+g� �6�@� % src/Reflection/ParametersAcceptor.phpI �+gI 6U�� + src/Reflection/GlobalConstantReflection.php� �+g� v�Zʤ 3 src/Reflection/ClassReflectionExtensionRegistry.php�
�+g�
{�#� * src/Reflection/ClassConstantReflection.php� �+g� �m~� 9 src/Reflection/MissingPropertyFromReflectionException.php} �+g} �D�$� I src/Reflection/Type/CalledOnTypeUnresolvedPropertyPrototypeReflection.phpc �+gc D耤 = src/Reflection/Type/UnresolvedPropertyPrototypeReflection.php� �+g� ��T`� D src/Reflection/Type/UnionTypeUnresolvedMethodPrototypeReflection.php�
�+g�
0SФ F src/Reflection/Type/UnionTypeUnresolvedPropertyPrototypeReflection.php�
�+g�
]�U_� K src/Reflection/Type/IntersectionTypeUnresolvedMethodPrototypeReflection.php�
�+g�
�'¤ 8 src/Reflection/Type/IntersectionTypeMethodReflection.php� �+g� ��� 3 src/Reflection/Type/UnionTypePropertyReflection.phpp �+gp �/�~� 1 src/Reflection/Type/UnionTypeMethodReflection.phpT �+gT �?e�� ; src/Reflection/Type/UnresolvedMethodPrototypeReflection.php� �+g� ��C.� : src/Reflection/Type/IntersectionTypePropertyReflection.phpn �+gn �T��� E src/Reflection/Type/CallbackUnresolvedPropertyPrototypeReflection.phph �+gh -�3� M src/Reflection/Type/IntersectionTypeUnresolvedPropertyPrototypeReflection.php�
�+g�
�Cy̤ C src/Reflection/Type/CallbackUnresolvedMethodPrototypeReflection.php. �+g. �e�g� G src/Reflection/Type/CalledOnTypeUnresolvedMethodPrototypeReflection.php* �+g* �K��� ' src/Reflection/BrokerAwareExtension.php �+g �J�� 4 src/Reflection/GenericParametersAcceptorResolver.phpE �+gE ��=� . src/Reflection/InitializerExprTypeResolver.phpgZ �+ggZ 7rh
� 2 src/Reflection/WrappedExtendedMethodReflection.php4 �+g4 u>�G� - src/Reflection/FunctionVariantWithPhpDocs.php �+g �� � & src/Reflection/ParameterReflection.php� �+g� �`}1� " src/Reflection/FunctionVariant.php1 �+g1 $y�פ 3 src/Reflection/Native/NativeParameterReflection.php� �+g� at�ʤ > src/Reflection/Native/NativeParameterWithPhpDocsReflection.php� �+g� �5� 0 src/Reflection/Native/NativeMethodReflection.php �+g A� >� 2 src/Reflection/Native/NativeFunctionReflection.php� �+g� U��R� ? src/Reflection/ReflectionProvider/ReflectionProviderFactory.phpS �+gS G+�� = src/Reflection/ReflectionProvider/DummyReflectionProvider.php� �+g� 1��"� F src/Reflection/ReflectionProvider/DirectReflectionProviderProvider.phpP �+gP �n̪� A src/Reflection/ReflectionProvider/MemoizingReflectionProvider.php� �+g� T)�r� F src/Reflection/ReflectionProvider/SetterReflectionProviderProvider.phpa �+ga �3�� D src/Reflection/ReflectionProvider/LazyReflectionProviderProvider.php` �+g` � � @ src/Reflection/ReflectionProvider/ReflectionProviderProvider.php� �+g�
� 1 src/Reflection/ParameterReflectionWithPhpDocs.php� �+g� �y��� $ src/Reflection/PassedByReference.php% �+g% �B�� 2 src/Reflection/MethodsClassReflectionExtension.php: �+g: GgN�� @ src/Reflection/SignatureMap/NativeFunctionReflectionProvider.php� �+g� 7�֥� ; src/Reflection/SignatureMap/SignatureMapProviderFactory.phpR �+gR %ڏ�� < src/Reflection/SignatureMap/FunctionSignatureMapProvider.php ' �+g ' �vRp� 1 src/Reflection/SignatureMap/FunctionSignature.php� �+g� �� � 8 src/Reflection/SignatureMap/Php8SignatureMapProvider.php�L �+g�L m�:1� 4 src/Reflection/SignatureMap/SignatureMapProvider.php� �+g� X
�7� 2 src/Reflection/SignatureMap/SignatureMapParser.php�
�+g�
8��� 2 src/Reflection/SignatureMap/ParameterSignature.php? �+g? �ᷤ 1 src/Reflection/Php/PhpMethodReflectionFactory.php� �+g� �� 2 src/Reflection/Php/ClosureCallMethodReflection.php� �+g� �YƢ� E src/Reflection/Php/ClosureCallUnresolvedMethodPrototypeReflection.php~ �+g~ �K�r� 2 src/Reflection/Php/PhpClassReflectionExtension.php2� �+g2� ̞�_� @ src/Reflection/Php/EnumUnresolvedPropertyPrototypeReflection.php� �+g� ��'7� ; src/Reflection/Php/PhpParameterFromParserNodeReflection.phpH
�+gH
��^@� 0 src/Reflection/Php/EnumCasesMethodReflection.phpS
�+gS
Aw)�� 6 src/Reflection/Php/Soap/SoapClientMethodReflection.phpF �+gF i� E src/Reflection/Php/Soap/SoapClientMethodsClassReflectionExtension.php� �+g� +���� % src/Reflection/Php/DummyParameter.php �+g �X�B� 4 src/Reflection/Php/NativeBuiltinMethodReflection.php� �+g� *��K� / src/Reflection/Php/SimpleXMLElementProperty.php� �+g� �� �� D src/Reflection/Php/UniversalObjectCratesClassReflectionExtension.php�
�+g�
N �N� 3 src/Reflection/Php/UniversalObjectCrateProperty.phpJ �+gJ t?��� . src/Reflection/Php/BuiltinMethodReflection.php �+g ��l� * src/Reflection/Php/PhpMethodReflection.phpxF �+gxF ��ྤ : src/Reflection/Php/PhpFunctionFromParserNodeReflection.php�, �+g�, T"Ȥ B src/Reflection/Php/EnumAllowedSubTypesClassReflectionExtension.php �+g � �� , src/Reflection/Php/PhpFunctionReflection.php. �+g. -�Jդ 0 src/Reflection/Php/DummyParameterWithPhpDocs.php� �+g� ��j-� - src/Reflection/Php/ExitFunctionReflection.php� �+g� ��V� 8 src/Reflection/Php/PhpMethodFromParserNodeReflection.phpV �+gV
�
'� - src/Reflection/Php/EnumPropertyReflection.php� �+g� T���� - src/Reflection/Php/PhpParameterReflection.phpz �+gz �f�
� , src/Reflection/Php/PhpPropertyReflection.php� �+g� v��� src/Reflection/Assertions.php� �+g� kXƤ ( src/Reflection/ClassMemberReflection.phpd �+gd Y3�٤ : src/Reflection/AllowedSubTypesClassReflectionExtension.php� �+g� Ulb�� 0 src/Reflection/ParametersAcceptorWithPhpDocs.php �+g O�$E� 9 src/Reflection/Annotations/AnnotationMethodReflection.php� �+g� ol㿤 L src/Reflection/Annotations/AnnotationsPropertiesClassReflectionExtension.phpm �+gm U�a� ; src/Reflection/Annotations/AnnotationPropertyReflection.phpk �+gk EۡԤ I src/Reflection/Annotations/AnnotationsMethodsClassReflectionExtension.php �+g %��
� C src/Reflection/Annotations/AnnotationsMethodParameterReflection.php. �+g. ��� + src/Reflection/PhpVersionStaticAccessor.phpk �+gk q��?� 6 src/Reflection/ResolvedFunctionVariantWithOriginal.php+) �+g+) ����� * src/Reflection/ResolvedFunctionVariant.php� �+g� li'Ԥ 9 src/Reflection/MissingConstantFromReflectionException.php| �+g| �'ʤ 3 src/Reflection/ReflectionProviderStaticAccessor.php� �+g� 2� H� " src/Reflection/ClassNameHelper.php
�+g
�W � . src/Reflection/Dummy/DummyMethodReflection.php� �+g� 2gV� 0 src/Reflection/Dummy/DummyPropertyReflection.phpO �+gO v�E�� 4 src/Reflection/Dummy/ChangedTypeMethodReflection.php �+g 0*�� 6 src/Reflection/Dummy/ChangedTypePropertyReflection.php� �+g� m�� 0 src/Reflection/Dummy/DummyConstantReflection.phpu �+gu ��A�� 3 src/Reflection/Dummy/DummyConstructorReflection.php �+g ��w� % src/Reflection/ReflectionProvider.php� �+g� ��r!� 2 src/Reflection/AdditionalConstructorsExtension.php� �+g�
W<� % src/Reflection/InaccessibleMethod.php* �+g* C�� - src/Reflection/ExtendedPropertyReflection.php �+g S��� , src/Reflection/MethodPrototypeReflection.php� �+g� #
�@� , src/Reflection/FunctionReflectionFactory.phpE �+gE ��t�� + src/Reflection/ExtendedMethodReflection.phpI �+gI �X\�� % src/Reflection/EnumCaseReflection.php� �+g� � K�� 6 src/Reflection/ResolvedFunctionVariantWithCallable.php� �+g� ��Ӥ + src/Reflection/ResolvedMethodReflection.php= �+g= ���� , src/Reflection/ClassMemberAccessAnswerer.phpt �+gt �J� # src/Reflection/MethodReflection.php� �+g� �u�*� 4 src/Reflection/WrappedExtendedPropertyReflection.php7 �+g7 �]�� src/Collectors/Collector.php, �+g, �� � src/Collectors/Registry.php� �+g� ��_b� src/Collectors/CollectedData.phpZ �+gZ na� " src/Collectors/RegistryFactory.php �+g �wʤ " src/Command/ErrorsConsoleStyle.php� �+g� �:j� " src/Command/AnalyseApplication.php�$ �+g�$ �X�� src/Command/AnalyseCommand.php�| �+g�| >��Y� src/Command/AnalysisResult.phpc �+gc ��$e� $ src/Command/Symfony/SymfonyStyle.php� �+g� >A[�� % src/Command/Symfony/SymfonyOutput.php �+g }!�$� 7 src/Command/ErrorFormatter/CheckstyleErrorFormatter.php �+g =�4� 2 src/Command/ErrorFormatter/JunitErrorFormatter.php �+g �U�+� 7 src/Command/ErrorFormatter/CiDetectedErrorFormatter.php� �+g� ��� 8 src/Command/ErrorFormatter/BaselinePhpErrorFormatter.phpP
�+gP
y��� 3 src/Command/ErrorFormatter/GithubErrorFormatter.phph
�+gh
�VԤ 9 src/Command/ErrorFormatter/BaselineNeonErrorFormatter.php� �+g� �N�� 0 src/Command/ErrorFormatter/RawErrorFormatter.phpj �+gj ��� 3 src/Command/ErrorFormatter/GitlabErrorFormatter.php5 �+g5 ^sФ 5 src/Command/ErrorFormatter/TeamcityErrorFormatter.php �+g K�.� 2 src/Command/ErrorFormatter/TableErrorFormatter.phpP �+gP V!�_� 1 src/Command/ErrorFormatter/JsonErrorFormatter.phpR �+gR ��� - src/Command/ErrorFormatter/ErrorFormatter.php� �+g� �s�̤ + src/Command/IgnoredRegexValidatorResult.php� �+g� �3�?� % src/Command/DumpParametersCommand.php� �+g� Rz�� % src/Command/IgnoredRegexValidator.phpK �+gK �p�3� src/Command/FixerApplication.php4U �+g4U Z��?� % src/Command/FixerProcessException.php� �+g� ��H}� src/Command/WorkerCommand.php~& �+g~& �R�� src/Command/AnalyserRunner.php �+g �m�U� / src/Command/InceptionNotSuccessfulException.php� �+g� �_� src/Command/InceptionResult.php[ �+g[ !G� " src/Command/FixerWorkerCommand.phpo> �+go> �y�� src/Command/Output.php� �+g� �9�� src/Command/fixer-phar.pubkey �+g u䪤 src/Command/OutputStyle.php� �+g� �>g� src/Command/CommandHelper.phpP� �+gP� � ��� src/Command/DiagnoseCommand.php? �+g? B&�̤ ' src/Command/ClearResultCacheCommand.php
�+g
��7� src/debugScope.php� �+g� � �� + src/Classes/ForbiddenClassNameExtension.phpL �+gL }�ж� , src/Analyser/TypeSpecifierAwareExtension.php� �+g� ���Q� ! src/Analyser/StatementContext.php� �+g� �_�8� # src/Analyser/EndStatementResult.phpi �+gi >��� src/Analyser/AnalyserResult.php� �+g� H�e�� src/Analyser/MutatingScope.php�H �+g�H �� �� src/Analyser/StatementResult.php� �+g� .�:� 0 src/Analyser/Ignore/IgnoredErrorHelperResult.php�( �+g�( @q7� 9 src/Analyser/Ignore/IgnoredErrorHelperProcessedResult.php
�+g
4�8C� * src/Analyser/Ignore/IgnoredErrorHelper.php �+g �L� $ src/Analyser/Ignore/IgnoredError.php4 �+g4 ��>f� , src/Analyser/Ignore/IgnoreParseException.php� �+g� ��툤 # src/Analyser/Ignore/IgnoreLexer.phpy
�+gy
Ɨ�J� src/Analyser/ThrowPoint.php� �+g� '#e�� $ src/Analyser/ArgumentsNormalizer.php� �+g� l � % src/Analyser/InternalScopeFactory.php� �+g� ϤƷ� + src/Analyser/UndefinedVariableException.php; �+g; ��!� src/Analyser/ScopeFactory.php �+g C��� " src/Analyser/NodeScopeResolver.php�v �+g�v ���� % src/Analyser/RuleErrorTransformer.php! �+g! �~��� % src/Analyser/TypeSpecifierContext.php �+g �EE� src/Analyser/Error.php� �+g� w{'�� ( src/Analyser/AnalyserResultFinalizer.php@% �+g@% �ʨ�� 6 src/Analyser/EnsuredNonNullabilityResultExpression.phpp �+gp YC�Z� ) src/Analyser/LazyInternalScopeFactory.php� �+g� �9i� ! src/Analyser/ExpressionResult.phpU
�+gU
���� src/Analyser/NameScope.phpc �+gc ���� src/Analyser/FinalizerResult.phpL �+gL ���K� & src/Analyser/LocalIgnoresProcessor.php�
�+g�
DWY� , src/Analyser/EnsuredNonNullabilityResult.phpW �+gW {=m� % src/Analyser/TypeSpecifierFactory.php= �+g= �yO�� ( src/Analyser/ResultCache/ResultCache.php� �+g� egˤ 6 src/Analyser/ResultCache/ResultCacheManagerFactory.php� �+g� C��� / src/Analyser/ResultCache/ResultCacheManager.phpў �+gў Cb�Ԥ / src/Analyser/ResultCache/ResultCacheClearer.phpK �+gK ���u� 5 src/Analyser/ResultCache/ResultCacheProcessResult.phpw �+gw �v�� , src/Analyser/LocalIgnoresProcessorResult.php9 �+g9 � n�� src/Analyser/InternalError.phpx
�+gx
�m&x� + src/Analyser/DirectInternalScopeFactory.php� �+g� [�1Ф src/Analyser/FileAnalyser.php A �+g A e~ j� % src/Analyser/ExpressionTypeHolder.php� �+g� �*�-� ! src/Analyser/ConstantResolver.php�+ �+g�+ ��31� # src/Analyser/StatementExitPoint.phpq �+gq �I�� , src/Analyser/ConditionalExpressionHolder.php� �+g� �p7 � ) src/Analyser/RicherScopeGetTypeHelper.php"
�+g"
����� src/Analyser/ScopeContext.php�
�+g�
���*� # src/Analyser/FileAnalyserResult.php� �+g� ��2�� src/Analyser/OutOfClassScope.php� �+g� �# � ' src/Analyser/NullsafeOperatorHelper.php�
�+g�
�� �� src/Analyser/ImpurePoint.php� �+g� X'癤 ( src/Analyser/ConstantResolverFactory.php? �+g? ��)&� % src/Analyser/ProcessClosureResult.php� �+g�
��1� src/Analyser/SpecifiedTypes.php^ �+g^ �Z=�� src/Analyser/Scope.php� �+g� �]{� " src/Analyser/ExpressionContext.php� �+g� n,�a� src/Analyser/Analyser.phpP �+gP ����� src/Analyser/TypeSpecifier.php�q �+g�q f�@�� src/Node/BooleanOrNode.php� �+g� *�k� src/Node/ReturnStatement.php �+g �쏿� src/Node/InFunctionNode.php� �+g� �_� � src/Node/ClassConstantsNode.php� �+g� "�hä & src/Node/InstantiationCallableNode.php �+g ~��#� src/Node/MatchExpressionNode.php �+g �ذ0� ( src/Node/Constant/ClassConstantFetch.phpi �+gi ���� src/Node/InClassMethodNode.php� �+g� �ܤ src/Node/VariableAssignNode.php� �+g� �� � src/Node/LiteralArrayItem.phpg �+gg %k� + src/Node/CatchWithUnthrownExceptionNode.php �+g ���G� src/Node/InTraitNode.phpy �+gy �@� src/Node/NoopExpressionNode.php� �+g� ���5� src/Node/CollectedDataNode.php� �+g� �ß� # src/Node/MatchExpressionArmBody.php3 �+g3 ƶ3� src/Node/ClassPropertyNode.php� �+g� ���2� src/Node/InClassNode.php2 �+g2 b� X� ! src/Node/ReturnStatementsNode.phpo �+go �7��� " src/Node/Property/PropertyRead.php �+g W� �� # src/Node/Property/PropertyWrite.php �+g }�� $ src/Node/Property/PropertyAssign.phpr �+gr � � $ src/Node/ClassStatementsGatherer.php�# �+g�# ��� " src/Node/FinallyExitPointsNode.php �+g @�q{� % src/Node/DoWhileLoopConditionNode.php< �+g< �{ o� src/Node/InArrowFunctionNode.phpW �+gW ��E<� ! src/Node/Expr/UnsetOffsetExpr.php& �+g& W�c� src/Node/Expr/TypeExpr.php� �+g� �gä * src/Node/Expr/GetIterableValueTypeExpr.php� �+g� � &� ' src/Node/Expr/ExistingArrayDimFetch.php2 �+g2 �� 0 src/Node/Expr/SetExistingOffsetValueTypeExpr.php� �+g� f�6�� ( src/Node/Expr/SetOffsetValueTypeExpr.php� �+g� ��6�� ( src/Node/Expr/GetIterableKeyTypeExpr.php� �+g� Wm2B� * src/Node/Expr/OriginalPropertyTypeExpr.php� �+g� �� � ( src/Node/Expr/GetOffsetValueTypeExpr.php4 �+g4 �%7� & src/Node/Expr/AlwaysRememberedExpr.php. �+g. w~(�� 4 src/Node/Expr/ParameterVariableOriginalValueExpr.php� �+g� DH� , src/Node/Expr/PropertyInitializationExpr.php� �+g� l�֤ src/Node/ClassMethodsNode.php� �+g� j�W� ' src/Node/MethodReturnStatementsNode.php� �+g� �cˌ� src/Node/ClassMethod.phpO �+gO -e(7� src/Node/InvalidateExprNode.php� �+g� �� �� src/Node/IssetExpr.php� �+g� -�n� src/Node/FileNode.phpP �+gP �Q�� ( src/Node/ClosureReturnStatementsNode.php�
�+g�
�\��� src/Node/LiteralArrayNode.php~ �+g~ 9�/r� src/Node/MatchExpressionArm.php� �+g� �t� ! src/Node/FunctionCallableNode.php �+g ;�� src/Node/VirtualNode.php� �+g� �@�Ϥ src/Node/ClassPropertiesNode.phpY@ �+gY@ ��ɤ % src/Node/UnreachableStatementNode.php �+g ���� src/Node/MethodCallableNode.php� �+g� �o�o� , src/Node/VarTagChangedExpressionTypeNode.php� �+g� �4/�� src/Node/PropertyAssignNode.phpN �+gN � J� ) src/Node/FunctionReturnStatementsNode.php� �+g� �4�� src/Node/Printer/Printer.php� �+g� �$��� src/Node/Printer/ExprPrinter.php� �+g� WԝΤ $ src/Node/Printer/NodeTypePrinter.php� �+g� ��w9� src/Node/AnonymousClassNode.php� �+g� bɫ�� ( src/Node/MatchExpressionArmCondition.php� �+g� & +�� src/Node/InClosureNode.php) �+g) �{9S� # src/Node/BreaklessWhileLoopNode.php� �+g� �F� src/Node/BooleanAndNode.php� �+g� 7�cJ� src/Node/InForeachNode.php� �+g� Sq�G� src/Node/Method/MethodCall.php �+g �[��� src/Node/ExecutionEndNode.php �+g �7�6� % src/Node/StaticMethodCallableNode.php; �+g; )3E0� src/dumpType.phpA �+gA � �
� src/Type/IntegerRangeType.php�[ �+g�[ �s
�� src/Type/IntersectionType.php� �+g� b+ פ src/Type/BooleanType.php� �+g�
D]� 3 src/Type/DynamicStaticMethodReturnTypeExtension.php� �+g� ��CѤ src/Type/IsSuperTypeOfResult.php: �+g: �3C� src/Type/CallableTypeHelper.php� �+g� "T�ʤ 2 src/Type/Accessory/AccessoryNonFalsyStringType.php�# �+g�# *��ޤ ) src/Type/Accessory/HasOffsetValueType.php�4 �+g�4 ��)� ( src/Type/Accessory/NonEmptyArrayType.phpZ+ �+gZ+ ���� 1 src/Type/Accessory/AccessoryNumericStringType.php�$ �+g�$ lB�l� ) src/Type/Accessory/OversizedArrayType.php�) �+g�) V�3 � $ src/Type/Accessory/AccessoryType.php� �+g� ;ʠ� 2 src/Type/Accessory/AccessoryNonEmptyStringType.php8% �+g8% ����� $ src/Type/Accessory/HasOffsetType.php�+ �+g�+
=�פ $ src/Type/Accessory/HasMethodType.php �+g ��ǚ� 1 src/Type/Accessory/AccessoryLiteralStringType.php $ �+g $ �n��� 3 src/Type/Accessory/AccessoryLowercaseStringType.php $ �+g $ ��nʤ - src/Type/Accessory/AccessoryArrayListType.php�/ �+g�/ ]�+� & src/Type/Accessory/HasPropertyType.php� �+g� Ȩ`�� . src/Type/FunctionParameterOutTypeExtension.php� �+g� �$%¤ 8 src/Type/StringAlwaysAcceptingObjectWithToStringType.php� �+g� Y� 9� # src/Type/Regex/RegexAlternation.php� �+g� ^
m�� ) src/Type/Regex/RegexNonCapturingGroup.phpm �+gm ��%D� # src/Type/Regex/RegexGroupParser.php I �+g I �\�� ' src/Type/Regex/RegexGroupWalkResult.php�
�+g�
c� � & src/Type/Regex/RegexCapturingGroup.php� �+g� �+-ڤ ( src/Type/Regex/RegexExpressionHelper.php� �+g� �(�Ϥ % src/Type/Regex/RegexAstWalkResult.php� �+g� ��iڤ " src/Type/JustNullableTypeTrait.php� �+g� �k�Ƥ src/Type/ResourceType.phpw �+gw ���� . src/Type/DynamicFunctionThrowTypeExtension.phpl �+gl +���� src/Type/TypeCombinator.phpI� �+gI� m�Ԥ , src/Type/MethodParameterOutTypeExtension.php� �+g� � �� src/Type/NullType.php) �+g) �u�Ϥ src/Type/VerbosityLevel.php� �+g� :�
� , src/Type/ExpressionTypeResolverExtension.phpI �+gI C8�� src/Type/TypeTraverser.php* �+g* pI��� - src/Type/DynamicMethodReturnTypeExtension.php� �+g� C�$� 2 src/Type/StaticMethodParameterOutTypeExtension.php� �+g� �� src/Type/StrictMixedType.php / �+g / �v� � . src/Type/Constant/ConstantArrayTypeBuilder.php�0 �+g�0 ��K�� 0 src/Type/Constant/ConstantArrayTypeAndMethod.php� �+g� �.�� ( src/Type/Constant/ConstantStringType.php�I �+g�I n�z�� ' src/Type/Constant/ConstantFloatType.php� �+g� B���� ) src/Type/Constant/ConstantIntegerType.php
�+g
j��� ' src/Type/Constant/ConstantArrayType.php�� �+g�� �x=�� + src/Type/Constant/OversizedArrayBuilder.php� �+g� vj�'� ) src/Type/Constant/ConstantBooleanType.php�
�+g�
��� 2 src/Type/Constant/ConstantScalarToBooleanTrait.php �+g &��� src/Type/IterableType.phpI= �+gI= ~ �$� src/Type/ClassStringType.php�
�+g�
�(t� src/Type/ConstantTypeHelper.php �+g �D㫤 ( src/Type/ConditionalTypeForParameter.php� �+g� ���Τ src/Type/ArrayType.php}_ �+g}_ �u�#� src/Type/ClosureType.php�^ �+g�^ ��Ľ� $ src/Type/Enum/EnumCaseObjectType.php� �+g�
��M� src/Type/ValueOfType.php� �+g� E���� src/Type/FileTypeMapper.php�� �+g�� �X�� 1 src/Type/CircularTypeAliasDefinitionException.php� �+g� ű�ä 4 src/Type/ExpressionTypeResolverExtensionRegistry.php' �+g' yn� & src/Type/SimultaneousTypeTraverser.php� �+g� ,� դ , src/Type/DirectTypeAliasResolverProvider.php �+g �)�� src/Type/ConstantType.php| �+g| ��>G� src/Type/OffsetAccessType.php� �+g� <�� src/Type/FloatType.php �+g ��܂� src/Type/CompoundType.php �+g U���� 4 src/Type/OperatorTypeSpecifyingExtensionRegistry.php
�+g
��4�� src/Type/UnionType.php�� �+g�� � ܩ� / src/Type/DynamicReturnTypeExtensionRegistry.php� �+g� �n&�� src/Type/KeyOfType.php&
�+g&
s�٤ src/Type/ConstantScalarType.php� �+g� )Y� # src/Type/ObjectWithoutClassType.php� �+g� �X�@� src/Type/StaticTypeFactory.php� �+g� �e��� * src/Type/LazyTypeAliasResolverProvider.php �+g c�k�� src/Type/VoidType.php. �+g. 2�Dפ src/Type/TypeWithClassName.php\ �+g\ '��ܤ src/Type/BitwiseFlagHelper.php�
�+g�
�*-{� src/Type/ExponentiateHelper.php �+g ��M� src/Type/RecursionGuard.php� �+g� }��O� , src/Type/FunctionTypeSpecifyingExtension.php �+g g\�P� , src/Type/OperatorTypeSpecifyingExtension.php� �+g� �
tF� * src/Type/ObjectShapePropertyReflection.php� �+g� �c�� ' src/Type/Traits/MaybeArrayTypeTrait.php� �+g� ��{� ( src/Type/Traits/NonIterableTypeTrait.php �+g �. |� * src/Type/Traits/FalseyBooleanTypeTrait.php �+g 4�k1� ( src/Type/Traits/NonCallableTypeTrait.php� �+g� զ�[� 2 src/Type/Traits/MaybeOffsetAccessibleTypeTrait.phpx �+gx �� + src/Type/Traits/ConstantScalarTypeTrait.php6 �+g6 z;r1� * src/Type/Traits/MaybeIterableTypeTrait.phpI �+gI �� ( src/Type/Traits/MaybeObjectTypeTrait.php
�+g
�2{� ' src/Type/Traits/NonGenericTypeTrait.php� �+g� ��ށ� 8 src/Type/Traits/UndecidedComparisonCompoundTypeTrait.php� �+g� ��� 0 src/Type/Traits/NonOffsetAccessibleTypeTrait.php� �+g� ��� % src/Type/Traits/NonArrayTypeTrait.php� �+g� ݄#� + src/Type/Traits/LateResolvableTypeTrait.php4= �+g4= z�cI� * src/Type/Traits/MaybeCallableTypeTrait.php� �+g� ��� - src/Type/Traits/UndecidedBooleanTypeTrait.php� �+g� ȷ�� - src/Type/Traits/NonGeneralizableTypeTrait.php� �+g� f�7ݤ & src/Type/Traits/NonObjectTypeTrait.phpu
�+gu
B�� # src/Type/Traits/ObjectTypeTrait.php �+g ���� 0 src/Type/Traits/UndecidedComparisonTypeTrait.php �+g ��n� * src/Type/Traits/TruthyBooleanTypeTrait.php �+g ��� � 6 src/Type/Traits/ConstantNumericComparisonTypeTrait.php) �+g) 5���� * src/Type/Traits/NonRemoveableTypeTrait.php� �+g� 4�i8� , src/Type/DynamicMethodThrowTypeExtension.phpg �+gg �ޭ^� src/Type/BenevolentUnionType.php �+g D�fr� ( src/Type/GenericTypeVariableResolver.php� �+g� ����� * src/Type/MethodTypeSpecifyingExtension.php' �+g' T\0e� src/Type/LateResolvableType.php� �+g� � 1�� " src/Type/NonAcceptingNeverType.php� �+g� �E3� src/Type/MixedType.php2� �+g2� t
� ' src/Type/Generic/TemplateStringType.phpV �+gV 6yI/� 0 src/Type/Generic/TemplateBenevolentUnionType.phpE �+gE ��֤ & src/Type/Generic/TemplateTypeScope.php �+g ��G�� & src/Type/Generic/TemplateKeyOfType.php{ �+g{ �f � + src/Type/Generic/GenericClassStringType.php� �+g� �{� , src/Type/Generic/TemplateObjectShapeType.php� �+g� �
�b� . src/Type/Generic/TemplateGenericObjectType.php� �+g� ��"� $ src/Type/Generic/TemplateTypeMap.php_ �+g_ �T� ' src/Type/Generic/TemplateTypeHelper.php �+g r�冤 & src/Type/Generic/TemplateMixedType.phph �+gh ��o� / src/Type/Generic/TemplateConstantStringType.php� �+g� �+T� * src/Type/Generic/TemplateTypeReference.php� �+g� B�8�� ) src/Type/Generic/TemplateTypeStrategy.php< �+g< Uzܤ ( src/Type/Generic/TemplateIntegerType.php[ �+g[ �˝L� 0 src/Type/Generic/TemplateConstantIntegerType.php� �+g� GA8դ & src/Type/Generic/TemplateTypeTrait.php0 �+g0 �$y� ( src/Type/Generic/TemplateTypeFactory.php" �+g" l�Ar� , src/Type/Generic/TemplateStrictMixedType.php� �+g� ��A� 3 src/Type/Generic/TemplateObjectWithoutClassType.php, �+g, �<��� ) src/Type/Generic/TypeProjectionHelper.phps �+gs H^�1� ! src/Type/Generic/TemplateType.php| �+g| ��r/� ( src/Type/Generic/TemplateBooleanType.php[ �+g[ �� & src/Type/Generic/TemplateFloatType.phpQ �+gQ $Z��� ) src/Type/Generic/TemplateTypeVariance.php �+g ��K� & src/Type/Generic/GenericObjectType.php�6 �+g�6 _�'Ф & src/Type/Generic/TemplateArrayType.php| �+g| `�� 1 src/Type/Generic/TemplateTypeArgumentStrategy.php� �+g� f�y� , src/Type/Generic/TemplateTypeVarianceMap.php� �+g� $�.� . src/Type/Generic/TemplateConstantArrayType.php� �+g� (�\&� ' src/Type/Generic/TemplateObjectType.php �+g ��8� 2 src/Type/Generic/TemplateTypeParameterStrategy.php� �+g� (�}� & src/Type/Generic/TemplateUnionType.php- �+g- `�mh� - src/Type/Generic/TemplateIntersectionType.php� �+g� � �� $ src/Type/UsefulTypeAliasResolver.php� �+g� �п� src/Type/TypehintHelper.php@% �+g@% /Rb�� 2 src/Type/DynamicStaticMethodThrowTypeExtension.php� �+g� � �� 0 src/Type/StaticMethodTypeSpecifyingExtension.phpG �+gG z��;� / src/Type/Php/FilterFunctionReturnTypeHelper.php4B �+g4B >B� 8 src/Type/Php/ArrayReverseFunctionReturnTypeExtension.php� �+g� ��"ˤ 7 src/Type/Php/IsArrayFunctionTypeSpecifyingExtension.php� �+g� �$Ұ� ; src/Type/Php/ArraySearchFunctionTypeSpecifyingExtension.phpH �+gH ��kԤ : src/Type/Php/CtypeDigitFunctionTypeSpecifyingExtension.php�
�+g�
��W � 2 src/Type/Php/StrTokFunctionReturnTypeExtension.php� �+g� �"r� 2 src/Type/Php/HrtimeFunctionReturnTypeExtension.php� �+g� ��� 4 src/Type/Php/DateFormatMethodReturnTypeExtension.php& �+g& �9Ӥ 1 src/Type/Php/HashFunctionsReturnTypeExtension.php� �+g� �� �� ; src/Type/Php/ParseUrlFunctionDynamicReturnTypeExtension.php� �+g� �Ή� = src/Type/Php/MbConvertEncodingFunctionReturnTypeExtension.php� �+g� � ��� / src/Type/Php/PowFunctionReturnTypeExtension.php{ �+g{ �_ڤ 6 src/Type/Php/AssertFunctionTypeSpecifyingExtension.php� �+g� &�f�� 0 src/Type/Php/IsAFunctionTypeSpecifyingHelper.php �+g 2ζ� 1 src/Type/Php/SubstrDynamicReturnTypeExtension.php� �+g� ��!~� 6 src/Type/Php/AbsFunctionDynamicReturnTypeExtension.php� �+g� ��D� ) src/Type/Php/AssertThrowTypeExtension.php$ �+g$ M��� 9 src/Type/Php/GetCalledClassDynamicReturnTypeExtension.php� �+g� ��*� 2 src/Type/Php/StrPadFunctionReturnTypeExtension.php! �+g! '�
�� - src/Type/Php/DateFunctionReturnTypeHelper.php� �+g�
c�� ; src/Type/Php/PathinfoFunctionDynamicReturnTypeExtension.php
�+g
U�� 3 src/Type/Php/CompactFunctionReturnTypeExtension.phpt
�+gt
b�j� > src/Type/Php/ClosureFromCallableDynamicReturnTypeExtension.php~ �+g~ {s$�� 6 src/Type/Php/ArrayShiftFunctionReturnTypeExtension.php� �+g� 5�l� A src/Type/Php/VersionCompareFunctionDynamicReturnTypeExtension.php� �+g� ��
� 3 src/Type/Php/PregMatchParameterOutTypeExtension.phph �+gh H
��� 4 src/Type/Php/ArrayFilterFunctionReturnTypeHelper.php>1 �+g>1 W�\� A src/Type/Php/SimpleXMLElementClassPropertyReflectionExtension.php� �+g� ?@� 5 src/Type/Php/StrRepeatFunctionReturnTypeExtension.php �+g �k�� < src/Type/Php/IsSubclassOfFunctionTypeSpecifyingExtension.php� �+g� ��� ; src/Type/Php/IteratorToArrayFunctionReturnTypeExtension.php( �+g( �qӤ 8 src/Type/Php/ArrayCombineFunctionReturnTypeExtension.php^ �+g^ ��¤ 4 src/Type/Php/MbStrlenFunctionReturnTypeExtension.php� �+g� �^Yܤ = src/Type/Php/ArrayMergeFunctionDynamicReturnTypeExtension.php� �+g� �.ˤ 7 src/Type/Php/DefinedConstantTypeSpecifyingExtension.php� �+g� Ӱ�� : src/Type/Php/IsCallableFunctionTypeSpecifyingExtension.php� �+g� {`�֤ ' src/Type/Php/JsonThrowTypeExtension.phpN �+gN D+�2� > src/Type/Php/ReflectionMethodConstructorThrowTypeExtension.php} �+g} �*Τ < src/Type/Php/ArrayKeysFunctionDynamicReturnTypeExtension.php: �+g: 0 ~� 5 src/Type/Php/ArrayFlipFunctionReturnTypeExtension.php �+g V�Q� 1 src/Type/Php/CountFunctionReturnTypeExtension.php� �+g� j.m�� 6 src/Type/Php/ClosureBindDynamicReturnTypeExtension.php� �+g� ]�� � > src/Type/Php/ArraySearchFunctionDynamicReturnTypeExtension.php] �+g] �Y�� 9 src/Type/Php/FilterVarArrayDynamicReturnTypeExtension.php� �+g� Gv�� 6 src/Type/Php/PregFilterFunctionReturnTypeExtension.php� �+g� ���|� 4 src/Type/Php/ConstantFunctionReturnTypeExtension.php �+g �� Ԥ ; src/Type/Php/ArraySumFunctionDynamicReturnTypeExtension.php� �+g� �VN�� * src/Type/Php/IniGetReturnTypeExtension.php� �+g� �W�N� 1 src/Type/Php/PregMatchTypeSpecifyingExtension.php4
�+g4
�iK� 8 src/Type/Php/GetDebugTypeFunctionReturnTypeExtension.php� �+g� �L��� ; src/Type/Php/NonEmptyStringFunctionsReturnTypeExtension.php �+g cQK�� ; src/Type/Php/ClassExistsFunctionTypeSpecifyingExtension.php� �+g� � j� 9 src/Type/Php/DateTimeCreateDynamicReturnTypeExtension.php. �+g. �(1[� 4 src/Type/Php/ArrayMapFunctionReturnTypeExtension.phpG �+gG ��-� 5 src/Type/Php/ArrayRandFunctionReturnTypeExtension.php! �+g! �`� 7 src/Type/Php/ArrayCurrentDynamicReturnTypeExtension.php� �+g� 7���� 3 src/Type/Php/GettypeFunctionReturnTypeExtension.phpF �+gF 1�Ŗ� 7 src/Type/Php/TriggerErrorDynamicReturnTypeExtension.php� �+g� �q��� ? src/Type/Php/BackedEnumFromMethodDynamicReturnTypeExtension.phpz �+gz ��� � 6 src/Type/Php/PropertyExistsTypeSpecifyingExtension.php �+g �/m�� > src/Type/Php/ArrayValuesFunctionDynamicReturnTypeExtension.php@ �+g@ E�"?� 4 src/Type/Php/MbFunctionsReturnTypeExtensionTrait.php� �+g� o% 9� 4 src/Type/Php/StrCaseFunctionsReturnTypeExtension.php[ �+g[ _��/� 2 src/Type/Php/MinMaxFunctionReturnTypeExtension.php= �+g= B� � 5 src/Type/Php/ArrayFillFunctionReturnTypeExtension.php)
�+g)
�b�� 8 src/Type/Php/StrvalFamilyFunctionReturnTypeExtension.php� �+g� ��а� 8 src/Type/Php/ClosureBindToDynamicReturnTypeExtension.php� �+g� ���� : src/Type/Php/DioStatDynamicFunctionReturnTypeExtension.php� �+g� �� � ; src/Type/Php/ReplaceFunctionsDynamicReturnTypeExtension.phpn �+gn ��� 5 src/Type/Php/StrtotimeFunctionReturnTypeExtension.php� �+g� 1�)S� @ src/Type/Php/MbSubstituteCharacterDynamicReturnTypeExtension.php\ �+g\ �)� 6 src/Type/Php/DateFormatFunctionReturnTypeExtension.php� �+g� ¥Cs� : src/Type/Php/DateTimeZoneConstructorThrowTypeExtension.php� �+g� z�Z� ? src/Type/Php/StrWordCountFunctionDynamicReturnTypeExtension.php$ �+g$ ��|4� 8 src/Type/Php/PregReplaceCallbackClosureTypeExtension.php� �+g� ��
�� ; src/Type/Php/ClassImplementsFunctionReturnTypeExtension.php{ �+g{ �c%w� / src/Type/Php/MbFunctionsReturnTypeExtension.php �+g `�,� 7 src/Type/Php/ArrayFilterFunctionReturnTypeExtension.php �+g o�v�� 4 src/Type/Php/MethodExistsTypeSpecifyingExtension.php� �+g� ̓�9� ) src/Type/Php/IntdivThrowTypeExtension.phpg �+gg C��� 0 src/Type/Php/DsMapDynamicReturnTypeExtension.php: �+g: ̢��� @ src/Type/Php/ArrayPointerFunctionsDynamicReturnTypeExtension.php� �+g� u�C� 5 src/Type/Php/RandomIntFunctionReturnTypeExtension.php� �+g� 4+� 8 src/Type/Php/ArrayReplaceFunctionReturnTypeExtension.php� �+g� ,�#�� : src/Type/Php/HighlightStringDynamicReturnTypeExtension.php �+g �k8�� : src/Type/Php/SprintfFunctionDynamicReturnTypeExtension.php91 �+g91 BzF� = src/Type/Php/ArrayIntersectKeyFunctionReturnTypeExtension.php� �+g� �mB� ? src/Type/Php/GettimeofdayDynamicFunctionReturnTypeExtension.phpJ �+gJ �R>� : src/Type/Php/DateIntervalConstructorThrowTypeExtension.php� �+g� �P47� 1 src/Type/Php/RangeFunctionReturnTypeExtension.php5 �+g5 � �� : src/Type/Php/ExplodeFunctionDynamicReturnTypeExtension.php? �+g? ed)J� 1 src/Type/Php/LtrimFunctionReturnTypeExtension.php[ �+g[ IL�ɤ @ src/Type/Php/ReflectionPropertyConstructorThrowTypeExtension.php� �+g� ��� 6 src/Type/Php/FilterInputDynamicReturnTypeExtension.php� �+g� ^(�Ȥ : src/Type/Php/IsIterableFunctionTypeSpecifyingExtension.php. �+g. R�3�� 4 src/Type/Php/PregSplitDynamicReturnTypeExtension.phps �+gs ��� @ src/Type/Php/ReflectionFunctionConstructorThrowTypeExtension.phpj �+gj ���2� 6 src/Type/Php/DefineConstantTypeSpecifyingExtension.php� �+g� �^�� 5 src/Type/Php/StrContainingTypeSpecifyingExtension.phpv
�+gv
�T�� 1 src/Type/Php/RoundFunctionReturnTypeExtension.php�
�+g�
�Mcw� A src/Type/Php/StrIncrementDecrementFunctionReturnTypeExtension.php� �+g� ��*Z� > src/Type/Php/FunctionExistsFunctionTypeSpecifyingExtension.phpA �+gA � �
� > src/Type/Php/SimpleXMLElementConstructorThrowTypeExtension.phpw �+gw t�Zˤ 2 src/Type/Php/DateTimeModifyReturnTypeExtension.php9
�+g9
�w�� 4 src/Type/Php/FilterVarDynamicReturnTypeExtension.php� �+g� 7��!� 9 src/Type/Php/SscanfFunctionDynamicReturnTypeExtension.phpg
�+gg
n�s� 5 src/Type/Php/CountFunctionTypeSpecifyingExtension.php� �+g� b�Q�� / src/Type/Php/StatDynamicReturnTypeExtension.phpn �+gn ڤPD� ? src/Type/Php/Base64DecodeDynamicFunctionReturnTypeExtension.php� �+g� gR� 7 src/Type/Php/ArrayKeyLastDynamicReturnTypeExtension.php� �+g� �?y�� 8 src/Type/Php/ArrayFindKeyFunctionReturnTypeExtension.php+ �+g+ *��"� 8 src/Type/Php/ArrayKeyFirstDynamicReturnTypeExtension.php� �+g� �y�Z� 5 src/Type/Php/ArrayFindFunctionReturnTypeExtension.php3 �+g3 �S�� 7 src/Type/Php/InArrayFunctionTypeSpecifyingExtension.phpt �+gt � �J� 4 src/Type/Php/DateTimeSubMethodThrowTypeExtension.php
�+g
� �դ A src/Type/Php/GetParentClassDynamicFunctionReturnTypeExtension.php� �+g� �#hŤ B src/Type/Php/TypeSpecifyingFunctionsDynamicReturnTypeExtension.php/ �+g/ ⩏�� - src/Type/Php/ThrowableReturnTypeExtension.php� �+g� s��� ? src/Type/Php/SimpleXMLElementXpathMethodReturnTypeExtension.php� �+g� Y?/�� 7 src/Type/Php/ArraySpliceFunctionReturnTypeExtension.php� �+g� �n� 9 src/Type/Php/DatePeriodConstructorReturnTypeExtension.php$ �+g$ �mFܤ 6 src/Type/Php/DateTimeConstructorThrowTypeExtension.php �+g �� > src/Type/Php/ArrayKeyExistsFunctionTypeSpecifyingExtension.phpf �+gf ����� 3 src/Type/Php/ImplodeFunctionReturnTypeExtension.php} �+g} /qz� = src/Type/Php/ReflectionClassConstructorThrowTypeExtension.php& �+g& �9��� 7 src/Type/Php/ArrayReduceFunctionReturnTypeExtension.php� �+g� ��{u� 4 src/Type/Php/StrSplitFunctionReturnTypeExtension.php� �+g� *��� 7 src/Type/Php/DateIntervalDynamicReturnTypeExtension.php� �+g� qM>� ? src/Type/Php/SimpleXMLElementAsXMLMethodReturnTypeExtension.php; �+g; OX-� 7 src/Type/Php/SetTypeFunctionTypeSpecifyingExtension.php; �+g; G� � 3 src/Type/Php/ArrayKeyDynamicReturnTypeExtension.php� �+g� *1�=� 9 src/Type/Php/ArgumentBasedFunctionReturnTypeExtension.php �+g h�٤ A src/Type/Php/ReflectionGetAttributesMethodReturnTypeExtension.php� �+g� -rJ� ' src/Type/Php/RegexArrayShapeMatcher.php�D �+g�D ��� 6 src/Type/Php/BcMathStringOrNullReturnTypeExtension.phpj( �+gj( WY<Y� 5 src/Type/Php/DsMapDynamicMethodThrowTypeExtension.php� �+g� � fS� 7 src/Type/Php/ArrayColumnFunctionReturnTypeExtension.php �+g I[�Ф 4 src/Type/Php/ArrayPopFunctionReturnTypeExtension.php� �+g� ��Ƥ 9 src/Type/Php/ArrayFillKeysFunctionReturnTypeExtension.phpF �+gF C�l
� 6 src/Type/Php/ArrayChunkFunctionReturnTypeExtension.phpi �+gi y��� 7 src/Type/Php/DateTimeModifyMethodThrowTypeExtension.php� �+g� ��1-� 1 src/Type/Php/XMLReaderOpenReturnTypeExtension.php� �+g� �h� C src/Type/Php/ReflectionClassIsSubclassOfTypeSpecifyingExtension.php� �+g� ,��Ф src/Type/Php/ConstantHelper.phpZ �+gZ t�9� ? src/Type/Php/NumberFormatFunctionDynamicReturnTypeExtension.php �+g �
vQ� 2 src/Type/Php/StrlenFunctionReturnTypeExtension.php� �+g� S] � ; src/Type/Php/JsonThrowOnErrorDynamicReturnTypeExtension.php� �+g� -�ۤ 3 src/Type/Php/GetClassDynamicReturnTypeExtension.php% �+g% wϡ�� 3 src/Type/Php/DateTimeDynamicReturnTypeExtension.php; �+g; 0��0� 3 src/Type/Php/IsAFunctionTypeSpecifyingExtension.php6 �+g6 r��ä > src/Type/Php/CurlGetinfoFunctionDynamicReturnTypeExtension.php� �+g� �x�!� 4 src/Type/Php/ArrayNextDynamicReturnTypeExtension.php� �+g� * E� 5 src/Type/Php/MicrotimeFunctionReturnTypeExtension.php� �+g� ���¤ 6 src/Type/Php/ArraySliceFunctionReturnTypeExtension.phpy �+gy �X � 0 src/Type/Php/DateFunctionReturnTypeExtension.php� �+g� �DԤ src/Type/TypeUtils.php~2 �+g~2 &, � / src/Type/DynamicFunctionReturnTypeExtension.php~ �+g~ ���� src/Type/NewObjectType.php6
�+g6
��� � ' src/Type/NonexistentParentClassType.php� �+g� �z� src/Type/SubtractableType.php� �+g� ���� src/Type/Type.php�/ �+g�/ ��l � 0 src/Type/MethodParameterClosureTypeExtension.phps �+gs �MҌ� src/Type/NeverType.php6 �+g6 ]���� ( src/Type/ParserNodeTypeToPHPStanType.php� �+g� �2��� src/Type/TypeResult.php� �+g� ��(� " src/Type/LooseComparisonHelper.php� �+g� 9�ͤ src/Type/ObjectType.php�� �+g�� s�� 2 src/Type/FunctionParameterClosureTypeExtension.php� �+g� _��� src/Type/StringType.php� �+g� ��̤ src/Type/AcceptsResult.php� �+g� ���N� src/Type/StaticType.phpu] �+gu] ���� src/Type/ClosureTypeFactory.phpl �+gl ?��ݤ 6 src/Type/StaticMethodParameterClosureTypeExtension.php� �+g� c�}B� src/Type/ConditionalType.php� �+g� ��� src/Type/TypeAliasResolver.php4 �+g4 Л�� ' src/Type/CircularTypeAliasErrorType.php� �+g� [}��� src/Type/ErrorType.php� �+g� X�ä src/Type/CallableType.php&P �+g&P Kg�� src/Type/UnionTypeHelper.php~ �+g~ �"o� src/Type/IntegerType.php� �+g� ��:� src/Type/ThisType.php? �+g? w�-� src/Type/TypeAlias.phpi �+gi 9�
� src/Type/ObjectShapeType.php�G �+g�G �a�� & src/Type/TypeAliasResolverProvider.php� �+g� ��!n� src/Type/GeneralizePrecision.php �+g 0�"?� ' src/Type/Helper/GetTemplateTypeType.php�
�+g�
��
� ' src/Process/ProcessCrashedException.php� �+g� &�Ф src/Process/ProcessHelper.phpY �+gY O�k� src/Process/ProcessPromise.phpz �+gz ��ɤ ( src/Process/ProcessCanceledException.php� �+g� w@X�� src/Process/CpuCoreCounter.php� �+g� �90� src/AnalysedCodeException.php� �+g� iqE^� " src/Diagnose/DiagnoseExtension.php� �+g� ���פ ) src/Diagnose/PHPStanDiagnoseExtension.php� �+g� ���� src/ShouldNotHappenException.php �+g ��� $ src/Php/PhpVersionFactoryFactory.php� �+g� �g�,� src/Php/PhpVersionFactory.php� �+g� ^ �Ф src/Php/PhpVersion.php+" �+g+" P\�� 4 src/DependencyInjection/ConditionalTagsExtension.php� �+g� rvㄤ ) src/DependencyInjection/LoaderFactory.php, �+g, �{*� ( src/DependencyInjection/Configurator.php �+g
PE
� 8 src/DependencyInjection/InvalidExcludePathsException.php' �+g' �Ԕ~� S src/DependencyInjection/Reflection/LazyClassReflectionExtensionRegistryProvider.php, �+g, ��b� O src/DependencyInjection/Reflection/ClassReflectionExtensionRegistryProvider.php
�+g
�r�� ; src/DependencyInjection/DuplicateIncludedFilesException.phpp �+gp ;i� 6 src/DependencyInjection/DerivativeContainerFactory.phpD �+gD �Cŏ� - src/DependencyInjection/Neon/OptionalPath.php �+g `G�Ť & src/DependencyInjection/NeonLoader.php� �+g� d�C٤ . src/DependencyInjection/BleedingEdgeToggle.php� �+g� 7�a�� 6 src/DependencyInjection/ParameterNotFoundException.phpP �+gP D� F src/DependencyInjection/Type/LazyParameterOutTypeExtensionProvider.php[ �+g[ ��j4� T src/DependencyInjection/Type/LazyOperatorTypeSpecifyingExtensionRegistryProvider.php �+g �e('� F src/DependencyInjection/Type/ParameterClosureTypeExtensionProvider.php� �+g� I{� P src/DependencyInjection/Type/OperatorTypeSpecifyingExtensionRegistryProvider.php �+g ��s)� O src/DependencyInjection/Type/LazyDynamicReturnTypeExtensionRegistryProvider.php! �+g! ;-j�� B src/DependencyInjection/Type/DynamicThrowTypeExtensionProvider.php� �+g� �p�դ T src/DependencyInjection/Type/LazyExpressionTypeResolverExtensionRegistryProvider.php� �+g� �Rפ B src/DependencyInjection/Type/ParameterOutTypeExtensionProvider.php� �+g� ����� J src/DependencyInjection/Type/LazyParameterClosureTypeExtensionProvider.php{ �+g{ � ä F src/DependencyInjection/Type/LazyDynamicThrowTypeExtensionProvider.php[ �+g[ ��*Ǥ K src/DependencyInjection/Type/DynamicReturnTypeExtensionRegistryProvider.php �+g ;r�� P src/DependencyInjection/Type/ExpressionTypeResolverExtensionRegistryProvider.php �+g �楤 / src/DependencyInjection/ProjectConfigHelper.php� �+g� +BC�� , src/DependencyInjection/ContainerFactory.php]; �+g]; 7�Ƶ� % src/DependencyInjection/Container.php� �+g� �qm5� 0 src/DependencyInjection/Nette/NetteContainer.phpL �+gL ��zz� ' src/DependencyInjection/NeonAdapter.php� �+g� ��
2� * src/DependencyInjection/RulesExtension.php �+g �=�� 5 src/DependencyInjection/ParametersSchemaExtension.php� �+g� X��P� : src/DependencyInjection/ValidateIgnoredErrorsExtension.php! �+g! <�ӽ� . src/DependencyInjection/MemoizingContainer.php �+g ��mr� 9 src/DependencyInjection/ValidateExcludePathsExtension.phpw
�+gw
�1h�� @ src/DependencyInjection/InvalidIgnoredErrorPatternsException.php/ �+g/ �6�� 4 src/Internal/ContainerDynamicReturnTypeExtension.php) �+g) ��wC� # src/Internal/CombinationsHelper.php �+g {�ou� src/Internal/BytesHelper.php� �+g� �e| � * src/Internal/DirectoryCreatorException.php8 �+g8 �~� src/Internal/SprintfHelper.php� �+g� � 6�� ! src/Internal/DirectoryCreator.php� �+g� z�y�� src/Internal/ComposerHelper.php �+g F/?�� src/Parallel/Process.php� �+g� ��� src/Parallel/Scheduler.php� �+g� ���� ) src/Parallel/ProcessTimedOutException.php� �+g� �ߤ src/Parallel/Schedule.php� �+g� ��� ! src/Parallel/ParallelAnalyser.php�1 �+g�1 w_�� src/Parallel/ProcessPool.phpj �+gj 1��q� src/Testing/PHPStanTestCase.php!% �+g!% zQ�� src/Testing/RuleTestCase.phpW �+gW [4�� src/Testing/LevelsTestCase.php �+g G�l� , src/Testing/TestCaseSourceLocatorFactory.phpi �+gi ���� % src/Testing/TypeInferenceTestCase.php5 �+g5 ����� & src/Testing/ErrorFormatterTestCase.php; �+g; i��N� src/Testing/functions.php� �+g� �-c� src/Testing/TestCase.neon� �+g� ;,!� % src/Parser/TraitCollectingVisitor.php� �+g� }4(Ĥ src/Parser/CleaningVisitor.php\ �+g\ ���H� # src/Parser/CurlSetOptArgVisitor.php� �+g� �Ac� src/Parser/CleaningParser.php� �+g� �ԱD� & src/Parser/ClosureBindToVarVisitor.php� �+g� �B� � " src/Parser/ArrayFindArgVisitor.php �+g ̲?�� $ src/Parser/AnonymousClassVisitor.phpf �+gf ,G�� + src/Parser/NewAssignedToPropertyVisitor.php� �+g� �X� � " src/Parser/TryCatchTypeVisitor.php� �+g� �K>�� " src/Parser/ArrayWalkArgVisitor.php� �+g� +F�� ! src/Parser/PhpParserDecorator.php� �+g� #�ߤ src/Parser/RichParser.php�3 �+g�3 ����� 4 src/Parser/RemoveUnusedCodeByPhpVersionIdVisitor.phpS
�+gS
��SL� & src/Parser/ArrowFunctionArgVisitor.php� �+g� ���Ǥ % src/Parser/DeclarePositionVisitor.php� �+g� �mA�� src/Parser/PathRoutingParser.php� �+g� '�\K� $ src/Parser/ParserErrorsException.php� �+g� ��<)� $ src/Parser/ClosureBindArgVisitor.php �+g `�i� src/Parser/LexerFactory.php� �+g� $�B9� * src/Parser/FunctionCallStatementFinder.php� �+g� �Jy�� src/Parser/CachedParser.php�
�+g�
64l�� # src/Parser/LastConditionVisitor.php�
�+g�
�o�� / src/Parser/MagicConstantParamDefaultVisitor.php �+g ��Bä src/Parser/ClosureArgVisitor.php� �+g� g��ˤ - src/Parser/TypeTraverserInstanceofVisitor.php( �+g( �Q�F� ! src/Parser/ArrayMapArgVisitor.php� �+g� ,z츤 $ src/Parser/ArrayFilterArgVisitor.php� �+g� Nh�5� / src/Parser/ImmediatelyInvokedClosureVisitor.php �+g Ňo�� % src/Parser/ParentStmtTypesVisitor.phpn �+gn &ܤ src/Parser/SimpleParser.php� �+g� Fa �� src/Parser/Parser.php� �+g� �_8�� src/Dependency/ExportedNode.phpa �+ga V�N� ' src/Dependency/ExportedNodeResolver.php. �+g. b?c�� % src/Dependency/DependencyResolver.phpM� �+gM� w͖1� # src/Dependency/NodeDependencies.php� �+g� ���W� # src/Dependency/RootExportedNode.php� �+g� ]65� 4 src/Dependency/ExportedNode/ExportedEnumCaseNode.php� �+g� ��� 1 src/Dependency/ExportedNode/ExportedClassNode.phpS �+gS
o� 9 src/Dependency/ExportedNode/ExportedClassConstantNode.phpU �+gU �a�%� 2 src/Dependency/ExportedNode/ExportedMethodNode.php� �+g� B��� 5 src/Dependency/ExportedNode/ExportedInterfaceNode.php �+g }�A� : src/Dependency/ExportedNode/ExportedClassConstantsNode.php� �+g� ��)8� 4 src/Dependency/ExportedNode/ExportedFunctionNode.php� �+g� 6u�� 0 src/Dependency/ExportedNode/ExportedEnumNode.php� �+g� ��Vt� 1 src/Dependency/ExportedNode/ExportedTraitNode.php9 �+g9 U)�פ : src/Dependency/ExportedNode/ExportedTraitUseAdaptation.phpF
�+gF
�)� 5 src/Dependency/ExportedNode/ExportedParameterNode.php� �+g� ��Ȥ 2 src/Dependency/ExportedNode/ExportedPhpDocNode.php) �+g) ����� 6 src/Dependency/ExportedNode/ExportedPropertiesNode.php$ �+g$ 2�l٤ 5 src/Dependency/ExportedNode/ExportedAttributeNode.php �+g 0�7� & src/Dependency/ExportedNodeFetcher.php� �+g� �*^� & src/Dependency/ExportedNodeVisitor.php �+g �Y� src/Cache/FileCacheStorage.phpO �+gO �;A� src/Cache/Cache.phpg �+gg ��`� src/Cache/CacheStorage.php0 �+g0 � ��� src/Cache/MemoryCacheStorage.phpO �+gO
�kB� src/Cache/CacheItem.php8 �+g8 O�IW� ( src/Broker/FunctionNotFoundException.php� �+g� r� �� ( src/Broker/ConstantNotFoundException.php� �+g� �cH� ' src/Broker/AnonymousClassNameHelper.php� �+g� k�0<� % src/Broker/ClassNotFoundException.php� �+g� �^zߤ src/Broker/Broker.php �+g &��� src/Broker/BrokerFactory.php� �+g� 6QΗ� ( src/Broker/ClassAutoloadingException.php� �+g� !u�V� src/TrinaryLogic.php� �+g� �3*� src/PhpDoc/Tag/VarTag.php �+g Ʃ�(� src/PhpDoc/Tag/DeprecatedTag.phpc �+gc �V� src/PhpDoc/Tag/UsesTag.phpY �+gY �{02� src/PhpDoc/Tag/TemplateTag.phpb �+gb a��� src/PhpDoc/Tag/TypeAliasTag.php? �+g? ��� ! src/PhpDoc/Tag/SelfOutTypeTag.php �+g � �� & src/PhpDoc/Tag/ParamClosureThisTag.php+ �+g+ ֨�� % src/PhpDoc/Tag/TypeAliasImportTag.php8 �+g8 �Atw� src/PhpDoc/Tag/ImplementsTag.php_ �+g_ %A�;� % src/PhpDoc/Tag/MethodTagParameter.php �+g �<a8� src/PhpDoc/Tag/ExtendsTag.php\ �+g\ 5Y!�� src/PhpDoc/Tag/ThrowsTag.php[ �+g[ �*
� src/PhpDoc/Tag/ParamOutTag.php �+g ~m;� src/PhpDoc/Tag/TypedTag.php� �+g� �*�4� src/PhpDoc/Tag/MethodTag.php �+g
��� src/PhpDoc/Tag/AssertTag.php� �+g� ��3� src/PhpDoc/Tag/ParamTag.php� �+g� 9�]�� $ src/PhpDoc/Tag/RequireExtendsTag.phpc �+gc H�D�� src/PhpDoc/Tag/MixinTag.phpZ �+gZ i��Τ src/PhpDoc/Tag/PropertyTag.php� �+g� �
� src/PhpDoc/Tag/ReturnTag.php[ �+g[ �n�֤ % src/PhpDoc/Tag/AssertTagParameter.php� �+g� ��� ' src/PhpDoc/Tag/RequireImplementsTag.phpf �+gf | �� < src/PhpDoc/LazyTypeNodeResolverExtensionRegistryProvider.php� �+g� �� ! src/PhpDoc/TypeStringResolver.php� �+g� ��j� src/PhpDoc/StubFilesProvider.php� �+g� ��%� 8 src/PhpDoc/TypeNodeResolverExtensionRegistryProvider.php� �+g� p:(�� ! src/PhpDoc/PhpDocNodeResolver.php�h �+g�h �Jcͤ > src/PhpDoc/DirectTypeNodeResolverExtensionRegistryProvider.php& �+g& � N� ' src/PhpDoc/StubSourceLocatorFactory.php3 �+g3 ���ͤ / src/PhpDoc/ReflectionEnumStubFilesExtension.php* �+g* ��� src/PhpDoc/TypeNodeResolver.php� �+g� �r_� % src/PhpDoc/ConstExprParserFactory.php� �+g� �פ ( src/PhpDoc/PhpDocInheritanceResolver.php �+g ���� ! src/PhpDoc/StubPhpDocProvider.phpF2 �+gF2 8)g� - src/PhpDoc/JsonValidateStubFilesExtension.php. �+g. 4-�ݤ src/PhpDoc/PhpDocBlock.php�, �+g�, ��/� " src/PhpDoc/ResolvedPhpDocBlock.phpę �+gę GD�*� $ src/PhpDoc/ConstExprNodeResolver.php �+g �c
� 5 src/PhpDoc/TypeNodeResolverExtensionAwareRegistry.phpq �+gq QA� ' src/PhpDoc/DefaultStubFilesProvider.php� �+g� P�ۤ 0 src/PhpDoc/TypeNodeResolverExtensionRegistry.php� �+g� u� � src/PhpDoc/StubValidator.php�7 �+g�7 喚0� - src/PhpDoc/TypeNodeResolverAwareExtension.php� �+g� N�,s� * src/PhpDoc/CountableStubFilesExtension.php$ �+g$ s�UV� # src/PhpDoc/PhpDocStringResolver.php� �+g� ;�ܤ ( src/PhpDoc/TypeNodeResolverExtension.php �+g �)� ! src/PhpDoc/StubFilesExtension.phpt �+gt �R��� - src/PhpDoc/SocketSelectStubFilesExtension.php^ �+g^ �D�ˤ stubs/arrayFunctions.stub� �+g� ~�� stubs/iterable.stub�# �+g�# �)k � stubs/ArrayObject.stub �+g ��jM� stubs/mysqli.stubX �+gX � FV� stubs/socket_select.stub� �+g� f/�� stubs/Countable.stubd �+gd �䞤 stubs/json_validate.stub� �+g� �v�R� % stubs/ReflectionFunctionAbstract.stub �+g V�cȤ stubs/core.stub$ �+g$ �-)� stubs/socket_select_php8.stub� �+g� ��٤ stubs/ReflectionMethod.stub� �+g� �ä� stubs/ReflectionClass.stub �+g ��ڤ stubs/spl.stub/ �+g/
��� stubs/ReflectionAttribute.stub �+g q���� ! stubs/bleedingEdge/Countable.stubo �+go
�U� stubs/bleedingEdge/Rule.stub� �+g� PE� stubs/ImagickPixel.stubp �+gp +��� stubs/ibm_db2.stub �+g �c�Ҥ stubs/Exception.stub- �+g- W� m� stubs/date.stub �+g �fa� stubs/PDOStatement.stub� �+g� ���� stubs/zip.stub4 �+g4 ��#� stubs/ReflectionEnum.stubh �+gh ݠFߤ stubs/dom.stubM �+gM M
=� stubs/SplObjectStorage.stub� �+g� �+�q� stubs/ReflectionProperty.stub� �+g� Xڛڤ " stubs/ReflectionClassConstant.stub� �+g� D�xd� stubs/ext-ds.stubw8 �+gw8
&�� stubs/WeakReference.stub` �+g` �`�� stubs/runtime/Enum/UnitEnum.php� �+g� � � / stubs/runtime/Enum/ReflectionEnumBackedCase.php� �+g� ;7y� ! stubs/runtime/Enum/BackedEnum.php
�+g
��M� - stubs/runtime/Enum/ReflectionEnumUnitCase.php� �+g� ��� % stubs/runtime/Enum/ReflectionEnum.php� �+g� ��mG� stubs/runtime/Attribute.php9 �+g9 Qۊ�� % stubs/runtime/ReflectionAttribute.php� �+g� �="� , stubs/runtime/ReflectionIntersectionType.php �+g ���;� % stubs/runtime/ReflectionUnionType.php� �+g� �D=� stubs/ReflectionParameter.stub� �+g� �5�Τ stubs/typeCheckingFunctions.stub^ �+g^ U5 ¤ 3 vendor/symfony/service-contracts/ResetInterface.php� �+g� �a�� 7 vendor/symfony/service-contracts/Attribute/Required.php� �+g� db�� @ vendor/symfony/service-contracts/Attribute/SubscribedService.php: �+g: \r��� ( vendor/symfony/service-contracts/LICENSE, �+g, � ��� ? vendor/symfony/service-contracts/ServiceSubscriberInterface.php� �+g� `k�� 8 vendor/symfony/service-contracts/ServiceLocatorTrait.php �+g � �c� ; vendor/symfony/service-contracts/ServiceSubscriberTrait.php� �+g� 5ܤ = vendor/symfony/service-contracts/ServiceProviderInterface.php� �+g� ��4� , vendor/symfony/deprecation-contracts/LICENSE, �+g, K� 1 vendor/symfony/deprecation-contracts/function.php2 �+g2 E��]� 3 vendor/symfony/polyfill-intl-grapheme/bootstrap.php� �+g� ��� - vendor/symfony/polyfill-intl-grapheme/LICENSE, �+g, �� H� 5 vendor/symfony/polyfill-intl-grapheme/bootstrap80.phpg
�+gg
��E{� 2 vendor/symfony/polyfill-intl-grapheme/Grapheme.php8& �+g8& � �I� " vendor/symfony/process/Process.php�� �+g�� 5�)� / vendor/symfony/process/Pipes/PipesInterface.php� �+g� ��� . vendor/symfony/process/Pipes/AbstractPipes.php� �+g� 8ಷ� * vendor/symfony/process/Pipes/UnixPipes.php� �+g� ��V� - vendor/symfony/process/Pipes/WindowsPipes.phpo �+go �%9�� vendor/symfony/process/LICENSE, �+g, ���U� % vendor/symfony/process/PhpProcess.php� �+g� =���� 5 vendor/symfony/process/Exception/RuntimeException.php� �+g� ���L� = vendor/symfony/process/Exception/ProcessSignaledException.php� �+g� � �� = vendor/symfony/process/Exception/ProcessTimedOutException.php| �+g| ��wI� 7 vendor/symfony/process/Exception/ExceptionInterface.php� �+g� � �E� 3 vendor/symfony/process/Exception/LogicException.php� �+g� zg�� ; vendor/symfony/process/Exception/ProcessFailedException.phpI �+gI ͱjK� = vendor/symfony/process/Exception/InvalidArgumentException.php �+g ��C�� + vendor/symfony/process/ExecutableFinder.php� �+g� �=�� ' vendor/symfony/process/ProcessUtils.php\ �+g\ gr퍤 & vendor/symfony/process/InputStream.php� �+g� �&� � . vendor/symfony/process/PhpExecutableFinder.phpa
�+ga
Y�EZ� - vendor/symfony/polyfill-mbstring/Mbstring.php�� �+g�� �Ѥ F vendor/symfony/polyfill-mbstring/Resources/unidata/titleCaseRegexp.php9 �+g9 >|zK� @ vendor/symfony/polyfill-mbstring/Resources/unidata/lowerCase.php�_ �+g�_ ���d� @ vendor/symfony/polyfill-mbstring/Resources/unidata/upperCase.php�f �+g�f �P�� B vendor/symfony/polyfill-mbstring/Resources/unidata/caseFolding.phpa �+ga �|ⳤ . vendor/symfony/polyfill-mbstring/bootstrap.php� �+g� O� a� ( vendor/symfony/polyfill-mbstring/LICENSE, �+g, �� H� 0 vendor/symfony/polyfill-mbstring/bootstrap80.php�$ �+g�$ �c�j� ' vendor/symfony/string/UnicodeString.php�2 �+g�2 }�"�� < vendor/symfony/string/Resources/data/wcswidth_table_zero.php� �+g� %V�Ӥ < vendor/symfony/string/Resources/data/wcswidth_table_wide.php �+g H �� - vendor/symfony/string/Resources/functions.phpp �+gp ��q,� vendor/symfony/string/LICENSE, �+g, զ_Ϥ ) vendor/symfony/string/CodePointString.php� �+g� ֬�� $ vendor/symfony/string/LazyString.phpr �+gr 7v�A� 4 vendor/symfony/string/Exception/RuntimeException.php� �+g� �jJ� 6 vendor/symfony/string/Exception/ExceptionInterface.phpc �+gc
m(/� < vendor/symfony/string/Exception/InvalidArgumentException.php� �+g� ��{� . vendor/symfony/string/Slugger/AsciiSlugger.php3 �+g3
Lz٤ 2 vendor/symfony/string/Slugger/SluggerInterface.php� �+g� �_l_� $ vendor/symfony/string/ByteString.php�< �+g�< +#�U� / vendor/symfony/string/AbstractUnicodeString.phpai �+gai �� X� 3 vendor/symfony/string/Inflector/FrenchInflector.php$ �+g$ `�2�� 4 vendor/symfony/string/Inflector/EnglishInflector.php�B �+g�B E��h� 6 vendor/symfony/string/Inflector/InflectorInterface.phpV �+gV ��Ar� ( vendor/symfony/string/AbstractString.php�O �+g�O C�+�� ? vendor/symfony/polyfill-php73/Resources/stubs/JsonException.phpE �+gE 8S�� + vendor/symfony/polyfill-php73/bootstrap.php� �+g� ��|� % vendor/symfony/polyfill-php73/LICENSE, �+g, � ��� ' vendor/symfony/polyfill-php73/Php73.phpb �+gb J�<� R vendor/symfony/polyfill-intl-normalizer/Resources/unidata/canonicalComposition.php�D �+g�D '�CԤ T vendor/symfony/polyfill-intl-normalizer/Resources/unidata/canonicalDecomposition.php{� �+g{� �je�� X vendor/symfony/polyfill-intl-normalizer/Resources/unidata/compatibilityDecomposition.phpo �+go c�,�� L vendor/symfony/polyfill-intl-normalizer/Resources/unidata/combiningClass.phpD5 �+gD5 ��� � F vendor/symfony/polyfill-intl-normalizer/Resources/stubs/Normalizer.php� �+g� ���%� 5 vendor/symfony/polyfill-intl-normalizer/bootstrap.php� �+g� #p� � / vendor/symfony/polyfill-intl-normalizer/LICENSE, �+g, �� H� 6 vendor/symfony/polyfill-intl-normalizer/Normalizer.phpd% �+gd% u��� 7 vendor/symfony/polyfill-intl-normalizer/bootstrap80.php� �+g� �,�� + vendor/symfony/polyfill-ctype/bootstrap.php, �+g, �k�|� % vendor/symfony/polyfill-ctype/LICENSE, �+g, � ��� - vendor/symfony/polyfill-ctype/bootstrap80.phph �+gh 8�j�� ' vendor/symfony/polyfill-ctype/Ctype.php� �+g� ��A(� vendor/symfony/console/Color.phpZ �+gZ ���� & vendor/symfony/console/Application.php� �+g� �N� 0 vendor/symfony/console/Resources/completion.bash�
�+g�
�z(� 4 vendor/symfony/console/Resources/bin/hiddeninput.exe $ �+g $ ���v� ! vendor/symfony/console/Cursor.php? �+g? s ^� . vendor/symfony/console/Attribute/AsCommand.phpN �+gN ��iͤ 5 vendor/symfony/console/Completion/CompletionInput.php[ �+g[ k�0� ; vendor/symfony/console/Completion/CompletionSuggestions.phpn �+gn j�ۤ F vendor/symfony/console/Completion/Output/CompletionOutputInterface.php� �+g� tsj$� A vendor/symfony/console/Completion/Output/BashCompletionOutput.php �+g P~S� 0 vendor/symfony/console/Completion/Suggestion.php� �+g� dl� � - vendor/symfony/console/Style/SymfonyStyle.php�9 �+g�9 �ۭ.� / vendor/symfony/console/Style/StyleInterface.phpR
�+gR
j��S� , vendor/symfony/console/Style/OutputStyle.phpL �+gL l s-� vendor/symfony/console/LICENSE, �+g, ���U� = vendor/symfony/console/Command/SignalableCommandInterface.php� �+g� uG/� * vendor/symfony/console/Command/Command.php�P �+g�P �H�� . vendor/symfony/console/Command/ListCommand.php �+g +�e� 8 vendor/symfony/console/Command/DumpCompletionCommand.php� �+g� ��O�� . vendor/symfony/console/Command/LazyCommand.phpF �+gF ���� 0 vendor/symfony/console/Command/LockableTrait.php$ �+g$ � -f� 2 vendor/symfony/console/Command/CompleteCommand.php� �+g� � ֤ . vendor/symfony/console/Command/HelpCommand.php �+g ��j� / vendor/symfony/console/Logger/ConsoleLogger.php� �+g� J_�L� / vendor/symfony/console/Tester/CommandTester.phpJ �+gJ �r� - vendor/symfony/console/Tester/TesterTrait.php� �+g� ���0� @ vendor/symfony/console/Tester/Constraint/CommandIsSuccessful.php� �+g� "�w� 3 vendor/symfony/console/Tester/ApplicationTester.php�
�+g�
'�6
� 9 vendor/symfony/console/Tester/CommandCompletionTester.phpL �+gL .H�B� 2 vendor/symfony/console/CI/GithubActionReporter.php# �+g# |.� : vendor/symfony/console/Exception/MissingInputException.php �+g �� ? vendor/symfony/console/Exception/NamespaceNotFoundException.php� �+g� �H f� 5 vendor/symfony/console/Exception/RuntimeException.php� �+g�
�Ϥ ; vendor/symfony/console/Exception/InvalidOptionException.php �+g Y�)v� = vendor/symfony/console/Exception/CommandNotFoundException.php� �+g� �X 7 vendor/symfony/console/Exception/ExceptionInterface.php� �+g� ee�P� 3 vendor/symfony/console/Exception/LogicException.php� �+g� �1x�� = vendor/symfony/console/Exception/InvalidArgumentException.php� �+g� t���� F vendor/symfony/console/Formatter/WrappableOutputFormatterInterface.php� �+g� �+G�� > vendor/symfony/console/Formatter/OutputFormatterStyleStack.php+
�+g+
���� = vendor/symfony/console/Formatter/NullOutputFormatterStyle.php� �+g� \D2�� B vendor/symfony/console/Formatter/OutputFormatterStyleInterface.phpi �+gi �� � 9 vendor/symfony/console/Formatter/OutputFormatterStyle.php� �+g� �`�� 4 vendor/symfony/console/Formatter/OutputFormatter.php� �+g� <�� = vendor/symfony/console/Formatter/OutputFormatterInterface.phpD �+gD I
_l� 8 vendor/symfony/console/Formatter/NullOutputFormatter.phpo �+go ���� ( vendor/symfony/console/ConsoleEvents.php� �+g� :��x� 4 vendor/symfony/console/Event/ConsoleCommandEvent.php= �+g= d%(� 6 vendor/symfony/console/Event/ConsoleTerminateEvent.phpj �+gj t��� 2 vendor/symfony/console/Event/ConsoleErrorEvent.php" �+g" Y�1� 3 vendor/symfony/console/Event/ConsoleSignalEvent.php� �+g� ���u� - vendor/symfony/console/Event/ConsoleEvent.php� �+g� #�\פ 3 vendor/symfony/console/SingleCommandApplication.php9 �+g9 ��U�� 8 vendor/symfony/console/SignalRegistry/SignalRegistry.phpD �+gD S � D vendor/symfony/console/DependencyInjection/AddConsoleCommandPass.php� �+g� ;�xT� 6 vendor/symfony/console/EventListener/ErrorListener.php^ �+g^ �5�p� # vendor/symfony/console/Terminal.phpm �+gm ���� . vendor/symfony/console/Output/StreamOutput.php� �+g� 7�b�� / vendor/symfony/console/Output/ConsoleOutput.php) �+g) ���V� 0 vendor/symfony/console/Output/BufferedOutput.phpc �+gc DQ9=� 1 vendor/symfony/console/Output/OutputInterface.phpt �+gt 2rZ� ( vendor/symfony/console/Output/Output.phpg �+gg �:�� , vendor/symfony/console/Output/NullOutput.php8 �+g8 ��� � 5 vendor/symfony/console/Output/TrimmedBufferOutput.phpo �+go �릤 6 vendor/symfony/console/Output/ConsoleSectionOutput.php� �+g� �k�¤ 8 vendor/symfony/console/Output/ConsoleOutputInterface.php1 �+g1 !F 8 vendor/symfony/console/Question/ConfirmationQuestion.php) �+g) ��{� 2 vendor/symfony/console/Question/ChoiceQuestion.php� �+g� .���� , vendor/symfony/console/Question/Question.php~ �+g~ /��� 8 vendor/symfony/console/Descriptor/MarkdownDescriptor.phpk �+gk U_Ĥ 0 vendor/symfony/console/Descriptor/Descriptor.php �+g ���/� 4 vendor/symfony/console/Descriptor/TextDescriptor.php2 �+g2 �qc�� 3 vendor/symfony/console/Descriptor/XmlDescriptor.php.' �+g.' �Wgz� 4 vendor/symfony/console/Descriptor/JsonDescriptor.php� �+g� �}� 9 vendor/symfony/console/Descriptor/DescriptorInterface.phpQ �+gQ �Wi@� < vendor/symfony/console/Descriptor/ApplicationDescription.php% �+g% {\� ? vendor/symfony/console/CommandLoader/CommandLoaderInterface.php� �+g� 8^ ߤ ? vendor/symfony/console/CommandLoader/ContainerCommandLoader.php �+g S�2� = vendor/symfony/console/CommandLoader/FactoryCommandLoader.phpe �+ge +�#� , vendor/symfony/console/Input/StringInput.php�
�+g�
��� 9 vendor/symfony/console/Input/StreamableInputInterface.phpz �+gz ����� , vendor/symfony/console/Input/InputOption.php` �+g` ⲋ� 0 vendor/symfony/console/Input/InputDefinition.phpT. �+gT. <!F)� * vendor/symfony/console/Input/ArgvInput.php�0 �+g�0 �3?� + vendor/symfony/console/Input/ArrayInput.php� �+g� ��W5� & vendor/symfony/console/Input/Input.php= �+g= <y� . vendor/symfony/console/Input/InputArgument.php�
�+g�
J�/1� 4 vendor/symfony/console/Input/InputAwareInterface.phpL �+gL �5�� / vendor/symfony/console/Input/InputInterface.php� �+g� Cd �� 6 vendor/symfony/console/Helper/DebugFormatterHelper.php\
�+g\
d��i� ( vendor/symfony/console/Helper/Dumper.phpX �+gX ��Y}� 1 vendor/symfony/console/Helper/FormatterHelper.php� �+g� P8��� + vendor/symfony/console/Helper/HelperSet.phpE
�+gE
�B�w� 7 vendor/symfony/console/Helper/SymfonyQuestionHelper.phpG
�+gG
���X� / vendor/symfony/console/Helper/ProcessHelper.php� �+g� U�#ä ( vendor/symfony/console/Helper/Helper.php� �+g� ��u� 2 vendor/symfony/console/Helper/InputAwareHelper.php! �+g! 3Tl�� 0 vendor/symfony/console/Helper/TableSeparator.php% �+g% �Y�X� , vendor/symfony/console/Helper/TableStyle.php�0 �+g�0 � �� - vendor/symfony/console/Helper/ProgressBar.phpOH �+gOH ��*� + vendor/symfony/console/Helper/TableRows.phpV �+gV
ݚ�� 0 vendor/symfony/console/Helper/QuestionHelper.php�L �+g�L 7��U� 0 vendor/symfony/console/Helper/TableCellStyle.phpd �+gd R�>� + vendor/symfony/console/Helper/TableCell.php �+g �`̤ 3 vendor/symfony/console/Helper/ProgressIndicator.php� �+g� ��ä ' vendor/symfony/console/Helper/Table.phps �+gs ��9�� 2 vendor/symfony/console/Helper/DescriptorHelper.php� �+g� /�e � 1 vendor/symfony/console/Helper/HelperInterface.php^ �+g^ �] � F vendor/symfony/polyfill-php81/Resources/stubs/ReturnTypeWillChange.php� �+g� 5�+� @ vendor/symfony/polyfill-php81/Resources/stubs/CURLStringFile.php� �+g� ��JT� + vendor/symfony/polyfill-php81/bootstrap.php� �+g� <P� % vendor/symfony/polyfill-php81/LICENSE, �+g, 0�� ' vendor/symfony/polyfill-php81/Php81.php� �+g� ��$� < vendor/symfony/polyfill-php80/Resources/stubs/Stringable.php� �+g� t]\ڤ : vendor/symfony/polyfill-php80/Resources/stubs/PhpToken.phpw �+gw =7T8� ; vendor/symfony/polyfill-php80/Resources/stubs/Attribute.php� �+g� MK�<� E vendor/symfony/polyfill-php80/Resources/stubs/UnhandledMatchError.phpG �+gG ֈ+� < vendor/symfony/polyfill-php80/Resources/stubs/ValueError.php> �+g> g��� ' vendor/symfony/polyfill-php80/Php80.php�
�+g�
cH��� * vendor/symfony/polyfill-php80/PhpToken.php� �+g� ]f� + vendor/symfony/polyfill-php80/bootstrap.php� �+g� �.Ĥ % vendor/symfony/polyfill-php80/LICENSE, �+g, K� + vendor/symfony/polyfill-php74/bootstrap.php �+g D驤 % vendor/symfony/polyfill-php74/LICENSE, �+g, զ_Ϥ ' vendor/symfony/polyfill-php74/Php74.php�
�+g�
AV܀� 7 vendor/symfony/finder/Iterator/CustomFilterIterator.php3 �+g3 �ߤ / vendor/symfony/finder/Iterator/LazyIterator.php� �+g� � �� 9 vendor/symfony/finder/Iterator/FileTypeFilterIterator.php� �+g� �dO�� A vendor/symfony/finder/Iterator/ExcludeDirectoryFilterIterator.php�
�+g�
�`��� = vendor/symfony/finder/Iterator/RecursiveDirectoryIterator.php� �+g� �� 9 vendor/symfony/finder/Iterator/FilenameFilterIterator.php� �+g� ��_C� < vendor/symfony/finder/Iterator/FilecontentFilterIterator.php� �+g� ZFIv� 3 vendor/symfony/finder/Iterator/SortableIterator.phpj �+gj V���� : vendor/symfony/finder/Iterator/SizeRangeFilterIterator.php� �+g� �h��� 5 vendor/symfony/finder/Iterator/PathFilterIterator.php� �+g� j��J� : vendor/symfony/finder/Iterator/DateRangeFilterIterator.php� �+g� I!㙤 = vendor/symfony/finder/Iterator/MultiplePcreFilterIterator.php� �+g� �Gއ� ; vendor/symfony/finder/Iterator/DepthRangeFilterIterator.php� �+g� �l�,� ; vendor/symfony/finder/Iterator/VcsIgnoredFilterIterator.php� �+g� E�B!� vendor/symfony/finder/LICENSE, �+g, ���U� # vendor/symfony/finder/Gitignore.php% �+g% 6��Τ vendor/symfony/finder/Finder.php�X �+g�X �60� > vendor/symfony/finder/Exception/DirectoryNotFoundException.php� �+g� |'� 9 vendor/symfony/finder/Exception/AccessDeniedException.php� �+g� �=IӤ % vendor/symfony/finder/SplFileInfo.php, �+g, m��!� 3 vendor/symfony/finder/Comparator/DateComparator.php� �+g� r�0� 5 vendor/symfony/finder/Comparator/NumberComparator.php
�+g
��#�� / vendor/symfony/finder/Comparator/Comparator.php� �+g� l@
k� vendor/symfony/finder/Glob.phpJ �+gJ �4 � 3 vendor/ondrejmirtes/better-reflection/renovate.json� �+g� ��{�� - vendor/ondrejmirtes/better-reflection/LICENSE6 �+g6 Ww� � G vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionType.phpV �+gV = �a� L vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionParameter.php?E �+g?E � �I� \ vendor/ondrejmirtes/better-reflection/src/Reflection/Attribute/ReflectionAttributeHelper.php3 �+g3 K� �� [ vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionAttributeFactory.php6 �+g6 ��� Y vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionEnumBackedCase.php� �+g� �M
C� O vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionType.php� �+g� Rc/F� T vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionParameter.phpt# �+gt# �.��� T vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionAttribute.php �+g �C,�� P vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionClass.php!U �+g!U ��>X� Q vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionMethod.phpV- �+gV- S <� Y vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/Exception/NotImplemented.php� �+g� IRe� S vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionFunction.php\" �+g\" �Ma�� X vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/FakeReflectionAttribute.php� �+g� �r � [ vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionIntersectionType.php1 �+g1 �{w�� X vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionClassConstant.phph �+gh ̬!� S vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionProperty.php �+g ���u� T vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionUnionType.php �+g |��� W vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionEnumUnitCase.php� �+g� 1?�~� T vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionNamedType.php� �+g� ��SN� Q vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionObject.phprG �+grG ��e�� O vendor/ondrejmirtes/better-reflection/src/Reflection/Adapter/ReflectionEnum.phpSK �+gSK ��W�� L vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionAttribute.php� �+g� ��Ĥ V vendor/ondrejmirtes/better-reflection/src/Reflection/Support/AlreadyVisitedClasses.php] �+g] %0�� H vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionClass.php�� �+g�� �
Z� I vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionMethod.php�= �+g�= ��<7� T vendor/ondrejmirtes/better-reflection/src/Reflection/Annotation/AnnotationHelper.php2 �+g2 i�
ˤ C vendor/ondrejmirtes/better-reflection/src/Reflection/Reflection.php� �+g� RuK� [ vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/ObjectNotInstanceOfClass.phpx �+gx ��w� 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/InvalidConstantNode.php �+g
� K vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/NoParent.php� �+g� �ߤ V vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/CodeLocationMissing.php �+g ���� V vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/PropertyIsNotStatic.php[ �+g[ ��� Z vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/InvalidDefaultValueType.php� �+g� �udB� W vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/PropertyDoesNotExist.php] �+g] /7i[� Z vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/MethodPrototypeNotFound.php� �+g� 2�7V� S vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/NoObjectProvided.php �+g �/�� _ vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/InvalidArrowFunctionBodyNode.php, �+g, �pJͤ W vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/FunctionDoesNotExist.php{ �+g{ ��c�� T vendor/ondrejmirtes/better-reflection/src/Reflection/Exception/ClassDoesNotExist.php� �+g� ��n� S vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionFunctionAbstract.phpj< �+gj< ��L�� K vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionFunction.php� �+g� �CԤ S vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionIntersectionType.php�
�+g�
����� P vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionClassConstant.php�) �+g�) a xפ K vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionConstant.php�' �+g�' � � K vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionProperty.php"K �+g"K ��]�� ] vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionClassStringCast.php(# �+g(# �U��� ` vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionFunctionStringCast.php �+g F[3�� a vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionAttributeStringCast.phpW �+gW h��W� \ vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionTypeStringCast.php: �+g: l1τ� ^ vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionMethodStringCast.phpy �+gy ��+� ` vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionConstantStringCast.php� �+g� p���� e vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionClassConstantStringCast.php� �+g� m��4� ` vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionPropertyStringCast.phpJ �+gJ ��/�� a vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionParameterStringCast.phpe �+ge *�� ` vendor/ondrejmirtes/better-reflection/src/Reflection/StringCast/ReflectionEnumCaseStringCast.php �+g �2^�� K vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionEnumCase.php� �+g� =�'� L vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionUnionType.php� �+g� ��<z� L vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionNamedType.php. �+g. �\ڤ I vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionObject.php�6 �+g�6 PB�e� G vendor/ondrejmirtes/better-reflection/src/Reflection/ReflectionEnum.phpj �+gj 2�� X vendor/ondrejmirtes/better-reflection/src/NodeCompiler/Exception/UnableToCompileNode.php� �+g� vNҺ� J vendor/ondrejmirtes/better-reflection/src/NodeCompiler/CompilerContext.php_ �+g_ Z��W� M vendor/ondrejmirtes/better-reflection/src/NodeCompiler/CompileNodeToValue.php�3 �+g�3 ���T� H vendor/ondrejmirtes/better-reflection/src/NodeCompiler/CompiledValue.php� �+g� _���� H vendor/ondrejmirtes/better-reflection/src/Util/ClassExistenceChecker.php{ �+g{ ���J� = vendor/ondrejmirtes/better-reflection/src/Util/FileHelper.phpf �+gf AuL� D vendor/ondrejmirtes/better-reflection/src/Util/GetLastDocComment.php� �+g� ��t� K vendor/ondrejmirtes/better-reflection/src/Util/Exception/NoNodePosition.php� �+g� $��� P vendor/ondrejmirtes/better-reflection/src/Util/Exception/InvalidNodePosition.phpV �+gV >U�ݤ G vendor/ondrejmirtes/better-reflection/src/Util/FindReflectionOnLine.php� �+g� P5�ˤ L vendor/ondrejmirtes/better-reflection/src/Util/CalculateReflectionColumn.php� �+g� 5�_�� F vendor/ondrejmirtes/better-reflection/src/Util/ConstantNodeChecker.php� �+g� ߸�C� > vendor/ondrejmirtes/better-reflection/src/BetterReflection.php �+g JSo3� a vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/ReflectionSourceStubber.php(z �+g(z HL� m vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/Exception/CouldNotFindPhpStormStubs.php0 �+g0 ��~�� d vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/PhpStormStubsSourceStubber.php�| �+g�| /8
U� ` vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/AggregateSourceStubber.php �+g ��)�� f vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/PhpStormStubs/CachingVisitor.phpt �+gt ���� W vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/SourceStubber.php� �+g� �ϭ� R vendor/ondrejmirtes/better-reflection/src/SourceLocator/SourceStubber/StubData.php� �+g� ��$դ [ vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/TwoClosuresOnSameLine.phpr �+gr �� Ӥ c vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/TwoAnonymousClassesOnSameLine.php� �+g� M/��� U vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/InvalidFileInfo.php+ �+g+ J"�� Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/InvalidFileLocation.php� �+g� ����� \ vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/NoAnonymousClassOnLine.php �+g �\� V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/InvalidDirectory.php� �+g� �d�T� i vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/EvaledAnonymousClassCannotBeLocated.php3 �+g3 �6Ǯ� b vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/EvaledClosureCannotBeLocated.php$ �+g$ d�Ϥ V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/NotInternalClass.php� �+g� �zׯ� W vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/FunctionUndefined.phpV �+gV N0� � U vendor/ondrejmirtes/better-reflection/src/SourceLocator/Exception/NoClosureOnLine.phpp �+gp ��G� X vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/EvaledCodeSourceLocator.php� �+g� W��v� W vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/MemoizingSourceLocator.php�
�+g�
_��ۤ T vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/StringSourceLocator.php1 �+g1 <>�٤ b vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/AnonymousClassObjectSourceLocator.phpD �+gD �Nw� X vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/SingleFileSourceLocator.phpT �+gT zE{G� N vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/SourceLocator.php+ �+g+ C�=� U vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/ClosureSourceLocator.php} �+g} M$�Ф V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/AbstractSourceLocator.php= �+g= �*��� p vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/AutoloadSourceLocator/FileReadTrapStreamWrapper.php~ �+g~ ��J`� V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/AutoloadSourceLocator.php�. �+g�. ��yS� W vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/AggregateSourceLocator.php �+g �H��� Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/DirectoriesSourceLocator.php� �+g� 8QvY� l vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Psr/Exception/InvalidPrefixMapping.phps �+gs � a vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Psr/Exception/Exception.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/Composer/Psr/Psr4Mapping.php
�+g
���� ^ vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/PsrAutoloaderLocator.php� �+g� X4 m� m vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/MakeLocatorForInstalledJson.php� �+g� �#@� l vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/MakeLocatorForComposerJson.php �+g ��L+� s vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/Exception/InvalidProjectDirectory.php� �+g� �!4l� 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� e vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/Exception/Exception.php� �+g� �Z�\� m vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/Exception/FailedToParseJson.php� �+g� '�<�� | vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/Composer/Factory/MakeLocatorForComposerJsonAndInstalledJson.phpo �+go :��� V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/ComposerSourceLocator.php� �+g� �Ҥ Z vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/FileIteratorSourceLocator.php
�+g
ʑqW� Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Type/PhpInternalSourceLocator.php2 �+g2 ��� Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Located/InternalLocatedSource.php �+g ��z�� Q vendor/ondrejmirtes/better-reflection/src/SourceLocator/Located/LocatedSource.php
�+g
SΤ Z vendor/ondrejmirtes/better-reflection/src/SourceLocator/Located/AnonymousLocatedSource.phpt �+gt �m � W vendor/ondrejmirtes/better-reflection/src/SourceLocator/Located/EvaledLocatedSource.php4 �+g4 {rj� V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Located/AliasLocatedSource.phpO �+gO ����� U vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/FindReflectionsInTree.php0 �+g0 d �� Y vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/Strategy/NodeToReflection.php� �+g� |~�� ^ vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/Strategy/AstConversionStrategy.php� �+g� �Ϝ� [ vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/Exception/ParseToAstFailure.php� �+g� J�:�� G vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/Locator.php( �+g( ���a� V vendor/ondrejmirtes/better-reflection/src/SourceLocator/Ast/Parser/MemoizingParser.php� �+g� g� �� G vendor/ondrejmirtes/better-reflection/src/SourceLocator/FileChecker.php� �+g� )��M� I vendor/ondrejmirtes/better-reflection/src/Reflector/ConstantReflector.php� �+g� ��$E� F vendor/ondrejmirtes/better-reflection/src/Reflector/ClassReflector.php� �+g� �E� I vendor/ondrejmirtes/better-reflection/src/Reflector/FunctionReflector.php� �+g� a�8Ҥ T vendor/ondrejmirtes/better-reflection/src/Reflector/Exception/IdentifierNotFound.phpL �+gL ޤ'� A vendor/ondrejmirtes/better-reflection/src/Reflector/Reflector.php �+g b�y�� H vendor/ondrejmirtes/better-reflection/src/Reflector/DefaultReflector.php �+g ��� G vendor/ondrejmirtes/better-reflection/src/Identifier/IdentifierType.php� �+g� ��lޤ X vendor/ondrejmirtes/better-reflection/src/Identifier/Exception/InvalidIdentifierName.phpe �+ge �ZJ� C vendor/ondrejmirtes/better-reflection/src/Identifier/Identifier.php� �+g� qb!�� " vendor/evenement/evenement/LICENSE �+g �{I=� 8 vendor/evenement/evenement/src/EventEmitterInterface.php� �+g� ��{A� / vendor/evenement/evenement/src/EventEmitter.phpr �+gr �E2�� 4 vendor/evenement/evenement/src/EventEmitterTrait.phpY �+gY " �� # vendor/hoa/ustring/Bin/Fromcode.php� �+g� ;�m� ! vendor/hoa/ustring/Bin/Tocode.php� �+g� ���� - vendor/hoa/ustring/Documentation/Fr/Index.xylEn �+gEn �Fp� - vendor/hoa/ustring/Documentation/En/Index.xyl h �+g h ��v� vendor/hoa/ustring/Ustring.php�e �+g�e ���� vendor/hoa/ustring/Exception.php� �+g� P��R� vendor/hoa/ustring/Search.php �+g �� � vendor/hoa/compiler/Bin/Pp.php� �+g� %�� $ vendor/hoa/compiler/Visitor/Dump.php?
�+g?
L�护 . vendor/hoa/compiler/Documentation/Fr/Index.xylt� �+gt� �E� . vendor/hoa/compiler/Documentation/En/Index.xyl�� �+g�� �d/� $ vendor/hoa/compiler/Llk/TreeNode.php �+g IC\ۤ & vendor/hoa/compiler/Llk/Rule/Entry.phph �+gh ��+ͤ ' vendor/hoa/compiler/Llk/Rule/Choice.phpe �+ge �Oᙤ & vendor/hoa/compiler/Llk/Rule/Token.php= �+g= �i�/� + vendor/hoa/compiler/Llk/Rule/Repetition.php� �+g� T1&� & vendor/hoa/compiler/Llk/Rule/Ekzit.phpo �+go V�|� . vendor/hoa/compiler/Llk/Rule/Concatenation.phpz �+gz _oP� % vendor/hoa/compiler/Llk/Rule/Rule.php" �+g" �hg7� ) vendor/hoa/compiler/Llk/Rule/Analyzer.php"4 �+g"4 ��xF� + vendor/hoa/compiler/Llk/Rule/Invocation.phpL �+gL ��ᙤ , 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/Sampler.php� �+g� k�<*� + vendor/hoa/compiler/Llk/Sampler/Uniform.php�" �+g�" ��� - vendor/hoa/compiler/Llk/Sampler/Exception.php� �+g� ��k� vendor/hoa/compiler/Llk/Llk.php�. �+g�. �&�� vendor/hoa/compiler/Llk/Llk.pp� �+g� Gr�� ! vendor/hoa/compiler/Llk/Lexer.php� �+g� |�O� " vendor/hoa/compiler/Llk/Parser.php
Q �+g
Q �J�(� . vendor/hoa/compiler/Exception/IllegalToken.php�
�+g�
EW �� & vendor/hoa/compiler/Exception/Rule.php� �+g� 5�<@� 3 vendor/hoa/compiler/Exception/UnrecognizedToken.php�
�+g�
wؤ = vendor/hoa/compiler/Exception/FinalStateHasNotBeenReached.php� �+g� �bsϤ + vendor/hoa/compiler/Exception/Exception.php �+g �?��� 1 vendor/hoa/compiler/Exception/UnexpectedToken.php� �+g� ��/�� ' vendor/hoa/compiler/Exception/Lexer.php� �+g� ���� vendor/hoa/compiler/PATCHES.txt; �+g; �Ts�� vendor/hoa/compiler/Ll1.php`k �+g`k �t�Ҥ vendor/hoa/stream/Stream.php�A �+g�A ]��� vendor/hoa/stream/Context.phpe �+ge lp� # vendor/hoa/stream/Filter/Filter.php� �+g� Y&�:� " vendor/hoa/stream/Filter/Basic.php� �+g� ��x� & vendor/hoa/stream/Filter/Exception.php� �+g� � � ) vendor/hoa/stream/Filter/LateComputed.phpc �+gc 4�G� vendor/hoa/stream/PATCHES.txt� �+g� �aQ� % vendor/hoa/stream/Wrapper/Wrapper.php� �+g� �L�Q� + 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/Bucket.php� �+g� e�� ( vendor/hoa/stream/IStream/Bufferable.php�
�+g�
Y�q� $ vendor/hoa/stream/IStream/Stream.php� �+g� g�� ' vendor/hoa/stream/IStream/Touchable.php� �+g� -6�� ' vendor/hoa/stream/IStream/Pointable.php �+g �gq� vendor/hoa/stream/IStream/In.phpn �+gn �T
� ( vendor/hoa/stream/IStream/Structural.php �+g ��q~� & vendor/hoa/stream/IStream/Pathable.phps �+gs I 7� & vendor/hoa/stream/IStream/Lockable.phph
�+gh
��� & vendor/hoa/stream/IStream/Statable.php�
�+g�
i��� ! vendor/hoa/stream/IStream/Out.php�
�+g�
�ǟΤ vendor/hoa/stream/Exception.php� �+g� e3��� vendor/hoa/stream/Composite.php� �+g� �¯~� vendor/hoa/math/Bin/Calc.php� �+g� �&�~� & vendor/hoa/math/Visitor/Arithmetic.phpG' �+gG' -�}ڤ vendor/hoa/math/Arithmetic.pp�
�+g�
��٤ vendor/hoa/math/Context.php �+g J/��� - vendor/hoa/math/Exception/UnknownVariable.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/Exception/Exception.php� �+g� �
��� " vendor/hoa/math/Sampler/Random.php� �+g� P� %� # vendor/hoa/math/Sampler/Sampler.php! �+g! �M�� vendor/hoa/math/Util.phpY �+gY �c]
� - vendor/hoa/math/Combinatorics/Arrangement.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/Permutation.php �+g sY�7� * vendor/hoa/math/Combinatorics/Counting.php �+g sY�7� + vendor/hoa/math/Combinatorics/FiniteSet.php �+g sY�7� vendor/hoa/zformat/Parameter.phpG �+gG ��?�� & vendor/hoa/zformat/Parameterizable.php� �+g� �Kn� vendor/hoa/zformat/Exception.php� �+g� N�f� vendor/hoa/iterator/Mock.phpX �+gX |!� % vendor/hoa/iterator/Demultiplexer.php� �+g� : �+� ! vendor/hoa/iterator/Directory.php �+g ��~� vendor/hoa/iterator/Seekable.phpq �+gq ���פ vendor/hoa/iterator/NoRewind.phpf �+gf 7Z/}� ! vendor/hoa/iterator/Aggregate.phpv �+gv ��ˤ vendor/hoa/iterator/Filter.phpg �+gg iһ� vendor/hoa/iterator/Limit.phpZ �+gZ �!x#� vendor/hoa/iterator/Multiple.php� �+g� �� � ! vendor/hoa/iterator/Lookahead.phpq �+gq ��_�� vendor/hoa/iterator/Repeater.php5 �+g5 �q�� vendor/hoa/iterator/Iterator.php� �+g� �"�� ) vendor/hoa/iterator/CallbackGenerator.php� �+g� 6H�9� vendor/hoa/iterator/Outer.phpf �+gf � vendor/hoa/iterator/PATCHES.txt� �+g� ���2� vendor/hoa/iterator/Buffer.php� �+g� �Mtʤ ) vendor/hoa/iterator/RegularExpression.php�! �+g�! ^Iu�� # vendor/hoa/iterator/SplFileInfo.phph �+gh �o�l� vendor/hoa/iterator/Infinite.phpf �+gf � �*� " vendor/hoa/iterator/Lookbehind.php4 �+g4 �*4� vendor/hoa/iterator/Map.phpV �+gV ���w� " vendor/hoa/iterator/FileSystem.php� �+g� ��� vendor/hoa/iterator/Append.php^ �+g^ ��{F� & vendor/hoa/iterator/Recursive/Mock.phpo �+go ���w� + vendor/hoa/iterator/Recursive/Directory.php� �+g� 6�FY� ( vendor/hoa/iterator/Recursive/Filter.php� �+g� ��҅� * vendor/hoa/iterator/Recursive/Iterator.php� �+g� ���s� 3 vendor/hoa/iterator/Recursive/RegularExpression.php� �+g� lֲ� % vendor/hoa/iterator/Recursive/Map.php| �+g| PX:� + vendor/hoa/iterator/Recursive/Recursive.php� �+g� Zr
�� 0 vendor/hoa/iterator/Recursive/CallbackFilter.php� �+g� �� �� ! vendor/hoa/iterator/Exception.php� �+g� �>�T� ( vendor/hoa/iterator/IteratorIterator.phpv �+gv iÃ#� & vendor/hoa/iterator/CallbackFilter.php~ �+g~ �L �� vendor/hoa/iterator/Glob.phpV �+gV �ǻ�� vendor/hoa/iterator/Counter.php� �+g� �6՟� vendor/hoa/visitor/Element.php� �+g� �e�b� vendor/hoa/visitor/Visit.php� �+g� ��5� vendor/hoa/file/Directory.php� �+g� �V� � vendor/hoa/file/Link/Read.phpP �+gP �X<6� vendor/hoa/file/Link/Link.phpR �+gR �M�� vendor/hoa/file/Link/Write.php� �+g� �G � " vendor/hoa/file/Link/ReadWrite.php�" �+g�" ��ͤ vendor/hoa/file/Generic.php44 �+g44 W\/� vendor/hoa/file/File.php�% �+g�% W
� vendor/hoa/file/Finder.php%D �+g%D ��ސ� ' vendor/hoa/file/Exception/Exception.php� �+g� U墕� . vendor/hoa/file/Exception/FileDoesNotExist.php� �+g� K�i�� vendor/hoa/file/PATCHES.txt� �+g� ���)� vendor/hoa/file/SplFileInfo.php �+g �RK� vendor/hoa/file/Read.phpA �+gA ��$� vendor/hoa/file/Write.php �+g ��0M� vendor/hoa/file/Watcher.php� �+g� ċv�� ' vendor/hoa/file/Temporary/Temporary.php� �+g� 0�9� " vendor/hoa/file/Temporary/Read.phpm �+gm ��3� # vendor/hoa/file/Temporary/Write.php �+g F6��� ' vendor/hoa/file/Temporary/ReadWrite.php�" �+g�" ���� vendor/hoa/file/ReadWrite.php�" �+g�" ��� % vendor/hoa/consistency/Autoloader.phpa �+ga ��� " vendor/hoa/consistency/PATCHES.txt� �+g� oV?� " vendor/hoa/consistency/Prelude.php �+g Y`�i� $ vendor/hoa/consistency/Exception.php� �+g� �m�X� $ vendor/hoa/consistency/Xcallable.phpt �+gt t�� & vendor/hoa/consistency/Consistency.php~ �+g~ b�B� # vendor/hoa/protocol/Bin/Resolve.php� �+g� A��M� $ 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/Protocol.php �+g �H�� vendor/hoa/protocol/Wrapper.php&F �+g&F [
ZC� ! vendor/hoa/protocol/Exception.php� �+g� 6��\� vendor/hoa/exception/Error.phpH �+gH *b�&� vendor/hoa/exception/PATCHES.txt� �+g� �`on� vendor/hoa/exception/Group.phpZ �+gZ �f�$� " vendor/hoa/exception/Exception.phpO �+gO � � vendor/hoa/exception/Idle.php� �+g� ��=� & vendor/hoa/regex/Visitor/Isotropic.php>$ �+g>$ CId;� vendor/hoa/regex/Grammar.pp �+g A L�� vendor/hoa/regex/Exception.php� �+g� ��� vendor/hoa/event/Listener.php� �+g� ���ݤ vendor/hoa/event/Listens.php� �+g� �#v� vendor/hoa/event/Listenable.php� �+g� �GO� vendor/hoa/event/Bucket.phpD
�+gD
4u�*� vendor/hoa/event/Exception.php� �+g� � �=� vendor/hoa/event/Source.php_ �+g_ �� vendor/hoa/event/Event.php �+g G�ṳ ? vendor/jetbrains/phpstorm-stubs/superglobals/_superglobals.stub �+g Fe��� , vendor/jetbrains/phpstorm-stubs/yaf/yaf.stub�` �+g�` ��k�� 6 vendor/jetbrains/phpstorm-stubs/yaf/yaf_namespace.stub^[ �+g^[ v�D� 0 vendor/jetbrains/phpstorm-stubs/posix/posix.stubTk �+gTk d� �� . vendor/jetbrains/phpstorm-stubs/pcov/pcov.stub �+g \�X�� 0 vendor/jetbrains/phpstorm-stubs/pgsql/pgsql.stubs �+gs � Tj� 2 vendor/jetbrains/phpstorm-stubs/pgsql/pgsql_c.stub� �+g� ��� 0 vendor/jetbrains/phpstorm-stubs/oci8/oci8v3.stubE9 �+gE9 � � . vendor/jetbrains/phpstorm-stubs/oci8/oci8.stub�o �+g�o h!p�� 2 vendor/jetbrains/phpstorm-stubs/ffmpeg/ffmpeg.stub� �+g� g%� 2 vendor/jetbrains/phpstorm-stubs/random/random.stub� �+g� ^�5� 0 vendor/jetbrains/phpstorm-stubs/ctype/ctype.stubR �+gR P��� 4 vendor/jetbrains/phpstorm-stubs/sysvmsg/sysvmsg.stub�& �+g�& ��jΤ 6 vendor/jetbrains/phpstorm-stubs/wincache/wincache.stuba �+ga �Ѓ � . vendor/jetbrains/phpstorm-stubs/fann/fann.stubh� �+gh� ��a*� 2 vendor/jetbrains/phpstorm-stubs/phpdbg/phpdbg.stubg �+gg AȾO� 0 vendor/jetbrains/phpstorm-stubs/stats/stats.stub"H �+g"H ��e� 4 vendor/jetbrains/phpstorm-stubs/ncurses/ncurses.stub� �+g� *�֩� . vendor/jetbrains/phpstorm-stubs/amqp/amqp.stub3� �+g3� {� 6 vendor/jetbrains/phpstorm-stubs/pthreads/pthreads.stub�H �+g�H �>9�� 4 vendor/jetbrains/phpstorm-stubs/imagick/imagick.stubm� �+gm� �~�� 2 vendor/jetbrains/phpstorm-stubs/mysqli/mysqli.stub2� �+g2� ?� �� 2 vendor/jetbrains/phpstorm-stubs/bcmath/bcmath.stub�# �+g�# ��b� 0 vendor/jetbrains/phpstorm-stubs/Parle/Lexer.stub* �+g* ;� �� 9 vendor/jetbrains/phpstorm-stubs/Parle/LexerException.stubw �+gw ^Ut�� 2 vendor/jetbrains/phpstorm-stubs/Parle/RParser.stub� �+g� �ɥФ 4 vendor/jetbrains/phpstorm-stubs/Parle/ErrorInfo.stubA �+gA �� 0 vendor/jetbrains/phpstorm-stubs/Parle/Token.stub� �+g� N���� 0 vendor/jetbrains/phpstorm-stubs/Parle/Stack.stubA �+gA .>o_� 1 vendor/jetbrains/phpstorm-stubs/Parle/RLexer.stub� �+g� w��� 1 vendor/jetbrains/phpstorm-stubs/Parle/Parser.stub, �+g, ���� : vendor/jetbrains/phpstorm-stubs/Parle/ParserException.stubx �+gx L�� , vendor/jetbrains/phpstorm-stubs/eio/eio.stubfy �+gfy �� 8 vendor/jetbrains/phpstorm-stubs/xmlreader/xmlreader.stubsD �+gsD +{ˤ . vendor/jetbrains/phpstorm-stubs/yaml/yaml.stubh �+gh �{�Ȥ . vendor/jetbrains/phpstorm-stubs/json/json.stub�4 �+g�4 �tA� 2 vendor/jetbrains/phpstorm-stubs/recode/recode.stub� �+g� �O� 2 vendor/jetbrains/phpstorm-stubs/radius/radius.stub�G �+g�G �4g�� 4 vendor/jetbrains/phpstorm-stubs/meminfo/meminfo.stub� �+g� �rbɤ . vendor/jetbrains/phpstorm-stubs/apcu/apcu.stub[n �+g[n F��� 7 vendor/jetbrains/phpstorm-stubs/tokenizer/PhpToken.stub� �+g� &��� 8 vendor/jetbrains/phpstorm-stubs/tokenizer/tokenizer.stub� �+g� �&� < vendor/jetbrains/phpstorm-stubs/libvirt-php/libvirt-php.stub�9 �+g�9 ��:`� 4 vendor/jetbrains/phpstorm-stubs/gearman/gearman.stub� �+g� ଉ�� 2 vendor/jetbrains/phpstorm-stubs/cubrid/cubrid.stubt� �+gt� ��
~� H vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionEnumBackedCase.stubP �+gP �g�� : vendor/jetbrains/phpstorm-stubs/Reflection/Reflection.stub� �+g� �C� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionReference.stub� �+g� ؆�5� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionException.stub� �+g� �#5�� J vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionFunctionAbstract.stubh( �+gh( ��#� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionExtension.stub2 �+g2 �~� @ vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionMethod.stubU* �+gU* ����� > vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionType.stub� �+g� � �R� J vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionIntersectionType.stub� �+g� 6�c8� ? vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionClass.stub�\ �+g�\ ۆ�$� @ vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionObject.stub� �+g� 0��� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionAttribute.stub� �+g� ז�� G vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionZendExtension.stub�
�+g�
b{`� 9 vendor/jetbrains/phpstorm-stubs/Reflection/Reflector.stub� �+g� �T�� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionNamedType.stubp �+gp ' � � ? vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionFiber.stub� �+g� *a�� > vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionEnum.stub� �+g� ��N� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionGenerator.stubL �+gL +�K�� B vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionConstant.stub� �+g� ���|� B vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionProperty.stuba. �+ga. � -�� G vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionClassConstant.stub4 �+g4 ���|� F vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionEnumUnitCase.stub� �+g� E;�� B vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionFunction.stub� �+g� b��� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionParameter.stub�' �+g�' �E�O� @ vendor/jetbrains/phpstorm-stubs/Reflection/PropertyHookType.stub3 �+g3 ��F� C vendor/jetbrains/phpstorm-stubs/Reflection/ReflectionUnionType.stub
�+g
��˜� / vendor/jetbrains/phpstorm-stubs/SPL/SPL_c1.stub
? �+g
? L�� , vendor/jetbrains/phpstorm-stubs/SPL/SPL.stub� �+g� h� � . vendor/jetbrains/phpstorm-stubs/SPL/SPL_f.stubm �+gm �O:ä 6 vendor/jetbrains/phpstorm-stubs/readline/readline.stubC �+gC c�� . vendor/jetbrains/phpstorm-stubs/wddx/wddx.stub� �+g�
[L� 6 vendor/jetbrains/phpstorm-stubs/simdjson/simdjson.stub/ �+g/ �P^� , vendor/jetbrains/phpstorm-stubs/zip/zip.stub � �+g � �C9�� + vendor/jetbrains/phpstorm-stubs/runTests.sh` �+g` �Rz1� . vendor/jetbrains/phpstorm-stubs/gd/GdFont.stub3 �+g3 `I=� * vendor/jetbrains/phpstorm-stubs/gd/gd.stub� �+g� ��� + vendor/jetbrains/phpstorm-stubs/qodana.yaml
�+g
'JX;� 8 vendor/jetbrains/phpstorm-stubs/memcached/memcached.stub�� �+g�� H@�� ' vendor/jetbrains/phpstorm-stubs/LICENSEW, �+gW, M��̤ 4 vendor/jetbrains/phpstorm-stubs/aerospike/Bytes.stub �+g ��ʍ� 8 vendor/jetbrains/phpstorm-stubs/aerospike/aerospike.stub24 �+g24 ٸe� 6 vendor/jetbrains/phpstorm-stubs/igbinary/igbinary.stub� �+g� o/�� . vendor/jetbrains/phpstorm-stubs/zstd/zstd.stub �+g �L�V� 8 vendor/jetbrains/phpstorm-stubs/xlswriter/xlswriter.stub'> �+g'> ��@�� 1 vendor/jetbrains/phpstorm-stubs/svm/SVMModel.stub� �+g�
��p� , vendor/jetbrains/phpstorm-stubs/svm/SVM.stub� �+g� ��g� 8 vendor/jetbrains/phpstorm-stubs/zookeeper/zookeeper.stub") �+g") ޛ� 4 vendor/jetbrains/phpstorm-stubs/rpminfo/rpminfo.stub- �+g- ���� 4 vendor/jetbrains/phpstorm-stubs/leveldb/LevelDB.stub� �+g� ;��� 2 vendor/jetbrains/phpstorm-stubs/xmlrpc/xmlrpc.stub� �+g� ���� 2 vendor/jetbrains/phpstorm-stubs/mcrypt/mcrypt.stub�_ �+g�_ iXV�� * vendor/jetbrains/phpstorm-stubs/ds/ds.stub� �+g� �R�E� 5 vendor/jetbrains/phpstorm-stubs/sybase/sybase_ct.stub7 �+g7 #��!� , vendor/jetbrains/phpstorm-stubs/xsl/xsl.stub; �+g; $��Ȥ 0 vendor/jetbrains/phpstorm-stubs/gnupg/gnupg.stubZI �+gZI ��
3� 8 vendor/jetbrains/phpstorm-stubs/cassandra/cassandra.stub �+g 3��Ԥ 2 vendor/jetbrains/phpstorm-stubs/apache/apache.stub- �+g- ��L�� 2 vendor/jetbrains/phpstorm-stubs/filter/filter.stub�; �+g�; v2֬� 0 vendor/jetbrains/phpstorm-stubs/stomp/stomp.stubA" �+gA" !K�� 2 vendor/jetbrains/phpstorm-stubs/xhprof/xhprof.stub� �+g� �g"դ > vendor/jetbrains/phpstorm-stubs/win32service/win32service.stubEc �+gEc �R�ۤ J vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient.stub� �+g� �!��� P vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Topic.stub� �+g� � � � Y vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/TopicPartition.stub& �+g& �>�~� R vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Message.stub� �+g� k� X vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Configuration.stubx �+gx ռv�� S vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Metadata.stub9 �+g9 !�a� Y vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Metadata/Topic.stubS �+gS \�� ] 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`� ^ vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/Metadata/Collection.stub �+g ���� ^ vendor/jetbrains/phpstorm-stubs/simple_kafka_client/SimpleKafkaClient/KafkaErrorException.stub� �+g� �i',� 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/Producer.stub� �+g� И�� B vendor/jetbrains/phpstorm-stubs/simple_kafka_client/functions.stub� �+g� B�Q�� 0 vendor/jetbrains/phpstorm-stubs/geoip/geoip.stub$ �+g$ 6 �� 8 vendor/jetbrains/phpstorm-stubs/ZendCache/ZendCache.stub �+g �ab� : vendor/jetbrains/phpstorm-stubs/frankenphp/frankenphp.stub� �+g� x���� 4 vendor/jetbrains/phpstorm-stubs/openssl/openssl.stub�� �+g�� ���Ф , vendor/jetbrains/phpstorm-stubs/yar/yar.stub �+g ���ۤ < vendor/jetbrains/phpstorm-stubs/elastic_apm/elastic_apm.stub�~ �+g�~ ���� 4 vendor/jetbrains/phpstorm-stubs/PhpStormStubsMap.php"�
�+g"�
�@�� 0 vendor/jetbrains/phpstorm-stubs/shmop/shmop.stub� �+g� �2ɤ @ vendor/jetbrains/phpstorm-stubs/mysql_xdevapi/mysql_xdevapi.stub�� �+g�� ^�� 8 vendor/jetbrains/phpstorm-stubs/mailparse/mailparse.stubw �+gw �r� B vendor/jetbrains/phpstorm-stubs/uploadprogress/uploadprogress.stub �+g �r� 8 vendor/jetbrains/phpstorm-stubs/SimpleXML/SimpleXML.stubQL �+gQL �O�� , vendor/jetbrains/phpstorm-stubs/ftp/ftp.stub�i �+g�i �y("� 3 vendor/jetbrains/phpstorm-stubs/ftp/Connection.stubG �+gG ��!� 0 vendor/jetbrains/phpstorm-stubs/iconv/iconv.stub�5 �+g�5 1�+G� 6 vendor/jetbrains/phpstorm-stubs/newrelic/newrelic.stub� �+g� ��Ϥ� , vendor/jetbrains/phpstorm-stubs/PDO/PDO.stubcG �+gcG K&sʤ 6 vendor/jetbrains/phpstorm-stubs/fileinfo/fileinfo.stubr! �+gr! WY1� 2 vendor/jetbrains/phpstorm-stubs/sqlsrv/sqlsrv.stub~� �+g~� ��i� , vendor/jetbrains/phpstorm-stubs/lzf/lzf.stub� �+g� ���Ƥ 0 vendor/jetbrains/phpstorm-stubs/ldap/Result.stubD �+gD ��vZ� . vendor/jetbrains/phpstorm-stubs/ldap/ldap.stub�� �+g�� ��� 4 vendor/jetbrains/phpstorm-stubs/ldap/Connection.stubH �+gH � � 5 vendor/jetbrains/phpstorm-stubs/ldap/ResultEntry.stubI �+gI Px�_� . vendor/jetbrains/phpstorm-stubs/soap/soap.stubG� �+gG� ��Z� 0 vendor/jetbrains/phpstorm-stubs/soap/soap_n.stub� �+g� u�� 6 vendor/jetbrains/phpstorm-stubs/mbstring/mbstring.stub� �+g� K �M� @ vendor/jetbrains/phpstorm-stubs/mongodb/TopologyDescription.stub� �+g� �, � 7 vendor/jetbrains/phpstorm-stubs/mongodb/WriteError.stub` �+g` __K�� @ vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Unserializable.stub� �+g� "t�_� 6 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Type.stub� �+g� 'J�-� ; vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Timestamp.stubq �+gq
g�H� A vendor/jetbrains/phpstorm-stubs/mongodb/BSON/BinaryInterface.stub� �+g� �0>F� 8 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Binary.stub� �+g� ?��� 8 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/MinKey.stub� �+g�
��� ; vendor/jetbrains/phpstorm-stubs/mongodb/BSON/DBPointer.stub� �+g� ��7� E vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Decimal128Interface.stub8 �+g8 �L=p� ; vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Undefined.stubO �+gO U���� 7 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Int64.stubO �+gO ���$� : vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Iterator.stub� �+g�
�� A vendor/jetbrains/phpstorm-stubs/mongodb/BSON/MinKeyInterface.stub �+g G�u�� A vendor/jetbrains/phpstorm-stubs/mongodb/BSON/MaxKeyInterface.stub �+g ���#� C vendor/jetbrains/phpstorm-stubs/mongodb/BSON/ObjectIdInterface.stub� �+g� C_�� : vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Document.stub� �+g� hb�T� = vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Persistable.stub� �+g� !t�� < vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Decimal128.stub �+g �W�Ϥ = vendor/jetbrains/phpstorm-stubs/mongodb/BSON/PackedArray.stub� �+g� ���פ = vendor/jetbrains/phpstorm-stubs/mongodb/BSON/UTCDateTime.stubN �+gN d�� � 8 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Symbol.stub/ �+g/ R���� 8 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/MaxKey.stub� �+g� ��W� > vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Serializable.stub� �+g� @}��� D vendor/jetbrains/phpstorm-stubs/mongodb/BSON/TimestampInterface.stub� �+g� E �p� : vendor/jetbrains/phpstorm-stubs/mongodb/BSON/ObjectId.stub� �+g� �tl?� ; vendor/jetbrains/phpstorm-stubs/mongodb/BSON/functions.stub^
�+g^
9�� @ vendor/jetbrains/phpstorm-stubs/mongodb/BSON/RegexInterface.stube �+ge ���m� 7 vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Regex.stubV �+gV u�k� < vendor/jetbrains/phpstorm-stubs/mongodb/BSON/Javascript.stub� �+g� #�<Ѥ F vendor/jetbrains/phpstorm-stubs/mongodb/BSON/UTCDateTimeInterface.stub+ �+g+ 2,�� E vendor/jetbrains/phpstorm-stubs/mongodb/BSON/JavascriptInterface.stub� �+g� ]O؇� K vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/TopologyClosedEvent.stub� �+g� �89�� M vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/CommandSucceededEvent.stub� �+g� ��u� I vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerClosedEvent.stubr �+gr :��S� J vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerOpeningEvent.stubv �+gv �6�2� K vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/CommandStartedEvent.stub �+g T��� J vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerChangedEvent.stub� �+g� �p� R vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerHeartbeatFailedEvent.stub] �+g] �5��� I vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/CommandSubscriber.stub� �+g� ;O�� L vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/TopologyOpeningEvent.stub� �+g� Y�Wu� U vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerHeartbeatSucceededEvent.stubU �+gU �2y{� L vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/TopologyChangedEvent.stub� �+g� e4��� J vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/CommandFailedEvent.stub� �+g� c됒� F vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/SDAMSubscriber.stub� �+g� Ɛ� S vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/ServerHeartbeatStartedEvent.stubx �+gx �x�� A vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/functions.stubu �+gu ƽg� B vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/Subscriber.stub� �+g� �� E vendor/jetbrains/phpstorm-stubs/mongodb/Monitoring/LogSubscriber.stub� �+g� n̅� 3 vendor/jetbrains/phpstorm-stubs/mongodb/Cursor.stub� �+g� �H� E vendor/jetbrains/phpstorm-stubs/mongodb/Exception/WriteException.stub� �+g� G��g� O vendor/jetbrains/phpstorm-stubs/mongodb/Exception/UnexpectedValueException.stubj �+gj �Mm� G vendor/jetbrains/phpstorm-stubs/mongodb/Exception/RuntimeException.stubF �+gF �E��� E vendor/jetbrains/phpstorm-stubs/mongodb/Exception/LogicException.stub �+g Z�Ť N vendor/jetbrains/phpstorm-stubs/mongodb/Exception/AuthenticationException.stub5 �+g5 K�� J vendor/jetbrains/phpstorm-stubs/mongodb/Exception/EncryptionException.stub, �+g,
�5�� P vendor/jetbrains/phpstorm-stubs/mongodb/Exception/ExecutionTimeoutException.stubH �+gH A� � I vendor/jetbrains/phpstorm-stubs/mongodb/Exception/BulkWriteException.stub �+g ���� @ vendor/jetbrains/phpstorm-stubs/mongodb/Exception/Exception.stub: �+g: M �� M vendor/jetbrains/phpstorm-stubs/mongodb/Exception/SSLConnectionException.stub2 �+g2 ��� O vendor/jetbrains/phpstorm-stubs/mongodb/Exception/InvalidArgumentException.stubS �+gS 5k�:� L vendor/jetbrains/phpstorm-stubs/mongodb/Exception/WriteConcernException.stuby �+gy ���� J vendor/jetbrains/phpstorm-stubs/mongodb/Exception/ConnectionException.stubG �+gG Al�� F vendor/jetbrains/phpstorm-stubs/mongodb/Exception/ServerException.stub� �+g� ��`� Q vendor/jetbrains/phpstorm-stubs/mongodb/Exception/ConnectionTimeoutException.stubd �+gd � -;� G vendor/jetbrains/phpstorm-stubs/mongodb/Exception/CommandException.stub �+g K��*� 6 vendor/jetbrains/phpstorm-stubs/mongodb/BulkWrite.stub� �+g� ��#Z� ; vendor/jetbrains/phpstorm-stubs/mongodb/ReadPreference.stubD �+gD ϣ��� 4 vendor/jetbrains/phpstorm-stubs/mongodb/Command.stub� �+g� �d� < vendor/jetbrains/phpstorm-stubs/mongodb/CursorInterface.stub� �+g� ��
� > vendor/jetbrains/phpstorm-stubs/mongodb/WriteConcernError.stub �+g �V�Z� 2 vendor/jetbrains/phpstorm-stubs/mongodb/Query.stub� �+g� �ԶǤ 4 vendor/jetbrains/phpstorm-stubs/mongodb/Manager.stub�* �+g�* �dk�� 4 vendor/jetbrains/phpstorm-stubs/mongodb/Session.stubT �+gT ڸ7�� 9 vendor/jetbrains/phpstorm-stubs/mongodb/WriteConcern.stubE �+gE S�� 4 vendor/jetbrains/phpstorm-stubs/mongodb/mongodb.stubF �+gF �.��� = vendor/jetbrains/phpstorm-stubs/mongodb/ClientEncryption.stubf �+gf 8DZ9� 5 vendor/jetbrains/phpstorm-stubs/mongodb/CursorId.stubw �+gw �:?� 8 vendor/jetbrains/phpstorm-stubs/mongodb/WriteResult.stubd
�+gd
ݚ�� > vendor/jetbrains/phpstorm-stubs/mongodb/ServerDescription.stub� �+g� .���� 3 vendor/jetbrains/phpstorm-stubs/mongodb/Server.stub�' �+g�' ;�d� 8 vendor/jetbrains/phpstorm-stubs/mongodb/ReadConcern.stub
�+g
w���� 6 vendor/jetbrains/phpstorm-stubs/mongodb/ServerApi.stub� �+g� ���֤ @ vendor/jetbrains/phpstorm-stubs/meta/attributes/ObjectShape.stub� �+g� �k p� = vendor/jetbrains/phpstorm-stubs/meta/attributes/NoReturn.stub� �+g� �4��� ? vendor/jetbrains/phpstorm-stubs/meta/attributes/Deprecated.stub� �+g� ��k^� 9 vendor/jetbrains/phpstorm-stubs/meta/attributes/Pure.stub� �+g� ;Ś�� ? vendor/jetbrains/phpstorm-stubs/meta/attributes/ArrayShape.stubV �+gV O7�� > vendor/jetbrains/phpstorm-stubs/meta/attributes/Immutable.stub� �+g� �a'�� T vendor/jetbrains/phpstorm-stubs/meta/attributes/internal/LanguageLevelTypeAware.stubo �+go ��%�� P vendor/jetbrains/phpstorm-stubs/meta/attributes/internal/ReturnTypeContract.stubh �+gh �<
x� [ vendor/jetbrains/phpstorm-stubs/meta/attributes/internal/PhpStormStubsElementAvailable.stub� �+g� e3� K vendor/jetbrains/phpstorm-stubs/meta/attributes/internal/TentativeType.stub� �+g� ()�� C vendor/jetbrains/phpstorm-stubs/meta/attributes/ExpectedValues.stub� �+g� ђ~�� = vendor/jetbrains/phpstorm-stubs/meta/attributes/Language.stub� �+g� �MJ�� 4 vendor/jetbrains/phpstorm-stubs/sqlite3/sqlite3.stub�f �+g�f ��Խ� 8 vendor/jetbrains/phpstorm-stubs/ZendUtils/ZendUtils.stub8 �+g8 �܌� 2 vendor/jetbrains/phpstorm-stubs/brotli/brotli.stub� �+g� p<5ʤ 2 vendor/jetbrains/phpstorm-stubs/SQLite/SQLite.stubl� �+gl�
L� 0 vendor/jetbrains/phpstorm-stubs/zend/zend_f.stub. �+g. 6��x� 0 vendor/jetbrains/phpstorm-stubs/zend/zend_d.stub �+g �-|j� . vendor/jetbrains/phpstorm-stubs/zend/zend.stub�X �+g�X ��B
� ; vendor/jetbrains/phpstorm-stubs/couchbase_v2/couchbase.stub�� �+g�� d�z
� : vendor/jetbrains/phpstorm-stubs/couchbase_v2/toplevel.stubW �+gW a->� 0 vendor/jetbrains/phpstorm-stubs/mysql/mysql.stub| �+g| �0{� < vendor/jetbrains/phpstorm-stubs/solr/Queries/SolrParams.stub� �+g� (�D� A vendor/jetbrains/phpstorm-stubs/solr/Queries/SolrDisMaxQuery.stub- �+g- I!�� F vendor/jetbrains/phpstorm-stubs/solr/Queries/SolrModifiableParams.stubk �+gk %��� F vendor/jetbrains/phpstorm-stubs/solr/Queries/SolrCollapseFunction.stub� �+g� E
� ; vendor/jetbrains/phpstorm-stubs/solr/Queries/SolrQuery.stubs> �+gs> ��� 3 vendor/jetbrains/phpstorm-stubs/solr/constants.stubD �+gD �� c� 4 vendor/jetbrains/phpstorm-stubs/solr/SolrClient.stub�M �+g�M C|��� D vendor/jetbrains/phpstorm-stubs/solr/Responses/SolrPingResponse.stub� �+g� ޡ�ޤ E vendor/jetbrains/phpstorm-stubs/solr/Responses/SolrQueryResponse.stub �+g �ɤ G vendor/jetbrains/phpstorm-stubs/solr/Responses/SolrGenericResponse.stub+ �+g+ ����� @ vendor/jetbrains/phpstorm-stubs/solr/Responses/SolrResponse.stub� �+g� /I�%� F vendor/jetbrains/phpstorm-stubs/solr/Responses/SolrUpdateResponse.stub% �+g% >H�٤ E vendor/jetbrains/phpstorm-stubs/solr/Documents/SolrDocumentField.stub �+g
\� @ vendor/jetbrains/phpstorm-stubs/solr/Documents/SolrDocument.stub�/ �+g�/ �F&�� E vendor/jetbrains/phpstorm-stubs/solr/Documents/SolrInputDocument.stub�& �+g�& ?J �� : vendor/jetbrains/phpstorm-stubs/solr/Utils/SolrObject.stub
�+g
�t
�� 9 vendor/jetbrains/phpstorm-stubs/solr/Utils/SolrUtils.stub� �+g� ��O� H vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrServerException.stuby �+gy C�$�� [ vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrMissingMandatoryParameterException.stub� �+g� ��n�� H vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrClientException.stubs �+gs �GP � B vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrException.stub� �+g� & � R vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrIllegalOperationException.stub� �+g� -N%�� Q vendor/jetbrains/phpstorm-stubs/solr/Exceptions/SolrIllegalArgumentException.stub� �+g� )�4� 3 vendor/jetbrains/phpstorm-stubs/solr/functions.stub� �+g� A�A� . vendor/jetbrains/phpstorm-stubs/hash/hash.stub�E �+g�E �̠�� . vendor/jetbrains/phpstorm-stubs/Core/Core.stub_� �+g_� R���� 0 vendor/jetbrains/phpstorm-stubs/Core/Core_d.stub
$ �+g
$ Zy�� 0 vendor/jetbrains/phpstorm-stubs/Core/Core_c.stubԋ �+gԋ �6�� , vendor/jetbrains/phpstorm-stubs/FFI/FFI.stub�M �+g�M �t�� 6 vendor/jetbrains/phpstorm-stubs/calendar/calendar.stub�& �+g�& �fxݤ 6 vendor/jetbrains/phpstorm-stubs/rdkafka/constants.stub�# �+g�# � ��� : vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Topic.stub{ �+g{ �t{=� : vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Queue.stub� �+g� ��hh� C vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/TopicPartition.stub! �+g! �9<� < vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Message.stubr �+gr b��W� B vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/ConsumerTopic.stub �+g � �>� G vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/KafkaConsumerTopic.stub �+g �C�٤ 9 vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Conf.stubq �+gq ���8� = vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Metadata.stub� �+g� ��ώ� C vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Metadata/Topic.stub �+g ��c� G vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Metadata/Partition.stub� �+g� �� D vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Metadata/Broker.stub� �+g� IQuR� H vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Metadata/Collection.stub� �+g� �L�� 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/Exception.stubA �+gA D/Q�� = vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Consumer.stub� �+g� �T�Y� = vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/Producer.stub9 �+g9 �߲ � > vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/TopicConf.stub �+g �x�� B vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka/KafkaConsumer.stubq
�+gq
F�!� 4 vendor/jetbrains/phpstorm-stubs/rdkafka/RdKafka.stubq �+gq �;�Ҥ 6 vendor/jetbrains/phpstorm-stubs/rdkafka/functions.stub �+g ��� + vendor/jetbrains/phpstorm-stubs/PATCHES.txtE �+gE ��ZΤ 0 vendor/jetbrains/phpstorm-stubs/date/date_c.stub �+g ?Ao�� . vendor/jetbrains/phpstorm-stubs/date/date.stub+� �+g+� �s�� 0 vendor/jetbrains/phpstorm-stubs/date/date_d.stub" �+g" ��e�� 9 vendor/jetbrains/phpstorm-stubs/snappy/snappy/snappy.stub �+g �� . vendor/jetbrains/phpstorm-stubs/ssh2/ssh2.stub�Z �+g�Z ��o� 0 vendor/jetbrains/phpstorm-stubs/mongo/mongo.stub�� �+g�� ;n�� 2 vendor/jetbrains/phpstorm-stubs/xdebug/xdebug.stub�3 �+g�3 ^Ȥ 0 vendor/jetbrains/phpstorm-stubs/xdiff/xdiff.stub"( �+g"( ���� 2 vendor/jetbrains/phpstorm-stubs/pcntl/pcntl_c.stub� �+g� zEh� 0 vendor/jetbrains/phpstorm-stubs/pcntl/pcntl.stubYX �+gYX ۖ<Ȥ 4 vendor/jetbrains/phpstorm-stubs/SplType/SplType.stub�
�+g�
�o��� 2 vendor/jetbrains/phpstorm-stubs/sodium/sodium.stub�� �+g�� �
�D� 8 vendor/jetbrains/phpstorm-stubs/winbinder/winbinder.stubx� �+gx� �:�� . vendor/jetbrains/phpstorm-stubs/judy/judy.stubF" �+gF" q��3� 4 vendor/jetbrains/phpstorm-stubs/sysvsem/sysvsem.stub�
�+g�
zX� , vendor/jetbrains/phpstorm-stubs/pam/pam.stub �+g s]7� . vendor/jetbrains/phpstorm-stubs/zlib/zlib.stub�K �+g�K �Z�Ԥ / vendor/jetbrains/phpstorm-stubs/Inspections.xml� �+g� wl� * vendor/jetbrains/phpstorm-stubs/pq/pq.stub�+ �+g�+ ��� . vendor/jetbrains/phpstorm-stubs/odbc/odbc.stub�y �+g�y ���� . vendor/jetbrains/phpstorm-stubs/dio/dio_d.stub� �+g� C � , vendor/jetbrains/phpstorm-stubs/dio/dio.stub�% �+g�% �'�&� 4 vendor/jetbrains/phpstorm-stubs/decimal/decimal.stub<< �+g<< z�y� . vendor/jetbrains/phpstorm-stubs/pcre/pcre.stubzP �+gzP ��Y�� , vendor/jetbrains/phpstorm-stubs/lua/lua.stub< �+g< � � 4 vendor/jetbrains/phpstorm-stubs/enchant/enchant.stub�) �+g�) �R�� 4 vendor/jetbrains/phpstorm-stubs/suhosin/suhosin.stub� �+g� � �Q� 1 vendor/jetbrains/phpstorm-stubs/relay/Events.stub� �+g� ��)� 2 vendor/jetbrains/phpstorm-stubs/relay/Cluster.stub�? �+g�? ��_p� 4 vendor/jetbrains/phpstorm-stubs/relay/Exception.stubc �+gc r��!� 0 vendor/jetbrains/phpstorm-stubs/relay/Relay.stub; �+g; �� 0 vendor/jetbrains/phpstorm-stubs/relay/Table.stubr �+gr G�ͤ 3 vendor/jetbrains/phpstorm-stubs/relay/Sentinel.stub� �+g� �&vY� 2 vendor/jetbrains/phpstorm-stubs/relay/KeyType.stub� �+g� �ۼ�� 0 vendor/jetbrains/phpstorm-stubs/relay/Event.stub� �+g� �,7A� 2 vendor/jetbrains/phpstorm-stubs/SaxonC/SaxonC.stubl� �+gl� �# �� , vendor/jetbrains/phpstorm-stubs/fpm/fpm.stub� �+g� �B�� 6 vendor/jetbrains/phpstorm-stubs/parallel/parallel.stub �+g � z� = vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events.stub�
�+g�
��ܤ A vendor/jetbrains/phpstorm-stubs/parallel/parallel/Sync/Error.stubH �+gH ��b� N vendor/jetbrains/phpstorm-stubs/parallel/parallel/Sync/Error/IllegalValue.stube �+ge > w� C vendor/jetbrains/phpstorm-stubs/parallel/parallel/Future/Error.stubJ �+gJ �b�� J vendor/jetbrains/phpstorm-stubs/parallel/parallel/Future/Error/Killed.stub\ �+g\ �<
� K vendor/jetbrains/phpstorm-stubs/parallel/parallel/Future/Error/Foreign.stub] �+g] } � M vendor/jetbrains/phpstorm-stubs/parallel/parallel/Future/Error/Cancelled.stub_ �+g_ �� �� O vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Type/Unavailable.stub> �+g> �^��� D vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error.stubK �+gK ����� T vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/IllegalVariable.stubn �+gn �[� K vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/Killed.stube �+ge �7ۑ� R vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/IllegalReturn.stubl �+gl $� 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�� K vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/Closed.stube �+ge �pp� T vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/IllegalFunction.stubn �+gn �� �� W vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Error/IllegalInstruction.stubq �+gq Z�G�� Q vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime/Object/Unavailable.stub@ �+g@ :�Ǧ� = vendor/jetbrains/phpstorm-stubs/parallel/parallel/Future.stub` �+g` .?Dä < vendor/jetbrains/phpstorm-stubs/parallel/parallel/Error.stub: �+g: {��� ; vendor/jetbrains/phpstorm-stubs/parallel/parallel/Sync.stub� �+g� 4�R�� D vendor/jetbrains/phpstorm-stubs/parallel/parallel/Channel/Error.stubK �+gK ��%� N vendor/jetbrains/phpstorm-stubs/parallel/parallel/Channel/Error/Existence.stubh �+gh ��yä Q vendor/jetbrains/phpstorm-stubs/parallel/parallel/Channel/Error/IllegalValue.stubk �+gk ��� K vendor/jetbrains/phpstorm-stubs/parallel/parallel/Channel/Error/Closed.stube �+ge ��z � C vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Input.stub0 �+g0 �>�� H vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Event/Type.stub. �+g. ϞZ>� I vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Event/Error.stubP �+gP ��R�� C vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Error.stubJ �+gJ �ž�� M vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Error/Existence.stubf �+gf �R�b� K vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Error/Timeout.stubd �+gd �J�6� C vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Event.stub� �+g� ̀�8� I vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Input/Error.stubP �+gP ?��� S vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Input/Error/Existence.stubr �+gr ��7o� V vendor/jetbrains/phpstorm-stubs/parallel/parallel/Events/Input/Error/IllegalValue.stubu �+gu i���� > vendor/jetbrains/phpstorm-stubs/parallel/parallel/Channel.stub( �+g( ��&� > vendor/jetbrains/phpstorm-stubs/parallel/parallel/Runtime.stub� �+g� 0��ˤ , vendor/jetbrains/phpstorm-stubs/ast/ast.stub [ �+g [ ��nΤ , vendor/jetbrains/phpstorm-stubs/zmq/zmq.stubzu �+gzu ��Z� . vendor/jetbrains/phpstorm-stubs/intl/intl.stub.} �+g.} �P��� 2 vendor/jetbrains/phpstorm-stubs/intl/IntlChar.stubL/ �+gL/ ��]t� B vendor/jetbrains/phpstorm-stubs/intl/IntlDatePatternGenerator.stub �+g $��J� 2 vendor/jetbrains/phpstorm-stubs/libxml/libxml.stub�$ �+g�$ �V9�� 2 vendor/jetbrains/phpstorm-stubs/expect/expect.stub� �+g� I�.Ȥ 8 vendor/jetbrains/phpstorm-stubs/xmlwriter/xmlwriter.stub�� �+g�� O�< � . vendor/jetbrains/phpstorm-stubs/geos/geos.stub�A �+g�A � �U� . vendor/jetbrains/phpstorm-stubs/uopz/uopz.stub�& �+g�& -#�� : vendor/jetbrains/phpstorm-stubs/com_dotnet/com_dotnet.stubf/ �+gf/ �b� , vendor/jetbrains/phpstorm-stubs/bz2/bz2.stubq �+gq �4 �� . vendor/jetbrains/phpstorm-stubs/exif/exif.stub� �+g� 0 Ѥ . vendor/jetbrains/phpstorm-stubs/curl/curl.stubs �+gs ���� 0 vendor/jetbrains/phpstorm-stubs/curl/curl_d.stubN �+gN r.W?� 8 vendor/jetbrains/phpstorm-stubs/curl/CURLStringFile.stub� �+g� @b� 4 vendor/jetbrains/phpstorm-stubs/sysvshm/sysvshm.stub> �+g> �� � . vendor/jetbrains/phpstorm-stubs/tidy/tidy.stubL� �+gL� �דN� . vendor/jetbrains/phpstorm-stubs/ming/ming.stubr" �+gr" 2�: � 9 vendor/jetbrains/phpstorm-stubs/Zend OPcache/OPcache.stubm
�+gm
�I�m� > vendor/jetbrains/phpstorm-stubs/ZendDebugger/ZendDebugger.stub �+g w�!� 6 vendor/jetbrains/phpstorm-stubs/libevent/libevent.stub"Y �+g"Y �0� 4 vendor/jetbrains/phpstorm-stubs/pspell/pspell_c.stub �+g R�� � 2 vendor/jetbrains/phpstorm-stubs/pspell/pspell.stubq. �+gq. �0\� @ vendor/jetbrains/phpstorm-stubs/opentelemetry/opentelemetry.stubP �+gP ���� 0 vendor/jetbrains/phpstorm-stubs/oauth/oauth.stubb �+gb ��bp� . vendor/jetbrains/phpstorm-stubs/sync/sync.stubi7 �+gi7 VB�� 2 vendor/jetbrains/phpstorm-stubs/xcache/xcache.stub� �+g� �^�)� . vendor/jetbrains/phpstorm-stubs/snmp/snmp.stub� �+g� ���� 8 vendor/jetbrains/phpstorm-stubs/interbase/interbase.stub�� �+g�� ���� 8 vendor/jetbrains/phpstorm-stubs/blackfire/blackfire.stubH �+gH Z�4� : 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� �ړ+� 0 vendor/jetbrains/phpstorm-stubs/xxtea/xxtea.stub� �+g� �$nڤ 2 vendor/jetbrains/phpstorm-stubs/crypto/crypto.stub1? �+g1? ګפ 2 vendor/jetbrains/phpstorm-stubs/docker-compose.ymlZ �+gZ zN�q� ; vendor/jetbrains/phpstorm-stubs/session/SessionHandler.stub[( �+g[( m�f � 4 vendor/jetbrains/phpstorm-stubs/session/session.stubiG �+giG ���ޤ 8 vendor/jetbrains/phpstorm-stubs/standard/standard_6.stub�� �+g�� b�Q� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_5.stubÄ �+gÄ �
4� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_4.stub�� �+g�� g�R�� 6 vendor/jetbrains/phpstorm-stubs/standard/password.stub' �+g' �O�u� 3 vendor/jetbrains/phpstorm-stubs/standard/basic.stub�, �+g�, ND� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_1.stubl� �+gl� �� O� > vendor/jetbrains/phpstorm-stubs/standard/_standard_manual.stub) �+g) �ػD� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_8.stub� �+g� �=N�� 9 vendor/jetbrains/phpstorm-stubs/standard/standard_10.stub� �+g� @�G� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_7.stub� �+g� .�Ť 8 vendor/jetbrains/phpstorm-stubs/standard/standard_3.stubyy �+gyy n�N� 4 vendor/jetbrains/phpstorm-stubs/standard/_types.stub�H �+g�H �� W� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_9.stub�� �+g�� /c;/� 8 vendor/jetbrains/phpstorm-stubs/standard/standard_2.stub"� �+g"� -�Qʤ 8 vendor/jetbrains/phpstorm-stubs/standard/standard_0.stub$� �+g$� ��>�� > vendor/jetbrains/phpstorm-stubs/standard/standard_defines.stub � �+g � ~�۞� 4 vendor/jetbrains/phpstorm-stubs/ibm_db2/ibm_db2.stub�� �+g�� �̯� , vendor/jetbrains/phpstorm-stubs/svn/svn.stubl� �+gl� � R� 2 vendor/jetbrains/phpstorm-stubs/pdflib/PDFlib.stub/T �+g/T 5% K� 6 vendor/jetbrains/phpstorm-stubs/mqseries/mqseries.stub�� �+g�� 1%� 4 vendor/jetbrains/phpstorm-stubs/inotify/inotify.stubN �+gN n��� . vendor/jetbrains/phpstorm-stubs/grpc/grpc.stub�Y �+g�Y X�K٤ . vendor/jetbrains/phpstorm-stubs/Phar/Phar.stub(� �+g(� ��6K� * vendor/jetbrains/phpstorm-stubs/uv/UV.stub �+g �h< � 4 vendor/jetbrains/phpstorm-stubs/uv/uv_functions.stub�f �+g�f ��t�� 4 vendor/jetbrains/phpstorm-stubs/gmagick/gmagick.stub�j �+g�j Y\� � . vendor/jetbrains/phpstorm-stubs/v8js/v8js.stub �+g �U�9� 4 vendor/jetbrains/phpstorm-stubs/msgpack/msgpack.stubX �+gX 2d\�� 7 vendor/jetbrains/phpstorm-stubs/redis/RedisCluster.stub,� �+g,� ��IU� 5 vendor/jetbrains/phpstorm-stubs/redis/RedisArray.stubL �+gL f�L� 8 vendor/jetbrains/phpstorm-stubs/redis/RedisSentinel.stub� �+g� z �A� 0 vendor/jetbrains/phpstorm-stubs/redis/Redis.stub�� �+g�� *��Y� 4 vendor/jetbrains/phpstorm-stubs/sockets/sockets.stub= �+g= `p�� * vendor/jetbrains/phpstorm-stubs/Ev/Ev.stub�� �+g�� ���r� . vendor/jetbrains/phpstorm-stubs/dom/dom_c.stub�_ �+g�_ ���� , vendor/jetbrains/phpstorm-stubs/dom/dom.stuby �+gy �9�� . vendor/jetbrains/phpstorm-stubs/dom/dom_n.stub� �+g� ��~� / vendor/jetbrains/phpstorm-stubs/regex/ereg.stubz �+gz =c�P� , vendor/jetbrains/phpstorm-stubs/xml/xml.stub�Z �+g�Z ��]!� 0 vendor/jetbrains/phpstorm-stubs/mssql/mssql.stub6M �+g6M �W˟� @ vendor/jetbrains/phpstorm-stubs/mosquitto-php/mosquitto-php.stubq5 �+gq5 H�^�� 8 vendor/jetbrains/phpstorm-stubs/couchbase/couchbase.stub�� �+g�� �C Ƥ 5 vendor/jetbrains/phpstorm-stubs/swoole/constants.stub�A �+g�A @�y�� < vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine.stub� �+g� N�ˤ A vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Http2/Response.stub �+g i� @ vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Http2/Request.stub� �+g� ��H1� A vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Timer/Iterator.stub� �+g� g8'� 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�ï� C vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Socket.stuba �+ga �M��� 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
� F vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Scheduler.stub� �+g� �9��� C vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/System.stub�
�+g�
S�Aۤ K vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Curl/Exception.stubp �+gp {�_Ԥ B vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/MySQL.stub< �+g< �&� � E vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Iterator.stub� �+g� 4;� C vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Client.stub� �+g� p�ծ� M vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Socket/Exception.stubr �+gr -| �� 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�*� D vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Channel.stub �+g �O�h� B vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Redis.stub�m �+g�m �%T�� D vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Coroutine/Context.stub� �+g� ���� 7 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Lock.stub �+g �.�n� 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��� > 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� D vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server/StatusInfo.stub� �+g� �.��� ? vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server/Event.stub� �+g� ��4� > vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Atomic/Long.stub� �+g� � ��� ? vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Redis/Server.stub� �+g� �?�� 9 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Atomic.stub� �+g� �eKͤ ? vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Process/Pool.stub� �+g� L4!� F vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Connection/Iterator.stub� �+g� fo�Ƥ 9 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Client.stub �+g ���Ѥ 8 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Error.stubR �+gR ��T� < vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Exception.stubZ �+gZ ���� @ vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Http/Response.stub� �+g� ��c�� ? vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Http/Request.stub� �+g� ��],� > vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Http/Server.stub` �+g` Y�� 8 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Table.stub� �+g� Ƃwդ @ vendor/jetbrains/phpstorm-stubs/swoole/Swoole/ExitException.stub �+g �� _� : vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Process.stub� �+g� 8<ڋ� B vendor/jetbrains/phpstorm-stubs/swoole/Swoole/WebSocket/Frame.stub �+g D� � C vendor/jetbrains/phpstorm-stubs/swoole/Swoole/WebSocket/Server.stub� �+g� �!Af� G vendor/jetbrains/phpstorm-stubs/swoole/Swoole/WebSocket/CloseFrame.stub� �+g� �%��� C vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Client/Exception.stubh �+gh ���;� 8 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Timer.stub{ �+g{ ��U�� 8 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Event.stub� �+g� �w��� : vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Runtime.stub �+g ��� 9 vendor/jetbrains/phpstorm-stubs/swoole/Swoole/Server.stubq& �+gq& ��EĤ 3 vendor/jetbrains/phpstorm-stubs/swoole/aliases.stubX �+gX ��ᕤ 5 vendor/jetbrains/phpstorm-stubs/swoole/functions.stub8" �+g8" 6|�� 0 vendor/jetbrains/phpstorm-stubs/event/event.stub�� �+g�� �zI� 4 vendor/jetbrains/phpstorm-stubs/gettext/gettext.stub\ �+g\ f�� 6 vendor/jetbrains/phpstorm-stubs/memcache/memcache.stub$R �+g$R U��*� / vendor/jetbrains/phpstorm-stubs/http/http3.stub]� �+g]� ���<� . vendor/jetbrains/phpstorm-stubs/http/http.stub�� �+g�� ���� , vendor/jetbrains/phpstorm-stubs/rrd/rrd.stub 0 �+g 0 ��Τ . vendor/jetbrains/phpstorm-stubs/imap/imap.stub;� �+g;� �Е�� 4 vendor/jetbrains/phpstorm-stubs/imap/Connection.stubH �+gH F�?�� 8 vendor/jetbrains/phpstorm-stubs/mapscript/mapscript.stub�� �+g�� {�|K� , vendor/jetbrains/phpstorm-stubs/dba/dba.stubE0 �+gE0 �Nԣ� 3 vendor/jetbrains/phpstorm-stubs/dba/Connection.stubG �+gG o�@3� 0 vendor/jetbrains/phpstorm-stubs/uuid/uuid_c.stub� �+g� }��j� , vendor/jetbrains/phpstorm-stubs/gmp/gmp.stub�u �+g�u �O � : vendor/jetbrains/phpstorm-stubs/LuaSandbox/LuaSandbox.stubE �+gE ��� , vendor/jetbrains/phpstorm-stubs/rar/rar.stub�_ �+g�_ EQ`� vendor/nikic/php-parser/LICENSE� �+g� ��*� @ vendor/nikic/php-parser/lib/PhpParser/NodeTraverserInterface.php� �+g� J��� 4 vendor/nikic/php-parser/lib/PhpParser/NodeFinder.php� �+g� �v��� 8 vendor/nikic/php-parser/lib/PhpParser/BuilderFactory.php�, �+g�, ��O�� / vendor/nikic/php-parser/lib/PhpParser/Error.php� �+g� %b&� 5 vendor/nikic/php-parser/lib/PhpParser/NodeVisitor.php� �+g� Y��� ? vendor/nikic/php-parser/lib/PhpParser/PrettyPrinterAbstract.php� �+g� �
�� M vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/ParentConnectingVisitor.php] �+g] �� � I vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/FirstFindingVisitor.php� �+g� ��+� K vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/NodeConnectingVisitor.phpt �+gt �k�ڤ D vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/FindingVisitor.phpl �+gl �=*�� B vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/NameResolver.php�& �+g�& �6��� D vendor/nikic/php-parser/lib/PhpParser/NodeVisitor/CloningVisitor.php� �+g� ��!F� F vendor/nikic/php-parser/lib/PhpParser/ConstExprEvaluationException.phpW �+gW �"� ? vendor/nikic/php-parser/lib/PhpParser/Node/IntersectionType.php� �+g� aD�� 4 vendor/nikic/php-parser/lib/PhpParser/Node/Param.phps �+gs b��N� 8 vendor/nikic/php-parser/lib/PhpParser/Node/Attribute.php@ �+g@ �`� : vendor/nikic/php-parser/lib/PhpParser/Node/ComplexType.phpC �+gC � �y� B vendor/nikic/php-parser/lib/PhpParser/Node/Name/FullyQualified.php� �+g� !�� � < vendor/nikic/php-parser/lib/PhpParser/Node/Name/Relative.php� �+g� ħ�J� @ vendor/nikic/php-parser/lib/PhpParser/Node/VarLikeIdentifier.php �+g T�.� 5 vendor/nikic/php-parser/lib/PhpParser/Node/Scalar.phps �+gs uQ�� 8 vendor/nikic/php-parser/lib/PhpParser/Node/UnionType.php� �+g� ���� ; vendor/nikic/php-parser/lib/PhpParser/Node/NullableType.php� �+g� �{�� 3 vendor/nikic/php-parser/lib/PhpParser/Node/Name.php �+g V�5�� 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��� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/List_.php� �+g� *�I� < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/CallLike.php �+g �p Ф ; vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PostDec.php~ �+g~ ���J� ; vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Ternary.php� �+g� ��H� < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Include_.php� �+g� O�J�� I vendor/nikic/php-parser/lib/PhpParser/Node/Expr/NullsafePropertyFetch.php� �+g� ��Ĥ < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp.php� �+g� @��ˤ : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Match_.php� �+g� x �,� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Error.php� �+g� ��2� < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp.php_ �+g_ �4A� = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ShellExec.php� �+g� ���g� = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/YieldFrom.php� �+g� i$��� ; vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PostInc.php~ �+g~ �4�Q� 8 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast.php1 �+g1 ��k� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Isset_.php �+g �i�x� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/BitwiseXor.php� �+g� ( f�� A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Plus.php� �+g�
�B� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Pow.php� �+g� �|�� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/BitwiseAnd.php� �+g� �x� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Mod.php� �+g� ǒ߿� C vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Concat.php� �+g� ����� B vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Minus.php� �+g� U��� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Mul.php� �+g� U#`ɤ F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/BitwiseOr.php� �+g� .��� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/ShiftLeft.php� �+g� wú� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Div.php� �+g� c��� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/ShiftRight.php� �+g� 7F�� E vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignOp/Coalesce.php� �+g� Q � : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Array_.php( �+g( 93�'� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Clone_.php{ �+g{ �Y�� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PreDec.php{ �+g{ Ly0�� = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/AssignRef.php8 �+g8 ��) � > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/MethodCall.php< �+g< 8��� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/UnaryMinus.php� �+g� 9���� A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ArrayDimFetch.php> �+g> 0� C vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ClassConstFetch.php� �+g� Aʤ > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ConstFetch.php� �+g� �l
� < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/FuncCall.php0 �+g0 ,fS� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Assign.php �+g � =� < vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Variable.php� �+g� %6`�� = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/UnaryPlus.php� �+g� �'( � G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BitwiseXor.php@ �+g@ �ݞ�� A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Plus.php4 �+g4 ~i1� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Pow.php3 �+g3 �9�V� 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@ �� � B vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Equal.php7 �+g7 (���� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BitwiseAnd.php@ �+g@ �LK
� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/LogicalOr.php? �+g? d�;x� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Mod.php2 �+g2 1��� K vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/SmallerOrEqual.phpI �+gI #��t� C vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Concat.php8 �+g8 " ɼ� B vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Minus.php6 �+g6 �߉� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Mul.php2 �+g2 �i�a� 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/BitwiseOr.php> �+g> Η�0� D vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Smaller.php: �+g: K��� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BooleanAnd.phpA �+gA ��(� I vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/NotIdentical.phpF �+gF ���1� K vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/GreaterOrEqual.phpI �+gI ���K� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/ShiftLeft.php? �+g? э��� D vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Greater.php: �+g: ����� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Div.php2 �+g2 ̒�_� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/BooleanOr.php? �+g? � 72� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/LogicalAnd.phpB �+gB �ا�� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/ShiftRight.phpA �+gA �rL0� E vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Coalesce.php= �+g= �:��� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BinaryOp/Identical.php@ �+g@ �.?� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Empty_.php~ �+g~ ۵�� ? vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Instanceof_.phpI �+gI �>lפ 9 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Eval_.php{ �+g{ ~��� 8 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/New_.phpx �+gx P�� F vendor/nikic/php-parser/lib/PhpParser/Node/Expr/NullsafeMethodCall.phpS �+gS �3�ͤ A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ErrorSuppress.php� �+g� j�77� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BitwiseNot.php� �+g� +2�8� G vendor/nikic/php-parser/lib/PhpParser/Node/Expr/StaticPropertyFetch.php �+g ��M � : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Throw_.php� �+g� �ճŤ = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/ArrayItem.phpi �+gi �nT� A vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PropertyFetch.php� �+g� �DG� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/StaticCall.phpJ �+gJ �� � : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Print_.php~ �+g~ �?(� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Yield_.phpN �+gN ��oP� = vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Int_.php� �+g� ��o=� @ vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/String_.php� �+g� m��3� ? vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Array_.php� �+g� 8)J]� ? 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/Object_.php� �+g� `��̤ > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Cast/Bool_.php� �+g� d��� ; vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Closure.php�
�+g�
<�/5� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Expr/Exit_.php� �+g� ��� : vendor/nikic/php-parser/lib/PhpParser/Node/Expr/PreInc.php{ �+g{ ��� > vendor/nikic/php-parser/lib/PhpParser/Node/Expr/BooleanNot.php� �+g� �$�� ; vendor/nikic/php-parser/lib/PhpParser/Node/FunctionLike.php� �+g� �,O� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Identifier.php� �+g� �m�{� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Break_.php� �+g� � � � < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Property.php�
�+g�
�/ � = vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Function_.php
�+g
܄�h� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Case_.php\ �+g\ �XEu� ; vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Global_.php� �+g� ��¤ < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/EnumCase.php� �+g� �_:Ǥ 8 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/For_.php. �+g. c�W� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Trait_.php �+g �p�/� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUse.php� �+g� �QM� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TryCatch.php* �+g* �
�� > vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ClassConst.php� �+g� ��GU� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Class_.phpr �+gr �� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Goto_.php� �+g� ci��� > vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/InlineHTML.php� �+g� �i�� D vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/PropertyProperty.php� �+g� �n��� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Label.php� �+g� ��yh� > vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Interface_.php� �+g� x�R� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Echo_.php� �+g� �+�� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Unset_.php� �+g� �c%� 7 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/If_.php* �+g* �� 7 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Do_.php2 �+g2 ��?�� ; vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ElseIf_.php9 �+g9 �t�� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Catch_.phpe �+ge �#>�� ? vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/ClassMethod.phpx �+gx ��5� B vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/DeclareDeclare.php� �+g� �ץ1� ; vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Static_.php� �+g� ��J}� @ vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/HaltCompiler.php� �+g� � )� 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/ClassLike.php �+g >��7� ; vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Return_.php� �+g� �:� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Declare_.phpw �+gw � ,� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Else_.php� �+g� wC�� 7 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Nop.php0 �+g0 cL �� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/UseUse.phpa �+ga 9�5� = vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/StaticVar.php� �+g� $�Uq� = vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Continue_.php� �+g� �U�� > vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Namespace_.php� �+g� FHod� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/GroupUse.php �+g ���!� : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/While_.php5 �+g5 �^?�� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Finally_.php� �+g� �YƤ : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Const_.php� �+g� F=eL� 9 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Enum_.phpB �+gB �~�Ȥ : vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Throw_.php� �+g� ��� ; vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Switch_.php% �+g% ߩ'� > vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Expression.php� �+g� +[�� 8 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Use_.php\ �+g\ �,�� < vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/Foreach_.php_ �+g_ �h�� F vendor/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUseAdaptation.php
�+g
!<�� 3 vendor/nikic/php-parser/lib/PhpParser/Node/Expr.php� �+g� :���� 5 vendor/nikic/php-parser/lib/PhpParser/Node/Const_.php� �+g� ��<Ѥ B vendor/nikic/php-parser/lib/PhpParser/Node/VariadicPlaceholder.php� �+g� ��E
� = vendor/nikic/php-parser/lib/PhpParser/Node/AttributeGroup.php� �+g� UP�R� 7 vendor/nikic/php-parser/lib/PhpParser/Node/MatchArm.php� �+g� j,q� = vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/String_.phpY �+gY ��28� > vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/Encapsed.php� �+g� �d� H vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/EncapsedStringPart.php� �+g� �՝� = vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/DNumber.php �+g �^�T� = vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/LNumber.phpi
�+gi
��1�� @ vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst.phpS �+gS ix� J vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Function_.phpM �+gM �fA�� G vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Trait_.phpD �+gD C���� G vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Class_.phpD �+gD +0
�� E vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/File.php@ �+g@ �g¤ D vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Dir.php= �+g= )�G�� G vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Method.phpF �+gF ��3� K vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Namespace_.phpP �+gP �t� E vendor/nikic/php-parser/lib/PhpParser/Node/Scalar/MagicConst/Line.php@ �+g@ �&Q&� 2 vendor/nikic/php-parser/lib/PhpParser/Node/Arg.php9 �+g9 �[��� 3 vendor/nikic/php-parser/lib/PhpParser/Node/Stmt.php� �+g� �Et1� 4 vendor/nikic/php-parser/lib/PhpParser/NodeDumper.phpV �+gV ��� 8 vendor/nikic/php-parser/lib/PhpParser/ParserAbstract.php� �+g� ��� � 6 vendor/nikic/php-parser/lib/PhpParser/NodeAbstract.php~ �+g~ [�W{� 5 vendor/nikic/php-parser/lib/PhpParser/JsonDecoder.phpD
�+gD
�C�D� ; 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� . vendor/nikic/php-parser/lib/PhpParser/Node.php� �+g� eȊԤ 5 vendor/nikic/php-parser/lib/PhpParser/Comment/Doc.phph �+gh �y��� 7 vendor/nikic/php-parser/lib/PhpParser/NodeTraverser.php�' �+g�' ���k� 5 vendor/nikic/php-parser/lib/PhpParser/NameContext.php�% �+g�% |m �� = vendor/nikic/php-parser/lib/PhpParser/NodeVisitorAbstract.php� �+g� 8��� : vendor/nikic/php-parser/lib/PhpParser/Builder/Property.php< �+g< L�� ; vendor/nikic/php-parser/lib/PhpParser/Builder/Function_.php1 �+g1 (�jL� 7 vendor/nikic/php-parser/lib/PhpParser/Builder/Param.php[ �+g[ \�P5� : vendor/nikic/php-parser/lib/PhpParser/Builder/EnumCase.php. �+g. �(��� 8 vendor/nikic/php-parser/lib/PhpParser/Builder/Trait_.php� �+g� ��6ۤ : vendor/nikic/php-parser/lib/PhpParser/Builder/TraitUse.php/ �+g/ G��� < vendor/nikic/php-parser/lib/PhpParser/Builder/ClassConst.php� �+g� ż�0� 8 vendor/nikic/php-parser/lib/PhpParser/Builder/Class_.php� �+g� ��� < vendor/nikic/php-parser/lib/PhpParser/Builder/Interface_.php� �+g� w�� � 8 vendor/nikic/php-parser/lib/PhpParser/Builder/Method.php{ �+g{ a,;#� > vendor/nikic/php-parser/lib/PhpParser/Builder/FunctionLike.php� �+g� ��� = vendor/nikic/php-parser/lib/PhpParser/Builder/Declaration.php� �+g� ?{� < vendor/nikic/php-parser/lib/PhpParser/Builder/Namespace_.php% �+g% ����� 7 vendor/nikic/php-parser/lib/PhpParser/Builder/Enum_.phpg �+gg koä 6 vendor/nikic/php-parser/lib/PhpParser/Builder/Use_.php� �+g� ixL� D vendor/nikic/php-parser/lib/PhpParser/Builder/TraitUseAdaptation.phpb �+gb �a��� 8 vendor/nikic/php-parser/lib/PhpParser/BuilderHelpers.php�% �+g�% դ 5 vendor/nikic/php-parser/lib/PhpParser/Parser/Php7.php�T �+g�T ���H� 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/Php5.php�+ �+g�+ P��Ĥ @ vendor/nikic/php-parser/lib/PhpParser/PrettyPrinter/Standard.phpӤ �+gӤ w��� < vendor/nikic/php-parser/lib/PhpParser/ConstExprEvaluator.phpv% �+gv% ��� 1 vendor/nikic/php-parser/lib/PhpParser/Builder.php� �+g� �� 9 vendor/nikic/php-parser/lib/PhpParser/Lexer/Emulative.php�" �+g�" LQ�c� [ vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ReadonlyFunctionTokenEmulator.php� �+g� �pX�� W vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/CoaleseEqualTokenEmulator.php �+g �V&z� W vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/FlexibleDocStringEmulator.php} �+g} �N� � S vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ReadonlyTokenEmulator.php[ �+g[ �_'�� K vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/TokenEmulator.phpm �+gm m�zG� O vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/AttributeEmulator.php� �+g� *�3� O vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/EnumTokenEmulator.php� �+g� %�d� M vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ReverseEmulator.php �+g �p�L� ] vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/NumericLiteralSeparatorEmulator.phpe �+ge NeV� M vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/FnTokenEmulator.php� �+g� ���K� M vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/KeywordEmulator.php� �+g� �I� P vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/MatchTokenEmulator.php� �+g� �6~%� S vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/NullsafeTokenEmulator.php� �+g� x�,�� S vendor/nikic/php-parser/lib/PhpParser/Lexer/TokenEmulator/ExplicitOctalEmulator.php� �+g� �<fB� ? vendor/nikic/php-parser/lib/PhpParser/ErrorHandler/Throwing.phpn �+gn �ZAM� A vendor/nikic/php-parser/lib/PhpParser/ErrorHandler/Collecting.php| �+g| ���� / vendor/nikic/php-parser/lib/PhpParser/Lexer.php&[ �+g&[ ��@� 1 vendor/nikic/php-parser/lib/PhpParser/Comment.php� �+g� �i�� 6 vendor/nikic/php-parser/lib/PhpParser/ErrorHandler.php2 �+g2 L� 7 vendor/nikic/php-parser/lib/PhpParser/ParserFactory.phpD �+gD �S�� 0 vendor/nikic/php-parser/lib/PhpParser/Parser.php� �+g� �C2Ӥ ! vendor/composer/autoload_psr4.php� �+g� }hi� vendor/composer/LICENSE. �+g. �� % vendor/composer/InstalledVersions.php? �+g? 2�Ť vendor/composer/installed.php�� �+g�� ��X� " vendor/composer/autoload_files.phpw �+gw )�� ! vendor/composer/ca-bundle/LICENSE �+g *!^`� % vendor/composer/ca-bundle/PATCHES.txt� �+g� rbmW� * vendor/composer/ca-bundle/src/CaBundle.php�+ �+g�+ bH�֤ ( vendor/composer/ca-bundle/res/cacert.pemz� �+gz� %�O� vendor/composer/pcre/LICENSE �+g hg�^� ? vendor/composer/pcre/src/PHPStan/UnsafeStrictGroupsCallRule.phpa
�+ga
�?��� G vendor/composer/pcre/src/PHPStan/PregMatchParameterOutTypeExtension.php? �+g? ��C� E vendor/composer/pcre/src/PHPStan/PregMatchTypeSpecifyingExtension.php� �+g� s�)� 3 vendor/composer/pcre/src/PHPStan/PregMatchFlags.phpd �+gd �I;� L vendor/composer/pcre/src/PHPStan/PregReplaceCallbackClosureTypeExtension.php� �+g� ��w<� < vendor/composer/pcre/src/PHPStan/InvalidRegexPatternRule.php= �+g= � C� ( vendor/composer/pcre/src/MatchResult.php �+g �D�� 7 vendor/composer/pcre/src/MatchAllStrictGroupsResult.php� �+g� �~tƤ 3 vendor/composer/pcre/src/MatchWithOffsetsResult.php� �+g� $�b�� 6 vendor/composer/pcre/src/MatchAllWithOffsetsResult.php� �+g� @9� * vendor/composer/pcre/src/PcreException.php �+g ���� * vendor/composer/pcre/src/ReplaceResult.php� �+g� �g�o� ! vendor/composer/pcre/src/Preg.phpUE �+gUE 8h 4 vendor/composer/pcre/src/MatchStrictGroupsResult.php �+g au�9� 9 vendor/composer/pcre/src/UnexpectedNullMatchException.php �+g [)�� + vendor/composer/pcre/src/MatchAllResult.php� �+g� ��%p� " vendor/composer/pcre/src/Regex.php� �+g� �94ؤ # vendor/composer/pcre/extension.neonF �+gF '��� ! vendor/composer/autoload_real.php� �+g� m>�P� ' vendor/composer/autoload_namespaces.php� �+g� �/t� vendor/composer/semver/LICENSE �+g Bh� ( vendor/composer/semver/src/Intervals.php�N �+g�N "?�*� % vendor/composer/semver/src/Semver.phpT
�+gT
�Y�� = vendor/composer/semver/src/Constraint/ConstraintInterface.php� �+g� a�|� = vendor/composer/semver/src/Constraint/MatchNoneConstraint.php� �+g� ���ڤ / vendor/composer/semver/src/Constraint/Bound.phpE
�+gE
~9Ф < vendor/composer/semver/src/Constraint/MatchAllConstraint.php� �+g� ¹�Ȥ 9 vendor/composer/semver/src/Constraint/MultiConstraint.php@# �+g@# 1�|� 4 vendor/composer/semver/src/Constraint/Constraint.php�0 �+g�0 +%�� ' vendor/composer/semver/src/Interval.php� �+g� l�� , vendor/composer/semver/src/VersionParser.php�T �+g�T �=�)� ) vendor/composer/semver/src/Comparator.phpb
�+gb
�s�d� / vendor/composer/semver/src/CompilingMatcher.php) �+g) �/�� % vendor/composer/autoload_classmap.php<� �+g<� � � vendor/composer/ClassLoader.php�? �+g�? 2@ u� & vendor/composer/xdebug-handler/LICENSE) �+g) #�;^� . vendor/composer/xdebug-handler/src/Process.phpn �+gn �7ĵ� 4 vendor/composer/xdebug-handler/src/XdebugHandler.php}T �+g}T w�S)� 0 vendor/composer/xdebug-handler/src/PhpConfig.php� �+g� ���0� - vendor/composer/xdebug-handler/src/Status.phpe �+ge �b�R� # vendor/composer/autoload_static.php�C �+g�C ���� vendor/autoload.php �+g U�� vendor/react/stream/LICENSEu �+gu �{�� + vendor/react/stream/src/CompositeStream.phph �+gh �6��� 2 vendor/react/stream/src/WritableResourceStream.php �+g EY�l� ) vendor/react/stream/src/ThroughStream.php� �+g� a��� 3 vendor/react/stream/src/ReadableStreamInterface.php�7 �+g�7 %�B� 2 vendor/react/stream/src/ReadableResourceStream.php� �+g� �;��� vendor/react/stream/src/Util.php� �+g� �|.�� 1 vendor/react/stream/src/DuplexStreamInterface.php� �+g� ɆHŤ 3 vendor/react/stream/src/WritableStreamInterface.php�9 �+g�9 2�� 0 vendor/react/stream/src/DuplexResourceStream.php� �+g� ��Ǥ vendor/react/async/LICENSE^ �+g^ yT � , vendor/react/async/src/functions_include.php� �+g� A��m� $ vendor/react/async/src/functions.php�B �+g�B �O�u� " vendor/react/child-process/LICENSEu �+gu �{�� * vendor/react/child-process/src/Process.php�: �+g�: �ٱ� vendor/react/cache/LICENSEu �+gu �{�� ) vendor/react/cache/src/CacheInterface.php0 �+g0 ���L� % vendor/react/cache/src/ArrayCache.php_ �+g_ [�=o� vendor/react/promise/LICENSEg �+gg �F� 6 vendor/react/promise/src/Exception/LengthException.phpq �+gq %�#� 9 vendor/react/promise/src/Exception/CompositeException.phpt �+gt �PnJ� $ vendor/react/promise/src/Promise.php#( �+g#( � - vendor/react/promise/src/PromiseInterface.phpm �+gm ��q� 5 vendor/react/promise/src/Internal/RejectedPromise.php�
�+g�
m�k� 7 vendor/react/promise/src/Internal/CancellationQueue.php' �+g' *� 6 vendor/react/promise/src/Internal/FulfilledPromise.phpT �+gT �}
�� . vendor/react/promise/src/functions_include.php� �+g� 9�� & vendor/react/promise/src/functions.php�, �+g�, e�{�� % vendor/react/promise/src/Deferred.php% �+g% ��H<� vendor/react/event-loop/LICENSEu �+gu �{�� . vendor/react/event-loop/src/SignalsHandler.php+ �+g+ iSˌ� , vendor/react/event-loop/src/Timer/Timers.php� �+g� &B4� + vendor/react/event-loop/src/Timer/Timer.php6 �+g6
b[�� , vendor/react/event-loop/src/ExtEventLoop.php� �+g� �f�� $ vendor/react/event-loop/src/Loop.php9 �+g9 s�J`� - vendor/react/event-loop/src/LoopInterface.php�K �+g�K V��ߤ 4 vendor/react/event-loop/src/Tick/FutureTickQueue.php� �+g� � �ۤ ) vendor/react/event-loop/src/ExtEvLoop.php� �+g� ��b{� / vendor/react/event-loop/src/ExtLibeventLoop.php�! �+g�! �5�� ' vendor/react/event-loop/src/Factory.php< �+g< �3ﵤ . vendor/react/event-loop/src/TimerInterface.php� �+g� W�g� ) vendor/react/event-loop/src/ExtUvLoop.php�# �+g�# �(m� , vendor/react/event-loop/src/ExtLibevLoop.php� �+g� 7��� 0 vendor/react/event-loop/src/StreamSelectLoop.php/ �+g/ ÷�� vendor/react/socket/LICENSEu �+gu �{�� : vendor/react/socket/src/HappyEyeBallsConnectionBuilder.php�- �+g�- �<t
� . vendor/react/socket/src/ConnectorInterface.php= �+g= Z�CӤ 2 vendor/react/socket/src/HappyEyeBallsConnector.php� �+g� ӬS�� & vendor/react/socket/src/Connection.php� �+g� 4u�V� + vendor/react/socket/src/SecureConnector.phpJ �+gJ ,+� ( vendor/react/socket/src/TcpConnector.php �+g ��\�� % vendor/react/socket/src/Connector.php� �+g� ���q� * vendor/react/socket/src/LimitingServer.php� �+g� `c��� , vendor/react/socket/src/StreamEncryption.php� �+g� ���t� , vendor/react/socket/src/TimeoutConnector.phpa �+ga �6��� / vendor/react/socket/src/ConnectionInterface.phpm �+gm ;�� ( vendor/react/socket/src/SocketServer.php�" �+g�" ��8�� % vendor/react/socket/src/TcpServer.php�" �+g�" xVn� - vendor/react/socket/src/FixedUriConnector.php< �+g< Z�J�� " vendor/react/socket/src/Server.php� �+g� K��� ( vendor/react/socket/src/SecureServer.php �+g ���:� $ vendor/react/socket/src/FdServer.php �+g ;�FŤ & vendor/react/socket/src/UnixServer.php� �+g� �0k� ( vendor/react/socket/src/DnsConnector.php� �+g� �� + vendor/react/socket/src/ServerInterface.php� �+g� Z�O�� ) vendor/react/socket/src/UnixConnector.php� �+g� ��a� vendor/react/dns/LICENSEu �+gu �{�� ) vendor/react/dns/src/Config/HostsFile.php� �+g� ��,�� & vendor/react/dns/src/Config/Config.phpK �+gK ���� % vendor/react/dns/src/Model/Record.php� �+g� k��(� & vendor/react/dns/src/Model/Message.php� �+g� �ź� 0 vendor/react/dns/src/RecordNotFoundException.phpk �+gk �IOH� + vendor/react/dns/src/Query/CoopExecutor.php�
�+g�
�)�� 0 vendor/react/dns/src/Query/HostsFileExecutor.php� �+g� �_X;� 0 vendor/react/dns/src/Query/ExecutorInterface.php� �+g� ��6ޤ . vendor/react/dns/src/Query/TimeoutExecutor.php �+g �ѡ¤ 4 vendor/react/dns/src/Query/CancellationException.phpv �+gv �Ј�� 3 vendor/react/dns/src/Query/UdpTransportExecutor.phph! �+gh! ��Q � 9 vendor/react/dns/src/Query/SelectiveTransportExecutor.php
�+g
fhݤ 3 vendor/react/dns/src/Query/TcpTransportExecutor.php�6 �+g�6 [#�^� / vendor/react/dns/src/Query/TimeoutException.phpj �+gj �ZW�� / vendor/react/dns/src/Query/FallbackExecutor.php� �+g� �
-� . vendor/react/dns/src/Query/CachingExecutor.phpU
�+gU
o1� , vendor/react/dns/src/Query/RetryExecutor.phpK
�+gK
zr� $ vendor/react/dns/src/Query/Query.php �+g �� � ) vendor/react/dns/src/Resolver/Factory.php� �+g� ��;� * vendor/react/dns/src/Resolver/Resolver.php �+g �ɂǤ 3 vendor/react/dns/src/Resolver/ResolverInterface.php� �+g� ��Iڤ . vendor/react/dns/src/Protocol/BinaryDumper.phpQ �+gQ p�Kc� ( vendor/react/dns/src/Protocol/Parser.php, �+g, ��Z� + vendor/react/dns/src/BadServerException.phpf �+gf p�o�� vendor/react/http/LICENSEu �+gu �{�� vendor/react/http/PATCHES.txt� �+g� !=�y� F vendor/react/http/src/Middleware/LimitConcurrentRequestsMiddleware.php� �+g� u�y(� @ vendor/react/http/src/Middleware/RequestBodyParserMiddleware.php^ �+g^ �8F� @ vendor/react/http/src/Middleware/RequestBodyBufferMiddleware.php3 �+g3 �5�� ? vendor/react/http/src/Middleware/StreamingRequestMiddleware.php/
�+g/
g� O� , vendor/react/http/src/Io/AbstractRequest.php� �+g� |�=� # vendor/react/http/src/Io/Sender.php� �+g� �~ ֤ / vendor/react/http/src/Io/ReadableBodyStream.php
�+g
Q2S� ) vendor/react/http/src/Io/BufferedBody.php� �+g� ; q�� " vendor/react/http/src/Io/Clock.php� �+g� E��Ѥ 0 vendor/react/http/src/Io/ClientRequestStream.php) �+g) #��� , vendor/react/http/src/Io/EmptyBodyStream.phpH �+gH �2� / vendor/react/http/src/Io/ClientRequestState.php- �+g- ���.� . vendor/react/http/src/Io/PauseBufferStream.php �+g �`�3� , vendor/react/http/src/Io/MultipartParser.php($ �+g($ �ú� $ vendor/react/http/src/Io/IniUtil.phps �+gs �g�� + vendor/react/http/src/Io/ChunkedEncoder.phpQ �+gQ ��V� ) vendor/react/http/src/Io/UploadedFile.php� �+g� � 7� 2 vendor/react/http/src/Io/CloseProtectionStream.php6 �+g6 +�u� 4 vendor/react/http/src/Io/ClientConnectionManager.php� �+g� �C� + vendor/react/http/src/Io/HttpBodyStream.php� �+g� �׀�� + vendor/react/http/src/Io/ChunkedDecoder.php/ �+g/ n�Τ ( vendor/react/http/src/Io/Transaction.php�, �+g�, �5 {� , vendor/react/http/src/Io/StreamingServer.phpQH �+gQH �4RE� 0 vendor/react/http/src/Io/LengthLimitedStream.php �+g ��} � 0 vendor/react/http/src/Io/RequestHeaderParser.php �+g ���� - vendor/react/http/src/Io/MiddlewareRunner.php� �+g� !� ݤ , vendor/react/http/src/Io/AbstractMessage.php� �+g� Y:�� ! vendor/react/http/src/Browser.phpN| �+gN| ��a� vendor/react/http/src/Server.phpF �+gF �� � ' vendor/react/http/src/Client/Client.php� �+g� Oå�� $ vendor/react/http/src/HttpServer.php�< �+g�< ��F5� / vendor/react/http/src/Message/ServerRequest.php/ �+g/ �KtN� % vendor/react/http/src/Message/Uri.phpL% �+gL% �~�� ) vendor/react/http/src/Message/Request.php" �+g" ��[?� * vendor/react/http/src/Message/Response.php}9 �+g}9 ��Τ 3 vendor/react/http/src/Message/ResponseException.php� �+g� ܿ� vendor/psr/http-message/LICENSE= �+g= ��� 6 vendor/psr/http-message/src/ServerRequestInterface.php�' �+g�' F[ѧ� 0 vendor/psr/http-message/src/MessageInterface.phpR �+gR �t'� , vendor/psr/http-message/src/UriInterface.php�1 �+g�1 �# Ҥ / vendor/psr/http-message/src/StreamInterface.php� �+g� �X�� 0 vendor/psr/http-message/src/RequestInterface.php �+g ���4� 5 vendor/psr/http-message/src/UploadedFileInterface.phpp �+gp �T� 1 vendor/psr/http-message/src/ResponseInterface.phpU
�+gU
�=Q� vendor/psr/log/LICENSE= �+g= p��O� ! vendor/psr/log/src/NullLogger.php� �+g� z�I�� ' vendor/psr/log/src/LoggerAwareTrait.php� �+g� �� " vendor/psr/log/src/LoggerTrait.phpL �+gL 0�<� + vendor/psr/log/src/LoggerAwareInterface.php< �+g< ���� & vendor/psr/log/src/LoggerInterface.php
�+g
�k� vendor/psr/log/src/LogLevel.phpL �+gL )�U� / vendor/psr/log/src/InvalidArgumentException.phps �+gs �D��� % vendor/psr/log/src/AbstractLogger.php� �+g� 0�h�� vendor/psr/container/LICENSEy �+gy �O�p� 7 vendor/psr/container/src/NotFoundExceptionInterface.php� �+g� ��\4� / vendor/psr/container/src/ContainerInterface.php" �+g" {�4� 8 vendor/psr/container/src/ContainerExceptionInterface.php� �+g� E��� . vendor/fidry/cpu-core-counter/bin/diagnose.phpl �+gl �� %� - vendor/fidry/cpu-core-counter/bin/execute.phpk �+gk �
ף� / vendor/fidry/cpu-core-counter/src/Diagnoser.php{ �+g{ �22� = vendor/fidry/cpu-core-counter/src/NumberOfCpuCoreNotFound.php$ �+g$ ����� ? vendor/fidry/cpu-core-counter/src/Executor/ProcOpenExecutor.php� �+g� be�y� > vendor/fidry/cpu-core-counter/src/Executor/ProcessExecutor.php� �+g� ��٦� 4 vendor/fidry/cpu-core-counter/src/CpuCoreCounter.phpk �+gk �-� < vendor/fidry/cpu-core-counter/src/Finder/HwLogicalFinder.phpv �+gv �7�� @ vendor/fidry/cpu-core-counter/src/Finder/LscpuPhysicalFinder.phpx �+gx �y��� : vendor/fidry/cpu-core-counter/src/Finder/CpuCoreFinder.php �+g �7��� = vendor/fidry/cpu-core-counter/src/Finder/HwPhysicalFinder.phpz �+gz �&k� 8 vendor/fidry/cpu-core-counter/src/Finder/NProcFinder.php& �+g& ��}� ; vendor/fidry/cpu-core-counter/src/Finder/FinderRegistry.phpe �+ge �p � ? vendor/fidry/cpu-core-counter/src/Finder/DummyCpuCoreFinder.phpA �+gA "��G� > vendor/fidry/cpu-core-counter/src/Finder/NullCpuCoreFinder.php� �+g� �nX� : vendor/fidry/cpu-core-counter/src/Finder/CpuInfoFinder.php� �+g� X� > vendor/fidry/cpu-core-counter/src/Finder/_NProcessorFinder.php� �+g� ��>�� ? vendor/fidry/cpu-core-counter/src/Finder/LscpuLogicalFinder.phpM �+gM �F�&� @ vendor/fidry/cpu-core-counter/src/Finder/ProcOpenBasedFinder.php �+g � 1R� ? vendor/fidry/cpu-core-counter/src/Finder/WmicPhysicalFinder.php� �+g�
O?� A vendor/fidry/cpu-core-counter/src/Finder/SkipOnOSFamilyFinder.php� �+g� �_�_� A vendor/fidry/cpu-core-counter/src/Finder/OnlyOnOSFamilyFinder.php� �+g� �\� > vendor/fidry/cpu-core-counter/src/Finder/WmicLogicalFinder.php� �+g� 7�!Ȥ = vendor/fidry/cpu-core-counter/src/Finder/NProcessorFinder.php� �+g� e�Ӥ vendor/clue/ndjson-react/LICENSE: �+g: �DiG� ( vendor/clue/ndjson-react/src/Encoder.php� �+g� �3� ( vendor/clue/ndjson-react/src/Decoder.php� �+g� �@k� , vendor/ondram/ci-detector/src/Ci/Jenkins.php� �+g� v�� + vendor/ondram/ci-detector/src/Ci/Travis.php� �+g� DCxE� 7 vendor/ondram/ci-detector/src/Ci/BitbucketPipelines.php� �+g� � ;� - vendor/ondram/ci-detector/src/Ci/Codeship.php �+g m�ww� * vendor/ondram/ci-detector/src/Ci/Drone.php2 �+g2
��� + vendor/ondram/ci-detector/src/Ci/GitLab.php �+g =%F5� 2 vendor/ondram/ci-detector/src/Ci/GitHubActions.php �+g 6�� + vendor/ondram/ci-detector/src/Ci/Bamboo.php8 �+g8 8�z7� 0 vendor/ondram/ci-detector/src/Ci/CiInterface.php� �+g� \'QO� - vendor/ondram/ci-detector/src/Ci/TeamCity.php� �+g� ��}Ȥ / vendor/ondram/ci-detector/src/Ci/AbstractCi.php� �+g� 4&�� 1 vendor/ondram/ci-detector/src/Ci/AwsCodeBuild.php� �+g� ���� , vendor/ondram/ci-detector/src/Ci/Wercker.php. �+g. ��O�� + vendor/ondram/ci-detector/src/Ci/Circle.php� �+g� s� ޤ - vendor/ondram/ci-detector/src/Ci/AppVeyor.php� �+g� z �� * vendor/ondram/ci-detector/src/Ci/Buddy.php �+g �%�ˤ 2 vendor/ondram/ci-detector/src/Ci/Continuousphp.phpi �+gi ��� % vendor/ondram/ci-detector/src/Env.php� �+g� Ɵ~N� B vendor/ondram/ci-detector/src/Exception/CiNotDetectedException.php� �+g� ��(D� , vendor/ondram/ci-detector/src/CiDetector.php�
�+g�
0-�U� . vendor/ondram/ci-detector/src/TrinaryLogic.php? �+g? �V�� 9 vendor/nette/robot-loader/src/RobotLoader/RobotLoader.php�@ �+g�@ ��j� vendor/nette/neon/bin/neon-lintK �+gK Z��� vendor/nette/neon/PATCHES.txt� �+g� 0��O� & vendor/nette/neon/src/Neon/Encoder.phph
�+gh
��J� $ vendor/nette/neon/src/Neon/Token.php} �+g} �'�� * vendor/nette/neon/src/Neon/TokenStream.php. �+g. ,���� / vendor/nette/neon/src/Neon/Node/LiteralNode.phpE �+gE ���i� . vendor/nette/neon/src/Neon/Node/StringNode.php�
�+g�
��5� 3 vendor/nette/neon/src/Neon/Node/EntityChainNode.php �+g ���� 3 vendor/nette/neon/src/Neon/Node/InlineArrayNode.php_ �+g_ اg� - vendor/nette/neon/src/Neon/Node/ArrayNode.php� �+g� ��� . vendor/nette/neon/src/Neon/Node/EntityNode.phpY �+gY ��ݤ 2 vendor/nette/neon/src/Neon/Node/BlockArrayNode.php� �+g� "� 1� 1 vendor/nette/neon/src/Neon/Node/ArrayItemNode.php� �+g� d(� � % vendor/nette/neon/src/Neon/Entity.php� �+g� ��T�� & vendor/nette/neon/src/Neon/Decoder.php� �+g� ��� ( vendor/nette/neon/src/Neon/Traverser.phpj �+gj �}2�� # vendor/nette/neon/src/Neon/Neon.php� �+g� �9�j� # vendor/nette/neon/src/Neon/Node.php� �+g� ���Q� ( vendor/nette/neon/src/Neon/Exception.php7 �+g7 �qa�� $ vendor/nette/neon/src/Neon/Lexer.php
�+g
��h�� % vendor/nette/neon/src/Neon/Parser.php�! �+g�! �h�� vendor/nette/di/PATCHES.txt� �+g� ���� % vendor/nette/di/src/compatibility.php� �+g� gT�� 6 vendor/nette/di/src/Bridges/DITracy/ContainerPanel.phpi
�+gi
�{s� 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/src/DI/Config/Loader.php4 �+g4 u�Bx� ) vendor/nette/di/src/DI/Config/Helpers.php% �+g% @�gj� ) vendor/nette/di/src/DI/Config/Adapter.php� �+g� <�B� 6 vendor/nette/di/src/DI/Config/Adapters/NeonAdapter.php� �+g� "� 5 vendor/nette/di/src/DI/Config/Adapters/PhpAdapter.php� �+g� A7
�� 7 vendor/nette/di/src/DI/Extensions/ServicesExtension.php �+g v��ͤ 8 vendor/nette/di/src/DI/Extensions/DecoratorExtension.phpg �+gg Okc� 1 vendor/nette/di/src/DI/Extensions/DIExtension.php9
�+g9
II�� 9 vendor/nette/di/src/DI/Extensions/ParametersExtension.php{ �+g{ :yC� 2 vendor/nette/di/src/DI/Extensions/PhpExtension.php� �+g� �`� 5 vendor/nette/di/src/DI/Extensions/InjectExtension.php� �+g� "W�� 5 vendor/nette/di/src/DI/Extensions/SearchExtension.php� �+g� �U'O� 8 vendor/nette/di/src/DI/Extensions/ConstantsExtension.php� �+g� &��� 9 vendor/nette/di/src/DI/Extensions/ExtensionsExtension.php �+g N3��� 6 vendor/nette/di/src/DI/Extensions/DefinitionSchema.phpo �+go t��0� , vendor/nette/di/src/DI/DependencyChecker.php �+g �O Ƥ + vendor/nette/di/src/DI/ContainerBuilder.php�+ �+g�+ �o�Ф ' vendor/nette/di/src/DI/PhpGenerator.php� �+g� �� =� " vendor/nette/di/src/DI/Helpers.php�# �+g�# ���X� , vendor/nette/di/src/DI/CompilerExtension.php� �+g� �x�� * vendor/nette/di/src/DI/ContainerLoader.phpL �+gL 4ilw� # vendor/nette/di/src/DI/Compiler.php�% �+g�% �5� % vendor/nette/di/src/DI/exceptions.php6 �+g6 ��vh� $ vendor/nette/di/src/DI/Container.php:, �+g:, f}x6� 8 vendor/nette/di/src/DI/Definitions/FactoryDefinition.phpG# �+gG# t(��� 9 vendor/nette/di/src/DI/Definitions/ImportedDefinition.php �+g r��p� 1 vendor/nette/di/src/DI/Definitions/Definition.php' �+g' ��O � 9 vendor/nette/di/src/DI/Definitions/AccessorDefinition.php$ �+g$ �\ͤ 8 vendor/nette/di/src/DI/Definitions/ServiceDefinition.phpi �+gi f2 �� 0 vendor/nette/di/src/DI/Definitions/Reference.php� �+g� ��b�� 0 vendor/nette/di/src/DI/Definitions/Statement.php� �+g� �N=S� 8 vendor/nette/di/src/DI/Definitions/LocatorDefinition.phpu �+gu ��f� # vendor/nette/di/src/DI/Resolver.php�b �+g�b D] �� , vendor/nette/di/src/DI/Attributes/Inject.php! �+g! yDꩤ + vendor/nette/di/src/DI/DynamicParameter.phpo �+go P^8ۤ % vendor/nette/di/src/DI/Autowiring.phpc �+gc ��+� 8 vendor/nette/php-generator/src/PhpGenerator/Property.php�
�+g�
I�]� 6 vendor/nette/php-generator/src/PhpGenerator/Dumper.php8# �+g8# �#;M� 9 vendor/nette/php-generator/src/PhpGenerator/Extractor.php > �+g > ���p� 8 vendor/nette/php-generator/src/PhpGenerator/EnumCase.php� �+g� ]
}l� 8 vendor/nette/php-generator/src/PhpGenerator/TraitUse.php� �+g� #1Oc� 7 vendor/nette/php-generator/src/PhpGenerator/Printer.php[4 �+g[4 Z��� 7 vendor/nette/php-generator/src/PhpGenerator/Literal.php
�+g
��HX� 9 vendor/nette/php-generator/src/PhpGenerator/Attribute.php_ �+g_ T(4� 7 vendor/nette/php-generator/src/PhpGenerator/PhpFile.php� �+g� � 7 vendor/nette/php-generator/src/PhpGenerator/Helpers.php� �+g� %�� 8 vendor/nette/php-generator/src/PhpGenerator/Constant.php� �+g� �}�@� 9 vendor/nette/php-generator/src/PhpGenerator/Parameter.php+
�+g+
u֩� 6 vendor/nette/php-generator/src/PhpGenerator/Method.php� �+g� F �
� : vendor/nette/php-generator/src/PhpGenerator/PsrPrinter.php� �+g� Q�d�� E vendor/nette/php-generator/src/PhpGenerator/Traits/AttributeAware.php� �+g� z�&n� F vendor/nette/php-generator/src/PhpGenerator/Traits/VisibilityAware.php< �+g< ^�\Q� C vendor/nette/php-generator/src/PhpGenerator/Traits/CommentAware.php� �+g� ��.� C vendor/nette/php-generator/src/PhpGenerator/Traits/FunctionLike.php0 �+g0 ˇ�� @ vendor/nette/php-generator/src/PhpGenerator/Traits/NameAware.php� �+g� !�>� 7 vendor/nette/php-generator/src/PhpGenerator/Factory.php�3 �+g�3 m00�� > vendor/nette/php-generator/src/PhpGenerator/GlobalFunction.php� �+g� ���"� 4 vendor/nette/php-generator/src/PhpGenerator/Type.phpX �+gX ض܊� < vendor/nette/php-generator/src/PhpGenerator/PhpNamespace.phpC' �+gC' 3��i� : vendor/nette/php-generator/src/PhpGenerator/PhpLiteral.php� �+g� �� )� A vendor/nette/php-generator/src/PhpGenerator/PromotedParameter.php� �+g� �6�Y� 9 vendor/nette/php-generator/src/PhpGenerator/ClassType.phpF; �+gF; �4X� 7 vendor/nette/php-generator/src/PhpGenerator/Closure.php� �+g� �&� " vendor/nette/php-generator/ncs.php' �+g' g�P�� @ vendor/nette/bootstrap/src/Bootstrap/Extensions/PhpExtension.phpQ �+gQ ��J� F vendor/nette/bootstrap/src/Bootstrap/Extensions/ConstantsExtension.php) �+g) L�@� 5 vendor/nette/bootstrap/src/Bootstrap/Configurator.php, �+g, �0�� + vendor/nette/bootstrap/src/Configurator.php� �+g� ����� ) vendor/nette/schema/src/Schema/Schema.phpy �+gy �[x� 6 vendor/nette/schema/src/Schema/ValidationException.php� �+g� �[A� * vendor/nette/schema/src/Schema/Helpers.php �+g m+Q�� * vendor/nette/schema/src/Schema/Context.php� �+g� yy� , vendor/nette/schema/src/Schema/Processor.php
�+g
�6� ) vendor/nette/schema/src/Schema/Expect.php� �+g� ͼ�$� 0 vendor/nette/schema/src/Schema/Elements/Base.php� �+g� ��_�� 1 vendor/nette/schema/src/Schema/Elements/AnyOf.phpV �+gV y4� 0 vendor/nette/schema/src/Schema/Elements/Type.php� �+g� `
�� 5 vendor/nette/schema/src/Schema/Elements/Structure.php� �+g� �2�� * vendor/nette/schema/src/Schema/Message.php� �+g� �Z7� 3 vendor/nette/schema/src/Schema/DynamicParameter.php� �+g� x�K3� vendor/nette/utils/ncs.xml� �+g� � � % vendor/nette/utils/src/Translator.php� �+g� �o�Ť ) vendor/nette/utils/src/HtmlStringable.phpl �+gl ���w� ( vendor/nette/utils/src/compatibility.php �+g �ui� & vendor/nette/utils/src/StaticClass.php� �+g� ��Y� % vendor/nette/utils/src/exceptions.php� �+g� Aw�2� * vendor/nette/utils/src/Utils/Paginator.php� �+g� �\�٤ ) vendor/nette/utils/src/Utils/DateTime.php_ �+g_ z� .� % vendor/nette/utils/src/Utils/Html.php�Z �+g�Z �r�� ( vendor/nette/utils/src/Utils/Helpers.php� �+g� ���*� . vendor/nette/utils/src/Utils/ObjectHelpers.phpF �+gF ��{� + vendor/nette/utils/src/Utils/Reflection.php{7 �+g{7 Ur Ť * vendor/nette/utils/src/Utils/ArrayList.php� �+g� �'#� ' vendor/nette/utils/src/Utils/Random.php� �+g� �K3�� , vendor/nette/utils/src/Utils/ObjectMixin.php �+g >_ � ( vendor/nette/utils/src/Utils/Strings.phpqQ �+gqQ I��� + vendor/nette/utils/src/Utils/exceptions.php� �+g� �+�� & vendor/nette/utils/src/Utils/Image.php�` �+g�` ߡ�� % vendor/nette/utils/src/Utils/Type.php� �+g� �3�x� % vendor/nette/utils/src/Utils/Json.php� �+g� tYդ + vendor/nette/utils/src/Utils/FileSystem.php� �+g� � �� ' vendor/nette/utils/src/Utils/Floats.phpm �+gm Y\�z� ) vendor/nette/utils/src/Utils/Callback.php� �+g� ��K � ' vendor/nette/utils/src/Utils/Arrays.php�1 �+g�1 ���� + vendor/nette/utils/src/Utils/Validators.php�+ �+g�+ ��m� * vendor/nette/utils/src/Utils/ArrayHash.phpN �+gN �w�� & vendor/nette/utils/src/SmartObject.php �+g $�%�� 4 vendor/nette/utils/src/Iterators/CachingIterator.php�
�+g�
���� + vendor/nette/utils/src/Iterators/Mapper.php� �+g� ���� vendor/nette/utils/ncs.php8 �+g8 H��/� ( vendor/nette/finder/src/Utils/Finder.php�* �+g�* ��
B� $ vendor/fig/http-message-util/LICENSE= �+g= ��?� 8 vendor/fig/http-message-util/src/StatusCodeInterface.phpy �+gy {K邤 ; vendor/fig/http-message-util/src/RequestMethodInterface.php� �+g� �t�$� $ vendor/phpstan/phpdoc-parser/LICENSE. �+g. �-� 2 vendor/phpstan/phpdoc-parser/src/Ast/Attribute.php9 �+g9 ���� 4 vendor/phpstan/phpdoc-parser/src/Ast/NodeVisitor.php�
�+g�
o���� C vendor/phpstan/phpdoc-parser/src/Ast/NodeVisitor/CloningVisitor.php� �+g� �d��� < vendor/phpstan/phpdoc-parser/src/Ast/AbstractNodeVisitor.php� �+g� �/�� 7 vendor/phpstan/phpdoc-parser/src/Ast/NodeAttributes.php� �+g� �YXT� 6 vendor/phpstan/phpdoc-parser/src/Ast/Type/TypeNode.php� �+g� �]�ˤ G vendor/phpstan/phpdoc-parser/src/Ast/Type/CallableTypeParameterNode.php� �+g� \6�� B vendor/phpstan/phpdoc-parser/src/Ast/Type/IntersectionTypeNode.phpF �+gF 7�6� > vendor/phpstan/phpdoc-parser/src/Ast/Type/CallableTypeNode.php� �+g� /,|� @ vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayShapeItemNode.php� �+g� �ԯ� : vendor/phpstan/phpdoc-parser/src/Ast/Type/ThisTypeNode.php( �+g( +�� = vendor/phpstan/phpdoc-parser/src/Ast/Type/InvalidTypeNode.phpS �+gS ���� ; vendor/phpstan/phpdoc-parser/src/Ast/Type/ConstTypeNode.php �+g !�.ߤ M vendor/phpstan/phpdoc-parser/src/Ast/Type/ConditionalTypeForParameterNode.phpA �+gA >a��� < vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayShapeNode.php$ �+g$ ��̤ A vendor/phpstan/phpdoc-parser/src/Ast/Type/ObjectShapeItemNode.php �+g ��� > vendor/phpstan/phpdoc-parser/src/Ast/Type/NullableTypeNode.php� �+g� K6�ˤ = vendor/phpstan/phpdoc-parser/src/Ast/Type/GenericTypeNode.phpR �+gR q�`� H vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayShapeUnsealedTypeNode.php! �+g! ��� @ vendor/phpstan/phpdoc-parser/src/Ast/Type/IdentifierTypeNode.php� �+g� F �� = vendor/phpstan/phpdoc-parser/src/Ast/Type/ObjectShapeNode.phpM �+gM ͥR�� B vendor/phpstan/phpdoc-parser/src/Ast/Type/OffsetAccessTypeNode.php_ �+g_ H �Ǥ ; vendor/phpstan/phpdoc-parser/src/Ast/Type/ArrayTypeNode.php� �+g� �Ξ�� ; vendor/phpstan/phpdoc-parser/src/Ast/Type/UnionTypeNode.php? �+g? T�� A vendor/phpstan/phpdoc-parser/src/Ast/Type/ConditionalTypeNode.phpN �+gN ��@� @ vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprNode.php� �+g� 0��K� D vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprNullNode.php; �+g; �g
�� I vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprArrayItemNode.php �+g 4�|ͤ D vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprTrueNode.php; �+g; �ĉE� F vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprStringNode.php� �+g� č �� E vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprArrayNode.phpF �+gF D��� E vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprFalseNode.php= �+g= P1w1� N vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/DoctrineConstExprStringNode.phpu �+gu �,wѤ P vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/QuoteAwareConstExprStringNode.phpP �+gP �� ]� A vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstFetchNode.php� �+g� �[e� E vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprFloatNode.php� �+g� �� G vendor/phpstan/phpdoc-parser/src/Ast/ConstExpr/ConstExprIntegerNode.php� �+g� ҳ��� - vendor/phpstan/phpdoc-parser/src/Ast/Node.phpw �+gw ?S;
� 6 vendor/phpstan/phpdoc-parser/src/Ast/NodeTraverser.php�* �+g�* �B,�� H vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/AssertTagMethodValueNode.php� �+g� �Ěd� C vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/SelfOutTagValueNode.php� �+g� ��2K� [ vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamImmediatelyInvokedCallableTagValueNode.php� �+g� 5S� V vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PureUnlessCallableIsImpureTagValueNode.php� �+g� Z t� @ vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/UsesTagValueNode.php� �+g� ���� B vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ThrowsTagValueNode.php� �+g� ��6�� ? vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/VarTagValueNode.phpB �+gB kN�-� L vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamClosureThisTagValueNode.php: �+g: ��ę� : vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocNode.php65 �+g65 �}nz� A vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamTagValueNode.php� �+g� ����� ? vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocChildNode.php� �+g� ���� D vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TemplateTagValueNode.php: �+g: U��� A vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/MixinTagValueNode.php� �+g� a��� D vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PropertyTagValueNode.php- �+g- Y�?Ť I vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TypelessParamTagValueNode.php �+g ���<� B vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/AssertTagValueNode.phpp �+gp �>䍤 > vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocTextNode.php� �+g� ��N� = vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocTagNode.php( �+g( Xr�� C vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/InvalidTagValueNode.php� �+g� >��N� J vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/RequireExtendsTagValueNode.php� �+g� B'�� B vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/PhpDocTagValueNode.php� �+g� ��9e� B vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ReturnTagValueNode.php� �+g� �H� D vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamOutTagValueNode.php2 �+g2 m� K vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/MethodTagValueParameterNode.php3 �+g3 �뉤 C vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ExtendsTagValueNode.php� �+g� uE此 U vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/ParamLaterInvokedCallableTagValueNode.php� �+g� Oؼ�� K vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TypeAliasImportTagValueNode.php� �+g� pк� M vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/RequireImplementsTagValueNode.php� �+g� �:Eˤ J vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/AssertTagPropertyValueNode.php� �+g� �P�o� C vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/GenericTagValueNode.php� �+g� �&�� F vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/DeprecatedTagValueNode.php �+g 2��w� M vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineTagValueNode.php� �+g� ^�� F vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/Doctrine/DoctrineArray.phpT �+gT |�m�� 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/ImplementsTagValueNode.php� �+g� ?��� B vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/MethodTagValueNode.php� �+g� 4�>ˤ E vendor/phpstan/phpdoc-parser/src/Ast/PhpDoc/TypeAliasTagValueNode.phpw �+gw 6&"!� 4 vendor/phpstan/phpdoc-parser/src/Printer/Printer.phpj� �+gj� i1�M� 5 vendor/phpstan/phpdoc-parser/src/Printer/DiffElem.php� �+g� �Z6� 3 vendor/phpstan/phpdoc-parser/src/Printer/Differ.php� �+g� R�ǀ� ; vendor/phpstan/phpdoc-parser/src/Parser/StringUnescaper.php>
�+g>
+t�9� 9 vendor/phpstan/phpdoc-parser/src/Parser/TokenIterator.php�# �+g�# G#�|� 6 vendor/phpstan/phpdoc-parser/src/Parser/TypeParser.php�� �+g�� ��Yդ ; vendor/phpstan/phpdoc-parser/src/Parser/ParserException.phpg �+gg u/g�� ; vendor/phpstan/phpdoc-parser/src/Parser/ConstExprParser.php<' �+g<' ��t� 8 vendor/phpstan/phpdoc-parser/src/Parser/PhpDocParser.phpY� �+gY� �=�ߤ 0 vendor/phpstan/phpdoc-parser/src/Lexer/Lexer.php� �+g�
�g�� " vendor/phpstan/php-8-stubs/LICENSE/ �+g/ #�Ȥ ( vendor/phpstan/php-8-stubs/stubs/LICENSE� �+g� ���V� 6 vendor/phpstan/php-8-stubs/stubs/Zend/Traversable.stubC �+gC �ł�� 8 vendor/phpstan/php-8-stubs/stubs/Zend/get_resources.stub? �+g? P2鮤 > vendor/phpstan/php-8-stubs/stubs/Zend/UnhandledMatchError.stub4 �+g4 -�A� 7 vendor/phpstan/php-8-stubs/stubs/Zend/class_exists.stubM �+gM �*CF� 2 vendor/phpstan/php-8-stubs/stubs/Zend/WeakMap.stubD �+gD -��� 4 vendor/phpstan/php-8-stubs/stubs/Zend/gc_enable.stub& �+g& V��/� 8 vendor/phpstan/php-8-stubs/stubs/Zend/method_exists.stubw �+gw _�ڟ� ; vendor/phpstan/php-8-stubs/stubs/Zend/extension_loaded.stub> �+g> 2[놤 4 vendor/phpstan/php-8-stubs/stubs/Zend/TypeError.stub* �+g* ��֤ = vendor/phpstan/php-8-stubs/stubs/Zend/get_included_files.stubG �+gG ��T � @ vendor/phpstan/php-8-stubs/stubs/Zend/set_exception_handler.stubg �+gg #\%� 1 vendor/phpstan/php-8-stubs/stubs/Zend/strlen.stub0 �+g0 <�� : vendor/phpstan/php-8-stubs/stubs/Zend/function_exists.stub< �+g< $m�� 7 vendor/phpstan/php-8-stubs/stubs/Zend/zend_version.stubM �+gM ��吤 4 vendor/phpstan/php-8-stubs/stubs/Zend/gc_status.stub> �+g> 0O�� 5 vendor/phpstan/php-8-stubs/stubs/Zend/Deprecated.stub_ �+g_ ��� 5 vendor/phpstan/php-8-stubs/stubs/Zend/BackedEnum.stub� �+g� H��+� : vendor/phpstan/php-8-stubs/stubs/Zend/ArithmeticError.stub0 �+g0 �ڏ� = vendor/phpstan/php-8-stubs/stubs/Zend/get_required_files.stubU �+gU Ln� 0 vendor/phpstan/php-8-stubs/stubs/Zend/Fiber.stub
�+g
��m� 4 vendor/phpstan/php-8-stubs/stubs/Zend/Countable.stub} �+g} �ҿ�� 8 vendor/phpstan/php-8-stubs/stubs/Zend/gc_mem_caches.stub0 �+g0 ���c� ; vendor/phpstan/php-8-stubs/stubs/Zend/interface_exists.stubU �+gU ��y� : vendor/phpstan/php-8-stubs/stubs/Zend/error_reporting.stubC �+gC AT�p� > vendor/phpstan/php-8-stubs/stubs/Zend/get_extension_funcs.stub_ �+g_ ��!S� 5 vendor/phpstan/php-8-stubs/stubs/Zend/FiberError.stubp �+gp �U3� B vendor/phpstan/php-8-stubs/stubs/Zend/SensitiveParameterValue.stub �+g CzO� 2 vendor/phpstan/php-8-stubs/stubs/Zend/Closure.stub� �+g� ɵ(� 5 vendor/phpstan/php-8-stubs/stubs/Zend/user_error.stub �+g <�Y� B vendor/phpstan/php-8-stubs/stubs/Zend/get_mangled_object_vars.stubC �+gC ��� < vendor/phpstan/php-8-stubs/stubs/Zend/get_class_methods.stubd �+gd �]S� ; vendor/phpstan/php-8-stubs/stubs/Zend/InternalIterator.stub� �+g� � }� A vendor/phpstan/php-8-stubs/stubs/Zend/AllowDynamicProperties.stub� �+g� ��]%� : vendor/phpstan/php-8-stubs/stubs/Zend/property_exists.stub{ �+g{ �y� 3 vendor/phpstan/php-8-stubs/stubs/Zend/UnitEnum.stuby �+gy wGuפ < vendor/phpstan/php-8-stubs/stubs/Zend/set_error_handler.stub~ �+g~ �S�Q� 5 vendor/phpstan/php-8-stubs/stubs/Zend/ValueError.stub+ �+g+ �&Ȳ� @ vendor/phpstan/php-8-stubs/stubs/Zend/debug_print_backtrace.stubR �+gR ���L� 8 vendor/phpstan/php-8-stubs/stubs/Zend/func_get_args.stub+ �+g+ ��6�� ; vendor/phpstan/php-8-stubs/stubs/Zend/get_defined_vars.stubE �+gE �[m� C vendor/phpstan/php-8-stubs/stubs/Zend/ClosedGeneratorException.stub= �+g= kQ�� 3 vendor/phpstan/php-8-stubs/stubs/Zend/Iterator.stub �+g ]燤 2 vendor/phpstan/php-8-stubs/stubs/Zend/strncmp.stubP �+gP �)�� @ vendor/phpstan/php-8-stubs/stubs/Zend/get_defined_functions.stubg �+gg ^&� 7 vendor/phpstan/php-8-stubs/stubs/Zend/CompileError.stub- �+g- � �� > vendor/phpstan/php-8-stubs/stubs/Zend/DivisionByZeroError.stub> �+g> �8դ : vendor/phpstan/php-8-stubs/stubs/Zend/get_resource_id.stubU �+gU �\ ߤ 3 vendor/phpstan/php-8-stubs/stubs/Zend/stdClass.stubJ �+gJ "� _� = vendor/phpstan/php-8-stubs/stubs/Zend/ArgumentCountError.stub7 �+g7 �f-� @ vendor/phpstan/php-8-stubs/stubs/Zend/restore_error_handler.stub �+g $P%)� < vendor/phpstan/php-8-stubs/stubs/Zend/IteratorAggregate.stub� �+g� ��-E� 7 vendor/phpstan/php-8-stubs/stubs/Zend/func_get_arg.stub7 �+g7 �� � 4 vendor/phpstan/php-8-stubs/stubs/Zend/Attribute.stub� �+g� �{�� D vendor/phpstan/php-8-stubs/stubs/Zend/restore_exception_handler.stub� �+g� ��Ҥ ; vendor/phpstan/php-8-stubs/stubs/Zend/get_parent_class.stub] �+g] ��� 6 vendor/phpstan/php-8-stubs/stubs/Zend/ArrayAccess.stub5 �+g5 &+��� 9 vendor/phpstan/php-8-stubs/stubs/Zend/is_subclass_of.stub� �+g� ��1� 8 vendor/phpstan/php-8-stubs/stubs/Zend/func_num_args.stub) �+g) O�Ph� ? vendor/phpstan/php-8-stubs/stubs/Zend/ReturnTypeWillChange.stubk �+gk �Y�� < vendor/phpstan/php-8-stubs/stubs/Zend/gc_collect_cycles.stub- �+g- �W� 5 vendor/phpstan/php-8-stubs/stubs/Zend/strcasecmp.stubF �+gF ���X� : vendor/phpstan/php-8-stubs/stubs/Zend/debug_backtrace.stub� �+g� w�|z� 8 vendor/phpstan/php-8-stubs/stubs/Zend/trigger_error.stub� �+g� ;��c� = vendor/phpstan/php-8-stubs/stubs/Zend/SensitiveParameter.stub� �+g� ��Q� 0 vendor/phpstan/php-8-stubs/stubs/Zend/Error.stub �+g �e��� 6 vendor/phpstan/php-8-stubs/stubs/Zend/class_alias.stub[ �+g[ ���Ĥ 4 vendor/phpstan/php-8-stubs/stubs/Zend/Exception.stubd �+gd �?[i� @ vendor/phpstan/php-8-stubs/stubs/Zend/get_defined_constants.stubb �+gb ��Vɤ ? vendor/phpstan/php-8-stubs/stubs/Zend/get_declared_classes.stubI �+gI �\��� 7 vendor/phpstan/php-8-stubs/stubs/Zend/trait_exists.stubM �+gM �ϐ8� 1 vendor/phpstan/php-8-stubs/stubs/Zend/strcmp.stubB �+gB ���0� 2 vendor/phpstan/php-8-stubs/stubs/Zend/defined.stub9 �+g9 n�*b� 5 vendor/phpstan/php-8-stubs/stubs/Zend/gc_enabled.stub' �+g' r}�� 5 vendor/phpstan/php-8-stubs/stubs/Zend/Stringable.stubJ �+gJ }ވ�� > vendor/phpstan/php-8-stubs/stubs/Zend/get_declared_traits.stubH �+gH {8� � 7 vendor/phpstan/php-8-stubs/stubs/Zend/Serializable.stub� �+g� ��i� @ vendor/phpstan/php-8-stubs/stubs/Zend/get_loaded_extensions.stubg �+gg �O6�� 3 vendor/phpstan/php-8-stubs/stubs/Zend/Override.stub� �+g� ~}�Ϥ 9 vendor/phpstan/php-8-stubs/stubs/Zend/zend_thread_id.stubI �+gI 0� o� : vendor/phpstan/php-8-stubs/stubs/Zend/get_object_vars.stub; �+g; 2�zc� 9 vendor/phpstan/php-8-stubs/stubs/Zend/ErrorException.stub �+g �
m� / vendor/phpstan/php-8-stubs/stubs/Zend/is_a.stub� �+g� ��ߤ 6 vendor/phpstan/php-8-stubs/stubs/Zend/enum_exists.stub\ �+g\ ԩ� � 4 vendor/phpstan/php-8-stubs/stubs/Zend/get_class.stub@ �+g@ A�p�� 8 vendor/phpstan/php-8-stubs/stubs/Zend/WeakReference.stub� �+g� qq�� 6 vendor/phpstan/php-8-stubs/stubs/Zend/strncasecmp.stubT �+gT *�b � 5 vendor/phpstan/php-8-stubs/stubs/Zend/gc_disable.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 (��ˤ D vendor/phpstan/php-8-stubs/stubs/Zend/RequestParseBodyException.stubO �+gO �Z4_� 4 vendor/phpstan/php-8-stubs/stubs/Zend/Generator.stub: �+g: ���� B vendor/phpstan/php-8-stubs/stubs/Zend/get_declared_interfaces.stubL �+gL u� 5� 1 vendor/phpstan/php-8-stubs/stubs/Zend/define.stub� �+g� ���n� ; vendor/phpstan/php-8-stubs/stubs/Zend/get_called_class.stub/ �+g/ �歉� 5 vendor/phpstan/php-8-stubs/stubs/Zend/ParseError.stub2 �+g2 �!� 9 vendor/phpstan/php-8-stubs/stubs/Zend/get_class_vars.stubP �+gP �u�� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getgrnam.stubU �+gU ��"y� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setpgid.stubW �+gW ��%N� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setgid.stub6 �+g6 h�t�� ; vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_uname.stubM �+gM "hr�� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getpgid.stubR �+gR �4e� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getlogin.stubO �+gO ^dH� ; vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_mknod.stub} �+g} 4 � = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_ttyname.stubu �+gu ���Q� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_ctermid.stubF �+gF QoM� = 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'� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_pathconf.stubm �+gm �Lb+� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getpwuid.stubU �+gU �;ߖ� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getuid.stub( �+g( ��0�� ? vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getgroups.stubg �+gg ��fK� 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_getegid.stub) �+g) �&D�� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getppid.stub) �+g) ���֤ < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_isatty.stube �+ge �N�� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setegid.stubK �+gK ��rK� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getpwnam.stubY �+gY k8�P� = 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_times.stubF �+gF �_�v� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getgid.stub/ �+g/ fI�E� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getsid.stubW �+gW �x�x� ? vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getrlimit.stub �+g +�� : vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_kill.stube �+ge ��n1� ; vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_errno.stubJ �+gJ ���Ǥ ? vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setrlimit.stubx �+gx hp � < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getcwd.stub1 �+g1 ��I[� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_access.stubP �+gP i �� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_seteuid.stubJ �+gJ wp�p� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_mkfifo.stub^ �+g^ y��� @ vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_initgroups.stubc �+gc �YW�� = vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_sysconf.stubM �+gM ��X� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getgrgid.stubV �+gV ��)�� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_setsid.stub; �+g; ��:|� > vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_strerror.stub< �+g< ��.�� < vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_getpid.stub( �+g( ���!� ? vendor/phpstan/php-8-stubs/stubs/ext/posix/posix_fpathconf.stub� �+g� �<�&� C vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_parameter_status.stub@ �+g@ ϧ�ݤ ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_num_rows.stub� �+g� }�h7� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_query_params.stub� �+g� ��F� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_close.stub� �+g� �Y%$� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_freeresult.stub �+g �ע� 7 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_exec.stubX �+gX ���R� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_numrows.stub� �+g� ��x� 6 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_jit.stub� �+g� f�� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_put_copy_end.stubp �+gp �ܳפ ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_connect_poll.stub� �+g� 34�� E vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result_error_field.stub �+g �~Z�� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_end_copy.stub� �+g� ng�� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_free_result.stub� �+g� ��D� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_get_result.stub� �+g� <�Y� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result_error.stub� �+g� �a�&� A vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_clientencoding.stub> �+g> �b�� < 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/PgSql/Connection.stubx �+gx Z@ 1� 8 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_close.stub) �+g) jI� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loreadall.stub� �+g� e��4� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_escape_string.stub2 �+g2 �I� B vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_change_password.stub� �+g� -9�[� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_is_null.stub� �+g� �6��� E vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_transaction_status.stub� �+g� 3�� � = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_getlastoid.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_pconnect.stub� �+g� B��Ĥ : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_copy_to.stub� �+g� �@�� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_meta_data.stub[ �+g[ ���� 7 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_ping.stub� �+g� �G� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_get_notify.stub: �+g: �%��� A vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_type_oid.stub� �+g� mRk� B vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_connection_busy.stub� �+g� �Q��� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_size.stub� �+g� ��¤ B vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_client_encoding.stub� �+g� 9�
� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldprtlen.stub� �+g� � ʤ > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldisnull.stub� �+g� �y� � : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_connect.stub �+g ��� 7 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_port.stub� �+g� �� Ƥ ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_prtlen.stub� �+g� �'4�� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_version.stub �+g � !�� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_delete.stub[ �+g[ H�_%� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_read_all.stub� �+g� pH�@� 8 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_trace.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� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_dbname.stub� �+g� �)^6� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_num.stub� �+g� � 8,� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loclose.stub� �+g� ę� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_object.stubi �+gi p�,ؤ O vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_set_error_context_visibility.stub� �+g� z�뇤 D vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_connection_status.stub� �+g� �y�;� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_insert.stubx �+gx �1�(� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldnum.stub �+g �ogǤ C vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_connection_reset.stub� �+g� �M�W� A vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_escape_literal.stub@ �+g@ ��yȤ @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_put_copy_data.stubg �+gg g��� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result_seek.stub� �+g� Ƽ�I� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldtype.stub �+g ��v�� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_options.stub� �+g� wfS� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_select.stub� �+g� ]KJ� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_table.stub �+g ��F� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_affected_rows.stub� �+g� �h+� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_cmdtuples.stub �+g ;� � 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_result.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_all.stub �+g �14�� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_update.stuby �+gy ����� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_export.stub� �+g� ���� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_locreate.stub� �+g� ��:"� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_consume_input.stub� �+g� �Ee� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_num_fields.stub� �+g� ��� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_field_type.stub� �+g� D1� � ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_escape_bytea.stub0 �+g0 Wm�I� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_numfields.stub �+g ��X� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_tell.stub� �+g� �N��� D vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_escape_identifier.stubF �+gF ;�l^� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_last_error.stub� �+g� �A�D� = 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 `�
� 8 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_flush.stub� �+g� '[� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_convert.stube �+ge %˯ � 6 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_tty.stub� �+g� M �ݤ E vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result_memory_size.stuby �+gy ��ڤ 8 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_query.stubC �+gC >�[� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_assoc.stub) �+g) Dl灤 ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_send_execute.stub �+g ��R� H vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_set_chunked_rows_size.stub� �+g� j/� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_cancel_query.stub� �+g� )�2T� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_untrace.stub/ �+g/ � D vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_setclientencoding.stub� �+g� |��� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loexport.stub �+g <��?� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loread.stub" �+g" B� p� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_create.stubh �+gh 8�.� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldsize.stub �+g 8�bx� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_truncate.stub� �+g� �@I�� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_errormessage.stub0 �+g0 �z� 7 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_host.stub� �+g� ݤpm� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_result.stub �+g ��.� 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_execute.stub� �+g� ^w�� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_seek.stub� �+g� W�� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_socket_poll.stub� �+g� @�{�� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_last_notice.stub �+g �WnX� ? vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_send_prepare.stub �+g \*��� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_open.stub� �+g� H�T� 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_last_oid.stub� �+g� S��b� ; vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lounlink.stubw �+gw
�
� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_row.stubS �+gS V�n�� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lowrite.stub> �+g> ITe� @ vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_result_status.stub
�+g
4J� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_loopen.stub� �+g� �o�<� = vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_send_query.stub� �+g� ��kl� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fieldname.stub �+g ���t� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_unlink.stub- �+g- [VNg� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_copy_from.stubd �+gd d�Sf� < vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_import.stub� �+g� ̮�� : vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_lo_read.stub� �+g� dO
�� 9 vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_socket.stub� �+g� �Г�� > vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_fetch_array.stubY �+gY �myƤ F vendor/phpstan/php-8-stubs/stubs/ext/pgsql/pg_set_error_verbosity.stub+ �+g+ �#��� M vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionEnumBackedCase.stub� �+g� ^��h� ? vendor/phpstan/php-8-stubs/stubs/ext/reflection/Reflection.stub� �+g� ����� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionReference.stubb �+gb ^��8� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionException.stubZ �+gZ �&��� 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��� E vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionMethod.stub�
�+g�
�6��� C vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionType.stub� �+g� 9� O vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionIntersectionType.stub� �+g� �o�Q� D vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionClass.stubG$ �+gG$ �Ҹդ E vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionObject.stubw �+gw ���� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionAttribute.stub� �+g� :�� L vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionZendExtension.stub� �+g� ��� > vendor/phpstan/php-8-stubs/stubs/ext/reflection/Reflector.stub3 �+g3 ����� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionNamedType.stub �+g L��Q� D vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionFiber.stub� �+g� ��� 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��� G vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionConstant.stub �+g �$K� G vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionProperty.stub" �+g" 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�%� G vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionFunction.stub� �+g� D��n� H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionParameter.stub �+g �Q*6� E vendor/phpstan/php-8-stubs/stubs/ext/reflection/PropertyHookType.stubg �+gg �`פ H vendor/phpstan/php-8-stubs/stubs/ext/reflection/ReflectionUnionType.stubo �+go ���� 7 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocilogon.stub� �+g� {�c2� 5 vendor/phpstan/php-8-stubs/stubs/ext/oci8/OCILob.stub<
�+g<
��Ĥ = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_size.stubp �+gp H3�Τ 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicancel.stubz �+gz V_��� D vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_assign.stubZ �+gZ ���� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifetchinto.stub� �+g� %��� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumnsize.stub� �+g� 0�� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch_assoc.stub_ �+g_ ��i�� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_free_cursor.stuby �+gy s��Q� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_parse.stuby �+gy ���ä ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociserverversion.stub� �+g� ��h� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_password_change.stub� �+g� �P ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_truncate.stubJ �+gJ �� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_statement_type.stubc �+gc i�%H� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_size.stubO �+gO X���� : vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_connect.stub� �+g� b]m� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocistatementtype.stub� �+g� a�Å� I vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_element_get.stubp �+gp �� � = vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocisetprefetch.stub� �+g� �9�� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_pconnect.stub� �+g� ��+v� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumnscale.stub� �+g� E�F�� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch_array.stub� �+g� �Q�� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicollappend.stub� �+g� 15��� 7 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocierror.stub� �+g� ��__� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumnisnull.stub� �+g� �ׄ� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_trim.stubT �+gT +�S� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocinewdescriptor.stub� �+g� �ʆH� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_write.stub^ �+g^ 8k�� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_rewind.stub7 �+g7 T6R�� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifreecursor.stub� �+g� `Y�'� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocisetbufferinglob.stubG �+gG PD0Ф < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocibindbyname.stub� �+g� �ܸt� ; 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/ocigetbufferinglob.stub; �+g; �d�Ȥ : vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocirollback.stub� �+g� � ��� C vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_call_timeout.stubm �+gm ��2� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociloadlob.stubi �+gi #e�=� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_num_fields.stubV �+gV �Tw�� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_new_descriptor.stub| �+g| C"� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocilogoff.stub| �+g| Ĭ0y� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicollgetelem.stub� �+g� �"�� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocinumcols.stub~ �+g~ NY��� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociwritelobtofile.stub� �+g� �ѯ� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_new_cursor.stubq �+gq �
�ʤ : vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_execute.stubw �+gw �Hj�� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumntype.stub� �+g� �F
�� : vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_eof.stub4 �+g4 D,�n� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_server_version.stube �+ge ����� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch.stubR �+gR �&�դ 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_close.stubU �+gU '^N� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_define_by_name.stub� �+g� ^�٬� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_free_collection.stubJ �+gJ �M|y� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_save.stubT �+gT �yD*� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_free_descriptor.stub< �+g< # �� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_client_version.stub1 �+g1 �� C vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_db_operation.stubo �+go ,}b� C vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_prefetch_lob.stub� �+g� �� <� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicollassignelem.stub� �+g�
KV� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch_object.stub� �+g� VLWͤ ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_size.stub: �+g: !0:� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumnname.stub� �+g� ���:� D vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_append.stub[ �+g[ ���� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_copy.stubX �+gX ۅњ� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocisavelobfile.stuby �+gy S�p� > vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_edition.stub; �+g; ?r��� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_collection_max.stubN �+gN p��o� = 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/ocinewcollection.stub� �+g� ���� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_prefetch.stubd �+gd ק� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_erase.stube �+ge ��� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_result.stubh �+gh G�%Ȥ ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifreestatement.stub� �+g� e� �� H vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_register_taf_callback.stuby �+gy �N
�� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifetchstatement.stub� �+g� �ex� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocinewcursor.stub� �+g� t�գ� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_error.stub� �+g� �Y��� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_name.stubs �+gs ��%ɤ J vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_unregister_taf_callback.stubf �+gf ��Ƥ > vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocidefinebyname.stub� �+g� ���� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifreecollection.stub} �+g} ~�a� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_module_name.stubl �+gl ��og� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_tell.stub: �+g: y�K� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociplogon.stub� �+g� ���<� : vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifreedesc.stubi �+gi tD(� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicommit.stub| �+g| ���Ҥ < vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_fetch_row.stub] �+g] Һ�ޤ A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_new_collection.stub� �+g� �4�
� : vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicollsize.stub| �+g| ���� = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_action.stubi �+gi Dà֤ > 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/oci_lob_read.stubJ �+gJ ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicollmax.stubz �+gz ���,� 7 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociparse.stub� �+g� ��W[� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_precision.stubu �+gu � ڙ� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocipasswordchange.stub� �+g� ��� 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociresult.stub� �+g� �M�;� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_flush.stubE �+gE ��ţ� B vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_set_client_info.stubw �+gw ��J8� @ vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_is_null.stubn �+gn ��J�� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumnprecision.stub� �+g� �/m� ; vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_load.stub= �+g= ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_cancel.stubS �+gS ���� 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_rollback.stubW �+gW UD�]� E vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_bind_array_by_name.stub� �+g� �^$� : vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolltrim.stub� �+g� ���� < vendor/phpstan/php-8-stubs/stubs/ext/oci8/OCICollection.stub �+g �qX]� A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_type_raw.stubt �+gt +��k� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ociexecute.stub� �+g� u� I vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_get_implicit_resultset.stub{ �+g{ �� � A vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_free_statement.stub[ �+g[ +�6+� 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_append.stubE �+gE �Ғ<� 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_commit.stubU �+gU ��&Ф = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_lob_export.stubs �+gs �H>�� ? vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocicolumntyperaw.stub� �+g� �Huä = vendor/phpstan/php-8-stubs/stubs/ext/oci8/oci_field_type.stubw �+gw ��G � : vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocirowcount.stub� �+g� ԧ��� > 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ݤ 8 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocinlogon.stub� �+g� d \� 7 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocifetch.stubx �+gx � � 9 vendor/phpstan/php-8-stubs/stubs/ext/oci8/ocisavelob.stub� �+g� %y<� = vendor/phpstan/php-8-stubs/stubs/ext/random/random_bytes.stubZ �+gZ T�P � ; 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!��� 8 vendor/phpstan/php-8-stubs/stubs/ext/random/mt_rand.stubZ �+gZ ݐ�^� G vendor/phpstan/php-8-stubs/stubs/ext/random/Random/RandomException.stubv �+gv a�� 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� C vendor/phpstan/php-8-stubs/stubs/ext/random/Random/RandomError.stubn �+gn �wY� Q vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Engine/Xoshiro256StarStar.stub" �+g" n !� E vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Engine/Secure.stub �+g ǥk� F vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Engine/Mt19937.stub� �+g� �� R vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Engine/PcgOneseq128XslRr64.stub� �+g� �|l!� O vendor/phpstan/php-8-stubs/stubs/ext/random/Random/BrokenRandomEngineError.stub� �+g� ��i� > vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Engine.stubh �+gh �*� B vendor/phpstan/php-8-stubs/stubs/ext/random/Random/Randomizer.stub� �+g� �e]� ; vendor/phpstan/php-8-stubs/stubs/ext/random/getrandmax.stubS �+gS �~Rw� 9 vendor/phpstan/php-8-stubs/stubs/ext/random/mt_srand.stub� �+g� d���� 6 vendor/phpstan/php-8-stubs/stubs/ext/random/srand.stub� �+g� �6x<� > vendor/phpstan/php-8-stubs/stubs/ext/random/mt_getrandmax.stub: �+g: ��g� : vendor/phpstan/php-8-stubs/stubs/ext/random/lcg_value.stub8 �+g8 ���� ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_space.stub3 �+g3 ��6 � ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_upper.stub3 �+g3 �mM� ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_graph.stub3 �+g3 _�r�� ; 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_punct.stub3 �+g3 !��^� ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_lower.stub3 �+g3 ���̤ < vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_xdigit.stub4 �+g4 �u�� ; vendor/phpstan/php-8-stubs/stubs/ext/ctype/ctype_digit.stub3 �+g3 ��簤 ; 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� B vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/SysvMessageQueue.stubJ �+gJ [�6M� ? vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/msg_get_queue.stub^ �+g^ �+u.� 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 ��~�� : vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/msg_send.stub� �+g� ,���� = 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 ޕ�>� B vendor/phpstan/php-8-stubs/stubs/ext/sysvmsg/msg_remove_queue.stubE �+gE ���� < 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��פ ; vendor/phpstan/php-8-stubs/stubs/ext/phar/PharFileInfo.stub� �+g� !yi� 7 vendor/phpstan/php-8-stubs/stubs/ext/phar/PharData.stub.( �+g.( 2�T/� = vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_close.stub� �+g� ��ޤ B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_close.stub� �+g� �x� F vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_data_seek.stubV �+gV Vq�T� < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_kill.stubG �+gG /BI� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_next_result.stub= �+g= �Ol�� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_lengths.stube �+ge �{ܧ� 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_real_query.stubK �+gK ��l� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_server_info.stubC �+gC �6 � C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_thread_safe.stub/ �+g/ �G�Ĥ G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_error_list.stubb �+gb Ig�� I vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_store_result.stubL �+gL 繽i� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_array.stub� �+g� ��؇� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_insert_id.stubA �+gA ƙs � D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_object.stub� �+g� 'U� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_init.stubI �+gI -1*�� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_affected_rows.stubE �+gE ��� J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_server_version.stubC �+gC "�� J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_client_version.stub5 �+g5 � DC� 7 vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli.stub2 �+g2 �a�q� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_column.stub �+g ��^E� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_escape_string.stuby �+gy ��0�� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_warning_count.stub> �+g> Y!�%� > vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_commit.stub^ �+g^ J���� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_connect_errno.stub0 �+g0 S�>�� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_data_seek.stubP �+gP �}�K� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_param_count.stubJ �+gJ ܌�F� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_charset.stubG �+gG ��wޤ @ vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_sqlstate.stub< �+g< A��4� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_warning.stub� �+g� @`�<� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_sqlstate.stubJ �+gJ �}�K� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_connect.stub� �+g� �p�� J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_real_escape_string.stubV �+gV <1�� I vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_release_savepoint.stubX �+gX ��֮� I vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_begin_transaction.stubi �+gi �w�Ф J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_field_direct.stub` �+g` ��g`� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_bind_result.stub\ �+g\ ��f[� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_real_connect.stub� �+g� o�� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_field_tell.stubC �+gC ��`� < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_ping.stub6 �+g6 DF�v� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_prepare.stubV �+gV ��`�� > vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_result.stub% �+g% X� o� < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt.stub8
�+g8
r�d� @ vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_num_rows.stubH �+gH �P��� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_change_user.stubt �+gt <C�<� < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_info.stub9 �+g9 nm� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_free_result.stubE �+gE @� �� L vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_result_metadata.stub_ �+g_ 퀞٤ C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_multi_query.stubL �+gL R�� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_use_result.stubL �+gL �˞
� J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_character_set_name.stubF �+gF �6ě� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_get_result.stubz �+gz Z�}�� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_sql_exception.stub� �+g� �.�� > vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_driver.stubG �+gG �Ai� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_execute.stub� �+g� ��=c� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_links_stats.stubK �+gK s@�-� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_error.stubG �+gG }�*�� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_ssl_set.stubY �+gY �OY�� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_attr_get.stubW �+gW �}>� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_host_info.stubA �+gA ���`� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_dump_debug_info.stubA �+gA +�UG� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_num_fields.stubC �+gC s�>� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_warnings.stubO �+gO ��|� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_field.stubM �+gM � щ� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_row.stubf �+gf �D�g� = vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_query.stub} �+g} �v�� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_reap_async_query.stubq �+gq �K� � F vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_insert_id.stubO �+gO ��9� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_autocommit.stubJ �+gJ >6�� 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_assoc.stubh �+gh [k��� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_execute.stub� �+g� &�2Ԥ 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_set_opt.stub� �+g� ��=� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_set_charset.stubN �+gN =�'6� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_error_list.stubT �+gT �6GQ� G vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_bind_param.stubj �+gj uX̬� J vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_affected_rows.stubS �+gS ���M� 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_options.stubn �+gn ���� = vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_error.stub9 �+g9 H`�� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_refresh.stubE �+gE ��٤ B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_reset.stubE �+gE o��Ϥ < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stat.stub> �+g> ۑ� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_savepoint.stubI �+gI ��� @ vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_rollback.stub` �+g` ��� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_select_db.stubM �+gM �[� = vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_debug.stub� �+g� +�� 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_more_results.stub> �+g> ��y� > vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_report.stub� �+g� pͦ�� ? vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_prepare.stub] �+g] ��ڤ B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_errno.stubD �+gD �2v6� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_connect_error.stub4 �+g4 x� I vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_get_warnings.stubd �+gd \�'� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_client_stats.stubL �+gL ���
� A vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_thread_id.stub: �+g: ��YX� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_fetch_fields.stub^ �+g^ ���� < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_init.stub1 �+g1 xfέ� H vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_free_result.stubK �+gK ��,� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_num_rows.stubU �+gU ��I�� < vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_poll.stub� �+g� ��e�� 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_execute_query.stub� �+g� (i�ۤ L vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_get_connection_stats.stub~ �+g~ v� C vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_field_count.stub< �+g< �FGV� E vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_stmt_attr_set.stubd �+gd ��[� D vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_store_result.stub] �+g] �q��� = vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_errno.stub6 �+g6 ��깤 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_all.stub� �+g� JD{E� B vendor/phpstan/php-8-stubs/stubs/ext/mysqli/mysqli_field_seek.stub� �+g� ��l� 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcadd.stubt �+gt ˯� � 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcmod.stubR �+gR 5��P� 8 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcfloor.stubU �+gU ��� 7 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bccomp.stubP �+gP t��
� 7 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcceil.stubT �+gT ��� � 9 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcdivmod.stub� �+g� �c78� 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcsub.stubR �+gR rjD� 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcpow.stubU �+gU z�ä 9 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcpowmod.stubi �+gi "�?5� 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/bcdiv.stubR �+gR �
�� 8 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcround.stub� �+g� ���� > vendor/phpstan/php-8-stubs/stubs/ext/bcmath/BcMath/Number.stub6 �+g6 ��]�� 6 vendor/phpstan/php-8-stubs/stubs/ext/bcmath/bcmul.stubR �+gR f=��� = vendor/phpstan/php-8-stubs/stubs/ext/xmlreader/XMLReader.stub�' �+g�' t�=y� > vendor/phpstan/php-8-stubs/stubs/ext/json/json_last_error.stub+ �+g+ ߏ,Ӥ < vendor/phpstan/php-8-stubs/stubs/ext/json/json_validate.stubi �+gi ���� : vendor/phpstan/php-8-stubs/stubs/ext/json/json_encode.stub� �+g� �x褤 ? vendor/phpstan/php-8-stubs/stubs/ext/json/JsonSerializable.stub� �+g� a�H�� : vendor/phpstan/php-8-stubs/stubs/ext/json/json_decode.stubr �+gr h)� < vendor/phpstan/php-8-stubs/stubs/ext/json/JsonException.stub2 �+g2 P�'� B vendor/phpstan/php-8-stubs/stubs/ext/json/json_last_error_msg.stub2 �+g2 �� � > 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+� I vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_write_history.stubK �+gK @�bR� ; vendor/phpstan/php-8-stubs/stubs/ext/readline/readline.stube �+ge %��ؤ @ vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_info.stub� �+g� G��� H vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_list_history.stubc �+gc �%� N vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_callback_read_char.stub8 �+g8 ~qe� G vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_add_history.stub? �+g? fՁ�� G vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_on_new_line.stubI �+gI t�ȸ� H vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_read_history.stubQ �+gQ $7�Ф T vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_callback_handler_install.stub �+g ��7#� I vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_clear_history.stub3 �+g3 $� S vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_callback_handler_remove.stub= �+g= ���y� E vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_redisplay.stub/ �+g/ ��''� O vendor/phpstan/php-8-stubs/stubs/ext/readline/readline_completion_function.stubK �+gK qR�� ; vendor/phpstan/php-8-stubs/stubs/ext/pdo_odbc/Pdo/Odbc.stubB �+gB � j�� < vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_name.stubr �+gr ��ES� < vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_open.stub� �+g� �Sy� = vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_close.stubk �+gk j��5� < vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_read.stub� �+g� �/��� 8 vendor/phpstan/php-8-stubs/stubs/ext/zip/ZipArchive.stub� �+g� �� @ vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_filesize.stubs �+gs y�r� 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 |�䆤 6 vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_open.stub� �+g� �C�>� 7 vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_close.stubY �+gY b��$� F vendor/phpstan/php-8-stubs/stubs/ext/zip/zip_entry_compressedsize.stuby �+gy �N� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorstotal.stub; �+g; ��Fp� : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetstyle.stubG �+gG �]��� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagedashedline.stubk �+gk V�?� 3 vendor/phpstan/php-8-stubs/stubs/ext/gd/GdFont.stubb �+gb ��+<� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegd2.stub �+g ��fa� > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilltoborder.stubl �+gl �yb� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorallocate.stubd �+gd �պ�� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefrombmp.stub\ �+g\ �D�E� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromgd2.stubI �+gI ���.� A vendor/phpstan/php-8-stubs/stubs/ext/gd/imageaffinematrixget.stub� �+g� �{9� 4 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegd.stubI �+gI �9�v� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagerotate.stubU �+gU �N�v� : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecropauto.stub� �+g� ��-� 4 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesx.stub2 �+g2 (QhŤ 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagewbmp.stub� �+g� U?��� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecopyresampled.stub� �+g� u8�� D vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorallocatealpha.stubu �+gu �X�� 4 vendor/phpstan/php-8-stubs/stubs/ext/gd/gd_info.stub< �+g< ՙG�� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageflip.stub@ �+g@ k-Z � < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorexact.stub[ �+g[ ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetclip.stub\ �+g\ ��� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromgif.stubI �+gI i�k7� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefttext.stub� �+g� �^ � 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegetclip.stubP �+gP r�Bդ 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreate.stubI �+gI �$��� A vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorexactalpha.stubl �+gl ����� C vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorresolvealpha.stubn �+gn 1�hV� C vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromgd2part.stubv �+gv H��� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imagerectangle.stubj �+gj ~C7� @ vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromwebp.stube �+ge Y �� : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagestringup.stub �+g E��� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageline.stube �+ge ���x� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagealphablending.stubL �+gL �c�� : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorset.stub �+g \y�.� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imageresolution.stub� �+g� )�� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefrompng.stubc �+gc ���� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imagepalettecopy.stubI �+gI ��\4� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefontwidth.stub� �+g� �d~Ҥ A vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatetruecolor.stubR �+gR ��ޤ > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegammacorrect.stubf �+gf �t�� 7 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagetypes.stub& �+g& o �J� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromxbm.stubP �+gP ��W� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilledpolygon.stub{ �+g{ )��E� A vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilledrectangle.stubp �+gp Vd�0� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imageopenpolygon.stuby �+gy ޅL�� : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetpixel.stubU �+gU BiW � 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagettfbbox.stub� �+g� �dQ� 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagedestroy.stub? �+g? ݪ�� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilledarc.stub� �+g� � �/� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagepng.stub� �+g� XGC � A vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorclosesthwb.stub` �+g` -�خ� @ vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorsforindex.stubc �+gc ��O?� A vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolordeallocate.stubL �+gL �Gڤ : vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetbrush.stubJ �+gJ s>� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecopy.stub� �+g� ���o� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageavif.stub� �+g� J(a�� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecrop.stubQ �+gQ � �� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecopymerge.stub� �+g� 2�\>� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagejpeg.stub� �+g� Qf��� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagearc.stub� �+g� ]s�F� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageaffine.stube �+ge ��
� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagechar.stub� �+g� �څ� 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagettftext.stub� �+g� �*j� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagestring.stub� �+g� �@� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromtga.stubc �+gc 6>�&� D vendor/phpstan/php-8-stubs/stubs/ext/gd/imagetruecolortopalette.stubb �+gb ��� @ vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromavif.stub� �+g� �K��� 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorat.stubM �+gM F&��� > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorclosest.stub] �+g] x�p � ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imageantialias.stubH �+gH YT�� ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesavealpha.stubH �+gH F�[�� B vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetinterpolation.stubc �+gc $m��� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegrabwindow.stubm �+gm p���� D vendor/phpstan/php-8-stubs/stubs/ext/gd/imagepalettetotruecolor.stubC �+gC �I� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecopyresized.stub� �+g� �bKܤ > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorresolve.stub] �+g] ��#ޤ ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilledellipse.stub� �+g� �7!ܤ : vendor/phpstan/php-8-stubs/stubs/ext/gd/imageloadfont.stub� �+g� "t禤 > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesetthickness.stubM �+gM �݉� > vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromgd.stubH �+gH ��7r� ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecopymergegray.stub� �+g� 0cX� C vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolorclosestalpha.stubn �+gn P��� B vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromstring.stubH �+gH ��c�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagebmp.stub� �+g� x��+� 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagewebp.stub� �+g� %�b� B vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegetinterpolation.stub@ �+g@ �W"u� 4 vendor/phpstan/php-8-stubs/stubs/ext/gd/GdImage.stubA �+gA _n ¤ 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesettile.stubH �+gH ���̤ 7 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagescale.stub~ �+g~ F2|>� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefilter.stub~ �+g~ ��|&� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagexbm.stubm �+gm �/n�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegif.stubk �+gk � B vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolortransparent.stubT �+gT ���Ϥ 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecharup.stub� �+g� ���ڤ ; vendor/phpstan/php-8-stubs/stubs/ext/gd/imageinterlace.stubP �+gP ;�� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imagelayereffect.stubI �+gI f^�� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefontheight.stub� �+g� PjKK� 8 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageftbbox.stub� �+g� ���M� @ vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromwbmp.stubQ �+gQ �
� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imageconvolution.stubj �+gj $��ݤ 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagepolygon.stubu �+gu �C��� D vendor/phpstan/php-8-stubs/stubs/ext/gd/imageaffinematrixconcat.stubp �+gp �I.4� @ vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromjpeg.stub] �+g] �x�� = vendor/phpstan/php-8-stubs/stubs/ext/gd/imageistruecolor.stub< �+g<
�@f� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagegrabscreen.stub6 �+g6 c�O� < vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecolormatch.stubN �+gN �}LǤ ? vendor/phpstan/php-8-stubs/stubs/ext/gd/imagecreatefromxpm.stub\ �+g\ �:q�� 9 vendor/phpstan/php-8-stubs/stubs/ext/gd/imageellipse.stub{ �+g{ ��:� 4 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagesy.stub2 �+g2 iJ䫤 6 vendor/phpstan/php-8-stubs/stubs/ext/gd/imagefill.stubQ �+gQ d�� � F vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_compile_file.stubA �+gA :ÑҤ G vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_jit_blacklist.stubT �+gT �ֹ� ? vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_reset.stubL �+gL u���� J vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_is_script_cached.stubE �+gE d�%� D vendor/phpstan/php-8-stubs/stubs/ext/opcache/opcache_invalidate.stubT �+gT �1� 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"� ; vendor/phpstan/php-8-stubs/stubs/ext/xsl/XSLTProcessor.stub� �+g� _Y�� ? vendor/phpstan/php-8-stubs/stubs/ext/filter/filter_has_var.stubn �+gn ��u`� ; vendor/phpstan/php-8-stubs/stubs/ext/filter/filter_var.stubj �+gj �c��� C vendor/phpstan/php-8-stubs/stubs/ext/filter/filter_input_array.stub� �+g� K�x� 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� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_derive.stub �+g I�G� R vendor/phpstan/php-8-stubs/stubs/ext/openssl/OpenSSLCertificateSigningRequest.stub8 �+g8 w�mW� K vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_checkpurpose.stub� �+g� ����� D vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_parse.stub� �+g� �%� � > vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_open.stub� �+g� 1̽t� F vendor/phpstan/php-8-stubs/stubs/ext/openssl/OpenSSLAsymmetricKey.stub, �+g, {Ք�� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_export.stub� �+g� �Oky� @ vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_verify.stub� �+g� 8o� L vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_get_public_key.stub� �+g� O�XϤ I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_private_encrypt.stub� �+g� �Z� J vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_get_private.stub� �+g� ��*o� H vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_public_encrypt.stub� �+g� ���'� A vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_encrypt.stub� �+g� l�S8� M vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_random_pseudo_bytes.stub �+g %Kp%� H vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_public_decrypt.stub� �+g� ���� I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_private_decrypt.stub� �+g� �{�� D vendor/phpstan/php-8-stubs/stubs/ext/openssl/OpenSSLCertificate.stubL �+gL LYZ�� 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_free_key.stubz �+gz \҅� I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_password_verify.stub� �+g� B;�(� O vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs12_export_to_file.stub �+g 4�b�� H vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_dh_compute_key.stubq �+gq 6�� > vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_seal.stub� �+g� ��K�� C vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_free.stuba �+ga .MIԤ J vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_get_details.stubm �+gm D��� F vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs7_verify.stub �+g ��դ J vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_fingerprint.stub� �+g� A�� B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_new.stubZ �+gZ N�� M vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_export_to_file.stub� �+g� C
m� K vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cipher_key_length.stub_ �+g_ H�� I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_curve_names.stubj �+gj �⡤ E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_spki_verify.stub< �+g< �N� C vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_read.stubj �+gj b({e� I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_get_public.stub� �+g� ��`� L vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_cipher_methods.stubd �+gd ��$� B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cms_read.stubu �+gu (��o� 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� O vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_spki_export_challenge.stubN �+gN ���� @ vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_digest.stubq �+gq ~Ւ�� M vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_export_to_file.stub� �+g� �w�#� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs12_read.stub� �+g� ��� C vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkey_free.stub[ �+g[ [j��� @ vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pbkdf2.stub� �+g� s�� G vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs12_export.stub �+g =I�W� G vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_password_hash.stub� �+g� �lz3� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cms_encrypt.stubV �+gV ��0Τ > vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_sign.stub� �+g� ���Ȥ G vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs7_encrypt.stub
�+g
h+ !� A vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_decrypt.stub~ �+g~ 8 � J vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cipher_iv_length.stubM �+gM ~� E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_export.stub� �+g� [�� G vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_publickey.stub� �+g� ��U� A vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_new.stub� �+g� a^A�� L vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_cert_locations.stubO �+gO �?� 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 ]��Ȥ B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_spki_new.stub� �+g� ].�� B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_sign.stub� �+g� ���ä E vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_verify.stub� �+g� kM� H vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_md_methods.stub` �+g`
I��� I vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_get_subject.stub� �+g� +�s� P vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_x509_check_private_key.stub� �+g� L�� F vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_error_string.stub9 �+g9 7�G1� D vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_pkcs7_sign.stubD �+gD �%�� D vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_csr_export.stub� �+g� �i��� H vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_get_privatekey.stub� �+g� Nd��� B vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cms_sign.stub] �+g] Y�h8� D vendor/phpstan/php-8-stubs/stubs/ext/openssl/openssl_cms_verify.stub( �+g( ���ۤ ; 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_size.stub3 �+g3 ���� : vendor/phpstan/php-8-stubs/stubs/ext/shmop/shmop_open.stubb �+gb ��:� 5 vendor/phpstan/php-8-stubs/stubs/ext/shmop/Shmop.stub? �+g? �f+� : vendor/phpstan/php-8-stubs/stubs/ext/shmop/shmop_read.stubN �+gN �R Τ ; vendor/phpstan/php-8-stubs/stubs/ext/shmop/shmop_close.stubH �+gH 1e�%� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_mkdir.stub� �+g� Ե1� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_mlsd.stub �+g ٬�Ԥ 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_pasv.stub� �+g� a��~� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_fput.stubm �+gm 3y� � 8 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nb_get.stubU �+gU ����� 8 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_delete.stub� �+g� �_9� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_close.stub� �+g� ƅ�V� = vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_ssl_connect.stub* �+g* kv��� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_login.stub� �+g� ��B"� 5 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_raw.stub� �+g� �.Z�� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_site.stub� �+g� �� 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 �� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_chdir.stub� �+g� 0 e�� = vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nb_continue.stub� �+g� c�
Ǥ < vendor/phpstan/php-8-stubs/stubs/ext/ftp/FTP/Connection.stubv �+gv ;p��� < vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_get_option.stub� �+g� W�U!� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_fget.stubm �+gm �~F� 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_exec.stub� �+g� �XB`� 8 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_rename.stub� �+g� �^❤ 6 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_size.stub� �+g� 'E� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_rmdir.stub� �+g� ��� 5 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_pwd.stub� �+g� �vEF� 9 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_systype.stub� �+g� ���n� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_chmod.stub� �+g� o��G� 8 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nb_put.stub[ �+g[ dC#T� 9 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_connect.stub �+g ` �q� 9 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_rawlist.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_cdup.stub� �+g� "���� 8 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_append.stub/ �+g/ ��w� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_alloc.stub �+g *��� 7 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nlist.stub
�+g
��]� 5 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_get.stubK �+gK �ŧ� < vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_set_option.stub �+g �^�e� 9 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_nb_fget.stubq �+gq �BE� 5 vendor/phpstan/php-8-stubs/stubs/ext/ftp/ftp_put.stubK �+gK &�ۤ < vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_substr.stub{ �+g{ '��6� A vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_mime_encode.stubr �+gr x� �� 5 vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv.stubd �+gd �zޱ� = vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_strrpos.stubi �+gi a2� B vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_get_encoding.stubh �+gh ���W� < vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_strlen.stubx �+gx ���� < vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_strpos.stuby �+gy �2h*� I vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_mime_decode_headers.stub� �+g� z\믤 A vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_mime_decode.stubm �+gm ��:� B vendor/phpstan/php-8-stubs/stubs/ext/iconv/iconv_set_encoding.stubM �+gM �۱�� > vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/finfo_close.stub� �+g� ޠ�8� = vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/finfo_open.stub �+g <*�� = vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/finfo_file.stub� �+g� �vz�� 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� D vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/mime_content_type.stubk �+gk �}.� B vendor/phpstan/php-8-stubs/stubs/ext/fileinfo/finfo_set_flags.stub �+g +�6%� = vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_sasl_bind.stub! �+g! �й� A vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_count_entries.stub� �+g� �7D�� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_del_ext.stub9 �+g9 ���� ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_connect.stub� �+g� ��Ť ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_exop_whoami.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_free_result.stub� �+g� �M�[� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_search.stubp �+gp Z[Hդ 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_exop_refresh.stub) �+g) ����� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_rename_ext.stub� �+g� 4le�� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_t61_to_8859.stubY �+gY � � > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_next_entry.stub �+g $�9�� C vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_first_reference.stub �+g �3>�� 9 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_errno.stub� �+g� ���;� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_add_ext.stub9 �+g9 �}� C vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_first_attribute.stub �+g ��6 � 8 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_list.stubl �+gl e�%�� 8 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_bind.stub� �+g� ʸ� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_set_option.stub1 �+g1 h6M�� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/LDAP/Result.stubs �+gs �A7=� > 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_dn2ufn.stub: �+g: b��Ť ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_exop_passwd.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_parse_exop.stub) �+g) a"�� C vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_replace_ext.stubA �+gA �/ � ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_get_entries.stub> �+g> �(|� = vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_start_tls.stub� �+g� �g� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_modify.stubG �+gG ҙ8�� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_get_values.stub� �+g� D�`� = vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_exop_sync.stubL �+gL )�/
� 9 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_error.stub� �+g� lM�� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_rename.stub� �+g� ��;� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_first_entry.stub �+g �S� � : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_unbind.stub� �+g� s�ɤ ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_del.stub �+g �6�L� ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_err2str.stub5 �+g5 :3ސ� 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_bind_ext.stub[ �+g[ �̖�� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_get_option.stub1 �+g1 � �0� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_explode_dn.stubf �+gf �&"� C vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_parse_reference.stub� �+g� H�Τ D vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_count_references.stub� �+g� R'� 8 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_read.stubz �+gz �~3� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_delete.stub� �+g� p Q�� B vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_next_reference.stub �+g �my� > vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_delete_ext.stub �+g �~�w� ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_add.stub �+g oQv � ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_add_ext.stub1 �+g1 )��f� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_mod_replace.stub �+g =q㧤 ; vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_compare.stub; �+g; �|?٤ : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_escape.stubc �+gc D[Gt� @ vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_parse_result.stub �+g X�C�� 8 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_exop.stub� �+g� �ҝT� B vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_next_attribute.stub �+g 75\<� B vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_connect_wallet.stub� �+g� �5D� @ vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_modify_batch.stub/ �+g/ g � 7 vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_add.stub �+g �b�S� ? vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_8859_to_t61.stubB �+gB �-A� : vendor/phpstan/php-8-stubs/stubs/ext/ldap/ldap_get_dn.stub� �+g� �}�0� 8 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapFault.stub �+g ��1� 8 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapParam.stubb �+gb �d>� 9 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapServer.stub& �+g& �}Zn� 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{� < vendor/phpstan/php-8-stubs/stubs/ext/soap/is_soap_fault.stub7 �+g7 �ת*� 6 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapVar.stub� �+g� T�|l� E vendor/phpstan/php-8-stubs/stubs/ext/soap/use_soap_error_handler.stubh �+gh īd� 9 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapHeader.stub� �+g� ��V� 9 vendor/phpstan/php-8-stubs/stubs/ext/soap/SoapClient.stubB �+gB �B<� ; vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_scrub.stubO �+gO (RR�� < vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strpos.stubv �+gv ���B� ? vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_parse_str.stub] �+g] '��&� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_stristr.stub� �+g� ���3� D vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_output_handler.stubK �+gK ��i0� C vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_eregi_replace.stub� �+g� %7��� A vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_http_output.stubJ �+gJ T�.� @ vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strtoupper.stubT �+gT ����� E vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_pos.stub} �+g} ��Aߤ H vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_setpos.stub= �+g= ��d^� I vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_getregs.stubQ �+gQ �W�� I vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_preferred_mime_name.stubK �+gK &�Yj� B vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_convert_case.stuba �+ga �7).� D vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_check_encoding.stubg �+gg ��P� < vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strcut.stubq �+gq ��P� F vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_convert_encoding.stub� �+g� �)Jv� ; vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ltrim.stub| �+g| �o᪤ = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_stripos.stubw �+gw ���n� > vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_language.stubi �+gi �q�� A vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search.stub[ �+g[ �W<¤ = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strrpos.stubw �+gw b�i� F vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_encoding_aliases.stubX �+gX �Z� J vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_substitute_character.stubk �+gk 5s�Ϥ ? vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_str_split.stubc �+gc >�nW� D vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_regex_encoding.stuba �+ga b%�K� @ vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strimwidth.stub� �+g� c�G� B vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_convert_kana.stubk �+gk yQI~� @ vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strtolower.stubT �+gT <x�5� < vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_substr.stubq �+gq ���W� : vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg.stubr �+gr +�d� B vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_replace.stub� �+g� D�� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strrchr.stub� �+g� �铤 > vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strwidth.stubO �+gO �*� G vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_regex_set_options.stubJ �+gJ Rޘ� J vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_encode_numericentity.stub} �+g} iܛ� @ vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_http_input.stubc �+gc ��G� @ vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_match.stubb �+gb ^��� ; vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_rtrim.stub| �+g| ��@� > vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strrichr.stub� �+g� R��� 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_trim.stub{ �+g{ � � = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ucfirst.stubb �+gb S~ ۤ G vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_encode_mimeheader.stub� �+g� �e�#� < vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strstr.stub� �+g� �B��� D vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_list_encodings.stub/ �+g/ �f-�� > vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_get_info.stub/ �+g/ bߗ
� B vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_substr_count.stube �+ge ���J� J vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_decode_numericentity.stubj �+gj 3䍤 G vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_decode_mimeheader.stubA �+gA �� G vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_internal_encoding.stubP �+gP {� � G vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_convert_variables.stub� �+g� }Z�� 9 vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_chr.stubS �+gS �9�,� < vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strlen.stubM �+gM *�j� B vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_detect_order.stubk �+gk ���V� E vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_detect_encoding.stub� �+g� ���E� ; vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_eregi.stubs �+gs ��� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_lcfirst.stubb �+gb �UO� F vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_regs.stub~ �+g~ �j��� 9 vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ord.stubP �+gP _��� F vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_search_init.stubp �+gp S
�_� ; vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_split.stubs �+gs �
� K vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_ereg_replace_callback.stub� �+g� ��� � ? vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_send_mail.stub� �+g� ���A� > vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_strripos.stubx �+gx ȴ��� = vendor/phpstan/php-8-stubs/stubs/ext/mbstring/mb_str_pad.stub� �+g�
�2� ? vendor/phpstan/php-8-stubs/stubs/ext/sqlite3/SQLite3Result.stub. �+g. � � 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� = vendor/phpstan/php-8-stubs/stubs/ext/sqlite3/SQLite3Stmt.stub� �+g� ��LȤ > vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_hmac_algos.stubZ �+gZ �MU� 8 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_hkdf.stubx �+gx ���� 4 vendor/phpstan/php-8-stubs/stubs/ext/hash/mhash.stubV �+gV �
`� 8 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_file.stub �+g T��5� : vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_pbkdf2.stub_ �+g_ D��Ѥ = vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_hmac_file.stubt �+gt m��� A vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_update_stream.stub} �+g} �W�Z� ? vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_update_file.stub� �+g� ��\�� 8 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_init.stub� �+g� ��P8� : vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_equals.stubQ �+gQ ݍ�� 3 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash.stub* �+g* ���N� : vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_update.stub� �+g� d8�� 9 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_final.stubT �+gT +�i�� : vendor/phpstan/php-8-stubs/stubs/ext/hash/mhash_count.stub' �+g' v � � 8 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_hmac.stube �+ge �Z饤 8 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_copy.stubC �+gC ��j� B vendor/phpstan/php-8-stubs/stubs/ext/hash/mhash_get_hash_name.stubA �+gA 3n� 9 vendor/phpstan/php-8-stubs/stubs/ext/hash/hash_algos.stubU �+gU ���7� : vendor/phpstan/php-8-stubs/stubs/ext/hash/HashContext.stub �+g ��� ? vendor/phpstan/php-8-stubs/stubs/ext/hash/mhash_keygen_s2k.stubk �+gk ڣ� C vendor/phpstan/php-8-stubs/stubs/ext/hash/mhash_get_block_size.stubS �+gS x�� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/jewishtojd.stubE �+gE �� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/frenchtojd.stubE �+gE � �� @ vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdtogregorian.stub; �+g; ��
� > vendor/phpstan/php-8-stubs/stubs/ext/calendar/jddayofweek.stubX �+gX b��� > vendor/phpstan/php-8-stubs/stubs/ext/calendar/cal_from_jd.stub^ �+g^ x�ա� > vendor/phpstan/php-8-stubs/stubs/ext/calendar/easter_days.stubX �+gX �TX2� > vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdmonthname.stubD �+gD ��t�� D vendor/phpstan/php-8-stubs/stubs/ext/calendar/cal_days_in_month.stubs �+gs
V� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdtojulian.stub8 �+g8 ��ݝ� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/juliantojd.stubE �+gE � �� ; vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdtounix.stub3 �+g3 �)&�� @ vendor/phpstan/php-8-stubs/stubs/ext/calendar/gregoriantojd.stubH �+gH %g^�� ; vendor/phpstan/php-8-stubs/stubs/ext/calendar/cal_info.stubO �+gO Vf��� > vendor/phpstan/php-8-stubs/stubs/ext/calendar/easter_date.stubX �+gX �M�� < vendor/phpstan/php-8-stubs/stubs/ext/calendar/cal_to_jd.stubS �+gS o�Y�� ; vendor/phpstan/php-8-stubs/stubs/ext/calendar/unixtojd.stub@ �+g@ �bv�� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdtojewish.stub^ �+g^ zA��� = vendor/phpstan/php-8-stubs/stubs/ext/calendar/jdtofrench.stub8 �+g8 �d�V� 7 vendor/phpstan/php-8-stubs/stubs/ext/date/DateTime.stub �+g ��Ҥ C vendor/phpstan/php-8-stubs/stubs/ext/date/date_interval_format.stubX �+gX �D� 8 vendor/phpstan/php-8-stubs/stubs/ext/date/checkdate.stubE �+gE ��&� < vendor/phpstan/php-8-stubs/stubs/ext/date/date_time_set.stub �+g r��@� D vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_location_get.stube �+ge :��¤ S vendor/phpstan/php-8-stubs/stubs/ext/date/DateMalformedIntervalStringException.stub| �+g| o�ȗ� < vendor/phpstan/php-8-stubs/stubs/ext/date/date_date_set.stuba �+ga �i&� > vendor/phpstan/php-8-stubs/stubs/ext/date/DateObjectError.stubc �+gc �G�\� 8 vendor/phpstan/php-8-stubs/stubs/ext/date/localtime.stubo �+go #v�� D vendor/phpstan/php-8-stubs/stubs/ext/date/date_create_immutable.stub �+g ��� E vendor/phpstan/php-8-stubs/stubs/ext/date/date_parse_from_format.stubk �+gk M�Yu� 7 vendor/phpstan/php-8-stubs/stubs/ext/date/date_sub.stubT �+gT q}�� K vendor/phpstan/php-8-stubs/stubs/ext/date/DateMalformedStringException.stubt �+gt tk�w� @ vendor/phpstan/php-8-stubs/stubs/ext/date/date_timezone_set.stub] �+g] ���(� 8 vendor/phpstan/php-8-stubs/stubs/ext/date/date_diff.stub� �+g� S�~�� < vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_open.stubI �+gI �.� 7 vendor/phpstan/php-8-stubs/stubs/ext/date/gmmktime.stub� �+g� �� 3 vendor/phpstan/php-8-stubs/stubs/ext/date/time.stub �+g e��� 9 vendor/phpstan/php-8-stubs/stubs/ext/date/date_parse.stubO �+gO %��-� 9 vendor/phpstan/php-8-stubs/stubs/ext/date/gmstrftime.stubU �+gU ~�_q� : vendor/phpstan/php-8-stubs/stubs/ext/date/date_format.stubT �+gT q(%Ӥ H vendor/phpstan/php-8-stubs/stubs/ext/date/date_default_timezone_set.stubH �+gH `�e� ; vendor/phpstan/php-8-stubs/stubs/ext/date/DateTimeZone.stuba �+ga �Ʋ� : vendor/phpstan/php-8-stubs/stubs/ext/date/date_modify.stubV �+gV
{U� : vendor/phpstan/php-8-stubs/stubs/ext/date/date_sunset.stub� �+g� `�qg� 7 vendor/phpstan/php-8-stubs/stubs/ext/date/date_add.stubT �+gT 57f � Q vendor/phpstan/php-8-stubs/stubs/ext/date/DateMalformedPeriodStringException.stubz �+gz �&
T� : vendor/phpstan/php-8-stubs/stubs/ext/date/date_create.stubl �+gl /�� L vendor/phpstan/php-8-stubs/stubs/ext/date/DateInvalidOperationException.stubu �+gu +`�� = vendor/phpstan/php-8-stubs/stubs/ext/date/DateRangeError.stubb �+gb �(u� 5 vendor/phpstan/php-8-stubs/stubs/ext/date/gmdate.stubK �+gK e�� @ vendor/phpstan/php-8-stubs/stubs/ext/date/DateTimeImmutable.stub �+g _�s1� > vendor/phpstan/php-8-stubs/stubs/ext/date/date_offset_get.stubE �+gE �Z)�� ? vendor/phpstan/php-8-stubs/stubs/ext/date/date_isodate_set.stubm �+gm �wl� P vendor/phpstan/php-8-stubs/stubs/ext/date/date_create_immutable_from_format.stub� �+g� ���h� 6 vendor/phpstan/php-8-stubs/stubs/ext/date/getdate.stubR �+gR ]Tp<� F vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_name_from_abbr.stubn �+gn ���� B vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_offset_get.stubb �+gb �
� 7 vendor/phpstan/php-8-stubs/stubs/ext/date/strftime.stubS �+gS ���t� 8 vendor/phpstan/php-8-stubs/stubs/ext/date/strtotime.stuby �+gy �I�Ѥ A vendor/phpstan/php-8-stubs/stubs/ext/date/date_timestamp_set.stubU �+gU %��=� 3 vendor/phpstan/php-8-stubs/stubs/ext/date/date.stubI �+gI ��Y�� 4 vendor/phpstan/php-8-stubs/stubs/ext/date/idate.stubM �+gM 1�8� @ vendor/phpstan/php-8-stubs/stubs/ext/date/DateTimeInterface.stub�
�+g�
�� @ vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_name_get.stubE �+gE J�� A vendor/phpstan/php-8-stubs/stubs/ext/date/date_timestamp_get.stubH �+gH /�a=� 5 vendor/phpstan/php-8-stubs/stubs/ext/date/mktime.stub� �+g� �qd� @ vendor/phpstan/php-8-stubs/stubs/ext/date/date_timezone_get.stubW �+gW �� |� H vendor/phpstan/php-8-stubs/stubs/ext/date/date_default_timezone_get.stub8 �+g8
H�6� 8 vendor/phpstan/php-8-stubs/stubs/ext/date/DateError.stubY �+gY �� K vendor/phpstan/php-8-stubs/stubs/ext/date/DateInvalidTimeZoneException.stubt �+gt �~�M� ; vendor/phpstan/php-8-stubs/stubs/ext/date/DateInterval.stub �+g f�� 9 vendor/phpstan/php-8-stubs/stubs/ext/date/DatePeriod.stub� �+g� @#�Z� T vendor/phpstan/php-8-stubs/stubs/ext/date/date_interval_create_from_date_string.stuba �+ga a׀ � F vendor/phpstan/php-8-stubs/stubs/ext/date/date_create_from_format.stub� �+g� 4 �� ; vendor/phpstan/php-8-stubs/stubs/ext/date/date_sunrise.stub� �+g� ˠ�� G vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_transitions_get.stub� �+g� �
�� J vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_abbreviations_list.stubP �+gP P�69� < vendor/phpstan/php-8-stubs/stubs/ext/date/DateException.stuba �+ga �f� < vendor/phpstan/php-8-stubs/stubs/ext/date/date_sun_info.stubs �+gs &)�� H vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_identifiers_list.stub� �+g� ���� C vendor/phpstan/php-8-stubs/stubs/ext/date/timezone_version_get.stub3 �+g3 a1nj� C vendor/phpstan/php-8-stubs/stubs/ext/date/date_get_last_errors.stubO �+gO ֩[�� D vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_setcpuaffinity.stubn �+gn �~=Ƥ A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wexitstatus.stub> �+g> Ӑ !� > vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wstopsig.stub; �+g; �tu� > vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wtermsig.stub; �+g; L�Q� < vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_waitid.stub �+g ܸ� � ; vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_setns.stub� �+g� � G� D vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_get_last_error.stub0 �+g0 �h1� D vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_getcpuaffinity.stub� �+g� �I n� A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_sigprocmask.stub� �+g� v��� ; vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_forkx.stub[ �+g[ 1��ߤ ; vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_alarm.stub3 �+g3 u��>� A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wifsignaled.stub@ �+g@ � � = vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_waitpid.stub� �+g� A�� > vendor/phpstan/php-8-stubs/stubs/ext/pcntl/Pcntl/QosClass.stub� �+g� i�tV� < vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_signal.stub� �+g� ��� A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_setpriority.stub� �+g� �9��� ; vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_errno.stubJ �+gJ 6��~� B vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_setqos_class.stubt �+gt Db�� B vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_getqos_class.stub| �+g| ���%� B vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wifcontinued.stubQ �+gQ h���� B vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_sigtimedwait.stub� �+g� i� = vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_unshare.stubH �+gH ��k5� @ vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wifstopped.stub8 �+g8 p��� E vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_signal_dispatch.stub2 �+g2 :"�� ; vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_rfork.stubl �+gl � �� A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_getpriority.stub| �+g| ��� H vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_signal_get_handler.stubV �+gV ���%� > vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_strerror.stubC �+gC f�V�� : vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_fork.stubH �+gH ���Ҥ : vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_exec.stub[ �+g[ ���ʤ : vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wait.stub� �+g� t��M� < vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_getcpu.stubY �+gY 2��� ? vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_wifexited.stubE �+gE �4 5� C vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_async_signals.stubD �+gD �>�8� A vendor/phpstan/php-8-stubs/stubs/ext/pcntl/pcntl_sigwaitinfo.stub� �+g� �" O� W vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_random.stubV �+gV ���z� d vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_keygen.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_core_ristretto255_scalar_random.stub] �+g] fz �� B vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_bin2base64.stubm �+gm f��ߤ A vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_increment.stub< �+g< �<Dޤ [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_mul.stubn �+gn >� a� O vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretbox_keygen.stub= �+g= �o� = vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_unpad.stubJ �+gJ ��� 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_scalarmult_ristretto255_base.stubc �+gc -ُ~� G vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_open.stubn �+gn {A�� 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_crypto_aead_chacha20poly1305_decrypt.stub� �+g� y�'o� U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_client_session_keys.stubm �+gm �#,� V vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_xchacha20_keygen.stubU �+gU ë� J vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_generichash.stub� �+g� ���פ 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_sign_ed25519_sk_to_curve25519.stub\ �+g\ ��!,� ? vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_bin2hex.stub; �+g; [,� B vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_base642bin.stub\ �+g\ �GΒ� Z vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aes256gcm_is_available.stubh �+gh <�� g vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_keypair_from_secretkey_and_publickey.stub{ �+g{ =�~Ƥ [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_add.stubn �+gn 3>�m� V vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_str_needs_rehash.stub� �+g� q{WD� L vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_detached.stub] �+g] � U� L vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_publickey.stubJ �+gJ В�3� h vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_keypair_from_secretkey_and_publickey.stub| �+g| ��2ڤ ? vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_hex2bin.stubP �+gP $�54� K vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_secretkey.stubI �+gI g�S}� P vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_generichash_final.stub{ �+g{ ;�� V vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_xchacha20_xor_ic.stub� �+g� ��:8� g vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_init_pull.stubp �+gp "�n� a vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_ietf_decrypt.stub� �+g� T�mӤ N vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_seed_keypair.stubH �+gH �ƍr� [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_publickey_from_secretkey.stub[ �+g[ `�ȧ� a vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_ietf_encrypt.stub� �+g� ��J�� U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis128l_decrypt.stub� �+g� �X᧤ L vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_keygen.stub: �+g: /s�פ [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_keygen.stubI �+gI <zJ�� @ vendor/phpstan/php-8-stubs/stubs/ext/sodium/SodiumException.stub4 �+g4 ���\� S vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_verify_detached.stubu �+gu "�R� Z vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_from_hash.stubb �+gb �ฤ C vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign.stubT �+gT ��;�� \ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_encrypt.stub� �+g� 'v� e vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_scryptsalsa208sha256_str_verify.stubo �+go �0_�� N vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_scalarmult_base.stub� �+g� YL�!� U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aes256gcm_encrypt.stub� �+g� �r a vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_xchacha20poly1305_ietf_keygen.stubO �+gO ��6� O vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_generichash_init.stub| �+g| UD8s� U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aes256gcm_decrypt.stub� �+g� �ཤ I vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kdf_keygen.stub7 �+g7 ��IǤ L vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_secretkey.stubJ �+gJ Q�� M vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretbox_open.stubo �+go 0�7(� O vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_xchacha20.stub� �+g� ��z� S vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis256_keygen.stubR �+gR '0X�� ^ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_invert.stubf �+gf �w�� Q vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_generichash_keygen.stub? �+g? ��<n� Z vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_scryptsalsa208sha256.stub� �+g� �o�� K vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_keypair.stub9 �+g9 ��ۥ� T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aes256gcm_keygen.stubB �+gB T�E%� C vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_auth.stubT �+gT �VȮ� B vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box.stub` �+g` ��!� Q vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_generichash_update.stub� �+g� �V�ˤ ; vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_add.stubH �+gH ���E� ? vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_memzero.stub: �+g: � �� \ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_ed25519_pk_to_curve25519.stub\ �+g\ �A�� c vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_rekey.stub] �+g] 9�� J vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_keypair.stub8 �+g8 �dډ� H vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretbox.stuba �+ga �n�� V vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_scalarmult_ristretto255.stub� �+g� Wh � ; vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_pad.stubH �+gH �ZO[� I vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_keypair.stub7 �+g7 ;&��� P vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_str_verify.stubZ �+gZ �9�� T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_sub.stubg �+gg �o:� \ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_publickey_from_secretkey.stub\ �+g\ (�� I vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream_xor.stubb �+gb [�� � > vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_memcmp.stubI �+gI +H � T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis256_encrypt.stub� �+g� m�� M vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_publickey.stubK �+gK |O� � ^ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_negate.stubf �+gf U�Ĥ 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_core_ristretto255_scalar_reduce.stubf �+gf �D� � b vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_complement.stubj �+gj y� F� b vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_pull.stub� �+g� �l� b vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_xchacha20poly1305_ietf_decrypt.stub� �+g� h\L� J vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_auth_verify.stub_ �+g_ �W�#� E vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_stream.stubZ �+gZ �*'� O vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_shorthash_keygen.stub= �+g= �]N̤ H vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_open.stubf �+gf ��Y\� 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_core_ristretto255_is_valid_point.stube �+ge 18�� J vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_auth_keygen.stub8 �+g8 `@Q� M vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_sign_secretkey.stubK �+gK ���*� ` vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_chacha20poly1305_ietf_keygen.stubN �+gN u���� E vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash.stub� �+g� �/�� [ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_core_ristretto255_scalar_sub.stubn �+gn K��m� H vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_shorthash.stubY �+gY xˁ� g vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_init_push.stub_ �+g_ 7$m%� ^ vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_pwhash_scryptsalsa208sha256_str.stubz �+gz g���� L vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_seal_open.stubd �+gd ��g� I vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_scalarmult.stubR �+gR +�(� R vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kdf_derive_from_key.stub� �+g� "a�Τ U vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_kx_server_session_keys.stubx �+gx % d� 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_compare.stubJ �+gJ (�gI� b vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_secretstream_xchacha20poly1305_push.stub� �+g� �a�u� G vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_seal.stubX �+gX 1Hˤ T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis256_decrypt.stub� �+g� ���� O vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_box_seed_keypair.stubI �+gI ]�M� T vendor/phpstan/php-8-stubs/stubs/ext/sodium/sodium_crypto_aead_aegis128l_keygen.stubS �+gS M� �� 9 vendor/phpstan/php-8-stubs/stubs/ext/sysvsem/sem_get.stub� �+g� k� � = 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 $)�"� ? vendor/phpstan/php-8-stubs/stubs/ext/sysvsem/SysvSemaphore.stubG �+gG �|W�� : vendor/phpstan/php-8-stubs/stubs/ext/zlib/inflate_add.stuby �+gy ��u� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzopen.stubt �+gt � 6� C vendor/phpstan/php-8-stubs/stubs/ext/zlib/zlib_get_coding_type.stub9 �+g9 s )� ; vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzuncompress.stubR �+gR �;nx� = vendor/phpstan/php-8-stubs/stubs/ext/zlib/InflateContext.stubH �+gH �I�� 6 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzwrite.stub� �+g� D��� 6 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzclose.stub_ �+g_ ��c� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzread.stubr �+gr ����� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzfile.stubl �+gl ۥ��� 9 vendor/phpstan/php-8-stubs/stubs/ext/zlib/readgzfile.stubW �+gW 1<3� : vendor/phpstan/php-8-stubs/stubs/ext/zlib/zlib_decode.stubQ �+gQ ���B� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzgets.stubz �+gz �El�� 8 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzdeflate.stubn �+gn {e�q� ; vendor/phpstan/php-8-stubs/stubs/ext/zlib/inflate_init.stub\ �+g\ -��Ǥ A vendor/phpstan/php-8-stubs/stubs/ext/zlib/inflate_get_status.stubF �+gF MsO� 9 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzcompress.stubs �+gs e�ֆ� 7 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzdecode.stubN �+gN ]�x� ; vendor/phpstan/php-8-stubs/stubs/ext/zlib/deflate_init.stub\ �+g\ �<� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzseek.stub� �+g� F��� C vendor/phpstan/php-8-stubs/stubs/ext/zlib/inflate_get_read_len.stubH �+gH 8��� 4 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzeof.stub[ �+g[ 9:l^� : vendor/phpstan/php-8-stubs/stubs/ext/zlib/zlib_encode.stub\ �+g\ dI��� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzgetc.stube �+ge �Z� : vendor/phpstan/php-8-stubs/stubs/ext/zlib/deflate_add.stuby �+gy ��9� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gztell.stubb �+gb ]��g� ; vendor/phpstan/php-8-stubs/stubs/ext/zlib/ob_gzhandler.stubI �+gI F0� 7 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzrewind.stub` �+g` ~d]� 8 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzinflate.stubO �+gO �6ޤ = vendor/phpstan/php-8-stubs/stubs/ext/zlib/DeflateContext.stub& �+g& �Ǭ�� 5 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzputs.stub� �+g� �d� 7 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzencode.stubn �+gn �D9~� 9 vendor/phpstan/php-8-stubs/stubs/ext/zlib/gzpassthru.stubd �+gd �j�Ҥ > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_result_all.stub �+g �l�z� : vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_cursor.stub� �+g� ��l�� : vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_tables.stub� �+g� ����� < vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_rollback.stub� �+g� �N �� C vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_tableprivileges.stub
�+g
�H� 6 vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_do.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_autocommit.stubb �+gb �(I�� ; vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_connect.stubf �+gf ��� B vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_specialcolumns.stub� �+g� g`g5� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_fetch_array.stub� �+g� %��\� = vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_num.stub� �+g� ��p�� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_statistics.stubk �+gk �f[�� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_num_fields.stub� �+g� �:}f� < vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_pconnect.stubh �+gh �S�j� < vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_num_rows.stub� �+g� PȤ = vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_setoption.stub �+g �p1�� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_data_source.stub� �+g� �.� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_scale.stub� �+g� b�V� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_fetch_into.stubK �+gK �5�5� 8 vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_exec.stub� �+g� �Jڮ� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_primarykeys.stub5 �+g5 !a��� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_gettypeinfo.stub� �+g� Q �� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_free_result.stub� �+g� �x�D� D vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_columnprivileges.stub_ �+g_
�Q7� = vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_close_all.stubM �+gM �]j&� : vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_result.stub� �+g� n|� ; vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_prepare.stub� �+g� ��㈤ C vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_precision.stub �+g �P�ؤ 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_longreadlen.stub� �+g� ���� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_foreignkeys.stub� �+g� �?�� ; vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_binmode.stub� �+g� 9V��� 9 vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_close.stub� �+g� X`N � > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_type.stub� �+g� Yi� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_name.stub� �+g� ��� : vendor/phpstan/php-8-stubs/stubs/ext/odbc/Odbc/Result.stubm �+gm ܕ>b� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/Odbc/Connection.stubq �+gq �W�k� = vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_field_len.stub� �+g� �^e� R vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_connection_string_should_quote.stub\ �+g\ �q� D vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_procedurecolumns.stubC �+gC ѳc�� ? vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_next_result.stub �+g m�K�� > vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_procedures.stubi �+gi 9�G,� ; vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_execute.stub� �+g� �_e� : vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_commit.stub� �+g� |OC� 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_errormsg.stub� �+g� Oi�}� = vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_fetch_row.stub� �+g� �)� 9 vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_error.stub� �+g� �{�
� @ vendor/phpstan/php-8-stubs/stubs/ext/odbc/odbc_fetch_object.stubF �+gF �\�h� 9 vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_match.stub� �+g� � �+� J vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_replace_callback_array.stub� �+g� �?3� 9 vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_quote.stubO �+gO ��-�� : vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_filter.stub� �+g� `F�H� 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� D vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_replace_callback.stub� �+g� ό�Ѥ > vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_last_error.stub+ �+g+ 9{j � ; vendor/phpstan/php-8-stubs/stubs/ext/pcre/preg_replace.stub� �+g� ��<� 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_match_all.stub� �+g� �x�^� N vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_add_to_personal.stub� �+g� ��ʹ� M vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_set_ordering.stubm �+gm ��� J vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_quick_check.stub� �+g� rA�� J vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_free_dict.stubf �+gf � � � C vendor/phpstan/php-8-stubs/stubs/ext/enchant/EnchantDictionary.stub) �+g) u.=^� 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� 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_init.stub@ �+g@ ��:� M vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_request_dict.stubo �+go �$_
� ? vendor/phpstan/php-8-stubs/stubs/ext/enchant/EnchantBroker.stubG �+gG !���� E vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_free.stubY �+gY ��}� M vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_add_to_session.stubd �+gd ���Y� 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� N vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_set_dict_path.stub{ �+g{ ���O� H vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_get_error.stubY �+gY iJ� G vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_describe.stubh �+gh �j}� N vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_get_dict_path.stubu �+gu x� k� Q vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_request_pwl_dict.stubx �+gx {*N7� L vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_is_in_session.stub� �+g� ���T� B vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_add.stubY �+gY 'W\� G vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_is_added.stub^ �+g^ 8�<� J vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_broker_get_error.stubS �+gS �;�Ӥ D vendor/phpstan/php-8-stubs/stubs/ext/enchant/enchant_dict_check.stub[ �+g[ ���u� = vendor/phpstan/php-8-stubs/stubs/ext/pdo_mysql/Pdo/Mysql.stub� �+g� ��� C vendor/phpstan/php-8-stubs/stubs/ext/pdo_firebird/Pdo/Firebird.stub� �+g� �A_g� = vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_format.stub� �+g� ��4�� D vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_filter_matches.stubr �+gr �� � G vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_use_daylight_time.stubL �+gL ��Ҥ D vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_error_code.stubN �+gN �U � B vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_minimum.stubX �+gX B�(� U vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_minimal_days_in_first_week.stub� �+g� M=�� C vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_datetype.stubS �+gS �y � 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_calendar.stubp �+gp W)�`� E vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_error_code.stubO �+gO ,%室 ? vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_compare.stube �+ge <=R� D vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_format_object.stub� �+g� �2w� = vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_gmt.stub4 �+g4 ��� D vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_create.stub� �+g� k�� D vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_windows_id.stubn �+gn {$ŋ� B vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_maximum.stubX �+gX �{� < vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_after.stubW �+gW ��U� A vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_set_pattern.stub\ �+g\ �� � I vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_from_date_time_zone.stubX �+gX �t�E� : vendor/phpstan/php-8-stubs/stubs/ext/intl/idn_to_utf8.stub� �+g� �Ju� O vendor/phpstan/php-8-stubs/stubs/ext/intl/intlgregcal_set_gregorian_change.stubo �+go <�}� H vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_error_message.stubU �+gU ��Do� K vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_day_of_week_type.stube �+ge 2��� > vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_strlen.stubS �+gS � 4� K vendor/phpstan/php-8-stubs/stubs/ext/intl/dateformat/IntlDateFormatter.stub� �+g� �~a4� R vendor/phpstan/php-8-stubs/stubs/ext/intl/dateformat/IntlDatePatternGenerator.stubN �+gN ޒ�!� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_symbol.stub^ �+g^ ��A�� E vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_from_date_time.stubo �+go �J�K� B vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_pattern.stubU �+gU �S�X� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_to_date_time_zone.stub[ �+g[ �}K� D vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_strength.stubB �+gB ��4[� ; vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_parse.stub9 �+g9 p���� I vendor/phpstan/php-8-stubs/stubs/ext/intl/msgformat/MessageFormatter.stub� �+g� �L��� D vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_parse_currency.stub� �+g� ���ˤ I vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_actual_minimum.stub_ �+g_ %B�@� D vendor/phpstan/php-8-stubs/stubs/ext/intl/normalizer/Normalizer.stub� �+g� ��h�� I vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_display_variant.stubl �+gl 2�T[� > vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_strstr.stubp �+gp (�5�� 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/intlcal_get_now.stub- �+g- �Z�2� D vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_has_same_rules.stubf �+gf ���
� M vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_weekend_transition.stubg �+gg �w�r� E vendor/phpstan/php-8-stubs/stubs/ext/intl/intl_get_error_message.stub5 �+g5 �C;$� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_error_message.stubT �+gT y�� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_region.stub? �+g? �� � 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/intl_error_name.stub< �+g< vz1� J vendor/phpstan/php-8-stubs/stubs/ext/intl/intlgregcal_create_instance.stub� �+g� i�oM� W vendor/phpstan/php-8-stubs/stubs/ext/intl/breakiterator/IntlCodePointBreakIterator.stub� �+g� ?�� W vendor/phpstan/php-8-stubs/stubs/ext/intl/breakiterator/IntlRuleBasedBreakIterator.stub� �+g� f�,� N vendor/phpstan/php-8-stubs/stubs/ext/intl/breakiterator/IntlPartsIterator.stub@ �+g@ �m6� N vendor/phpstan/php-8-stubs/stubs/ext/intl/breakiterator/IntlBreakIterator.stubL �+gL p
Wq� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_field_difference.stubo �+go ?�� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_region.stubH �+gH W_̤ G vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_in_daylight_time.stubL �+gL ���� < vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_create.stubz �+gz 5ڈt� A vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_locale.stubY �+gY ��� � F vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_display_name.stubi �+gi ��8դ H vendor/phpstan/php-8-stubs/stubs/ext/intl/formatter/NumberFormatter.stub�\ �+g�\ ��Ҥ U vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_create_time_zone_id_enumeration.stub� �+g� �:� I vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_actual_maximum.stub_ �+g_ '�zy� G vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_equivalent_id.stub\ �+g\ ��5� D vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_create_default.stub; �+g; �9B � B vendor/phpstan/php-8-stubs/stubs/ext/intl/common/IntlIterator.stubi �+gi �X�A� O vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_create_from_rules.stub� �+g� w��4� H vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_display_region.stubk �+gk ��+_� O vendor/phpstan/php-8-stubs/stubs/ext/intl/intlgregcal_get_gregorian_change.stub^ �+g^ ��dƤ > vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_strpos.stubb �+gb 9hⓤ E vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_set_attribute.stub` �+g` ���� < vendor/phpstan/php-8-stubs/stubs/ext/intl/locale/Locale.stubo �+go �� D vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_create.stub� �+g� w%�� S vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_skipped_wall_time_option.stubW �+gW ��y� B vendor/phpstan/php-8-stubs/stubs/ext/intl/intl_get_error_code.stub< �+g< Q�/� : vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set.stub� �+g� &ʵC� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/collator/Collator.stubF �+gF �CT{� A vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_unknown.stub8 �+g8 ��� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_locale.stubq �+gq J���� A vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_pattern.stubR �+gR K��� = vendor/phpstan/php-8-stubs/stubs/ext/intl/uchar/IntlChar.stubJ� �+gJ� D� � @ vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_offset.stub� �+g� qs(ɤ J vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_primary_language.stubI �+gI @~�� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_set_symbol.stube �+ge
I�٤ F vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_create_instance.stub� �+g� �<|� H vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_least_maximum.stub^ �+g^ �R�v� 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/locale_accept_from_http.stubJ �+gJ g�� H vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_create_enumeration.stub� �+g� ���5� D vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_time_zone.stub� �+g� � �� B vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_locale.stubT �+gT /<�� T vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_repeated_wall_time_option.stub� �+g� ^`l� F vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_canonical_id.stub� �+g� ��7�� H vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_set_text_attribute.stubp �+gp �a� < vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_format.stub] �+g] X/_�� ; vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_parse.stub� �+g� ��Ҥ D vendor/phpstan/php-8-stubs/stubs/ext/intl/timezone/IntlTimeZone.stub �+g �W��� < vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_format.stub� �+g� �C�Z� O vendor/phpstan/php-8-stubs/stubs/ext/intl/normalizer_get_raw_decomposition.stub� �+g� �½�� ; vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_parse.stubs �+gs �خ0� J vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_display_language.stubm �+gm �� F vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_display_name.stub� �+g� �hW�� H vendor/phpstan/php-8-stubs/stubs/ext/intl/spoofchecker/Spoofchecker.stub� �+g� �d�a� G vendor/phpstan/php-8-stubs/stubs/ext/intl/normalizer_is_normalized.stubc �+gc |��� A vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_locale.stubt �+gt �:LԤ D vendor/phpstan/php-8-stubs/stubs/ext/intl/calendar/IntlCalendar.stub�F �+g�F 8+��� M vendor/phpstan/php-8-stubs/stubs/ext/intl/calendar/IntlGregorianCalendar.stub� �+g� �`�T� = vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_equals.stubX �+gX �e�W� C vendor/phpstan/php-8-stubs/stubs/ext/intl/normalizer_normalize.stubx �+gx �'�� J vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_count_equivalent_ids.stub^ �+g^ $'� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_script.stub? �+g? �Fʿ� C vendor/phpstan/php-8-stubs/stubs/ext/intl/converter/UConverter.stub(1 �+g(1 ���� B vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_set_pattern.stub^ �+g^ C-� < vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_sort.stubo �+go Ǎ��� D vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_time_zone.stubX �+gX �C��� A vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_is_lenient.stubL �+gL G��Ԥ G vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_is_equivalent_to.stubb �+gb �qr�� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_localtime.stub� �+g� ��eƤ ; vendor/phpstan/php-8-stubs/stubs/ext/intl/idn_to_ascii.stub� �+g� 3H�� K vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_transliterate.stub� �+g� !n�r� A vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_get_pattern.stubS �+gS u��� < vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_parse.stub� �+g� ���7� B vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_lenient.stub� �+g� ��\�� D vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_raw_offset.stubH �+gH ��D�� = vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_asort.stubp �+gp �^�R� = vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_before.stubX �+gX �3�T� L vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_available_locales.stubR �+gR *�e?� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_time.stubV �+gV s��� K vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_greatest_minimum.stuba �+ga ��1z� F vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_error_code.stubJ �+gJ �.�Ȥ F vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_create_time_zone.stubP �+gP {�Ф D vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_sort_key.stub[ �+g[ �K�� D vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_get_error_code.stubM �+gM wυ�� E vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_dst_savings.stubI �+gI C�ತ @ vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_strripos.stubd �+gd =�'� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_stristr.stubq �+gq ԺU� H vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_display_script.stubk �+gk ��dk� G vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_get_error_message.stubS �+gS VY� B vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_canonicalize.stubA �+gA � �:� < vendor/phpstan/php-8-stubs/stubs/ext/intl/IntlException.stubT �+gT c�� G vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_error_message.stubR �+gR ���� T vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_keyword_values_for_locale.stub� �+g� �� � H vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_error_message.stubU �+gU �� C vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_set_timezone.stubJ �+gJ ��݆� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_time.stubK �+gK � ] � A vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_set_default.stub� �+g� =d�� C vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_timezone.stub] �+g] ^�=�� A vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_is_weekend.stub` �+g` ��c)� = vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_compose.stubA �+gA ~`�Ф B vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_keywords.stuba �+ga Ϲ�n� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_stripos.stubc �+gc �� � G vendor/phpstan/php-8-stubs/stubs/ext/intl/intlgregcal_is_leap_year.stub` �+g` ���� C vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_parse_message.stub �+g A��� : vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_add.stubW �+gW y�;z� > vendor/phpstan/php-8-stubs/stubs/ext/intl/intl_is_failure.stub: �+g: {y�� < vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_clear.stub� �+g� �V�ʤ A vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_set_pattern.stub[ �+g[ ��$դ 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_create.stubc �+gc /�u� D vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_set_strength.stub� �+g� �Іp� I vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_error_message.stubP �+gP �]�#� C vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_to_date_time.stubS �+gS !=r� E vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_get_attribute.stubY �+gY 'C $� < vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_lookup.stub� �+g� rq�� K vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_id_for_windows_id.stubk �+gk R-��� C vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_count.stubG �+gG ���� L vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_create_inverse.stube �+ge ~�1K� S vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_set_skipped_wall_time_option.stub� �+g� �J��� O vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_get_error_message.stubd �+gd "K�� < vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_id.stubI �+gI �A� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_type.stubF �+gF |��� D vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_format_message.stubh �+gh ��� F vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_all_variants.stubD �+gD �l� D vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_error_code.stubL �+gL ���$� L vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle/ResourceBundle.stubh �+gh �+�� 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/grapheme_str_split.stubf �+gf �-sq� L vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator/Transliterator.stub� �+g� ��� ; vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_roll.stubr �+gr ��Fe� U vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_minimal_days_in_first_week.stub_ �+g_ F@�� L vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_get_error_code.stub^ �+g^ �*`� A vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_is_lenient.stubF �+gF sFLq� C vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_calendar.stubS �+gS {э�� C vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_set_attribute.stubn �+gn
XR� : vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get.stubP �+gP @D�
� A vendor/phpstan/php-8-stubs/stubs/ext/intl/intltz_get_iana_id.stub| �+g| ��`� T vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_get_repeated_wall_time_option.stubX �+gX ��� F vendor/phpstan/php-8-stubs/stubs/ext/intl/transliterator_list_ids.stubR �+gR ."9� E vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_error_code.stubO �+gO 4�.�� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_strrpos.stubc �+gc D��Ҥ E vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_locales.stub_ �+g_ O_}�� > vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_substr.stubd �+gd ����� A vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_get.stub2 �+g2 O�> � 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/datefmt_get_timezone_id.stubY �+gY �k�� ? vendor/phpstan/php-8-stubs/stubs/ext/intl/grapheme_extract.stub� �+g� �恤 O vendor/phpstan/php-8-stubs/stubs/ext/intl/resourcebundle_get_error_message.stubV �+gV ��6� > vendor/phpstan/php-8-stubs/stubs/ext/intl/collator_create.stubO �+gO �`� C vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_attribute.stubg �+gg �{�� < vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_create.stubg �+gg ��b� J vendor/phpstan/php-8-stubs/stubs/ext/intl/datefmt_get_calendar_object.stubi �+gi V*+}� H vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_get_text_attribute.stubi �+gi ��� = vendor/phpstan/php-8-stubs/stubs/ext/intl/intlcal_is_set.stubN �+gN i��=� @ vendor/phpstan/php-8-stubs/stubs/ext/intl/msgfmt_get_locale.stubL �+gL + ��� A vendor/phpstan/php-8-stubs/stubs/ext/intl/locale_get_default.stub> �+g> F�P�� E vendor/phpstan/php-8-stubs/stubs/ext/intl/numfmt_format_currency.stubw �+gw �M�d� D vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_clear_errors.stub0 �+g0 '���� K vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_use_internal_errors.stubO �+gO n�u8� B vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_get_errors.stub/ �+g/ � �� R vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_get_external_entity_loader.stubT �+gT a�A� < vendor/phpstan/php-8-stubs/stubs/ext/libxml/LibXMLError.stub? �+g? ��� M vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_disable_entity_loader.stub` �+g` ���� R vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_set_external_entity_loader.stubZ �+gZ f�rl� K vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_set_streams_context.stub_ �+g_ p�u+� F vendor/phpstan/php-8-stubs/stubs/ext/libxml/libxml_get_last_error.stub@ �+g@ ��)� F vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_open_uri.stubh �+gh �s�� F vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_pi.stubb �+gb �V�� O vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_dtd_element.stubi �+gi �� � J vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_document.stubE �+gE Fku� D vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_pi.stub? �+g? C��0� 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_write_comment.stubW �+gW d� � I vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_cdata.stubD �+gD Q܋2� L vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_dtd_entity.stubG �+gG &m% � 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_write_attribute.stube �+ge ���Ϥ N vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_full_end_element.stubI �+gI � `\� N vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_dtd_entity.stubf �+gf ��d�� B vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_text.stubN �+gN R=kޤ P vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_attribute_ns.stub~ �+g~ ���z� P vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_attribute_ns.stub� �+g� ���V� G vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_raw.stubS �+gS �k�ˤ I vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_comment.stubD �+gD �V O vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_dtd_attlist.stubi �+gi "h��� M vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_dtd_attlist.stubH �+gH YJ.� K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_element.stubT �+gT �,�d� I vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_open_memory.stub> �+g> ۽ �� K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_output_memory.stub\ �+g\ �<-5� C vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_flush.stubX �+gX n�Ť G vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_cdata.stubB �+gB ��W@� F vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_pi.stubQ �+gQ �C��� O vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_set_indent_string.stub_ �+g_ _�p�� K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_attribute.stubF �+gF ��
� I vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_cdata.stubU �+gU �� � N vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_dtd_entity.stub� �+g� td+ʤ M vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_dtd_element.stubH �+gH JHz� G vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_dtd.stub� �+g� �xN`� N vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_element_ns.stub| �+g| �ǚ>� G vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_dtd.stub� �+g� ��o� M vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_attribute.stubV �+gV +�$U� H vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_set_indent.stubQ �+gQ �
bH� = vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/XMLWriter.stub: �+g: TX � K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_element.stubm �+gm � � K vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_comment.stubF �+gF b�~o� O vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_start_dtd_element.stuba �+ga �&ht� E vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_dtd.stub@ �+g@ U��|� I vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_end_element.stubD �+gD � N vendor/phpstan/php-8-stubs/stubs/ext/xmlwriter/xmlwriter_write_element_ns.stub� �+g� ��#� @ 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_int.stub8 �+g8 (?^�� A vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_cast.stubI �+gI *� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_pow.stubE �+gE �Wg� E vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_set_type.stubI �+gI kjo�� D vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_create_guid.stub4 �+g4 �\B#� H vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_safearray_proxy.stubC �+gC ��j� J vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_get_active_object.stub\ �+g\ �) ˤ @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_eqv.stubE �+gE ��=� E vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_get_type.stub= �+g= �N�D� E vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/COMPersistHelper.stub� �+g� ��찤 G vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_print_typeinfo.stub� �+g� �?o� 8 vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com.stub� �+g� K�ϯ� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_fix.stub8 �+g8 ��F�� @ 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�[� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_cmp.stubx �+gx �?�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_add.stubE �+gE �'Z5� B vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_exception.stub? �+g? P�f� E vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_load_typelib.stub[ �+g[ g���� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_and.stubE �+gE {wq� E vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/com_message_pump.stubJ �+gJ ���� ? vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_or.stubD �+gD �S�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_div.stubE �+gE ��� 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_sub.stubE �+gE �Ag3� A vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_idiv.stubF �+gF h�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_xor.stubE �+gE ؏+�� N vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_date_to_timestamp.stubG �+gG �뾤 ; vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/dotnet.stub� �+g� ��`*� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_cat.stubE �+gE j� 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_neg.stub8 �+g8 ox�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_imp.stubE �+gE 2�6W� < vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant.stub� �+g� 4b@p� B vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_round.stubJ �+gJ �.�� @ vendor/phpstan/php-8-stubs/stubs/ext/com_dotnet/variant_set.stubi �+gi � � 5 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzclose.stubf �+gf �\�m� 5 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzerrno.stub� �+g� ��-+� 5 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzflush.stubf �+gf ���� 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� ��� 5 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzwrite.stub� �+g� 1�]� : vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzdecompress.stub` �+g` ��V� 8 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzcompress.stubd �+gd ?Qmu� 4 vendor/phpstan/php-8-stubs/stubs/ext/bz2/bzopen.stub� �+g� ��DӤ = vendor/phpstan/php-8-stubs/stubs/ext/exif/exif_imagetype.stub@ �+g@ �vY� ; vendor/phpstan/php-8-stubs/stubs/ext/exif/exif_tagname.stub] �+g] J�)f� = 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/curl/curl_share_close.stubK �+gK >�n�� 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_errno.stub9 �+g9 � �� : vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_escape.stub� �+g� ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_reset.stubA �+gA u��L� 8 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_exec.stubG �+gG ��a�� ; vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_getinfo.stubR �+gR 3���� ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_close.stubK �+gK D�$)� > vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_init.stub8 �+g8 ��5Ƥ 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/CurlHandle.stubD �+gD � �� D vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_getcontent.stubH �+gH �8� < vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_strerror.stub< �+g< ó�q� > vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_share_init.stub8 �+g8 Z�Hɤ > vendor/phpstan/php-8-stubs/stubs/ext/curl/CurlMultiHandle.stub' �+g' `�f`� ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_copy_handle.stubM �+gM � �� ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_file_create.stub~ �+g~ 1�$j� C vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_info_read.stub� �+g� �Ԃ� : vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_setopt.stubV �+gV b��� 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_version.stubG �+gG �_F�� @ vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_share_setopt.stubg �+gg ���� > vendor/phpstan/php-8-stubs/stubs/ext/curl/CurlShareHandle.stub' �+g' 4\4�� 8 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_init.stubF �+gF B4��� : vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_upkeep.stub� �+g� ��j� @ vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_select.stuba �+ga `x�� > vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_exec.stub{ �+g{ I�J� 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_setopt_array.stubQ �+gQ x�gL� 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_pause.stubv �+gv � i;� B vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_strerror.stubB �+gB �� 7 vendor/phpstan/php-8-stubs/stubs/ext/curl/CURLFile.stub �+g n�7B� @ vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_setopt.stubg �+gg ��}ˤ 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_error.stub< �+g< >ti� ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_multi_errno.stubJ �+gJ
�h� = vendor/phpstan/php-8-stubs/stubs/ext/curl/CURLStringFile.stub� �+g� '��V� < vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_unescape.stubU �+gU �� ? vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_share_errno.stubJ �+gJ �� u� 9 vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_close.stub: �+g: �09q� B vendor/phpstan/php-8-stubs/stubs/ext/curl/curl_share_strerror.stubB �+gB m��2� = vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_get_var.stubI �+gI ���u� < vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_detach.stub= �+g= :Pā� = 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� < vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_attach.stubn �+gn I!� = vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_put_var.stubV �+gV ¾� � < vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/shm_remove.stub= �+g= B E� B vendor/phpstan/php-8-stubs/stubs/ext/sysvshm/SysvSharedMemory.stubJ �+gJ I�_+� 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� : vendor/phpstan/php-8-stubs/stubs/ext/pdo/PDOStatement.stubK �+gK �xҤ 9 vendor/phpstan/php-8-stubs/stubs/ext/pdo/pdo_drivers.stub@ �+g@ �C�� > vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_config.stub? �+g? ��=� < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_html.stub; �+g; g�5 � < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_head.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_release.stub/ �+g/ [�6G� < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_is_xhtml.stub5 �+g5 �>0� > vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_output.stub9 �+g9 ��J� < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_body.stub; �+g; )�� < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_root.stub; �+g; I�� < vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_diagnose.stub5 �+g5 ���¤ 3 vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy.stubY �+gY q���� @ vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_clean_repair.stub9 �+g9 c�]�� ? vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_opt_doc.stubj �+gj �-�� > vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_status.stub6 �+g6 7�31� 7 vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidyNode.stub� �+g� �Ѳޤ D vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_get_error_buffer.stubE �+gE &�+� ? vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_repair_file.stub� �+g� 絲�� @ 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_getopt.stubN �+gN �\T-� : vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_is_xml.stub3 �+g3 ���դ > vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_parse_file.stub� �+g� �_xN� A vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_warning_count.stub9 �+g9 ��� A vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_repair_string.stub� �+g� �c� � ? vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_error_count.stub7 �+g7 Å�@� @ vendor/phpstan/php-8-stubs/stubs/ext/tidy/tidy_config_count.stub8 �+g8 ��ŗ� 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 �� �� 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 ۤ E vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_ignore.stub� �+g� `�S � 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� E vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_create.stub, �+g, ��(� C vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_mode.stub� �+g� �A2a� E vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_clear_session.stub� �+g� o�Τ ; vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_new.stubh �+gh � �?� G vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_data_dir.stub� �+g� �j<_� C vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_repl.stub� �+g� �S,� D vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_new_personal.stub| �+g| ��p|� F vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_add_to_session.stub� �+g� �(� 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_suggest.stub �+g |��� I vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_store_replacement.stub� �+g� ���� J vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_config_runtogether.stub� �+g� w��� G vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_add_to_personal.stub� �+g� z&�y� = vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_check.stub� �+g� ��8Ϥ E vendor/phpstan/php-8-stubs/stubs/ext/pspell/pspell_save_wordlist.stub� �+g� [WO�� = vendor/phpstan/php-8-stubs/stubs/ext/pdo_dblib/Pdo/Dblib.stubQ �+gQ �M-u� C vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_get_quick_print.stub1 �+g1 �:� : vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmpwalkoid.stub� �+g� J�A̤ 8 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp3_get.stub �+g -�!L� 6 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmpget.stub� �+g� �Wޤ : vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmpgetnext.stub� �+g� ��3� < vendor/phpstan/php-8-stubs/stubs/ext/snmp/SNMPException.stub9 �+g9 �=w � 7 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmpwalk.stub� �+g� R�S� F vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_set_valueretrieval.stub� �+g� ���ޤ 6 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmpset.stub� �+g� ���� I vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_set_oid_output_format.stub� �+g� �:`M� B vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_set_enum_print.stub� �+g� i ��� F vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_get_valueretrieval.stub3 �+g3 K Z� 8 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp2_get.stub� �+g� �K�� < vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp3_getnext.stub �+g Z�ݤ 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� }���� 8 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp2_set.stub� �+g� "��a� C vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_set_quick_print.stub� �+g� �{� 9 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp2_walk.stub� �+g� �uڤ > vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp3_real_walk.stub �+g �C`� 3 vendor/phpstan/php-8-stubs/stubs/ext/snmp/SNMP.stub� �+g� }|$� 8 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp3_set.stub3 �+g3 �x�� < vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp2_getnext.stub� �+g� D |� < vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp_read_mib.stub: �+g: n�U� ; vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmprealwalk.stub� �+g� h�Ƥ 9 vendor/phpstan/php-8-stubs/stubs/ext/snmp/snmp3_walk.stub �+g �'|M� G vendor/phpstan/php-8-stubs/stubs/ext/session/session_regenerate_id.stubR �+gR Mch� @ vendor/phpstan/php-8-stubs/stubs/ext/session/session_encode.stub3 �+g3 o�4� ? vendor/phpstan/php-8-stubs/stubs/ext/session/session_unset.stub* �+g* P%� @ vendor/phpstan/php-8-stubs/stubs/ext/session/session_status.stub* �+g* Qe��� G vendor/phpstan/php-8-stubs/stubs/ext/session/session_cache_limiter.stubO �+gO ��V� K vendor/phpstan/php-8-stubs/stubs/ext/session/session_get_cookie_params.stubN �+gN :\a� C vendor/phpstan/php-8-stubs/stubs/ext/session/session_save_path.stubJ �+gJ .�Z� C vendor/phpstan/php-8-stubs/stubs/ext/session/session_create_id.stubI �+gI )i� I vendor/phpstan/php-8-stubs/stubs/ext/session/SessionHandlerInterface.stub� �+g� �&)� < vendor/phpstan/php-8-stubs/stubs/ext/session/session_gc.stub, �+g, ���� X vendor/phpstan/php-8-stubs/stubs/ext/session/SessionUpdateTimestampHandlerInterface.stub+ �+g+ ��B�� > vendor/phpstan/php-8-stubs/stubs/ext/session/session_name.stubg �+gg C;� ? vendor/phpstan/php-8-stubs/stubs/ext/session/session_abort.stub* �+g* ]��Ĥ E vendor/phpstan/php-8-stubs/stubs/ext/session/session_write_close.stub0 �+g0 �H8� @ vendor/phpstan/php-8-stubs/stubs/ext/session/session_decode.stub7 �+g7 ��쭤 < vendor/phpstan/php-8-stubs/stubs/ext/session/session_id.stubA �+gA 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� _��Ӥ @ vendor/phpstan/php-8-stubs/stubs/ext/session/session_commit.stubM �+gM n
=�� @ vendor/phpstan/php-8-stubs/stubs/ext/session/SessionHandler.stub� �+g� �� � A vendor/phpstan/php-8-stubs/stubs/ext/session/session_destroy.stub, �+g, �N� F vendor/phpstan/php-8-stubs/stubs/ext/session/session_cache_expire.stubH �+gH ���� ? vendor/phpstan/php-8-stubs/stubs/ext/session/session_start.stub= �+g= 1�T� E vendor/phpstan/php-8-stubs/stubs/ext/session/session_module_name.stubN �+gN r��Q� K vendor/phpstan/php-8-stubs/stubs/ext/session/session_register_shutdown.stub6 �+g6 ��KS� D vendor/phpstan/php-8-stubs/stubs/ext/session/SessionIdInterface.stub� �+g� bᣤ ? vendor/phpstan/php-8-stubs/stubs/ext/session/session_reset.stub* �+g* �l� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/getcwd.stub2 �+g2 �88Ǥ D vendor/phpstan/php-8-stubs/stubs/ext/standard/connection_status.stub- �+g- n��
� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_reduce.stuba �+ga
�A� > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_callable.stub� �+g� ��(� A vendor/phpstan/php-8-stubs/stubs/ext/standard/substr_compare.stub� �+g� �ИG� A vendor/phpstan/php-8-stubs/stubs/ext/standard/array_key_last.stubB �+gB �s7�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/nl2br.stubJ �+gJ ;WtB� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/str_ends_with.stubJ �+gJ ��JO� E vendor/phpstan/php-8-stubs/stubs/ext/standard/array_count_values.stubi �+gi r�Ze� : vendor/phpstan/php-8-stubs/stubs/ext/standard/strcspn.stubk �+gk ��~� C vendor/phpstan/php-8-stubs/stubs/ext/standard/array_diff_assoc.stubL �+gL �B��� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/uniqid.stub| �+g| =7�� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_flush.stub% �+g% ��$E� J vendor/phpstan/php-8-stubs/stubs/ext/standard/memory_reset_peak_usage.stubE �+gE �4?� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/random_bytes.stubE �+gE O� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_product.stub; �+g; �q�-� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/file.stub� �+g� ���K� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/constant.stubJ �+gJ k�,�� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/end.stub5 �+g5 ��e� L vendor/phpstan/php-8-stubs/stubs/ext/standard/output_reset_rewrite_vars.stub6 �+g6 ��� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/in_array.stubY �+gY (1�ä 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/range.stub �+g j%�>� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fread.stub] �+g] �kO�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/ftell.stubM �+gM T�4�� N vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_resolve_include_path.stubP �+gP 'F^� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/intdiv.stub6 �+g6 ]�aФ E vendor/phpstan/php-8-stubs/stubs/ext/standard/array_udiff_uassoc.stubi �+gi BJ�Ӥ H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_filter_prepend.stub� �+g� �)�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/mail.stub� �+g� fc @ vendor/phpstan/php-8-stubs/stubs/ext/standard/getservbyname.stubg �+gg ���� L vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_wrapper_unregister.stubF �+gF �y� < vendor/phpstan/php-8-stubs/stubs/ext/standard/str_rot13.stub6 �+g6 谛;� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/log.stub> �+g> ��G�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/cosh.stub, �+g, g�e� = vendor/phpstan/php-8-stubs/stubs/ext/standard/pfsockopen.stub� �+g� {[�h� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/vsprintf.stubD �+gD ?c�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/headers_sent.stub� �+g� ��H� D vendor/phpstan/php-8-stubs/stubs/ext/standard/socket_get_status.stubx �+gx �դ 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/chown.stubD �+gD s��� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_select.stubO �+gO ��ݤ @ vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_length.stub/ �+g/ � ם� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/floor.stub1 �+g1 op�Z� : vendor/phpstan/php-8-stubs/stubs/ext/standard/lcfirst.stub4 �+g4 ,�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/boolval.stub0 �+g0 #�A� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/number_format.stub� �+g� �4�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_end_flush.stub) �+g) ���Ҥ 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/count.stubR �+gR G�� � ; vendor/phpstan/php-8-stubs/stubs/ext/standard/getmyuid.stub; �+g; �4G � > vendor/phpstan/php-8-stubs/stubs/ext/standard/utf8_encode.stub8 �+g8 _�?� : vendor/phpstan/php-8-stubs/stubs/ext/standard/scandir.stub� �+g� ��:� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/hexdec.stub: �+g: AT� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/hypot.stub5 �+g5 �(4� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/fwrite.stubq �+gq ���� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/max.stub? �+g? ����� = vendor/phpstan/php-8-stubs/stubs/ext/standard/random_int.stub8 �+g8 ��#s� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/rsort.stub� �+g� 1>\E� E vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_filters.stubG �+gG 4, `� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_end_clean.stub) �+g) "�?E� < vendor/phpstan/php-8-stubs/stubs/ext/standard/metaphone.stubf �+gf ���Ф : vendor/phpstan/php-8-stubs/stubs/ext/standard/getmxrr.stub� �+g� �~�ߤ < vendor/phpstan/php-8-stubs/stubs/ext/standard/fpassthru.stubK �+gK ����� C vendor/phpstan/php-8-stubs/stubs/ext/standard/parse_ini_string.stub� �+g� ��t� I vendor/phpstan/php-8-stubs/stubs/ext/standard/__PHP_Incomplete_Class.stub^ �+g^ LG8H� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/setrawcookie.stub� �+g� $� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/base64_decode.stubV �+gV 5lQ� F vendor/phpstan/php-8-stubs/stubs/ext/standard/php_ini_loaded_file.stub8 �+g8 �0 � ? vendor/phpstan/php-8-stubs/stubs/ext/standard/RoundingMode.stub� �+g� �t�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/sha1_file.stubT �+gT dEW"� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/rand.stubF �+gF � ��� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_isatty.stubP �+gP �k��� 5 vendor/phpstan/php-8-stubs/stubs/ext/standard/pi.stub �+g _loͤ @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_combine.stubE �+gE �c�`� C vendor/phpstan/php-8-stubs/stubs/ext/standard/is_uploaded_file.stub= �+g= Էr2� = vendor/phpstan/php-8-stubs/stubs/ext/standard/addslashes.stub7 �+g7 PYӛ� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/stripslashes.stub9 �+g9 ��m� B vendor/phpstan/php-8-stubs/stubs/ext/standard/config_get_hash.stubS �+gS �V+� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/atan2.stub5 �+g5 zA�� B vendor/phpstan/php-8-stubs/stubs/ext/standard/array_fill_keys.stubF �+gF ��m�� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/strnatcasecmp.stubI �+gI A_'� L vendor/phpstan/php-8-stubs/stubs/ext/standard/forward_static_call_array.stubV �+gV �q;�� = vendor/phpstan/php-8-stubs/stubs/ext/standard/is_numeric.stub3 �+g3 ��r�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/proc_nice.stubD �+gD ���� A vendor/phpstan/php-8-stubs/stubs/ext/standard/gethostbynamel.stubY �+gY ���{� B vendor/phpstan/php-8-stubs/stubs/ext/standard/array_key_first.stubC �+gC Hrʷ� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_filter_append.stub� �+g� �;��� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/sqrt.stub, �+g, ����� < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_pad.stubN �+gN �{~ � ; vendor/phpstan/php-8-stubs/stubs/ext/standard/readfile.stub� �+g� ���� D vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_bucket_new.stub �+g 6놞� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/closedir.stub_ �+g_ DyJ�� 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/chdir.stub3 �+g3 {RQ� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/htmlentities.stub] �+g] R�i~� P vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_set_ctrl_handler.stub^ �+g^ ��|�� E vendor/phpstan/php-8-stubs/stubs/ext/standard/connection_aborted.stub. �+g. 7���� C vendor/phpstan/php-8-stubs/stubs/ext/standard/time_sleep_until.stub= �+g= h��E� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/str_decrement.stubK �+gK z�R�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/is_null.stub0 �+g0 �E8�� M vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_set_default.stubW �+gW �D � > vendor/phpstan/php-8-stubs/stubs/ext/standard/levenshtein.stub� �+g� ���� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fstat.stubb �+gb h7� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/fclose.stubI �+gI p|� � G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_bucket_append.stub� �+g� k��� : vendor/phpstan/php-8-stubs/stubs/ext/standard/symlink.stub@ �+g@ �/j� J vendor/phpstan/php-8-stubs/stubs/ext/standard/quoted_printable_decode.stub^ �+g^ n��� I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_recvfrom.stub� �+g� Uq5$� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/base64_encode.stubI �+gI ��� < vendor/phpstan/php-8-stubs/stubs/ext/standard/urldecode.stub6 �+g6 q�v� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_supports_lock.stubW �+gW x �Ĥ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/arsort.stub� �+g� ��D� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fputs.stub� �+g� '�
r� H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_bucket_prepend.stub� �+g� �q�m� < vendor/phpstan/php-8-stubs/stubs/ext/standard/getrusage.stubn �+gn ���<� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/filetype.stub= �+g= L� J vendor/phpstan/php-8-stubs/stubs/ext/standard/htmlspecialchars_decode.stub� �+g� ��+�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fgets.stube �+ge �π2� 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_map.stubZ �+gZ Kc�ܤ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/chroot.stubt �+gt ��� F vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_cp_set.stube �+ge Nv�[� J vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_cp_is_utf8.stub4 �+g4 V�Ћ� C vendor/phpstan/php-8-stubs/stubs/ext/standard/dns_check_record.stub� �+g� ��� H vendor/phpstan/php-8-stubs/stubs/ext/standard/array_intersect_assoc.stubQ �+gQ ³�L� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/rewind.stubI �+gI �BӐ� H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_copy_to_stream.stub� �+g� ��?K� C vendor/phpstan/php-8-stubs/stubs/ext/standard/disk_total_space.stubE �+gE Bx�̤ : vendor/phpstan/php-8-stubs/stubs/ext/standard/strcoll.stubJ �+gJ ��0�� A vendor/phpstan/php-8-stubs/stubs/ext/standard/error_get_last.stubD �+gD U1̤ J vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_set_write_buffer.stubd �+gd �� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/flock.stub� �+g� )-&� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/expm1.stub- �+g- �Bf�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/show_source.stubr �+gr v��6� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/getopt.stub� �+g� ���� : vendor/phpstan/php-8-stubs/stubs/ext/standard/natsort.stub} �+g} *#��� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/asin.stub, �+g, +�9� : vendor/phpstan/php-8-stubs/stubs/ext/standard/print_r.stub� �+g� �"�N� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/is_int.stub/ �+g/ �^�� L vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_get_params.stubr �+gr �t��� : vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_get.stub: �+g: ��� E vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_set_timeout.stub� �+g� �iه� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/is_nan.stub- �+g- #"� B vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_line.stub| �+g| ����� > vendor/phpstan/php-8-stubs/stubs/ext/standard/get_browser.stub� �+g� /.� > vendor/phpstan/php-8-stubs/stubs/ext/standard/count_chars.stubz �+gz 7�n�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strchr.stub} �+g} ��F� : vendor/phpstan/php-8-stubs/stubs/ext/standard/long2ip.stub� �+g� ��Q�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/iptcembed.stubm �+gm �/�*� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/system.stubo �+go 7қ� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/usort.stub� �+g� ���� = vendor/phpstan/php-8-stubs/stubs/ext/standard/str_getcsv.stub� �+g� :7 � > vendor/phpstan/php-8-stubs/stubs/ext/standard/array_chunk.stub_ �+g_ Z��Ǥ 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/sort.stub� �+g� ( vY� : vendor/phpstan/php-8-stubs/stubs/ext/standard/mt_rand.stubI �+gI �:� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/getenv.stubv �+gv �q �� : vendor/phpstan/php-8-stubs/stubs/ext/standard/is_bool.stub0 �+g0 ��� � 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/chmod.stubK �+gK �� � < vendor/phpstan/php-8-stubs/stubs/ext/standard/fsockopen.stub� �+g� /� A� < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_all.stubW �+gW ���¤ ; vendor/phpstan/php-8-stubs/stubs/ext/standard/pathinfo.stubk �+gk �6[Ĥ 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/acos.stub, �+g, t� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/substr.stubU �+gU �E#� = vendor/phpstan/php-8-stubs/stubs/ext/standard/var_export.stubL �+gL �k\}� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/sleep.stub- �+g- �3cL� : vendor/phpstan/php-8-stubs/stubs/ext/standard/stristr.stubi �+gi O�z�� C vendor/phpstan/php-8-stubs/stubs/ext/standard/convert_uuencode.stubN �+gN ���~� N vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_enable_crypto.stub� �+g� |�j"� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/trim.stubW �+gW ���+� A vendor/phpstan/php-8-stubs/stubs/ext/standard/get_debug_type.stub9 �+g9 �1&D� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/gethostbyname.stub< �+g< �?N� B vendor/phpstan/php-8-stubs/stubs/ext/standard/disk_free_space.stubD �+gD ,�T�� C vendor/phpstan/php-8-stubs/stubs/ext/standard/convert_uudecode.stubC �+gC 6�b�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/octdec.stub< �+g< �9� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/fdiv.stub: �+g: �]�� C vendor/phpstan/php-8-stubs/stubs/ext/standard/htmlspecialchars.stub� �+g� �W֤ < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_sum.stub7 �+g7 �̮�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/reset.stub7 �+g7 ��?_� = vendor/phpstan/php-8-stubs/stubs/ext/standard/phpversion.stubH �+gH �L��� C vendor/phpstan/php-8-stubs/stubs/ext/standard/array_key_exists.stub] �+g] �^2�� B vendor/phpstan/php-8-stubs/stubs/ext/standard/password_verify.stubJ �+gJ ��� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/pow.stubG �+gG \�4Ϥ F vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_set_blocking.stubd �+gd ���u� H vendor/phpstan/php-8-stubs/stubs/ext/standard/password_needs_rehash.stubj �+gj 7�O� : vendor/phpstan/php-8-stubs/stubs/ext/standard/strpbrk.stubN �+gN ��Kݤ 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/join.stubf �+gf ��a)� A vendor/phpstan/php-8-stubs/stubs/ext/standard/set_time_limit.stubk �+gk ,�mz� < vendor/phpstan/php-8-stubs/stubs/ext/standard/quotemeta.stub6 �+g6 ��V
� A vendor/phpstan/php-8-stubs/stubs/ext/standard/str_word_count.stub� �+g� �w}� F vendor/phpstan/php-8-stubs/stubs/ext/standard/forward_static_call.stubS �+gS ����� A vendor/phpstan/php-8-stubs/stubs/ext/standard/assert_options.stubO �+gO }��d� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/headers_list.stubA �+gA �gŤ ; vendor/phpstan/php-8-stubs/stubs/ext/standard/md5_file.stubS �+gS �&�ۤ = vendor/phpstan/php-8-stubs/stubs/ext/standard/strtolower.stub7 �+g7 ���� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/basename.stubH �+gH ]aפ 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/abs.stub@ �+g@ D_fӤ = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_diff.stubF �+gF �C��� B vendor/phpstan/php-8-stubs/stubs/ext/standard/version_compare.stub �+g Z5g�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/str_pad.stubz �+gz e��!� = vendor/phpstan/php-8-stubs/stubs/ext/standard/getrandmax.stubB �+gB la� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/touch.stubi �+gi �A� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/is_countable.stub5 �+g5 ���s� > vendor/phpstan/php-8-stubs/stubs/ext/standard/array_shift.stub6 �+g6 �0S�� L vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_set_option.stub� �+g� �K�
� : vendor/phpstan/php-8-stubs/stubs/ext/standard/tempnam.stubM �+gM >{�$� F vendor/phpstan/php-8-stubs/stubs/ext/standard/socket_set_blocking.stub� �+g�
�@~� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/getimagesize.stub� �+g� ��� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_walk.stub� �+g� �Z��� B vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_is_local.stubY �+gY I(Ѥ : vendor/phpstan/php-8-stubs/stubs/ext/standard/rad2deg.stub/ �+g/ �dO-� : vendor/phpstan/php-8-stubs/stubs/ext/standard/current.stub8 �+g8 �Nr� A vendor/phpstan/php-8-stubs/stubs/ext/standard/escapeshellarg.stub8 �+g8 �
�ܤ : vendor/phpstan/php-8-stubs/stubs/ext/standard/soundex.stubD �+gD +/�D� A vendor/phpstan/php-8-stubs/stubs/ext/standard/array_find_key.stub] �+g] x�#�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/fputcsv.stub �+g ^@"� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/header.stubp �+gp 7^��� : vendor/phpstan/php-8-stubs/stubs/ext/standard/strrchr.stub� �+g� � v� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_values.stubT �+gT ���� > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_resource.stub4 �+g4 �U� > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_infinite.stub2 �+g2 �k�o� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/wordwrap.stubz �+gz c�Eb� G vendor/phpstan/php-8-stubs/stubs/ext/standard/php_strip_whitespace.stubC �+gC ��%`� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fileinode.stub; �+g; l6"M� F vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_wrappers.stubH �+gH ���!� E vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_pair.stub� �+g� Xy� A vendor/phpstan/php-8-stubs/stubs/ext/standard/escapeshellcmd.stub< �+g< E-_�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/decoct.stub- �+g- �� +� > vendor/phpstan/php-8-stubs/stubs/ext/standard/array_slice.stubt �+gt �� = vendor/phpstan/php-8-stubs/stubs/ext/standard/shell_exec.stubC �+gC ��W�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/doubleval.stubJ �+gJ g�(�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/setcookie.stub� �+g� N~��� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/str_contains.stubI �+gI i:3ˤ 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/atanh.stub- �+g- ��OY� H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_set_chunk_size.stubi �+gi ��@)� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/pos.stubJ �+gJ ��� D vendor/phpstan/php-8-stubs/stubs/ext/standard/array_udiff_assoc.stubh �+gh ��Pj� < vendor/phpstan/php-8-stubs/stubs/ext/standard/error_log.stub� �+g� -���� B vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_contents.stub4 �+g4
p>R� : vendor/phpstan/php-8-stubs/stubs/ext/standard/opendir.stub� �+g� �#`r� = vendor/phpstan/php-8-stubs/stubs/ext/standard/strtoupper.stub7 �+g7 9Z+�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/rewinddir.stub` �+g` ��=�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/str_shuffle.stub8 �+g8 7j�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/round.stub �+g p|mq� I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_get_name.stubo �+go QQ� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_clean.stub% �+g% M��Ҥ A vendor/phpstan/php-8-stubs/stubs/ext/standard/password_algos.stub, �+g, פ : vendor/phpstan/php-8-stubs/stubs/ext/standard/deg2rad.stub/ �+g/ C~�� I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_shutdown.stuby �+gy �"�
� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/exec.stub� �+g� 6���� > vendor/phpstan/php-8-stubs/stubs/ext/standard/get_headers.stub� �+g�
�CC� A vendor/phpstan/php-8-stubs/stubs/ext/standard/array_diff_key.stubJ �+gJ �=+� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/asort.stub� �+g� �U�!� A vendor/phpstan/php-8-stubs/stubs/ext/standard/AssertionError.stub@ �+g@ �6�¤ : vendor/phpstan/php-8-stubs/stubs/ext/standard/is_long.stubE �+gE H��� G vendor/phpstan/php-8-stubs/stubs/ext/standard/array_intersect_ukey.stubk �+gk �|��� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/lchgrp.stubF �+gF a;�� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/ord.stub0 �+g0 2�a/� I vendor/phpstan/php-8-stubs/stubs/ext/standard/register_tick_function.stub\ �+g\ �n (� < vendor/phpstan/php-8-stubs/stubs/ext/standard/iptcparse.stubV �+gV �ה� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_unshift.stubH �+gH b��`� F vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_cp_get.stub@ �+g@ ��9�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/extract.stub| �+g| ���f� M vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_set_options.stub
�+g
�'hĤ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/unpack.stub� �+g� S}T٤ = vendor/phpstan/php-8-stubs/stubs/ext/standard/getmyinode.stub, �+g, ��$h� : vendor/phpstan/php-8-stubs/stubs/ext/standard/strrpos.stubZ �+gZ G}
� G vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_cp_conv.stubv �+gv �I]�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/is_file.stub4 �+g4 �J�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fgetc.stubP �+gP ̳kh� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/gettimeofday.stub] �+g] �q;?� A vendor/phpstan/php-8-stubs/stubs/ext/standard/time_nanosleep.stuby �+gy �0� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_meta_data.stub\ �+g\ �.>(� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_client.stub1 �+g1 �s�x� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fileperms.stub; �+g; �F �� : vendor/phpstan/php-8-stubs/stubs/ext/standard/openlog.stub� �+g� &�r`� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/printf.stubB �+gB �(� D vendor/phpstan/php-8-stubs/stubs/ext/standard/password_get_info.stubc �+gc ��� > vendor/phpstan/php-8-stubs/stubs/ext/standard/str_replace.stub� �+g� ���� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fileatime.stubL �+gL �|�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/parse_str.stubZ �+gZ ȇPI� M vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_get_options.stubx �+gx ໄ�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_unique.stubP �+gP |3J�� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/key.stub> �+g> {�ܠ� < vendor/phpstan/php-8-stubs/stubs/ext/standard/is_scalar.stub2 �+g2 2��m� : vendor/phpstan/php-8-stubs/stubs/ext/standard/implode.stubS �+gS q?V� > vendor/phpstan/php-8-stubs/stubs/ext/standard/utf8_decode.stub8 �+g8 �{�,� < vendor/phpstan/php-8-stubs/stubs/ext/standard/serialize.stub4 �+g4 ��פ ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_splice.stubr �+gr Ý�5� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/chgrp.stubE �+gE ��*
� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/sin.stub+ �+g+ �֊�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/is_writeable.stubS �+gS ���� > vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_get_all.stubu �+gu ��̤ D vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_implicit_flush.stubA �+gA �� J vendor/phpstan/php-8-stubs/stubs/ext/standard/image_type_to_extension.stube �+ge ��c�� C vendor/phpstan/php-8-stubs/stubs/ext/standard/http_build_query.stub� �+g� �� � E vendor/phpstan/php-8-stubs/stubs/ext/standard/http_response_code.stubI �+gI y�g
� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/is_executable.stub: �+g: H�p� M vendor/phpstan/php-8-stubs/stubs/ext/standard/register_shutdown_function.stub� �+g� J��K� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/ltrim.stubX �+gX ��;-� < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_pop.stub4 �+g4 �mߤ 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/sinh.stub, �+g, ��+.� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/hebrev.stubP �+gP J=I� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/hrtime.stuba �+ga ��2 � 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/chr.stub0 �+g0 �4n� : vendor/phpstan/php-8-stubs/stubs/ext/standard/ucfirst.stub4 �+g4 ��
ܤ ; vendor/phpstan/php-8-stubs/stubs/ext/standard/is_float.stub1 �+g1 ��ʛ� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/assert.stubx �+gx ͢Mo� < vendor/phpstan/php-8-stubs/stubs/ext/standard/urlencode.stub6 �+g6 �z�e� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/link.stub= �+g=
��� J vendor/phpstan/php-8-stubs/stubs/ext/standard/array_uintersect_uassoc.stubn �+gn ���� > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_writable.stub8 �+g8 �b��� > vendor/phpstan/php-8-stubs/stubs/ext/standard/addcslashes.stubL �+gL a�q� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/fscanf.stub� �+g� t�[ � 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/usleep.stub4 �+g4 � � @ vendor/phpstan/php-8-stubs/stubs/ext/standard/get_meta_tags.stubx �+gx ��Rp� > vendor/phpstan/php-8-stubs/stubs/ext/standard/chunk_split.stubf �+gf �-j�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/ftruncate.stubW �+gW ӌӣ� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_search.stubi �+gi a� i� D vendor/phpstan/php-8-stubs/stubs/ext/standard/file_get_contents.stub� �+g� �ј7� 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/array_uintersect_assoc.stubm �+gm M)w�� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/mt_srand.stub� �+g� '��� = vendor/phpstan/php-8-stubs/stubs/ext/standard/key_exists.stubv �+gv @)�;� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/filesize.stub: �+g: ���� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_keys.stub� �+g�
�b� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/popen.stubW �+gW �o�.� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/crc32.stub= �+g= �@� I vendor/phpstan/php-8-stubs/stubs/ext/standard/getimagesizefromstring.stub� �+g� ��y�� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/tan.stub+ �+g+ *>BZ� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/strtr.stubZ �+gZ <���� A vendor/phpstan/php-8-stubs/stubs/ext/standard/call_user_func.stubN �+gN ���� G vendor/phpstan/php-8-stubs/stubs/ext/standard/array_walk_recursive.stub� �+g� �c2� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/StreamBucket.stub �+g "i7� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/tanh.stub, �+g, ��ש� < vendor/phpstan/php-8-stubs/stubs/ext/standard/inet_ntop.stubU �+gU �Yt٤ D vendor/phpstan/php-8-stubs/stubs/ext/standard/file_put_contents.stub� �+g� ����� E vendor/phpstan/php-8-stubs/stubs/ext/standard/realpath_cache_get.stubG �+gG ֧ �� > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_iterable.stub4 �+g4 8ŝ�� B vendor/phpstan/php-8-stubs/stubs/ext/standard/array_multisort.stub� �+g� n�la� E vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_parse_quantity.stubP �+gP 3 �� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_fill.stubR �+gR ��ˤ ; vendor/phpstan/php-8-stubs/stubs/ext/standard/is_array.stub1 �+g1 ��曤 I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_set_read_buffer.stubc �+gc ��m�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/natcasesort.stub� �+g� A��i� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/str_increment.stubK �+gK t��� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/lchown.stubU �+gU �Y�� > vendor/phpstan/php-8-stubs/stubs/ext/standard/array_udiff.stubb �+gb ���K� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_clean.stub1 �+g1 �z�դ 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/md5.stubR �+gR ���)� < vendor/phpstan/php-8-stubs/stubs/ext/standard/proc_open.stub �+g �� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/fpow.stubi �+gi �v� : vendor/phpstan/php-8-stubs/stubs/ext/standard/vprintf.stub@ �+g@ �^ A� < vendor/phpstan/php-8-stubs/stubs/ext/standard/fdatasync.stub] �+g] ��@�� A vendor/phpstan/php-8-stubs/stubs/ext/standard/sys_getloadavg.stubg �+gg {�dv� : vendor/phpstan/php-8-stubs/stubs/ext/standard/settype.stub= �+g= ��� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/decbin.stub- �+g- �!K�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_flush.stub1 �+g1 x� �� : vendor/phpstan/php-8-stubs/stubs/ext/standard/dirname.stubC �+gC !j�Ф C vendor/phpstan/php-8-stubs/stubs/ext/standard/set_include_path.stubI �+gI ���� < vendor/phpstan/php-8-stubs/stubs/ext/standard/array_any.stubW �+gW ��D� > vendor/phpstan/php-8-stubs/stubs/ext/standard/get_cfg_var.stubD �+gD A��� B vendor/phpstan/php-8-stubs/stubs/ext/standard/debug_zval_dump.stubJ �+gJ d5͉� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_level.stub( �+g( y,�� A vendor/phpstan/php-8-stubs/stubs/ext/standard/parse_ini_file.stub� �+g� �
e� : vendor/phpstan/php-8-stubs/stubs/ext/standard/sprintf.stub^ �+g^ ��S�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/ftok.stubf �+gf /�'� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/cos.stub+ �+g+ �YF*� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/glob.stubo �+go ���Ѥ C vendor/phpstan/php-8-stubs/stubs/ext/standard/error_clear_last.stub- �+g- sq�8� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/passthru.stub� �+g� O ^� < vendor/phpstan/php-8-stubs/stubs/ext/standard/str_split.stubd �+gd ���ͤ ; vendor/phpstan/php-8-stubs/stubs/ext/standard/strptime.stub� �+g� ��~� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/copy.stubo �+go K�=� I vendor/phpstan/php-8-stubs/stubs/ext/standard/output_add_rewrite_var.stubN �+gN ]��4� C vendor/phpstan/php-8-stubs/stubs/ext/standard/array_uintersect.stubg �+gg Vś� > vendor/phpstan/php-8-stubs/stubs/ext/standard/nl_langinfo.stubN �+gN �<n� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/syslog.stub� �+g� ���x� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fsync.stubY �+gY + �
� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/mkdir.stub� �+g� �
� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/atan.stub, �+g, ��ͤ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/is_dir.stub3 �+g3 �� : vendor/phpstan/php-8-stubs/stubs/ext/standard/ip2long.stub3 �+g3 ��� : vendor/phpstan/php-8-stubs/stubs/ext/standard/tmpfile.stub< �+g< �?�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/pclose.stubH �+gH =t��� > vendor/phpstan/php-8-stubs/stubs/ext/standard/unserialize.stubJ �+gJ ��ɒ� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_accept.stub� �+g� �(�_� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/sizeof.stubg �+gg D��� F vendor/phpstan/php-8-stubs/stubs/ext/standard/realpath_cache_size.stub/ �+g/ z�l� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/getservbyport.stubk �+gk F�W� C vendor/phpstan/php-8-stubs/stubs/ext/standard/get_include_path.stub5 �+g5 h��a� J vendor/phpstan/php-8-stubs/stubs/ext/standard/array_replace_recursive.stubY �+gY �>Y� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strtok.stubP �+gP �GL�� I vendor/phpstan/php-8-stubs/stubs/ext/standard/array_intersect_uassoc.stubm �+gm =:|� J vendor/phpstan/php-8-stubs/stubs/ext/standard/quoted_printable_encode.stubD �+gD 0� ,� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strpos.stubY �+gY ��O?� : vendor/phpstan/php-8-stubs/stubs/ext/standard/hex2bin.stub: �+g: @Q\1� = vendor/phpstan/php-8-stubs/stubs/ext/standard/is_integer.stubH �+gH �� �� S vendor/phpstan/php-8-stubs/stubs/ext/standard/http_clear_last_response_headers.stubN �+gN A#�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/ceil.stub0 �+g0 R �>� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/krsort.stub� �+g� �bK� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/getmypid.stub* �+g* �o4� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/header_remove.stub> �+g> �}��� < vendor/phpstan/php-8-stubs/stubs/ext/standard/parse_url.stub� �+g� �s�+� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_sendto.stub� �+g� ��g�� E vendor/phpstan/php-8-stubs/stubs/ext/standard/socket_set_timeout.stub� �+g� U�R� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fseek.stubl �+gl ����� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/var_dump.stubO �+gO �}�� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/realpath.stub9 �+g9 /'~� < vendor/phpstan/php-8-stubs/stubs/ext/standard/strnatcmp.stubE �+gE h�L�� = vendor/phpstan/php-8-stubs/stubs/ext/standard/strip_tags.stub_ �+g_ ��f� B vendor/phpstan/php-8-stubs/stubs/ext/standard/array_intersect.stubK �+gK ��]� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_reverse.stubT �+gT ¼)0� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_rand.stubM �+gM �BQ� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/feof.stubG �+gG =�m�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strrev.stub3 �+g3 ��� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/intval.stub> �+g> �Y� A vendor/phpstan/php-8-stubs/stubs/ext/standard/proc_terminate.stube �+ge �uO�� Q vendor/phpstan/php-8-stubs/stubs/ext/standard/http_get_last_response_headers.stubN �+gN =��Ĥ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strval.stub1 �+g1 ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/fflush.stubI �+gI d$_`� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/umask.stub2 �+g2 &� M� A vendor/phpstan/php-8-stubs/stubs/ext/standard/dns_get_record.stub �+g a[�8� < vendor/phpstan/php-8-stubs/stubs/ext/standard/is_object.stub2 �+g2 ��*j� C vendor/phpstan/php-8-stubs/stubs/ext/standard/getprotobynumber.stubc �+gc ��� < vendor/phpstan/php-8-stubs/stubs/ext/standard/microtime.stubo �+go oĕ� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/vfprintf.stubi �+gi �Aɤ H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_transports.stubJ �+gJ ���Ǥ 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��� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/next.stub6 �+g6 �U�P� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/rename.stubq �+gq ��� < vendor/phpstan/php-8-stubs/stubs/ext/standard/is_double.stubI �+gI �� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_push.stubS �+gS ^�;� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_is_list.stubG �+gG �8� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/exp.stub+ �+g+ ���ۤ < vendor/phpstan/php-8-stubs/stubs/ext/standard/php_uname.stub: �+g: ����� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/flush.stub" �+g" �E� B vendor/phpstan/php-8-stubs/stubs/ext/standard/php_user_filter.stub� �+g� b�@k� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/rtrim.stubX �+gX t1�5� : vendor/phpstan/php-8-stubs/stubs/ext/standard/phpinfo.stub� �+g� �ߒ�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/dechex.stub- �+g- �U� L vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_set_params.stub� �+g� �9 <� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/uasort.stub� �+g� VnH�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/log10.stub- �+g- n��ɤ S vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_generate_ctrl_event.stubU �+gU `��� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_socket_server.stub- �+g- g��Y� J vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_wrapper_register.stub� �+g� K$� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/prev.stub6 �+g6 ���l� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/strripos.stub[ �+g[ ��Ҥ @ vendor/phpstan/php-8-stubs/stubs/ext/standard/password_hash.stubh �+gh ��4Y� H vendor/phpstan/php-8-stubs/stubs/ext/standard/array_merge_recursive.stubC �+gC ��<� < vendor/phpstan/php-8-stubs/stubs/ext/standard/is_string.stub2 �+g2 x� < vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_alter.stub� �+g� g}�٤ 5 vendor/phpstan/php-8-stubs/stubs/ext/standard/dl.stub9 �+g9 -U~�� C vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_list_handlers.stubE �+gE DT e� = vendor/phpstan/php-8-stubs/stubs/ext/standard/str_repeat.stubC �+gC �+�� M vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_get_default.stub_ �+g_ �ؤ : vendor/phpstan/php-8-stubs/stubs/ext/standard/stripos.stubZ �+gZ BSAѤ H vendor/phpstan/php-8-stubs/stubs/ext/standard/php_ini_scanned_files.stub: �+g: W�e� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_flip.stuba �+ga %菤 : vendor/phpstan/php-8-stubs/stubs/ext/standard/shuffle.stub} �+g} ʓc~� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/sscanf.stubs �+gs
]��� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/rawurldecode.stub9 �+g9 6��� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/floatval.stub2 �+g2 �2�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/lstat.stubP �+gP ����� = vendor/phpstan/php-8-stubs/stubs/ext/standard/getlastmod.stub, �+g, ��Ӥ 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/unlink.stubi �+gi �� Ȥ D vendor/phpstan/php-8-stubs/stubs/ext/standard/ignore_user_abort.stubA �+gA ����� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/diskfreespace.stub` �+g` �k�K� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/substr_count.stubn �+gn �H� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/getmygid.stub* �+g* �5� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/rawurlencode.stub9 �+g9 ��� = vendor/phpstan/php-8-stubs/stubs/ext/standard/dns_get_mx.stub� �+g� %�� E vendor/phpstan/php-8-stubs/stubs/ext/standard/html_entity_decode.stub �+g R��{� B vendor/phpstan/php-8-stubs/stubs/ext/standard/str_starts_with.stubL �+gL ��Y� A vendor/phpstan/php-8-stubs/stubs/ext/standard/substr_replace.stub� �+g� [[�� I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_filter_register.stubU �+gU -n�� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_column.stubv �+gv %�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/srand.stub� �+g� v N�� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/pack.stubW �+gW 1��ݤ < vendor/phpstan/php-8-stubs/stubs/ext/standard/Directory.stub� �+g� t�w]� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/stripcslashes.stub: �+g: �N_X� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/rmdir.stubi �+gi pO#� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/closelog.stube �+ge I��� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/asinh.stub- �+g- ��ޤ : vendor/phpstan/php-8-stubs/stubs/ext/standard/fgetcsv.stub� �+g� �(�'� M vendor/phpstan/php-8-stubs/stubs/ext/standard/get_html_translation_table.stub� �+g� ��i� = vendor/phpstan/php-8-stubs/stubs/ext/standard/localeconv.stub? �+g? {� E vendor/phpstan/php-8-stubs/stubs/ext/standard/move_uploaded_file.stubG �+gG U�*� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/base_convert.stubT �+gT Y!t�� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/linkinfo.stub6 �+g6 ��ݍ� D vendor/phpstan/php-8-stubs/stubs/ext/standard/array_diff_uassoc.stubh �+gh ����� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/uksort.stub� �+g� DĄ�� = vendor/phpstan/php-8-stubs/stubs/ext/standard/phpcredits.stub� �+g� �� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/mt_getrandmax.stub) �+g) �ag� : vendor/phpstan/php-8-stubs/stubs/ext/standard/compact.stub� �+g� z��ؤ < vendor/phpstan/php-8-stubs/stubs/ext/standard/fileowner.stub; �+g; �Oh� : vendor/phpstan/php-8-stubs/stubs/ext/standard/is_link.stub4 �+g4 ���� F vendor/phpstan/php-8-stubs/stubs/ext/standard/array_intersect_key.stubO �+gO �釤 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/acosh.stub- �+g- �3�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_set.stub� �+g� �P� C vendor/phpstan/php-8-stubs/stubs/ext/standard/highlight_string.stub� �+g� �kb�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/gettype.stubF �+gF �_�� B vendor/phpstan/php-8-stubs/stubs/ext/standard/set_file_buffer.stub� �+g� ��OK� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/stat.stubO �+gO ,�`� < vendor/phpstan/php-8-stubs/stubs/ext/standard/lcg_value.stub3 �+g3 r�*� < vendor/phpstan/php-8-stubs/stubs/ext/standard/filectime.stub; �+g; �3�� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strspn.stubj �+gj �x�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/fprintf.stubk �+gk �U� � B vendor/phpstan/php-8-stubs/stubs/ext/standard/proc_get_status.stubh �+gh _l]� K vendor/phpstan/php-8-stubs/stubs/ext/standard/header_register_callback.stubY �+gY �q&� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/array_filter.stuba �+ga ����� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/fmod.stub: �+g: "-� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/strstr.stubh �+gh �<�� = vendor/phpstan/php-8-stubs/stubs/ext/standard/array_find.stubY �+gY �n<� > vendor/phpstan/php-8-stubs/stubs/ext/standard/ini_restore.stub6 �+g6 ik� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/log1p.stub- �+g- �`9� > vendor/phpstan/php-8-stubs/stubs/ext/standard/array_merge.stub9 �+g9 ��d� < vendor/phpstan/php-8-stubs/stubs/ext/standard/setlocale.stub� �+g� � Ib� E vendor/phpstan/php-8-stubs/stubs/ext/standard/request_parse_body.stub� �+g� ��[+� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/min.stub? �+g? ��Ԥ A vendor/phpstan/php-8-stubs/stubs/ext/standard/clearstatcache.stubk �+gk ��?� < vendor/phpstan/php-8-stubs/stubs/ext/standard/is_finite.stub0 �+g0 ��Ar� : vendor/phpstan/php-8-stubs/stubs/ext/standard/readdir.stubf �+gf ��97� < vendor/phpstan/php-8-stubs/stubs/ext/standard/filemtime.stub; �+g; �S��� : vendor/phpstan/php-8-stubs/stubs/ext/standard/fnmatch.stubi �+gi � �b� < vendor/phpstan/php-8-stubs/stubs/ext/standard/filegroup.stub; �+g; �4�� A vendor/phpstan/php-8-stubs/stubs/ext/standard/getprotobyname.stub_ �+g_ q��� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_get_status.stub[ �+g[ ӁW&� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/php_sapi_name.stub2 �+g2 ���Y� E vendor/phpstan/php-8-stubs/stubs/ext/standard/net_get_interfaces.stub� �+g� ��t1� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/ksort.stub� �+g� U��f� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/chop.stubk �+gk �� �� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/similar_text.stubw �+gw ��<� 7 vendor/phpstan/php-8-stubs/stubs/ext/standard/sha1.stubT �+gT �� ¤ : vendor/phpstan/php-8-stubs/stubs/ext/standard/explode.stub� �+g� Ҥ(M� 6 vendor/phpstan/php-8-stubs/stubs/ext/standard/dir.stubs �+gs �?�� J vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_register_wrapper.stub� �+g� ��E� G vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_filter_remove.stube �+ge 8m%� H vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_context_create.stubq �+gq R�5R� H vendor/phpstan/php-8-stubs/stubs/ext/standard/memory_get_peak_usage.stubI �+gI )�*� ? vendor/phpstan/php-8-stubs/stubs/ext/standard/str_ireplace.stub� �+g� Y�9� K vendor/phpstan/php-8-stubs/stubs/ext/standard/unregister_tick_function.stubG �+gG �{5� = vendor/phpstan/php-8-stubs/stubs/ext/standard/proc_close.stubN �+gN ��מ� A vendor/phpstan/php-8-stubs/stubs/ext/standard/highlight_file.stubX �+gX �H:�� < vendor/phpstan/php-8-stubs/stubs/ext/standard/inet_pton.stubU �+gU ɔ� � > vendor/phpstan/php-8-stubs/stubs/ext/standard/is_readable.stub8 �+g8 [K�z� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/putenv.stubH �+gH �+�V� > vendor/phpstan/php-8-stubs/stubs/ext/standard/file_exists.stub8 �+g8 ^��,� : vendor/phpstan/php-8-stubs/stubs/ext/standard/ucwords.stubX �+gX �|�Τ C vendor/phpstan/php-8-stubs/stubs/ext/standard/get_current_user.stub6 �+g6 �R� 9 vendor/phpstan/php-8-stubs/stubs/ext/standard/bindec.stub= �+g= kXa� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/array_replace.stubO �+gO |�7c� M vendor/phpstan/php-8-stubs/stubs/ext/standard/sapi_windows_vt100_support.stub� �+g� ���?� O vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_bucket_make_writeable.stub' �+g' P��Τ F vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_get_contents.stub� �+g� �0$� C vendor/phpstan/php-8-stubs/stubs/ext/standard/memory_get_usage.stubD �+gD E�N�� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/crypt.stubN �+gN �7�� : vendor/phpstan/php-8-stubs/stubs/ext/standard/bin2hex.stubC �+gC �Fۤ = vendor/phpstan/php-8-stubs/stubs/ext/standard/checkdnsrr.stubk �+gk �� 8 vendor/phpstan/php-8-stubs/stubs/ext/standard/fopen.stub� �+g� ��� @ vendor/phpstan/php-8-stubs/stubs/ext/standard/gethostbyaddr.stubC �+gC ��� H vendor/phpstan/php-8-stubs/stubs/ext/standard/array_change_key_case.stubW �+gW ��Q � > vendor/phpstan/php-8-stubs/stubs/ext/standard/gethostname.stub[ �+g[ 1)��� ; vendor/phpstan/php-8-stubs/stubs/ext/standard/ob_start.stubr �+gr }<��� I vendor/phpstan/php-8-stubs/stubs/ext/standard/stream_wrapper_restore.stubC �+gC �Ae�� A vendor/phpstan/php-8-stubs/stubs/ext/pdo_pgsql/PDO_PGSql_Ext.stubg �+gg ���� = vendor/phpstan/php-8-stubs/stubs/ext/pdo_pgsql/Pdo/Pgsql.stub[ �+g[ } 3$� A vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_shutdown.stubf �+gf ����� 8 vendor/phpstan/php-8-stubs/stubs/ext/sockets/Socket.stub@ �+g@ R�o� = vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_bind.stubW �+gW %�� C vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_cmsg_space.stubQ �+gQ \�դ F vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_import_stream.stub` �+g` �R7Ť ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_listen.stubK �+gK �%l�� C vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_set_option.stub� �+g� �� D vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_getsockname.stub� �+g� �PI2� = vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_read.stubi �+gi �qb� B vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_set_block.stub< �+g< �<!� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_select.stub� �+g� ZOޤ ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_getopt.stub� �+g� t�zV� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_accept.stubB �+gB j�դ @ vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_recvmsg.stub` �+g` ۓ��� I vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_addrinfo_connect.stubR �+gR ~HG�� Q vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_wsaprotocol_info_release.stubK �+gK �攘� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_sendto.stub� �+g� 6��q� D vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_create_pair.stub� �+g� � �l� > vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_close.stub8 �+g8 ���� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_create.stubX �+gX R �O� D vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_getpeername.stub� �+g� �x�� E vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_set_nonblock.stub? �+g? ܟ0H� F vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_create_listen.stub� �+g� �7�� = vendor/phpstan/php-8-stubs/stubs/ext/sockets/AddressInfo.stub# �+g# AA � = vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_recv.stub} �+g} �>� P vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_wsaprotocol_info_export.stubt �+gt �Pv�� 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^ [��`� P vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_wsaprotocol_info_import.stubS �+gS � �� C vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_last_error.stubK �+gK �� F vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_addrinfo_bind.stubO �+gO �I�� = vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_send.stubc �+gc N.[4� @ vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_sendmsg.stub_ �+g_ �qp
� ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_atmark.stubh �+gh �%|� C vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_get_option.stubx �+gx ]�I�� H vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_addrinfo_lookup.stub� �+g� �\ur� I vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_addrinfo_explain.stuba �+ga J� N� A vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_recvfrom.stub� �+g� �4!ˤ ? vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_setopt.stub� �+g� ĉ
� F vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_export_stream.stubX �+gX ��hP� D vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_clear_error.stubF �+gF _�{Z� > vendor/phpstan/php-8-stubs/stubs/ext/sockets/socket_write.stub` �+g` �)��� = vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMDocumentType.stubT �+gT oW=� = vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMNamedNodeMap.stub� �+g� ���� 8 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMElement.stub� �+g� ��s�� > vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMNameSpaceNode.stub �+g P�Hۤ 9 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMDocument.stub� �+g� 㖑� ; vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMParentNode.stubA �+gA ��� ? vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMImplementation.stub. �+g. ��Z� A vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMDocumentFragment.stub7 �+g7 ��Τ 5 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMNode.stub� �+g� q�'� 6 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMXPath.stub �+g ��I� 9 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMNodeList.stubC �+gC �GQ� 7 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMEntity.stub, �+g, �v��� @ vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMEntityReference.stubo �+go *��� : vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMException.stub7 �+g7 wH�� 8 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMComment.stubu �+gu p=1�� 5 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMText.stub� �+g� 8葰� B vendor/phpstan/php-8-stubs/stubs/ext/dom/dom_import_simplexml.stubK �+gK �E�� > vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMCharacterData.stub$ �+g$ !�2� : vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Notation.stub� �+g� g��L� @ vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/HTMLCollection.stub7 �+g7 h�+Z� ? vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/CharacterData.stub+ �+g+ ����� > vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/DocumentType.stub( �+g( ��(y� 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� � ? 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/CDATASection.stubQ �+gQ �fƤ 6 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Attr.stub= �+g= ��e� < vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/ParentNode.stuby �+gy ��cq� 8 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Entity.stub< �+g< }]�l� B vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/AdjacentPosition.stub� �+g� б+�� : vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Document.stub� �+g� ={�� = vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/HTMLElement.stubS �+gS �d7z� B vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/import_simplexml.stubi �+gi *E� B vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/DocumentFragment.stub� �+g� \+@m� ; vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/ChildNode.stub �+g ��Ť 7 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/XPath.stub� �+g� � � 6 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Text.stub� �+g� A : vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/NodeList.stub� �+g� )
�� 9 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Comment.stub� �+g� Ӝ� = vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/XMLDocument.stub� �+g� �R� � 9 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Element.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/HTMLDocument.stub� �+g� �q�� @ vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Implementation.stub� �+g� ����� > vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/NamedNodeMap.stub% �+g% C
(� 6 vendor/phpstan/php-8-stubs/stubs/ext/dom/Dom/Node.stub' �+g' HRvפ 9 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMNotation.stub. �+g. �c� F vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMProcessingInstruction.stub� �+g� �B�Ȥ 5 vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMAttr.stub� �+g� ����� : vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMChildNode.stubI �+gI heL� = vendor/phpstan/php-8-stubs/stubs/ext/dom/DOMCdataSection.stubl �+gl �� � P vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_end_namespace_decl_handler.stub� �+g� Շ-{� I vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_get_current_line_number.stubI �+gI �<� � E vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_element_handler.stub �+g ��;a� 7 vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parse.stub] �+g]
�N� T vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_processing_instruction_handler.stub� �+g� �{NQ� C vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parser_set_option.stub �+g I\x�� K vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_notation_decl_handler.stub� �+g� �� R vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_start_namespace_decl_handler.stub� �+g� � �"� ? vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parser_create.stubn �+gn k�P� < vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_object.stub� �+g� j���� = vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parser_free.stub> �+g> �X9ޤ C vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parse_into_struct.stube �+ge �G�� C vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parser_get_option.stub� �+g� �=�t� E vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_default_handler.stub{ �+g{ �� K vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_get_current_column_number.stubK �+gK �VJ� L vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_character_data_handler.stub� �+g� ��b� > vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_error_string.stub? �+g? wK� 7 vendor/phpstan/php-8-stubs/stubs/ext/xml/XMLParser.stub! �+g! �; A� R vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_unparsed_entity_decl_handler.stub� �+g� ||�ߤ B vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_parser_create_ns.stubh �+gh ����� Q vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_set_external_entity_ref_handler.stub� �+g� ���q� H vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_get_current_byte_index.stubH �+gH qF� @ vendor/phpstan/php-8-stubs/stubs/ext/xml/xml_get_error_code.stub@ �+g@ m��:� 7 vendor/phpstan/php-8-stubs/stubs/ext/ffi/FFI/CType.stubF+ �+gF+ ��x� ; vendor/phpstan/php-8-stubs/stubs/ext/ffi/FFI/Exception.stub: �+g: ڧ��� A vendor/phpstan/php-8-stubs/stubs/ext/ffi/FFI/ParserException.stubN �+gN 2q 0� 7 vendor/phpstan/php-8-stubs/stubs/ext/ffi/FFI/CData.stub- �+g- ���� 1 vendor/phpstan/php-8-stubs/stubs/ext/ffi/FFI.stub� �+g� �Cg� ? vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveIterator.stub �+g ���ۤ M vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveCallbackFilterIterator.stub �+g :ir&� < vendor/phpstan/php-8-stubs/stubs/ext/spl/iterator_count.stub� �+g� S4�� F vendor/phpstan/php-8-stubs/stubs/ext/spl/UnexpectedValueException.stubU �+gU � �h� > vendor/phpstan/php-8-stubs/stubs/ext/spl/RuntimeException.stubF �+gF �G�� D vendor/phpstan/php-8-stubs/stubs/ext/spl/CallbackFilterIterator.stub� �+g� � �� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/LimitIterator.stub� �+g� ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplObserver.stub� �+g� �MƵ� D vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveRegexIterator.stub� �+g� �6�&� 5 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplHeap.stubZ �+gZ 4Y`�� 9 vendor/phpstan/php-8-stubs/stubs/ext/spl/ArrayObject.stub] �+g] ��_�� 8 vendor/phpstan/php-8-stubs/stubs/ext/spl/class_uses.stub� �+g� C��� < vendor/phpstan/php-8-stubs/stubs/ext/spl/LogicException.stubc �+gc U�;� @ vendor/phpstan/php-8-stubs/stubs/ext/spl/FilesystemIterator.stubI �+gI �$� ? vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload_call.stub; �+g; {ń"� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/SplFixedArray.stub� �+g� }1�m� D vendor/phpstan/php-8-stubs/stubs/ext/spl/BadMethodCallException.stub[ �+g[ ���&� 9 vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_classes.stub@ �+g@ �n;� A vendor/phpstan/php-8-stubs/stubs/ext/spl/OutOfRangeException.stubN �+gN �"�8� D vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveArrayIterator.stubq �+gq Z)#ޤ ? vendor/phpstan/php-8-stubs/stubs/ext/spl/DirectoryIterator.stub! �+g! i�EC� A vendor/phpstan/php-8-stubs/stubs/ext/spl/SplDoublyLinkedList.stubr �+gr ��� 6 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplQueue.stub� �+g� t�V�� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/EmptyIterator.stubj �+gj Gځݤ < vendor/phpstan/php-8-stubs/stubs/ext/spl/AppendIterator.stub� �+g� YT��� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/class_parents.stub� �+g� �LwH� C vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveTreeIterator.stubV
�+gV
41�?� : vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload.stubW �+gW 5��=� G vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveIteratorIterator.stub� �+g� _T�q� < vendor/phpstan/php-8-stubs/stubs/ext/spl/FilterIterator.stub� �+g� ��Ź� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/ArrayIterator.stub� �+g� u�P� = vendor/phpstan/php-8-stubs/stubs/ext/spl/DomainException.stubJ �+gJ �|HR� = vendor/phpstan/php-8-stubs/stubs/ext/spl/LengthException.stubJ �+gJ 2��?� H vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveDirectoryIterator.stub� �+g� �t6� < vendor/phpstan/php-8-stubs/stubs/ext/spl/iterator_apply.stubi �+gi ���� : vendor/phpstan/php-8-stubs/stubs/ext/spl/GlobIterator.stubc �+gc
���� = vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_object_hash.stub< �+g< x~��� > vendor/phpstan/php-8-stubs/stubs/ext/spl/SeekableIterator.stub� �+g� �֤ E vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload_unregister.stubF �+gF ���W� D vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload_functions.stub4 �+g4 mp�i� > vendor/phpstan/php-8-stubs/stubs/ext/spl/MultipleIterator.stubi
�+gi
cX䌤 9 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplFileInfo.stub� �+g� ���Y� E vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload_extensions.stubU �+gU c
��� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/SplFileObject.stub� �+g� �� z� B vendor/phpstan/php-8-stubs/stubs/ext/spl/OutOfBoundsException.stubQ �+gQ $ �"� 8 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplMinHeap.stub� �+g� �] �� < vendor/phpstan/php-8-stubs/stubs/ext/spl/ParentIterator.stub7 �+g7 ��ml� ; vendor/phpstan/php-8-stubs/stubs/ext/spl/OuterIterator.stub� �+g� = =� = vendor/phpstan/php-8-stubs/stubs/ext/spl/CachingIterator.stub� �+g� ��� F vendor/phpstan/php-8-stubs/stubs/ext/spl/InvalidArgumentException.stubS �+gS �W�� ? vendor/phpstan/php-8-stubs/stubs/ext/spl/SplTempFileObject.stub� �+g� ��hv� 8 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplSubject.stubj �+gj �r�Ϥ ; vendor/phpstan/php-8-stubs/stubs/ext/spl/RegexIterator.stub�
�+g�
�1�� > vendor/phpstan/php-8-stubs/stubs/ext/spl/SplObjectStorage.stubX
�+gX
��ɤ C vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_autoload_register.stubw �+gw �n�{� > vendor/phpstan/php-8-stubs/stubs/ext/spl/NoRewindIterator.stub� �+g� �Km�� F vendor/phpstan/php-8-stubs/stubs/ext/spl/BadFunctionCallException.stubS �+gS 7}Ҥ @ vendor/phpstan/php-8-stubs/stubs/ext/spl/UnderflowException.stubO �+gO ��A�� ? vendor/phpstan/php-8-stubs/stubs/ext/spl/iterator_to_array.stub� �+g� :6Yؤ > vendor/phpstan/php-8-stubs/stubs/ext/spl/SplPriorityQueue.stub� �+g� x��^� ? vendor/phpstan/php-8-stubs/stubs/ext/spl/OverflowException.stubN �+gN ���Ƥ 8 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplMaxHeap.stub� �+g� C�0� F vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveCachingIterator.stub� �+g� ��)�� 6 vendor/phpstan/php-8-stubs/stubs/ext/spl/SplStack.stub7 �+g7 >��� > vendor/phpstan/php-8-stubs/stubs/ext/spl/InfiniteIterator.stub� �+g� 3VH� > vendor/phpstan/php-8-stubs/stubs/ext/spl/IteratorIterator.stub, �+g, �h絤 > vendor/phpstan/php-8-stubs/stubs/ext/spl/class_implements.stub� �+g� qNl@� E vendor/phpstan/php-8-stubs/stubs/ext/spl/RecursiveFilterIterator.stub� �+g� � � ; vendor/phpstan/php-8-stubs/stubs/ext/spl/spl_object_id.stub7 �+g7 [
3� < vendor/phpstan/php-8-stubs/stubs/ext/spl/RangeException.stubK �+gK �7gͤ I vendor/phpstan/php-8-stubs/stubs/ext/gettext/bind_textdomain_codeset.stubC �+gC E�މ� : vendor/phpstan/php-8-stubs/stubs/ext/gettext/dgettext.stubF �+gF �;�� 9 vendor/phpstan/php-8-stubs/stubs/ext/gettext/gettext.stub5 �+g5 R9ג� ; 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/bindtextdomain.stub� �+g� ��h�� ; vendor/phpstan/php-8-stubs/stubs/ext/gettext/dcgettext.stubV �+gV r-�T� : vendor/phpstan/php-8-stubs/stubs/ext/gettext/ngettext.stubh �+gh ��ٵ� < vendor/phpstan/php-8-stubs/stubs/ext/gettext/dcngettext.stub� �+g� ����� < vendor/phpstan/php-8-stubs/stubs/ext/gettext/textdomain.stub� �+g� �Ǖ� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_lsub.stub� �+g� � ݤ 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_8bit.stub< �+g< ��W� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mail.stub� �+g� c�p|� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_thread.stub� �+g� v��W� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_rename.stub �+g � X֤ ; vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_timeout.stubQ �+gQ ϔnФ = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetchtext.stub- �+g- �er�� < vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_listscan.stub �+g !I�ۤ = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mail_copy.stub �+g �t�� > vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_last_error.stub4 �+g4 ��� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_createmailbox.stub� �+g� # �%� > vendor/phpstan/php-8-stubs/stubs/ext/imap/IMAP/Connection.stubw �+gw ̑^f� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_utf8_to_mutf7.stub\ �+g\ ��h� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_delete.stubr �+gr ǖ{� ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetchheader.stub �+g ��� H vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_rfc822_parse_adrlist.stub_ �+g_ ��c� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_search.stub- �+g- R-<j� 9 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_close.stub- �+g- J��]� ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_listmailbox.stub3 �+g3 h��k� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_open.stub� �+g� �D�� 9 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_msgno.stub� �+g� ^7.� B vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetch_overview.stub �+g �+�� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_body.stub� �+g� ���� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_reopen.stub
�+g
7:o�� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_utf8.stubA �+gA � t� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetchmime.stub �+g �"��� B vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_clearflag_full.stub� �+g� �cڤ ; vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_num_msg.stub� �+g� b�1� F vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mime_header_decode.stubP �+gP plr� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_base64.stub> �+g> �T'� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_ping.stub� �+g� I@�@� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetchbody.stub �+g �$� @ vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mail_compose.stubT �+gT �0�� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_getsubscribed.stub �+g � : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_setacl.stub �+g �9v� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_getacl.stub� �+g� ��k� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_subscribe.stub� �+g� -�f�� B vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_listsubscribed.stub9 �+g9 �?9:� ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_utf7_encode.stub= �+g= N� � ; vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_expunge.stub �+g Ρ�� ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_unsubscribe.stub� �+g� '�{J� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_get_quota.stubI �+gI R�<� H vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_rfc822_parse_headers.stubp �+gp �ó� H vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_rfc822_write_address.stubq �+gq �ٹ� ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_utf7_decode.stubC �+gC ��b5� ; vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_is_open.stubP �+gP ��z� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_binary.stub> �+g> �s� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mutf7_to_utf8.stubE �+gE �:ܤ = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_set_quota.stub� �+g� �� �� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_create.stub �+g �e6� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_alerts.stub/ �+g/ ���� 7 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_uid.stub� �+g� �*�� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_list.stub� �+g� REȤ 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_scan.stubO �+gO ^BeM� > vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_bodystruct.stub �+g �
Z�� < vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_savebody.stubu �+gu Q��p� > vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_headerinfo.stubC �+gC }V�@� 6 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_gc.stub �+g !װ� B vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_fetchstructure.stub
�+g
��`� < vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_undelete.stubx �+gx ��>$� > vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_num_recent.stub� �+g� E�67� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_qprint.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_append.stubU �+gU ��(^� @ vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_getmailboxes.stub �+g ��Ӥ @ vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_setflag_full.stub� �+g� q�hA� B vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mailboxmsginfo.stub� �+g� 28�� 9 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_check.stub� �+g� �?8� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_status.stub �+g (%2�� = vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_mail_move.stub �+g �)Ԥ ? vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_scanmailbox.stub] �+g] ?��� 8 vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_sort.stub} �+g} �-?ܤ A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_deletemailbox.stub� �+g� �*ɧ� : vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_errors.stub/ �+g/ �r��� ; vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_headers.stub� �+g� a �� A vendor/phpstan/php-8-stubs/stubs/ext/imap/imap_get_quotaroot.stub� �+g� �ž� 6 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_sync.stub� �+g� �[�� ; vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_key_split.stubG �+gG �P�� 7 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_close.stub� �+g� ٻ��� : vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_handlers.stubX �+gX N�+b� 7 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_popen.stub� �+g� �% ޤ < 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_fetch.stub� �+g� ��Iؤ 6 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_open.stubk �+gk �f� 9 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_nextkey.stub� �+g� �T�̤ 8 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_exists.stubK �+gK �l � : vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_firstkey.stub� �+g� ���� 9 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_replace.stub{ �+g{ ��B� : vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_optimize.stub� �+g� R��� 8 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_insert.stubx �+gx 9#$�� 6 vendor/phpstan/php-8-stubs/stubs/ext/dba/dba_list.stub& �+g& �� D vendor/phpstan/php-8-stubs/stubs/ext/simplexml/SimpleXMLElement.stub� �+g� ��� E vendor/phpstan/php-8-stubs/stubs/ext/simplexml/SimpleXMLIterator.stub= �+g=
�� I vendor/phpstan/php-8-stubs/stubs/ext/simplexml/simplexml_load_string.stub� �+g� �s,� H vendor/phpstan/php-8-stubs/stubs/ext/simplexml/simplexml_import_dom.stub# �+g# �u�֤ G vendor/phpstan/php-8-stubs/stubs/ext/simplexml/simplexml_load_file.stub� �+g� ��� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_pow.stubG �+gG ���� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_cmp.stubO �+gO Ѓ�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_add.stubP �+gP �<� 7 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_scan0.stubF �+gF H V� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_lcm.stubP �+gP �Z�%� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_div_qr.stub� �+g� �
*� : vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_binomial.stubC �+gC ��
�� 7 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_div_r.stubw �+gw lo9?� = 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� : vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_divexact.stubU �+gU ���j� 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_fact.stub9 �+g9 �B烤 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_and.stubP �+gP cmΒ� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_clrbit.stub< �+g< � -ؤ < vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_prob_prime.stubU �+gU ��Y� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_xor.stubP �+gP ɐm� 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_sign.stub8 �+g8 ��}�� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_intval.stub: �+g: �Z�� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_jacobi.stubR �+gR ��j� 7 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_div_q.stubw �+gw �w�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_com.stub8 �+g8 S�Դ� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_sub.stubP �+gP �Ai�� 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_import.stubw �+gw [�Y�� 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_sqrt.stub9 �+g9 2�H�� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_setbit.stubP �+gP
+� � 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_init.stubC �+gC '¿J� ? vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_perfect_power.stubB �+gB �IqΤ 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_gcd.stubP �+gP �6�� ; vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_nextprime.stub> �+g> �� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_strval.stubM �+gM �O-�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_abs.stub8 �+g8 ܕp�� : vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_legendre.stubT �+gT ���N� 9 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_hamdist.stubS �+gS 0)�"� 9 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_sqrtrem.stubT �+gT �^�� ; vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_kronecker.stubU �+gU �#¤ 7 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_scan1.stubF �+gF 6��� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_gcdext.stubk �+gk ~�?0� 8 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_invert.stubY �+gY ^ �� 4 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_or.stubO �+gO N4� 9 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_testbit.stubH �+gH aO�X� > vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_random_range.stubW �+gW �-�� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_mod.stubP �+gP P�Z� @ vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_perfect_square.stubC �+gC eE*0� 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_powm.stubn �+gn zR�� : vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_popcount.stub< �+g< =��5� 1 vendor/phpstan/php-8-stubs/stubs/ext/gmp/GMP.stub< �+g< ��(� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_neg.stub8 �+g8 ��� 6 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_root.stubC �+gC F���� 9 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_rootrem.stub^ �+g^ s�e`� 5 vendor/phpstan/php-8-stubs/stubs/ext/gmp/gmp_mul.stubP �+gP �F�F� ? vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_prompt.stub8 �+g8 5�S�� E vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_break_method.stubM �+gM J� = vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_exec.stub> �+g> �e� > 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� C vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_break_file.stubE �+gE r;�c� C vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_break_next.stubP �+gP �dL,� B vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_end_oplog.stubB �+gB o�q� G vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_break_function.stubB �+gB {�&�� D vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_start_oplog.stub/ �+g/ )�N� > vendor/phpstan/php-8-stubs/stubs/sapi/phpdbg/phpdbg_clear.stub) �+g) jw��� < 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 ���� 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 �� Ϥ B vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/getallheaders.stubS �+gS ��g� O vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/litespeed_response_headers.stub> �+g> ��j�� N vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/litespeed_request_headers.stubY �+gY �4S� M vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/litespeed_finish_request.stub5 �+g5 g�R,� L vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/apache_response_headers.stubd �+gd ��cL� K vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/apache_request_headers.stub\ �+g\ �8� G vendor/phpstan/php-8-stubs/stubs/sapi/litespeed/apache_get_modules.stub0 �+g0 ��7Ҥ < 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 ���� 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_set_process_title.stub? �+g? <k�m� D vendor/phpstan/php-8-stubs/stubs/sapi/cli/cli_get_process_title.stub5 �+g5 |�}p� @ vendor/phpstan/php-8-stubs/stubs/sapi/fpm/fpm/getallheaders.stubP �+gP ��(�� 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��� G vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_setenv.stubd �+gd K�ݤ G vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/getallheaders.stubP �+gP ��(�� G vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_getenv.stub] �+g] �]3� K vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_lookup_uri.stubh �+gh kz-� E vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_note.stub] �+g] 7��d� Q vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_response_headers.stub5 �+g5 ���� P vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_request_headers.stub4 �+g4 DhH:� L vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_get_version.stub7 �+g7 >��֤ L vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/apache_get_modules.stub0 �+g0 ��7Ҥ A vendor/phpstan/php-8-stubs/stubs/sapi/apache2handler/virtual.stub/ �+g/ {X�Ӥ + vendor/phpstan/php-8-stubs/Php8StubsMap.php�� �+g�� *4 ڤ preload.phpt� �+gt� �D�[� 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
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.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.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.level6.neon
parameters:
checkUnionTypes: true
reportMaybes: true
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\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%
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:
- 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.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.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.level8.neon
parameters:
checkExplicitMixed: true
includes:
- config.level9.neon
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
includes:
- config.level7.neon
parameters:
checkNullables: true
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\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\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\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\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
<?php
namespace _PHPStan_6dcda722c;
// 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_6dcda722c;
// 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_6dcda722c;
// 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
namespace _PHPStan_6dcda722c;
// 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', '&rw_var_array' => 'array', 'extract_type=' => '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 // @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 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/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', '&rw_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' => ['Closure', 'old'=>'Closure', 'to'=>'?object', 'scope='=>'object|string|null'],
'Closure::bindTo' => ['Closure', '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' => ['DOMAttr', 'name'=>'string'],
'DOMDocument::createAttributeNS' => ['DOMAttr', 'namespaceuri'=>'string', 'qualifiedname'=>'string'],
'DOMDocument::createCDATASection' => ['DOMCDATASection', 'data'=>'string'],
'DOMDocument::createComment' => ['DOMComment', 'data'=>'string'],
'DOMDocument::createDocumentFragment' => ['DOMDocumentFragment'],
'DOMDocument::createElement' => ['DOMElement', 'name'=>'string', 'value='=>'string'],
'DOMDocument::createElementNS' => ['DOMElement', 'namespaceuri'=>'string', 'qualifiedname'=>'string', 'value='=>'string'],
'DOMDocument::createEntityReference' => ['DOMEntityReference', 'name'=>'string'],
'DOMDocument::createProcessingInstruction' => ['DOMProcessingInstruction', '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', '&rw_var_array'=>'array', 'extract_type='=>'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', '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-empty-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-empty-string|false', 'algo'=>'string', 'filename'=>'string', 'raw_output='=>'bool'],
'hash_final' => ['non-empty-string', 'context'=>'HashContext', 'raw_output='=>'bool'],
'hash_hkdf' => ['non-empty-string|false', 'algo'=>'string', 'key'=>'string', 'length='=>'int', 'info='=>'string', 'salt='=>'string'],
'hash_hmac' => ['non-empty-string|false', 'algo'=>'string', 'data'=>'string', 'key'=>'string', 'raw_output='=>'bool'],
'hash_hmac_algos' => ['non-empty-list<non-falsy-string>'],
'hash_hmac_file' => ['non-empty-string|false', 'algo'=>'string', 'filename'=>'string', 'key'=>'string', 'raw_output='=>'bool'],
'hash_init' => ['HashContext', 'algo'=>'string', 'options='=>'int', 'key='=>'string'],
'hash_pbkdf2' => ['non-empty-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' => ['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', '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', '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' => ['void', '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' => ['int|false'],
'ReflectionClass::getExtension' => ['ReflectionExtension|null'],
'ReflectionClass::getExtensionName' => ['string|false'],
'ReflectionClass::getFileName' => ['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' => ['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' => ['int|false'],
'ReflectionFunction::getExtension' => ['ReflectionExtension|null'],
'ReflectionFunction::getExtensionName' => ['string|false'],
'ReflectionFunction::getFileName' => ['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' => ['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' => ['int|false'],
'ReflectionFunctionAbstract::getExtension' => ['ReflectionExtension|null'],
'ReflectionFunctionAbstract::getExtensionName' => ['string|false'],
'ReflectionFunctionAbstract::getFileName' => ['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' => ['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'],
'setproctitle' => ['void', 'title'=>'string'],
'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'],
'sha256' => ['string', 'str'=>'string', 'raw_output='=>'bool'],
'sha256_file' => ['string', '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', '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' => ['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'],
];
//
// 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:: 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_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_6dcda722c;
// 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
namespace _PHPStan_6dcda722c;
// 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 // 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-empty-string', 'algo'=>'string', 'data'=>'string', 'key'=>'string', 'raw_output='=>'bool'],
'hash_pbkdf2' => ['non-empty-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-empty-string|false', 'algo'=>'string', 'data'=>'string', 'raw_output='=>'bool'],
'hash_hkdf' => ['non-empty-string|false', 'algo'=>'string', 'key'=>'string', 'length='=>'int', 'info='=>'string', 'salt='=>'string'],
'hash_hmac' => ['non-empty-string|false', 'algo'=>'string', 'data'=>'string', 'key'=>'string', 'raw_output='=>'bool'],
'hash_pbkdf2' => ['non-empty-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'],
]
];
<?php
declare (strict_types=1);
namespace _PHPStan_6dcda722c;
use PHPStan\Command\AnalyseCommand;
use PHPStan\Command\ClearResultCacheCommand;
use PHPStan\Command\DiagnoseCommand;
use PHPStan\Command\DumpParametersCommand;
use PHPStan\Command\FixerWorkerCommand;
use PHPStan\Command\WorkerCommand;
use PHPStan\Internal\ComposerHelper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\ProgressBar;
(function () {
\error_reporting(\E_ALL & ~\E_DEPRECATED);
\ini_set('display_errors', 'stderr');
if (\version_compare(\PHP_VERSION, '7.4.0', '<')) {
// PHP earlier than 7.4.x with OpCache triggers a bug when we intercept
// custom autoloaders' reads to discover file paths. See PHPStan #4881.
\ini_set('opcache.enable', 'Off');
}
if (\PHP_VERSION_ID < 70300) {
\gc_disable();
// performance boost
}
\define('__PHPSTAN_RUNNING__', \true);
$analysisStartTime = \microtime(\true);
$devOrPharLoader = (require_once 'phar://phpstan.phar/vendor/autoload.php');
require_once 'phar://phpstan.phar/preload.php';
$composer = ComposerHelper::getComposerConfig(\getcwd());
if ($composer !== null) {
$vendorDirectory = ComposerHelper::getVendorDirFromComposerConfig(\getcwd(), $composer);
} else {
$vendorDirectory = \getcwd() . '/' . 'vendor';
}
$devOrPharLoader->unregister();
$composerAutoloadFiles = $GLOBALS['__composer_autoload_files'];
if (!\array_key_exists('e88992873b7765f9b5710cab95ba5dd7', $composerAutoloadFiles) || !\array_key_exists('3e76f7f02b41af8cea96018933f6b7e3', $composerAutoloadFiles) || !\array_key_exists('a4a119a56e50fbb293281d9a48007e0e', $composerAutoloadFiles) || !\array_key_exists('0e6d7bf4a5811bfa5cf40c5ccd6fae6a', $composerAutoloadFiles) || !\array_key_exists('e69f7f6ee287b969198c3c9d6777bd38', $composerAutoloadFiles) || !\array_key_exists('0d59ee240a4cd96ddbb4ff164fccea4d', $composerAutoloadFiles) || !\array_key_exists('b686b8e46447868025a15ce5d0cb2634', $composerAutoloadFiles) || !\array_key_exists('8825ede83f2f289127722d4e842cf7e8', $composerAutoloadFiles) || !\array_key_exists('23c18046f52bef3eea034657bafda50f', $composerAutoloadFiles)) {
echo "Composer autoloader changed\n";
exit(1);
}
// empty the global variable so that unprefixed functions from user-space can be loaded
$GLOBALS['__composer_autoload_files'] = [
// fix unprefixed Hoa namespace - files already loaded
'e88992873b7765f9b5710cab95ba5dd7' => \true,
'3e76f7f02b41af8cea96018933f6b7e3' => \true,
// vendor/symfony/polyfill-php80/bootstrap.php
'a4a119a56e50fbb293281d9a48007e0e' => \true,
// vendor/symfony/polyfill-mbstring/bootstrap.php
'0e6d7bf4a5811bfa5cf40c5ccd6fae6a' => \true,
// vendor/symfony/polyfill-intl-normalizer/bootstrap.php
'e69f7f6ee287b969198c3c9d6777bd38' => \true,
// vendor/symfony/polyfill-php73/bootstrap.php
'0d59ee240a4cd96ddbb4ff164fccea4d' => \true,
// vendor/symfony/polyfill-php74/bootstrap.php
'b686b8e46447868025a15ce5d0cb2634' => \true,
// vendor/symfony/polyfill-intl-grapheme/bootstrap.php
'8825ede83f2f289127722d4e842cf7e8' => \true,
// vendor/symfony/polyfill-php81/bootstrap.php
'23c18046f52bef3eea034657bafda50f' => \true,
];
$autoloaderInWorkingDirectory = $vendorDirectory . '/autoload.php';
$composerAutoloaderProjectPaths = [];
/** @var array<callable>|false $autoloadFunctionsBefore */
$autoloadFunctionsBefore = \spl_autoload_functions();
if (@\is_file($autoloaderInWorkingDirectory)) {
$composerAutoloaderProjectPaths[] = \dirname($autoloaderInWorkingDirectory, 2);
require_once $autoloaderInWorkingDirectory;
}
$path = \dirname(__DIR__, 3) . '/autoload.php';
if (!\extension_loaded('phar')) {
if (@\is_file($path)) {
$composerAutoloaderProjectPaths[] = \dirname($path, 2);
require_once $path;
}
} else {
$pharPath = \Phar::running(\false);
if ($pharPath === '') {
if (@\is_file($path)) {
$composerAutoloaderProjectPaths[] = \dirname($path, 2);
require_once $path;
}
} else {
$path = \dirname($pharPath, 3) . '/autoload.php';
if (@\is_file($path)) {
$composerAutoloaderProjectPaths[] = \dirname($path, 2);
require_once $path;
}
}
}
/** @var array<callable>|false $autoloadFunctionsAfter */
$autoloadFunctionsAfter = \spl_autoload_functions();
if ($autoloadFunctionsBefore !== \false && $autoloadFunctionsAfter !== \false) {
$newAutoloadFunctions = [];
foreach ($autoloadFunctionsAfter as $after) {
if (\is_array($after) && \count($after) > 0) {
if (\is_object($after[0]) && \get_class($after[0]) === \Composer\Autoload\ClassLoader::class) {
continue;
}
if ($after[0] === 'PHPStan\\PharAutoloader') {
continue;
}
}
foreach ($autoloadFunctionsBefore as $before) {
if ($after === $before) {
continue 2;
}
}
$newAutoloadFunctions[] = $after;
}
$GLOBALS['__phpstanAutoloadFunctions'] = $newAutoloadFunctions;
}
$devOrPharLoader->register(\true);
$application = new \_PHPStan_6dcda722c\Symfony\Component\Console\Application('PHPStan - PHP Static Analysis Tool', ComposerHelper::getPhpStanVersion());
$application->setDefaultCommand('analyse');
ProgressBar::setFormatDefinition('file_download', ' [%bar%] %percent:3s%% %fileSize%');
$composerAutoloaderProjectPaths = \array_map(function (string $s) : string {
return \str_replace(\DIRECTORY_SEPARATOR, '/', $s);
}, $composerAutoloaderProjectPaths);
$reversedComposerAutoloaderProjectPaths = \array_values(\array_unique(\array_reverse($composerAutoloaderProjectPaths)));
$application->add(new AnalyseCommand($reversedComposerAutoloaderProjectPaths, $analysisStartTime));
$application->add(new WorkerCommand($reversedComposerAutoloaderProjectPaths));
$application->add(new ClearResultCacheCommand($reversedComposerAutoloaderProjectPaths));
$application->add(new FixerWorkerCommand($reversedComposerAutoloaderProjectPaths));
$application->add(new DumpParametersCommand($reversedComposerAutoloaderProjectPaths));
$application->add(new DiagnoseCommand($reversedComposerAutoloaderProjectPaths));
$application->run();
})();
<?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;
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;
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;
final class NullRelativePathHelper implements \PHPStan\File\RelativePathHelper
{
public function getRelativePath(string $filename) : string
{
return $filename;
}
}
<?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_6dcda722c\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 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_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 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 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 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;
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;
interface FileExcluderRawFactory
{
/**
* @param string[] $analyseExcludes
*/
public function create(array $analyseExcludes) : \PHPStan\File\FileExcluder;
}
<?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;
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 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 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;
use _PHPStan_6dcda722c\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 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;
/**
* @return array<int, callable(string): void>
*/
function autoloadFunctions() : array
{
return $GLOBALS['__phpstanAutoloadFunctions'] ?? [];
}
<?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 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 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 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\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 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 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\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 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\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 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 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\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 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 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 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 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 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\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 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\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 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 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\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 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 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\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 _PHPStan_6dcda722c\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 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 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 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 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 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 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 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 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 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\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 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 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;
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;
/** @api */
interface FileRuleError extends \PHPStan\Rules\RuleError
{
public function getFile() : string;
public function getFileDescription() : string;
}
<?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\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\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\Api;
use _PHPStan_6dcda722c\Nette\Utils\Json;
use _PHPStan_6dcda722c\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\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\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\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 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;
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 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 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\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 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\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 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 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\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()',
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 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 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 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;
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 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;
use PhpParser\Node;
interface Registry
{
/**
* @template TNodeType of Node
* @phpstan-param class-string<TNodeType> $nodeType
* @param Node $nodeType
* @phpstan-return array<Rule<TNodeType>>
* @return Rule[]
*/
public function getRules(string $nodeType) : array;
}
<?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;
/** @api */
interface MetadataRuleError extends \PHPStan\Rules\RuleError
{
/**
* @return mixed[]
*/
public function getMetadata() : array;
}
<?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 $i => $arg) {
$type = $scope->getType($arg->value);
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) {
$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 $i => [$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) {
$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\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 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\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 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 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\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 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 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;
/**
* @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 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\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\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 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\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;
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\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 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\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\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 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\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 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 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>
*/
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\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\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;
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\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\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\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\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\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;
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\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\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;
/**
* @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 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\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 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 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\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\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 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\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 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\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 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\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 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 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\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\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 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\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\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\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\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\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 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\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 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 Attribute;
use PhpParser\Node;
use PHPStan\Analyser\Scope;
use PHPStan\Rules\AttributesCheck;
use PHPStan\Rules\Rule;
/**
* @implements Rule<Node\Stmt\ClassLike>
*/
final class ClassAttributesRule implements Rule
{
/**
* @var AttributesCheck
*/
private $attributesCheck;
public function __construct(AttributesCheck $attributesCheck)
{
$this->attributesCheck = $attributesCheck;
}
public function getNodeType() : string
{
return Node\Stmt\ClassLike::class;
}
public function processNode(Node $node, Scope $scope) : array
{
return $this->attributesCheck->check($scope, $node->attrGroups, Attribute::TARGET_CLASS, 'class');
}
}
<?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\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 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\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\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\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());
}
}
<?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) : array
{
$errors = [];
$isPure = $functionReflection->isPure();
$isConstructor = \false;
if ($functionReflection instanceof ExtendedMethodReflection && $functionReflection->getDeclaringClass()->hasConstructor() && $functionReflection->getDeclaringClass()->getConstructor()->getName() === $functionReflection->getName()) {
$isConstructor = \true;
}
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\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());
}
}
<?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\Regexp;
use _PHPStan_6dcda722c\Nette\Utils\RegexpException;
use _PHPStan_6dcda722c\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;
/** @api */
interface RuleError
{
public function getMessage() : string;
}
<?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\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 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 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\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 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\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\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;
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\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;
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\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 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 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 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\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\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\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\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\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\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 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\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\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;
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\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() || $rightType->isConstantScalarValue()->yes() && !$rightType->isString()->no() && !$leftType->isConstantScalarValue()->yes() && !$leftType->isString()->no() && TrinaryLogic::extremeIdentity($leftType->isLowercaseString(), $rightType->isLowercaseString())->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\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 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 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 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\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 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;
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 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;
/** @api */
interface IdentifierRuleError extends \PHPStan\Rules\RuleError
{
public function getIdentifier() : string;
}
<?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\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\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\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;
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\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\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;
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;
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
* @phpstan-param class-string<TNodeType> $nodeType
* @param Node $nodeType
* @phpstan-return array<Rule<TNodeType>>
* @return Rule[]
*/
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;
}
/**
* @phpstan-var array<Rule<TNodeType>> $selectedRules
* @var Rule[] $selectedRules
*/
$selectedRules = $this->cache[$nodeType];
return $selectedRules;
}
}
<?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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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;
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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\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;
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
* @phpstan-template TNodeType of Node
*/
interface Rule
{
/**
* @phpstan-return class-string<TNodeType>
*/
public function getNodeType() : string;
/**
* @phpstan-param TNodeType $node
* @return (string|RuleError)[] errors
*/
public function processNode(Node $node, Scope $scope) : array;
}
<?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\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 PHPStan\Analyser\Scope;
use PHPStan\Collectors\Collector;
use PHPStan\Node\MethodReturnStatementsNode;
use function count;
use function strtolower;
/**
* @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 (strtolower($method->getName()) !== '__construct') {
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 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\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 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\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;
}
$declaringClass = $method->getDeclaringClass();
if ($declaringClass->hasConstructor() && $declaringClass->getConstructor()->getName() === $method->getName()) {
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 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\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 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\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 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 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\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\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 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;
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
* @phpstan-param class-string<TNodeType> $nodeType
* @param Node $nodeType
* @phpstan-return array<Rule<TNodeType>>
* @return Rule[]
*/
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;
}
/**
* @phpstan-var array<Rule<TNodeType>> $selectedRules
* @var Rule[] $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\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 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\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\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\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\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\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\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 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\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 _PHPStan_6dcda722c\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\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 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 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\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\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\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;
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\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 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\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\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\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 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\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;
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\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;
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 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\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 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\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\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 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\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 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;
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\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 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\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 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 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\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\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\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\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 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\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 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 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 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\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 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\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\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 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 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\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;
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 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\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;
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 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\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 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\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\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\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 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;
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 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;
/**
* @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\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\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\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 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\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\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 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 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\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\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;
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\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\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\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\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;
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;
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;
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\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($type->getIterableValueType());
}
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) {
$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;
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 . ' constructorinvoked 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 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;
/** @api */
interface NonIgnorableRuleError extends \PHPStan\Rules\RuleError
{
}
<?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 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\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 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\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 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\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\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 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\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\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\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 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 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\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 PHPStan\Rules\IdentifierRuleError;
use PHPStan\Rules\RuleErrorBuilder;
use PHPStan\ShouldNotHappenException;
use PHPStan\Type\Generic\GenericObjectType;
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 GenericObjectType[]
*/
private function getGenericTypes(Type $phpDocType) : array
{
$genericObjectTypes = [];
TypeTraverser::map($phpDocType, static function (Type $type, callable $traverse) use(&$genericObjectTypes) : Type {
if ($type instanceof GenericObjectType) {
$resolvedType = TemplateTypeHelper::resolveToBounds($type);
if (!$resolvedType instanceof GenericObjectType) {
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\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 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\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 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\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\Whitespace;
use _PHPStan_6dcda722c\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;
/** @api */
interface LineRuleError extends \PHPStan\Rules\RuleError
{
public function getLine() : int;
}
<?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\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\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;
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\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\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\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\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\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;
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\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\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 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\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 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\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 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\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\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 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\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 _PHPStan_6dcda722c\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\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 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\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 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\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\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 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 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\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\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;
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 PhpParser\Node\Expr;
use PHPStan\Analyser\Scope;
use PHPStan\Node\Expr\GetOffsetValueTypeExpr;
use PHPStan\PhpDoc\Tag\VarTag;
use PHPStan\Rules\IdentifierRuleError;
use PHPStan\Rules\RuleErrorBuilder;
use PHPStan\Type\ArrayType;
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 bool
*/
private $checkTypeAgainstPhpDocType;
/**
* @var bool
*/
private $strictWideningCheck;
public function __construct(bool $checkTypeAgainstPhpDocType, bool $strictWideningCheck)
{
$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($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($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(Node\Expr $expr, Type $type, Type $varTagType) : bool
{
if ($expr instanceof Expr\Array_) {
if ($expr->items === []) {
$type = new ArrayType(new MixedType(), new MixedType());
}
return $type->isSuperTypeOf($varTagType)->no();
}
if ($expr instanceof Expr\ConstFetch) {
return $type->isSuperTypeOf($varTagType)->no();
}
if ($expr instanceof Node\Scalar) {
return $type->isSuperTypeOf($varTagType)->no();
}
if ($expr instanceof Expr\New_) {
if ($type instanceof GenericObjectType) {
$type = new ObjectType($type->getClassName());
}
}
return $this->checkType($type, $varTagType);
}
private function checkType(Type $type, Type $varTagType, int $depth = 0) : bool
{
if ($this->strictWideningCheck) {
return !$type->isSuperTypeOf($varTagType)->yes();
}
if ($type->isConstantArray()->yes()) {
if ($type->isIterableAtLeastOnce()->no()) {
$type = new ArrayType(new MixedType(), new MixedType());
return $type->isSuperTypeOf($varTagType)->no();
}
}
if ($type->isIterable()->yes() && $varTagType->isIterable()->yes()) {
if ($type->isSuperTypeOf($varTagType)->no()) {
return \true;
}
$innerType = $type->getIterableValueType();
$innerVarTagType = $varTagType->getIterableValueType();
if ($type->equals($innerType) || $varTagType->equals($innerVarTagType)) {
return !$innerType->isSuperTypeOf($innerVarTagType)->yes();
}
return $this->checkType($innerType, $innerVarTagType, $depth + 1);
}
if ($type->isConstantValue()->yes() && $depth === 0) {
return $type->isSuperTypeOf($varTagType)->no();
}
return !$type->isSuperTypeOf($varTagType)->yes();
}
}
<?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 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 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\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\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\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 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) {
continue;
}
$returnTypes[] = $returnStatement->getScope()->getType($returnNode->expr);
}
if (count($returnTypes) === 0) {
return [];
}
$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;
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\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\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 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) {
continue;
}
$returnTypes[] = $returnStatement->getScope()->getType($returnNode->expr);
}
if (count($returnTypes) === 0) {
return [];
}
$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\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\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\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 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\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\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\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\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\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\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\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\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\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;
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_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\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\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\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 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 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 = [];
/**
* @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
{
foreach ($this->methodsClassReflectionExtensions as $extension) {
if ($extension->hasMethod($this, $methodName)) {
return \true;
}
}
if ($this->requireExtendsMethodsClassReflectionExtension->hasMethod($this, $methodName)) {
return \true;
}
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();
$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);
}
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();
$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::resolveToBounds($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;
/** @api */
interface NamespaceAnswerer
{
/**
* @return non-empty-string|null
*/
public function getNamespace() : ?string;
}
<?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\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\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\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\BetterReflection;
use Closure;
use _PHPStan_6dcda722c\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 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\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\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 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 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\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 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 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\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 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 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;
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_6dcda722c\Nette\Utils\Json;
use _PHPStan_6dcda722c\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 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 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 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;
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 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 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 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;
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\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\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\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 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\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;
interface WrapperPropertyReflection extends \PHPStan\Reflection\ExtendedPropertyReflection
{
public function getOriginalReflection() : \PHPStan\Reflection\ExtendedPropertyReflection;
}
<?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\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\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;
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 ?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)
{
$this->initializerExprTypeResolver = $initializerExprTypeResolver;
$this->declaringClass = $declaringClass;
$this->reflection = $reflection;
$this->nativeType = $nativeType;
$this->phpDocType = $phpDocType;
$this->deprecatedDescription = $deprecatedDescription;
$this->isDeprecated = $isDeprecated;
$this->isInternal = $isInternal;
}
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->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 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\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\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\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\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\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\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\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\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\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\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\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\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\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\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\StaticType;
use PHPStan\Type\Type;
use PHPStan\Type\TypeTraverser;
use function array_map;
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 StaticType) {
return $this->calledOnType;
}
return $traverse($type);
});
}
}
<?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 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;
use _PHPStan_6dcda722c\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\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();
}
$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->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\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;
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\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\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\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\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\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\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\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\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 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 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 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;
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 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;
/**
* 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\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\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\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\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 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\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;
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)
{
$this->functionSignatureMapProvider = $functionSignatureMapProvider;
$this->fileNodesFetcher = $fileNodesFetcher;
$this->fileTypeMapper = $fileTypeMapper;
$this->phpVersion = $phpVersion;
$this->initializerExprTypeResolver = $initializerExprTypeResolver;
$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();
}
}
$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, null);
$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(), null);
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\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_6dcda722c\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\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\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;
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 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, $fileDeclaringClass->getFileName(), $fileDeclaringClass, $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\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\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 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\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\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\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 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\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 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\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 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 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\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 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 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 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 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;
/**
* @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)
{
$this->declaringClass = $declaringClass;
$this->selfOutType = $selfOutType;
$name = strtolower($classMethod->name->name);
if (in_array($name, ['__construct', '__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 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\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\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\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;
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;
/** @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\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 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\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\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\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\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\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;
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\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) {
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 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 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\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_6dcda722c\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\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 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\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\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\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;
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;
/**
* 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;
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;
/**
* 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;
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;
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;
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;
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\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;
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;
/** @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;
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 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\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
* @phpstan-template-covariant TNodeType of Node
* @phpstan-template-covariant TValue
*/
interface Collector
{
/**
* @phpstan-return class-string<TNodeType>
*/
public function getNodeType() : string;
/**
* @phpstan-param TNodeType $node
* @return TValue|null Collected data
*/
public function processNode(Node $node, Scope $scope);
}
<?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
* @phpstan-param class-string<TNodeType> $nodeType
* @param Node $nodeType
* @phpstan-return array<Collector<TNodeType, mixed>>
* @return Collector[]
*/
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;
}
/**
* @phpstan-var array<Collector<TNodeType, mixed>> $selectedCollectors
* @var Collector[] $selectedCollectors
*/
$selectedCollectors = $this->cache[$nodeType];
return $selectedCollectors;
}
}
<?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 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\Command;
use _PHPStan_6dcda722c\OndraM\CiDetector\CiDetector;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\ProgressBar;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\TableSeparator;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Style\SymfonyStyle;
use _PHPStan_6dcda722c\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\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_6dcda722c\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 _PHPStan_6dcda722c\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_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\StringInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\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\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\Symfony;
use PHPStan\Command\OutputStyle;
use _PHPStan_6dcda722c\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_6dcda722c\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\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\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_6dcda722c\OndraM\CiDetector\CiDetector;
use _PHPStan_6dcda722c\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\ErrorFormatter;
use _PHPStan_6dcda722c\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 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_6dcda722c\Nette\DI\Helpers;
use _PHPStan_6dcda722c\Nette\Neon\Neon;
use _PHPStan_6dcda722c\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\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_6dcda722c\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\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\Analyser\Error;
use PHPStan\Command\AnalyseCommand;
use PHPStan\Command\AnalysisResult;
use PHPStan\Command\Output;
use PHPStan\File\RelativePathHelper;
use PHPStan\File\SimpleRelativePathHelper;
use _PHPStan_6dcda722c\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_6dcda722c\Nette\Utils\Json;
use PHPStan\Command\AnalysisResult;
use PHPStan\Command\Output;
use _PHPStan_6dcda722c\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\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;
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_6dcda722c\Nette\Neon\Neon;
use _PHPStan_6dcda722c\Nette\Utils\Json;
use PHPStan\ShouldNotHappenException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\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 Hoa\Compiler\Llk\Parser;
use Hoa\Compiler\Llk\TreeNode;
use Hoa\Exception\Exception;
use _PHPStan_6dcda722c\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 str_contains;
use function str_starts_with;
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) {
if (str_starts_with($e->getMessage(), 'Unexpected token "|" (alternation) at line 1')) {
return new \PHPStan\Command\IgnoredRegexValidatorResult([], \false, \true, '||', '\\|\\|');
}
if (str_contains($regex, '()') && str_starts_with($e->getMessage(), 'Unexpected token ")" (_capturing) at line 1')) {
return new \PHPStan\Command\IgnoredRegexValidatorResult([], \false, \true, '()', '\\(\\)');
}
return new \PHPStan\Command\IgnoredRegexValidatorResult([], \false, \false);
}
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;
use _PHPStan_6dcda722c\Clue\React\NDJson\Decoder;
use _PHPStan_6dcda722c\Clue\React\NDJson\Encoder;
use _PHPStan_6dcda722c\Composer\CaBundle\CaBundle;
use DateTime;
use DateTimeImmutable;
use DateTimeZone;
use _PHPStan_6dcda722c\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_6dcda722c\Psr\Http\Message\ResponseInterface;
use _PHPStan_6dcda722c\React\ChildProcess\Process;
use _PHPStan_6dcda722c\React\Dns\Config\Config;
use _PHPStan_6dcda722c\React\EventLoop\Loop;
use _PHPStan_6dcda722c\React\EventLoop\LoopInterface;
use _PHPStan_6dcda722c\React\EventLoop\StreamSelectLoop;
use _PHPStan_6dcda722c\React\Http\Browser;
use _PHPStan_6dcda722c\React\Promise\PromiseInterface;
use _PHPStan_6dcda722c\React\Socket\ConnectionInterface;
use _PHPStan_6dcda722c\React\Socket\Connector;
use _PHPStan_6dcda722c\React\Socket\TcpServer;
use _PHPStan_6dcda722c\React\Stream\ReadableStreamInterface;
use RuntimeException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\ProgressBar;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\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_6dcda722c\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_6dcda722c\Clue\React\NDJson\Decoder;
use _PHPStan_6dcda722c\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_6dcda722c\React\EventLoop\StreamSelectLoop;
use _PHPStan_6dcda722c\React\Socket\ConnectionInterface;
use _PHPStan_6dcda722c\React\Socket\TcpConnector;
use _PHPStan_6dcda722c\React\Stream\ReadableStreamInterface;
use _PHPStan_6dcda722c\React\Stream\WritableStreamInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\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 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_6dcda722c\React\EventLoop\StreamSelectLoop;
use _PHPStan_6dcda722c\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 Exception;
final class InceptionNotSuccessfulException extends Exception
{
}
<?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_6dcda722c\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_6dcda722c\React\EventLoop\LoopInterface;
use _PHPStan_6dcda722c\React\EventLoop\StreamSelectLoop;
use _PHPStan_6dcda722c\React\Promise\PromiseInterface;
use _PHPStan_6dcda722c\React\Socket\ConnectionInterface;
use _PHPStan_6dcda722c\React\Socket\TcpConnector;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\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_6dcda722c\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;
/** @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;
}
-----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;
/** @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\Command;
use _PHPStan_6dcda722c\Composer\Semver\Semver;
use _PHPStan_6dcda722c\Composer\XdebugHandler\XdebugHandler;
use _PHPStan_6dcda722c\Nette\DI\Helpers;
use _PHPStan_6dcda722c\Nette\DI\InvalidConfigurationException;
use _PHPStan_6dcda722c\Nette\DI\ServiceCreationException;
use _PHPStan_6dcda722c\Nette\FileNotFoundException;
use _PHPStan_6dcda722c\Nette\InvalidStateException;
use _PHPStan_6dcda722c\Nette\Schema\ValidationException;
use _PHPStan_6dcda722c\Nette\Utils\AssertionException;
use _PHPStan_6dcda722c\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_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutputInterface;
use _PHPStan_6dcda722c\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;
use PHPStan\Diagnose\DiagnoseExtension;
use PHPStan\Diagnose\PHPStanDiagnoseExtension;
use PHPStan\ShouldNotHappenException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\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;
use PHPStan\Analyser\ResultCache\ResultCacheClearer;
use PHPStan\ShouldNotHappenException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\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;
/**
* @phpstan-pure
* @return mixed
*
* @throws void
*/
function debugScope()
{
return null;
}
<?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;
}
<?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;
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;
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 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;
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\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);
if ($node instanceof Node\FunctionLike && $node->hasAttribute(ArrayMapArgVisitor::ATTRIBUTE_NAME) && $node->hasAttribute('startFilePos')) {
$key .= '/*' . $node->getAttribute('startFilePos') . '*/';
}
if ($node->getAttribute(self::KEEP_VOID_ATTRIBUTE_NAME) === \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);
if (count($resultType->getConstantStrings()) === 0) {
return $resultType;
}
}
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 = []) : 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)), !$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())) {
$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()) {
$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));
if ($resolvedClassName === null) {
return null;
}
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 = 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 || $constructorMethod->getDeclaringClass()->getName() !== $classReflection->getName()) {
return new GenericObjectType($resolvedClassName, $classReflection->typeMapToList($classReflection->getTemplateTypeMap()->resolveToBounds()));
}
$parametersAcceptor = ParametersAcceptorSelector::selectFromArgs($this, $methodCall->getArgs(), $constructorMethod->getVariants(), $constructorMethod->getNamedArgumentsVariants());
if ($this->explicitMixedInUnknownGenericNew) {
$resolvedTemplateTypeMap = $parametersAcceptor->getResolvedTemplateTypeMap();
return TypeTraverser::map(new GenericObjectType($resolvedClassName, $classReflection->typeMapToList($classReflection->getTemplateTypeMap())), 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;
}
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;
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\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 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_6dcda722c\Nette\Utils\Json;
use _PHPStan_6dcda722c\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_6dcda722c\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 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_6dcda722c\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 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 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;
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 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;
/**
* @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 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);
}
$methodScope = $scope->enterClassMethod($stmt, $templateTypeMap, $phpDocParameterTypes, $phpDocReturnType, $phpDocThrowType, $deprecatedDescription, $isDeprecated, $isInternal, $isFinal, $isPure, $acceptsNamedArguments, $asserts, $selfOutType, $phpDocComment, $phpDocParameterOutTypes, $phpDocImmediatelyInvokedCallableParameters, $phpDocClosureThisTypeParameters);
if (!$scope->isInClass()) {
throw new ShouldNotHappenException();
}
$isFromTrait = $stmt->getAttribute('originalTraitMethodName') === '__construct';
if ($isFromTrait || $stmt->name->toLowerString() === '__construct') {
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) {
$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);
if ($lastCondExpr !== null) {
$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);
}
}
return new \PHPStan\Analyser\StatementResult($finalScope, $finalScopeResult->hasYield() || $hasYield, \false, $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;
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 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 Exception;
use JsonSerializable;
use _PHPStan_6dcda722c\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 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 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 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;
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\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;
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 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;
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\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\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\ResultCache;
interface ResultCacheManagerFactory
{
public function create() : \PHPStan\Analyser\ResultCache\ResultCacheManager;
}
<?php
declare (strict_types=1);
namespace PHPStan\Analyser\ResultCache;
use _PHPStan_6dcda722c\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;
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;
/**
* @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;
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 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 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 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 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 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 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\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 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\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;
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\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 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;
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 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 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\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 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 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\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);
$type = TypeTraverser::map($classType, static function (Type $type, callable $traverse) : Type {
if ($type instanceof UnionType || $type instanceof IntersectionType) {
return $traverse($type);
}
if ($type->getObjectClassNames() !== []) {
return $type;
}
if ($type instanceof GenericClassStringType) {
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()) {
$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'], \true) && (!$expr->right instanceof FuncCall || !$expr->right->name instanceof Name || !in_array(strtolower((string) $expr->right->name), ['count', 'sizeof', 'strlen', 'mb_strlen'], \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()) === 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}|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];
} elseif ($rightType instanceof ConstantScalarType && !$leftExpr instanceof ConstFetch && !$leftExpr instanceof ClassConstFetch) {
return [$binaryOperation->left, $rightType];
}
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];
if (!$context->null() && ($constantType->getValue() === \false || $constantType->getValue() === null)) {
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 ($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
{
$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);
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;
}
}
}
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);
}
}
}
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);
}
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));
}
}
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;
}
}
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);
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\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\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\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\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\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;
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\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;
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\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\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\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;
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;
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\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;
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;
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;
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\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\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 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 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;
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\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;
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;
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\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\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 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 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 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 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;
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;
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 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;
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 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 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;
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;
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\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\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;
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;
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\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;
/**
* @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\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;
/** @api */
interface VirtualNode extends Node
{
}
<?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;
/**
* @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\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\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\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;
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\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\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 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\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\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;
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\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\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;
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\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;
/**
* @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\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\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 AccessoryNumericStringType(), new AccessoryNonFalsyStringType()]);
}
return new \PHPStan\Type\IntersectionType([new \PHPStan\Type\StringType(), new AccessoryLowercaseStringType(), 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 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\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) {
if ($type instanceof AccessoryLowercaseStringType && !$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 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());
});
}
return $this->intersectTypes(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->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[md5($enumCase->describe(\PHPStan\Type\VerbosityLevel::typeOnly()))] = $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) {
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 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 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;
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 $reasons;
}
}
<?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\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 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\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 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\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 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\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 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\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 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\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 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\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 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\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\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 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\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 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\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 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\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;
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;
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\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;
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;
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_6dcda722c\Nette\Utils\RegexpException;
use _PHPStan_6dcda722c\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 count;
use function in_array;
use function is_int;
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;
/**
* @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;
}
$rawRegex = $this->regexExpressionHelper->removeDelimitersAndModifiers($regex);
try {
$ast = self::$parser->parse($rawRegex);
} catch (Exception $e) {
return null;
}
$captureOnlyNamed = \false;
$modifiers = $this->regexExpressionHelper->getPatternModifiers($regex) ?? '';
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()];
}
/**
* @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') {
$inAlternation = \true;
}
// [^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 \false;
}
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 && (!in_array($value, ['.'], \true) || $isEscaped || $inCharacterClass)) {
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\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 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;
/** @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;
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 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\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 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\Type\Accessory\AccessoryArrayListType;
use PHPStan\Type\Accessory\AccessoryNonEmptyStringType;
use PHPStan\Type\Accessory\AccessoryType;
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, new \PHPStan\Type\StringType()];
}
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 [new \PHPStan\Type\StringType(), null];
}
if ($a instanceof ConstantStringType && $a->getValue() === '0' && $b->describe(\PHPStan\Type\VerbosityLevel::value()) === 'non-falsy-string') {
return [null, new \PHPStan\Type\IntersectionType([new \PHPStan\Type\StringType(), new AccessoryNonEmptyStringType()])];
}
if ($b instanceof ConstantStringType && $b->getValue() === '0' && $a->describe(\PHPStan\Type\VerbosityLevel::value()) === 'non-falsy-string') {
return [new \PHPStan\Type\IntersectionType([new \PHPStan\Type\StringType(), new AccessoryNonEmptyStringType()]), null];
}
return null;
}
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());
}
}
<?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 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 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\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\NonEmptyArrayType;
use PHPStan\Type\Generic\GenericObjectType;
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;
return $type;
}
if ($type->isConstantValue()->yes() && $type->isNull()->no()) {
$moreVerbose = \true;
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) {
$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) {
$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 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;
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 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 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;
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 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\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_6dcda722c\Nette\Utils\RegexpException;
use _PHPStan_6dcda722c\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\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 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 hasOffsetValueType(Type $offsetType) : TrinaryLogic
{
if ($offsetType->isInteger()->yes()) {
$strLenType = IntegerRangeType::fromInterval(0, strlen($this->value) - 1);
return $strLenType->isSuperTypeOf($offsetType);
}
return parent::hasOffsetValueType($offsetType);
}
public function getOffsetValueType(Type $offsetType) : Type
{
if ($offsetType->isInteger()->yes()) {
if ($offsetType instanceof \PHPStan\Type\Constant\ConstantIntegerType) {
if ($offsetType->getValue() < strlen($this->value)) {
return new self($this->value[$offsetType->getValue()]);
}
return new ErrorType();
}
$strLenType = IntegerRangeType::fromInterval(0, strlen($this->value) - 1);
$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();
}
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 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\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_6dcda722c\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 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\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 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 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;
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 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;
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;
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\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\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();
}
$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 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 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\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) {
return \PHPStan\Type\CallableTypeHelper::isParametersAcceptorSuperTypeOf($this, $type, $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
{
$typeMap = TemplateTypeMap::createEmpty();
$args = $parametersAcceptor->getParameters();
$returnType = $parametersAcceptor->getReturnType();
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 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\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 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 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\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);
}
$nameScopeMap = [];
if (!isset($this->inProcess[$fileName])) {
$nameScopeMap = $this->getNameScopeMap($fileName);
}
if (isset($nameScopeMap[$nameScopeKey])) {
return $this->createResolvedPhpDocBlock($phpDocKey, $nameScopeMap[$nameScopeKey], $docComment, $fileName);
}
if (!isset($this->inProcess[$fileName][$nameScopeKey])) {
// wrong $fileName due to traits
return ResolvedPhpDocBlock::createEmpty();
}
if ($this->inProcess[$fileName][$nameScopeKey] === \true) {
// PHPDoc has cyclic dependency
return ResolvedPhpDocBlock::createEmpty();
}
if (is_callable($this->inProcess[$fileName][$nameScopeKey])) {
$resolveCallback = $this->inProcess[$fileName][$nameScopeKey];
$this->inProcess[$fileName][$nameScopeKey] = \true;
$this->inProcess[$fileName][$nameScopeKey] = $resolveCallback();
}
return $this->createResolvedPhpDocBlock($phpDocKey, $this->inProcess[$fileName][$nameScopeKey], $docComment, $fileName);
}
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 Exception;
final class CircularTypeAliasDefinitionException extends Exception
{
}
<?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;
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;
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;
/** @api */
interface ConstantType extends \PHPStan\Type\Type
{
}
<?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\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\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 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 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\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\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;
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);
}
$result = \PHPStan\Type\IsSuperTypeOfResult::createNo()->or(...array_map(static function (\PHPStan\Type\Type $innerType) use($otherType) {
return $innerType->isSuperTypeOfWithReason($otherType);
}, $this->types));
if ($result->yes()) {
return $result;
}
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 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 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\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;
/** @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 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\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\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\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 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 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 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 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;
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\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;
/**
* 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\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\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\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\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\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\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\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\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\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\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\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\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\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\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 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\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\BooleanType;
trait UndecidedBooleanTypeTrait
{
public function toBoolean() : BooleanType
{
return new BooleanType();
}
}
<?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\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\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 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\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;
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\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;
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\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\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 $bound;
}
return $type;
}
}
<?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;
/** @api */
interface LateResolvableType
{
public function resolve() : \PHPStan\Type\Type;
public function isResolvable() : bool;
}
<?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 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\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\UnionType([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 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\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\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 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 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\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\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;
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\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\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 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\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\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;
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\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 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\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\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\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\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\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\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\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\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\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\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\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\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 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\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\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\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\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\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;
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 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 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\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\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\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\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\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\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\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\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 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\Php\PhpVersion;
use PHPStan\Reflection\FunctionReflection;
use PHPStan\Reflection\ParametersAcceptorSelector;
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\MixedType;
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 hash_algos;
use function in_array;
use function strtolower;
final class HashFunctionsReturnTypeExtension implements DynamicFunctionReturnTypeExtension
{
/**
* @var PhpVersion
*/
private $phpVersion;
private const SUPPORTED_FUNCTIONS = ['hash' => ['cryptographic' => \false, 'possiblyFalse' => \false], 'hash_file' => ['cryptographic' => \false, 'possiblyFalse' => \true], 'hash_hkdf' => ['cryptographic' => \true, 'possiblyFalse' => \false], 'hash_hmac' => ['cryptographic' => \true, 'possiblyFalse' => \false], 'hash_hmac_file' => ['cryptographic' => \true, 'possiblyFalse' => \true], 'hash_pbkdf2' => ['cryptographic' => \true, 'possiblyFalse' => \false]];
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
{
$defaultReturnType = ParametersAcceptorSelector::selectFromArgs($scope, $functionCall->getArgs(), $functionReflection->getVariants())->getReturnType();
if (!isset($functionCall->getArgs()[0])) {
return $defaultReturnType;
}
$algorithmType = $scope->getType($functionCall->getArgs()[0]->value);
if ($algorithmType instanceof MixedType) {
return TypeUtils::toBenevolentUnion($defaultReturnType);
}
$constantAlgorithmTypes = $algorithmType->getConstantStrings();
if ($constantAlgorithmTypes === []) {
return TypeUtils::toBenevolentUnion($defaultReturnType);
}
$neverType = new NeverType();
$falseType = new ConstantBooleanType(\false);
$nonEmptyString = new IntersectionType([new StringType(), new AccessoryNonEmptyStringType()]);
$invalidAlgorithmType = $this->phpVersion->throwsValueErrorForInternalFunctions() ? $neverType : $falseType;
$functionData = self::SUPPORTED_FUNCTIONS[strtolower($functionReflection->getName())];
$returnTypes = array_map(function (ConstantStringType $type) use($functionData, $nonEmptyString, $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 $nonEmptyString;
}, $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\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\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\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 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\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\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->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\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\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 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\Accessory\AccessoryLiteralStringType;
use PHPStan\Type\Accessory\AccessoryLowercaseStringType;
use PHPStan\Type\Accessory\AccessoryNonEmptyStringType;
use PHPStan\Type\Accessory\AccessoryNonFalsyStringType;
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 (count($accessoryTypes) > 0) {
$accessoryTypes[] = new StringType();
return new IntersectionType($accessoryTypes);
}
return new StringType();
}
}
<?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;
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 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 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\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\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\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\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\ConstantBooleanType;
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 instanceof ConstantBooleanType];
}
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 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 _PHPStan_6dcda722c\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\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 (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 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\Accessory\AccessoryArrayListType;
use PHPStan\Type\ArrayType;
use PHPStan\Type\DynamicFunctionReturnTypeExtension;
use PHPStan\Type\IntegerType;
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);
$arrayKeyType = $traversableType->getIterableKeyType();
$isList = \false;
if (isset($arguments[1])) {
$preserveKeysType = $scope->getType($arguments[1]->value);
if ($preserveKeysType->isFalse()->yes()) {
$arrayKeyType = new IntegerType();
$isList = \true;
}
}
$arrayType = new ArrayType($arrayKeyType, $traversableType->getIterableValueType());
if ($isList) {
$arrayType = AccessoryArrayListType::intersectWith($arrayType);
}
return $arrayType;
}
}
<?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\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\FuncCall;
use PHPStan\Analyser\Scope;
use PHPStan\Reflection\FunctionReflection;
use PHPStan\ShouldNotHappenException;
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\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 = [];
$allConstant = \true;
foreach ($args as $arg) {
$argType = $scope->getType($arg->value);
if ($arg->unpack) {
if ($argType instanceof ConstantArrayType) {
$argTypesFound = $argType->getValueTypes();
} else {
$argTypesFound = [$argType->getIterableValueType()];
}
foreach ($argTypesFound as $argTypeFound) {
$argTypes[] = $argTypeFound;
if ($argTypeFound instanceof ConstantArrayType) {
continue;
}
$allConstant = \false;
}
if (!$argType->isIterableAtLeastOnce()->yes()) {
// unpacked params can be empty, making them optional
$optionalArgTypesOffset = count($argTypes) - 1;
foreach (array_keys($argTypesFound) as $key) {
$optionalArgTypes[] = $optionalArgTypesOffset + $key;
}
}
} else {
$argTypes[] = $argType;
if (!$argType instanceof ConstantArrayType) {
$allConstant = \false;
}
}
}
if ($allConstant) {
$newArrayBuilder = ConstantArrayTypeBuilder::createEmpty();
foreach ($argTypes as $argType) {
if (!$argType instanceof ConstantArrayType) {
throw new ShouldNotHappenException();
}
$keyTypes = $argType->getKeyTypes();
$valueTypes = $argType->getValueTypes();
$optionalKeys = $argType->getOptionalKeys();
foreach ($keyTypes as $k => $keyType) {
$isOptional = in_array($k, $optionalKeys, \true);
$newArrayBuilder->setOffsetValueType($keyType instanceof ConstantIntegerType ? null : $keyType, $valueTypes[$k], $isOptional);
}
}
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 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\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 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\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\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\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\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 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\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 instanceof ConstantBooleanType || $strictArgType->getValue() === \false) {
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;
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\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 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\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\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\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 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\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\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 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;
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_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
{
if (count($functionCall->getArgs()) < 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();
foreach (array_slice($functionCall->getArgs(), 1) as $index => $arg) {
$arrayBuilder->setOffsetValueType(new ConstantIntegerType($index), $scope->getType($arg->value)->getIterableValueType());
}
$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 = 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 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 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 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\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 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 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\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 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\Accessory\AccessoryLowercaseStringType;
use PHPStan\Type\Accessory\AccessoryNonEmptyStringType;
use PHPStan\Type\Accessory\AccessoryNonFalsyStringType;
use PHPStan\Type\Accessory\AccessoryNumericStringType;
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;
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;
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;
}
} 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;
}
$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 ($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\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\ConstantType;
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 (!$type instanceof ConstantType) {
return TypeCombinator::union(...$types);
}
if ($resultType === null) {
$resultType = $type;
continue;
}
$compareResult = $this->compareTypes($resultType, $type);
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->isConstantArray()->yes() && $secondType instanceof ConstantScalarType) {
return $secondType;
}
if ($firstType instanceof ConstantScalarType && $secondType->isConstantArray()->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\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\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 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 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\Reflection\FunctionReflection;
use PHPStan\Reflection\ParametersAcceptorSelector;
use PHPStan\Type\Accessory\AccessoryLowercaseStringType;
use PHPStan\Type\Accessory\AccessoryNonEmptyStringType;
use PHPStan\Type\Accessory\AccessoryNonFalsyStringType;
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 (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\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\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 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 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;
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\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\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\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\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\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 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\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\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\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\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\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\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_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 = null;
$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;
}
// The printf format is %[argnum$][flags][width][.precision]specifier.
if (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 !== []) {
$result = [];
$printfArgs = array_fill(0, count($args) - 1, '');
foreach ($constArgTypes as $constArgType) {
$printfArgs[$checkArg - 1] = $constArgType->getValue();
try {
$result[] = new ConstantStringType(@sprintf($constantString->getValue(), ...$printfArgs));
} catch (Throwable $e) {
continue 2;
}
}
$singlePlaceholderEarlyReturn = TypeCombinator::union(...$result);
continue;
}
$singlePlaceholderEarlyReturn = $checkArgType->toString();
} elseif ($matches['specifier'] !== 's') {
$singlePlaceholderEarlyReturn = $this->getStringReturnType(new AccessoryNumericStringType(), $isLowercase);
}
continue;
}
$singlePlaceholderEarlyReturn = null;
break;
}
if ($singlePlaceholderEarlyReturn !== null) {
return $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\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 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 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\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\Php\PhpVersion;
use PHPStan\Reflection\FunctionReflection;
use PHPStan\Type\Accessory\AccessoryArrayListType;
use PHPStan\Type\Accessory\AccessoryLowercaseStringType;
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);
if ($stringType->isLowercaseString()->yes()) {
$returnValueType = new IntersectionType([new StringType(), new AccessoryLowercaseStringType()]);
} 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\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\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 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\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\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\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 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\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\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\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\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 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 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\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\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\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 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\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\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\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\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\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\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 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\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\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\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\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 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 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 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\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\Accessory\AccessoryLiteralStringType;
use PHPStan\Type\Accessory\AccessoryLowercaseStringType;
use PHPStan\Type\Accessory\AccessoryNonEmptyStringType;
use PHPStan\Type\Accessory\AccessoryNonFalsyStringType;
use PHPStan\Type\Constant\ConstantArrayType;
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 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 (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 = [];
foreach ($valueTypes as $valueType) {
if (!$valueType instanceof ConstantScalarType) {
return null;
}
$arrayValues[] = $valueType->getValue();
}
$strings[] = new ConstantStringType(implode($separatorType->getValue(), $arrayValues));
}
return TypeCombinator::union(...$strings);
}
}
<?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\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\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 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\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 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\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 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_change_key_case' => 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\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;
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 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 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\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\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\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\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 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\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\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;
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\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 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\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 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 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 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\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\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\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\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;
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 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\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\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;
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\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 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;
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;
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 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 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;
/**
* @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;
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;
use ArrayAccess;
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 = ['SimpleXMLElement', 'DOMNodeList', '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() || 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 $bound;
}
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 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 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\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 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 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, $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, $reasons);
}
}
<?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 $type;
}
return $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 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 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;
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\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 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;
/** @api */
class CircularTypeAliasErrorType extends \PHPStan\Type\ErrorType
{
}
<?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\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\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;
}
$variantsResult = null;
foreach ($type->getCallableParametersAcceptors($scope) as $variant) {
$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
{
$typeMap = TemplateTypeMap::createEmpty();
$args = $parametersAcceptor->getParameters();
$returnType = $parametersAcceptor->getReturnType();
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 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\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 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\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 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\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\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;
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;
interface TypeAliasResolverProvider
{
public function getTypeAliasResolver() : \PHPStan\Type\TypeAliasResolver;
}
<?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\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\Process;
use Exception;
final class ProcessCrashedException extends Exception
{
}
<?php
declare (strict_types=1);
namespace PHPStan\Process;
use PHPStan\Command\AnalyseCommand;
use _PHPStan_6dcda722c\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 PHPStan\ShouldNotHappenException;
use _PHPStan_6dcda722c\React\ChildProcess\Process;
use _PHPStan_6dcda722c\React\EventLoop\LoopInterface;
use _PHPStan_6dcda722c\React\Promise\Deferred;
use _PHPStan_6dcda722c\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\Process;
use Exception;
final class ProcessCanceledException extends Exception
{
}
<?php
declare (strict_types=1);
namespace PHPStan\Process;
use _PHPStan_6dcda722c\Fidry\CpuCoreCounter\CpuCoreCounter as FidryCpuCoreCounter;
use _PHPStan_6dcda722c\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;
use Exception;
abstract class AnalysedCodeException extends Exception
{
public abstract function getTip() : ?string;
}
<?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;
use Exception;
final class ShouldNotHappenException extends Exception
{
/** @api */
public function __construct(string $message = 'Internal error.')
{
parent::__construct($message);
}
}
<?php
declare (strict_types=1);
namespace PHPStan\Php;
use _PHPStan_6dcda722c\Nette\Utils\Json;
use _PHPStan_6dcda722c\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\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\DependencyInjection;
use _PHPStan_6dcda722c\Nette;
use _PHPStan_6dcda722c\Nette\DI\CompilerExtension;
use _PHPStan_6dcda722c\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 _PHPStan_6dcda722c\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_6dcda722c\Nette\DI\Config\Loader;
use _PHPStan_6dcda722c\Nette\DI\Container as OriginalNetteContainer;
use _PHPStan_6dcda722c\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_6dcda722c\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 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\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\Reflection;
use PHPStan\Reflection\ClassReflectionExtensionRegistry;
interface ClassReflectionExtensionRegistryProvider
{
public function getRegistry() : ClassReflectionExtensionRegistry;
}
<?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 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\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 _PHPStan_6dcda722c\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;
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 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\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\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\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\OperatorTypeSpecifyingExtensionRegistry;
interface OperatorTypeSpecifyingExtensionRegistryProvider
{
public function getRegistry() : OperatorTypeSpecifyingExtensionRegistry;
}
<?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\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\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\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\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\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\DynamicReturnTypeExtensionRegistry;
interface DynamicReturnTypeExtensionRegistryProvider
{
public function getRegistry() : DynamicReturnTypeExtensionRegistry;
}
<?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;
use _PHPStan_6dcda722c\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;
use _PHPStan_6dcda722c\Nette\Bootstrap\Extensions\PhpExtension;
use _PHPStan_6dcda722c\Nette\DI\Config\Adapters\PhpAdapter;
use _PHPStan_6dcda722c\Nette\DI\Definitions\Statement;
use _PHPStan_6dcda722c\Nette\DI\Extensions\ExtensionsExtension;
use _PHPStan_6dcda722c\Nette\DI\Helpers;
use _PHPStan_6dcda722c\Nette\Schema\Context as SchemaContext;
use _PHPStan_6dcda722c\Nette\Schema\Elements\AnyOf;
use _PHPStan_6dcda722c\Nette\Schema\Elements\Structure;
use _PHPStan_6dcda722c\Nette\Schema\Elements\Type;
use _PHPStan_6dcda722c\Nette\Schema\Expect;
use _PHPStan_6dcda722c\Nette\Schema\Processor;
use _PHPStan_6dcda722c\Nette\Schema\Schema;
use _PHPStan_6dcda722c\Nette\Utils\Strings;
use _PHPStan_6dcda722c\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_6dcda722c\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_6dcda722c\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_6dcda722c\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;
/** @api */
interface Container
{
public function hasService(string $serviceName) : bool;
/**
* @return mixed
*/
public function getService(string $serviceName);
/**
* @phpstan-template T of object
* @phpstan-param class-string<T> $className
* @phpstan-return T
* @return mixed
*/
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\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_6dcda722c\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);
}
/**
* @phpstan-template T of object
* @phpstan-param class-string<T> $className
* @phpstan-return T
* @return mixed
*/
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_6dcda722c\Nette\DI\Config\Adapter;
use _PHPStan_6dcda722c\Nette\DI\Config\Helpers;
use _PHPStan_6dcda722c\Nette\DI\Definitions\Reference;
use _PHPStan_6dcda722c\Nette\DI\Definitions\Statement;
use _PHPStan_6dcda722c\Nette\DI\InvalidConfigurationException;
use _PHPStan_6dcda722c\Nette\Neon\Entity;
use _PHPStan_6dcda722c\Nette\Neon\Exception;
use _PHPStan_6dcda722c\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 _PHPStan_6dcda722c\Nette\DI\CompilerExtension;
use _PHPStan_6dcda722c\Nette\Schema\Expect;
use _PHPStan_6dcda722c\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 _PHPStan_6dcda722c\Nette\DI\CompilerExtension;
use _PHPStan_6dcda722c\Nette\DI\Definitions\Statement;
use _PHPStan_6dcda722c\Nette\Schema\Expect;
use _PHPStan_6dcda722c\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 Hoa\Compiler\Llk\Llk;
use Hoa\File\Read;
use _PHPStan_6dcda722c\Nette\DI\CompilerExtension;
use _PHPStan_6dcda722c\Nette\Utils\RegexpException;
use _PHPStan_6dcda722c\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;
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;
use _PHPStan_6dcda722c\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 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\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\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\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 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 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 _PHPStan_6dcda722c\Nette\Utils\Json;
use _PHPStan_6dcda722c\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\Parallel;
use PHPStan\ShouldNotHappenException;
use _PHPStan_6dcda722c\React\EventLoop\LoopInterface;
use _PHPStan_6dcda722c\React\EventLoop\TimerInterface;
use _PHPStan_6dcda722c\React\Stream\ReadableStreamInterface;
use _PHPStan_6dcda722c\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_6dcda722c\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 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\Parallel;
use Exception;
final class ProcessTimedOutException extends Exception
{
}
<?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 Closure;
use _PHPStan_6dcda722c\Clue\React\NDJson\Decoder;
use _PHPStan_6dcda722c\Clue\React\NDJson\Encoder;
use _PHPStan_6dcda722c\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_6dcda722c\React\EventLoop\LoopInterface;
use _PHPStan_6dcda722c\React\Promise\Deferred;
use _PHPStan_6dcda722c\React\Promise\PromiseInterface;
use _PHPStan_6dcda722c\React\Socket\ConnectionInterface;
use _PHPStan_6dcda722c\React\Socket\TcpServer;
use _PHPStan_6dcda722c\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_6dcda722c\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\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;
/**
* @phpstan-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 _PHPStan_6dcda722c\Nette\Utils\Json;
use _PHPStan_6dcda722c\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 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 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_6dcda722c\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\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_6dcda722c\Symfony\Component\Console\Input\StringInput;
use _PHPStan_6dcda722c\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\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;
}
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\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\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\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 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\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 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;
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 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;
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;
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\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\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) {
$trait->setAttribute('linesToIgnore', array_filter($linesToIgnore, static function (int $line) use($trait) : bool {
return $line >= $trait->getStartLine() && $line <= $trait->getEndLine();
}, ARRAY_FILTER_USE_KEY));
}
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\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\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\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 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 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\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\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\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 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;
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;
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 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 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;
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;
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 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\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\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;
/** @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\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\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;
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 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\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\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\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\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 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\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 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 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 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;
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 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 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\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;
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;
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\Cache;
use InvalidArgumentException;
use _PHPStan_6dcda722c\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\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;
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 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\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\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\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 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\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\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;
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\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 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 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\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\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\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
*/
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;
/** @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
*/
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\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 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 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\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 */
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 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\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 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 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\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 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 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;
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 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;
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\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;
interface StubFilesProvider
{
/** @return string[] */
public function getStubFiles() : array;
/** @return string[] */
public function getProjectStubFiles() : array;
}
<?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 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;
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;
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\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 Closure;
use Generator;
use Iterator;
use IteratorAggregate;
use _PHPStan_6dcda722c\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\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\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 '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 '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();
}
$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\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 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, null, $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\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\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\PhpDoc\Tag\AssertTagParameter;
use PHPStan\Reflection\ClassReflection;
use PHPStan\Reflection\ConstantReflection;
use PHPStan\Reflection\MethodReflection;
use PHPStan\Reflection\Php\PhpMethodReflection;
use PHPStan\Reflection\Php\PhpPropertyReflection;
use PHPStan\Reflection\PropertyReflection;
use PHPStan\Reflection\ResolvedMethodReflection;
use PHPStan\Reflection\ResolvedPropertyReflection;
use PHPStan\Type\ConditionalTypeForParameter;
use PHPStan\Type\Type;
use PHPStan\Type\TypeTraverser;
use function array_key_exists;
use function count;
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;
}
/**
* @param array<int, string> $originalPositionalParameterNames
* @param array<int, string> $newPositionalParameterNames
*/
public static function resolvePhpDocBlockForProperty(
?string $docComment,
ClassReflection $classReflection,
?string $trait,
string $propertyName,
?string $file,
?bool $explicit,
array $originalPositionalParameterNames,
// unused
array $newPositionalParameterNames
) : self
{
return self::resolvePhpDocBlockTree($docComment, $classReflection, $trait, $propertyName, $file, 'hasNativeProperty', 'getNativeProperty', __FUNCTION__, $explicit, [], []);
}
/**
* @param array<int, string> $originalPositionalParameterNames
* @param array<int, string> $newPositionalParameterNames
*/
public static function resolvePhpDocBlockForConstant(
?string $docComment,
ClassReflection $classReflection,
?string $trait,
// unused
string $constantName,
?string $file,
?bool $explicit,
array $originalPositionalParameterNames,
// unused
array $newPositionalParameterNames
) : self
{
return self::resolvePhpDocBlockTree($docComment, $classReflection, null, $constantName, $file, 'hasConstant', 'getConstant', __FUNCTION__, $explicit, [], []);
}
/**
* @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
{
return self::resolvePhpDocBlockTree($docComment, $classReflection, $trait, $methodName, $file, 'hasNativeMethod', 'getNativeMethod', __FUNCTION__, $explicit, $originalPositionalParameterNames, $newPositionalParameterNames);
}
/**
* @param array<int, string> $originalPositionalParameterNames
* @param array<int, string> $newPositionalParameterNames
*/
private static function resolvePhpDocBlockTree(?string $docComment, ClassReflection $classReflection, ?string $trait, string $name, ?string $file, string $hasMethodName, string $getMethodName, string $resolveMethodName, ?bool $explicit, array $originalPositionalParameterNames, array $newPositionalParameterNames) : self
{
$docBlocksFromParents = self::resolveParentPhpDocBlocks($classReflection, $name, $hasMethodName, $getMethodName, $resolveMethodName, $explicit ?? $docComment !== null, $newPositionalParameterNames);
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;
}
/**
* @param array<int, string> $positionalParameterNames
* @return array<int, self>
*/
private static function resolveParentPhpDocBlocks(ClassReflection $classReflection, string $name, string $hasMethodName, string $getMethodName, string $resolveMethodName, bool $explicit, array $positionalParameterNames) : array
{
$result = [];
$parentReflections = self::getParentReflections($classReflection);
foreach ($parentReflections as $parentReflection) {
$oneResult = self::resolvePhpDocBlockFromClass($parentReflection, $name, $hasMethodName, $getMethodName, $resolveMethodName, $explicit, $positionalParameterNames);
if ($oneResult === null) {
// Null if it is private or from a wrong trait.
continue;
}
$result[] = $oneResult;
}
return $result;
}
/**
* @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;
}
/**
* @param array<int, string> $positionalParameterNames
*/
private static function resolvePhpDocBlockFromClass(ClassReflection $classReflection, string $name, string $hasMethodName, string $getMethodName, string $resolveMethodName, bool $explicit, array $positionalParameterNames) : ?self
{
if ($classReflection->{$hasMethodName}($name)) {
/** @var PropertyReflection|MethodReflection|ConstantReflection $parentReflection */
$parentReflection = $classReflection->{$getMethodName}($name);
if ($parentReflection->isPrivate()) {
return null;
}
$classReflection = $parentReflection->getDeclaringClass();
if ($parentReflection instanceof PhpPropertyReflection || $parentReflection instanceof ResolvedPropertyReflection) {
$traitReflection = $parentReflection->getDeclaringTrait();
$positionalMethodParameterNames = [];
} elseif ($parentReflection instanceof MethodReflection) {
$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;
}
} else {
$traitReflection = null;
$positionalMethodParameterNames = [];
}
$trait = $traitReflection !== null ? $traitReflection->getName() : null;
return self::$resolveMethodName($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;
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\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 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\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;
interface TypeNodeResolverExtensionRegistry
{
/**
* @return TypeNodeResolverExtension[]
*/
public function getExtensions() : array;
}
<?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;
/** @api */
interface TypeNodeResolverAwareExtension
{
public function setTypeNodeResolver(\PHPStan\PhpDoc\TypeNodeResolver $typeNodeResolver) : void;
}
<?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\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\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;
/**
* 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;
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
/**
* @template TIn of mixed
* @template TReturn of mixed
*
* @param array<TIn> $one
* @param callable(TReturn, TIn): TReturn $two
* @param TReturn $three
*
* @return TReturn
*/
function array_reduce(
array $one,
callable $two,
$three = null
) {}
/**
* @template T of mixed
*
* @param array<T> $array
* @return ($array is non-empty-array ? non-empty-list<T> : list<T>)
*/
function array_values(array $array): array {}
/**
* @template TKey as (int|string)
* @template T
* @template TArray as array<TKey,T>
*
* @param TArray $array
* @param callable(T,T):int $callback
*/
function uasort(array &$array, callable $callback): bool
{}
/**
* @template T
* @template TArray as array<T>
*
* @param TArray $array
* @param callable(T,T):int $callback
*/
function usort(array &$array, callable $callback): bool
{}
/**
* @template TKey as (int|string)
* @template T
* @template TArray as array<TKey,T>
*
* @param TArray $array
* @param callable(TKey,TKey):int $callback
*/
function uksort(array &$array, callable $callback): bool
{
}
/**
* @template T of mixed
*
* @param array<T> $one
* @param array<T> $two
* @param callable(T, T): int $three
*/
function array_udiff(
array $one,
array $two,
callable $three
): int {}
/**
* @param array<array-key, mixed> $value
* @return ($value is __always-list ? true : false)
*/
function array_is_list(array $value): bool {}
<?php
/**
* @template-covariant TKey
* @template-covariant TValue
*/
interface Traversable
{
}
/**
* @template-covariant TKey
* @template-covariant TValue
*
* @extends Traversable<TKey, TValue>
*/
interface IteratorAggregate extends Traversable
{
/**
* @return Traversable<TKey, TValue>
*/
public function getIterator();
}
/**
* @template-covariant TKey
* @template-covariant TValue
*
* @extends Traversable<TKey, TValue>
*/
interface Iterator extends Traversable
{
/**
* @return TValue
*/
public function current();
/**
* @return TKey
*/
public function key();
}
/**
* @template-covariant TKey
* @template-covariant TValue
*
* @extends Iterator<TKey, TValue>
*/
interface RecursiveIterator extends Iterator
{
}
/**
* @template-covariant TKey
* @template-covariant TValue
* @template TSend
* @template-covariant TReturn
*
* @implements Iterator<TKey, TValue>
*/
class Generator implements Iterator
{
/**
* @return TReturn
*/
public function getReturn() {}
/**
* @param TSend $value
* @return TValue
*/
public function send($value) {}
}
/**
* @implements Traversable<string, static>
* @implements ArrayAccess<int|string, static>
* @implements Iterator<string, static>
* @implements RecursiveIterator<string, static>
*/
class SimpleXMLElement implements Traversable, ArrayAccess, Iterator, RecursiveIterator
{
/**
* @return ($filename is null ? string|false : bool)
*/
public function asXML(?string $filename = null) { }
/**
* @return ($filename is null ? string|false : bool)
*/
public function saveXML(?string $filename = null) { }
}
/**
* @template-covariant TKey
* @template-covariant TValue
* @extends Iterator<TKey, TValue>
*/
interface SeekableIterator extends Iterator
{
}
/**
* @template TKey of array-key
* @template TValue
* @implements SeekableIterator<TKey, TValue>
* @implements ArrayAccess<TKey, TValue>
*/
class ArrayIterator implements SeekableIterator, ArrayAccess, Countable
{
/**
* @param array<TKey, TValue> $array
* @param int $flags
*/
public function __construct($array = array(), $flags = 0) { }
/**
* @param TValue $value
* @return void
*/
public function append($value) { }
/**
* @return array<TKey, TValue>
*/
public function getArrayCopy() { }
/**
* @param callable(TValue, TValue): int $cmp_function
* @return void
*/
public function uasort($cmp_function) { }
/**
* @param callable(TKey, TKey): int $cmp_function
* @return void
*/
public function uksort($cmp_function) { }
}
/**
* @template T of \RecursiveIterator|\IteratorAggregate
* @mixin T
*/
class RecursiveIteratorIterator
{
/**
* @param T $iterator
*/
public function __construct(
$iterator,
int $mode = RecursiveIteratorIterator::LEAVES_ONLY,
int $flags = 0
)
{
}
}
/**
* @template-covariant TKey
* @template-covariant TValue
*
* @template-extends Iterator<TKey, TValue>
*/
interface OuterIterator extends Iterator {
/**
* @return Iterator<TKey, TValue>
*/
public function getInnerIterator();
}
/**
* @template-covariant TKey
* @template-covariant TValue
* @template TIterator as Traversable<TKey, TValue>
*
* @template-implements OuterIterator<TKey, TValue>
*
* @mixin TIterator
*/
class IteratorIterator implements OuterIterator {
/**
* @param TIterator $iterator
*/
public function __construct(Traversable $iterator) {}
}
/**
* @template-covariant TKey
* @template-covariant TValue
* @template TIterator as Traversable<TKey, TValue>
*
* @template-extends IteratorIterator<TKey, TValue, TIterator>
*/
class FilterIterator extends IteratorIterator
{
}
/**
* @template-covariant TKey
* @template-covariant TValue
* @template TIterator as Traversable<TKey, TValue>
*
* @extends FilterIterator<TKey, TValue, TIterator>
*/
class CallbackFilterIterator extends FilterIterator
{
}
/**
* @template-covariant TKey
* @template-covariant TValue
* @template TIterator as Traversable<TKey, TValue>
*
* @extends CallbackFilterIterator<TKey, TValue, TIterator>
* @implements RecursiveIterator<TKey, TValue>
*/
class RecursiveCallbackFilterIterator extends CallbackFilterIterator implements RecursiveIterator
{
/**
* @return bool
*/
public function hasChildren() {}
/**
* @return RecursiveCallbackFilterIterator<TKey, TValue, TIterator>
*/
public function getChildren() {}
}
/**
* @template TKey of array-key
* @template TValue
*
* @template-implements RecursiveIterator<TKey, TValue>
* @template-extends ArrayIterator<TKey, TValue>
*/
class RecursiveArrayIterator extends ArrayIterator implements RecursiveIterator {
/**
* @return RecursiveArrayIterator<TKey, TValue>
*/
public function getChildren() {}
/**
* @return bool
*/
public function hasChildren() {}
/**
* @return TValue
*/
public function current() {}
/**
* @return TKey
*/
public function key() {}
/**
* @param callable(TKey, TKey): int $cmp_function
* @return void
*/
public function uksort($cmp_function) { }
}
/**
* @template TKey
* @template TValue
* @template TIterator as Iterator<TKey, TValue>
*
* @template-extends IteratorIterator<TKey, TValue, TIterator>
*/
class AppendIterator extends IteratorIterator {
/**
* @param TIterator $iterator
* @return void
*/
public function append(Iterator $iterator) {}
/**
* @return ArrayIterator<array-key, TValue>
*/
public function getArrayIterator() {}
}
/**
* @template-covariant TKey
* @template-covariant TValue
* @template TIterator as Iterator<TKey, TValue>
*
* @template-extends IteratorIterator<TKey, TValue, TIterator>
*/
class NoRewindIterator extends IteratorIterator {
/**
* @param TIterator $iterator
*/
public function __construct(Iterator $iterator) {}
/**
* @return TValue
*/
public function current() {}
/**
* @return TKey
*/
public function key() {}
}
/**
* @template-covariant TKey
* @template-covariant TValue
* @template TIterator as Iterator<TKey, TValue>
*
* @template-implements OuterIterator<TKey, TValue>
* @template-extends IteratorIterator<TKey, TValue, TIterator>
*/
class LimitIterator extends IteratorIterator implements OuterIterator {
/**
* @param TIterator $iterator
*/
public function __construct(Iterator $iterator, int $offset = 0, int $count = -1) {}
/**
* @return TValue
*/
public function current() {}
/**
* @return TKey
*/
public function key() {}
}
/**
* @template-covariant TKey
* @template-covariant TValue
* @template TIterator as Iterator<TKey, TValue>
*
* @template-extends IteratorIterator<TKey, TValue, TIterator>
*/
class InfiniteIterator extends IteratorIterator {
/**
* @param TIterator $iterator
*/
public function __construct(Iterator $iterator) {}
/**
* @return TValue
*/
public function current() {}
/**
* @return TKey
*/
public function key() {}
}
/**
* @template TKey
* @template TValue
* @template TIterator as Iterator<TKey, TValue>
*
* @template-implements OuterIterator<TKey, TValue>
* @template-implements ArrayAccess<TKey, TValue>
*
* @template-extends IteratorIterator<TKey, TValue, TIterator>
*/
class CachingIterator extends IteratorIterator implements OuterIterator, ArrayAccess, Countable {
const CALL_TOSTRING = 1 ;
const CATCH_GET_CHILD = 16 ;
const TOSTRING_USE_KEY = 2 ;
const TOSTRING_USE_CURRENT = 4 ;
const TOSTRING_USE_INNER = 8 ;
const FULL_CACHE = 256 ;
/**
* @param TIterator $iterator
* @param int-mask-of<self::*> $flags
*/
public function __construct(Iterator $iterator, int $flags = self::CALL_TOSTRING) {}
/**
* @return TValue
*/
public function current() {}
/**
* @return TKey
*/
public function key() {}
/**
* @return array<array-key, TValue>
*/
public function getCache() {}
}
/**
* @template TKey
* @template TValue
* @template TIterator of Traversable<TKey, TValue>
*
* @template-extends FilterIterator<TKey, TValue, TIterator>
*/
class RegexIterator extends FilterIterator {
const MATCH = 0 ;
const GET_MATCH = 1 ;
const ALL_MATCHES = 2 ;
const SPLIT = 3 ;
const REPLACE = 4 ;
const USE_KEY = 1 ;
/**
* @param Iterator<TKey, TValue> $iterator
* @param self::MATCH|self::GET_MATCH|self::ALL_MATCHES|self::SPLIT|self::REPLACE $mode
*/
public function __construct(Iterator $iterator, string $regex, int $mode = self::MATCH, int $flags = 0, int $preg_flags = 0) {}
/**
* @return TValue
*/
public function current() {}
/**
* @return TKey
*/
public function key() {}
}
/**
* @template-implements Iterator<never, never>
*/
class EmptyIterator implements Iterator {
/**
* @return never
*/
public function current() {}
/**
* @return never
*/
public function key() {}
/**
* @return false
*/
public function valid() {}
}
<?php
/**
* @template TKey
* @template TValue
*/
interface ArrayAccess
{
/**
* @param TKey $offset
* @return bool
*/
public function offsetExists($offset);
/**
* @param TKey $offset
* @return TValue|null
*/
public function offsetGet($offset);
/**
* @param TKey|null $offset
* @param TValue $value
* @return void
*/
public function offsetSet($offset, $value);
/**
* @param TKey $offset
* @return void
*/
public function offsetUnset($offset);
}
/**
* @template TKey of array-key
* @template TValue
* @implements IteratorAggregate<TKey, TValue>
* @implements ArrayAccess<TKey, TValue>
*/
class ArrayObject implements IteratorAggregate, ArrayAccess
{
/**
* @param array<TKey, TValue>|object $input
* @param int $flags
* @param class-string $iterator_class
*/
public function __construct($input = null, $flags = 0, $iterator_class = "ArrayIterator") { }
/**
* @param TValue $value
* @return void
*/
public function append($value) { }
/**
* @return array<TKey, TValue>
*/
public function getArrayCopy() { }
/**
* @param callable(TValue, TValue): int $cmp_function
* @return void
*/
public function uasort($cmp_function) { }
/**
* @param callable(TKey, TKey): int $cmp_function
* @return void
*/
public function uksort($cmp_function) { }
/**
* @return ArrayIterator<TKey, TValue>
*/
public function getIterator() { }
/**
* @param class-string $iterator_class
* @return void
*/
public function setIteratorClass($iterator_class) { }
}
/**
* @template TValue
* @implements Iterator<int, TValue|null>
* @implements IteratorAggregate<int, TValue|null>
* @implements ArrayAccess<int, TValue|null>
*/
class SplFixedArray implements Iterator, IteratorAggregate, ArrayAccess, Countable
{
/**
* @template TInput
* @param array<int, TInput> $array
* @return SplFixedArray<TInput>
*/
public static function fromArray(array $array, bool $save_indexes = true): SplFixedArray { }
/**
* @return array<int, TValue|null>
*/
public function toArray(): array { }
}
<?php
class mysqli
{
/**
* @var int<-1,max>|numeric-string
*/
public $affected_rows;
}
class mysqli_result
{
/**
* @var int<0,max>|numeric-string
*/
public $num_rows;
/**
* @template T of object
* @param class-string<T> $class
* @param array<mixed> $constructor_args
* @return T|null|false
*/
function fetch_object(string $class = 'stdClass', array $constructor_args = []) {}
}
/**
* @template T of object
*
* @param class-string<T> $class
* @param array<mixed> $constructor_args
* @return T|null|false
*/
function mysqli_fetch_object(mysqli_result $result, string $class = 'stdClass', array $constructor_args = []) {}
class mysqli_stmt
{
/**
* @var int<-1,max>|numeric-string
*/
public $affected_rows;
/**
* @var int
*/
public $errno;
/**
* @var list<array{errno: int, sqlstate: string, error: string}>
*/
public $error_list;
/**
* @var string
*/
public $error;
/**
* @var 0|positive-int
*/
public $field_count;
/**
* @var int|string
*/
public $insert_id;
/**
* @var int<0,max>|numeric-string
*/
public $num_rows;
/**
* @var 0|positive-int
*/
public $param_count;
/**
* @var non-empty-string
*/
public $sqlstate;
}
<?php
/**
* @param array<resource>|null &$read
* @param array<resource>|null &$write
* @param array<resource>|null &$except
* @param-out ($read is not null ? array<resource> : null) $read
* @param-out ($write is not null ? array<resource> : null) $write
* @param-out ($except is not null ? array<resource> : null) $except
* @return int|false
*/
function socket_select(?array &$read, ?array &$write, ?array &$except, ?int $seconds, int $microseconds = 0) {}
<?php
interface Countable
{
/**
* @return int
*/
public function count(): int;
}
<?php
/**
* @param positive-int $depth
* @param int-mask<JSON_INVALID_UTF8_IGNORE> $flags
* @phpstan-assert-if-true =non-empty-string $json
*/
function json_validate(string $json, int $depth = 512, int $flags = 0): bool
{
}
<?php
abstract class ReflectionFunctionAbstract
{
/**
* @return string|false
*/
public function getFileName () {}
/**
* @return list<ReflectionAttribute<object>>
*/
public function getAttributes(?string $name = null, int $flags = 0)
{
}
}
<?php
/**
* @param ($allow_string is false ? object : object|string) $object_or_class
* @param string $class
* @param bool $allow_string
* @return ($allow_string is false ? ($object_or_class is object ? bool : false) : bool)
*/
function is_subclass_of($object_or_class, string $class, $allow_string = true): bool{}
/**
* @param ($allow_string is false ? object : object|string) $object_or_class
* @param string $class
* @param bool $allow_string
* @return ($allow_string is false ? ($object_or_class is object ? bool : false) : bool)
*/
function is_a($object_or_class, string $class, $allow_string = false): bool{}
/**
* @param mixed $var
* @param bool $return
* @return ($return is true ? string : null)
*/
function var_export($var, bool $return = false) {}
/**
* @param mixed $var
* @return ($return is true ? string : bool)
*/
function highlight_file($var, bool $return = false) {}
/**
* @param mixed $var
* @return ($return is true ? string : bool)
*/
function show_source($var, bool $return = false) {}
/**
* @param mixed $var
* @param bool $return
* @return ($return is true ? string : true)
*/
function print_r($var, bool $return = false) {}
/**
* @return ($string is non-empty-string ? non-empty-string : string)
*/
function sodium_bin2base64(string $string, int $id): string {}
/**
* @return ($string is non-empty-string ? non-empty-string : string)
*/
function sodium_bin2hex(string $string): string {}
/**
* @return ($string is non-empty-string ? non-empty-string : string)
*/
function base64_encode(string $string) : string {}
/**
* @return ($string is non-empty-string ? non-empty-string : string)
*/
function bin2hex(string $string): string {}
/**
* @return ($string is non-empty-string ? non-empty-string : string)
*/
function str_shuffle(string $string): string {}
/**
* @param array<mixed> $result
* @param-out ($string is lowercase-string ? array<int|string, array<mixed>|lowercase-string> : array<int|string, array<mixed>|string>) $result
*/
function parse_str(string $string, array &$result): void {}
/**
* @param array<mixed> $result
* @param-out array<string, array<mixed>|string> $result
*/
function mb_parse_str(string $string, array &$result): bool {}
/** @param-out float $percent */
function similar_text(string $string1, string $string2, ?float &$percent = null) : int {}
/**
* @param mixed $output
* @param mixed $result_code
*
* @param-out list<string> $output
* @param-out int $result_code
*
* @return string|false
*/
function exec(string $command, &$output, &$result_code) {}
/**
* @param mixed $result_code
* @param-out int $result_code
*
* @return string|false
*/
function system(string $command, &$result_code) {}
/**
* @param mixed $result_code
* @param-out int $result_code
*/
function passthru(string $command, &$result_code): ?bool {}
/**
* @template T
* @template TArray as array<T>
*
* @param TArray $array
*/
function shuffle(array &$array): bool
{
}
/**
* @template T
* @template TArray as array<T>
*
* @param TArray $array
*/
function sort(array &$array, int $flags = SORT_REGULAR): bool
{
}
/**
* @template T
* @template TArray as array<T>
*
* @param TArray $array
*/
function rsort(array &$array, int $flags = SORT_REGULAR): bool
{
}
/**
* @param string $string
* @param-out null $string
*/
function sodium_memzero(string &$string): void
{
}
/**
* @param resource $stream
* @param mixed $vars
* @param-out string|int|float|null $vars
*
* @return list<mixed>|int|false
*/
function fscanf($stream, string $format, &...$vars) {}
/**
* @param mixed $war
* @param mixed $vars
* @param-out string|int|float|null $war
* @param-out string|int|float|null $vars
*
* @return int|array<mixed>|null
*/
function sscanf(string $string, string $format, &$war, &...$vars) {}
/**
* @template TFlags as int
*
* @param string $pattern
* @param string $subject
* @param mixed $matches
* @param TFlags $flags
* @param-out (
* TFlags is 1
* ? array<list<string>>
* : (TFlags is 2
* ? list<array<string>>
* : (TFlags is 256|257
* ? array<list<array{string, int}>>
* : (TFlags is 258
* ? list<array<array{string, int}>>
* : (TFlags is 512|513
* ? array<list<?string>>
* : (TFlags is 514
* ? list<array<?string>>
* : (TFlags is 770
* ? list<array<array{?string, int}>>
* : (TFlags is 0 ? array<list<string>> : array<mixed>)
* )
* )
* )
* )
* )
* )
* ) $matches
* @return int|false
*/
function preg_match_all($pattern, $subject, &$matches = [], int $flags = 1, int $offset = 0) {}
/**
* @template TFlags as int-mask<0, 256, 512>
*
* @param string $pattern
* @param string $subject
* @param mixed $matches
* @param TFlags $flags
* @param-out (
* TFlags is 256
* ? array<array-key, array{string, 0|positive-int}|array{'', -1}>
* : (TFlags is 512
* ? array<array-key, string|null>
* : (TFlags is 768
* ? array<array-key, array{string, 0|positive-int}|array{null, -1}>
* : array<array-key, string>
* )
* )
* ) $matches
* @return 1|0|false
*/
function preg_match($pattern, $subject, &$matches = [], int $flags = 0, int $offset = 0) {}
/**
* @param string|array<mixed> $pattern
* @param callable(array<int|string, string>):string $callback
* @param string|array<mixed> $subject
* @param int $count
* @param-out 0|positive-int $count
* @return ($subject is array ? list<string>|null : string|null)
*/
function preg_replace_callback($pattern, $callback, $subject, int $limit = -1, &$count = null, int $flags = 0) {}
/**
* @param string|array<mixed> $pattern
* @param string|array<mixed> $replacement
* @param string|array<mixed> $subject
* @param int $count
* @param-out 0|positive-int $count
* @return ($subject is array ? list<string>|null : string|null)
*/
function preg_replace($pattern, $replacement, $subject, int $limit = -1, &$count = null) {}
/**
* @param string|array<mixed> $pattern
* @param string|array<mixed> $replacement
* @param string|array<mixed> $subject
* @param int $count
* @param-out 0|positive-int $count
* @return ($subject is array ? list<string> : string|null)
*/
function preg_filter($pattern, $replacement, $subject, int $limit = -1, &$count = null) {}
/**
* @param array<mixed>|string $search
* @param array<mixed>|string $replace
* @param array<mixed>|string $subject
* @param-out int $count
* @return list<string>|string
*/
function str_replace($search, $replace, $subject, ?int &$count = null) {}
/**
* @param array<mixed>|string $search
* @param array<mixed>|string $replace
* @param array<mixed>|string $subject
* @param-out int $count
* @return list<string>|string
*/
function str_ireplace($search, $replace, $subject, ?int &$count = null) {}
/**
* @template TRead of null|array<array-key, resource>
* @template TWrite of null|array<array-key, resource>
* @template TExcept of null|array<array-key, resource>
* @param TRead $read
* @param TWrite $write
* @param TExcept $except
* @return false|0|positive-int
* @param-out (TRead is null ? null : array<array-key, resource>) $read
* @param-out (TWrite is null ? null : array<array-key, resource>) $write
* @param-out (TExcept is null ? null : array<array-key, resource>) $except
*/
function stream_select(?array &$read, ?array &$write, ?array &$except, ?int $seconds, ?int $microseconds = null) {}
/**
* @param resource $stream
* @param-out 0|1 $would_block
*/
function flock($stream, int $operation, mixed &$would_block = null): bool {}
/**
* @param-out int $error_code
* @param-out string $error_message
* @return resource|false
*/
function fsockopen(string $hostname, int $port = -1, ?int &$error_code = null, ?string &$error_message = null, ?float $timeout = null) {}
/**
* @param-out string $filename
* @param-out int $line
*/
function headers_sent(?string &$filename = null, ?int &$line = null): bool {}
/**
* @param-out callable-string $callable_name
* @return ($value is callable ? true : false)
*/
function is_callable(mixed $value, bool $syntax_only = false, ?string &$callable_name = null): bool {}
/**
* @param float|int $num
* @return ($num is float ? float : $num is int ? non-negative-int : float|non-negative-int)
*/
function abs($num) {}
/**
* @return ($string is lowercase-string ? lowercase-string : string)
*/
function trim(string $string, string $characters = " \n\r\t\v\x00"): string {}
/**
* @return ($string is lowercase-string ? lowercase-string : string)
*/
function ltrim(string $string, string $characters = " \n\r\t\v\x00"): string {}
/**
* @return ($string is lowercase-string ? lowercase-string : string)
*/
function rtrim(string $string, string $characters = " \n\r\t\v\x00"): string {}
<?php
/**
* @param array<Socket>|null &$read
* @param array<Socket>|null &$write
* @param array<Socket>|null &$except
* @param-out ($read is not null ? array<Socket> : null) $read
* @param-out ($write is not null ? array<Socket> : null) $write
* @param-out ($except is not null ? array<Socket> : null) $except
*/
function socket_select(?array &$read, ?array &$write, ?array &$except, ?int $seconds, int $microseconds = 0): int|false {}
<?php
class ReflectionMethod
{
/**
* @var class-string
*/
public $class;
/**
* @var non-falsy-string
*/
public $name;
}
<?php
/**
* @template-covariant T of object
*/
class ReflectionClass
{
/**
* @var class-string<T>
*/
public $name;
/**
* @param T|class-string<T> $argument
* @throws ReflectionException
*/
public function __construct($argument) {}
/**
* @return class-string<T>
*/
public function getName() : string;
/**
* @param mixed ...$args
*
* @return T
*/
public function newInstance(...$args) {}
/**
* @param array<int|string, mixed> $args
*
* @return T
*/
public function newInstanceArgs(array $args) {}
/**
* @return T
*/
public function newInstanceWithoutConstructor();
/**
* @return list<ReflectionAttribute<object>>
*/
public function getAttributes(?string $name = null, int $flags = 0)
{
}
}
<?php
declare(strict_types=1);
/**
* @template TValue
* @implements \Iterator<int, TValue>
* @implements \ArrayAccess<int, TValue>
*/
class SplDoublyLinkedList implements \Iterator, \ArrayAccess {
/**
* @param int $index
* @param TValue $newval
* @return void
*/
public function add($index, $newval) {}
/**
* @return TValue
*/
public function pop () {}
/**
* @return TValue
*/
public function shift () {}
/**
* @param TValue $value
* @return void
*/
public function push ($value) {}
/**
* @param TValue $value
* @return void
*/
public function unshift ($value) {}
/**
* @return TValue
*/
public function top () {}
/**
* @return TValue
*/
public function bottom () {}
/**
* @param int $offset
* @return TValue
*/
public function offsetGet ($offset) {}
}
/**
* @template TValue
* @extends \SplDoublyLinkedList<TValue>
*/
class SplQueue extends \SplDoublyLinkedList {
/**
* @param TValue $value
* @return void
*/
public function enqueue ($value) {}
/**
* @return TValue
*/
public function dequeue () {}
}
/**
* @template TPriority
* @template TValue
*
* @implements \Iterator<int, TValue>
*/
class SplPriorityQueue implements \Iterator {
/**
* @param TPriority $priority1
* @param TPriority $priority2
* @return int
*/
public function compare ($priority1, $priority2) {}
/**
* @param TValue $value
* @param TPriority $priority
* @return true
*/
public function insert ($value, $priority) {}
/**
* @return TPriority|TValue|array{priority: TPriority, data: TValue}
*/
public function top () {}
/**
* @return TPriority|TValue|array{priority: TPriority, data: TValue}
*/
public function extract () {}
/**
* @return TPriority|TValue|array{priority: TPriority, data: TValue}
*/
public function current () {}
}
<?php
/**
* @template-covariant T of object
*/
class ReflectionAttribute
{
/**
* @return class-string<T>
*/
public function getName() : string
{
}
/**
* @return T
*/
public function newInstance() : object
{
}
}
<?php
interface Countable
{
/**
* @return 0|positive-int
*/
public function count(): int;
}
<?php declare(strict_types = 1);
namespace PHPStan\Rules;
use PhpParser\Node;
use PHPStan\Analyser\Scope;
/**
* @api
* @phpstan-template TNodeType of Node
*/
interface Rule
{
/**
* @phpstan-return class-string<TNodeType>
*/
public function getNodeType(): string;
/**
* @phpstan-param TNodeType $node
* @return list<IdentifierRuleError>
*/
public function processNode(Node $node, Scope $scope): array;
}
<?php
class ImagickPixel
{
/**
* @return ($normalized is 0 ? array{r: int<0, 255>, g: int<0, 255>, b: int<0, 255>, a: int<0, 1>} : ($normalized is 1 ? array{r: float, g: float, b: float, a: float} : ($normalized is 2 ? array{r: int<0, 255>, g: int<0, 255>, b: int<0, 255>, a: int<0, 255>} : array{})))
*/
public function getColor(int $normalized = 0): array;
}
<?php
/**
* @param resource $connection
* @param \DB2_AUTOCOMMIT_OFF|\DB2_AUTOCOMMIT_ON $value
*
* @return ($value is null ? \DB2_AUTOCOMMIT_OFF|\DB2_AUTOCOMMIT_ON : bool)
*/
function db2_autocommit($connection, ?int $value = null) {}
<?php
interface Throwable
{
/**
* @return string
* @throws void
*/
public function getMessage();
/**
* @return mixed
* @throws void
*/
public function getCode();
/**
* @return string
* @throws void
*/
public function getFile();
/**
* @return int
* @throws void
*/
public function getLine();
/**
* @return list<array{function:string,line?:int,file?:string,class?:class-string,type?:'::'|'->',args?:mixed[],object?:object}>
* @throws void
*/
public function getTrace();
/**
* @return string
* @throws void
*/
public function getTraceAsString();
/**
* @return null|Throwable
* @throws void
*/
public function getPrevious();
/**
* @return string
*/
public function __toString();
}
class Exception implements Throwable
{
/**
* @return string
* @throws void
*/
final public function getMessage(): string {}
/**
* @return mixed
* @throws void
*/
final public function getCode() {}
/**
* @return string
* @throws void
*/
final public function getFile(): string {}
/**
* @return int
* @throws void
*/
final public function getLine(): int {}
/**
* @return list<array{function:string,line?:int,file?:string,class?:class-string,type?:'::'|'->',args?:mixed[],object?:object}>
* @throws void
*/
final public function getTrace(): array {}
/**
* @return null|Throwable
* @throws void
*/
final public function getPrevious(): ?Throwable {}
/**
* @return string
* @throws void
*/
final public function getTraceAsString(): string {}
}
class Error implements Throwable
{
/**
* @return string
* @throws void
*/
final public function getMessage(): string {}
/**
* @return mixed
* @throws void
*/
final public function getCode() {}
/**
* @return string
* @throws void
*/
final public function getFile(): string {}
/**
* @return int
* @throws void
*/
final public function getLine(): int {}
/**
* @return list<array{function:string,line?:int,file?:string,class?:class-string,type?:'::'|'->',args?:mixed[],object?:object}>
* @throws void
*/
final public function getTrace(): array {}
/**
* @return null|Throwable
* @throws void
*/
final public function getPrevious(): ?Throwable {}
/**
* @return string
* @throws void
*/
final public function getTraceAsString(): string {}
}
<?php
/**
* @template-covariant TDate of DateTimeInterface
* @template-covariant TEnd of ?DateTimeInterface
* @template-covariant TRecurrences of ?int
* @implements \IteratorAggregate<int, TDate>
* @implements \Traversable<int, TDate>
*/
class DatePeriod implements \IteratorAggregate, \Traversable
{
/**
* @return TEnd
*/
public function getEndDate()
{
}
/**
* @return TRecurrences
*/
public function getRecurrences()
{
}
/**
* @return TDate
*/
public function getStartDate(): DateTimeInterface
{
}
}
<?php
/**
* @implements Traversable<array<int|string, mixed>>
* @implements IteratorAggregate<array<int|string, mixed>>
* @link https://php.net/manual/en/class.pdostatement.php
*/
class PDOStatement implements Traversable, IteratorAggregate
{
/**
* @template T of object
* @param class-string<T> $class
* @param array<mixed> $ctorArgs
* @return false|T
*/
public function fetchObject($class = \stdClass::class, array $ctorArgs = array()) {}
/**
* @return array{name: string, table?: string, native_type?: string, len: int, flags: array<int, string>, precision: int<0, max>, pdo_type: PDO::PARAM_* }|false
*/
public function getColumnMeta(int $column) {}
}
<?php
class ZipArchive
{
/**
* @var int
*/
public $status;
/**
* @var int
*/
public $statusSys;
/**
* @var int
*/
public $numFiles;
/**
* @var string
*/
public $filename;
/**
* @var string
*/
public $comment;
}
<?php
/**
* @template-covariant T of UnitEnum
* @extends ReflectionClass<T>
*/
class ReflectionEnum extends ReflectionClass
{
/**
* @return (T is BackedEnum ? ReflectionEnumBackedCase[] : ReflectionEnumUnitCase[])
*/
public function getCases(): array {}
/**
* @return (T is BackedEnum ? ReflectionEnumBackedCase : ReflectionEnumUnitCase)
* @throws ReflectionException
*/
public function getCase(string $name): ReflectionEnumUnitCase {}
/**
* @phpstan-assert-if-true self<BackedEnum> $this
* @phpstan-assert-if-true !null $this->getBackingType()
*/
public function isBacked(): bool {}
}
<?php
class DOMDocument
{
/** @var DOMDocumentType|null */
public $doctype;
/** @var DOMElement|null */
public $documentElement;
/** @var null */
public $ownerDocument;
/**
* @param string $name
* @return DOMNodeList<DOMElement>
*/
public function getElementsByTagName ($name) {}
/**
* @param string $namespaceURI
* @param string $localName
* @return DOMNodeList<DOMElement>
*/
public function getElementsByTagNameNS ($namespaceURI, $localName) {}
}
class DOMNode
{
}
class DOMElement extends DOMNode
{
/** @var DOMDocument */
public $ownerDocument;
/**
* @param string $name
* @return DOMNodeList<DOMElement>
*/
public function getElementsByTagName ($name) {}
/**
* @param string $namespaceURI
* @param string $localName
* @return DOMNodeList<DOMElement>
*/
public function getElementsByTagNameNS ($namespaceURI, $localName) {}
}
/**
* @template-covariant TNode as DOMNode
* @implements Traversable<int, TNode>
* @implements IteratorAggregate<int, TNode>
*/
class DOMNodeList implements Traversable, IteratorAggregate, Countable
{
/**
* @param int $index
* @return TNode|null
*/
public function item ($index) {}
}
class DOMXPath
{
/**
* @param string $expression
* @param DOMNode|null $contextNode
* @param boolean $registerNodeNS
* @return DOMNodeList<DOMNode>|false
*/
public function query($expression, $contextNode, $registerNodeNS) {}
}
class DOMAttr
{
/** @var DOMDocument */
public $ownerDocument;
}
class DOMCharacterData
{
/** @var DOMDocument */
public $ownerDocument;
}
class DOMDocumentType
{
/** @var DOMDocument */
public $ownerDocument;
}
class DOMEntity
{
/** @var DOMDocument */
public $ownerDocument;
}
class DOMNotation
{
/** @var DOMDocument */
public $ownerDocument;
}
class DOMProcessingInstruction
{
/** @var DOMDocument */
public $ownerDocument;
/**
* @var string
*/
public $target;
/**
* @var string
*/
public $data;
}
/**
* @property-read int $length
*/
class DOMNamedNodeMap
{
}
class DOMText
{
/** @var string */
public $wholeText;
}
<?php
/**
* @template TObject of object
* @template TData
*
* @template-implements Iterator<int, TObject>
* @template-implements SeekableIterator<int, TObject>
* @template-implements ArrayAccess<TObject, TData>
*/
class SplObjectStorage implements Countable, Iterator, SeekableIterator, Serializable, ArrayAccess
{
/**
* @param \SplObjectStorage<TObject, TData> $storage
*/
public function addAll(SplObjectStorage $storage): void { }
/**
* @param TObject $object
* @param TData $data
*/
public function attach(object $object, $data = null): void { }
/**
* @param TObject $object
*/
public function contains(object $object): bool { }
/**
* @param TObject $object
*/
public function detach(object $object): void { }
/**
* @param TObject $object
*/
public function getHash(object $object): string { }
/**
* @return TData
*/
public function getInfo() { }
/**
* @param \SplObjectStorage<*, *> $storage
*/
public function removeAll(SplObjectStorage $storage): void { }
/**
* @param \SplObjectStorage<*, *> $storage
*/
public function removeAllExcept(SplObjectStorage $storage): void { }
/**
* @param TData $data
*/
public function setInfo($data): void { }
/**
* @param TObject $offset
* @return TData
*/
public function offsetGet($offset);
}
<?php
class ReflectionProperty
{
/**
* @return list<ReflectionAttribute<object>>
*/
public function getAttributes(?string $name = null, int $flags = 0)
{
}
}
<?php
class ReflectionClassConstant
{
/**
* @return list<ReflectionAttribute<object>>
*/
public function getAttributes(?string $name = null, int $flags = 0)
{
}
}
<?php
namespace Ds;
use ArrayAccess;
use Countable;
use JsonSerializable;
use OutOfBoundsException;
use OutOfRangeException;
use IteratorAggregate;
use UnderflowException;
/**
* @template-covariant TKey
* @template-covariant TValue
* @extends IteratorAggregate<TKey, TValue>
*/
interface Collection extends IteratorAggregate, Countable, JsonSerializable
{
/**
* @return static
*/
public function copy();
/**
* @return array<TKey, TValue>
*/
public function toArray(): array;
}
/**
* @template TValue
* @implements Sequence<TValue>
*/
final class Deque implements Sequence
{
/**
* @param iterable<TValue> $values
*/
public function __construct(iterable $values = [])
{
}
/**
* @return Deque<TValue>
*/
public function copy()
{
}
/**
* @template TValue2
* @param iterable<TValue2> $values
* @return Deque<TValue|TValue2>
*/
public function merge(iterable $values): Deque
{
}
/**
* @param (callable(TValue): bool)|null $callback
* @return Deque<TValue>
*/
public function filter(?callable $callback = null): Deque
{
}
/**
* @template TNewValue
* @param callable(TValue): TNewValue $callback
* @return Deque<TNewValue>
*/
public function map(callable $callback): Deque
{
}
/**
* @return Deque<TValue>
*/
public function reversed(): Deque
{
}
/**
* @return Deque<TValue>
*/
public function slice(int $offset, ?int $length = null): Deque
{
}
}
/**
* @template TKey
* @template TValue
* @implements Collection<TKey, TValue>
* @implements ArrayAccess<TKey, TValue>
*/
final class Map implements Collection, ArrayAccess
{
/**
* @param iterable<TKey, TValue> $values
*/
public function __construct(iterable $values = [])
{
}
/**
* @return Map<TKey, TValue>
*/
public function copy(): Map
{
}
/**
* @param callable(TKey, TValue): TValue $callback
* @return void
*/
public function apply(callable $callback)
{
}
/**
* @return Pair<TKey, TValue>
* @throws UnderflowException
*/
public function first(): Pair
{
}
/**
* @return Pair<TKey, TValue>
* @throws UnderflowException
*/
public function last(): Pair
{
}
/**
* @return Pair<TKey, TValue>
* @throws OutOfRangeException
*/
public function skip(int $position): Pair
{
}
/**
* @template TKey2
* @template TValue2
* @param iterable<TKey2, TValue2> $values
* @return Map<TKey|TKey2, TValue|TValue2>
*/
public function merge(iterable $values): Map
{
}
/**
* @template TKey2
* @template TValue2
* @param Map<TKey2, TValue2> $map
* @return Map<TKey&TKey2, TValue>
*/
public function intersect(Map $map): Map
{
}
/**
* @template TValue2
* @param Map<TKey, TValue2> $map
* @return Map<TKey, TValue>
*/
public function diff(Map $map): Map
{
}
/**
* @param TKey $key
*/
public function hasKey($key): bool
{
}
/**
* @param TValue $value
*/
public function hasValue($value): bool
{
}
/**
* @param (callable(TKey, TValue): bool)|null $callback
* @return Map<TKey, TValue>
*/
public function filter(?callable $callback = null): Map
{
}
/**
* @template TDefault
* @param TKey $key
* @param TDefault $default
* @return TValue|TDefault
* @throws OutOfBoundsException
*/
public function get($key, $default = null)
{
}
/**
* @return Set<TKey>
*/
public function keys(): Set
{
}
/**
* @template TNewValue
* @param callable(TKey, TValue): TNewValue $callback
* @return Map<TKey, TNewValue>
*/
public function map(callable $callback): Map
{
}
/**
* @return Sequence<Pair<TKey, TValue>>
*/
public function pairs(): Sequence
{
}
/**
* @param TKey $key
* @param TValue $value
* @return void
*/
public function put($key, $value)
{
}
/**
* @param iterable<TKey, TValue> $values
* @return void
*/
public function putAll(iterable $values)
{
}
/**
* @template TCarry
* @param callable(TCarry, TKey, TValue): TCarry $callback
* @param TCarry $initial
* @return TCarry
*/
public function reduce(callable $callback, $initial = null)
{
}
/**
* @template TDefault
* @param TKey $key
* @param TDefault $default
* @return TValue|TDefault
* @throws \OutOfBoundsException
*/
public function remove($key, $default = null)
{
}
/**
* @return Map<TKey, TValue>
*/
public function reversed(): Map
{
}
/**
* @return Map<TKey, TValue>
*/
public function slice(int $offset, ?int $length = null): Map
{
}
/**
* @param (callable(TValue, TValue): int)|null $comparator
* @return void
*/
public function sort(?callable $comparator = null)
{
}
/**
* @param (callable(TValue, TValue): int)|null $comparator
* @return Map<TKey, TValue>
*/
public function sorted(?callable $comparator = null): Map
{
}
/**
* @param (callable(TKey, TKey): int)|null $comparator
* @return void
*/
public function ksort(?callable $comparator = null)
{
}
/**
* @param (callable(TKey, TKey): int)|null $comparator
* @return Map<TKey, TValue>
*/
public function ksorted(?callable $comparator = null): Map
{
}
/**
* @return array<TKey, TValue>
*/
public function toArray(): array
{
}
/**
* @return Sequence<TValue>
*/
public function values(): Sequence
{
}
/**
* @template TKey2
* @template TValue2
* @param Map<TKey2, TValue2> $map
* @return Map<TKey|TKey2, TValue|TValue2>
*/
public function union(Map $map): Map
{
}
/**
* @template TKey2
* @template TValue2
* @param Map<TKey2, TValue2> $map
* @return Map<TKey|TKey2, TValue|TValue2>
*/
public function xor(Map $map): Map
{
}
}
/**
* @template-covariant TKey
* @template-covariant TValue
*/
final class Pair implements JsonSerializable
{
/**
* @var TKey
*/
public $key;
/**
* @var TValue
*/
public $value;
/**
* @param TKey $key
* @param TValue $value
*/
public function __construct($key = null, $value = null)
{
}
/**
* @return Pair<TKey, TValue>
*/
public function copy(): Pair
{
}
}
/**
* @template TValue
* @extends Collection<int, TValue>
* @extends ArrayAccess<int, TValue>
*/
interface Sequence extends Collection, ArrayAccess
{
/**
* @param callable(TValue): TValue $callback
* @return void
*/
public function apply(callable $callback);
/**
* @param TValue ...$values
*/
public function contains(...$values): bool;
/**
* @param (callable(TValue): bool)|null $callback
* @return Sequence<TValue>
*/
public function filter(?callable $callback = null);
/**
* @param TValue $value
* @return int|false
*/
public function find($value);
/**
* @return TValue
* @throws \UnderflowException
*/
public function first();
/**
* @return TValue
* @throws \OutOfRangeException
*/
public function get(int $index);
/**
* @param TValue ...$values
* @throws \OutOfRangeException
* @return void
*/
public function insert(int $index, ...$values);
/**
* @param string $glue
* @return string
*/
public function join(?string $glue = null): string;
/**
* @return TValue
* @throws \UnderflowException
*/
public function last();
/**
* @template TNewValue
* @param callable(TValue): TNewValue $callback
* @return Sequence<TNewValue>
*/
public function map(callable $callback);
/**
* @template TValue2
* @param iterable<TValue2> $values
* @return Sequence<TValue|TValue2>
*/
public function merge(iterable $values);
/**
* @return TValue
* @throws \UnderflowException
* @phpstan-impure
*/
public function pop();
/**
* @param TValue ...$values
* @return void
*/
public function push(...$values);
/**
* @template TCarry
* @param callable(TCarry, TValue): TCarry $callback
* @param TCarry $initial
* @return TCarry
*/
public function reduce(callable $callback, $initial = null);
/**
* @return TValue
* @throws \OutOfRangeException
*/
public function remove(int $index);
/**
* @return Sequence<TValue>
*/
public function reversed();
/**
* @param TValue $value
* @throws \OutOfRangeException
* @return void
*/
public function set(int $index, $value);
/**
* @return TValue
* @throws \UnderflowException
* @phpstan-impure
*/
public function shift();
/**
* @return Sequence<TValue>
*/
public function slice(int $index, ?int $length = null);
/**
* @param (callable(TValue, TValue): int)|null $comparator
* @return void
*/
public function sort(?callable $comparator = null);
/**
* @param (callable(TValue, TValue): int)|null $comparator
* @return Sequence<TValue>
*/
public function sorted(?callable $comparator = null);
/**
* @param TValue ...$values
* @return void
*/
public function unshift(...$values);
}
/**
* @template TValue
* @implements Sequence<TValue>
*/
final class Vector implements Sequence
{
/**
* @param iterable<TValue> $values
*/
public function __construct(iterable $values = [])
{
}
/**
* @return Vector<TValue>
*/
public function copy()
{
}
/**
* @return Vector<TValue>
*/
public function reversed(): Vector
{
}
/**
* @return Vector<TValue>
*/
public function slice(int $offset, ?int $length = null): Vector
{
}
/**
* @param (callable(TValue, TValue): int)|null $comparator
* @return Vector<TValue>
*/
public function sorted(?callable $comparator = null): Vector
{
}
/**
* @param (callable(TValue): bool)|null $callback
* @return Vector<TValue>
*/
public function filter(?callable $callback = null): Vector
{
}
/**
* @template TNewValue
* @param callable(TValue): TNewValue $callback
* @return Vector<TNewValue>
*/
public function map(callable $callback): Vector
{
}
/**
* @template TValue2
* @param iterable<TValue2> $values
* @return Vector<TValue|TValue2>
*/
public function merge(iterable $values): Vector
{
}
}
/**
* @template TValue
* @implements Collection<int, TValue>
* @implements ArrayAccess<int, TValue>
*/
final class Set implements Collection, ArrayAccess
{
/**
* @param iterable<TValue> $values
*/
public function __construct(iterable $values = [])
{
}
/**
* @param TValue ...$values
*/
public function add(...$values): void
{
}
/**
* @param TValue ...$values
*/
public function contains(...$values): bool
{
}
/**
* @return Set<TValue>
*/
public function copy(): Set
{
}
/**
* @template TValue2
* @param Set<TValue2> $set
* @return Set<TValue>
*/
public function diff(Set $set): Set
{
}
/**
* @param (callable(TValue): bool)|null $callback
* @return Set<TValue>
*/
public function filter(?callable $callback = null): Set
{
}
/**
* @return TValue
* @throws \UnderflowException
*/
public function first()
{
}
/**
* @return TValue
* @throws \OutOfRangeException
*/
public function get(int $index)
{
}
/**
* @template TValue2
* @param Set<TValue2> $set
* @return Set<TValue&TValue2>
*/
public function intersect(Set $set): Set
{
}
/**
* @return TValue
* @throws \UnderflowException
*/
public function last()
{
}
/**
* @template TNewValue
* @param callable(TValue): TNewValue $callback
* @return Set<TNewValue>
*/
public function map(callable $callback): Set
{
}
/**
* @template TValue2
* @param iterable<TValue2> $values
* @return Set<TValue|TValue2>
*/
public function merge(iterable $values): Set
{
}
/**
* @template TCarry
* @param callable(TCarry, TValue): TCarry $callback
* @param TCarry $initial
* @return TCarry
*/
public function reduce(callable $callback, $initial = null)
{
}
/**
* @param TValue ...$values
*/
public function remove(...$values): void
{
}
/**
* @return Set<TValue>
*/
public function reversed(): Set
{
}
/**
* @return Set<TValue>
*/
public function slice(int $index, ?int $length = null): Set
{
}
/**
* @param (callable(TValue, TValue): int)|null $comparator
*/
public function sort(?callable $comparator = null): void
{
}
/**
* @param (callable(TValue, TValue): int)|null $comparator
* @return Set<TValue>
*/
public function sorted(?callable $comparator = null): Set
{
}
/**
* @return list<TValue>
*/
public function toArray(): array
{
}
/**
* @template TValue2
* @param Set<TValue2> $set
* @return Set<TValue|TValue2>
*/
public function union(Set $set): Set
{
}
/**
* @template TValue2
* @param Set<TValue2> $set
* @return Set<TValue|TValue2>
*/
public function xor(Set $set): Set
{
}
}
/**
* @template TValue
* @implements Collection<int, TValue>
* @implements ArrayAccess<int, TValue>
*/
final class Stack implements Collection, ArrayAccess
{
/**
* @param iterable<TValue> $values
*/
public function __construct(iterable $values = [])
{
}
/**
* @return Stack<TValue>
*/
public function copy(): Stack
{
}
/**
* @return TValue
* @throws UnderflowException
*/
public function peek()
{
}
/**
* @return TValue
* @throws UnderflowException
* @phpstan-impure
*/
public function pop()
{
}
/**
* @param TValue ...$values
* @return void
*/
public function push(...$values): void
{
}
/**
* @return list<TValue>
*/
public function toArray(): array
{
}
}
/**
* @template TValue
* @implements Collection<int, TValue>
* @implements ArrayAccess<int, TValue>
*/
final class Queue implements Collection, ArrayAccess
{
/**
* @param iterable<TValue> $values
*/
public function __construct(iterable $values = [])
{
}
/**
* @return Queue<TValue>
*/
public function copy(): Queue
{
}
/**
* @return TValue
* @throws UnderflowException
*/
public function peek()
{
}
/**
* @return TValue
* @throws UnderflowException
* @phpstan-impure
*/
public function pop()
{
}
/**
* @param TValue ...$values
*/
public function push(...$values): void
{
}
/**
* @return list<TValue>
*/
public function toArray(): array
{
}
}
/**
* @template TValue
* @implements Collection<int, TValue>
*/
final class PriorityQueue implements Collection
{
/**
* @return PriorityQueue<TValue>
*/
public function copy(): PriorityQueue
{
}
/**
* @return TValue
* @throws UnderflowException
*/
public function peek()
{
}
/**
* @return TValue
* @throws UnderflowException
* @phpstan-impure
*/
public function pop()
{
}
/**
* @param TValue $value
*/
public function push($value, int $priority): void
{
}
/**
* @return list<TValue>
*/
public function toArray(): array
{
}
}
<?php
/**
* @template-covariant T as object
*/
final class WeakReference
{
/**
* @template TIn as object
* @param TIn $referent
* @return WeakReference<TIn>
*/
public static function create(object $referent): WeakReference {}
/** @return ?T */
public function get() {}
}
/**
* @template TKey of object
* @template TValue
* @implements \ArrayAccess<TKey, TValue>
* @implements \IteratorAggregate<TKey, TValue>
*/
final class WeakMap implements \ArrayAccess, \Countable, \IteratorAggregate
{
/**
* @param TKey $offset
* @return TValue
*/
public function offsetGet($offset) {}
}
<?php
if (\PHP_VERSION_ID < 80100) {
if (interface_exists('UnitEnum', false)) {
return;
}
interface UnitEnum
{
/**
* @return list<static>
*/
public static function cases(): array;
}
}
<?php
if (\PHP_VERSION_ID < 80100) {
if (class_exists('ReflectionEnumBackedCase', false)) {
return;
}
class ReflectionEnumBackedCase extends ReflectionEnumUnitCase
{
public function getBackingValue(): int|string
{
}
}
}
<?php
if (\PHP_VERSION_ID < 80100) {
if (interface_exists('BackedEnum', false)) {
return;
}
interface BackedEnum extends UnitEnum
{
public static function from(int|string $value): static;
public static function tryFrom(int|string $value): ?static;
}
}
<?php
if (\PHP_VERSION_ID < 80100) {
if (class_exists('ReflectionEnumUnitCase', false)) {
return;
}
class ReflectionEnumUnitCase extends ReflectionClassConstant
{
public function __construct(object|string $class, string $constant)
{
}
public function getValue(): UnitEnum
{
}
/**
* @return ReflectionEnum
*/
public function getEnum(): ReflectionEnum
{
}
}
}
<?php
if (\PHP_VERSION_ID < 80100) {
if (class_exists('ReflectionEnum', false)) {
return;
}
class ReflectionEnum extends ReflectionClass
{
public function __construct(object|string $objectOrClass) {}
public function hasCase(string $name): bool
{
}
public function getCases(): array
{
}
public function getCase(string $name): ReflectionEnumUnitCase
{
}
public function isBacked(): bool
{
}
public function getBackingType(): ?ReflectionType
{
}
}
}
<?php
if (\PHP_VERSION_ID < 80000 && !class_exists('Attribute', false)) {
#[Attribute(Attribute::TARGET_CLASS)]
class Attribute
{
/** @var int */
public $flags;
/**
* Marks that attribute declaration is allowed only in classes.
*/
const TARGET_CLASS = 1;
/**
* Marks that attribute declaration is allowed only in functions.
*/
const TARGET_FUNCTION = 1 << 1;
/**
* Marks that attribute declaration is allowed only in class methods.
*/
const TARGET_METHOD = 1 << 2;
/**
* Marks that attribute declaration is allowed only in class properties.
*/
const TARGET_PROPERTY = 1 << 3;
/**
* Marks that attribute declaration is allowed only in class constants.
*/
const TARGET_CLASS_CONSTANT = 1 << 4;
/**
* Marks that attribute declaration is allowed only in function or method parameters.
*/
const TARGET_PARAMETER = 1 << 5;
/**
* Marks that attribute declaration is allowed anywhere.
*/
const TARGET_ALL = (1 << 6) - 1;
/**
* Notes that an attribute declaration in the same place is
* allowed multiple times.
*/
const IS_REPEATABLE = 1 << 6;
/**
* @param int $flags A value in the form of a bitmask indicating the places
* where attributes can be defined.
*/
public function __construct($flags = self::TARGET_ALL)
{
$this->flags = $flags;
}
}
}
if (\PHP_VERSION_ID < 80100 && !class_exists('ReturnTypeWillChange', false)) {
#[Attribute(Attribute::TARGET_METHOD)]
final class ReturnTypeWillChange
{
}
}
if (\PHP_VERSION_ID < 80200 && !class_exists('AllowDynamicProperties', false)) {
#[Attribute(Attribute::TARGET_CLASS)]
final class AllowDynamicProperties
{
}
}
if (\PHP_VERSION_ID < 80200 && !class_exists('SensitiveParameter', false)) {
#[Attribute(Attribute::TARGET_PARAMETER)]
final class SensitiveParameter
{
}
}
<?php
if (\PHP_VERSION_ID < 80000) {
if (class_exists('ReflectionAttribute', false)) {
return;
}
class ReflectionAttribute
{
public const IS_INSTANCEOF = 2;
public function getName(): string
{
}
public function getTarget(): int
{
}
public function isRepeated(): bool
{
}
public function getArguments(): array
{
}
public function newInstance(): object
{
}
private function __clone()
{
}
private function __construct()
{
}
}
}
<?php
if (\PHP_VERSION_ID < 80100) {
if (class_exists('ReflectionIntersectionType', false)) {
return;
}
class ReflectionIntersectionType extends ReflectionType
{
/** @return ReflectionType[] */
public function getTypes()
{
return [];
}
}
}
<?php
if (\PHP_VERSION_ID < 80000) {
if (class_exists('ReflectionUnionType', false)) {
return;
}
class ReflectionUnionType extends ReflectionType
{
/** @return ReflectionType[] */
public function getTypes()
{
return [];
}
}
}
<?php
class ReflectionParameter
{
/**
* @return list<ReflectionAttribute<object>>
*/
public function getAttributes(?string $name = null, int $flags = 0)
{
}
}
<?php
/**
* @return ($value is string ? true : false)
*/
function is_string(mixed $value): bool
{
}
/**
* @return ($value is float ? true : false)
*/
function is_float(mixed $value): bool
{
}
/**
* @return ($value is float ? true : false)
*/
function is_double(mixed $value): bool
{
}
/**
* @return ($value is float ? true : false)
*/
function is_real(mixed $value): bool
{
}
/**
* @return ($value is float|int|numeric-string ? true : false)
*/
function is_numeric(mixed $value): bool
{
}
/**
* @return ($value is null ? true : false)
*/
function is_null(mixed $value): bool
{
}
/**
* @return ($value is bool ? true : false)
*/
function is_bool(mixed $value): bool
{
}
/**
* @return ($value is array<array-key, mixed>|\Countable ? true : false)
*/
function is_countable(mixed $value): bool
{
}
/**
* @return ($value is object ? true : false)
*/
function is_object(mixed $value): bool
{
}
/**
* @return ($value is scalar ? true : false)
*/
function is_scalar(mixed $value): bool
{
}
/**
* @return ($value is int ? true : false)
*/
function is_int(mixed $value): bool
{
}
/**
* @return ($value is int ? true : false)
*/
function is_integer(mixed $value): bool
{
}
/**
* @return ($value is int ? true : false)
*/
function is_long(mixed $value): bool
{
}
/**
* @phpstan-assert-if-true =resource $value
* @return bool
*/
function is_resource(mixed $value): bool
{
}
/**
* @return ($value is array ? true : false)
*/
function is_array(mixed $value): bool
{
}
/**
* @return ($value is iterable<mixed, mixed> ? true : false)
*/
function is_iterable(mixed $value): bool
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Contracts\Service;
/**
* Provides a way to reset an object to its initial state.
*
* When calling the "reset()" method on an object, it should be put back to its
* initial state. This usually means clearing any internal buffers and forwarding
* the call to internal dependencies. All properties of the object should be put
* back to the same state it had when it was first ready to use.
*
* This method could be called, for example, to recycle objects that are used as
* services, so that they can be used to handle several requests in the same
* process loop (note that we advise making your services stateless instead of
* implementing this interface when possible.)
*/
interface ResetInterface
{
public function reset();
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Contracts\Service\Attribute;
/**
* A required dependency.
*
* This attribute indicates that a property holds a required dependency. The annotated property or method should be
* considered during the instantiation process of the containing class.
*
* @author Alexander M. Turek <me@derrabus.de>
*/
#[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY)]
final class Required
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Contracts\Service\Attribute;
use _PHPStan_6dcda722c\Symfony\Contracts\Service\ServiceSubscriberTrait;
/**
* Use with {@see ServiceSubscriberTrait} to mark a method's return type
* as a subscribed service.
*
* @author Kevin Bond <kevinbond@gmail.com>
*/
#[\Attribute(\Attribute::TARGET_METHOD)]
final class SubscribedService
{
/**
* @param string|null $key The key to use for the service
* If null, use "ClassName::methodName"
*/
public function __construct(public ?string $key = null)
{
}
}
Copyright (c) 2018-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Contracts\Service;
/**
* A ServiceSubscriber exposes its dependencies via the static {@link getSubscribedServices} method.
*
* The getSubscribedServices method returns an array of service types required by such instances,
* optionally keyed by the service names used internally. Service types that start with an interrogation
* mark "?" are optional, while the other ones are mandatory service dependencies.
*
* The injected service locators SHOULD NOT allow access to any other services not specified by the method.
*
* It is expected that ServiceSubscriber instances consume PSR-11-based service locators internally.
* This interface does not dictate any injection method for these service locators, although constructor
* injection is recommended.
*
* @author Nicolas Grekas <p@tchwork.com>
*/
interface ServiceSubscriberInterface
{
/**
* Returns an array of service types required by such instances, optionally keyed by the service names used internally.
*
* For mandatory dependencies:
*
* * ['logger' => 'Psr\Log\LoggerInterface'] means the objects use the "logger" name
* internally to fetch a service which must implement Psr\Log\LoggerInterface.
* * ['loggers' => 'Psr\Log\LoggerInterface[]'] means the objects use the "loggers" name
* internally to fetch an iterable of Psr\Log\LoggerInterface instances.
* * ['Psr\Log\LoggerInterface'] is a shortcut for
* * ['Psr\Log\LoggerInterface' => 'Psr\Log\LoggerInterface']
*
* otherwise:
*
* * ['logger' => '?Psr\Log\LoggerInterface'] denotes an optional dependency
* * ['loggers' => '?Psr\Log\LoggerInterface[]'] denotes an optional iterable dependency
* * ['?Psr\Log\LoggerInterface'] is a shortcut for
* * ['Psr\Log\LoggerInterface' => '?Psr\Log\LoggerInterface']
*
* @return string[] The required service types, optionally keyed by service names
*/
public static function getSubscribedServices();
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Contracts\Service;
use _PHPStan_6dcda722c\Psr\Container\ContainerExceptionInterface;
use _PHPStan_6dcda722c\Psr\Container\NotFoundExceptionInterface;
// Help opcache.preload discover always-needed symbols
\class_exists(ContainerExceptionInterface::class);
\class_exists(NotFoundExceptionInterface::class);
/**
* A trait to help implement ServiceProviderInterface.
*
* @author Robin Chalas <robin.chalas@gmail.com>
* @author Nicolas Grekas <p@tchwork.com>
*/
trait ServiceLocatorTrait
{
private $factories;
private $loading = [];
private $providedTypes;
/**
* @param callable[] $factories
*/
public function __construct(array $factories)
{
$this->factories = $factories;
}
/**
* {@inheritdoc}
*
* @return bool
*/
public function has(string $id)
{
return isset($this->factories[$id]);
}
/**
* {@inheritdoc}
*
* @return mixed
*/
public function get(string $id)
{
if (!isset($this->factories[$id])) {
throw $this->createNotFoundException($id);
}
if (isset($this->loading[$id])) {
$ids = \array_values($this->loading);
$ids = \array_slice($this->loading, \array_search($id, $ids));
$ids[] = $id;
throw $this->createCircularReferenceException($id, $ids);
}
$this->loading[$id] = $id;
try {
return $this->factories[$id]($this);
} finally {
unset($this->loading[$id]);
}
}
/**
* {@inheritdoc}
*/
public function getProvidedServices() : array
{
if (null === $this->providedTypes) {
$this->providedTypes = [];
foreach ($this->factories as $name => $factory) {
if (!\is_callable($factory)) {
$this->providedTypes[$name] = '?';
} else {
$type = (new \ReflectionFunction($factory))->getReturnType();
$this->providedTypes[$name] = $type ? ($type->allowsNull() ? '?' : '') . ($type instanceof \ReflectionNamedType ? $type->getName() : $type) : '?';
}
}
}
return $this->providedTypes;
}
private function createNotFoundException(string $id) : NotFoundExceptionInterface
{
if (!($alternatives = \array_keys($this->factories))) {
$message = 'is empty...';
} else {
$last = \array_pop($alternatives);
if ($alternatives) {
$message = \sprintf('only knows about the "%s" and "%s" services.', \implode('", "', $alternatives), $last);
} else {
$message = \sprintf('only knows about the "%s" service.', $last);
}
}
if ($this->loading) {
$message = \sprintf('The service "%s" has a dependency on a non-existent service "%s". This locator %s', \end($this->loading), $id, $message);
} else {
$message = \sprintf('Service "%s" not found: the current service locator %s', $id, $message);
}
return new class($message) extends \InvalidArgumentException implements NotFoundExceptionInterface
{
};
}
private function createCircularReferenceException(string $id, array $path) : ContainerExceptionInterface
{
return new class(\sprintf('Circular reference detected for service "%s", path: "%s".', $id, \implode(' -> ', $path))) extends \RuntimeException implements ContainerExceptionInterface
{
};
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Contracts\Service;
use _PHPStan_6dcda722c\Psr\Container\ContainerInterface;
use _PHPStan_6dcda722c\Symfony\Contracts\Service\Attribute\SubscribedService;
/**
* Implementation of ServiceSubscriberInterface that determines subscribed services from
* method return types. Service ids are available as "ClassName::methodName".
*
* @author Kevin Bond <kevinbond@gmail.com>
*/
trait ServiceSubscriberTrait
{
/** @var ContainerInterface */
protected $container;
/**
* {@inheritdoc}
*/
public static function getSubscribedServices() : array
{
$services = \method_exists(\get_parent_class(self::class) ?: '', __FUNCTION__) ? parent::getSubscribedServices() : [];
$attributeOptIn = \false;
if (\PHP_VERSION_ID >= 80000) {
foreach ((new \ReflectionClass(self::class))->getMethods() as $method) {
if (self::class !== $method->getDeclaringClass()->name) {
continue;
}
if (!($attribute = $method->getAttributes(SubscribedService::class)[0] ?? null)) {
continue;
}
if ($method->isStatic() || $method->isAbstract() || $method->isGenerator() || $method->isInternal() || $method->getNumberOfRequiredParameters()) {
throw new \LogicException(\sprintf('Cannot use "%s" on method "%s::%s()" (can only be used on non-static, non-abstract methods with no parameters).', SubscribedService::class, self::class, $method->name));
}
if (!($returnType = $method->getReturnType())) {
throw new \LogicException(\sprintf('Cannot use "%s" on methods without a return type in "%s::%s()".', SubscribedService::class, $method->name, self::class));
}
$serviceId = $returnType instanceof \ReflectionNamedType ? $returnType->getName() : (string) $returnType;
if ($returnType->allowsNull()) {
$serviceId = '?' . $serviceId;
}
$services[$attribute->newInstance()->key ?? self::class . '::' . $method->name] = $serviceId;
$attributeOptIn = \true;
}
}
if (!$attributeOptIn) {
foreach ((new \ReflectionClass(self::class))->getMethods() as $method) {
if ($method->isStatic() || $method->isAbstract() || $method->isGenerator() || $method->isInternal() || $method->getNumberOfRequiredParameters()) {
continue;
}
if (self::class !== $method->getDeclaringClass()->name) {
continue;
}
if (!($returnType = $method->getReturnType()) instanceof \ReflectionNamedType) {
continue;
}
if ($returnType->isBuiltin()) {
continue;
}
if (\PHP_VERSION_ID >= 80000) {
trigger_deprecation('symfony/service-contracts', '2.5', 'Using "%s" in "%s" without using the "%s" attribute on any method is deprecated.', ServiceSubscriberTrait::class, self::class, SubscribedService::class);
}
$services[self::class . '::' . $method->name] = '?' . ($returnType instanceof \ReflectionNamedType ? $returnType->getName() : $returnType);
}
}
return $services;
}
/**
* @required
*
* @return ContainerInterface|null
*/
public function setContainer(ContainerInterface $container)
{
$ret = null;
if (\method_exists(\get_parent_class(self::class) ?: '', __FUNCTION__)) {
$ret = parent::setContainer($container);
}
$this->container = $container;
return $ret;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Contracts\Service;
use _PHPStan_6dcda722c\Psr\Container\ContainerInterface;
/**
* A ServiceProviderInterface exposes the identifiers and the types of services provided by a container.
*
* @author Nicolas Grekas <p@tchwork.com>
* @author Mateusz Sip <mateusz.sip@gmail.com>
*/
interface ServiceProviderInterface extends ContainerInterface
{
/**
* Returns an associative array of service types keyed by the identifiers provided by the current container.
*
* Examples:
*
* * ['logger' => 'Psr\Log\LoggerInterface'] means the object provides a service named "logger" that implements Psr\Log\LoggerInterface
* * ['foo' => '?'] means the container provides service name "foo" of unspecified type
* * ['bar' => '?Bar\Baz'] means the container provides a service "bar" of type Bar\Baz|null
*
* @return string[] The provided service types, keyed by service names
*/
public function getProvidedServices() : array;
}
Copyright (c) 2020-present Fabien Potencier
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_6dcda722c;
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (!\function_exists('_PHPStan_6dcda722c\\trigger_deprecation')) {
/**
* Triggers a silenced deprecation notice.
*
* @param string $package The name of the Composer package that is triggering the deprecation
* @param string $version The version of the package that introduced the deprecation
* @param string $message The message of the deprecation
* @param mixed ...$args Values to insert in the message using printf() formatting
*
* @author Nicolas Grekas <p@tchwork.com>
*/
function trigger_deprecation(string $package, string $version, string $message, mixed ...$args) : void
{
@\trigger_error(($package || $version ? "Since {$package} {$version}: " : '') . ($args ? \vsprintf($message, $args) : $message), \E_USER_DEPRECATED);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use Symfony\Polyfill\Intl\Grapheme as p;
if (extension_loaded('intl')) {
return;
}
if (\PHP_VERSION_ID >= 80000) {
return require __DIR__.'/bootstrap80.php';
}
if (!defined('GRAPHEME_EXTR_COUNT')) {
define('GRAPHEME_EXTR_COUNT', 0);
}
if (!defined('GRAPHEME_EXTR_MAXBYTES')) {
define('GRAPHEME_EXTR_MAXBYTES', 1);
}
if (!defined('GRAPHEME_EXTR_MAXCHARS')) {
define('GRAPHEME_EXTR_MAXCHARS', 2);
}
if (!function_exists('grapheme_extract')) {
function grapheme_extract($haystack, $size, $type = 0, $start = 0, &$next = 0) { return p\Grapheme::grapheme_extract($haystack, $size, $type, $start, $next); }
}
if (!function_exists('grapheme_stripos')) {
function grapheme_stripos($haystack, $needle, $offset = 0) { return p\Grapheme::grapheme_stripos($haystack, $needle, $offset); }
}
if (!function_exists('grapheme_stristr')) {
function grapheme_stristr($haystack, $needle, $beforeNeedle = false) { return p\Grapheme::grapheme_stristr($haystack, $needle, $beforeNeedle); }
}
if (!function_exists('grapheme_strlen')) {
function grapheme_strlen($input) { return p\Grapheme::grapheme_strlen($input); }
}
if (!function_exists('grapheme_strpos')) {
function grapheme_strpos($haystack, $needle, $offset = 0) { return p\Grapheme::grapheme_strpos($haystack, $needle, $offset); }
}
if (!function_exists('grapheme_strripos')) {
function grapheme_strripos($haystack, $needle, $offset = 0) { return p\Grapheme::grapheme_strripos($haystack, $needle, $offset); }
}
if (!function_exists('grapheme_strrpos')) {
function grapheme_strrpos($haystack, $needle, $offset = 0) { return p\Grapheme::grapheme_strrpos($haystack, $needle, $offset); }
}
if (!function_exists('grapheme_strstr')) {
function grapheme_strstr($haystack, $needle, $beforeNeedle = false) { return p\Grapheme::grapheme_strstr($haystack, $needle, $beforeNeedle); }
}
if (!function_exists('grapheme_substr')) {
function grapheme_substr($string, $offset, $length = null) { return p\Grapheme::grapheme_substr($string, $offset, $length); }
}
Copyright (c) 2015-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use Symfony\Polyfill\Intl\Grapheme as p;
if (!defined('GRAPHEME_EXTR_COUNT')) {
define('GRAPHEME_EXTR_COUNT', 0);
}
if (!defined('GRAPHEME_EXTR_MAXBYTES')) {
define('GRAPHEME_EXTR_MAXBYTES', 1);
}
if (!defined('GRAPHEME_EXTR_MAXCHARS')) {
define('GRAPHEME_EXTR_MAXCHARS', 2);
}
if (!function_exists('grapheme_extract')) {
function grapheme_extract(?string $haystack, ?int $size, ?int $type = GRAPHEME_EXTR_COUNT, ?int $offset = 0, &$next = null): string|false { return p\Grapheme::grapheme_extract((string) $haystack, (int) $size, (int) $type, (int) $offset, $next); }
}
if (!function_exists('grapheme_stripos')) {
function grapheme_stripos(?string $haystack, ?string $needle, ?int $offset = 0): int|false { return p\Grapheme::grapheme_stripos((string) $haystack, (string) $needle, (int) $offset); }
}
if (!function_exists('grapheme_stristr')) {
function grapheme_stristr(?string $haystack, ?string $needle, ?bool $beforeNeedle = false): string|false { return p\Grapheme::grapheme_stristr((string) $haystack, (string) $needle, (bool) $beforeNeedle); }
}
if (!function_exists('grapheme_strlen')) {
function grapheme_strlen(?string $string): int|false|null { return p\Grapheme::grapheme_strlen((string) $string); }
}
if (!function_exists('grapheme_strpos')) {
function grapheme_strpos(?string $haystack, ?string $needle, ?int $offset = 0): int|false { return p\Grapheme::grapheme_strpos((string) $haystack, (string) $needle, (int) $offset); }
}
if (!function_exists('grapheme_strripos')) {
function grapheme_strripos(?string $haystack, ?string $needle, ?int $offset = 0): int|false { return p\Grapheme::grapheme_strripos((string) $haystack, (string) $needle, (int) $offset); }
}
if (!function_exists('grapheme_strrpos')) {
function grapheme_strrpos(?string $haystack, ?string $needle, ?int $offset = 0): int|false { return p\Grapheme::grapheme_strrpos((string) $haystack, (string) $needle, (int) $offset); }
}
if (!function_exists('grapheme_strstr')) {
function grapheme_strstr(?string $haystack, ?string $needle, ?bool $beforeNeedle = false): string|false { return p\Grapheme::grapheme_strstr((string) $haystack, (string) $needle, (bool) $beforeNeedle); }
}
if (!function_exists('grapheme_substr')) {
function grapheme_substr(?string $string, ?int $offset, ?int $length = null): string|false { return p\Grapheme::grapheme_substr((string) $string, (int) $offset, $length); }
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Polyfill\Intl\Grapheme;
\define('SYMFONY_GRAPHEME_CLUSTER_RX', ((float) \PCRE_VERSION < 10 ? (float) \PCRE_VERSION >= 8.32 : (float) \PCRE_VERSION >= 10.39) ? '\X' : Grapheme::GRAPHEME_CLUSTER_RX);
/**
* Partial intl implementation in pure PHP.
*
* Implemented:
* - grapheme_extract - Extract a sequence of grapheme clusters from a text buffer, which must be encoded in UTF-8
* - grapheme_stripos - Find position (in grapheme units) of first occurrence of a case-insensitive string
* - grapheme_stristr - Returns part of haystack string from the first occurrence of case-insensitive needle to the end of haystack
* - grapheme_strlen - Get string length in grapheme units
* - grapheme_strpos - Find position (in grapheme units) of first occurrence of a string
* - grapheme_strripos - Find position (in grapheme units) of last occurrence of a case-insensitive string
* - grapheme_strrpos - Find position (in grapheme units) of last occurrence of a string
* - grapheme_strstr - Returns part of haystack string from the first occurrence of needle to the end of haystack
* - grapheme_substr - Return part of a string
*
* @author Nicolas Grekas <p@tchwork.com>
*
* @internal
*/
final class Grapheme
{
// (CRLF|([ZWNJ-ZWJ]|T+|L*(LV?V+|LV|LVT)T*|L+|[^Control])[Extend]*|[Control])
// This regular expression is a work around for http://bugs.exim.org/1279
public const GRAPHEME_CLUSTER_RX = '(?:\r\n|(?:[ -~\x{200C}\x{200D}]|[ᆨ-ᇹ]+|[ᄀ-ᅟ]*(?:[가개갸걔거게겨계고과괘괴교구궈궤귀규그긔기까깨꺄꺠꺼께껴꼐꼬꽈꽤꾀꾜꾸꿔꿰뀌뀨끄끠끼나내냐냬너네녀녜노놔놰뇌뇨누눠눼뉘뉴느늬니다대댜댸더데뎌뎨도돠돼되됴두둬뒈뒤듀드듸디따때땨떄떠떼뗘뗴또똬뙈뙤뚀뚜뚸뛔뛰뜌뜨띄띠라래랴럐러레려례로롸뢔뢰료루뤄뤠뤼류르릐리마매먀먜머메며몌모뫄뫠뫼묘무뭐뭬뮈뮤므믜미바배뱌뱨버베벼볘보봐봬뵈뵤부붜붸뷔뷰브븨비빠빼뺘뺴뻐뻬뼈뼤뽀뽜뽸뾔뾰뿌뿨쀄쀠쀼쁘쁴삐사새샤섀서세셔셰소솨쇄쇠쇼수숴쉐쉬슈스싀시싸쌔쌰썌써쎄쎠쎼쏘쏴쐐쐬쑈쑤쒀쒜쒸쓔쓰씌씨아애야얘어에여예오와왜외요우워웨위유으의이자재쟈쟤저제져졔조좌좨죄죠주줘줴쥐쥬즈즤지짜째쨔쨰쩌쩨쪄쪠쪼쫘쫴쬐쬬쭈쭤쮀쮜쮸쯔쯰찌차채챠챼처체쳐쳬초촤쵀최쵸추춰췌취츄츠츼치카캐캬컈커케켜켸코콰쾌쾨쿄쿠쿼퀘퀴큐크킈키타태탸턔터테텨톄토톼퇘퇴툐투퉈퉤튀튜트틔티파패퍄퍠퍼페펴폐포퐈퐤푀표푸풔풰퓌퓨프픠피하해햐햬허헤혀혜호화홰회효후훠훼휘휴흐희히]?[ᅠ-ᆢ]+|[가-힣])[ᆨ-ᇹ]*|[ᄀ-ᅟ]+|[^\p{Cc}\p{Cf}\p{Zl}\p{Zp}])[\p{Mn}\p{Me}\x{09BE}\x{09D7}\x{0B3E}\x{0B57}\x{0BBE}\x{0BD7}\x{0CC2}\x{0CD5}\x{0CD6}\x{0D3E}\x{0D57}\x{0DCF}\x{0DDF}\x{200C}\x{200D}\x{1D165}\x{1D16E}-\x{1D172}]*|[\p{Cc}\p{Cf}\p{Zl}\p{Zp}])';
private const CASE_FOLD = [
['µ', 'ſ', "\xCD\x85", 'ς', "\xCF\x90", "\xCF\x91", "\xCF\x95", "\xCF\x96", "\xCF\xB0", "\xCF\xB1", "\xCF\xB5", "\xE1\xBA\x9B", "\xE1\xBE\xBE"],
['μ', 's', 'ι', 'σ', 'β', 'θ', 'φ', 'π', 'κ', 'ρ', 'ε', "\xE1\xB9\xA1", 'ι'],
];
public static function grapheme_extract($s, $size, $type = \GRAPHEME_EXTR_COUNT, $start = 0, &$next = 0)
{
if (0 > $start) {
$start = \strlen($s) + $start;
}
if (!\is_scalar($s)) {
$hasError = false;
set_error_handler(function () use (&$hasError) { $hasError = true; });
$next = substr($s, $start);
restore_error_handler();
if ($hasError) {
substr($s, $start);
$s = '';
} else {
$s = $next;
}
} else {
$s = substr($s, $start);
}
$size = (int) $size;
$type = (int) $type;
$start = (int) $start;
if (\GRAPHEME_EXTR_COUNT !== $type && \GRAPHEME_EXTR_MAXBYTES !== $type && \GRAPHEME_EXTR_MAXCHARS !== $type) {
if (80000 > \PHP_VERSION_ID) {
return false;
}
throw new \ValueError('grapheme_extract(): Argument #3 ($type) must be one of GRAPHEME_EXTR_COUNT, GRAPHEME_EXTR_MAXBYTES, or GRAPHEME_EXTR_MAXCHARS');
}
if (!isset($s[0]) || 0 > $size || 0 > $start) {
return false;
}
if (0 === $size) {
return '';
}
$next = $start;
$s = preg_split('/('.SYMFONY_GRAPHEME_CLUSTER_RX.')/u', "\r\n".$s, $size + 1, \PREG_SPLIT_NO_EMPTY | \PREG_SPLIT_DELIM_CAPTURE);
if (!isset($s[1])) {
return false;
}
$i = 1;
$ret = '';
do {
if (\GRAPHEME_EXTR_COUNT === $type) {
--$size;
} elseif (\GRAPHEME_EXTR_MAXBYTES === $type) {
$size -= \strlen($s[$i]);
} else {
$size -= iconv_strlen($s[$i], 'UTF-8//IGNORE');
}
if ($size >= 0) {
$ret .= $s[$i];
}
} while (isset($s[++$i]) && $size > 0);
$next += \strlen($ret);
return $ret;
}
public static function grapheme_strlen($s)
{
preg_replace('/'.SYMFONY_GRAPHEME_CLUSTER_RX.'/u', '', $s, -1, $len);
return 0 === $len && '' !== $s ? null : $len;
}
public static function grapheme_substr($s, $start, $len = null)
{
if (null === $len) {
$len = 2147483647;
}
preg_match_all('/'.SYMFONY_GRAPHEME_CLUSTER_RX.'/u', $s, $s);
$slen = \count($s[0]);
$start = (int) $start;
if (0 > $start) {
$start += $slen;
}
if (0 > $start) {
if (\PHP_VERSION_ID < 80000) {
return false;
}
$start = 0;
}
if ($start >= $slen) {
return \PHP_VERSION_ID >= 80000 ? '' : false;
}
$rem = $slen - $start;
if (0 > $len) {
$len += $rem;
}
if (0 === $len) {
return '';
}
if (0 > $len) {
return \PHP_VERSION_ID >= 80000 ? '' : false;
}
if ($len > $rem) {
$len = $rem;
}
return implode('', \array_slice($s[0], $start, $len));
}
public static function grapheme_strpos($s, $needle, $offset = 0)
{
return self::grapheme_position($s, $needle, $offset, 0);
}
public static function grapheme_stripos($s, $needle, $offset = 0)
{
return self::grapheme_position($s, $needle, $offset, 1);
}
public static function grapheme_strrpos($s, $needle, $offset = 0)
{
return self::grapheme_position($s, $needle, $offset, 2);
}
public static function grapheme_strripos($s, $needle, $offset = 0)
{
return self::grapheme_position($s, $needle, $offset, 3);
}
public static function grapheme_stristr($s, $needle, $beforeNeedle = false)
{
return mb_stristr($s, $needle, $beforeNeedle, 'UTF-8');
}
public static function grapheme_strstr($s, $needle, $beforeNeedle = false)
{
return mb_strstr($s, $needle, $beforeNeedle, 'UTF-8');
}
private static function grapheme_position($s, $needle, $offset, $mode)
{
$needle = (string) $needle;
if (80000 > \PHP_VERSION_ID && !preg_match('/./us', $needle)) {
return false;
}
$s = (string) $s;
if (!preg_match('/./us', $s)) {
return false;
}
if ($offset > 0) {
$s = self::grapheme_substr($s, $offset);
} elseif ($offset < 0) {
if (2 > $mode) {
$offset += self::grapheme_strlen($s);
$s = self::grapheme_substr($s, $offset);
if (0 > $offset) {
$offset = 0;
}
} elseif (0 > $offset += self::grapheme_strlen($needle)) {
$s = self::grapheme_substr($s, 0, $offset);
$offset = 0;
} else {
$offset = 0;
}
}
// As UTF-8 is self-synchronizing, and we have ensured the strings are valid UTF-8,
// we can use normal binary string functions here. For case-insensitive searches,
// case fold the strings first.
$caseInsensitive = $mode & 1;
$reverse = $mode & 2;
if ($caseInsensitive) {
// Use the same case folding mode as mbstring does for mb_stripos().
// Stick to SIMPLE case folding to avoid changing the length of the string, which
// might result in offsets being shifted.
$mode = \defined('MB_CASE_FOLD_SIMPLE') ? \MB_CASE_FOLD_SIMPLE : \MB_CASE_LOWER;
$s = mb_convert_case($s, $mode, 'UTF-8');
$needle = mb_convert_case($needle, $mode, 'UTF-8');
if (!\defined('MB_CASE_FOLD_SIMPLE')) {
$s = str_replace(self::CASE_FOLD[0], self::CASE_FOLD[1], $s);
$needle = str_replace(self::CASE_FOLD[0], self::CASE_FOLD[1], $needle);
}
}
if ($reverse) {
$needlePos = strrpos($s, $needle);
} else {
$needlePos = strpos($s, $needle);
}
return false !== $needlePos ? self::grapheme_strlen(substr($s, 0, $needlePos)) + $offset : false;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\LogicException;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\ProcessFailedException;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\ProcessSignaledException;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\ProcessTimedOutException;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\RuntimeException;
use _PHPStan_6dcda722c\Symfony\Component\Process\Pipes\PipesInterface;
use _PHPStan_6dcda722c\Symfony\Component\Process\Pipes\UnixPipes;
use _PHPStan_6dcda722c\Symfony\Component\Process\Pipes\WindowsPipes;
/**
* Process is a thin wrapper around proc_* functions to easily
* start independent PHP processes.
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Romain Neutron <imprec@gmail.com>
*
* @implements \IteratorAggregate<string, string>
*/
class Process implements \IteratorAggregate
{
public const ERR = 'err';
public const OUT = 'out';
public const STATUS_READY = 'ready';
public const STATUS_STARTED = 'started';
public const STATUS_TERMINATED = 'terminated';
public const STDIN = 0;
public const STDOUT = 1;
public const STDERR = 2;
// Timeout Precision in seconds.
public const TIMEOUT_PRECISION = 0.2;
public const ITER_NON_BLOCKING = 1;
// By default, iterating over outputs is a blocking call, use this flag to make it non-blocking
public const ITER_KEEP_OUTPUT = 2;
// By default, outputs are cleared while iterating, use this flag to keep them in memory
public const ITER_SKIP_OUT = 4;
// Use this flag to skip STDOUT while iterating
public const ITER_SKIP_ERR = 8;
// Use this flag to skip STDERR while iterating
private $callback;
private $hasCallback = \false;
private $commandline;
private $cwd;
private $env = [];
private $input;
private $starttime;
private $lastOutputTime;
private $timeout;
private $idleTimeout;
private $exitcode;
private $fallbackStatus = [];
private $processInformation;
private $outputDisabled = \false;
private $stdout;
private $stderr;
private $process;
private $status = self::STATUS_READY;
private $incrementalOutputOffset = 0;
private $incrementalErrorOutputOffset = 0;
private $tty = \false;
private $pty;
private $options = ['suppress_errors' => \true, 'bypass_shell' => \true];
private $useFileHandles = \false;
/** @var PipesInterface */
private $processPipes;
private $latestSignal;
private $cachedExitCode;
private static $sigchild;
/**
* Exit codes translation table.
*
* User-defined errors must use exit codes in the 64-113 range.
*/
public static $exitCodes = [
0 => 'OK',
1 => 'General error',
2 => 'Misuse of shell builtins',
126 => 'Invoked command cannot execute',
127 => 'Command not found',
128 => 'Invalid exit argument',
// signals
129 => 'Hangup',
130 => 'Interrupt',
131 => 'Quit and dump core',
132 => 'Illegal instruction',
133 => 'Trace/breakpoint trap',
134 => 'Process aborted',
135 => 'Bus error: "access to undefined portion of memory object"',
136 => 'Floating point exception: "erroneous arithmetic operation"',
137 => 'Kill (terminate immediately)',
138 => 'User-defined 1',
139 => 'Segmentation violation',
140 => 'User-defined 2',
141 => 'Write to pipe with no one reading',
142 => 'Signal raised by alarm',
143 => 'Termination (request to terminate)',
// 144 - not defined
145 => 'Child process terminated, stopped (or continued*)',
146 => 'Continue if stopped',
147 => 'Stop executing temporarily',
148 => 'Terminal stop signal',
149 => 'Background process attempting to read from tty ("in")',
150 => 'Background process attempting to write to tty ("out")',
151 => 'Urgent data available on socket',
152 => 'CPU time limit exceeded',
153 => 'File size limit exceeded',
154 => 'Signal raised by timer counting virtual time: "virtual timer expired"',
155 => 'Profiling timer expired',
// 156 - not defined
157 => 'Pollable event',
// 158 - not defined
159 => 'Bad syscall',
];
/**
* @param array $command The command to run and its arguments listed as separate entries
* @param string|null $cwd The working directory or null to use the working dir of the current PHP process
* @param array|null $env The environment variables or null to use the same environment as the current PHP process
* @param mixed $input The input as stream resource, scalar or \Traversable, or null for no input
* @param int|float|null $timeout The timeout in seconds or null to disable
*
* @throws LogicException When proc_open is not installed
*/
public function __construct(array $command, ?string $cwd = null, ?array $env = null, $input = null, ?float $timeout = 60)
{
if (!\function_exists('proc_open')) {
throw new LogicException('The Process class relies on proc_open, which is not available on your PHP installation.');
}
$this->commandline = $command;
$this->cwd = $cwd;
// on Windows, if the cwd changed via chdir(), proc_open defaults to the dir where PHP was started
// on Gnu/Linux, PHP builds with --enable-maintainer-zts are also affected
// @see : https://bugs.php.net/51800
// @see : https://bugs.php.net/50524
if (null === $this->cwd && (\defined('ZEND_THREAD_SAFE') || '\\' === \DIRECTORY_SEPARATOR)) {
$this->cwd = \getcwd();
}
if (null !== $env) {
$this->setEnv($env);
}
$this->setInput($input);
$this->setTimeout($timeout);
$this->useFileHandles = '\\' === \DIRECTORY_SEPARATOR;
$this->pty = \false;
}
/**
* Creates a Process instance as a command-line to be run in a shell wrapper.
*
* Command-lines are parsed by the shell of your OS (/bin/sh on Unix-like, cmd.exe on Windows.)
* This allows using e.g. pipes or conditional execution. In this mode, signals are sent to the
* shell wrapper and not to your commands.
*
* In order to inject dynamic values into command-lines, we strongly recommend using placeholders.
* This will save escaping values, which is not portable nor secure anyway:
*
* $process = Process::fromShellCommandline('my_command "${:MY_VAR}"');
* $process->run(null, ['MY_VAR' => $theValue]);
*
* @param string $command The command line to pass to the shell of the OS
* @param string|null $cwd The working directory or null to use the working dir of the current PHP process
* @param array|null $env The environment variables or null to use the same environment as the current PHP process
* @param mixed $input The input as stream resource, scalar or \Traversable, or null for no input
* @param int|float|null $timeout The timeout in seconds or null to disable
*
* @return static
*
* @throws LogicException When proc_open is not installed
*/
public static function fromShellCommandline(string $command, ?string $cwd = null, ?array $env = null, $input = null, ?float $timeout = 60)
{
$process = new static([], $cwd, $env, $input, $timeout);
$process->commandline = $command;
return $process;
}
/**
* @return array
*/
public function __sleep()
{
throw new \BadMethodCallException('Cannot serialize ' . __CLASS__);
}
public function __wakeup()
{
throw new \BadMethodCallException('Cannot unserialize ' . __CLASS__);
}
public function __destruct()
{
if ($this->options['create_new_console'] ?? \false) {
$this->processPipes->close();
} else {
$this->stop(0);
}
}
public function __clone()
{
$this->resetProcessData();
}
/**
* Runs the process.
*
* The callback receives the type of output (out or err) and
* some bytes from the output in real-time. It allows to have feedback
* from the independent process during execution.
*
* The STDOUT and STDERR are also available after the process is finished
* via the getOutput() and getErrorOutput() methods.
*
* @param callable|null $callback A PHP callback to run whenever there is some
* output available on STDOUT or STDERR
*
* @return int The exit status code
*
* @throws RuntimeException When process can't be launched
* @throws RuntimeException When process is already running
* @throws ProcessTimedOutException When process timed out
* @throws ProcessSignaledException When process stopped after receiving signal
* @throws LogicException In case a callback is provided and output has been disabled
*
* @final
*/
public function run(?callable $callback = null, array $env = []) : int
{
$this->start($callback, $env);
return $this->wait();
}
/**
* Runs the process.
*
* This is identical to run() except that an exception is thrown if the process
* exits with a non-zero exit code.
*
* @return $this
*
* @throws ProcessFailedException if the process didn't terminate successfully
*
* @final
*/
public function mustRun(?callable $callback = null, array $env = []) : self
{
if (0 !== $this->run($callback, $env)) {
throw new ProcessFailedException($this);
}
return $this;
}
/**
* Starts the process and returns after writing the input to STDIN.
*
* This method blocks until all STDIN data is sent to the process then it
* returns while the process runs in the background.
*
* The termination of the process can be awaited with wait().
*
* The callback receives the type of output (out or err) and some bytes from
* the output in real-time while writing the standard input to the process.
* It allows to have feedback from the independent process during execution.
*
* @param callable|null $callback A PHP callback to run whenever there is some
* output available on STDOUT or STDERR
*
* @throws RuntimeException When process can't be launched
* @throws RuntimeException When process is already running
* @throws LogicException In case a callback is provided and output has been disabled
*/
public function start(?callable $callback = null, array $env = [])
{
if ($this->isRunning()) {
throw new RuntimeException('Process is already running.');
}
$this->resetProcessData();
$this->starttime = $this->lastOutputTime = \microtime(\true);
$this->callback = $this->buildCallback($callback);
$this->hasCallback = null !== $callback;
$descriptors = $this->getDescriptors();
if ($this->env) {
$env += '\\' === \DIRECTORY_SEPARATOR ? \array_diff_ukey($this->env, $env, 'strcasecmp') : $this->env;
}
$env += '\\' === \DIRECTORY_SEPARATOR ? \array_diff_ukey($this->getDefaultEnv(), $env, 'strcasecmp') : $this->getDefaultEnv();
if (\is_array($commandline = $this->commandline)) {
$commandline = \implode(' ', \array_map([$this, 'escapeArgument'], $commandline));
if ('\\' !== \DIRECTORY_SEPARATOR) {
// exec is mandatory to deal with sending a signal to the process
$commandline = 'exec ' . $commandline;
}
} else {
$commandline = $this->replacePlaceholders($commandline, $env);
}
if ('\\' === \DIRECTORY_SEPARATOR) {
$commandline = $this->prepareWindowsCommandLine($commandline, $env);
} elseif (!$this->useFileHandles && $this->isSigchildEnabled()) {
// last exit code is output on the fourth pipe and caught to work around --enable-sigchild
$descriptors[3] = ['pipe', 'w'];
// See https://unix.stackexchange.com/questions/71205/background-process-pipe-input
$commandline = '{ (' . $commandline . ') <&3 3<&- 3>/dev/null & } 3<&0;';
$commandline .= 'pid=$!; echo $pid >&3; wait $pid 2>/dev/null; code=$?; echo $code >&3; exit $code';
// Workaround for the bug, when PTS functionality is enabled.
// @see : https://bugs.php.net/69442
$ptsWorkaround = \fopen(__FILE__, 'r');
}
$envPairs = [];
foreach ($env as $k => $v) {
if (\false !== $v && \false === \in_array($k, ['argc', 'argv', 'ARGC', 'ARGV'], \true)) {
$envPairs[] = $k . '=' . $v;
}
}
if (!\is_dir($this->cwd)) {
throw new RuntimeException(\sprintf('The provided cwd "%s" does not exist.', $this->cwd));
}
$this->process = @\proc_open($commandline, $descriptors, $this->processPipes->pipes, $this->cwd, $envPairs, $this->options);
if (!\is_resource($this->process)) {
throw new RuntimeException('Unable to launch a new process.');
}
$this->status = self::STATUS_STARTED;
if (isset($descriptors[3])) {
$this->fallbackStatus['pid'] = (int) \fgets($this->processPipes->pipes[3]);
}
if ($this->tty) {
return;
}
$this->updateStatus(\false);
$this->checkTimeout();
}
/**
* Restarts the process.
*
* Be warned that the process is cloned before being started.
*
* @param callable|null $callback A PHP callback to run whenever there is some
* output available on STDOUT or STDERR
*
* @return static
*
* @throws RuntimeException When process can't be launched
* @throws RuntimeException When process is already running
*
* @see start()
*
* @final
*/
public function restart(?callable $callback = null, array $env = []) : self
{
if ($this->isRunning()) {
throw new RuntimeException('Process is already running.');
}
$process = clone $this;
$process->start($callback, $env);
return $process;
}
/**
* Waits for the process to terminate.
*
* The callback receives the type of output (out or err) and some bytes
* from the output in real-time while writing the standard input to the process.
* It allows to have feedback from the independent process during execution.
*
* @param callable|null $callback A valid PHP callback
*
* @return int The exitcode of the process
*
* @throws ProcessTimedOutException When process timed out
* @throws ProcessSignaledException When process stopped after receiving signal
* @throws LogicException When process is not yet started
*/
public function wait(?callable $callback = null)
{
$this->requireProcessIsStarted(__FUNCTION__);
$this->updateStatus(\false);
if (null !== $callback) {
if (!$this->processPipes->haveReadSupport()) {
$this->stop(0);
throw new LogicException('Pass the callback to the "Process::start" method or call enableOutput to use a callback with "Process::wait".');
}
$this->callback = $this->buildCallback($callback);
}
do {
$this->checkTimeout();
$running = $this->isRunning() && ('\\' === \DIRECTORY_SEPARATOR || $this->processPipes->areOpen());
$this->readPipes($running, '\\' !== \DIRECTORY_SEPARATOR || !$running);
} while ($running);
while ($this->isRunning()) {
$this->checkTimeout();
\usleep(1000);
}
if ($this->processInformation['signaled'] && $this->processInformation['termsig'] !== $this->latestSignal) {
throw new ProcessSignaledException($this);
}
return $this->exitcode;
}
/**
* Waits until the callback returns true.
*
* The callback receives the type of output (out or err) and some bytes
* from the output in real-time while writing the standard input to the process.
* It allows to have feedback from the independent process during execution.
*
* @throws RuntimeException When process timed out
* @throws LogicException When process is not yet started
* @throws ProcessTimedOutException In case the timeout was reached
*/
public function waitUntil(callable $callback) : bool
{
$this->requireProcessIsStarted(__FUNCTION__);
$this->updateStatus(\false);
if (!$this->processPipes->haveReadSupport()) {
$this->stop(0);
throw new LogicException('Pass the callback to the "Process::start" method or call enableOutput to use a callback with "Process::waitUntil".');
}
$callback = $this->buildCallback($callback);
$ready = \false;
while (\true) {
$this->checkTimeout();
$running = '\\' === \DIRECTORY_SEPARATOR ? $this->isRunning() : $this->processPipes->areOpen();
$output = $this->processPipes->readAndWrite($running, '\\' !== \DIRECTORY_SEPARATOR || !$running);
foreach ($output as $type => $data) {
if (3 !== $type) {
$ready = $callback(self::STDOUT === $type ? self::OUT : self::ERR, $data) || $ready;
} elseif (!isset($this->fallbackStatus['signaled'])) {
$this->fallbackStatus['exitcode'] = (int) $data;
}
}
if ($ready) {
return \true;
}
if (!$running) {
return \false;
}
\usleep(1000);
}
}
/**
* Returns the Pid (process identifier), if applicable.
*
* @return int|null The process id if running, null otherwise
*/
public function getPid()
{
return $this->isRunning() ? $this->processInformation['pid'] : null;
}
/**
* Sends a POSIX signal to the process.
*
* @param int $signal A valid POSIX signal (see https://php.net/pcntl.constants)
*
* @return $this
*
* @throws LogicException In case the process is not running
* @throws RuntimeException In case --enable-sigchild is activated and the process can't be killed
* @throws RuntimeException In case of failure
*/
public function signal(int $signal)
{
$this->doSignal($signal, \true);
return $this;
}
/**
* Disables fetching output and error output from the underlying process.
*
* @return $this
*
* @throws RuntimeException In case the process is already running
* @throws LogicException if an idle timeout is set
*/
public function disableOutput()
{
if ($this->isRunning()) {
throw new RuntimeException('Disabling output while the process is running is not possible.');
}
if (null !== $this->idleTimeout) {
throw new LogicException('Output cannot be disabled while an idle timeout is set.');
}
$this->outputDisabled = \true;
return $this;
}
/**
* Enables fetching output and error output from the underlying process.
*
* @return $this
*
* @throws RuntimeException In case the process is already running
*/
public function enableOutput()
{
if ($this->isRunning()) {
throw new RuntimeException('Enabling output while the process is running is not possible.');
}
$this->outputDisabled = \false;
return $this;
}
/**
* Returns true in case the output is disabled, false otherwise.
*
* @return bool
*/
public function isOutputDisabled()
{
return $this->outputDisabled;
}
/**
* Returns the current output of the process (STDOUT).
*
* @return string
*
* @throws LogicException in case the output has been disabled
* @throws LogicException In case the process is not started
*/
public function getOutput()
{
$this->readPipesForOutput(__FUNCTION__);
if (\false === ($ret = \stream_get_contents($this->stdout, -1, 0))) {
return '';
}
return $ret;
}
/**
* Returns the output incrementally.
*
* In comparison with the getOutput method which always return the whole
* output, this one returns the new output since the last call.
*
* @return string
*
* @throws LogicException in case the output has been disabled
* @throws LogicException In case the process is not started
*/
public function getIncrementalOutput()
{
$this->readPipesForOutput(__FUNCTION__);
$latest = \stream_get_contents($this->stdout, -1, $this->incrementalOutputOffset);
$this->incrementalOutputOffset = \ftell($this->stdout);
if (\false === $latest) {
return '';
}
return $latest;
}
/**
* Returns an iterator to the output of the process, with the output type as keys (Process::OUT/ERR).
*
* @param int $flags A bit field of Process::ITER_* flags
*
* @return \Generator<string, string>
*
* @throws LogicException in case the output has been disabled
* @throws LogicException In case the process is not started
*/
#[\ReturnTypeWillChange]
public function getIterator(int $flags = 0)
{
$this->readPipesForOutput(__FUNCTION__, \false);
$clearOutput = !(self::ITER_KEEP_OUTPUT & $flags);
$blocking = !(self::ITER_NON_BLOCKING & $flags);
$yieldOut = !(self::ITER_SKIP_OUT & $flags);
$yieldErr = !(self::ITER_SKIP_ERR & $flags);
while (null !== $this->callback || $yieldOut && !\feof($this->stdout) || $yieldErr && !\feof($this->stderr)) {
if ($yieldOut) {
$out = \stream_get_contents($this->stdout, -1, $this->incrementalOutputOffset);
if (isset($out[0])) {
if ($clearOutput) {
$this->clearOutput();
} else {
$this->incrementalOutputOffset = \ftell($this->stdout);
}
(yield self::OUT => $out);
}
}
if ($yieldErr) {
$err = \stream_get_contents($this->stderr, -1, $this->incrementalErrorOutputOffset);
if (isset($err[0])) {
if ($clearOutput) {
$this->clearErrorOutput();
} else {
$this->incrementalErrorOutputOffset = \ftell($this->stderr);
}
(yield self::ERR => $err);
}
}
if (!$blocking && !isset($out[0]) && !isset($err[0])) {
(yield self::OUT => '');
}
$this->checkTimeout();
$this->readPipesForOutput(__FUNCTION__, $blocking);
}
}
/**
* Clears the process output.
*
* @return $this
*/
public function clearOutput()
{
\ftruncate($this->stdout, 0);
\fseek($this->stdout, 0);
$this->incrementalOutputOffset = 0;
return $this;
}
/**
* Returns the current error output of the process (STDERR).
*
* @return string
*
* @throws LogicException in case the output has been disabled
* @throws LogicException In case the process is not started
*/
public function getErrorOutput()
{
$this->readPipesForOutput(__FUNCTION__);
if (\false === ($ret = \stream_get_contents($this->stderr, -1, 0))) {
return '';
}
return $ret;
}
/**
* Returns the errorOutput incrementally.
*
* In comparison with the getErrorOutput method which always return the
* whole error output, this one returns the new error output since the last
* call.
*
* @return string
*
* @throws LogicException in case the output has been disabled
* @throws LogicException In case the process is not started
*/
public function getIncrementalErrorOutput()
{
$this->readPipesForOutput(__FUNCTION__);
$latest = \stream_get_contents($this->stderr, -1, $this->incrementalErrorOutputOffset);
$this->incrementalErrorOutputOffset = \ftell($this->stderr);
if (\false === $latest) {
return '';
}
return $latest;
}
/**
* Clears the process output.
*
* @return $this
*/
public function clearErrorOutput()
{
\ftruncate($this->stderr, 0);
\fseek($this->stderr, 0);
$this->incrementalErrorOutputOffset = 0;
return $this;
}
/**
* Returns the exit code returned by the process.
*
* @return int|null The exit status code, null if the Process is not terminated
*/
public function getExitCode()
{
$this->updateStatus(\false);
return $this->exitcode;
}
/**
* Returns a string representation for the exit code returned by the process.
*
* This method relies on the Unix exit code status standardization
* and might not be relevant for other operating systems.
*
* @return string|null A string representation for the exit status code, null if the Process is not terminated
*
* @see http://tldp.org/LDP/abs/html/exitcodes.html
* @see http://en.wikipedia.org/wiki/Unix_signal
*/
public function getExitCodeText()
{
if (null === ($exitcode = $this->getExitCode())) {
return null;
}
return self::$exitCodes[$exitcode] ?? 'Unknown error';
}
/**
* Checks if the process ended successfully.
*
* @return bool
*/
public function isSuccessful()
{
return 0 === $this->getExitCode();
}
/**
* Returns true if the child process has been terminated by an uncaught signal.
*
* It always returns false on Windows.
*
* @return bool
*
* @throws LogicException In case the process is not terminated
*/
public function hasBeenSignaled()
{
$this->requireProcessIsTerminated(__FUNCTION__);
return $this->processInformation['signaled'];
}
/**
* Returns the number of the signal that caused the child process to terminate its execution.
*
* It is only meaningful if hasBeenSignaled() returns true.
*
* @return int
*
* @throws RuntimeException In case --enable-sigchild is activated
* @throws LogicException In case the process is not terminated
*/
public function getTermSignal()
{
$this->requireProcessIsTerminated(__FUNCTION__);
if ($this->isSigchildEnabled() && -1 === $this->processInformation['termsig']) {
throw new RuntimeException('This PHP has been compiled with --enable-sigchild. Term signal cannot be retrieved.');
}
return $this->processInformation['termsig'];
}
/**
* Returns true if the child process has been stopped by a signal.
*
* It always returns false on Windows.
*
* @return bool
*
* @throws LogicException In case the process is not terminated
*/
public function hasBeenStopped()
{
$this->requireProcessIsTerminated(__FUNCTION__);
return $this->processInformation['stopped'];
}
/**
* Returns the number of the signal that caused the child process to stop its execution.
*
* It is only meaningful if hasBeenStopped() returns true.
*
* @return int
*
* @throws LogicException In case the process is not terminated
*/
public function getStopSignal()
{
$this->requireProcessIsTerminated(__FUNCTION__);
return $this->processInformation['stopsig'];
}
/**
* Checks if the process is currently running.
*
* @return bool
*/
public function isRunning()
{
if (self::STATUS_STARTED !== $this->status) {
return \false;
}
$this->updateStatus(\false);
return $this->processInformation['running'];
}
/**
* Checks if the process has been started with no regard to the current state.
*
* @return bool
*/
public function isStarted()
{
return self::STATUS_READY != $this->status;
}
/**
* Checks if the process is terminated.
*
* @return bool
*/
public function isTerminated()
{
$this->updateStatus(\false);
return self::STATUS_TERMINATED == $this->status;
}
/**
* Gets the process status.
*
* The status is one of: ready, started, terminated.
*
* @return string
*/
public function getStatus()
{
$this->updateStatus(\false);
return $this->status;
}
/**
* Stops the process.
*
* @param int|float $timeout The timeout in seconds
* @param int|null $signal A POSIX signal to send in case the process has not stop at timeout, default is SIGKILL (9)
*
* @return int|null The exit-code of the process or null if it's not running
*/
public function stop(float $timeout = 10, ?int $signal = null)
{
$timeoutMicro = \microtime(\true) + $timeout;
if ($this->isRunning()) {
// given SIGTERM may not be defined and that "proc_terminate" uses the constant value and not the constant itself, we use the same here
$this->doSignal(15, \false);
do {
\usleep(1000);
} while ($this->isRunning() && \microtime(\true) < $timeoutMicro);
if ($this->isRunning()) {
// Avoid exception here: process is supposed to be running, but it might have stopped just
// after this line. In any case, let's silently discard the error, we cannot do anything.
$this->doSignal($signal ?: 9, \false);
}
}
if ($this->isRunning()) {
if (isset($this->fallbackStatus['pid'])) {
unset($this->fallbackStatus['pid']);
return $this->stop(0, $signal);
}
$this->close();
}
return $this->exitcode;
}
/**
* Adds a line to the STDOUT stream.
*
* @internal
*/
public function addOutput(string $line)
{
$this->lastOutputTime = \microtime(\true);
\fseek($this->stdout, 0, \SEEK_END);
\fwrite($this->stdout, $line);
\fseek($this->stdout, $this->incrementalOutputOffset);
}
/**
* Adds a line to the STDERR stream.
*
* @internal
*/
public function addErrorOutput(string $line)
{
$this->lastOutputTime = \microtime(\true);
\fseek($this->stderr, 0, \SEEK_END);
\fwrite($this->stderr, $line);
\fseek($this->stderr, $this->incrementalErrorOutputOffset);
}
/**
* Gets the last output time in seconds.
*/
public function getLastOutputTime() : ?float
{
return $this->lastOutputTime;
}
/**
* Gets the command line to be executed.
*
* @return string
*/
public function getCommandLine()
{
return \is_array($this->commandline) ? \implode(' ', \array_map([$this, 'escapeArgument'], $this->commandline)) : $this->commandline;
}
/**
* Gets the process timeout in seconds (max. runtime).
*
* @return float|null
*/
public function getTimeout()
{
return $this->timeout;
}
/**
* Gets the process idle timeout in seconds (max. time since last output).
*
* @return float|null
*/
public function getIdleTimeout()
{
return $this->idleTimeout;
}
/**
* Sets the process timeout (max. runtime) in seconds.
*
* To disable the timeout, set this value to null.
*
* @return $this
*
* @throws InvalidArgumentException if the timeout is negative
*/
public function setTimeout(?float $timeout)
{
$this->timeout = $this->validateTimeout($timeout);
return $this;
}
/**
* Sets the process idle timeout (max. time since last output) in seconds.
*
* To disable the timeout, set this value to null.
*
* @return $this
*
* @throws LogicException if the output is disabled
* @throws InvalidArgumentException if the timeout is negative
*/
public function setIdleTimeout(?float $timeout)
{
if (null !== $timeout && $this->outputDisabled) {
throw new LogicException('Idle timeout cannot be set while the output is disabled.');
}
$this->idleTimeout = $this->validateTimeout($timeout);
return $this;
}
/**
* Enables or disables the TTY mode.
*
* @return $this
*
* @throws RuntimeException In case the TTY mode is not supported
*/
public function setTty(bool $tty)
{
if ('\\' === \DIRECTORY_SEPARATOR && $tty) {
throw new RuntimeException('TTY mode is not supported on Windows platform.');
}
if ($tty && !self::isTtySupported()) {
throw new RuntimeException('TTY mode requires /dev/tty to be read/writable.');
}
$this->tty = $tty;
return $this;
}
/**
* Checks if the TTY mode is enabled.
*
* @return bool
*/
public function isTty()
{
return $this->tty;
}
/**
* Sets PTY mode.
*
* @return $this
*/
public function setPty(bool $bool)
{
$this->pty = $bool;
return $this;
}
/**
* Returns PTY state.
*
* @return bool
*/
public function isPty()
{
return $this->pty;
}
/**
* Gets the working directory.
*
* @return string|null
*/
public function getWorkingDirectory()
{
if (null === $this->cwd) {
// getcwd() will return false if any one of the parent directories does not have
// the readable or search mode set, even if the current directory does
return \getcwd() ?: null;
}
return $this->cwd;
}
/**
* Sets the current working directory.
*
* @return $this
*/
public function setWorkingDirectory(string $cwd)
{
$this->cwd = $cwd;
return $this;
}
/**
* Gets the environment variables.
*
* @return array
*/
public function getEnv()
{
return $this->env;
}
/**
* Sets the environment variables.
*
* @param array<string|\Stringable> $env The new environment variables
*
* @return $this
*/
public function setEnv(array $env)
{
$this->env = $env;
return $this;
}
/**
* Gets the Process input.
*
* @return resource|string|\Iterator|null
*/
public function getInput()
{
return $this->input;
}
/**
* Sets the input.
*
* This content will be passed to the underlying process standard input.
*
* @param string|int|float|bool|resource|\Traversable|null $input The content
*
* @return $this
*
* @throws LogicException In case the process is running
*/
public function setInput($input)
{
if ($this->isRunning()) {
throw new LogicException('Input cannot be set while the process is running.');
}
$this->input = ProcessUtils::validateInput(__METHOD__, $input);
return $this;
}
/**
* Performs a check between the timeout definition and the time the process started.
*
* In case you run a background process (with the start method), you should
* trigger this method regularly to ensure the process timeout
*
* @throws ProcessTimedOutException In case the timeout was reached
*/
public function checkTimeout()
{
if (self::STATUS_STARTED !== $this->status) {
return;
}
if (null !== $this->timeout && $this->timeout < \microtime(\true) - $this->starttime) {
$this->stop(0);
throw new ProcessTimedOutException($this, ProcessTimedOutException::TYPE_GENERAL);
}
if (null !== $this->idleTimeout && $this->idleTimeout < \microtime(\true) - $this->lastOutputTime) {
$this->stop(0);
throw new ProcessTimedOutException($this, ProcessTimedOutException::TYPE_IDLE);
}
}
/**
* @throws LogicException in case process is not started
*/
public function getStartTime() : float
{
if (!$this->isStarted()) {
throw new LogicException('Start time is only available after process start.');
}
return $this->starttime;
}
/**
* Defines options to pass to the underlying proc_open().
*
* @see https://php.net/proc_open for the options supported by PHP.
*
* Enabling the "create_new_console" option allows a subprocess to continue
* to run after the main process exited, on both Windows and *nix
*/
public function setOptions(array $options)
{
if ($this->isRunning()) {
throw new RuntimeException('Setting options while the process is running is not possible.');
}
$defaultOptions = $this->options;
$existingOptions = ['blocking_pipes', 'create_process_group', 'create_new_console'];
foreach ($options as $key => $value) {
if (!\in_array($key, $existingOptions)) {
$this->options = $defaultOptions;
throw new LogicException(\sprintf('Invalid option "%s" passed to "%s()". Supported options are "%s".', $key, __METHOD__, \implode('", "', $existingOptions)));
}
$this->options[$key] = $value;
}
}
/**
* Returns whether TTY is supported on the current operating system.
*/
public static function isTtySupported() : bool
{
static $isTtySupported;
if (null === $isTtySupported) {
$isTtySupported = (bool) @\proc_open('echo 1 >/dev/null', [['file', '/dev/tty', 'r'], ['file', '/dev/tty', 'w'], ['file', '/dev/tty', 'w']], $pipes);
}
return $isTtySupported;
}
/**
* Returns whether PTY is supported on the current operating system.
*
* @return bool
*/
public static function isPtySupported()
{
static $result;
if (null !== $result) {
return $result;
}
if ('\\' === \DIRECTORY_SEPARATOR) {
return $result = \false;
}
return $result = (bool) @\proc_open('echo 1 >/dev/null', [['pty'], ['pty'], ['pty']], $pipes);
}
/**
* Creates the descriptors needed by the proc_open.
*/
private function getDescriptors() : array
{
if ($this->input instanceof \Iterator) {
$this->input->rewind();
}
if ('\\' === \DIRECTORY_SEPARATOR) {
$this->processPipes = new WindowsPipes($this->input, !$this->outputDisabled || $this->hasCallback);
} else {
$this->processPipes = new UnixPipes($this->isTty(), $this->isPty(), $this->input, !$this->outputDisabled || $this->hasCallback);
}
return $this->processPipes->getDescriptors();
}
/**
* Builds up the callback used by wait().
*
* The callbacks adds all occurred output to the specific buffer and calls
* the user callback (if present) with the received output.
*
* @param callable|null $callback The user defined PHP callback
*
* @return \Closure
*/
protected function buildCallback(?callable $callback = null)
{
if ($this->outputDisabled) {
return function ($type, $data) use($callback) : bool {
return null !== $callback && $callback($type, $data);
};
}
$out = self::OUT;
return function ($type, $data) use($callback, $out) : bool {
if ($out == $type) {
$this->addOutput($data);
} else {
$this->addErrorOutput($data);
}
return null !== $callback && $callback($type, $data);
};
}
/**
* Updates the status of the process, reads pipes.
*
* @param bool $blocking Whether to use a blocking read call
*/
protected function updateStatus(bool $blocking)
{
if (self::STATUS_STARTED !== $this->status) {
return;
}
$this->processInformation = \proc_get_status($this->process);
$running = $this->processInformation['running'];
// In PHP < 8.3, "proc_get_status" only returns the correct exit status on the first call.
// Subsequent calls return -1 as the process is discarded. This workaround caches the first
// retrieved exit status for consistent results in later calls, mimicking PHP 8.3 behavior.
if (\PHP_VERSION_ID < 80300) {
if (!isset($this->cachedExitCode) && !$running && -1 !== $this->processInformation['exitcode']) {
$this->cachedExitCode = $this->processInformation['exitcode'];
}
if (isset($this->cachedExitCode) && !$running && -1 === $this->processInformation['exitcode']) {
$this->processInformation['exitcode'] = $this->cachedExitCode;
}
}
$this->readPipes($running && $blocking, '\\' !== \DIRECTORY_SEPARATOR || !$running);
if ($this->fallbackStatus && $this->isSigchildEnabled()) {
$this->processInformation = $this->fallbackStatus + $this->processInformation;
}
if (!$running) {
$this->close();
}
}
/**
* Returns whether PHP has been compiled with the '--enable-sigchild' option or not.
*
* @return bool
*/
protected function isSigchildEnabled()
{
if (null !== self::$sigchild) {
return self::$sigchild;
}
if (!\function_exists('phpinfo')) {
return self::$sigchild = \false;
}
\ob_start();
\phpinfo(\INFO_GENERAL);
return self::$sigchild = \str_contains(\ob_get_clean(), '--enable-sigchild');
}
/**
* Reads pipes for the freshest output.
*
* @param string $caller The name of the method that needs fresh outputs
* @param bool $blocking Whether to use blocking calls or not
*
* @throws LogicException in case output has been disabled or process is not started
*/
private function readPipesForOutput(string $caller, bool $blocking = \false)
{
if ($this->outputDisabled) {
throw new LogicException('Output has been disabled.');
}
$this->requireProcessIsStarted($caller);
$this->updateStatus($blocking);
}
/**
* Validates and returns the filtered timeout.
*
* @throws InvalidArgumentException if the given timeout is a negative number
*/
private function validateTimeout(?float $timeout) : ?float
{
$timeout = (float) $timeout;
if (0.0 === $timeout) {
$timeout = null;
} elseif ($timeout < 0) {
throw new InvalidArgumentException('The timeout value must be a valid positive integer or float number.');
}
return $timeout;
}
/**
* Reads pipes, executes callback.
*
* @param bool $blocking Whether to use blocking calls or not
* @param bool $close Whether to close file handles or not
*/
private function readPipes(bool $blocking, bool $close)
{
$result = $this->processPipes->readAndWrite($blocking, $close);
$callback = $this->callback;
foreach ($result as $type => $data) {
if (3 !== $type) {
$callback(self::STDOUT === $type ? self::OUT : self::ERR, $data);
} elseif (!isset($this->fallbackStatus['signaled'])) {
$this->fallbackStatus['exitcode'] = (int) $data;
}
}
}
/**
* Closes process resource, closes file handles, sets the exitcode.
*
* @return int The exitcode
*/
private function close() : int
{
$this->processPipes->close();
if (\is_resource($this->process)) {
\proc_close($this->process);
}
$this->exitcode = $this->processInformation['exitcode'];
$this->status = self::STATUS_TERMINATED;
if (-1 === $this->exitcode) {
if ($this->processInformation['signaled'] && 0 < $this->processInformation['termsig']) {
// if process has been signaled, no exitcode but a valid termsig, apply Unix convention
$this->exitcode = 128 + $this->processInformation['termsig'];
} elseif ($this->isSigchildEnabled()) {
$this->processInformation['signaled'] = \true;
$this->processInformation['termsig'] = -1;
}
}
// Free memory from self-reference callback created by buildCallback
// Doing so in other contexts like __destruct or by garbage collector is ineffective
// Now pipes are closed, so the callback is no longer necessary
$this->callback = null;
return $this->exitcode;
}
/**
* Resets data related to the latest run of the process.
*/
private function resetProcessData()
{
$this->starttime = null;
$this->callback = null;
$this->exitcode = null;
$this->fallbackStatus = [];
$this->processInformation = null;
$this->stdout = \fopen('php://temp/maxmemory:' . 1024 * 1024, 'w+');
$this->stderr = \fopen('php://temp/maxmemory:' . 1024 * 1024, 'w+');
$this->process = null;
$this->latestSignal = null;
$this->status = self::STATUS_READY;
$this->incrementalOutputOffset = 0;
$this->incrementalErrorOutputOffset = 0;
}
/**
* Sends a POSIX signal to the process.
*
* @param int $signal A valid POSIX signal (see https://php.net/pcntl.constants)
* @param bool $throwException Whether to throw exception in case signal failed
*
* @throws LogicException In case the process is not running
* @throws RuntimeException In case --enable-sigchild is activated and the process can't be killed
* @throws RuntimeException In case of failure
*/
private function doSignal(int $signal, bool $throwException) : bool
{
if (null === ($pid = $this->getPid())) {
if ($throwException) {
throw new LogicException('Cannot send signal on a non running process.');
}
return \false;
}
if ('\\' === \DIRECTORY_SEPARATOR) {
\exec(\sprintf('taskkill /F /T /PID %d 2>&1', $pid), $output, $exitCode);
if ($exitCode && $this->isRunning()) {
if ($throwException) {
throw new RuntimeException(\sprintf('Unable to kill the process (%s).', \implode(' ', $output)));
}
return \false;
}
} else {
if (!$this->isSigchildEnabled()) {
$ok = @\proc_terminate($this->process, $signal);
} elseif (\function_exists('posix_kill')) {
$ok = @\posix_kill($pid, $signal);
} elseif ($ok = \proc_open(\sprintf('kill -%d %d', $signal, $pid), [2 => ['pipe', 'w']], $pipes)) {
$ok = \false === \fgets($pipes[2]);
}
if (!$ok) {
if ($throwException) {
throw new RuntimeException(\sprintf('Error while sending signal "%s".', $signal));
}
return \false;
}
}
$this->latestSignal = $signal;
$this->fallbackStatus['signaled'] = \true;
$this->fallbackStatus['exitcode'] = -1;
$this->fallbackStatus['termsig'] = $this->latestSignal;
return \true;
}
private function prepareWindowsCommandLine(string $cmd, array &$env) : string
{
$uid = \uniqid('', \true);
$varCount = 0;
$varCache = [];
$cmd = \preg_replace_callback('/"(?:(
[^"%!^]*+
(?:
(?: !LF! | "(?:\\^[%!^])?+" )
[^"%!^]*+
)++
) | [^"]*+ )"/x', function ($m) use(&$env, &$varCache, &$varCount, $uid) {
if (!isset($m[1])) {
return $m[0];
}
if (isset($varCache[$m[0]])) {
return $varCache[$m[0]];
}
if (\str_contains($value = $m[1], "\x00")) {
$value = \str_replace("\x00", '?', $value);
}
if (\false === \strpbrk($value, "\"%!\n")) {
return '"' . $value . '"';
}
$value = \str_replace(['!LF!', '"^!"', '"^%"', '"^^"', '""'], ["\n", '!', '%', '^', '"'], $value);
$value = '"' . \preg_replace('/(\\\\*)"/', '$1$1\\"', $value) . '"';
$var = $uid . ++$varCount;
$env[$var] = $value;
return $varCache[$m[0]] = '!' . $var . '!';
}, $cmd);
$cmd = 'cmd /V:ON /E:ON /D /C (' . \str_replace("\n", ' ', $cmd) . ')';
foreach ($this->processPipes->getFiles() as $offset => $filename) {
$cmd .= ' ' . $offset . '>"' . $filename . '"';
}
return $cmd;
}
/**
* Ensures the process is running or terminated, throws a LogicException if the process has a not started.
*
* @throws LogicException if the process has not run
*/
private function requireProcessIsStarted(string $functionName)
{
if (!$this->isStarted()) {
throw new LogicException(\sprintf('Process must be started before calling "%s()".', $functionName));
}
}
/**
* Ensures the process is terminated, throws a LogicException if the process has a status different than "terminated".
*
* @throws LogicException if the process is not yet terminated
*/
private function requireProcessIsTerminated(string $functionName)
{
if (!$this->isTerminated()) {
throw new LogicException(\sprintf('Process must be terminated before calling "%s()".', $functionName));
}
}
/**
* Escapes a string to be used as a shell argument.
*/
private function escapeArgument(?string $argument) : string
{
if ('' === $argument || null === $argument) {
return '""';
}
if ('\\' !== \DIRECTORY_SEPARATOR) {
return "'" . \str_replace("'", "'\\''", $argument) . "'";
}
if (\str_contains($argument, "\x00")) {
$argument = \str_replace("\x00", '?', $argument);
}
if (!\preg_match('/[\\/()%!^"<>&|\\s]/', $argument)) {
return $argument;
}
$argument = \preg_replace('/(\\\\+)$/', '$1$1', $argument);
return '"' . \str_replace(['"', '^', '%', '!', "\n"], ['""', '"^^"', '"^%"', '"^!"', '!LF!'], $argument) . '"';
}
private function replacePlaceholders(string $commandline, array $env)
{
return \preg_replace_callback('/"\\$\\{:([_a-zA-Z]++[_a-zA-Z0-9]*+)\\}"/', function ($matches) use($commandline, $env) {
if (!isset($env[$matches[1]]) || \false === $env[$matches[1]]) {
throw new InvalidArgumentException(\sprintf('Command line is missing a value for parameter "%s": ', $matches[1]) . $commandline);
}
return $this->escapeArgument($env[$matches[1]]);
}, $commandline);
}
private function getDefaultEnv() : array
{
$env = \getenv();
$env = ('\\' === \DIRECTORY_SEPARATOR ? \array_intersect_ukey($env, $_SERVER, 'strcasecmp') : \array_intersect_key($env, $_SERVER)) ?: $env;
return $_ENV + ('\\' === \DIRECTORY_SEPARATOR ? \array_diff_ukey($env, $_ENV, 'strcasecmp') : $env);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Pipes;
/**
* PipesInterface manages descriptors and pipes for the use of proc_open.
*
* @author Romain Neutron <imprec@gmail.com>
*
* @internal
*/
interface PipesInterface
{
public const CHUNK_SIZE = 16384;
/**
* Returns an array of descriptors for the use of proc_open.
*/
public function getDescriptors() : array;
/**
* Returns an array of filenames indexed by their related stream in case these pipes use temporary files.
*
* @return string[]
*/
public function getFiles() : array;
/**
* Reads data in file handles and pipes.
*
* @param bool $blocking Whether to use blocking calls or not
* @param bool $close Whether to close pipes if they've reached EOF
*
* @return string[] An array of read data indexed by their fd
*/
public function readAndWrite(bool $blocking, bool $close = \false) : array;
/**
* Returns if the current state has open file handles or pipes.
*/
public function areOpen() : bool;
/**
* Returns if pipes are able to read output.
*/
public function haveReadSupport() : bool;
/**
* Closes file handles and pipes.
*/
public function close();
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Pipes;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\InvalidArgumentException;
/**
* @author Romain Neutron <imprec@gmail.com>
*
* @internal
*/
abstract class AbstractPipes implements PipesInterface
{
public $pipes = [];
private $inputBuffer = '';
private $input;
private $blocked = \true;
private $lastError;
/**
* @param resource|string|int|float|bool|\Iterator|null $input
*/
public function __construct($input)
{
if (\is_resource($input) || $input instanceof \Iterator) {
$this->input = $input;
} elseif (\is_string($input)) {
$this->inputBuffer = $input;
} else {
$this->inputBuffer = (string) $input;
}
}
/**
* {@inheritdoc}
*/
public function close()
{
foreach ($this->pipes as $pipe) {
if (\is_resource($pipe)) {
\fclose($pipe);
}
}
$this->pipes = [];
}
/**
* Returns true if a system call has been interrupted.
*/
protected function hasSystemCallBeenInterrupted() : bool
{
$lastError = $this->lastError;
$this->lastError = null;
// stream_select returns false when the `select` system call is interrupted by an incoming signal
return null !== $lastError && \false !== \stripos($lastError, 'interrupted system call');
}
/**
* Unblocks streams.
*/
protected function unblock()
{
if (!$this->blocked) {
return;
}
foreach ($this->pipes as $pipe) {
\stream_set_blocking($pipe, 0);
}
if (\is_resource($this->input)) {
\stream_set_blocking($this->input, 0);
}
$this->blocked = \false;
}
/**
* Writes input to stdin.
*
* @throws InvalidArgumentException When an input iterator yields a non supported value
*/
protected function write() : ?array
{
if (!isset($this->pipes[0])) {
return null;
}
$input = $this->input;
if ($input instanceof \Iterator) {
if (!$input->valid()) {
$input = null;
} elseif (\is_resource($input = $input->current())) {
\stream_set_blocking($input, 0);
} elseif (!isset($this->inputBuffer[0])) {
if (!\is_string($input)) {
if (!\is_scalar($input)) {
throw new InvalidArgumentException(\sprintf('"%s" yielded a value of type "%s", but only scalars and stream resources are supported.', \get_debug_type($this->input), \get_debug_type($input)));
}
$input = (string) $input;
}
$this->inputBuffer = $input;
$this->input->next();
$input = null;
} else {
$input = null;
}
}
$r = $e = [];
$w = [$this->pipes[0]];
// let's have a look if something changed in streams
if (\false === @\stream_select($r, $w, $e, 0, 0)) {
return null;
}
foreach ($w as $stdin) {
if (isset($this->inputBuffer[0])) {
$written = \fwrite($stdin, $this->inputBuffer);
$this->inputBuffer = \substr($this->inputBuffer, $written);
if (isset($this->inputBuffer[0])) {
return [$this->pipes[0]];
}
}
if ($input) {
while (\true) {
$data = \fread($input, self::CHUNK_SIZE);
if (!isset($data[0])) {
break;
}
$written = \fwrite($stdin, $data);
$data = \substr($data, $written);
if (isset($data[0])) {
$this->inputBuffer = $data;
return [$this->pipes[0]];
}
}
if (\feof($input)) {
if ($this->input instanceof \Iterator) {
$this->input->next();
} else {
$this->input = null;
}
}
}
}
// no input to read on resource, buffer is empty
if (!isset($this->inputBuffer[0]) && !($this->input instanceof \Iterator ? $this->input->valid() : $this->input)) {
$this->input = null;
\fclose($this->pipes[0]);
unset($this->pipes[0]);
} elseif (!$w) {
return [$this->pipes[0]];
}
return null;
}
/**
* @internal
*/
public function handleError(int $type, string $msg)
{
$this->lastError = $msg;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Pipes;
use _PHPStan_6dcda722c\Symfony\Component\Process\Process;
/**
* UnixPipes implementation uses unix pipes as handles.
*
* @author Romain Neutron <imprec@gmail.com>
*
* @internal
*/
class UnixPipes extends AbstractPipes
{
private $ttyMode;
private $ptyMode;
private $haveReadSupport;
public function __construct(?bool $ttyMode, bool $ptyMode, $input, bool $haveReadSupport)
{
$this->ttyMode = $ttyMode;
$this->ptyMode = $ptyMode;
$this->haveReadSupport = $haveReadSupport;
parent::__construct($input);
}
public function __sleep() : array
{
throw new \BadMethodCallException('Cannot serialize ' . __CLASS__);
}
public function __wakeup()
{
throw new \BadMethodCallException('Cannot unserialize ' . __CLASS__);
}
public function __destruct()
{
$this->close();
}
/**
* {@inheritdoc}
*/
public function getDescriptors() : array
{
if (!$this->haveReadSupport) {
$nullstream = \fopen('/dev/null', 'c');
return [['pipe', 'r'], $nullstream, $nullstream];
}
if ($this->ttyMode) {
return [['file', '/dev/tty', 'r'], ['file', '/dev/tty', 'w'], ['file', '/dev/tty', 'w']];
}
if ($this->ptyMode && Process::isPtySupported()) {
return [['pty'], ['pty'], ['pty']];
}
return [
['pipe', 'r'],
['pipe', 'w'],
// stdout
['pipe', 'w'],
];
}
/**
* {@inheritdoc}
*/
public function getFiles() : array
{
return [];
}
/**
* {@inheritdoc}
*/
public function readAndWrite(bool $blocking, bool $close = \false) : array
{
$this->unblock();
$w = $this->write();
$read = $e = [];
$r = $this->pipes;
unset($r[0]);
// let's have a look if something changed in streams
\set_error_handler([$this, 'handleError']);
if (($r || $w) && \false === \stream_select($r, $w, $e, 0, $blocking ? Process::TIMEOUT_PRECISION * 1000000.0 : 0)) {
\restore_error_handler();
// if a system call has been interrupted, forget about it, let's try again
// otherwise, an error occurred, let's reset pipes
if (!$this->hasSystemCallBeenInterrupted()) {
$this->pipes = [];
}
return $read;
}
\restore_error_handler();
foreach ($r as $pipe) {
// prior PHP 5.4 the array passed to stream_select is modified and
// lose key association, we have to find back the key
$read[$type = \array_search($pipe, $this->pipes, \true)] = '';
do {
$data = @\fread($pipe, self::CHUNK_SIZE);
$read[$type] .= $data;
} while (isset($data[0]) && ($close || isset($data[self::CHUNK_SIZE - 1])));
if (!isset($read[$type][0])) {
unset($read[$type]);
}
if ($close && \feof($pipe)) {
\fclose($pipe);
unset($this->pipes[$type]);
}
}
return $read;
}
/**
* {@inheritdoc}
*/
public function haveReadSupport() : bool
{
return $this->haveReadSupport;
}
/**
* {@inheritdoc}
*/
public function areOpen() : bool
{
return (bool) $this->pipes;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Pipes;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\RuntimeException;
use _PHPStan_6dcda722c\Symfony\Component\Process\Process;
/**
* WindowsPipes implementation uses temporary files as handles.
*
* @see https://bugs.php.net/51800
* @see https://bugs.php.net/65650
*
* @author Romain Neutron <imprec@gmail.com>
*
* @internal
*/
class WindowsPipes extends AbstractPipes
{
private $files = [];
private $fileHandles = [];
private $lockHandles = [];
private $readBytes = [Process::STDOUT => 0, Process::STDERR => 0];
private $haveReadSupport;
public function __construct($input, bool $haveReadSupport)
{
$this->haveReadSupport = $haveReadSupport;
if ($this->haveReadSupport) {
// Fix for PHP bug #51800: reading from STDOUT pipe hangs forever on Windows if the output is too big.
// Workaround for this problem is to use temporary files instead of pipes on Windows platform.
//
// @see https://bugs.php.net/51800
$pipes = [Process::STDOUT => Process::OUT, Process::STDERR => Process::ERR];
$tmpDir = \sys_get_temp_dir();
$lastError = 'unknown reason';
\set_error_handler(function ($type, $msg) use(&$lastError) {
$lastError = $msg;
});
for ($i = 0;; ++$i) {
foreach ($pipes as $pipe => $name) {
$file = \sprintf('%s\\sf_proc_%02X.%s', $tmpDir, $i, $name);
if (!($h = \fopen($file . '.lock', 'w'))) {
if (\file_exists($file . '.lock')) {
continue 2;
}
\restore_error_handler();
throw new RuntimeException('A temporary file could not be opened to write the process output: ' . $lastError);
}
if (!\flock($h, \LOCK_EX | \LOCK_NB)) {
continue 2;
}
if (isset($this->lockHandles[$pipe])) {
\flock($this->lockHandles[$pipe], \LOCK_UN);
\fclose($this->lockHandles[$pipe]);
}
$this->lockHandles[$pipe] = $h;
if (!($h = \fopen($file, 'w')) || !\fclose($h) || !($h = \fopen($file, 'r'))) {
\flock($this->lockHandles[$pipe], \LOCK_UN);
\fclose($this->lockHandles[$pipe]);
unset($this->lockHandles[$pipe]);
continue 2;
}
$this->fileHandles[$pipe] = $h;
$this->files[$pipe] = $file;
}
break;
}
\restore_error_handler();
}
parent::__construct($input);
}
public function __sleep() : array
{
throw new \BadMethodCallException('Cannot serialize ' . __CLASS__);
}
public function __wakeup()
{
throw new \BadMethodCallException('Cannot unserialize ' . __CLASS__);
}
public function __destruct()
{
$this->close();
}
/**
* {@inheritdoc}
*/
public function getDescriptors() : array
{
if (!$this->haveReadSupport) {
$nullstream = \fopen('NUL', 'c');
return [['pipe', 'r'], $nullstream, $nullstream];
}
// We're not using pipe on Windows platform as it hangs (https://bugs.php.net/51800)
// We're not using file handles as it can produce corrupted output https://bugs.php.net/65650
// So we redirect output within the commandline and pass the nul device to the process
return [['pipe', 'r'], ['file', 'NUL', 'w'], ['file', 'NUL', 'w']];
}
/**
* {@inheritdoc}
*/
public function getFiles() : array
{
return $this->files;
}
/**
* {@inheritdoc}
*/
public function readAndWrite(bool $blocking, bool $close = \false) : array
{
$this->unblock();
$w = $this->write();
$read = $r = $e = [];
if ($blocking) {
if ($w) {
@\stream_select($r, $w, $e, 0, Process::TIMEOUT_PRECISION * 1000000.0);
} elseif ($this->fileHandles) {
\usleep((int) (Process::TIMEOUT_PRECISION * 1000000.0));
}
}
foreach ($this->fileHandles as $type => $fileHandle) {
$data = \stream_get_contents($fileHandle, -1, $this->readBytes[$type]);
if (isset($data[0])) {
$this->readBytes[$type] += \strlen($data);
$read[$type] = $data;
}
if ($close) {
\ftruncate($fileHandle, 0);
\fclose($fileHandle);
\flock($this->lockHandles[$type], \LOCK_UN);
\fclose($this->lockHandles[$type]);
unset($this->fileHandles[$type], $this->lockHandles[$type]);
}
}
return $read;
}
/**
* {@inheritdoc}
*/
public function haveReadSupport() : bool
{
return $this->haveReadSupport;
}
/**
* {@inheritdoc}
*/
public function areOpen() : bool
{
return $this->pipes && $this->fileHandles;
}
/**
* {@inheritdoc}
*/
public function close()
{
parent::close();
foreach ($this->fileHandles as $type => $handle) {
\ftruncate($handle, 0);
\fclose($handle);
\flock($this->lockHandles[$type], \LOCK_UN);
\fclose($this->lockHandles[$type]);
}
$this->fileHandles = $this->lockHandles = [];
}
}
Copyright (c) 2004-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\LogicException;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\RuntimeException;
/**
* PhpProcess runs a PHP script in an independent process.
*
* $p = new PhpProcess('<?php echo "foo"; ?>');
* $p->run();
* print $p->getOutput()."\n";
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class PhpProcess extends Process
{
/**
* @param string $script The PHP script to run (as a string)
* @param string|null $cwd The working directory or null to use the working dir of the current PHP process
* @param array|null $env The environment variables or null to use the same environment as the current PHP process
* @param int $timeout The timeout in seconds
* @param array|null $php Path to the PHP binary to use with any additional arguments
*/
public function __construct(string $script, ?string $cwd = null, ?array $env = null, int $timeout = 60, ?array $php = null)
{
if (null === $php) {
$executableFinder = new PhpExecutableFinder();
$php = $executableFinder->find(\false);
$php = \false === $php ? null : \array_merge([$php], $executableFinder->findArguments());
}
if ('phpdbg' === \PHP_SAPI) {
$file = \tempnam(\sys_get_temp_dir(), 'dbg');
\file_put_contents($file, $script);
\register_shutdown_function('unlink', $file);
$php[] = $file;
$script = null;
}
parent::__construct($php, $cwd, $env, $script, $timeout);
}
/**
* {@inheritdoc}
*/
public static function fromShellCommandline(string $command, ?string $cwd = null, ?array $env = null, $input = null, ?float $timeout = 60)
{
throw new LogicException(\sprintf('The "%s()" method cannot be called when using "%s".', __METHOD__, self::class));
}
/**
* {@inheritdoc}
*/
public function start(?callable $callback = null, array $env = [])
{
if (null === $this->getCommandLine()) {
throw new RuntimeException('Unable to find the PHP executable.');
}
parent::start($callback, $env);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Exception;
/**
* RuntimeException for the Process Component.
*
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*/
class RuntimeException extends \RuntimeException implements ExceptionInterface
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Exception;
use _PHPStan_6dcda722c\Symfony\Component\Process\Process;
/**
* Exception that is thrown when a process has been signaled.
*
* @author Sullivan Senechal <soullivaneuh@gmail.com>
*/
final class ProcessSignaledException extends RuntimeException
{
private $process;
public function __construct(Process $process)
{
$this->process = $process;
parent::__construct(\sprintf('The process has been signaled with signal "%s".', $process->getTermSignal()));
}
public function getProcess() : Process
{
return $this->process;
}
public function getSignal() : int
{
return $this->getProcess()->getTermSignal();
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Exception;
use _PHPStan_6dcda722c\Symfony\Component\Process\Process;
/**
* Exception that is thrown when a process times out.
*
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*/
class ProcessTimedOutException extends RuntimeException
{
public const TYPE_GENERAL = 1;
public const TYPE_IDLE = 2;
private $process;
private $timeoutType;
public function __construct(Process $process, int $timeoutType)
{
$this->process = $process;
$this->timeoutType = $timeoutType;
parent::__construct(\sprintf('The process "%s" exceeded the timeout of %s seconds.', $process->getCommandLine(), $this->getExceededTimeout()));
}
public function getProcess()
{
return $this->process;
}
public function isGeneralTimeout()
{
return self::TYPE_GENERAL === $this->timeoutType;
}
public function isIdleTimeout()
{
return self::TYPE_IDLE === $this->timeoutType;
}
public function getExceededTimeout()
{
switch ($this->timeoutType) {
case self::TYPE_GENERAL:
return $this->process->getTimeout();
case self::TYPE_IDLE:
return $this->process->getIdleTimeout();
default:
throw new \LogicException(\sprintf('Unknown timeout type "%d".', $this->timeoutType));
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Exception;
/**
* Marker Interface for the Process Component.
*
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*/
interface ExceptionInterface extends \Throwable
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Exception;
/**
* LogicException for the Process Component.
*
* @author Romain Neutron <imprec@gmail.com>
*/
class LogicException extends \LogicException implements ExceptionInterface
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Exception;
use _PHPStan_6dcda722c\Symfony\Component\Process\Process;
/**
* Exception for failed processes.
*
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*/
class ProcessFailedException extends RuntimeException
{
private $process;
public function __construct(Process $process)
{
if ($process->isSuccessful()) {
throw new InvalidArgumentException('Expected a failed process, but the given process was successful.');
}
$error = \sprintf('The command "%s" failed.' . "\n\nExit Code: %s(%s)\n\nWorking directory: %s", $process->getCommandLine(), $process->getExitCode(), $process->getExitCodeText(), $process->getWorkingDirectory());
if (!$process->isOutputDisabled()) {
$error .= \sprintf("\n\nOutput:\n================\n%s\n\nError Output:\n================\n%s", $process->getOutput(), $process->getErrorOutput());
}
parent::__construct($error);
$this->process = $process;
}
public function getProcess()
{
return $this->process;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process\Exception;
/**
* InvalidArgumentException for the Process Component.
*
* @author Romain Neutron <imprec@gmail.com>
*/
class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process;
/**
* Generic executable finder.
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*/
class ExecutableFinder
{
private $suffixes = ['.exe', '.bat', '.cmd', '.com'];
/**
* Replaces default suffixes of executable.
*/
public function setSuffixes(array $suffixes)
{
$this->suffixes = $suffixes;
}
/**
* Adds new possible suffix to check for executable.
*/
public function addSuffix(string $suffix)
{
$this->suffixes[] = $suffix;
}
/**
* Finds an executable by name.
*
* @param string $name The executable name (without the extension)
* @param string|null $default The default to return if no executable is found
* @param array $extraDirs Additional dirs to check into
*
* @return string|null
*/
public function find(string $name, ?string $default = null, array $extraDirs = [])
{
if (\ini_get('open_basedir')) {
$searchPath = \array_merge(\explode(\PATH_SEPARATOR, \ini_get('open_basedir')), $extraDirs);
$dirs = [];
foreach ($searchPath as $path) {
// Silencing against https://bugs.php.net/69240
if (@\is_dir($path)) {
$dirs[] = $path;
} else {
if (\basename($path) == $name && @\is_executable($path)) {
return $path;
}
}
}
} else {
$dirs = \array_merge(\explode(\PATH_SEPARATOR, \getenv('PATH') ?: \getenv('Path')), $extraDirs);
}
$suffixes = [''];
if ('\\' === \DIRECTORY_SEPARATOR) {
$pathExt = \getenv('PATHEXT');
$suffixes = \array_merge($pathExt ? \explode(\PATH_SEPARATOR, $pathExt) : $this->suffixes, $suffixes);
}
foreach ($suffixes as $suffix) {
foreach ($dirs as $dir) {
if (@\is_file($file = $dir . \DIRECTORY_SEPARATOR . $name . $suffix) && ('\\' === \DIRECTORY_SEPARATOR || @\is_executable($file))) {
return $file;
}
}
}
return $default;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\InvalidArgumentException;
/**
* ProcessUtils is a bunch of utility methods.
*
* This class contains static methods only and is not meant to be instantiated.
*
* @author Martin Hasoň <martin.hason@gmail.com>
*/
class ProcessUtils
{
/**
* This class should not be instantiated.
*/
private function __construct()
{
}
/**
* Validates and normalizes a Process input.
*
* @param string $caller The name of method call that validates the input
* @param mixed $input The input to validate
*
* @return mixed
*
* @throws InvalidArgumentException In case the input is not valid
*/
public static function validateInput(string $caller, $input)
{
if (null !== $input) {
if (\is_resource($input)) {
return $input;
}
if (\is_string($input)) {
return $input;
}
if (\is_scalar($input)) {
return (string) $input;
}
if ($input instanceof Process) {
return $input->getIterator($input::ITER_SKIP_ERR);
}
if ($input instanceof \Iterator) {
return $input;
}
if ($input instanceof \Traversable) {
return new \IteratorIterator($input);
}
throw new InvalidArgumentException(\sprintf('"%s" only accepts strings, Traversable objects or stream resources.', $caller));
}
return $input;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\RuntimeException;
/**
* Provides a way to continuously write to the input of a Process until the InputStream is closed.
*
* @author Nicolas Grekas <p@tchwork.com>
*
* @implements \IteratorAggregate<int, string>
*/
class InputStream implements \IteratorAggregate
{
/** @var callable|null */
private $onEmpty = null;
private $input = [];
private $open = \true;
/**
* Sets a callback that is called when the write buffer becomes empty.
*/
public function onEmpty(?callable $onEmpty = null)
{
$this->onEmpty = $onEmpty;
}
/**
* Appends an input to the write buffer.
*
* @param resource|string|int|float|bool|\Traversable|null $input The input to append as scalar,
* stream resource or \Traversable
*/
public function write($input)
{
if (null === $input) {
return;
}
if ($this->isClosed()) {
throw new RuntimeException(\sprintf('"%s" is closed.', static::class));
}
$this->input[] = ProcessUtils::validateInput(__METHOD__, $input);
}
/**
* Closes the write buffer.
*/
public function close()
{
$this->open = \false;
}
/**
* Tells whether the write buffer is closed or not.
*/
public function isClosed()
{
return !$this->open;
}
/**
* @return \Traversable<int, string>
*/
#[\ReturnTypeWillChange]
public function getIterator()
{
$this->open = \true;
while ($this->open || $this->input) {
if (!$this->input) {
(yield '');
continue;
}
$current = \array_shift($this->input);
if ($current instanceof \Iterator) {
yield from $current;
} else {
(yield $current);
}
if (!$this->input && $this->open && null !== ($onEmpty = $this->onEmpty)) {
$this->write($onEmpty($this));
}
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Process;
/**
* An executable finder specifically designed for the PHP executable.
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*/
class PhpExecutableFinder
{
private $executableFinder;
public function __construct()
{
$this->executableFinder = new ExecutableFinder();
}
/**
* Finds The PHP executable.
*
* @return string|false
*/
public function find(bool $includeArgs = \true)
{
if ($php = \getenv('PHP_BINARY')) {
if (!\is_executable($php)) {
$command = '\\' === \DIRECTORY_SEPARATOR ? 'where' : 'command -v --';
if ($php = \strtok(\exec($command . ' ' . \escapeshellarg($php)), \PHP_EOL)) {
if (!\is_executable($php)) {
return \false;
}
} else {
return \false;
}
}
if (@\is_dir($php)) {
return \false;
}
return $php;
}
$args = $this->findArguments();
$args = $includeArgs && $args ? ' ' . \implode(' ', $args) : '';
// PHP_BINARY return the current sapi executable
if (\PHP_BINARY && \in_array(\PHP_SAPI, ['cli', 'cli-server', 'phpdbg'], \true)) {
return \PHP_BINARY . $args;
}
if ($php = \getenv('PHP_PATH')) {
if (!@\is_executable($php) || @\is_dir($php)) {
return \false;
}
return $php;
}
if ($php = \getenv('PHP_PEAR_PHP_BIN')) {
if (@\is_executable($php) && !@\is_dir($php)) {
return $php;
}
}
if (@\is_executable($php = \PHP_BINDIR . ('\\' === \DIRECTORY_SEPARATOR ? '\\php.exe' : '/php')) && !@\is_dir($php)) {
return $php;
}
$dirs = [\PHP_BINDIR];
if ('\\' === \DIRECTORY_SEPARATOR) {
$dirs[] = 'C:\\xampp\\php\\';
}
return $this->executableFinder->find('php', \false, $dirs);
}
/**
* Finds the PHP executable arguments.
*
* @return array
*/
public function findArguments()
{
$arguments = [];
if ('phpdbg' === \PHP_SAPI) {
$arguments[] = '-qrr';
}
return $arguments;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Polyfill\Mbstring;
/**
* Partial mbstring implementation in PHP, iconv based, UTF-8 centric.
*
* Implemented:
* - mb_chr - Returns a specific character from its Unicode code point
* - mb_convert_encoding - Convert character encoding
* - mb_convert_variables - Convert character code in variable(s)
* - mb_decode_mimeheader - Decode string in MIME header field
* - mb_encode_mimeheader - Encode string for MIME header XXX NATIVE IMPLEMENTATION IS REALLY BUGGED
* - mb_decode_numericentity - Decode HTML numeric string reference to character
* - mb_encode_numericentity - Encode character to HTML numeric string reference
* - mb_convert_case - Perform case folding on a string
* - mb_detect_encoding - Detect character encoding
* - mb_get_info - Get internal settings of mbstring
* - mb_http_input - Detect HTTP input character encoding
* - mb_http_output - Set/Get HTTP output character encoding
* - mb_internal_encoding - Set/Get internal character encoding
* - mb_list_encodings - Returns an array of all supported encodings
* - mb_ord - Returns the Unicode code point of a character
* - mb_output_handler - Callback function converts character encoding in output buffer
* - mb_scrub - Replaces ill-formed byte sequences with substitute characters
* - mb_strlen - Get string length
* - mb_strpos - Find position of first occurrence of string in a string
* - mb_strrpos - Find position of last occurrence of a string in a string
* - mb_str_split - Convert a string to an array
* - mb_strtolower - Make a string lowercase
* - mb_strtoupper - Make a string uppercase
* - mb_substitute_character - Set/Get substitution character
* - mb_substr - Get part of string
* - mb_stripos - Finds position of first occurrence of a string within another, case insensitive
* - mb_stristr - Finds first occurrence of a string within another, case insensitive
* - mb_strrchr - Finds the last occurrence of a character in a string within another
* - mb_strrichr - Finds the last occurrence of a character in a string within another, case insensitive
* - mb_strripos - Finds position of last occurrence of a string within another, case insensitive
* - mb_strstr - Finds first occurrence of a string within another
* - mb_strwidth - Return width of string
* - mb_substr_count - Count the number of substring occurrences
* - mb_ucfirst - Make a string's first character uppercase
* - mb_lcfirst - Make a string's first character lowercase
*
* Not implemented:
* - mb_convert_kana - Convert "kana" one from another ("zen-kaku", "han-kaku" and more)
* - mb_ereg_* - Regular expression with multibyte support
* - mb_parse_str - Parse GET/POST/COOKIE data and set global variable
* - mb_preferred_mime_name - Get MIME charset string
* - mb_regex_encoding - Returns current encoding for multibyte regex as string
* - mb_regex_set_options - Set/Get the default options for mbregex functions
* - mb_send_mail - Send encoded mail
* - mb_split - Split multibyte string using regular expression
* - mb_strcut - Get part of string
* - mb_strimwidth - Get truncated string with specified width
*
* @author Nicolas Grekas <p@tchwork.com>
*
* @internal
*/
final class Mbstring
{
public const MB_CASE_FOLD = \PHP_INT_MAX;
private const SIMPLE_CASE_FOLD = [
['µ', 'ſ', "\xCD\x85", 'ς', "\xCF\x90", "\xCF\x91", "\xCF\x95", "\xCF\x96", "\xCF\xB0", "\xCF\xB1", "\xCF\xB5", "\xE1\xBA\x9B", "\xE1\xBE\xBE"],
['μ', 's', 'ι', 'σ', 'β', 'θ', 'φ', 'π', 'κ', 'ρ', 'ε', "\xE1\xB9\xA1", 'ι'],
];
private static $encodingList = ['ASCII', 'UTF-8'];
private static $language = 'neutral';
private static $internalEncoding = 'UTF-8';
public static function mb_convert_encoding($s, $toEncoding, $fromEncoding = null)
{
if (\is_array($s)) {
if (PHP_VERSION_ID < 70200) {
trigger_error('mb_convert_encoding() expects parameter 1 to be string, array given', \E_USER_WARNING);
return null;
}
$r = [];
foreach ($s as $str) {
$r[] = self::mb_convert_encoding($str, $toEncoding, $fromEncoding);
}
return $r;
}
if (\is_array($fromEncoding) || (null !== $fromEncoding && false !== strpos($fromEncoding, ','))) {
$fromEncoding = self::mb_detect_encoding($s, $fromEncoding);
} else {
$fromEncoding = self::getEncoding($fromEncoding);
}
$toEncoding = self::getEncoding($toEncoding);
if ('BASE64' === $fromEncoding) {
$s = base64_decode($s);
$fromEncoding = $toEncoding;
}
if ('BASE64' === $toEncoding) {
return base64_encode($s);
}
if ('HTML-ENTITIES' === $toEncoding || 'HTML' === $toEncoding) {
if ('HTML-ENTITIES' === $fromEncoding || 'HTML' === $fromEncoding) {
$fromEncoding = 'Windows-1252';
}
if ('UTF-8' !== $fromEncoding) {
$s = iconv($fromEncoding, 'UTF-8//IGNORE', $s);
}
return preg_replace_callback('/[\x80-\xFF]+/', [__CLASS__, 'html_encoding_callback'], $s);
}
if ('HTML-ENTITIES' === $fromEncoding) {
$s = html_entity_decode($s, \ENT_COMPAT, 'UTF-8');
$fromEncoding = 'UTF-8';
}
return iconv($fromEncoding, $toEncoding.'//IGNORE', $s);
}
public static function mb_convert_variables($toEncoding, $fromEncoding, &...$vars)
{
$ok = true;
array_walk_recursive($vars, function (&$v) use (&$ok, $toEncoding, $fromEncoding) {
if (false === $v = self::mb_convert_encoding($v, $toEncoding, $fromEncoding)) {
$ok = false;
}
});
return $ok ? $fromEncoding : false;
}
public static function mb_decode_mimeheader($s)
{
return iconv_mime_decode($s, 2, self::$internalEncoding);
}
public static function mb_encode_mimeheader($s, $charset = null, $transferEncoding = null, $linefeed = null, $indent = null)
{
trigger_error('mb_encode_mimeheader() is bugged. Please use iconv_mime_encode() instead', \E_USER_WARNING);
}
public static function mb_decode_numericentity($s, $convmap, $encoding = null)
{
if (null !== $s && !\is_scalar($s) && !(\is_object($s) && method_exists($s, '__toString'))) {
trigger_error('mb_decode_numericentity() expects parameter 1 to be string, '.\gettype($s).' given', \E_USER_WARNING);
return null;
}
if (!\is_array($convmap) || (80000 > \PHP_VERSION_ID && !$convmap)) {
return false;
}
if (null !== $encoding && !\is_scalar($encoding)) {
trigger_error('mb_decode_numericentity() expects parameter 3 to be string, '.\gettype($s).' given', \E_USER_WARNING);
return ''; // Instead of null (cf. mb_encode_numericentity).
}
$s = (string) $s;
if ('' === $s) {
return '';
}
$encoding = self::getEncoding($encoding);
if ('UTF-8' === $encoding) {
$encoding = null;
if (!preg_match('//u', $s)) {
$s = @iconv('UTF-8', 'UTF-8//IGNORE', $s);
}
} else {
$s = iconv($encoding, 'UTF-8//IGNORE', $s);
}
$cnt = floor(\count($convmap) / 4) * 4;
for ($i = 0; $i < $cnt; $i += 4) {
// collector_decode_htmlnumericentity ignores $convmap[$i + 3]
$convmap[$i] += $convmap[$i + 2];
$convmap[$i + 1] += $convmap[$i + 2];
}
$s = preg_replace_callback('/&#(?:0*([0-9]+)|x0*([0-9a-fA-F]+))(?!&);?/', function (array $m) use ($cnt, $convmap) {
$c = isset($m[2]) ? (int) hexdec($m[2]) : $m[1];
for ($i = 0; $i < $cnt; $i += 4) {
if ($c >= $convmap[$i] && $c <= $convmap[$i + 1]) {
return self::mb_chr($c - $convmap[$i + 2]);
}
}
return $m[0];
}, $s);
if (null === $encoding) {
return $s;
}
return iconv('UTF-8', $encoding.'//IGNORE', $s);
}
public static function mb_encode_numericentity($s, $convmap, $encoding = null, $is_hex = false)
{
if (null !== $s && !\is_scalar($s) && !(\is_object($s) && method_exists($s, '__toString'))) {
trigger_error('mb_encode_numericentity() expects parameter 1 to be string, '.\gettype($s).' given', \E_USER_WARNING);
return null;
}
if (!\is_array($convmap) || (80000 > \PHP_VERSION_ID && !$convmap)) {
return false;
}
if (null !== $encoding && !\is_scalar($encoding)) {
trigger_error('mb_encode_numericentity() expects parameter 3 to be string, '.\gettype($s).' given', \E_USER_WARNING);
return null; // Instead of '' (cf. mb_decode_numericentity).
}
if (null !== $is_hex && !\is_scalar($is_hex)) {
trigger_error('mb_encode_numericentity() expects parameter 4 to be boolean, '.\gettype($s).' given', \E_USER_WARNING);
return null;
}
$s = (string) $s;
if ('' === $s) {
return '';
}
$encoding = self::getEncoding($encoding);
if ('UTF-8' === $encoding) {
$encoding = null;
if (!preg_match('//u', $s)) {
$s = @iconv('UTF-8', 'UTF-8//IGNORE', $s);
}
} else {
$s = iconv($encoding, 'UTF-8//IGNORE', $s);
}
static $ulenMask = ["\xC0" => 2, "\xD0" => 2, "\xE0" => 3, "\xF0" => 4];
$cnt = floor(\count($convmap) / 4) * 4;
$i = 0;
$len = \strlen($s);
$result = '';
while ($i < $len) {
$ulen = $s[$i] < "\x80" ? 1 : $ulenMask[$s[$i] & "\xF0"];
$uchr = substr($s, $i, $ulen);
$i += $ulen;
$c = self::mb_ord($uchr);
for ($j = 0; $j < $cnt; $j += 4) {
if ($c >= $convmap[$j] && $c <= $convmap[$j + 1]) {
$cOffset = ($c + $convmap[$j + 2]) & $convmap[$j + 3];
$result .= $is_hex ? sprintf('&#x%X;', $cOffset) : '&#'.$cOffset.';';
continue 2;
}
}
$result .= $uchr;
}
if (null === $encoding) {
return $result;
}
return iconv('UTF-8', $encoding.'//IGNORE', $result);
}
public static function mb_convert_case($s, $mode, $encoding = null)
{
$s = (string) $s;
if ('' === $s) {
return '';
}
$encoding = self::getEncoding($encoding);
if ('UTF-8' === $encoding) {
$encoding = null;
if (!preg_match('//u', $s)) {
$s = @iconv('UTF-8', 'UTF-8//IGNORE', $s);
}
} else {
$s = iconv($encoding, 'UTF-8//IGNORE', $s);
}
if (\MB_CASE_TITLE == $mode) {
static $titleRegexp = null;
if (null === $titleRegexp) {
$titleRegexp = self::getData('titleCaseRegexp');
}
$s = preg_replace_callback($titleRegexp, [__CLASS__, 'title_case'], $s);
} else {
if (\MB_CASE_UPPER == $mode) {
static $upper = null;
if (null === $upper) {
$upper = self::getData('upperCase');
}
$map = $upper;
} else {
if (self::MB_CASE_FOLD === $mode) {
static $caseFolding = null;
if (null === $caseFolding) {
$caseFolding = self::getData('caseFolding');
}
$s = strtr($s, $caseFolding);
}
static $lower = null;
if (null === $lower) {
$lower = self::getData('lowerCase');
}
$map = $lower;
}
static $ulenMask = ["\xC0" => 2, "\xD0" => 2, "\xE0" => 3, "\xF0" => 4];
$i = 0;
$len = \strlen($s);
while ($i < $len) {
$ulen = $s[$i] < "\x80" ? 1 : $ulenMask[$s[$i] & "\xF0"];
$uchr = substr($s, $i, $ulen);
$i += $ulen;
if (isset($map[$uchr])) {
$uchr = $map[$uchr];
$nlen = \strlen($uchr);
if ($nlen == $ulen) {
$nlen = $i;
do {
$s[--$nlen] = $uchr[--$ulen];
} while ($ulen);
} else {
$s = substr_replace($s, $uchr, $i - $ulen, $ulen);
$len += $nlen - $ulen;
$i += $nlen - $ulen;
}
}
}
}
if (null === $encoding) {
return $s;
}
return iconv('UTF-8', $encoding.'//IGNORE', $s);
}
public static function mb_internal_encoding($encoding = null)
{
if (null === $encoding) {
return self::$internalEncoding;
}
$normalizedEncoding = self::getEncoding($encoding);
if ('UTF-8' === $normalizedEncoding || false !== @iconv($normalizedEncoding, $normalizedEncoding, ' ')) {
self::$internalEncoding = $normalizedEncoding;
return true;
}
if (80000 > \PHP_VERSION_ID) {
return false;
}
throw new \ValueError(sprintf('Argument #1 ($encoding) must be a valid encoding, "%s" given', $encoding));
}
public static function mb_language($lang = null)
{
if (null === $lang) {
return self::$language;
}
switch ($normalizedLang = strtolower($lang)) {
case 'uni':
case 'neutral':
self::$language = $normalizedLang;
return true;
}
if (80000 > \PHP_VERSION_ID) {
return false;
}
throw new \ValueError(sprintf('Argument #1 ($language) must be a valid language, "%s" given', $lang));
}
public static function mb_list_encodings()
{
return ['UTF-8'];
}
public static function mb_encoding_aliases($encoding)
{
switch (strtoupper($encoding)) {
case 'UTF8':
case 'UTF-8':
return ['utf8'];
}
return false;
}
public static function mb_check_encoding($var = null, $encoding = null)
{
if (\PHP_VERSION_ID < 70200 && \is_array($var)) {
trigger_error('mb_check_encoding() expects parameter 1 to be string, array given', \E_USER_WARNING);
return null;
}
if (null === $encoding) {
if (null === $var) {
return false;
}
$encoding = self::$internalEncoding;
}
if (!\is_array($var)) {
return self::mb_detect_encoding($var, [$encoding]) || false !== @iconv($encoding, $encoding, $var);
}
foreach ($var as $key => $value) {
if (!self::mb_check_encoding($key, $encoding)) {
return false;
}
if (!self::mb_check_encoding($value, $encoding)) {
return false;
}
}
return true;
}
public static function mb_detect_encoding($str, $encodingList = null, $strict = false)
{
if (null === $encodingList) {
$encodingList = self::$encodingList;
} else {
if (!\is_array($encodingList)) {
$encodingList = array_map('trim', explode(',', $encodingList));
}
$encodingList = array_map('strtoupper', $encodingList);
}
foreach ($encodingList as $enc) {
switch ($enc) {
case 'ASCII':
if (!preg_match('/[\x80-\xFF]/', $str)) {
return $enc;
}
break;
case 'UTF8':
case 'UTF-8':
if (preg_match('//u', $str)) {
return 'UTF-8';
}
break;
default:
if (0 === strncmp($enc, 'ISO-8859-', 9)) {
return $enc;
}
}
}
return false;
}
public static function mb_detect_order($encodingList = null)
{
if (null === $encodingList) {
return self::$encodingList;
}
if (!\is_array($encodingList)) {
$encodingList = array_map('trim', explode(',', $encodingList));
}
$encodingList = array_map('strtoupper', $encodingList);
foreach ($encodingList as $enc) {
switch ($enc) {
default:
if (strncmp($enc, 'ISO-8859-', 9)) {
return false;
}
// no break
case 'ASCII':
case 'UTF8':
case 'UTF-8':
}
}
self::$encodingList = $encodingList;
return true;
}
public static function mb_strlen($s, $encoding = null)
{
$encoding = self::getEncoding($encoding);
if ('CP850' === $encoding || 'ASCII' === $encoding) {
return \strlen($s);
}
return @iconv_strlen($s, $encoding);
}
public static function mb_strpos($haystack, $needle, $offset = 0, $encoding = null)
{
$encoding = self::getEncoding($encoding);
if ('CP850' === $encoding || 'ASCII' === $encoding) {
return strpos($haystack, $needle, $offset);
}
$needle = (string) $needle;
if ('' === $needle) {
if (80000 > \PHP_VERSION_ID) {
trigger_error(__METHOD__.': Empty delimiter', \E_USER_WARNING);
return false;
}
return 0;
}
return iconv_strpos($haystack, $needle, $offset, $encoding);
}
public static function mb_strrpos($haystack, $needle, $offset = 0, $encoding = null)
{
$encoding = self::getEncoding($encoding);
if ('CP850' === $encoding || 'ASCII' === $encoding) {
return strrpos($haystack, $needle, $offset);
}
if ($offset != (int) $offset) {
$offset = 0;
} elseif ($offset = (int) $offset) {
if ($offset < 0) {
if (0 > $offset += self::mb_strlen($needle)) {
$haystack = self::mb_substr($haystack, 0, $offset, $encoding);
}
$offset = 0;
} else {
$haystack = self::mb_substr($haystack, $offset, 2147483647, $encoding);
}
}
$pos = '' !== $needle || 80000 > \PHP_VERSION_ID
? iconv_strrpos($haystack, $needle, $encoding)
: self::mb_strlen($haystack, $encoding);
return false !== $pos ? $offset + $pos : false;
}
public static function mb_str_split($string, $split_length = 1, $encoding = null)
{
if (null !== $string && !\is_scalar($string) && !(\is_object($string) && method_exists($string, '__toString'))) {
trigger_error('mb_str_split() expects parameter 1 to be string, '.\gettype($string).' given', \E_USER_WARNING);
return null;
}
if (1 > $split_length = (int) $split_length) {
if (80000 > \PHP_VERSION_ID) {
trigger_error('The length of each segment must be greater than zero', \E_USER_WARNING);
return false;
}
throw new \ValueError('Argument #2 ($length) must be greater than 0');
}
if (null === $encoding) {
$encoding = mb_internal_encoding();
}
if ('UTF-8' === $encoding = self::getEncoding($encoding)) {
$rx = '/(';
while (65535 < $split_length) {
$rx .= '.{65535}';
$split_length -= 65535;
}
$rx .= '.{'.$split_length.'})/us';
return preg_split($rx, $string, -1, \PREG_SPLIT_DELIM_CAPTURE | \PREG_SPLIT_NO_EMPTY);
}
$result = [];
$length = mb_strlen($string, $encoding);
for ($i = 0; $i < $length; $i += $split_length) {
$result[] = mb_substr($string, $i, $split_length, $encoding);
}
return $result;
}
public static function mb_strtolower($s, $encoding = null)
{
return self::mb_convert_case($s, \MB_CASE_LOWER, $encoding);
}
public static function mb_strtoupper($s, $encoding = null)
{
return self::mb_convert_case($s, \MB_CASE_UPPER, $encoding);
}
public static function mb_substitute_character($c = null)
{
if (null === $c) {
return 'none';
}
if (0 === strcasecmp($c, 'none')) {
return true;
}
if (80000 > \PHP_VERSION_ID) {
return false;
}
if (\is_int($c) || 'long' === $c || 'entity' === $c) {
return false;
}
throw new \ValueError('Argument #1 ($substitute_character) must be "none", "long", "entity" or a valid codepoint');
}
public static function mb_substr($s, $start, $length = null, $encoding = null)
{
$encoding = self::getEncoding($encoding);
if ('CP850' === $encoding || 'ASCII' === $encoding) {
return (string) substr($s, $start, null === $length ? 2147483647 : $length);
}
if ($start < 0) {
$start = iconv_strlen($s, $encoding) + $start;
if ($start < 0) {
$start = 0;
}
}
if (null === $length) {
$length = 2147483647;
} elseif ($length < 0) {
$length = iconv_strlen($s, $encoding) + $length - $start;
if ($length < 0) {
return '';
}
}
return (string) iconv_substr($s, $start, $length, $encoding);
}
public static function mb_stripos($haystack, $needle, $offset = 0, $encoding = null)
{
[$haystack, $needle] = str_replace(self::SIMPLE_CASE_FOLD[0], self::SIMPLE_CASE_FOLD[1], [
self::mb_convert_case($haystack, \MB_CASE_LOWER, $encoding),
self::mb_convert_case($needle, \MB_CASE_LOWER, $encoding),
]);
return self::mb_strpos($haystack, $needle, $offset, $encoding);
}
public static function mb_stristr($haystack, $needle, $part = false, $encoding = null)
{
$pos = self::mb_stripos($haystack, $needle, 0, $encoding);
return self::getSubpart($pos, $part, $haystack, $encoding);
}
public static function mb_strrchr($haystack, $needle, $part = false, $encoding = null)
{
$encoding = self::getEncoding($encoding);
if ('CP850' === $encoding || 'ASCII' === $encoding) {
$pos = strrpos($haystack, $needle);
} else {
$needle = self::mb_substr($needle, 0, 1, $encoding);
$pos = iconv_strrpos($haystack, $needle, $encoding);
}
return self::getSubpart($pos, $part, $haystack, $encoding);
}
public static function mb_strrichr($haystack, $needle, $part = false, $encoding = null)
{
$needle = self::mb_substr($needle, 0, 1, $encoding);
$pos = self::mb_strripos($haystack, $needle, $encoding);
return self::getSubpart($pos, $part, $haystack, $encoding);
}
public static function mb_strripos($haystack, $needle, $offset = 0, $encoding = null)
{
$haystack = self::mb_convert_case($haystack, \MB_CASE_LOWER, $encoding);
$needle = self::mb_convert_case($needle, \MB_CASE_LOWER, $encoding);
$haystack = str_replace(self::SIMPLE_CASE_FOLD[0], self::SIMPLE_CASE_FOLD[1], $haystack);
$needle = str_replace(self::SIMPLE_CASE_FOLD[0], self::SIMPLE_CASE_FOLD[1], $needle);
return self::mb_strrpos($haystack, $needle, $offset, $encoding);
}
public static function mb_strstr($haystack, $needle, $part = false, $encoding = null)
{
$pos = strpos($haystack, $needle);
if (false === $pos) {
return false;
}
if ($part) {
return substr($haystack, 0, $pos);
}
return substr($haystack, $pos);
}
public static function mb_get_info($type = 'all')
{
$info = [
'internal_encoding' => self::$internalEncoding,
'http_output' => 'pass',
'http_output_conv_mimetypes' => '^(text/|application/xhtml\+xml)',
'func_overload' => 0,
'func_overload_list' => 'no overload',
'mail_charset' => 'UTF-8',
'mail_header_encoding' => 'BASE64',
'mail_body_encoding' => 'BASE64',
'illegal_chars' => 0,
'encoding_translation' => 'Off',
'language' => self::$language,
'detect_order' => self::$encodingList,
'substitute_character' => 'none',
'strict_detection' => 'Off',
];
if ('all' === $type) {
return $info;
}
if (isset($info[$type])) {
return $info[$type];
}
return false;
}
public static function mb_http_input($type = '')
{
return false;
}
public static function mb_http_output($encoding = null)
{
return null !== $encoding ? 'pass' === $encoding : 'pass';
}
public static function mb_strwidth($s, $encoding = null)
{
$encoding = self::getEncoding($encoding);
if ('UTF-8' !== $encoding) {
$s = iconv($encoding, 'UTF-8//IGNORE', $s);
}
$s = preg_replace('/[\x{1100}-\x{115F}\x{2329}\x{232A}\x{2E80}-\x{303E}\x{3040}-\x{A4CF}\x{AC00}-\x{D7A3}\x{F900}-\x{FAFF}\x{FE10}-\x{FE19}\x{FE30}-\x{FE6F}\x{FF00}-\x{FF60}\x{FFE0}-\x{FFE6}\x{20000}-\x{2FFFD}\x{30000}-\x{3FFFD}]/u', '', $s, -1, $wide);
return ($wide << 1) + iconv_strlen($s, 'UTF-8');
}
public static function mb_substr_count($haystack, $needle, $encoding = null)
{
return substr_count($haystack, $needle);
}
public static function mb_output_handler($contents, $status)
{
return $contents;
}
public static function mb_chr($code, $encoding = null)
{
if (0x80 > $code %= 0x200000) {
$s = \chr($code);
} elseif (0x800 > $code) {
$s = \chr(0xC0 | $code >> 6).\chr(0x80 | $code & 0x3F);
} elseif (0x10000 > $code) {
$s = \chr(0xE0 | $code >> 12).\chr(0x80 | $code >> 6 & 0x3F).\chr(0x80 | $code & 0x3F);
} else {
$s = \chr(0xF0 | $code >> 18).\chr(0x80 | $code >> 12 & 0x3F).\chr(0x80 | $code >> 6 & 0x3F).\chr(0x80 | $code & 0x3F);
}
if ('UTF-8' !== $encoding = self::getEncoding($encoding)) {
$s = mb_convert_encoding($s, $encoding, 'UTF-8');
}
return $s;
}
public static function mb_ord($s, $encoding = null)
{
if ('UTF-8' !== $encoding = self::getEncoding($encoding)) {
$s = mb_convert_encoding($s, 'UTF-8', $encoding);
}
if (1 === \strlen($s)) {
return \ord($s);
}
$code = ($s = unpack('C*', substr($s, 0, 4))) ? $s[1] : 0;
if (0xF0 <= $code) {
return (($code - 0xF0) << 18) + (($s[2] - 0x80) << 12) + (($s[3] - 0x80) << 6) + $s[4] - 0x80;
}
if (0xE0 <= $code) {
return (($code - 0xE0) << 12) + (($s[2] - 0x80) << 6) + $s[3] - 0x80;
}
if (0xC0 <= $code) {
return (($code - 0xC0) << 6) + $s[2] - 0x80;
}
return $code;
}
public static function mb_str_pad(string $string, int $length, string $pad_string = ' ', int $pad_type = \STR_PAD_RIGHT, ?string $encoding = null): string
{
if (!\in_array($pad_type, [\STR_PAD_RIGHT, \STR_PAD_LEFT, \STR_PAD_BOTH], true)) {
throw new \ValueError('mb_str_pad(): Argument #4 ($pad_type) must be STR_PAD_LEFT, STR_PAD_RIGHT, or STR_PAD_BOTH');
}
if (null === $encoding) {
$encoding = self::mb_internal_encoding();
} else {
self::assertEncoding($encoding, 'mb_str_pad(): Argument #5 ($encoding) must be a valid encoding, "%s" given');
}
if (self::mb_strlen($pad_string, $encoding) <= 0) {
throw new \ValueError('mb_str_pad(): Argument #3 ($pad_string) must be a non-empty string');
}
$paddingRequired = $length - self::mb_strlen($string, $encoding);
if ($paddingRequired < 1) {
return $string;
}
switch ($pad_type) {
case \STR_PAD_LEFT:
return self::mb_substr(str_repeat($pad_string, $paddingRequired), 0, $paddingRequired, $encoding).$string;
case \STR_PAD_RIGHT:
return $string.self::mb_substr(str_repeat($pad_string, $paddingRequired), 0, $paddingRequired, $encoding);
default:
$leftPaddingLength = floor($paddingRequired / 2);
$rightPaddingLength = $paddingRequired - $leftPaddingLength;
return self::mb_substr(str_repeat($pad_string, $leftPaddingLength), 0, $leftPaddingLength, $encoding).$string.self::mb_substr(str_repeat($pad_string, $rightPaddingLength), 0, $rightPaddingLength, $encoding);
}
}
public static function mb_ucfirst(string $string, ?string $encoding = null): string
{
if (null === $encoding) {
$encoding = self::mb_internal_encoding();
} else {
self::assertEncoding($encoding, 'mb_ucfirst(): Argument #2 ($encoding) must be a valid encoding, "%s" given');
}
$firstChar = mb_substr($string, 0, 1, $encoding);
$firstChar = mb_convert_case($firstChar, \MB_CASE_TITLE, $encoding);
return $firstChar.mb_substr($string, 1, null, $encoding);
}
public static function mb_lcfirst(string $string, ?string $encoding = null): string
{
if (null === $encoding) {
$encoding = self::mb_internal_encoding();
} else {
self::assertEncoding($encoding, 'mb_lcfirst(): Argument #2 ($encoding) must be a valid encoding, "%s" given');
}
$firstChar = mb_substr($string, 0, 1, $encoding);
$firstChar = mb_convert_case($firstChar, \MB_CASE_LOWER, $encoding);
return $firstChar.mb_substr($string, 1, null, $encoding);
}
private static function getSubpart($pos, $part, $haystack, $encoding)
{
if (false === $pos) {
return false;
}
if ($part) {
return self::mb_substr($haystack, 0, $pos, $encoding);
}
return self::mb_substr($haystack, $pos, null, $encoding);
}
private static function html_encoding_callback(array $m)
{
$i = 1;
$entities = '';
$m = unpack('C*', htmlentities($m[0], \ENT_COMPAT, 'UTF-8'));
while (isset($m[$i])) {
if (0x80 > $m[$i]) {
$entities .= \chr($m[$i++]);
continue;
}
if (0xF0 <= $m[$i]) {
$c = (($m[$i++] - 0xF0) << 18) + (($m[$i++] - 0x80) << 12) + (($m[$i++] - 0x80) << 6) + $m[$i++] - 0x80;
} elseif (0xE0 <= $m[$i]) {
$c = (($m[$i++] - 0xE0) << 12) + (($m[$i++] - 0x80) << 6) + $m[$i++] - 0x80;
} else {
$c = (($m[$i++] - 0xC0) << 6) + $m[$i++] - 0x80;
}
$entities .= '&#'.$c.';';
}
return $entities;
}
private static function title_case(array $s)
{
return self::mb_convert_case($s[1], \MB_CASE_UPPER, 'UTF-8').self::mb_convert_case($s[2], \MB_CASE_LOWER, 'UTF-8');
}
private static function getData($file)
{
if (file_exists($file = __DIR__.'/Resources/unidata/'.$file.'.php')) {
return require $file;
}
return false;
}
private static function getEncoding($encoding)
{
if (null === $encoding) {
return self::$internalEncoding;
}
if ('UTF-8' === $encoding) {
return 'UTF-8';
}
$encoding = strtoupper($encoding);
if ('8BIT' === $encoding || 'BINARY' === $encoding) {
return 'CP850';
}
if ('UTF8' === $encoding) {
return 'UTF-8';
}
return $encoding;
}
private static function assertEncoding(string $encoding, string $errorFormat): void
{
try {
$validEncoding = @self::mb_check_encoding('', $encoding);
} catch (\ValueError $e) {
throw new \ValueError(\sprintf($errorFormat, $encoding));
}
// BC for PHP 7.3 and lower
if (!$validEncoding) {
throw new \ValueError(\sprintf($errorFormat, $encoding));
}
}
}
<?php
// from Case_Ignorable in https://unicode.org/Public/UNIDATA/DerivedCoreProperties.txt
return '/(?<![\x{0027}\x{002E}\x{003A}\x{005E}\x{0060}\x{00A8}\x{00AD}\x{00AF}\x{00B4}\x{00B7}\x{00B8}\x{02B0}-\x{02C1}\x{02C2}-\x{02C5}\x{02C6}-\x{02D1}\x{02D2}-\x{02DF}\x{02E0}-\x{02E4}\x{02E5}-\x{02EB}\x{02EC}\x{02ED}\x{02EE}\x{02EF}-\x{02FF}\x{0300}-\x{036F}\x{0374}\x{0375}\x{037A}\x{0384}-\x{0385}\x{0387}\x{0483}-\x{0487}\x{0488}-\x{0489}\x{0559}\x{0591}-\x{05BD}\x{05BF}\x{05C1}-\x{05C2}\x{05C4}-\x{05C5}\x{05C7}\x{05F4}\x{0600}-\x{0605}\x{0610}-\x{061A}\x{061C}\x{0640}\x{064B}-\x{065F}\x{0670}\x{06D6}-\x{06DC}\x{06DD}\x{06DF}-\x{06E4}\x{06E5}-\x{06E6}\x{06E7}-\x{06E8}\x{06EA}-\x{06ED}\x{070F}\x{0711}\x{0730}-\x{074A}\x{07A6}-\x{07B0}\x{07EB}-\x{07F3}\x{07F4}-\x{07F5}\x{07FA}\x{07FD}\x{0816}-\x{0819}\x{081A}\x{081B}-\x{0823}\x{0824}\x{0825}-\x{0827}\x{0828}\x{0829}-\x{082D}\x{0859}-\x{085B}\x{08D3}-\x{08E1}\x{08E2}\x{08E3}-\x{0902}\x{093A}\x{093C}\x{0941}-\x{0948}\x{094D}\x{0951}-\x{0957}\x{0962}-\x{0963}\x{0971}\x{0981}\x{09BC}\x{09C1}-\x{09C4}\x{09CD}\x{09E2}-\x{09E3}\x{09FE}\x{0A01}-\x{0A02}\x{0A3C}\x{0A41}-\x{0A42}\x{0A47}-\x{0A48}\x{0A4B}-\x{0A4D}\x{0A51}\x{0A70}-\x{0A71}\x{0A75}\x{0A81}-\x{0A82}\x{0ABC}\x{0AC1}-\x{0AC5}\x{0AC7}-\x{0AC8}\x{0ACD}\x{0AE2}-\x{0AE3}\x{0AFA}-\x{0AFF}\x{0B01}\x{0B3C}\x{0B3F}\x{0B41}-\x{0B44}\x{0B4D}\x{0B56}\x{0B62}-\x{0B63}\x{0B82}\x{0BC0}\x{0BCD}\x{0C00}\x{0C04}\x{0C3E}-\x{0C40}\x{0C46}-\x{0C48}\x{0C4A}-\x{0C4D}\x{0C55}-\x{0C56}\x{0C62}-\x{0C63}\x{0C81}\x{0CBC}\x{0CBF}\x{0CC6}\x{0CCC}-\x{0CCD}\x{0CE2}-\x{0CE3}\x{0D00}-\x{0D01}\x{0D3B}-\x{0D3C}\x{0D41}-\x{0D44}\x{0D4D}\x{0D62}-\x{0D63}\x{0DCA}\x{0DD2}-\x{0DD4}\x{0DD6}\x{0E31}\x{0E34}-\x{0E3A}\x{0E46}\x{0E47}-\x{0E4E}\x{0EB1}\x{0EB4}-\x{0EB9}\x{0EBB}-\x{0EBC}\x{0EC6}\x{0EC8}-\x{0ECD}\x{0F18}-\x{0F19}\x{0F35}\x{0F37}\x{0F39}\x{0F71}-\x{0F7E}\x{0F80}-\x{0F84}\x{0F86}-\x{0F87}\x{0F8D}-\x{0F97}\x{0F99}-\x{0FBC}\x{0FC6}\x{102D}-\x{1030}\x{1032}-\x{1037}\x{1039}-\x{103A}\x{103D}-\x{103E}\x{1058}-\x{1059}\x{105E}-\x{1060}\x{1071}-\x{1074}\x{1082}\x{1085}-\x{1086}\x{108D}\x{109D}\x{10FC}\x{135D}-\x{135F}\x{1712}-\x{1714}\x{1732}-\x{1734}\x{1752}-\x{1753}\x{1772}-\x{1773}\x{17B4}-\x{17B5}\x{17B7}-\x{17BD}\x{17C6}\x{17C9}-\x{17D3}\x{17D7}\x{17DD}\x{180B}-\x{180D}\x{180E}\x{1843}\x{1885}-\x{1886}\x{18A9}\x{1920}-\x{1922}\x{1927}-\x{1928}\x{1932}\x{1939}-\x{193B}\x{1A17}-\x{1A18}\x{1A1B}\x{1A56}\x{1A58}-\x{1A5E}\x{1A60}\x{1A62}\x{1A65}-\x{1A6C}\x{1A73}-\x{1A7C}\x{1A7F}\x{1AA7}\x{1AB0}-\x{1ABD}\x{1ABE}\x{1B00}-\x{1B03}\x{1B34}\x{1B36}-\x{1B3A}\x{1B3C}\x{1B42}\x{1B6B}-\x{1B73}\x{1B80}-\x{1B81}\x{1BA2}-\x{1BA5}\x{1BA8}-\x{1BA9}\x{1BAB}-\x{1BAD}\x{1BE6}\x{1BE8}-\x{1BE9}\x{1BED}\x{1BEF}-\x{1BF1}\x{1C2C}-\x{1C33}\x{1C36}-\x{1C37}\x{1C78}-\x{1C7D}\x{1CD0}-\x{1CD2}\x{1CD4}-\x{1CE0}\x{1CE2}-\x{1CE8}\x{1CED}\x{1CF4}\x{1CF8}-\x{1CF9}\x{1D2C}-\x{1D6A}\x{1D78}\x{1D9B}-\x{1DBF}\x{1DC0}-\x{1DF9}\x{1DFB}-\x{1DFF}\x{1FBD}\x{1FBF}-\x{1FC1}\x{1FCD}-\x{1FCF}\x{1FDD}-\x{1FDF}\x{1FED}-\x{1FEF}\x{1FFD}-\x{1FFE}\x{200B}-\x{200F}\x{2018}\x{2019}\x{2024}\x{2027}\x{202A}-\x{202E}\x{2060}-\x{2064}\x{2066}-\x{206F}\x{2071}\x{207F}\x{2090}-\x{209C}\x{20D0}-\x{20DC}\x{20DD}-\x{20E0}\x{20E1}\x{20E2}-\x{20E4}\x{20E5}-\x{20F0}\x{2C7C}-\x{2C7D}\x{2CEF}-\x{2CF1}\x{2D6F}\x{2D7F}\x{2DE0}-\x{2DFF}\x{2E2F}\x{3005}\x{302A}-\x{302D}\x{3031}-\x{3035}\x{303B}\x{3099}-\x{309A}\x{309B}-\x{309C}\x{309D}-\x{309E}\x{30FC}-\x{30FE}\x{A015}\x{A4F8}-\x{A4FD}\x{A60C}\x{A66F}\x{A670}-\x{A672}\x{A674}-\x{A67D}\x{A67F}\x{A69C}-\x{A69D}\x{A69E}-\x{A69F}\x{A6F0}-\x{A6F1}\x{A700}-\x{A716}\x{A717}-\x{A71F}\x{A720}-\x{A721}\x{A770}\x{A788}\x{A789}-\x{A78A}\x{A7F8}-\x{A7F9}\x{A802}\x{A806}\x{A80B}\x{A825}-\x{A826}\x{A8C4}-\x{A8C5}\x{A8E0}-\x{A8F1}\x{A8FF}\x{A926}-\x{A92D}\x{A947}-\x{A951}\x{A980}-\x{A982}\x{A9B3}\x{A9B6}-\x{A9B9}\x{A9BC}\x{A9CF}\x{A9E5}\x{A9E6}\x{AA29}-\x{AA2E}\x{AA31}-\x{AA32}\x{AA35}-\x{AA36}\x{AA43}\x{AA4C}\x{AA70}\x{AA7C}\x{AAB0}\x{AAB2}-\x{AAB4}\x{AAB7}-\x{AAB8}\x{AABE}-\x{AABF}\x{AAC1}\x{AADD}\x{AAEC}-\x{AAED}\x{AAF3}-\x{AAF4}\x{AAF6}\x{AB5B}\x{AB5C}-\x{AB5F}\x{ABE5}\x{ABE8}\x{ABED}\x{FB1E}\x{FBB2}-\x{FBC1}\x{FE00}-\x{FE0F}\x{FE13}\x{FE20}-\x{FE2F}\x{FE52}\x{FE55}\x{FEFF}\x{FF07}\x{FF0E}\x{FF1A}\x{FF3E}\x{FF40}\x{FF70}\x{FF9E}-\x{FF9F}\x{FFE3}\x{FFF9}-\x{FFFB}\x{101FD}\x{102E0}\x{10376}-\x{1037A}\x{10A01}-\x{10A03}\x{10A05}-\x{10A06}\x{10A0C}-\x{10A0F}\x{10A38}-\x{10A3A}\x{10A3F}\x{10AE5}-\x{10AE6}\x{10D24}-\x{10D27}\x{10F46}-\x{10F50}\x{11001}\x{11038}-\x{11046}\x{1107F}-\x{11081}\x{110B3}-\x{110B6}\x{110B9}-\x{110BA}\x{110BD}\x{110CD}\x{11100}-\x{11102}\x{11127}-\x{1112B}\x{1112D}-\x{11134}\x{11173}\x{11180}-\x{11181}\x{111B6}-\x{111BE}\x{111C9}-\x{111CC}\x{1122F}-\x{11231}\x{11234}\x{11236}-\x{11237}\x{1123E}\x{112DF}\x{112E3}-\x{112EA}\x{11300}-\x{11301}\x{1133B}-\x{1133C}\x{11340}\x{11366}-\x{1136C}\x{11370}-\x{11374}\x{11438}-\x{1143F}\x{11442}-\x{11444}\x{11446}\x{1145E}\x{114B3}-\x{114B8}\x{114BA}\x{114BF}-\x{114C0}\x{114C2}-\x{114C3}\x{115B2}-\x{115B5}\x{115BC}-\x{115BD}\x{115BF}-\x{115C0}\x{115DC}-\x{115DD}\x{11633}-\x{1163A}\x{1163D}\x{1163F}-\x{11640}\x{116AB}\x{116AD}\x{116B0}-\x{116B5}\x{116B7}\x{1171D}-\x{1171F}\x{11722}-\x{11725}\x{11727}-\x{1172B}\x{1182F}-\x{11837}\x{11839}-\x{1183A}\x{11A01}-\x{11A0A}\x{11A33}-\x{11A38}\x{11A3B}-\x{11A3E}\x{11A47}\x{11A51}-\x{11A56}\x{11A59}-\x{11A5B}\x{11A8A}-\x{11A96}\x{11A98}-\x{11A99}\x{11C30}-\x{11C36}\x{11C38}-\x{11C3D}\x{11C3F}\x{11C92}-\x{11CA7}\x{11CAA}-\x{11CB0}\x{11CB2}-\x{11CB3}\x{11CB5}-\x{11CB6}\x{11D31}-\x{11D36}\x{11D3A}\x{11D3C}-\x{11D3D}\x{11D3F}-\x{11D45}\x{11D47}\x{11D90}-\x{11D91}\x{11D95}\x{11D97}\x{11EF3}-\x{11EF4}\x{16AF0}-\x{16AF4}\x{16B30}-\x{16B36}\x{16B40}-\x{16B43}\x{16F8F}-\x{16F92}\x{16F93}-\x{16F9F}\x{16FE0}-\x{16FE1}\x{1BC9D}-\x{1BC9E}\x{1BCA0}-\x{1BCA3}\x{1D167}-\x{1D169}\x{1D173}-\x{1D17A}\x{1D17B}-\x{1D182}\x{1D185}-\x{1D18B}\x{1D1AA}-\x{1D1AD}\x{1D242}-\x{1D244}\x{1DA00}-\x{1DA36}\x{1DA3B}-\x{1DA6C}\x{1DA75}\x{1DA84}\x{1DA9B}-\x{1DA9F}\x{1DAA1}-\x{1DAAF}\x{1E000}-\x{1E006}\x{1E008}-\x{1E018}\x{1E01B}-\x{1E021}\x{1E023}-\x{1E024}\x{1E026}-\x{1E02A}\x{1E8D0}-\x{1E8D6}\x{1E944}-\x{1E94A}\x{1F3FB}-\x{1F3FF}\x{E0001}\x{E0020}-\x{E007F}\x{E0100}-\x{E01EF}])(\pL)(\pL*+)/u';
<?php
return array (
'A' => 'a',
'B' => 'b',
'C' => 'c',
'D' => 'd',
'E' => 'e',
'F' => 'f',
'G' => 'g',
'H' => 'h',
'I' => 'i',
'J' => 'j',
'K' => 'k',
'L' => 'l',
'M' => 'm',
'N' => 'n',
'O' => 'o',
'P' => 'p',
'Q' => 'q',
'R' => 'r',
'S' => 's',
'T' => 't',
'U' => 'u',
'V' => 'v',
'W' => 'w',
'X' => 'x',
'Y' => 'y',
'Z' => 'z',
'À' => 'à',
'Á' => 'á',
'Â' => 'â',
'Ã' => 'ã',
'Ä' => 'ä',
'Å' => 'å',
'Æ' => 'æ',
'Ç' => 'ç',
'È' => 'è',
'É' => 'é',
'Ê' => 'ê',
'Ë' => 'ë',
'Ì' => 'ì',
'Í' => 'í',
'Î' => 'î',
'Ï' => 'ï',
'Ð' => 'ð',
'Ñ' => 'ñ',
'Ò' => 'ò',
'Ó' => 'ó',
'Ô' => 'ô',
'Õ' => 'õ',
'Ö' => 'ö',
'Ø' => 'ø',
'Ù' => 'ù',
'Ú' => 'ú',
'Û' => 'û',
'Ü' => 'ü',
'Ý' => 'ý',
'Þ' => 'þ',
'Ā' => 'ā',
'Ă' => 'ă',
'Ą' => 'ą',
'Ć' => 'ć',
'Ĉ' => 'ĉ',
'Ċ' => 'ċ',
'Č' => 'č',
'Ď' => 'ď',
'Đ' => 'đ',
'Ē' => 'ē',
'Ĕ' => 'ĕ',
'Ė' => 'ė',
'Ę' => 'ę',
'Ě' => 'ě',
'Ĝ' => 'ĝ',
'Ğ' => 'ğ',
'Ġ' => 'ġ',
'Ģ' => 'ģ',
'Ĥ' => 'ĥ',
'Ħ' => 'ħ',
'Ĩ' => 'ĩ',
'Ī' => 'ī',
'Ĭ' => 'ĭ',
'Į' => 'į',
'İ' => 'i̇',
'IJ' => 'ij',
'Ĵ' => 'ĵ',
'Ķ' => 'ķ',
'Ĺ' => 'ĺ',
'Ļ' => 'ļ',
'Ľ' => 'ľ',
'Ŀ' => 'ŀ',
'Ł' => 'ł',
'Ń' => 'ń',
'Ņ' => 'ņ',
'Ň' => 'ň',
'Ŋ' => 'ŋ',
'Ō' => 'ō',
'Ŏ' => 'ŏ',
'Ő' => 'ő',
'Œ' => 'œ',
'Ŕ' => 'ŕ',
'Ŗ' => 'ŗ',
'Ř' => 'ř',
'Ś' => 'ś',
'Ŝ' => 'ŝ',
'Ş' => 'ş',
'Š' => 'š',
'Ţ' => 'ţ',
'Ť' => 'ť',
'Ŧ' => 'ŧ',
'Ũ' => 'ũ',
'Ū' => 'ū',
'Ŭ' => 'ŭ',
'Ů' => 'ů',
'Ű' => 'ű',
'Ų' => 'ų',
'Ŵ' => 'ŵ',
'Ŷ' => 'ŷ',
'Ÿ' => 'ÿ',
'Ź' => 'ź',
'Ż' => 'ż',
'Ž' => 'ž',
'Ɓ' => 'ɓ',
'Ƃ' => 'ƃ',
'Ƅ' => 'ƅ',
'Ɔ' => 'ɔ',
'Ƈ' => 'ƈ',
'Ɖ' => 'ɖ',
'Ɗ' => 'ɗ',
'Ƌ' => 'ƌ',
'Ǝ' => 'ǝ',
'Ə' => 'ə',
'Ɛ' => 'ɛ',
'Ƒ' => 'ƒ',
'Ɠ' => 'ɠ',
'Ɣ' => 'ɣ',
'Ɩ' => 'ɩ',
'Ɨ' => 'ɨ',
'Ƙ' => 'ƙ',
'Ɯ' => 'ɯ',
'Ɲ' => 'ɲ',
'Ɵ' => 'ɵ',
'Ơ' => 'ơ',
'Ƣ' => 'ƣ',
'Ƥ' => 'ƥ',
'Ʀ' => 'ʀ',
'Ƨ' => 'ƨ',
'Ʃ' => 'ʃ',
'Ƭ' => 'ƭ',
'Ʈ' => 'ʈ',
'Ư' => 'ư',
'Ʊ' => 'ʊ',
'Ʋ' => 'ʋ',
'Ƴ' => 'ƴ',
'Ƶ' => 'ƶ',
'Ʒ' => 'ʒ',
'Ƹ' => 'ƹ',
'Ƽ' => 'ƽ',
'DŽ' => 'dž',
'Dž' => 'dž',
'LJ' => 'lj',
'Lj' => 'lj',
'NJ' => 'nj',
'Nj' => 'nj',
'Ǎ' => 'ǎ',
'Ǐ' => 'ǐ',
'Ǒ' => 'ǒ',
'Ǔ' => 'ǔ',
'Ǖ' => 'ǖ',
'Ǘ' => 'ǘ',
'Ǚ' => 'ǚ',
'Ǜ' => 'ǜ',
'Ǟ' => 'ǟ',
'Ǡ' => 'ǡ',
'Ǣ' => 'ǣ',
'Ǥ' => 'ǥ',
'Ǧ' => 'ǧ',
'Ǩ' => 'ǩ',
'Ǫ' => 'ǫ',
'Ǭ' => 'ǭ',
'Ǯ' => 'ǯ',
'DZ' => 'dz',
'Dz' => 'dz',
'Ǵ' => 'ǵ',
'Ƕ' => 'ƕ',
'Ƿ' => 'ƿ',
'Ǹ' => 'ǹ',
'Ǻ' => 'ǻ',
'Ǽ' => 'ǽ',
'Ǿ' => 'ǿ',
'Ȁ' => 'ȁ',
'Ȃ' => 'ȃ',
'Ȅ' => 'ȅ',
'Ȇ' => 'ȇ',
'Ȉ' => 'ȉ',
'Ȋ' => 'ȋ',
'Ȍ' => 'ȍ',
'Ȏ' => 'ȏ',
'Ȑ' => 'ȑ',
'Ȓ' => 'ȓ',
'Ȕ' => 'ȕ',
'Ȗ' => 'ȗ',
'Ș' => 'ș',
'Ț' => 'ț',
'Ȝ' => 'ȝ',
'Ȟ' => 'ȟ',
'Ƞ' => 'ƞ',
'Ȣ' => 'ȣ',
'Ȥ' => 'ȥ',
'Ȧ' => 'ȧ',
'Ȩ' => 'ȩ',
'Ȫ' => 'ȫ',
'Ȭ' => 'ȭ',
'Ȯ' => 'ȯ',
'Ȱ' => 'ȱ',
'Ȳ' => 'ȳ',
'Ⱥ' => 'ⱥ',
'Ȼ' => 'ȼ',
'Ƚ' => 'ƚ',
'Ⱦ' => 'ⱦ',
'Ɂ' => 'ɂ',
'Ƀ' => 'ƀ',
'Ʉ' => 'ʉ',
'Ʌ' => 'ʌ',
'Ɇ' => 'ɇ',
'Ɉ' => 'ɉ',
'Ɋ' => 'ɋ',
'Ɍ' => 'ɍ',
'Ɏ' => 'ɏ',
'Ͱ' => 'ͱ',
'Ͳ' => 'ͳ',
'Ͷ' => 'ͷ',
'Ϳ' => 'ϳ',
'Ά' => 'ά',
'Έ' => 'έ',
'Ή' => 'ή',
'Ί' => 'ί',
'Ό' => 'ό',
'Ύ' => 'ύ',
'Ώ' => 'ώ',
'Α' => 'α',
'Β' => 'β',
'Γ' => 'γ',
'Δ' => 'δ',
'Ε' => 'ε',
'Ζ' => 'ζ',
'Η' => 'η',
'Θ' => 'θ',
'Ι' => 'ι',
'Κ' => 'κ',
'Λ' => 'λ',
'Μ' => 'μ',
'Ν' => 'ν',
'Ξ' => 'ξ',
'Ο' => 'ο',
'Π' => 'π',
'Ρ' => 'ρ',
'Σ' => 'σ',
'Τ' => 'τ',
'Υ' => 'υ',
'Φ' => 'φ',
'Χ' => 'χ',
'Ψ' => 'ψ',
'Ω' => 'ω',
'Ϊ' => 'ϊ',
'Ϋ' => 'ϋ',
'Ϗ' => 'ϗ',
'Ϙ' => 'ϙ',
'Ϛ' => 'ϛ',
'Ϝ' => 'ϝ',
'Ϟ' => 'ϟ',
'Ϡ' => 'ϡ',
'Ϣ' => 'ϣ',
'Ϥ' => 'ϥ',
'Ϧ' => 'ϧ',
'Ϩ' => 'ϩ',
'Ϫ' => 'ϫ',
'Ϭ' => 'ϭ',
'Ϯ' => 'ϯ',
'ϴ' => 'θ',
'Ϸ' => 'ϸ',
'Ϲ' => 'ϲ',
'Ϻ' => 'ϻ',
'Ͻ' => 'ͻ',
'Ͼ' => 'ͼ',
'Ͽ' => 'ͽ',
'Ѐ' => 'ѐ',
'Ё' => 'ё',
'Ђ' => 'ђ',
'Ѓ' => 'ѓ',
'Є' => 'є',
'Ѕ' => 'ѕ',
'І' => 'і',
'Ї' => 'ї',
'Ј' => 'ј',
'Љ' => 'љ',
'Њ' => 'њ',
'Ћ' => 'ћ',
'Ќ' => 'ќ',
'Ѝ' => 'ѝ',
'Ў' => 'ў',
'Џ' => 'џ',
'А' => 'а',
'Б' => 'б',
'В' => 'в',
'Г' => 'г',
'Д' => 'д',
'Е' => 'е',
'Ж' => 'ж',
'З' => 'з',
'И' => 'и',
'Й' => 'й',
'К' => 'к',
'Л' => 'л',
'М' => 'м',
'Н' => 'н',
'О' => 'о',
'П' => 'п',
'Р' => 'р',
'С' => 'с',
'Т' => 'т',
'У' => 'у',
'Ф' => 'ф',
'Х' => 'х',
'Ц' => 'ц',
'Ч' => 'ч',
'Ш' => 'ш',
'Щ' => 'щ',
'Ъ' => 'ъ',
'Ы' => 'ы',
'Ь' => 'ь',
'Э' => 'э',
'Ю' => 'ю',
'Я' => 'я',
'Ѡ' => 'ѡ',
'Ѣ' => 'ѣ',
'Ѥ' => 'ѥ',
'Ѧ' => 'ѧ',
'Ѩ' => 'ѩ',
'Ѫ' => 'ѫ',
'Ѭ' => 'ѭ',
'Ѯ' => 'ѯ',
'Ѱ' => 'ѱ',
'Ѳ' => 'ѳ',
'Ѵ' => 'ѵ',
'Ѷ' => 'ѷ',
'Ѹ' => 'ѹ',
'Ѻ' => 'ѻ',
'Ѽ' => 'ѽ',
'Ѿ' => 'ѿ',
'Ҁ' => 'ҁ',
'Ҋ' => 'ҋ',
'Ҍ' => 'ҍ',
'Ҏ' => 'ҏ',
'Ґ' => 'ґ',
'Ғ' => 'ғ',
'Ҕ' => 'ҕ',
'Җ' => 'җ',
'Ҙ' => 'ҙ',
'Қ' => 'қ',
'Ҝ' => 'ҝ',
'Ҟ' => 'ҟ',
'Ҡ' => 'ҡ',
'Ң' => 'ң',
'Ҥ' => 'ҥ',
'Ҧ' => 'ҧ',
'Ҩ' => 'ҩ',
'Ҫ' => 'ҫ',
'Ҭ' => 'ҭ',
'Ү' => 'ү',
'Ұ' => 'ұ',
'Ҳ' => 'ҳ',
'Ҵ' => 'ҵ',
'Ҷ' => 'ҷ',
'Ҹ' => 'ҹ',
'Һ' => 'һ',
'Ҽ' => 'ҽ',
'Ҿ' => 'ҿ',
'Ӏ' => 'ӏ',
'Ӂ' => 'ӂ',
'Ӄ' => 'ӄ',
'Ӆ' => 'ӆ',
'Ӈ' => 'ӈ',
'Ӊ' => 'ӊ',
'Ӌ' => 'ӌ',
'Ӎ' => 'ӎ',
'Ӑ' => 'ӑ',
'Ӓ' => 'ӓ',
'Ӕ' => 'ӕ',
'Ӗ' => 'ӗ',
'Ә' => 'ә',
'Ӛ' => 'ӛ',
'Ӝ' => 'ӝ',
'Ӟ' => 'ӟ',
'Ӡ' => 'ӡ',
'Ӣ' => 'ӣ',
'Ӥ' => 'ӥ',
'Ӧ' => 'ӧ',
'Ө' => 'ө',
'Ӫ' => 'ӫ',
'Ӭ' => 'ӭ',
'Ӯ' => 'ӯ',
'Ӱ' => 'ӱ',
'Ӳ' => 'ӳ',
'Ӵ' => 'ӵ',
'Ӷ' => 'ӷ',
'Ӹ' => 'ӹ',
'Ӻ' => 'ӻ',
'Ӽ' => 'ӽ',
'Ӿ' => 'ӿ',
'Ԁ' => 'ԁ',
'Ԃ' => 'ԃ',
'Ԅ' => 'ԅ',
'Ԇ' => 'ԇ',
'Ԉ' => 'ԉ',
'Ԋ' => 'ԋ',
'Ԍ' => 'ԍ',
'Ԏ' => 'ԏ',
'Ԑ' => 'ԑ',
'Ԓ' => 'ԓ',
'Ԕ' => 'ԕ',
'Ԗ' => 'ԗ',
'Ԙ' => 'ԙ',
'Ԛ' => 'ԛ',
'Ԝ' => 'ԝ',
'Ԟ' => 'ԟ',
'Ԡ' => 'ԡ',
'Ԣ' => 'ԣ',
'Ԥ' => 'ԥ',
'Ԧ' => 'ԧ',
'Ԩ' => 'ԩ',
'Ԫ' => 'ԫ',
'Ԭ' => 'ԭ',
'Ԯ' => 'ԯ',
'Ա' => 'ա',
'Բ' => 'բ',
'Գ' => 'գ',
'Դ' => 'դ',
'Ե' => 'ե',
'Զ' => 'զ',
'Է' => 'է',
'Ը' => 'ը',
'Թ' => 'թ',
'Ժ' => 'ժ',
'Ի' => 'ի',
'Լ' => 'լ',
'Խ' => 'խ',
'Ծ' => 'ծ',
'Կ' => 'կ',
'Հ' => 'հ',
'Ձ' => 'ձ',
'Ղ' => 'ղ',
'Ճ' => 'ճ',
'Մ' => 'մ',
'Յ' => 'յ',
'Ն' => 'ն',
'Շ' => 'շ',
'Ո' => 'ո',
'Չ' => 'չ',
'Պ' => 'պ',
'Ջ' => 'ջ',
'Ռ' => 'ռ',
'Ս' => 'ս',
'Վ' => 'վ',
'Տ' => 'տ',
'Ր' => 'ր',
'Ց' => 'ց',
'Ւ' => 'ւ',
'Փ' => 'փ',
'Ք' => 'ք',
'Օ' => 'օ',
'Ֆ' => 'ֆ',
'Ⴀ' => 'ⴀ',
'Ⴁ' => 'ⴁ',
'Ⴂ' => 'ⴂ',
'Ⴃ' => 'ⴃ',
'Ⴄ' => 'ⴄ',
'Ⴅ' => 'ⴅ',
'Ⴆ' => 'ⴆ',
'Ⴇ' => 'ⴇ',
'Ⴈ' => 'ⴈ',
'Ⴉ' => 'ⴉ',
'Ⴊ' => 'ⴊ',
'Ⴋ' => 'ⴋ',
'Ⴌ' => 'ⴌ',
'Ⴍ' => 'ⴍ',
'Ⴎ' => 'ⴎ',
'Ⴏ' => 'ⴏ',
'Ⴐ' => 'ⴐ',
'Ⴑ' => 'ⴑ',
'Ⴒ' => 'ⴒ',
'Ⴓ' => 'ⴓ',
'Ⴔ' => 'ⴔ',
'Ⴕ' => 'ⴕ',
'Ⴖ' => 'ⴖ',
'Ⴗ' => 'ⴗ',
'Ⴘ' => 'ⴘ',
'Ⴙ' => 'ⴙ',
'Ⴚ' => 'ⴚ',
'Ⴛ' => 'ⴛ',
'Ⴜ' => 'ⴜ',
'Ⴝ' => 'ⴝ',
'Ⴞ' => 'ⴞ',
'Ⴟ' => 'ⴟ',
'Ⴠ' => 'ⴠ',
'Ⴡ' => 'ⴡ',
'Ⴢ' => 'ⴢ',
'Ⴣ' => 'ⴣ',
'Ⴤ' => 'ⴤ',
'Ⴥ' => 'ⴥ',
'Ⴧ' => 'ⴧ',
'Ⴭ' => 'ⴭ',
'Ꭰ' => 'ꭰ',
'Ꭱ' => 'ꭱ',
'Ꭲ' => 'ꭲ',
'Ꭳ' => 'ꭳ',
'Ꭴ' => 'ꭴ',
'Ꭵ' => 'ꭵ',
'Ꭶ' => 'ꭶ',
'Ꭷ' => 'ꭷ',
'Ꭸ' => 'ꭸ',
'Ꭹ' => 'ꭹ',
'Ꭺ' => 'ꭺ',
'Ꭻ' => 'ꭻ',
'Ꭼ' => 'ꭼ',
'Ꭽ' => 'ꭽ',
'Ꭾ' => 'ꭾ',
'Ꭿ' => 'ꭿ',
'Ꮀ' => 'ꮀ',
'Ꮁ' => 'ꮁ',
'Ꮂ' => 'ꮂ',
'Ꮃ' => 'ꮃ',
'Ꮄ' => 'ꮄ',
'Ꮅ' => 'ꮅ',
'Ꮆ' => 'ꮆ',
'Ꮇ' => 'ꮇ',
'Ꮈ' => 'ꮈ',
'Ꮉ' => 'ꮉ',
'Ꮊ' => 'ꮊ',
'Ꮋ' => 'ꮋ',
'Ꮌ' => 'ꮌ',
'Ꮍ' => 'ꮍ',
'Ꮎ' => 'ꮎ',
'Ꮏ' => 'ꮏ',
'Ꮐ' => 'ꮐ',
'Ꮑ' => 'ꮑ',
'Ꮒ' => 'ꮒ',
'Ꮓ' => 'ꮓ',
'Ꮔ' => 'ꮔ',
'Ꮕ' => 'ꮕ',
'Ꮖ' => 'ꮖ',
'Ꮗ' => 'ꮗ',
'Ꮘ' => 'ꮘ',
'Ꮙ' => 'ꮙ',
'Ꮚ' => 'ꮚ',
'Ꮛ' => 'ꮛ',
'Ꮜ' => 'ꮜ',
'Ꮝ' => 'ꮝ',
'Ꮞ' => 'ꮞ',
'Ꮟ' => 'ꮟ',
'Ꮠ' => 'ꮠ',
'Ꮡ' => 'ꮡ',
'Ꮢ' => 'ꮢ',
'Ꮣ' => 'ꮣ',
'Ꮤ' => 'ꮤ',
'Ꮥ' => 'ꮥ',
'Ꮦ' => 'ꮦ',
'Ꮧ' => 'ꮧ',
'Ꮨ' => 'ꮨ',
'Ꮩ' => 'ꮩ',
'Ꮪ' => 'ꮪ',
'Ꮫ' => 'ꮫ',
'Ꮬ' => 'ꮬ',
'Ꮭ' => 'ꮭ',
'Ꮮ' => 'ꮮ',
'Ꮯ' => 'ꮯ',
'Ꮰ' => 'ꮰ',
'Ꮱ' => 'ꮱ',
'Ꮲ' => 'ꮲ',
'Ꮳ' => 'ꮳ',
'Ꮴ' => 'ꮴ',
'Ꮵ' => 'ꮵ',
'Ꮶ' => 'ꮶ',
'Ꮷ' => 'ꮷ',
'Ꮸ' => 'ꮸ',
'Ꮹ' => 'ꮹ',
'Ꮺ' => 'ꮺ',
'Ꮻ' => 'ꮻ',
'Ꮼ' => 'ꮼ',
'Ꮽ' => 'ꮽ',
'Ꮾ' => 'ꮾ',
'Ꮿ' => 'ꮿ',
'Ᏸ' => 'ᏸ',
'Ᏹ' => 'ᏹ',
'Ᏺ' => 'ᏺ',
'Ᏻ' => 'ᏻ',
'Ᏼ' => 'ᏼ',
'Ᏽ' => 'ᏽ',
'Ა' => 'ა',
'Ბ' => 'ბ',
'Გ' => 'გ',
'Დ' => 'დ',
'Ე' => 'ე',
'Ვ' => 'ვ',
'Ზ' => 'ზ',
'Თ' => 'თ',
'Ი' => 'ი',
'Კ' => 'კ',
'Ლ' => 'ლ',
'Მ' => 'მ',
'Ნ' => 'ნ',
'Ო' => 'ო',
'Პ' => 'პ',
'Ჟ' => 'ჟ',
'Რ' => 'რ',
'Ს' => 'ს',
'Ტ' => 'ტ',
'Უ' => 'უ',
'Ფ' => 'ფ',
'Ქ' => 'ქ',
'Ღ' => 'ღ',
'Ყ' => 'ყ',
'Შ' => 'შ',
'Ჩ' => 'ჩ',
'Ც' => 'ც',
'Ძ' => 'ძ',
'Წ' => 'წ',
'Ჭ' => 'ჭ',
'Ხ' => 'ხ',
'Ჯ' => 'ჯ',
'Ჰ' => 'ჰ',
'Ჱ' => 'ჱ',
'Ჲ' => 'ჲ',
'Ჳ' => 'ჳ',
'Ჴ' => 'ჴ',
'Ჵ' => 'ჵ',
'Ჶ' => 'ჶ',
'Ჷ' => 'ჷ',
'Ჸ' => 'ჸ',
'Ჹ' => 'ჹ',
'Ჺ' => 'ჺ',
'Ჽ' => 'ჽ',
'Ჾ' => 'ჾ',
'Ჿ' => 'ჿ',
'Ḁ' => 'ḁ',
'Ḃ' => 'ḃ',
'Ḅ' => 'ḅ',
'Ḇ' => 'ḇ',
'Ḉ' => 'ḉ',
'Ḋ' => 'ḋ',
'Ḍ' => 'ḍ',
'Ḏ' => 'ḏ',
'Ḑ' => 'ḑ',
'Ḓ' => 'ḓ',
'Ḕ' => 'ḕ',
'Ḗ' => 'ḗ',
'Ḙ' => 'ḙ',
'Ḛ' => 'ḛ',
'Ḝ' => 'ḝ',
'Ḟ' => 'ḟ',
'Ḡ' => 'ḡ',
'Ḣ' => 'ḣ',
'Ḥ' => 'ḥ',
'Ḧ' => 'ḧ',
'Ḩ' => 'ḩ',
'Ḫ' => 'ḫ',
'Ḭ' => 'ḭ',
'Ḯ' => 'ḯ',
'Ḱ' => 'ḱ',
'Ḳ' => 'ḳ',
'Ḵ' => 'ḵ',
'Ḷ' => 'ḷ',
'Ḹ' => 'ḹ',
'Ḻ' => 'ḻ',
'Ḽ' => 'ḽ',
'Ḿ' => 'ḿ',
'Ṁ' => 'ṁ',
'Ṃ' => 'ṃ',
'Ṅ' => 'ṅ',
'Ṇ' => 'ṇ',
'Ṉ' => 'ṉ',
'Ṋ' => 'ṋ',
'Ṍ' => 'ṍ',
'Ṏ' => 'ṏ',
'Ṑ' => 'ṑ',
'Ṓ' => 'ṓ',
'Ṕ' => 'ṕ',
'Ṗ' => 'ṗ',
'Ṙ' => 'ṙ',
'Ṛ' => 'ṛ',
'Ṝ' => 'ṝ',
'Ṟ' => 'ṟ',
'Ṡ' => 'ṡ',
'Ṣ' => 'ṣ',
'Ṥ' => 'ṥ',
'Ṧ' => 'ṧ',
'Ṩ' => 'ṩ',
'Ṫ' => 'ṫ',
'Ṭ' => 'ṭ',
'Ṯ' => 'ṯ',
'Ṱ' => 'ṱ',
'Ṳ' => 'ṳ',
'Ṵ' => 'ṵ',
'Ṷ' => 'ṷ',
'Ṹ' => 'ṹ',
'Ṻ' => 'ṻ',
'Ṽ' => 'ṽ',
'Ṿ' => 'ṿ',
'Ẁ' => 'ẁ',
'Ẃ' => 'ẃ',
'Ẅ' => 'ẅ',
'Ẇ' => 'ẇ',
'Ẉ' => 'ẉ',
'Ẋ' => 'ẋ',
'Ẍ' => 'ẍ',
'Ẏ' => 'ẏ',
'Ẑ' => 'ẑ',
'Ẓ' => 'ẓ',
'Ẕ' => 'ẕ',
'ẞ' => 'ß',
'Ạ' => 'ạ',
'Ả' => 'ả',
'Ấ' => 'ấ',
'Ầ' => 'ầ',
'Ẩ' => 'ẩ',
'Ẫ' => 'ẫ',
'Ậ' => 'ậ',
'Ắ' => 'ắ',
'Ằ' => 'ằ',
'Ẳ' => 'ẳ',
'Ẵ' => 'ẵ',
'Ặ' => 'ặ',
'Ẹ' => 'ẹ',
'Ẻ' => 'ẻ',
'Ẽ' => 'ẽ',
'Ế' => 'ế',
'Ề' => 'ề',
'Ể' => 'ể',
'Ễ' => 'ễ',
'Ệ' => 'ệ',
'Ỉ' => 'ỉ',
'Ị' => 'ị',
'Ọ' => 'ọ',
'Ỏ' => 'ỏ',
'Ố' => 'ố',
'Ồ' => 'ồ',
'Ổ' => 'ổ',
'Ỗ' => 'ỗ',
'Ộ' => 'ộ',
'Ớ' => 'ớ',
'Ờ' => 'ờ',
'Ở' => 'ở',
'Ỡ' => 'ỡ',
'Ợ' => 'ợ',
'Ụ' => 'ụ',
'Ủ' => 'ủ',
'Ứ' => 'ứ',
'Ừ' => 'ừ',
'Ử' => 'ử',
'Ữ' => 'ữ',
'Ự' => 'ự',
'Ỳ' => 'ỳ',
'Ỵ' => 'ỵ',
'Ỷ' => 'ỷ',
'Ỹ' => 'ỹ',
'Ỻ' => 'ỻ',
'Ỽ' => 'ỽ',
'Ỿ' => 'ỿ',
'Ἀ' => 'ἀ',
'Ἁ' => 'ἁ',
'Ἂ' => 'ἂ',
'Ἃ' => 'ἃ',
'Ἄ' => 'ἄ',
'Ἅ' => 'ἅ',
'Ἆ' => 'ἆ',
'Ἇ' => 'ἇ',
'Ἐ' => 'ἐ',
'Ἑ' => 'ἑ',
'Ἒ' => 'ἒ',
'Ἓ' => 'ἓ',
'Ἔ' => 'ἔ',
'Ἕ' => 'ἕ',
'Ἠ' => 'ἠ',
'Ἡ' => 'ἡ',
'Ἢ' => 'ἢ',
'Ἣ' => 'ἣ',
'Ἤ' => 'ἤ',
'Ἥ' => 'ἥ',
'Ἦ' => 'ἦ',
'Ἧ' => 'ἧ',
'Ἰ' => 'ἰ',
'Ἱ' => 'ἱ',
'Ἲ' => 'ἲ',
'Ἳ' => 'ἳ',
'Ἴ' => 'ἴ',
'Ἵ' => 'ἵ',
'Ἶ' => 'ἶ',
'Ἷ' => 'ἷ',
'Ὀ' => 'ὀ',
'Ὁ' => 'ὁ',
'Ὂ' => 'ὂ',
'Ὃ' => 'ὃ',
'Ὄ' => 'ὄ',
'Ὅ' => 'ὅ',
'Ὑ' => 'ὑ',
'Ὓ' => 'ὓ',
'Ὕ' => 'ὕ',
'Ὗ' => 'ὗ',
'Ὠ' => 'ὠ',
'Ὡ' => 'ὡ',
'Ὢ' => 'ὢ',
'Ὣ' => 'ὣ',
'Ὤ' => 'ὤ',
'Ὥ' => 'ὥ',
'Ὦ' => 'ὦ',
'Ὧ' => 'ὧ',
'ᾈ' => 'ᾀ',
'ᾉ' => 'ᾁ',
'ᾊ' => 'ᾂ',
'ᾋ' => 'ᾃ',
'ᾌ' => 'ᾄ',
'ᾍ' => 'ᾅ',
'ᾎ' => 'ᾆ',
'ᾏ' => 'ᾇ',
'ᾘ' => 'ᾐ',
'ᾙ' => 'ᾑ',
'ᾚ' => 'ᾒ',
'ᾛ' => 'ᾓ',
'ᾜ' => 'ᾔ',
'ᾝ' => 'ᾕ',
'ᾞ' => 'ᾖ',
'ᾟ' => 'ᾗ',
'ᾨ' => 'ᾠ',
'ᾩ' => 'ᾡ',
'ᾪ' => 'ᾢ',
'ᾫ' => 'ᾣ',
'ᾬ' => 'ᾤ',
'ᾭ' => 'ᾥ',
'ᾮ' => 'ᾦ',
'ᾯ' => 'ᾧ',
'Ᾰ' => 'ᾰ',
'Ᾱ' => 'ᾱ',
'Ὰ' => 'ὰ',
'Ά' => 'ά',
'ᾼ' => 'ᾳ',
'Ὲ' => 'ὲ',
'Έ' => 'έ',
'Ὴ' => 'ὴ',
'Ή' => 'ή',
'ῌ' => 'ῃ',
'Ῐ' => 'ῐ',
'Ῑ' => 'ῑ',
'Ὶ' => 'ὶ',
'Ί' => 'ί',
'Ῠ' => 'ῠ',
'Ῡ' => 'ῡ',
'Ὺ' => 'ὺ',
'Ύ' => 'ύ',
'Ῥ' => 'ῥ',
'Ὸ' => 'ὸ',
'Ό' => 'ό',
'Ὼ' => 'ὼ',
'Ώ' => 'ώ',
'ῼ' => 'ῳ',
'Ω' => 'ω',
'K' => 'k',
'Å' => 'å',
'Ⅎ' => 'ⅎ',
'Ⅰ' => 'ⅰ',
'Ⅱ' => 'ⅱ',
'Ⅲ' => 'ⅲ',
'Ⅳ' => 'ⅳ',
'Ⅴ' => 'ⅴ',
'Ⅵ' => 'ⅵ',
'Ⅶ' => 'ⅶ',
'Ⅷ' => 'ⅷ',
'Ⅸ' => 'ⅸ',
'Ⅹ' => 'ⅹ',
'Ⅺ' => 'ⅺ',
'Ⅻ' => 'ⅻ',
'Ⅼ' => 'ⅼ',
'Ⅽ' => 'ⅽ',
'Ⅾ' => 'ⅾ',
'Ⅿ' => 'ⅿ',
'Ↄ' => 'ↄ',
'Ⓐ' => 'ⓐ',
'Ⓑ' => 'ⓑ',
'Ⓒ' => 'ⓒ',
'Ⓓ' => 'ⓓ',
'Ⓔ' => 'ⓔ',
'Ⓕ' => 'ⓕ',
'Ⓖ' => 'ⓖ',
'Ⓗ' => 'ⓗ',
'Ⓘ' => 'ⓘ',
'Ⓙ' => 'ⓙ',
'Ⓚ' => 'ⓚ',
'Ⓛ' => 'ⓛ',
'Ⓜ' => 'ⓜ',
'Ⓝ' => 'ⓝ',
'Ⓞ' => 'ⓞ',
'Ⓟ' => 'ⓟ',
'Ⓠ' => 'ⓠ',
'Ⓡ' => 'ⓡ',
'Ⓢ' => 'ⓢ',
'Ⓣ' => 'ⓣ',
'Ⓤ' => 'ⓤ',
'Ⓥ' => 'ⓥ',
'Ⓦ' => 'ⓦ',
'Ⓧ' => 'ⓧ',
'Ⓨ' => 'ⓨ',
'Ⓩ' => 'ⓩ',
'Ⰰ' => 'ⰰ',
'Ⰱ' => 'ⰱ',
'Ⰲ' => 'ⰲ',
'Ⰳ' => 'ⰳ',
'Ⰴ' => 'ⰴ',
'Ⰵ' => 'ⰵ',
'Ⰶ' => 'ⰶ',
'Ⰷ' => 'ⰷ',
'Ⰸ' => 'ⰸ',
'Ⰹ' => 'ⰹ',
'Ⰺ' => 'ⰺ',
'Ⰻ' => 'ⰻ',
'Ⰼ' => 'ⰼ',
'Ⰽ' => 'ⰽ',
'Ⰾ' => 'ⰾ',
'Ⰿ' => 'ⰿ',
'Ⱀ' => 'ⱀ',
'Ⱁ' => 'ⱁ',
'Ⱂ' => 'ⱂ',
'Ⱃ' => 'ⱃ',
'Ⱄ' => 'ⱄ',
'Ⱅ' => 'ⱅ',
'Ⱆ' => 'ⱆ',
'Ⱇ' => 'ⱇ',
'Ⱈ' => 'ⱈ',
'Ⱉ' => 'ⱉ',
'Ⱊ' => 'ⱊ',
'Ⱋ' => 'ⱋ',
'Ⱌ' => 'ⱌ',
'Ⱍ' => 'ⱍ',
'Ⱎ' => 'ⱎ',
'Ⱏ' => 'ⱏ',
'Ⱐ' => 'ⱐ',
'Ⱑ' => 'ⱑ',
'Ⱒ' => 'ⱒ',
'Ⱓ' => 'ⱓ',
'Ⱔ' => 'ⱔ',
'Ⱕ' => 'ⱕ',
'Ⱖ' => 'ⱖ',
'Ⱗ' => 'ⱗ',
'Ⱘ' => 'ⱘ',
'Ⱙ' => 'ⱙ',
'Ⱚ' => 'ⱚ',
'Ⱛ' => 'ⱛ',
'Ⱜ' => 'ⱜ',
'Ⱝ' => 'ⱝ',
'Ⱞ' => 'ⱞ',
'Ⱡ' => 'ⱡ',
'Ɫ' => 'ɫ',
'Ᵽ' => 'ᵽ',
'Ɽ' => 'ɽ',
'Ⱨ' => 'ⱨ',
'Ⱪ' => 'ⱪ',
'Ⱬ' => 'ⱬ',
'Ɑ' => 'ɑ',
'Ɱ' => 'ɱ',
'Ɐ' => 'ɐ',
'Ɒ' => 'ɒ',
'Ⱳ' => 'ⱳ',
'Ⱶ' => 'ⱶ',
'Ȿ' => 'ȿ',
'Ɀ' => 'ɀ',
'Ⲁ' => 'ⲁ',
'Ⲃ' => 'ⲃ',
'Ⲅ' => 'ⲅ',
'Ⲇ' => 'ⲇ',
'Ⲉ' => 'ⲉ',
'Ⲋ' => 'ⲋ',
'Ⲍ' => 'ⲍ',
'Ⲏ' => 'ⲏ',
'Ⲑ' => 'ⲑ',
'Ⲓ' => 'ⲓ',
'Ⲕ' => 'ⲕ',
'Ⲗ' => 'ⲗ',
'Ⲙ' => 'ⲙ',
'Ⲛ' => 'ⲛ',
'Ⲝ' => 'ⲝ',
'Ⲟ' => 'ⲟ',
'Ⲡ' => 'ⲡ',
'Ⲣ' => 'ⲣ',
'Ⲥ' => 'ⲥ',
'Ⲧ' => 'ⲧ',
'Ⲩ' => 'ⲩ',
'Ⲫ' => 'ⲫ',
'Ⲭ' => 'ⲭ',
'Ⲯ' => 'ⲯ',
'Ⲱ' => 'ⲱ',
'Ⲳ' => 'ⲳ',
'Ⲵ' => 'ⲵ',
'Ⲷ' => 'ⲷ',
'Ⲹ' => 'ⲹ',
'Ⲻ' => 'ⲻ',
'Ⲽ' => 'ⲽ',
'Ⲿ' => 'ⲿ',
'Ⳁ' => 'ⳁ',
'Ⳃ' => 'ⳃ',
'Ⳅ' => 'ⳅ',
'Ⳇ' => 'ⳇ',
'Ⳉ' => 'ⳉ',
'Ⳋ' => 'ⳋ',
'Ⳍ' => 'ⳍ',
'Ⳏ' => 'ⳏ',
'Ⳑ' => 'ⳑ',
'Ⳓ' => 'ⳓ',
'Ⳕ' => 'ⳕ',
'Ⳗ' => 'ⳗ',
'Ⳙ' => 'ⳙ',
'Ⳛ' => 'ⳛ',
'Ⳝ' => 'ⳝ',
'Ⳟ' => 'ⳟ',
'Ⳡ' => 'ⳡ',
'Ⳣ' => 'ⳣ',
'Ⳬ' => 'ⳬ',
'Ⳮ' => 'ⳮ',
'Ⳳ' => 'ⳳ',
'Ꙁ' => 'ꙁ',
'Ꙃ' => 'ꙃ',
'Ꙅ' => 'ꙅ',
'Ꙇ' => 'ꙇ',
'Ꙉ' => 'ꙉ',
'Ꙋ' => 'ꙋ',
'Ꙍ' => 'ꙍ',
'Ꙏ' => 'ꙏ',
'Ꙑ' => 'ꙑ',
'Ꙓ' => 'ꙓ',
'Ꙕ' => 'ꙕ',
'Ꙗ' => 'ꙗ',
'Ꙙ' => 'ꙙ',
'Ꙛ' => 'ꙛ',
'Ꙝ' => 'ꙝ',
'Ꙟ' => 'ꙟ',
'Ꙡ' => 'ꙡ',
'Ꙣ' => 'ꙣ',
'Ꙥ' => 'ꙥ',
'Ꙧ' => 'ꙧ',
'Ꙩ' => 'ꙩ',
'Ꙫ' => 'ꙫ',
'Ꙭ' => 'ꙭ',
'Ꚁ' => 'ꚁ',
'Ꚃ' => 'ꚃ',
'Ꚅ' => 'ꚅ',
'Ꚇ' => 'ꚇ',
'Ꚉ' => 'ꚉ',
'Ꚋ' => 'ꚋ',
'Ꚍ' => 'ꚍ',
'Ꚏ' => 'ꚏ',
'Ꚑ' => 'ꚑ',
'Ꚓ' => 'ꚓ',
'Ꚕ' => 'ꚕ',
'Ꚗ' => 'ꚗ',
'Ꚙ' => 'ꚙ',
'Ꚛ' => 'ꚛ',
'Ꜣ' => 'ꜣ',
'Ꜥ' => 'ꜥ',
'Ꜧ' => 'ꜧ',
'Ꜩ' => 'ꜩ',
'Ꜫ' => 'ꜫ',
'Ꜭ' => 'ꜭ',
'Ꜯ' => 'ꜯ',
'Ꜳ' => 'ꜳ',
'Ꜵ' => 'ꜵ',
'Ꜷ' => 'ꜷ',
'Ꜹ' => 'ꜹ',
'Ꜻ' => 'ꜻ',
'Ꜽ' => 'ꜽ',
'Ꜿ' => 'ꜿ',
'Ꝁ' => 'ꝁ',
'Ꝃ' => 'ꝃ',
'Ꝅ' => 'ꝅ',
'Ꝇ' => 'ꝇ',
'Ꝉ' => 'ꝉ',
'Ꝋ' => 'ꝋ',
'Ꝍ' => 'ꝍ',
'Ꝏ' => 'ꝏ',
'Ꝑ' => 'ꝑ',
'Ꝓ' => 'ꝓ',
'Ꝕ' => 'ꝕ',
'Ꝗ' => 'ꝗ',
'Ꝙ' => 'ꝙ',
'Ꝛ' => 'ꝛ',
'Ꝝ' => 'ꝝ',
'Ꝟ' => 'ꝟ',
'Ꝡ' => 'ꝡ',
'Ꝣ' => 'ꝣ',
'Ꝥ' => 'ꝥ',
'Ꝧ' => 'ꝧ',
'Ꝩ' => 'ꝩ',
'Ꝫ' => 'ꝫ',
'Ꝭ' => 'ꝭ',
'Ꝯ' => 'ꝯ',
'Ꝺ' => 'ꝺ',
'Ꝼ' => 'ꝼ',
'Ᵹ' => 'ᵹ',
'Ꝿ' => 'ꝿ',
'Ꞁ' => 'ꞁ',
'Ꞃ' => 'ꞃ',
'Ꞅ' => 'ꞅ',
'Ꞇ' => 'ꞇ',
'Ꞌ' => 'ꞌ',
'Ɥ' => 'ɥ',
'Ꞑ' => 'ꞑ',
'Ꞓ' => 'ꞓ',
'Ꞗ' => 'ꞗ',
'Ꞙ' => 'ꞙ',
'Ꞛ' => 'ꞛ',
'Ꞝ' => 'ꞝ',
'Ꞟ' => 'ꞟ',
'Ꞡ' => 'ꞡ',
'Ꞣ' => 'ꞣ',
'Ꞥ' => 'ꞥ',
'Ꞧ' => 'ꞧ',
'Ꞩ' => 'ꞩ',
'Ɦ' => 'ɦ',
'Ɜ' => 'ɜ',
'Ɡ' => 'ɡ',
'Ɬ' => 'ɬ',
'Ɪ' => 'ɪ',
'Ʞ' => 'ʞ',
'Ʇ' => 'ʇ',
'Ʝ' => 'ʝ',
'Ꭓ' => 'ꭓ',
'Ꞵ' => 'ꞵ',
'Ꞷ' => 'ꞷ',
'Ꞹ' => 'ꞹ',
'Ꞻ' => 'ꞻ',
'Ꞽ' => 'ꞽ',
'Ꞿ' => 'ꞿ',
'Ꟃ' => 'ꟃ',
'Ꞔ' => 'ꞔ',
'Ʂ' => 'ʂ',
'Ᶎ' => 'ᶎ',
'Ꟈ' => 'ꟈ',
'Ꟊ' => 'ꟊ',
'Ꟶ' => 'ꟶ',
'Ａ' => 'ａ',
'Ｂ' => 'ｂ',
'Ｃ' => 'ｃ',
'Ｄ' => 'ｄ',
'Ｅ' => 'ｅ',
'Ｆ' => 'ｆ',
'Ｇ' => 'ｇ',
'Ｈ' => 'ｈ',
'Ｉ' => 'ｉ',
'Ｊ' => 'ｊ',
'Ｋ' => 'ｋ',
'Ｌ' => 'ｌ',
'Ｍ' => 'ｍ',
'Ｎ' => 'ｎ',
'Ｏ' => 'ｏ',
'Ｐ' => 'ｐ',
'Ｑ' => 'ｑ',
'Ｒ' => 'ｒ',
'Ｓ' => 'ｓ',
'Ｔ' => 'ｔ',
'Ｕ' => 'ｕ',
'Ｖ' => 'ｖ',
'Ｗ' => 'ｗ',
'Ｘ' => 'ｘ',
'Ｙ' => 'ｙ',
'Ｚ' => 'ｚ',
'𐐀' => '𐐨',
'𐐁' => '𐐩',
'𐐂' => '𐐪',
'𐐃' => '𐐫',
'𐐄' => '𐐬',
'𐐅' => '𐐭',
'𐐆' => '𐐮',
'𐐇' => '𐐯',
'𐐈' => '𐐰',
'𐐉' => '𐐱',
'𐐊' => '𐐲',
'𐐋' => '𐐳',
'𐐌' => '𐐴',
'𐐍' => '𐐵',
'𐐎' => '𐐶',
'𐐏' => '𐐷',
'𐐐' => '𐐸',
'𐐑' => '𐐹',
'𐐒' => '𐐺',
'𐐓' => '𐐻',
'𐐔' => '𐐼',
'𐐕' => '𐐽',
'𐐖' => '𐐾',
'𐐗' => '𐐿',
'𐐘' => '𐑀',
'𐐙' => '𐑁',
'𐐚' => '𐑂',
'𐐛' => '𐑃',
'𐐜' => '𐑄',
'𐐝' => '𐑅',
'𐐞' => '𐑆',
'𐐟' => '𐑇',
'𐐠' => '𐑈',
'𐐡' => '𐑉',
'𐐢' => '𐑊',
'𐐣' => '𐑋',
'𐐤' => '𐑌',
'𐐥' => '𐑍',
'𐐦' => '𐑎',
'𐐧' => '𐑏',
'𐒰' => '𐓘',
'𐒱' => '𐓙',
'𐒲' => '𐓚',
'𐒳' => '𐓛',
'𐒴' => '𐓜',
'𐒵' => '𐓝',
'𐒶' => '𐓞',
'𐒷' => '𐓟',
'𐒸' => '𐓠',
'𐒹' => '𐓡',
'𐒺' => '𐓢',
'𐒻' => '𐓣',
'𐒼' => '𐓤',
'𐒽' => '𐓥',
'𐒾' => '𐓦',
'𐒿' => '𐓧',
'𐓀' => '𐓨',
'𐓁' => '𐓩',
'𐓂' => '𐓪',
'𐓃' => '𐓫',
'𐓄' => '𐓬',
'𐓅' => '𐓭',
'𐓆' => '𐓮',
'𐓇' => '𐓯',
'𐓈' => '𐓰',
'𐓉' => '𐓱',
'𐓊' => '𐓲',
'𐓋' => '𐓳',
'𐓌' => '𐓴',
'𐓍' => '𐓵',
'𐓎' => '𐓶',
'𐓏' => '𐓷',
'𐓐' => '𐓸',
'𐓑' => '𐓹',
'𐓒' => '𐓺',
'𐓓' => '𐓻',
'𐲀' => '𐳀',
'𐲁' => '𐳁',
'𐲂' => '𐳂',
'𐲃' => '𐳃',
'𐲄' => '𐳄',
'𐲅' => '𐳅',
'𐲆' => '𐳆',
'𐲇' => '𐳇',
'𐲈' => '𐳈',
'𐲉' => '𐳉',
'𐲊' => '𐳊',
'𐲋' => '𐳋',
'𐲌' => '𐳌',
'𐲍' => '𐳍',
'𐲎' => '𐳎',
'𐲏' => '𐳏',
'𐲐' => '𐳐',
'𐲑' => '𐳑',
'𐲒' => '𐳒',
'𐲓' => '𐳓',
'𐲔' => '𐳔',
'𐲕' => '𐳕',
'𐲖' => '𐳖',
'𐲗' => '𐳗',
'𐲘' => '𐳘',
'𐲙' => '𐳙',
'𐲚' => '𐳚',
'𐲛' => '𐳛',
'𐲜' => '𐳜',
'𐲝' => '𐳝',
'𐲞' => '𐳞',
'𐲟' => '𐳟',
'𐲠' => '𐳠',
'𐲡' => '𐳡',
'𐲢' => '𐳢',
'𐲣' => '𐳣',
'𐲤' => '𐳤',
'𐲥' => '𐳥',
'𐲦' => '𐳦',
'𐲧' => '𐳧',
'𐲨' => '𐳨',
'𐲩' => '𐳩',
'𐲪' => '𐳪',
'𐲫' => '𐳫',
'𐲬' => '𐳬',
'𐲭' => '𐳭',
'𐲮' => '𐳮',
'𐲯' => '𐳯',
'𐲰' => '𐳰',
'𐲱' => '𐳱',
'𐲲' => '𐳲',
'𑢠' => '𑣀',
'𑢡' => '𑣁',
'𑢢' => '𑣂',
'𑢣' => '𑣃',
'𑢤' => '𑣄',
'𑢥' => '𑣅',
'𑢦' => '𑣆',
'𑢧' => '𑣇',
'𑢨' => '𑣈',
'𑢩' => '𑣉',
'𑢪' => '𑣊',
'𑢫' => '𑣋',
'𑢬' => '𑣌',
'𑢭' => '𑣍',
'𑢮' => '𑣎',
'𑢯' => '𑣏',
'𑢰' => '𑣐',
'𑢱' => '𑣑',
'𑢲' => '𑣒',
'𑢳' => '𑣓',
'𑢴' => '𑣔',
'𑢵' => '𑣕',
'𑢶' => '𑣖',
'𑢷' => '𑣗',
'𑢸' => '𑣘',
'𑢹' => '𑣙',
'𑢺' => '𑣚',
'𑢻' => '𑣛',
'𑢼' => '𑣜',
'𑢽' => '𑣝',
'𑢾' => '𑣞',
'𑢿' => '𑣟',
'𖹀' => '𖹠',
'𖹁' => '𖹡',
'𖹂' => '𖹢',
'𖹃' => '𖹣',
'𖹄' => '𖹤',
'𖹅' => '𖹥',
'𖹆' => '𖹦',
'𖹇' => '𖹧',
'𖹈' => '𖹨',
'𖹉' => '𖹩',
'𖹊' => '𖹪',
'𖹋' => '𖹫',
'𖹌' => '𖹬',
'𖹍' => '𖹭',
'𖹎' => '𖹮',
'𖹏' => '𖹯',
'𖹐' => '𖹰',
'𖹑' => '𖹱',
'𖹒' => '𖹲',
'𖹓' => '𖹳',
'𖹔' => '𖹴',
'𖹕' => '𖹵',
'𖹖' => '𖹶',
'𖹗' => '𖹷',
'𖹘' => '𖹸',
'𖹙' => '𖹹',
'𖹚' => '𖹺',
'𖹛' => '𖹻',
'𖹜' => '𖹼',
'𖹝' => '𖹽',
'𖹞' => '𖹾',
'𖹟' => '𖹿',
'𞤀' => '𞤢',
'𞤁' => '𞤣',
'𞤂' => '𞤤',
'𞤃' => '𞤥',
'𞤄' => '𞤦',
'𞤅' => '𞤧',
'𞤆' => '𞤨',
'𞤇' => '𞤩',
'𞤈' => '𞤪',
'𞤉' => '𞤫',
'𞤊' => '𞤬',
'𞤋' => '𞤭',
'𞤌' => '𞤮',
'𞤍' => '𞤯',
'𞤎' => '𞤰',
'𞤏' => '𞤱',
'𞤐' => '𞤲',
'𞤑' => '𞤳',
'𞤒' => '𞤴',
'𞤓' => '𞤵',
'𞤔' => '𞤶',
'𞤕' => '𞤷',
'𞤖' => '𞤸',
'𞤗' => '𞤹',
'𞤘' => '𞤺',
'𞤙' => '𞤻',
'𞤚' => '𞤼',
'𞤛' => '𞤽',
'𞤜' => '𞤾',
'𞤝' => '𞤿',
'𞤞' => '𞥀',
'𞤟' => '𞥁',
'𞤠' => '𞥂',
'𞤡' => '𞥃',
);
<?php
return array (
'a' => 'A',
'b' => 'B',
'c' => 'C',
'd' => 'D',
'e' => 'E',
'f' => 'F',
'g' => 'G',
'h' => 'H',
'i' => 'I',
'j' => 'J',
'k' => 'K',
'l' => 'L',
'm' => 'M',
'n' => 'N',
'o' => 'O',
'p' => 'P',
'q' => 'Q',
'r' => 'R',
's' => 'S',
't' => 'T',
'u' => 'U',
'v' => 'V',
'w' => 'W',
'x' => 'X',
'y' => 'Y',
'z' => 'Z',
'µ' => 'Μ',
'à' => 'À',
'á' => 'Á',
'â' => 'Â',
'ã' => 'Ã',
'ä' => 'Ä',
'å' => 'Å',
'æ' => 'Æ',
'ç' => 'Ç',
'è' => 'È',
'é' => 'É',
'ê' => 'Ê',
'ë' => 'Ë',
'ì' => 'Ì',
'í' => 'Í',
'î' => 'Î',
'ï' => 'Ï',
'ð' => 'Ð',
'ñ' => 'Ñ',
'ò' => 'Ò',
'ó' => 'Ó',
'ô' => 'Ô',
'õ' => 'Õ',
'ö' => 'Ö',
'ø' => 'Ø',
'ù' => 'Ù',
'ú' => 'Ú',
'û' => 'Û',
'ü' => 'Ü',
'ý' => 'Ý',
'þ' => 'Þ',
'ÿ' => 'Ÿ',
'ā' => 'Ā',
'ă' => 'Ă',
'ą' => 'Ą',
'ć' => 'Ć',
'ĉ' => 'Ĉ',
'ċ' => 'Ċ',
'č' => 'Č',
'ď' => 'Ď',
'đ' => 'Đ',
'ē' => 'Ē',
'ĕ' => 'Ĕ',
'ė' => 'Ė',
'ę' => 'Ę',
'ě' => 'Ě',
'ĝ' => 'Ĝ',
'ğ' => 'Ğ',
'ġ' => 'Ġ',
'ģ' => 'Ģ',
'ĥ' => 'Ĥ',
'ħ' => 'Ħ',
'ĩ' => 'Ĩ',
'ī' => 'Ī',
'ĭ' => 'Ĭ',
'į' => 'Į',
'ı' => 'I',
'ij' => 'IJ',
'ĵ' => 'Ĵ',
'ķ' => 'Ķ',
'ĺ' => 'Ĺ',
'ļ' => 'Ļ',
'ľ' => 'Ľ',
'ŀ' => 'Ŀ',
'ł' => 'Ł',
'ń' => 'Ń',
'ņ' => 'Ņ',
'ň' => 'Ň',
'ŋ' => 'Ŋ',
'ō' => 'Ō',
'ŏ' => 'Ŏ',
'ő' => 'Ő',
'œ' => 'Œ',
'ŕ' => 'Ŕ',
'ŗ' => 'Ŗ',
'ř' => 'Ř',
'ś' => 'Ś',
'ŝ' => 'Ŝ',
'ş' => 'Ş',
'š' => 'Š',
'ţ' => 'Ţ',
'ť' => 'Ť',
'ŧ' => 'Ŧ',
'ũ' => 'Ũ',
'ū' => 'Ū',
'ŭ' => 'Ŭ',
'ů' => 'Ů',
'ű' => 'Ű',
'ų' => 'Ų',
'ŵ' => 'Ŵ',
'ŷ' => 'Ŷ',
'ź' => 'Ź',
'ż' => 'Ż',
'ž' => 'Ž',
'ſ' => 'S',
'ƀ' => 'Ƀ',
'ƃ' => 'Ƃ',
'ƅ' => 'Ƅ',
'ƈ' => 'Ƈ',
'ƌ' => 'Ƌ',
'ƒ' => 'Ƒ',
'ƕ' => 'Ƕ',
'ƙ' => 'Ƙ',
'ƚ' => 'Ƚ',
'ƞ' => 'Ƞ',
'ơ' => 'Ơ',
'ƣ' => 'Ƣ',
'ƥ' => 'Ƥ',
'ƨ' => 'Ƨ',
'ƭ' => 'Ƭ',
'ư' => 'Ư',
'ƴ' => 'Ƴ',
'ƶ' => 'Ƶ',
'ƹ' => 'Ƹ',
'ƽ' => 'Ƽ',
'ƿ' => 'Ƿ',
'Dž' => 'DŽ',
'dž' => 'DŽ',
'Lj' => 'LJ',
'lj' => 'LJ',
'Nj' => 'NJ',
'nj' => 'NJ',
'ǎ' => 'Ǎ',
'ǐ' => 'Ǐ',
'ǒ' => 'Ǒ',
'ǔ' => 'Ǔ',
'ǖ' => 'Ǖ',
'ǘ' => 'Ǘ',
'ǚ' => 'Ǚ',
'ǜ' => 'Ǜ',
'ǝ' => 'Ǝ',
'ǟ' => 'Ǟ',
'ǡ' => 'Ǡ',
'ǣ' => 'Ǣ',
'ǥ' => 'Ǥ',
'ǧ' => 'Ǧ',
'ǩ' => 'Ǩ',
'ǫ' => 'Ǫ',
'ǭ' => 'Ǭ',
'ǯ' => 'Ǯ',
'Dz' => 'DZ',
'dz' => 'DZ',
'ǵ' => 'Ǵ',
'ǹ' => 'Ǹ',
'ǻ' => 'Ǻ',
'ǽ' => 'Ǽ',
'ǿ' => 'Ǿ',
'ȁ' => 'Ȁ',
'ȃ' => 'Ȃ',
'ȅ' => 'Ȅ',
'ȇ' => 'Ȇ',
'ȉ' => 'Ȉ',
'ȋ' => 'Ȋ',
'ȍ' => 'Ȍ',
'ȏ' => 'Ȏ',
'ȑ' => 'Ȑ',
'ȓ' => 'Ȓ',
'ȕ' => 'Ȕ',
'ȗ' => 'Ȗ',
'ș' => 'Ș',
'ț' => 'Ț',
'ȝ' => 'Ȝ',
'ȟ' => 'Ȟ',
'ȣ' => 'Ȣ',
'ȥ' => 'Ȥ',
'ȧ' => 'Ȧ',
'ȩ' => 'Ȩ',
'ȫ' => 'Ȫ',
'ȭ' => 'Ȭ',
'ȯ' => 'Ȯ',
'ȱ' => 'Ȱ',
'ȳ' => 'Ȳ',
'ȼ' => 'Ȼ',
'ȿ' => 'Ȿ',
'ɀ' => 'Ɀ',
'ɂ' => 'Ɂ',
'ɇ' => 'Ɇ',
'ɉ' => 'Ɉ',
'ɋ' => 'Ɋ',
'ɍ' => 'Ɍ',
'ɏ' => 'Ɏ',
'ɐ' => 'Ɐ',
'ɑ' => 'Ɑ',
'ɒ' => 'Ɒ',
'ɓ' => 'Ɓ',
'ɔ' => 'Ɔ',
'ɖ' => 'Ɖ',
'ɗ' => 'Ɗ',
'ə' => 'Ə',
'ɛ' => 'Ɛ',
'ɜ' => 'Ɜ',
'ɠ' => 'Ɠ',
'ɡ' => 'Ɡ',
'ɣ' => 'Ɣ',
'ɥ' => 'Ɥ',
'ɦ' => 'Ɦ',
'ɨ' => 'Ɨ',
'ɩ' => 'Ɩ',
'ɪ' => 'Ɪ',
'ɫ' => 'Ɫ',
'ɬ' => 'Ɬ',
'ɯ' => 'Ɯ',
'ɱ' => 'Ɱ',
'ɲ' => 'Ɲ',
'ɵ' => 'Ɵ',
'ɽ' => 'Ɽ',
'ʀ' => 'Ʀ',
'ʂ' => 'Ʂ',
'ʃ' => 'Ʃ',
'ʇ' => 'Ʇ',
'ʈ' => 'Ʈ',
'ʉ' => 'Ʉ',
'ʊ' => 'Ʊ',
'ʋ' => 'Ʋ',
'ʌ' => 'Ʌ',
'ʒ' => 'Ʒ',
'ʝ' => 'Ʝ',
'ʞ' => 'Ʞ',
'ͅ' => 'Ι',
'ͱ' => 'Ͱ',
'ͳ' => 'Ͳ',
'ͷ' => 'Ͷ',
'ͻ' => 'Ͻ',
'ͼ' => 'Ͼ',
'ͽ' => 'Ͽ',
'ά' => 'Ά',
'έ' => 'Έ',
'ή' => 'Ή',
'ί' => 'Ί',
'α' => 'Α',
'β' => 'Β',
'γ' => 'Γ',
'δ' => 'Δ',
'ε' => 'Ε',
'ζ' => 'Ζ',
'η' => 'Η',
'θ' => 'Θ',
'ι' => 'Ι',
'κ' => 'Κ',
'λ' => 'Λ',
'μ' => 'Μ',
'ν' => 'Ν',
'ξ' => 'Ξ',
'ο' => 'Ο',
'π' => 'Π',
'ρ' => 'Ρ',
'ς' => 'Σ',
'σ' => 'Σ',
'τ' => 'Τ',
'υ' => 'Υ',
'φ' => 'Φ',
'χ' => 'Χ',
'ψ' => 'Ψ',
'ω' => 'Ω',
'ϊ' => 'Ϊ',
'ϋ' => 'Ϋ',
'ό' => 'Ό',
'ύ' => 'Ύ',
'ώ' => 'Ώ',
'ϐ' => 'Β',
'ϑ' => 'Θ',
'ϕ' => 'Φ',
'ϖ' => 'Π',
'ϗ' => 'Ϗ',
'ϙ' => 'Ϙ',
'ϛ' => 'Ϛ',
'ϝ' => 'Ϝ',
'ϟ' => 'Ϟ',
'ϡ' => 'Ϡ',
'ϣ' => 'Ϣ',
'ϥ' => 'Ϥ',
'ϧ' => 'Ϧ',
'ϩ' => 'Ϩ',
'ϫ' => 'Ϫ',
'ϭ' => 'Ϭ',
'ϯ' => 'Ϯ',
'ϰ' => 'Κ',
'ϱ' => 'Ρ',
'ϲ' => 'Ϲ',
'ϳ' => 'Ϳ',
'ϵ' => 'Ε',
'ϸ' => 'Ϸ',
'ϻ' => 'Ϻ',
'а' => 'А',
'б' => 'Б',
'в' => 'В',
'г' => 'Г',
'д' => 'Д',
'е' => 'Е',
'ж' => 'Ж',
'з' => 'З',
'и' => 'И',
'й' => 'Й',
'к' => 'К',
'л' => 'Л',
'м' => 'М',
'н' => 'Н',
'о' => 'О',
'п' => 'П',
'р' => 'Р',
'с' => 'С',
'т' => 'Т',
'у' => 'У',
'ф' => 'Ф',
'х' => 'Х',
'ц' => 'Ц',
'ч' => 'Ч',
'ш' => 'Ш',
'щ' => 'Щ',
'ъ' => 'Ъ',
'ы' => 'Ы',
'ь' => 'Ь',
'э' => 'Э',
'ю' => 'Ю',
'я' => 'Я',
'ѐ' => 'Ѐ',
'ё' => 'Ё',
'ђ' => 'Ђ',
'ѓ' => 'Ѓ',
'є' => 'Є',
'ѕ' => 'Ѕ',
'і' => 'І',
'ї' => 'Ї',
'ј' => 'Ј',
'љ' => 'Љ',
'њ' => 'Њ',
'ћ' => 'Ћ',
'ќ' => 'Ќ',
'ѝ' => 'Ѝ',
'ў' => 'Ў',
'џ' => 'Џ',
'ѡ' => 'Ѡ',
'ѣ' => 'Ѣ',
'ѥ' => 'Ѥ',
'ѧ' => 'Ѧ',
'ѩ' => 'Ѩ',
'ѫ' => 'Ѫ',
'ѭ' => 'Ѭ',
'ѯ' => 'Ѯ',
'ѱ' => 'Ѱ',
'ѳ' => 'Ѳ',
'ѵ' => 'Ѵ',
'ѷ' => 'Ѷ',
'ѹ' => 'Ѹ',
'ѻ' => 'Ѻ',
'ѽ' => 'Ѽ',
'ѿ' => 'Ѿ',
'ҁ' => 'Ҁ',
'ҋ' => 'Ҋ',
'ҍ' => 'Ҍ',
'ҏ' => 'Ҏ',
'ґ' => 'Ґ',
'ғ' => 'Ғ',
'ҕ' => 'Ҕ',
'җ' => 'Җ',
'ҙ' => 'Ҙ',
'қ' => 'Қ',
'ҝ' => 'Ҝ',
'ҟ' => 'Ҟ',
'ҡ' => 'Ҡ',
'ң' => 'Ң',
'ҥ' => 'Ҥ',
'ҧ' => 'Ҧ',
'ҩ' => 'Ҩ',
'ҫ' => 'Ҫ',
'ҭ' => 'Ҭ',
'ү' => 'Ү',
'ұ' => 'Ұ',
'ҳ' => 'Ҳ',
'ҵ' => 'Ҵ',
'ҷ' => 'Ҷ',
'ҹ' => 'Ҹ',
'һ' => 'Һ',
'ҽ' => 'Ҽ',
'ҿ' => 'Ҿ',
'ӂ' => 'Ӂ',
'ӄ' => 'Ӄ',
'ӆ' => 'Ӆ',
'ӈ' => 'Ӈ',
'ӊ' => 'Ӊ',
'ӌ' => 'Ӌ',
'ӎ' => 'Ӎ',
'ӏ' => 'Ӏ',
'ӑ' => 'Ӑ',
'ӓ' => 'Ӓ',
'ӕ' => 'Ӕ',
'ӗ' => 'Ӗ',
'ә' => 'Ә',
'ӛ' => 'Ӛ',
'ӝ' => 'Ӝ',
'ӟ' => 'Ӟ',
'ӡ' => 'Ӡ',
'ӣ' => 'Ӣ',
'ӥ' => 'Ӥ',
'ӧ' => 'Ӧ',
'ө' => 'Ө',
'ӫ' => 'Ӫ',
'ӭ' => 'Ӭ',
'ӯ' => 'Ӯ',
'ӱ' => 'Ӱ',
'ӳ' => 'Ӳ',
'ӵ' => 'Ӵ',
'ӷ' => 'Ӷ',
'ӹ' => 'Ӹ',
'ӻ' => 'Ӻ',
'ӽ' => 'Ӽ',
'ӿ' => 'Ӿ',
'ԁ' => 'Ԁ',
'ԃ' => 'Ԃ',
'ԅ' => 'Ԅ',
'ԇ' => 'Ԇ',
'ԉ' => 'Ԉ',
'ԋ' => 'Ԋ',
'ԍ' => 'Ԍ',
'ԏ' => 'Ԏ',
'ԑ' => 'Ԑ',
'ԓ' => 'Ԓ',
'ԕ' => 'Ԕ',
'ԗ' => 'Ԗ',
'ԙ' => 'Ԙ',
'ԛ' => 'Ԛ',
'ԝ' => 'Ԝ',
'ԟ' => 'Ԟ',
'ԡ' => 'Ԡ',
'ԣ' => 'Ԣ',
'ԥ' => 'Ԥ',
'ԧ' => 'Ԧ',
'ԩ' => 'Ԩ',
'ԫ' => 'Ԫ',
'ԭ' => 'Ԭ',
'ԯ' => 'Ԯ',
'ա' => 'Ա',
'բ' => 'Բ',
'գ' => 'Գ',
'դ' => 'Դ',
'ե' => 'Ե',
'զ' => 'Զ',
'է' => 'Է',
'ը' => 'Ը',
'թ' => 'Թ',
'ժ' => 'Ժ',
'ի' => 'Ի',
'լ' => 'Լ',
'խ' => 'Խ',
'ծ' => 'Ծ',
'կ' => 'Կ',
'հ' => 'Հ',
'ձ' => 'Ձ',
'ղ' => 'Ղ',
'ճ' => 'Ճ',
'մ' => 'Մ',
'յ' => 'Յ',
'ն' => 'Ն',
'շ' => 'Շ',
'ո' => 'Ո',
'չ' => 'Չ',
'պ' => 'Պ',
'ջ' => 'Ջ',
'ռ' => 'Ռ',
'ս' => 'Ս',
'վ' => 'Վ',
'տ' => 'Տ',
'ր' => 'Ր',
'ց' => 'Ց',
'ւ' => 'Ւ',
'փ' => 'Փ',
'ք' => 'Ք',
'օ' => 'Օ',
'ֆ' => 'Ֆ',
'ა' => 'Ა',
'ბ' => 'Ბ',
'გ' => 'Გ',
'დ' => 'Დ',
'ე' => 'Ე',
'ვ' => 'Ვ',
'ზ' => 'Ზ',
'თ' => 'Თ',
'ი' => 'Ი',
'კ' => 'Კ',
'ლ' => 'Ლ',
'მ' => 'Მ',
'ნ' => 'Ნ',
'ო' => 'Ო',
'პ' => 'Პ',
'ჟ' => 'Ჟ',
'რ' => 'Რ',
'ს' => 'Ს',
'ტ' => 'Ტ',
'უ' => 'Უ',
'ფ' => 'Ფ',
'ქ' => 'Ქ',
'ღ' => 'Ღ',
'ყ' => 'Ყ',
'შ' => 'Შ',
'ჩ' => 'Ჩ',
'ც' => 'Ც',
'ძ' => 'Ძ',
'წ' => 'Წ',
'ჭ' => 'Ჭ',
'ხ' => 'Ხ',
'ჯ' => 'Ჯ',
'ჰ' => 'Ჰ',
'ჱ' => 'Ჱ',
'ჲ' => 'Ჲ',
'ჳ' => 'Ჳ',
'ჴ' => 'Ჴ',
'ჵ' => 'Ჵ',
'ჶ' => 'Ჶ',
'ჷ' => 'Ჷ',
'ჸ' => 'Ჸ',
'ჹ' => 'Ჹ',
'ჺ' => 'Ჺ',
'ჽ' => 'Ჽ',
'ჾ' => 'Ჾ',
'ჿ' => 'Ჿ',
'ᏸ' => 'Ᏸ',
'ᏹ' => 'Ᏹ',
'ᏺ' => 'Ᏺ',
'ᏻ' => 'Ᏻ',
'ᏼ' => 'Ᏼ',
'ᏽ' => 'Ᏽ',
'ᲀ' => 'В',
'ᲁ' => 'Д',
'ᲂ' => 'О',
'ᲃ' => 'С',
'ᲄ' => 'Т',
'ᲅ' => 'Т',
'ᲆ' => 'Ъ',
'ᲇ' => 'Ѣ',
'ᲈ' => 'Ꙋ',
'ᵹ' => 'Ᵹ',
'ᵽ' => 'Ᵽ',
'ᶎ' => 'Ᶎ',
'ḁ' => 'Ḁ',
'ḃ' => 'Ḃ',
'ḅ' => 'Ḅ',
'ḇ' => 'Ḇ',
'ḉ' => 'Ḉ',
'ḋ' => 'Ḋ',
'ḍ' => 'Ḍ',
'ḏ' => 'Ḏ',
'ḑ' => 'Ḑ',
'ḓ' => 'Ḓ',
'ḕ' => 'Ḕ',
'ḗ' => 'Ḗ',
'ḙ' => 'Ḙ',
'ḛ' => 'Ḛ',
'ḝ' => 'Ḝ',
'ḟ' => 'Ḟ',
'ḡ' => 'Ḡ',
'ḣ' => 'Ḣ',
'ḥ' => 'Ḥ',
'ḧ' => 'Ḧ',
'ḩ' => 'Ḩ',
'ḫ' => 'Ḫ',
'ḭ' => 'Ḭ',
'ḯ' => 'Ḯ',
'ḱ' => 'Ḱ',
'ḳ' => 'Ḳ',
'ḵ' => 'Ḵ',
'ḷ' => 'Ḷ',
'ḹ' => 'Ḹ',
'ḻ' => 'Ḻ',
'ḽ' => 'Ḽ',
'ḿ' => 'Ḿ',
'ṁ' => 'Ṁ',
'ṃ' => 'Ṃ',
'ṅ' => 'Ṅ',
'ṇ' => 'Ṇ',
'ṉ' => 'Ṉ',
'ṋ' => 'Ṋ',
'ṍ' => 'Ṍ',
'ṏ' => 'Ṏ',
'ṑ' => 'Ṑ',
'ṓ' => 'Ṓ',
'ṕ' => 'Ṕ',
'ṗ' => 'Ṗ',
'ṙ' => 'Ṙ',
'ṛ' => 'Ṛ',
'ṝ' => 'Ṝ',
'ṟ' => 'Ṟ',
'ṡ' => 'Ṡ',
'ṣ' => 'Ṣ',
'ṥ' => 'Ṥ',
'ṧ' => 'Ṧ',
'ṩ' => 'Ṩ',
'ṫ' => 'Ṫ',
'ṭ' => 'Ṭ',
'ṯ' => 'Ṯ',
'ṱ' => 'Ṱ',
'ṳ' => 'Ṳ',
'ṵ' => 'Ṵ',
'ṷ' => 'Ṷ',
'ṹ' => 'Ṹ',
'ṻ' => 'Ṻ',
'ṽ' => 'Ṽ',
'ṿ' => 'Ṿ',
'ẁ' => 'Ẁ',
'ẃ' => 'Ẃ',
'ẅ' => 'Ẅ',
'ẇ' => 'Ẇ',
'ẉ' => 'Ẉ',
'ẋ' => 'Ẋ',
'ẍ' => 'Ẍ',
'ẏ' => 'Ẏ',
'ẑ' => 'Ẑ',
'ẓ' => 'Ẓ',
'ẕ' => 'Ẕ',
'ẛ' => 'Ṡ',
'ạ' => 'Ạ',
'ả' => 'Ả',
'ấ' => 'Ấ',
'ầ' => 'Ầ',
'ẩ' => 'Ẩ',
'ẫ' => 'Ẫ',
'ậ' => 'Ậ',
'ắ' => 'Ắ',
'ằ' => 'Ằ',
'ẳ' => 'Ẳ',
'ẵ' => 'Ẵ',
'ặ' => 'Ặ',
'ẹ' => 'Ẹ',
'ẻ' => 'Ẻ',
'ẽ' => 'Ẽ',
'ế' => 'Ế',
'ề' => 'Ề',
'ể' => 'Ể',
'ễ' => 'Ễ',
'ệ' => 'Ệ',
'ỉ' => 'Ỉ',
'ị' => 'Ị',
'ọ' => 'Ọ',
'ỏ' => 'Ỏ',
'ố' => 'Ố',
'ồ' => 'Ồ',
'ổ' => 'Ổ',
'ỗ' => 'Ỗ',
'ộ' => 'Ộ',
'ớ' => 'Ớ',
'ờ' => 'Ờ',
'ở' => 'Ở',
'ỡ' => 'Ỡ',
'ợ' => 'Ợ',
'ụ' => 'Ụ',
'ủ' => 'Ủ',
'ứ' => 'Ứ',
'ừ' => 'Ừ',
'ử' => 'Ử',
'ữ' => 'Ữ',
'ự' => 'Ự',
'ỳ' => 'Ỳ',
'ỵ' => 'Ỵ',
'ỷ' => 'Ỷ',
'ỹ' => 'Ỹ',
'ỻ' => 'Ỻ',
'ỽ' => 'Ỽ',
'ỿ' => 'Ỿ',
'ἀ' => 'Ἀ',
'ἁ' => 'Ἁ',
'ἂ' => 'Ἂ',
'ἃ' => 'Ἃ',
'ἄ' => 'Ἄ',
'ἅ' => 'Ἅ',
'ἆ' => 'Ἆ',
'ἇ' => 'Ἇ',
'ἐ' => 'Ἐ',
'ἑ' => 'Ἑ',
'ἒ' => 'Ἒ',
'ἓ' => 'Ἓ',
'ἔ' => 'Ἔ',
'ἕ' => 'Ἕ',
'ἠ' => 'Ἠ',
'ἡ' => 'Ἡ',
'ἢ' => 'Ἢ',
'ἣ' => 'Ἣ',
'ἤ' => 'Ἤ',
'ἥ' => 'Ἥ',
'ἦ' => 'Ἦ',
'ἧ' => 'Ἧ',
'ἰ' => 'Ἰ',
'ἱ' => 'Ἱ',
'ἲ' => 'Ἲ',
'ἳ' => 'Ἳ',
'ἴ' => 'Ἴ',
'ἵ' => 'Ἵ',
'ἶ' => 'Ἶ',
'ἷ' => 'Ἷ',
'ὀ' => 'Ὀ',
'ὁ' => 'Ὁ',
'ὂ' => 'Ὂ',
'ὃ' => 'Ὃ',
'ὄ' => 'Ὄ',
'ὅ' => 'Ὅ',
'ὑ' => 'Ὑ',
'ὓ' => 'Ὓ',
'ὕ' => 'Ὕ',
'ὗ' => 'Ὗ',
'ὠ' => 'Ὠ',
'ὡ' => 'Ὡ',
'ὢ' => 'Ὢ',
'ὣ' => 'Ὣ',
'ὤ' => 'Ὤ',
'ὥ' => 'Ὥ',
'ὦ' => 'Ὦ',
'ὧ' => 'Ὧ',
'ὰ' => 'Ὰ',
'ά' => 'Ά',
'ὲ' => 'Ὲ',
'έ' => 'Έ',
'ὴ' => 'Ὴ',
'ή' => 'Ή',
'ὶ' => 'Ὶ',
'ί' => 'Ί',
'ὸ' => 'Ὸ',
'ό' => 'Ό',
'ὺ' => 'Ὺ',
'ύ' => 'Ύ',
'ὼ' => 'Ὼ',
'ώ' => 'Ώ',
'ᾀ' => 'ἈΙ',
'ᾁ' => 'ἉΙ',
'ᾂ' => 'ἊΙ',
'ᾃ' => 'ἋΙ',
'ᾄ' => 'ἌΙ',
'ᾅ' => 'ἍΙ',
'ᾆ' => 'ἎΙ',
'ᾇ' => 'ἏΙ',
'ᾐ' => 'ἨΙ',
'ᾑ' => 'ἩΙ',
'ᾒ' => 'ἪΙ',
'ᾓ' => 'ἫΙ',
'ᾔ' => 'ἬΙ',
'ᾕ' => 'ἭΙ',
'ᾖ' => 'ἮΙ',
'ᾗ' => 'ἯΙ',
'ᾠ' => 'ὨΙ',
'ᾡ' => 'ὩΙ',
'ᾢ' => 'ὪΙ',
'ᾣ' => 'ὫΙ',
'ᾤ' => 'ὬΙ',
'ᾥ' => 'ὭΙ',
'ᾦ' => 'ὮΙ',
'ᾧ' => 'ὯΙ',
'ᾰ' => 'Ᾰ',
'ᾱ' => 'Ᾱ',
'ᾳ' => 'ΑΙ',
'ι' => 'Ι',
'ῃ' => 'ΗΙ',
'ῐ' => 'Ῐ',
'ῑ' => 'Ῑ',
'ῠ' => 'Ῠ',
'ῡ' => 'Ῡ',
'ῥ' => 'Ῥ',
'ῳ' => 'ΩΙ',
'ⅎ' => 'Ⅎ',
'ⅰ' => 'Ⅰ',
'ⅱ' => 'Ⅱ',
'ⅲ' => 'Ⅲ',
'ⅳ' => 'Ⅳ',
'ⅴ' => 'Ⅴ',
'ⅵ' => 'Ⅵ',
'ⅶ' => 'Ⅶ',
'ⅷ' => 'Ⅷ',
'ⅸ' => 'Ⅸ',
'ⅹ' => 'Ⅹ',
'ⅺ' => 'Ⅺ',
'ⅻ' => 'Ⅻ',
'ⅼ' => 'Ⅼ',
'ⅽ' => 'Ⅽ',
'ⅾ' => 'Ⅾ',
'ⅿ' => 'Ⅿ',
'ↄ' => 'Ↄ',
'ⓐ' => 'Ⓐ',
'ⓑ' => 'Ⓑ',
'ⓒ' => 'Ⓒ',
'ⓓ' => 'Ⓓ',
'ⓔ' => 'Ⓔ',
'ⓕ' => 'Ⓕ',
'ⓖ' => 'Ⓖ',
'ⓗ' => 'Ⓗ',
'ⓘ' => 'Ⓘ',
'ⓙ' => 'Ⓙ',
'ⓚ' => 'Ⓚ',
'ⓛ' => 'Ⓛ',
'ⓜ' => 'Ⓜ',
'ⓝ' => 'Ⓝ',
'ⓞ' => 'Ⓞ',
'ⓟ' => 'Ⓟ',
'ⓠ' => 'Ⓠ',
'ⓡ' => 'Ⓡ',
'ⓢ' => 'Ⓢ',
'ⓣ' => 'Ⓣ',
'ⓤ' => 'Ⓤ',
'ⓥ' => 'Ⓥ',
'ⓦ' => 'Ⓦ',
'ⓧ' => 'Ⓧ',
'ⓨ' => 'Ⓨ',
'ⓩ' => 'Ⓩ',
'ⰰ' => 'Ⰰ',
'ⰱ' => 'Ⰱ',
'ⰲ' => 'Ⰲ',
'ⰳ' => 'Ⰳ',
'ⰴ' => 'Ⰴ',
'ⰵ' => 'Ⰵ',
'ⰶ' => 'Ⰶ',
'ⰷ' => 'Ⰷ',
'ⰸ' => 'Ⰸ',
'ⰹ' => 'Ⰹ',
'ⰺ' => 'Ⰺ',
'ⰻ' => 'Ⰻ',
'ⰼ' => 'Ⰼ',
'ⰽ' => 'Ⰽ',
'ⰾ' => 'Ⰾ',
'ⰿ' => 'Ⰿ',
'ⱀ' => 'Ⱀ',
'ⱁ' => 'Ⱁ',
'ⱂ' => 'Ⱂ',
'ⱃ' => 'Ⱃ',
'ⱄ' => 'Ⱄ',
'ⱅ' => 'Ⱅ',
'ⱆ' => 'Ⱆ',
'ⱇ' => 'Ⱇ',
'ⱈ' => 'Ⱈ',
'ⱉ' => 'Ⱉ',
'ⱊ' => 'Ⱊ',
'ⱋ' => 'Ⱋ',
'ⱌ' => 'Ⱌ',
'ⱍ' => 'Ⱍ',
'ⱎ' => 'Ⱎ',
'ⱏ' => 'Ⱏ',
'ⱐ' => 'Ⱐ',
'ⱑ' => 'Ⱑ',
'ⱒ' => 'Ⱒ',
'ⱓ' => 'Ⱓ',
'ⱔ' => 'Ⱔ',
'ⱕ' => 'Ⱕ',
'ⱖ' => 'Ⱖ',
'ⱗ' => 'Ⱗ',
'ⱘ' => 'Ⱘ',
'ⱙ' => 'Ⱙ',
'ⱚ' => 'Ⱚ',
'ⱛ' => 'Ⱛ',
'ⱜ' => 'Ⱜ',
'ⱝ' => 'Ⱝ',
'ⱞ' => 'Ⱞ',
'ⱡ' => 'Ⱡ',
'ⱥ' => 'Ⱥ',
'ⱦ' => 'Ⱦ',
'ⱨ' => 'Ⱨ',
'ⱪ' => 'Ⱪ',
'ⱬ' => 'Ⱬ',
'ⱳ' => 'Ⱳ',
'ⱶ' => 'Ⱶ',
'ⲁ' => 'Ⲁ',
'ⲃ' => 'Ⲃ',
'ⲅ' => 'Ⲅ',
'ⲇ' => 'Ⲇ',
'ⲉ' => 'Ⲉ',
'ⲋ' => 'Ⲋ',
'ⲍ' => 'Ⲍ',
'ⲏ' => 'Ⲏ',
'ⲑ' => 'Ⲑ',
'ⲓ' => 'Ⲓ',
'ⲕ' => 'Ⲕ',
'ⲗ' => 'Ⲗ',
'ⲙ' => 'Ⲙ',
'ⲛ' => 'Ⲛ',
'ⲝ' => 'Ⲝ',
'ⲟ' => 'Ⲟ',
'ⲡ' => 'Ⲡ',
'ⲣ' => 'Ⲣ',
'ⲥ' => 'Ⲥ',
'ⲧ' => 'Ⲧ',
'ⲩ' => 'Ⲩ',
'ⲫ' => 'Ⲫ',
'ⲭ' => 'Ⲭ',
'ⲯ' => 'Ⲯ',
'ⲱ' => 'Ⲱ',
'ⲳ' => 'Ⲳ',
'ⲵ' => 'Ⲵ',
'ⲷ' => 'Ⲷ',
'ⲹ' => 'Ⲹ',
'ⲻ' => 'Ⲻ',
'ⲽ' => 'Ⲽ',
'ⲿ' => 'Ⲿ',
'ⳁ' => 'Ⳁ',
'ⳃ' => 'Ⳃ',
'ⳅ' => 'Ⳅ',
'ⳇ' => 'Ⳇ',
'ⳉ' => 'Ⳉ',
'ⳋ' => 'Ⳋ',
'ⳍ' => 'Ⳍ',
'ⳏ' => 'Ⳏ',
'ⳑ' => 'Ⳑ',
'ⳓ' => 'Ⳓ',
'ⳕ' => 'Ⳕ',
'ⳗ' => 'Ⳗ',
'ⳙ' => 'Ⳙ',
'ⳛ' => 'Ⳛ',
'ⳝ' => 'Ⳝ',
'ⳟ' => 'Ⳟ',
'ⳡ' => 'Ⳡ',
'ⳣ' => 'Ⳣ',
'ⳬ' => 'Ⳬ',
'ⳮ' => 'Ⳮ',
'ⳳ' => 'Ⳳ',
'ⴀ' => 'Ⴀ',
'ⴁ' => 'Ⴁ',
'ⴂ' => 'Ⴂ',
'ⴃ' => 'Ⴃ',
'ⴄ' => 'Ⴄ',
'ⴅ' => 'Ⴅ',
'ⴆ' => 'Ⴆ',
'ⴇ' => 'Ⴇ',
'ⴈ' => 'Ⴈ',
'ⴉ' => 'Ⴉ',
'ⴊ' => 'Ⴊ',
'ⴋ' => 'Ⴋ',
'ⴌ' => 'Ⴌ',
'ⴍ' => 'Ⴍ',
'ⴎ' => 'Ⴎ',
'ⴏ' => 'Ⴏ',
'ⴐ' => 'Ⴐ',
'ⴑ' => 'Ⴑ',
'ⴒ' => 'Ⴒ',
'ⴓ' => 'Ⴓ',
'ⴔ' => 'Ⴔ',
'ⴕ' => 'Ⴕ',
'ⴖ' => 'Ⴖ',
'ⴗ' => 'Ⴗ',
'ⴘ' => 'Ⴘ',
'ⴙ' => 'Ⴙ',
'ⴚ' => 'Ⴚ',
'ⴛ' => 'Ⴛ',
'ⴜ' => 'Ⴜ',
'ⴝ' => 'Ⴝ',
'ⴞ' => 'Ⴞ',
'ⴟ' => 'Ⴟ',
'ⴠ' => 'Ⴠ',
'ⴡ' => 'Ⴡ',
'ⴢ' => 'Ⴢ',
'ⴣ' => 'Ⴣ',
'ⴤ' => 'Ⴤ',
'ⴥ' => 'Ⴥ',
'ⴧ' => 'Ⴧ',
'ⴭ' => 'Ⴭ',
'ꙁ' => 'Ꙁ',
'ꙃ' => 'Ꙃ',
'ꙅ' => 'Ꙅ',
'ꙇ' => 'Ꙇ',
'ꙉ' => 'Ꙉ',
'ꙋ' => 'Ꙋ',
'ꙍ' => 'Ꙍ',
'ꙏ' => 'Ꙏ',
'ꙑ' => 'Ꙑ',
'ꙓ' => 'Ꙓ',
'ꙕ' => 'Ꙕ',
'ꙗ' => 'Ꙗ',
'ꙙ' => 'Ꙙ',
'ꙛ' => 'Ꙛ',
'ꙝ' => 'Ꙝ',
'ꙟ' => 'Ꙟ',
'ꙡ' => 'Ꙡ',
'ꙣ' => 'Ꙣ',
'ꙥ' => 'Ꙥ',
'ꙧ' => 'Ꙧ',
'ꙩ' => 'Ꙩ',
'ꙫ' => 'Ꙫ',
'ꙭ' => 'Ꙭ',
'ꚁ' => 'Ꚁ',
'ꚃ' => 'Ꚃ',
'ꚅ' => 'Ꚅ',
'ꚇ' => 'Ꚇ',
'ꚉ' => 'Ꚉ',
'ꚋ' => 'Ꚋ',
'ꚍ' => 'Ꚍ',
'ꚏ' => 'Ꚏ',
'ꚑ' => 'Ꚑ',
'ꚓ' => 'Ꚓ',
'ꚕ' => 'Ꚕ',
'ꚗ' => 'Ꚗ',
'ꚙ' => 'Ꚙ',
'ꚛ' => 'Ꚛ',
'ꜣ' => 'Ꜣ',
'ꜥ' => 'Ꜥ',
'ꜧ' => 'Ꜧ',
'ꜩ' => 'Ꜩ',
'ꜫ' => 'Ꜫ',
'ꜭ' => 'Ꜭ',
'ꜯ' => 'Ꜯ',
'ꜳ' => 'Ꜳ',
'ꜵ' => 'Ꜵ',
'ꜷ' => 'Ꜷ',
'ꜹ' => 'Ꜹ',
'ꜻ' => 'Ꜻ',
'ꜽ' => 'Ꜽ',
'ꜿ' => 'Ꜿ',
'ꝁ' => 'Ꝁ',
'ꝃ' => 'Ꝃ',
'ꝅ' => 'Ꝅ',
'ꝇ' => 'Ꝇ',
'ꝉ' => 'Ꝉ',
'ꝋ' => 'Ꝋ',
'ꝍ' => 'Ꝍ',
'ꝏ' => 'Ꝏ',
'ꝑ' => 'Ꝑ',
'ꝓ' => 'Ꝓ',
'ꝕ' => 'Ꝕ',
'ꝗ' => 'Ꝗ',
'ꝙ' => 'Ꝙ',
'ꝛ' => 'Ꝛ',
'ꝝ' => 'Ꝝ',
'ꝟ' => 'Ꝟ',
'ꝡ' => 'Ꝡ',
'ꝣ' => 'Ꝣ',
'ꝥ' => 'Ꝥ',
'ꝧ' => 'Ꝧ',
'ꝩ' => 'Ꝩ',
'ꝫ' => 'Ꝫ',
'ꝭ' => 'Ꝭ',
'ꝯ' => 'Ꝯ',
'ꝺ' => 'Ꝺ',
'ꝼ' => 'Ꝼ',
'ꝿ' => 'Ꝿ',
'ꞁ' => 'Ꞁ',
'ꞃ' => 'Ꞃ',
'ꞅ' => 'Ꞅ',
'ꞇ' => 'Ꞇ',
'ꞌ' => 'Ꞌ',
'ꞑ' => 'Ꞑ',
'ꞓ' => 'Ꞓ',
'ꞔ' => 'Ꞔ',
'ꞗ' => 'Ꞗ',
'ꞙ' => 'Ꞙ',
'ꞛ' => 'Ꞛ',
'ꞝ' => 'Ꞝ',
'ꞟ' => 'Ꞟ',
'ꞡ' => 'Ꞡ',
'ꞣ' => 'Ꞣ',
'ꞥ' => 'Ꞥ',
'ꞧ' => 'Ꞧ',
'ꞩ' => 'Ꞩ',
'ꞵ' => 'Ꞵ',
'ꞷ' => 'Ꞷ',
'ꞹ' => 'Ꞹ',
'ꞻ' => 'Ꞻ',
'ꞽ' => 'Ꞽ',
'ꞿ' => 'Ꞿ',
'ꟃ' => 'Ꟃ',
'ꟈ' => 'Ꟈ',
'ꟊ' => 'Ꟊ',
'ꟶ' => 'Ꟶ',
'ꭓ' => 'Ꭓ',
'ꭰ' => 'Ꭰ',
'ꭱ' => 'Ꭱ',
'ꭲ' => 'Ꭲ',
'ꭳ' => 'Ꭳ',
'ꭴ' => 'Ꭴ',
'ꭵ' => 'Ꭵ',
'ꭶ' => 'Ꭶ',
'ꭷ' => 'Ꭷ',
'ꭸ' => 'Ꭸ',
'ꭹ' => 'Ꭹ',
'ꭺ' => 'Ꭺ',
'ꭻ' => 'Ꭻ',
'ꭼ' => 'Ꭼ',
'ꭽ' => 'Ꭽ',
'ꭾ' => 'Ꭾ',
'ꭿ' => 'Ꭿ',
'ꮀ' => 'Ꮀ',
'ꮁ' => 'Ꮁ',
'ꮂ' => 'Ꮂ',
'ꮃ' => 'Ꮃ',
'ꮄ' => 'Ꮄ',
'ꮅ' => 'Ꮅ',
'ꮆ' => 'Ꮆ',
'ꮇ' => 'Ꮇ',
'ꮈ' => 'Ꮈ',
'ꮉ' => 'Ꮉ',
'ꮊ' => 'Ꮊ',
'ꮋ' => 'Ꮋ',
'ꮌ' => 'Ꮌ',
'ꮍ' => 'Ꮍ',
'ꮎ' => 'Ꮎ',
'ꮏ' => 'Ꮏ',
'ꮐ' => 'Ꮐ',
'ꮑ' => 'Ꮑ',
'ꮒ' => 'Ꮒ',
'ꮓ' => 'Ꮓ',
'ꮔ' => 'Ꮔ',
'ꮕ' => 'Ꮕ',
'ꮖ' => 'Ꮖ',
'ꮗ' => 'Ꮗ',
'ꮘ' => 'Ꮘ',
'ꮙ' => 'Ꮙ',
'ꮚ' => 'Ꮚ',
'ꮛ' => 'Ꮛ',
'ꮜ' => 'Ꮜ',
'ꮝ' => 'Ꮝ',
'ꮞ' => 'Ꮞ',
'ꮟ' => 'Ꮟ',
'ꮠ' => 'Ꮠ',
'ꮡ' => 'Ꮡ',
'ꮢ' => 'Ꮢ',
'ꮣ' => 'Ꮣ',
'ꮤ' => 'Ꮤ',
'ꮥ' => 'Ꮥ',
'ꮦ' => 'Ꮦ',
'ꮧ' => 'Ꮧ',
'ꮨ' => 'Ꮨ',
'ꮩ' => 'Ꮩ',
'ꮪ' => 'Ꮪ',
'ꮫ' => 'Ꮫ',
'ꮬ' => 'Ꮬ',
'ꮭ' => 'Ꮭ',
'ꮮ' => 'Ꮮ',
'ꮯ' => 'Ꮯ',
'ꮰ' => 'Ꮰ',
'ꮱ' => 'Ꮱ',
'ꮲ' => 'Ꮲ',
'ꮳ' => 'Ꮳ',
'ꮴ' => 'Ꮴ',
'ꮵ' => 'Ꮵ',
'ꮶ' => 'Ꮶ',
'ꮷ' => 'Ꮷ',
'ꮸ' => 'Ꮸ',
'ꮹ' => 'Ꮹ',
'ꮺ' => 'Ꮺ',
'ꮻ' => 'Ꮻ',
'ꮼ' => 'Ꮼ',
'ꮽ' => 'Ꮽ',
'ꮾ' => 'Ꮾ',
'ꮿ' => 'Ꮿ',
'ａ' => 'Ａ',
'ｂ' => 'Ｂ',
'ｃ' => 'Ｃ',
'ｄ' => 'Ｄ',
'ｅ' => 'Ｅ',
'ｆ' => 'Ｆ',
'ｇ' => 'Ｇ',
'ｈ' => 'Ｈ',
'ｉ' => 'Ｉ',
'ｊ' => 'Ｊ',
'ｋ' => 'Ｋ',
'ｌ' => 'Ｌ',
'ｍ' => 'Ｍ',
'ｎ' => 'Ｎ',
'ｏ' => 'Ｏ',
'ｐ' => 'Ｐ',
'ｑ' => 'Ｑ',
'ｒ' => 'Ｒ',
'ｓ' => 'Ｓ',
'ｔ' => 'Ｔ',
'ｕ' => 'Ｕ',
'ｖ' => 'Ｖ',
'ｗ' => 'Ｗ',
'ｘ' => 'Ｘ',
'ｙ' => 'Ｙ',
'ｚ' => 'Ｚ',
'𐐨' => '𐐀',
'𐐩' => '𐐁',
'𐐪' => '𐐂',
'𐐫' => '𐐃',
'𐐬' => '𐐄',
'𐐭' => '𐐅',
'𐐮' => '𐐆',
'𐐯' => '𐐇',
'𐐰' => '𐐈',
'𐐱' => '𐐉',
'𐐲' => '𐐊',
'𐐳' => '𐐋',
'𐐴' => '𐐌',
'𐐵' => '𐐍',
'𐐶' => '𐐎',
'𐐷' => '𐐏',
'𐐸' => '𐐐',
'𐐹' => '𐐑',
'𐐺' => '𐐒',
'𐐻' => '𐐓',
'𐐼' => '𐐔',
'𐐽' => '𐐕',
'𐐾' => '𐐖',
'𐐿' => '𐐗',
'𐑀' => '𐐘',
'𐑁' => '𐐙',
'𐑂' => '𐐚',
'𐑃' => '𐐛',
'𐑄' => '𐐜',
'𐑅' => '𐐝',
'𐑆' => '𐐞',
'𐑇' => '𐐟',
'𐑈' => '𐐠',
'𐑉' => '𐐡',
'𐑊' => '𐐢',
'𐑋' => '𐐣',
'𐑌' => '𐐤',
'𐑍' => '𐐥',
'𐑎' => '𐐦',
'𐑏' => '𐐧',
'𐓘' => '𐒰',
'𐓙' => '𐒱',
'𐓚' => '𐒲',
'𐓛' => '𐒳',
'𐓜' => '𐒴',
'𐓝' => '𐒵',
'𐓞' => '𐒶',
'𐓟' => '𐒷',
'𐓠' => '𐒸',
'𐓡' => '𐒹',
'𐓢' => '𐒺',
'𐓣' => '𐒻',
'𐓤' => '𐒼',
'𐓥' => '𐒽',
'𐓦' => '𐒾',
'𐓧' => '𐒿',
'𐓨' => '𐓀',
'𐓩' => '𐓁',
'𐓪' => '𐓂',
'𐓫' => '𐓃',
'𐓬' => '𐓄',
'𐓭' => '𐓅',
'𐓮' => '𐓆',
'𐓯' => '𐓇',
'𐓰' => '𐓈',
'𐓱' => '𐓉',
'𐓲' => '𐓊',
'𐓳' => '𐓋',
'𐓴' => '𐓌',
'𐓵' => '𐓍',
'𐓶' => '𐓎',
'𐓷' => '𐓏',
'𐓸' => '𐓐',
'𐓹' => '𐓑',
'𐓺' => '𐓒',
'𐓻' => '𐓓',
'𐳀' => '𐲀',
'𐳁' => '𐲁',
'𐳂' => '𐲂',
'𐳃' => '𐲃',
'𐳄' => '𐲄',
'𐳅' => '𐲅',
'𐳆' => '𐲆',
'𐳇' => '𐲇',
'𐳈' => '𐲈',
'𐳉' => '𐲉',
'𐳊' => '𐲊',
'𐳋' => '𐲋',
'𐳌' => '𐲌',
'𐳍' => '𐲍',
'𐳎' => '𐲎',
'𐳏' => '𐲏',
'𐳐' => '𐲐',
'𐳑' => '𐲑',
'𐳒' => '𐲒',
'𐳓' => '𐲓',
'𐳔' => '𐲔',
'𐳕' => '𐲕',
'𐳖' => '𐲖',
'𐳗' => '𐲗',
'𐳘' => '𐲘',
'𐳙' => '𐲙',
'𐳚' => '𐲚',
'𐳛' => '𐲛',
'𐳜' => '𐲜',
'𐳝' => '𐲝',
'𐳞' => '𐲞',
'𐳟' => '𐲟',
'𐳠' => '𐲠',
'𐳡' => '𐲡',
'𐳢' => '𐲢',
'𐳣' => '𐲣',
'𐳤' => '𐲤',
'𐳥' => '𐲥',
'𐳦' => '𐲦',
'𐳧' => '𐲧',
'𐳨' => '𐲨',
'𐳩' => '𐲩',
'𐳪' => '𐲪',
'𐳫' => '𐲫',
'𐳬' => '𐲬',
'𐳭' => '𐲭',
'𐳮' => '𐲮',
'𐳯' => '𐲯',
'𐳰' => '𐲰',
'𐳱' => '𐲱',
'𐳲' => '𐲲',
'𑣀' => '𑢠',
'𑣁' => '𑢡',
'𑣂' => '𑢢',
'𑣃' => '𑢣',
'𑣄' => '𑢤',
'𑣅' => '𑢥',
'𑣆' => '𑢦',
'𑣇' => '𑢧',
'𑣈' => '𑢨',
'𑣉' => '𑢩',
'𑣊' => '𑢪',
'𑣋' => '𑢫',
'𑣌' => '𑢬',
'𑣍' => '𑢭',
'𑣎' => '𑢮',
'𑣏' => '𑢯',
'𑣐' => '𑢰',
'𑣑' => '𑢱',
'𑣒' => '𑢲',
'𑣓' => '𑢳',
'𑣔' => '𑢴',
'𑣕' => '𑢵',
'𑣖' => '𑢶',
'𑣗' => '𑢷',
'𑣘' => '𑢸',
'𑣙' => '𑢹',
'𑣚' => '𑢺',
'𑣛' => '𑢻',
'𑣜' => '𑢼',
'𑣝' => '𑢽',
'𑣞' => '𑢾',
'𑣟' => '𑢿',
'𖹠' => '𖹀',
'𖹡' => '𖹁',
'𖹢' => '𖹂',
'𖹣' => '𖹃',
'𖹤' => '𖹄',
'𖹥' => '𖹅',
'𖹦' => '𖹆',
'𖹧' => '𖹇',
'𖹨' => '𖹈',
'𖹩' => '𖹉',
'𖹪' => '𖹊',
'𖹫' => '𖹋',
'𖹬' => '𖹌',
'𖹭' => '𖹍',
'𖹮' => '𖹎',
'𖹯' => '𖹏',
'𖹰' => '𖹐',
'𖹱' => '𖹑',
'𖹲' => '𖹒',
'𖹳' => '𖹓',
'𖹴' => '𖹔',
'𖹵' => '𖹕',
'𖹶' => '𖹖',
'𖹷' => '𖹗',
'𖹸' => '𖹘',
'𖹹' => '𖹙',
'𖹺' => '𖹚',
'𖹻' => '𖹛',
'𖹼' => '𖹜',
'𖹽' => '𖹝',
'𖹾' => '𖹞',
'𖹿' => '𖹟',
'𞤢' => '𞤀',
'𞤣' => '𞤁',
'𞤤' => '𞤂',
'𞤥' => '𞤃',
'𞤦' => '𞤄',
'𞤧' => '𞤅',
'𞤨' => '𞤆',
'𞤩' => '𞤇',
'𞤪' => '𞤈',
'𞤫' => '𞤉',
'𞤬' => '𞤊',
'𞤭' => '𞤋',
'𞤮' => '𞤌',
'𞤯' => '𞤍',
'𞤰' => '𞤎',
'𞤱' => '𞤏',
'𞤲' => '𞤐',
'𞤳' => '𞤑',
'𞤴' => '𞤒',
'𞤵' => '𞤓',
'𞤶' => '𞤔',
'𞤷' => '𞤕',
'𞤸' => '𞤖',
'𞤹' => '𞤗',
'𞤺' => '𞤘',
'𞤻' => '𞤙',
'𞤼' => '𞤚',
'𞤽' => '𞤛',
'𞤾' => '𞤜',
'𞤿' => '𞤝',
'𞥀' => '𞤞',
'𞥁' => '𞤟',
'𞥂' => '𞤠',
'𞥃' => '𞤡',
'ß' => 'SS',
'ff' => 'FF',
'fi' => 'FI',
'fl' => 'FL',
'ffi' => 'FFI',
'ffl' => 'FFL',
'ſt' => 'ST',
'st' => 'ST',
'և' => 'ԵՒ',
'ﬓ' => 'ՄՆ',
'ﬔ' => 'ՄԵ',
'ﬕ' => 'ՄԻ',
'ﬖ' => 'ՎՆ',
'ﬗ' => 'ՄԽ',
'ʼn' => 'ʼN',
'ΐ' => 'Ϊ́',
'ΰ' => 'Ϋ́',
'ǰ' => 'J̌',
'ẖ' => 'H̱',
'ẗ' => 'T̈',
'ẘ' => 'W̊',
'ẙ' => 'Y̊',
'ẚ' => 'Aʾ',
'ὐ' => 'Υ̓',
'ὒ' => 'Υ̓̀',
'ὔ' => 'Υ̓́',
'ὖ' => 'Υ̓͂',
'ᾶ' => 'Α͂',
'ῆ' => 'Η͂',
'ῒ' => 'Ϊ̀',
'ΐ' => 'Ϊ́',
'ῖ' => 'Ι͂',
'ῗ' => 'Ϊ͂',
'ῢ' => 'Ϋ̀',
'ΰ' => 'Ϋ́',
'ῤ' => 'Ρ̓',
'ῦ' => 'Υ͂',
'ῧ' => 'Ϋ͂',
'ῶ' => 'Ω͂',
'ᾈ' => 'ἈΙ',
'ᾉ' => 'ἉΙ',
'ᾊ' => 'ἊΙ',
'ᾋ' => 'ἋΙ',
'ᾌ' => 'ἌΙ',
'ᾍ' => 'ἍΙ',
'ᾎ' => 'ἎΙ',
'ᾏ' => 'ἏΙ',
'ᾘ' => 'ἨΙ',
'ᾙ' => 'ἩΙ',
'ᾚ' => 'ἪΙ',
'ᾛ' => 'ἫΙ',
'ᾜ' => 'ἬΙ',
'ᾝ' => 'ἭΙ',
'ᾞ' => 'ἮΙ',
'ᾟ' => 'ἯΙ',
'ᾨ' => 'ὨΙ',
'ᾩ' => 'ὩΙ',
'ᾪ' => 'ὪΙ',
'ᾫ' => 'ὫΙ',
'ᾬ' => 'ὬΙ',
'ᾭ' => 'ὭΙ',
'ᾮ' => 'ὮΙ',
'ᾯ' => 'ὯΙ',
'ᾼ' => 'ΑΙ',
'ῌ' => 'ΗΙ',
'ῼ' => 'ΩΙ',
'ᾲ' => 'ᾺΙ',
'ᾴ' => 'ΆΙ',
'ῂ' => 'ῊΙ',
'ῄ' => 'ΉΙ',
'ῲ' => 'ῺΙ',
'ῴ' => 'ΏΙ',
'ᾷ' => 'Α͂Ι',
'ῇ' => 'Η͂Ι',
'ῷ' => 'Ω͂Ι',
);
<?php
return [
'İ' => 'i̇',
'µ' => 'μ',
'ſ' => 's',
'ͅ' => 'ι',
'ς' => 'σ',
'ϐ' => 'β',
'ϑ' => 'θ',
'ϕ' => 'φ',
'ϖ' => 'π',
'ϰ' => 'κ',
'ϱ' => 'ρ',
'ϵ' => 'ε',
'ẛ' => 'ṡ',
'ι' => 'ι',
'ß' => 'ss',
'ʼn' => 'ʼn',
'ǰ' => 'ǰ',
'ΐ' => 'ΐ',
'ΰ' => 'ΰ',
'և' => 'եւ',
'ẖ' => 'ẖ',
'ẗ' => 'ẗ',
'ẘ' => 'ẘ',
'ẙ' => 'ẙ',
'ẚ' => 'aʾ',
'ẞ' => 'ss',
'ὐ' => 'ὐ',
'ὒ' => 'ὒ',
'ὔ' => 'ὔ',
'ὖ' => 'ὖ',
'ᾀ' => 'ἀι',
'ᾁ' => 'ἁι',
'ᾂ' => 'ἂι',
'ᾃ' => 'ἃι',
'ᾄ' => 'ἄι',
'ᾅ' => 'ἅι',
'ᾆ' => 'ἆι',
'ᾇ' => 'ἇι',
'ᾈ' => 'ἀι',
'ᾉ' => 'ἁι',
'ᾊ' => 'ἂι',
'ᾋ' => 'ἃι',
'ᾌ' => 'ἄι',
'ᾍ' => 'ἅι',
'ᾎ' => 'ἆι',
'ᾏ' => 'ἇι',
'ᾐ' => 'ἠι',
'ᾑ' => 'ἡι',
'ᾒ' => 'ἢι',
'ᾓ' => 'ἣι',
'ᾔ' => 'ἤι',
'ᾕ' => 'ἥι',
'ᾖ' => 'ἦι',
'ᾗ' => 'ἧι',
'ᾘ' => 'ἠι',
'ᾙ' => 'ἡι',
'ᾚ' => 'ἢι',
'ᾛ' => 'ἣι',
'ᾜ' => 'ἤι',
'ᾝ' => 'ἥι',
'ᾞ' => 'ἦι',
'ᾟ' => 'ἧι',
'ᾠ' => 'ὠι',
'ᾡ' => 'ὡι',
'ᾢ' => 'ὢι',
'ᾣ' => 'ὣι',
'ᾤ' => 'ὤι',
'ᾥ' => 'ὥι',
'ᾦ' => 'ὦι',
'ᾧ' => 'ὧι',
'ᾨ' => 'ὠι',
'ᾩ' => 'ὡι',
'ᾪ' => 'ὢι',
'ᾫ' => 'ὣι',
'ᾬ' => 'ὤι',
'ᾭ' => 'ὥι',
'ᾮ' => 'ὦι',
'ᾯ' => 'ὧι',
'ᾲ' => 'ὰι',
'ᾳ' => 'αι',
'ᾴ' => 'άι',
'ᾶ' => 'ᾶ',
'ᾷ' => 'ᾶι',
'ᾼ' => 'αι',
'ῂ' => 'ὴι',
'ῃ' => 'ηι',
'ῄ' => 'ήι',
'ῆ' => 'ῆ',
'ῇ' => 'ῆι',
'ῌ' => 'ηι',
'ῒ' => 'ῒ',
'ῖ' => 'ῖ',
'ῗ' => 'ῗ',
'ῢ' => 'ῢ',
'ῤ' => 'ῤ',
'ῦ' => 'ῦ',
'ῧ' => 'ῧ',
'ῲ' => 'ὼι',
'ῳ' => 'ωι',
'ῴ' => 'ώι',
'ῶ' => 'ῶ',
'ῷ' => 'ῶι',
'ῼ' => 'ωι',
'ff' => 'ff',
'fi' => 'fi',
'fl' => 'fl',
'ffi' => 'ffi',
'ffl' => 'ffl',
'ſt' => 'st',
'st' => 'st',
'ﬓ' => 'մն',
'ﬔ' => 'մե',
'ﬕ' => 'մի',
'ﬖ' => 'վն',
'ﬗ' => 'մխ',
];
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use Symfony\Polyfill\Mbstring as p;
if (\PHP_VERSION_ID >= 80000) {
return require __DIR__.'/bootstrap80.php';
}
if (!function_exists('mb_convert_encoding')) {
function mb_convert_encoding($string, $to_encoding, $from_encoding = null) { return p\Mbstring::mb_convert_encoding($string, $to_encoding, $from_encoding); }
}
if (!function_exists('mb_decode_mimeheader')) {
function mb_decode_mimeheader($string) { return p\Mbstring::mb_decode_mimeheader($string); }
}
if (!function_exists('mb_encode_mimeheader')) {
function mb_encode_mimeheader($string, $charset = null, $transfer_encoding = null, $newline = "\r\n", $indent = 0) { return p\Mbstring::mb_encode_mimeheader($string, $charset, $transfer_encoding, $newline, $indent); }
}
if (!function_exists('mb_decode_numericentity')) {
function mb_decode_numericentity($string, $map, $encoding = null) { return p\Mbstring::mb_decode_numericentity($string, $map, $encoding); }
}
if (!function_exists('mb_encode_numericentity')) {
function mb_encode_numericentity($string, $map, $encoding = null, $hex = false) { return p\Mbstring::mb_encode_numericentity($string, $map, $encoding, $hex); }
}
if (!function_exists('mb_convert_case')) {
function mb_convert_case($string, $mode, $encoding = null) { return p\Mbstring::mb_convert_case($string, $mode, $encoding); }
}
if (!function_exists('mb_internal_encoding')) {
function mb_internal_encoding($encoding = null) { return p\Mbstring::mb_internal_encoding($encoding); }
}
if (!function_exists('mb_language')) {
function mb_language($language = null) { return p\Mbstring::mb_language($language); }
}
if (!function_exists('mb_list_encodings')) {
function mb_list_encodings() { return p\Mbstring::mb_list_encodings(); }
}
if (!function_exists('mb_encoding_aliases')) {
function mb_encoding_aliases($encoding) { return p\Mbstring::mb_encoding_aliases($encoding); }
}
if (!function_exists('mb_check_encoding')) {
function mb_check_encoding($value = null, $encoding = null) { return p\Mbstring::mb_check_encoding($value, $encoding); }
}
if (!function_exists('mb_detect_encoding')) {
function mb_detect_encoding($string, $encodings = null, $strict = false) { return p\Mbstring::mb_detect_encoding($string, $encodings, $strict); }
}
if (!function_exists('mb_detect_order')) {
function mb_detect_order($encoding = null) { return p\Mbstring::mb_detect_order($encoding); }
}
if (!function_exists('mb_parse_str')) {
function mb_parse_str($string, &$result = []) { parse_str($string, $result); return (bool) $result; }
}
if (!function_exists('mb_strlen')) {
function mb_strlen($string, $encoding = null) { return p\Mbstring::mb_strlen($string, $encoding); }
}
if (!function_exists('mb_strpos')) {
function mb_strpos($haystack, $needle, $offset = 0, $encoding = null) { return p\Mbstring::mb_strpos($haystack, $needle, $offset, $encoding); }
}
if (!function_exists('mb_strtolower')) {
function mb_strtolower($string, $encoding = null) { return p\Mbstring::mb_strtolower($string, $encoding); }
}
if (!function_exists('mb_strtoupper')) {
function mb_strtoupper($string, $encoding = null) { return p\Mbstring::mb_strtoupper($string, $encoding); }
}
if (!function_exists('mb_substitute_character')) {
function mb_substitute_character($substitute_character = null) { return p\Mbstring::mb_substitute_character($substitute_character); }
}
if (!function_exists('mb_substr')) {
function mb_substr($string, $start, $length = 2147483647, $encoding = null) { return p\Mbstring::mb_substr($string, $start, $length, $encoding); }
}
if (!function_exists('mb_stripos')) {
function mb_stripos($haystack, $needle, $offset = 0, $encoding = null) { return p\Mbstring::mb_stripos($haystack, $needle, $offset, $encoding); }
}
if (!function_exists('mb_stristr')) {
function mb_stristr($haystack, $needle, $before_needle = false, $encoding = null) { return p\Mbstring::mb_stristr($haystack, $needle, $before_needle, $encoding); }
}
if (!function_exists('mb_strrchr')) {
function mb_strrchr($haystack, $needle, $before_needle = false, $encoding = null) { return p\Mbstring::mb_strrchr($haystack, $needle, $before_needle, $encoding); }
}
if (!function_exists('mb_strrichr')) {
function mb_strrichr($haystack, $needle, $before_needle = false, $encoding = null) { return p\Mbstring::mb_strrichr($haystack, $needle, $before_needle, $encoding); }
}
if (!function_exists('mb_strripos')) {
function mb_strripos($haystack, $needle, $offset = 0, $encoding = null) { return p\Mbstring::mb_strripos($haystack, $needle, $offset, $encoding); }
}
if (!function_exists('mb_strrpos')) {
function mb_strrpos($haystack, $needle, $offset = 0, $encoding = null) { return p\Mbstring::mb_strrpos($haystack, $needle, $offset, $encoding); }
}
if (!function_exists('mb_strstr')) {
function mb_strstr($haystack, $needle, $before_needle = false, $encoding = null) { return p\Mbstring::mb_strstr($haystack, $needle, $before_needle, $encoding); }
}
if (!function_exists('mb_get_info')) {
function mb_get_info($type = 'all') { return p\Mbstring::mb_get_info($type); }
}
if (!function_exists('mb_http_output')) {
function mb_http_output($encoding = null) { return p\Mbstring::mb_http_output($encoding); }
}
if (!function_exists('mb_strwidth')) {
function mb_strwidth($string, $encoding = null) { return p\Mbstring::mb_strwidth($string, $encoding); }
}
if (!function_exists('mb_substr_count')) {
function mb_substr_count($haystack, $needle, $encoding = null) { return p\Mbstring::mb_substr_count($haystack, $needle, $encoding); }
}
if (!function_exists('mb_output_handler')) {
function mb_output_handler($string, $status) { return p\Mbstring::mb_output_handler($string, $status); }
}
if (!function_exists('mb_http_input')) {
function mb_http_input($type = null) { return p\Mbstring::mb_http_input($type); }
}
if (!function_exists('mb_convert_variables')) {
function mb_convert_variables($to_encoding, $from_encoding, &...$vars) { return p\Mbstring::mb_convert_variables($to_encoding, $from_encoding, ...$vars); }
}
if (!function_exists('mb_ord')) {
function mb_ord($string, $encoding = null) { return p\Mbstring::mb_ord($string, $encoding); }
}
if (!function_exists('mb_chr')) {
function mb_chr($codepoint, $encoding = null) { return p\Mbstring::mb_chr($codepoint, $encoding); }
}
if (!function_exists('mb_scrub')) {
function mb_scrub($string, $encoding = null) { $encoding = null === $encoding ? mb_internal_encoding() : $encoding; return mb_convert_encoding($string, $encoding, $encoding); }
}
if (!function_exists('mb_str_split')) {
function mb_str_split($string, $length = 1, $encoding = null) { return p\Mbstring::mb_str_split($string, $length, $encoding); }
}
if (!function_exists('mb_str_pad')) {
function mb_str_pad(string $string, int $length, string $pad_string = ' ', int $pad_type = STR_PAD_RIGHT, ?string $encoding = null): string { return p\Mbstring::mb_str_pad($string, $length, $pad_string, $pad_type, $encoding); }
}
if (!function_exists('mb_ucfirst')) {
function mb_ucfirst(string $string, ?string $encoding = null): string { return p\Mbstring::mb_ucfirst($string, $encoding); }
}
if (!function_exists('mb_lcfirst')) {
function mb_lcfirst(string $string, ?string $encoding = null): string { return p\Mbstring::mb_lcfirst($string, $encoding); }
}
if (extension_loaded('mbstring')) {
return;
}
if (!defined('MB_CASE_UPPER')) {
define('MB_CASE_UPPER', 0);
}
if (!defined('MB_CASE_LOWER')) {
define('MB_CASE_LOWER', 1);
}
if (!defined('MB_CASE_TITLE')) {
define('MB_CASE_TITLE', 2);
}
Copyright (c) 2015-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use Symfony\Polyfill\Mbstring as p;
if (!function_exists('mb_convert_encoding')) {
function mb_convert_encoding(array|string|null $string, ?string $to_encoding, array|string|null $from_encoding = null): array|string|false { return p\Mbstring::mb_convert_encoding($string ?? '', (string) $to_encoding, $from_encoding); }
}
if (!function_exists('mb_decode_mimeheader')) {
function mb_decode_mimeheader(?string $string): string { return p\Mbstring::mb_decode_mimeheader((string) $string); }
}
if (!function_exists('mb_encode_mimeheader')) {
function mb_encode_mimeheader(?string $string, ?string $charset = null, ?string $transfer_encoding = null, ?string $newline = "\r\n", ?int $indent = 0): string { return p\Mbstring::mb_encode_mimeheader((string) $string, $charset, $transfer_encoding, (string) $newline, (int) $indent); }
}
if (!function_exists('mb_decode_numericentity')) {
function mb_decode_numericentity(?string $string, array $map, ?string $encoding = null): string { return p\Mbstring::mb_decode_numericentity((string) $string, $map, $encoding); }
}
if (!function_exists('mb_encode_numericentity')) {
function mb_encode_numericentity(?string $string, array $map, ?string $encoding = null, ?bool $hex = false): string { return p\Mbstring::mb_encode_numericentity((string) $string, $map, $encoding, (bool) $hex); }
}
if (!function_exists('mb_convert_case')) {
function mb_convert_case(?string $string, ?int $mode, ?string $encoding = null): string { return p\Mbstring::mb_convert_case((string) $string, (int) $mode, $encoding); }
}
if (!function_exists('mb_internal_encoding')) {
function mb_internal_encoding(?string $encoding = null): string|bool { return p\Mbstring::mb_internal_encoding($encoding); }
}
if (!function_exists('mb_language')) {
function mb_language(?string $language = null): string|bool { return p\Mbstring::mb_language($language); }
}
if (!function_exists('mb_list_encodings')) {
function mb_list_encodings(): array { return p\Mbstring::mb_list_encodings(); }
}
if (!function_exists('mb_encoding_aliases')) {
function mb_encoding_aliases(?string $encoding): array { return p\Mbstring::mb_encoding_aliases((string) $encoding); }
}
if (!function_exists('mb_check_encoding')) {
function mb_check_encoding(array|string|null $value = null, ?string $encoding = null): bool { return p\Mbstring::mb_check_encoding($value, $encoding); }
}
if (!function_exists('mb_detect_encoding')) {
function mb_detect_encoding(?string $string, array|string|null $encodings = null, ?bool $strict = false): string|false { return p\Mbstring::mb_detect_encoding((string) $string, $encodings, (bool) $strict); }
}
if (!function_exists('mb_detect_order')) {
function mb_detect_order(array|string|null $encoding = null): array|bool { return p\Mbstring::mb_detect_order($encoding); }
}
if (!function_exists('mb_parse_str')) {
function mb_parse_str(?string $string, &$result = []): bool { parse_str((string) $string, $result); return (bool) $result; }
}
if (!function_exists('mb_strlen')) {
function mb_strlen(?string $string, ?string $encoding = null): int { return p\Mbstring::mb_strlen((string) $string, $encoding); }
}
if (!function_exists('mb_strpos')) {
function mb_strpos(?string $haystack, ?string $needle, ?int $offset = 0, ?string $encoding = null): int|false { return p\Mbstring::mb_strpos((string) $haystack, (string) $needle, (int) $offset, $encoding); }
}
if (!function_exists('mb_strtolower')) {
function mb_strtolower(?string $string, ?string $encoding = null): string { return p\Mbstring::mb_strtolower((string) $string, $encoding); }
}
if (!function_exists('mb_strtoupper')) {
function mb_strtoupper(?string $string, ?string $encoding = null): string { return p\Mbstring::mb_strtoupper((string) $string, $encoding); }
}
if (!function_exists('mb_substitute_character')) {
function mb_substitute_character(string|int|null $substitute_character = null): string|int|bool { return p\Mbstring::mb_substitute_character($substitute_character); }
}
if (!function_exists('mb_substr')) {
function mb_substr(?string $string, ?int $start, ?int $length = null, ?string $encoding = null): string { return p\Mbstring::mb_substr((string) $string, (int) $start, $length, $encoding); }
}
if (!function_exists('mb_stripos')) {
function mb_stripos(?string $haystack, ?string $needle, ?int $offset = 0, ?string $encoding = null): int|false { return p\Mbstring::mb_stripos((string) $haystack, (string) $needle, (int) $offset, $encoding); }
}
if (!function_exists('mb_stristr')) {
function mb_stristr(?string $haystack, ?string $needle, ?bool $before_needle = false, ?string $encoding = null): string|false { return p\Mbstring::mb_stristr((string) $haystack, (string) $needle, (bool) $before_needle, $encoding); }
}
if (!function_exists('mb_strrchr')) {
function mb_strrchr(?string $haystack, ?string $needle, ?bool $before_needle = false, ?string $encoding = null): string|false { return p\Mbstring::mb_strrchr((string) $haystack, (string) $needle, (bool) $before_needle, $encoding); }
}
if (!function_exists('mb_strrichr')) {
function mb_strrichr(?string $haystack, ?string $needle, ?bool $before_needle = false, ?string $encoding = null): string|false { return p\Mbstring::mb_strrichr((string) $haystack, (string) $needle, (bool) $before_needle, $encoding); }
}
if (!function_exists('mb_strripos')) {
function mb_strripos(?string $haystack, ?string $needle, ?int $offset = 0, ?string $encoding = null): int|false { return p\Mbstring::mb_strripos((string) $haystack, (string) $needle, (int) $offset, $encoding); }
}
if (!function_exists('mb_strrpos')) {
function mb_strrpos(?string $haystack, ?string $needle, ?int $offset = 0, ?string $encoding = null): int|false { return p\Mbstring::mb_strrpos((string) $haystack, (string) $needle, (int) $offset, $encoding); }
}
if (!function_exists('mb_strstr')) {
function mb_strstr(?string $haystack, ?string $needle, ?bool $before_needle = false, ?string $encoding = null): string|false { return p\Mbstring::mb_strstr((string) $haystack, (string) $needle, (bool) $before_needle, $encoding); }
}
if (!function_exists('mb_get_info')) {
function mb_get_info(?string $type = 'all'): array|string|int|false { return p\Mbstring::mb_get_info((string) $type); }
}
if (!function_exists('mb_http_output')) {
function mb_http_output(?string $encoding = null): string|bool { return p\Mbstring::mb_http_output($encoding); }
}
if (!function_exists('mb_strwidth')) {
function mb_strwidth(?string $string, ?string $encoding = null): int { return p\Mbstring::mb_strwidth((string) $string, $encoding); }
}
if (!function_exists('mb_substr_count')) {
function mb_substr_count(?string $haystack, ?string $needle, ?string $encoding = null): int { return p\Mbstring::mb_substr_count((string) $haystack, (string) $needle, $encoding); }
}
if (!function_exists('mb_output_handler')) {
function mb_output_handler(?string $string, ?int $status): string { return p\Mbstring::mb_output_handler((string) $string, (int) $status); }
}
if (!function_exists('mb_http_input')) {
function mb_http_input(?string $type = null): array|string|false { return p\Mbstring::mb_http_input($type); }
}
if (!function_exists('mb_convert_variables')) {
function mb_convert_variables(?string $to_encoding, array|string|null $from_encoding, mixed &$var, mixed &...$vars): string|false { return p\Mbstring::mb_convert_variables((string) $to_encoding, $from_encoding ?? '', $var, ...$vars); }
}
if (!function_exists('mb_ord')) {
function mb_ord(?string $string, ?string $encoding = null): int|false { return p\Mbstring::mb_ord((string) $string, $encoding); }
}
if (!function_exists('mb_chr')) {
function mb_chr(?int $codepoint, ?string $encoding = null): string|false { return p\Mbstring::mb_chr((int) $codepoint, $encoding); }
}
if (!function_exists('mb_scrub')) {
function mb_scrub(?string $string, ?string $encoding = null): string { $encoding ??= mb_internal_encoding(); return mb_convert_encoding((string) $string, $encoding, $encoding); }
}
if (!function_exists('mb_str_split')) {
function mb_str_split(?string $string, ?int $length = 1, ?string $encoding = null): array { return p\Mbstring::mb_str_split((string) $string, (int) $length, $encoding); }
}
if (!function_exists('mb_str_pad')) {
function mb_str_pad(string $string, int $length, string $pad_string = ' ', int $pad_type = STR_PAD_RIGHT, ?string $encoding = null): string { return p\Mbstring::mb_str_pad($string, $length, $pad_string, $pad_type, $encoding); }
}
if (!function_exists('mb_ucfirst')) {
function mb_ucfirst($string, ?string $encoding = null): string { return p\Mbstring::mb_ucfirst($string, $encoding); }
}
if (!function_exists('mb_lcfirst')) {
function mb_lcfirst($string, ?string $encoding = null): string { return p\Mbstring::mb_lcfirst($string, $encoding); }
}
if (extension_loaded('mbstring')) {
return;
}
if (!defined('MB_CASE_UPPER')) {
define('MB_CASE_UPPER', 0);
}
if (!defined('MB_CASE_LOWER')) {
define('MB_CASE_LOWER', 1);
}
if (!defined('MB_CASE_TITLE')) {
define('MB_CASE_TITLE', 2);
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\ExceptionInterface;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\InvalidArgumentException;
/**
* Represents a string of Unicode grapheme clusters encoded as UTF-8.
*
* A letter followed by combining characters (accents typically) form what Unicode defines
* as a grapheme cluster: a character as humans mean it in written texts. This class knows
* about the concept and won't split a letter apart from its combining accents. It also
* ensures all string comparisons happen on their canonically-composed representation,
* ignoring e.g. the order in which accents are listed when a letter has many of them.
*
* @see https://unicode.org/reports/tr15/
*
* @author Nicolas Grekas <p@tchwork.com>
* @author Hugo Hamon <hugohamon@neuf.fr>
*
* @throws ExceptionInterface
*/
class UnicodeString extends AbstractUnicodeString
{
public function __construct(string $string = '')
{
$this->string = \normalizer_is_normalized($string) ? $string : \normalizer_normalize($string);
if (\false === $this->string) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
}
public function append(string ...$suffix) : AbstractString
{
$str = clone $this;
$str->string = $this->string . (1 >= \count($suffix) ? $suffix[0] ?? '' : \implode('', $suffix));
\normalizer_is_normalized($str->string) ?: ($str->string = \normalizer_normalize($str->string));
if (\false === $str->string) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
return $str;
}
public function chunk(int $length = 1) : array
{
if (1 > $length) {
throw new InvalidArgumentException('The chunk length must be greater than zero.');
}
if ('' === $this->string) {
return [];
}
$rx = '/(';
while (65535 < $length) {
$rx .= '\\X{65535}';
$length -= 65535;
}
$rx .= '\\X{' . $length . '})/u';
$str = clone $this;
$chunks = [];
foreach (\preg_split($rx, $this->string, -1, \PREG_SPLIT_DELIM_CAPTURE | \PREG_SPLIT_NO_EMPTY) as $chunk) {
$str->string = $chunk;
$chunks[] = clone $str;
}
return $chunks;
}
public function endsWith($suffix) : bool
{
if ($suffix instanceof AbstractString) {
$suffix = $suffix->string;
} elseif (\is_array($suffix) || $suffix instanceof \Traversable) {
return parent::endsWith($suffix);
} else {
$suffix = (string) $suffix;
}
$form = null === $this->ignoreCase ? \Normalizer::NFD : \Normalizer::NFC;
\normalizer_is_normalized($suffix, $form) ?: ($suffix = \normalizer_normalize($suffix, $form));
if ('' === $suffix || \false === $suffix) {
return \false;
}
if ($this->ignoreCase) {
return 0 === \mb_stripos(\grapheme_extract($this->string, \strlen($suffix), \GRAPHEME_EXTR_MAXBYTES, \strlen($this->string) - \strlen($suffix)), $suffix, 0, 'UTF-8');
}
return $suffix === \grapheme_extract($this->string, \strlen($suffix), \GRAPHEME_EXTR_MAXBYTES, \strlen($this->string) - \strlen($suffix));
}
public function equalsTo($string) : bool
{
if ($string instanceof AbstractString) {
$string = $string->string;
} elseif (\is_array($string) || $string instanceof \Traversable) {
return parent::equalsTo($string);
} else {
$string = (string) $string;
}
$form = null === $this->ignoreCase ? \Normalizer::NFD : \Normalizer::NFC;
\normalizer_is_normalized($string, $form) ?: ($string = \normalizer_normalize($string, $form));
if ('' !== $string && \false !== $string && $this->ignoreCase) {
return \strlen($string) === \strlen($this->string) && 0 === \mb_stripos($this->string, $string, 0, 'UTF-8');
}
return $string === $this->string;
}
public function indexOf($needle, int $offset = 0) : ?int
{
if ($needle instanceof AbstractString) {
$needle = $needle->string;
} elseif (\is_array($needle) || $needle instanceof \Traversable) {
return parent::indexOf($needle, $offset);
} else {
$needle = (string) $needle;
}
$form = null === $this->ignoreCase ? \Normalizer::NFD : \Normalizer::NFC;
\normalizer_is_normalized($needle, $form) ?: ($needle = \normalizer_normalize($needle, $form));
if ('' === $needle || \false === $needle) {
return null;
}
try {
$i = $this->ignoreCase ? \grapheme_stripos($this->string, $needle, $offset) : \grapheme_strpos($this->string, $needle, $offset);
} catch (\ValueError $e) {
return null;
}
return \false === $i ? null : $i;
}
public function indexOfLast($needle, int $offset = 0) : ?int
{
if ($needle instanceof AbstractString) {
$needle = $needle->string;
} elseif (\is_array($needle) || $needle instanceof \Traversable) {
return parent::indexOfLast($needle, $offset);
} else {
$needle = (string) $needle;
}
$form = null === $this->ignoreCase ? \Normalizer::NFD : \Normalizer::NFC;
\normalizer_is_normalized($needle, $form) ?: ($needle = \normalizer_normalize($needle, $form));
if ('' === $needle || \false === $needle) {
return null;
}
$string = $this->string;
if (0 > $offset) {
// workaround https://bugs.php.net/74264
if (0 > ($offset += \grapheme_strlen($needle))) {
$string = \grapheme_substr($string, 0, $offset);
}
$offset = 0;
}
$i = $this->ignoreCase ? \grapheme_strripos($string, $needle, $offset) : \grapheme_strrpos($string, $needle, $offset);
return \false === $i ? null : $i;
}
public function join(array $strings, ?string $lastGlue = null) : AbstractString
{
$str = parent::join($strings, $lastGlue);
\normalizer_is_normalized($str->string) ?: ($str->string = \normalizer_normalize($str->string));
return $str;
}
public function length() : int
{
return \grapheme_strlen($this->string);
}
/**
* @return static
*/
public function normalize(int $form = self::NFC) : parent
{
$str = clone $this;
if (\in_array($form, [self::NFC, self::NFKC], \true)) {
\normalizer_is_normalized($str->string, $form) ?: ($str->string = \normalizer_normalize($str->string, $form));
} elseif (!\in_array($form, [self::NFD, self::NFKD], \true)) {
throw new InvalidArgumentException('Unsupported normalization form.');
} elseif (!\normalizer_is_normalized($str->string, $form)) {
$str->string = \normalizer_normalize($str->string, $form);
$str->ignoreCase = null;
}
return $str;
}
public function prepend(string ...$prefix) : AbstractString
{
$str = clone $this;
$str->string = (1 >= \count($prefix) ? $prefix[0] ?? '' : \implode('', $prefix)) . $this->string;
\normalizer_is_normalized($str->string) ?: ($str->string = \normalizer_normalize($str->string));
if (\false === $str->string) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
return $str;
}
public function replace(string $from, string $to) : AbstractString
{
$str = clone $this;
\normalizer_is_normalized($from) ?: ($from = \normalizer_normalize($from));
if ('' !== $from && \false !== $from) {
$tail = $str->string;
$result = '';
$indexOf = $this->ignoreCase ? 'grapheme_stripos' : 'grapheme_strpos';
while ('' !== $tail && \false !== ($i = $indexOf($tail, $from))) {
$slice = \grapheme_substr($tail, 0, $i);
$result .= $slice . $to;
$tail = \substr($tail, \strlen($slice) + \strlen($from));
}
$str->string = $result . $tail;
\normalizer_is_normalized($str->string) ?: ($str->string = \normalizer_normalize($str->string));
if (\false === $str->string) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
}
return $str;
}
public function replaceMatches(string $fromRegexp, $to) : AbstractString
{
$str = parent::replaceMatches($fromRegexp, $to);
\normalizer_is_normalized($str->string) ?: ($str->string = \normalizer_normalize($str->string));
return $str;
}
public function slice(int $start = 0, ?int $length = null) : AbstractString
{
$str = clone $this;
if (\PHP_VERSION_ID < 80000 && 0 > $start && \grapheme_strlen($this->string) < -$start) {
$start = 0;
}
$str->string = (string) \grapheme_substr($this->string, $start, $length ?? 2147483647);
return $str;
}
public function splice(string $replacement, int $start = 0, ?int $length = null) : AbstractString
{
$str = clone $this;
if (\PHP_VERSION_ID < 80000 && 0 > $start && \grapheme_strlen($this->string) < -$start) {
$start = 0;
}
$start = $start ? \strlen(\grapheme_substr($this->string, 0, $start)) : 0;
$length = $length ? \strlen(\grapheme_substr($this->string, $start, $length ?? 2147483647)) : $length;
$str->string = \substr_replace($this->string, $replacement, $start, $length ?? 2147483647);
\normalizer_is_normalized($str->string) ?: ($str->string = \normalizer_normalize($str->string));
if (\false === $str->string) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
return $str;
}
public function split(string $delimiter, ?int $limit = null, ?int $flags = null) : array
{
if (1 > ($limit = $limit ?? 2147483647)) {
throw new InvalidArgumentException('Split limit must be a positive integer.');
}
if ('' === $delimiter) {
throw new InvalidArgumentException('Split delimiter is empty.');
}
if (null !== $flags) {
return parent::split($delimiter . 'u', $limit, $flags);
}
\normalizer_is_normalized($delimiter) ?: ($delimiter = \normalizer_normalize($delimiter));
if (\false === $delimiter) {
throw new InvalidArgumentException('Split delimiter is not a valid UTF-8 string.');
}
$str = clone $this;
$tail = $this->string;
$chunks = [];
$indexOf = $this->ignoreCase ? 'grapheme_stripos' : 'grapheme_strpos';
while (1 < $limit && \false !== ($i = $indexOf($tail, $delimiter))) {
$str->string = \grapheme_substr($tail, 0, $i);
$chunks[] = clone $str;
$tail = \substr($tail, \strlen($str->string) + \strlen($delimiter));
--$limit;
}
$str->string = $tail;
$chunks[] = clone $str;
return $chunks;
}
public function startsWith($prefix) : bool
{
if ($prefix instanceof AbstractString) {
$prefix = $prefix->string;
} elseif (\is_array($prefix) || $prefix instanceof \Traversable) {
return parent::startsWith($prefix);
} else {
$prefix = (string) $prefix;
}
$form = null === $this->ignoreCase ? \Normalizer::NFD : \Normalizer::NFC;
\normalizer_is_normalized($prefix, $form) ?: ($prefix = \normalizer_normalize($prefix, $form));
if ('' === $prefix || \false === $prefix) {
return \false;
}
if ($this->ignoreCase) {
return 0 === \mb_stripos(\grapheme_extract($this->string, \strlen($prefix), \GRAPHEME_EXTR_MAXBYTES), $prefix, 0, 'UTF-8');
}
return $prefix === \grapheme_extract($this->string, \strlen($prefix), \GRAPHEME_EXTR_MAXBYTES);
}
public function __wakeup()
{
if (!\is_string($this->string)) {
throw new \BadMethodCallException('Cannot unserialize ' . __CLASS__);
}
\normalizer_is_normalized($this->string) ?: ($this->string = \normalizer_normalize($this->string));
}
public function __clone()
{
if (null === $this->ignoreCase) {
\normalizer_is_normalized($this->string) ?: ($this->string = \normalizer_normalize($this->string));
}
$this->ignoreCase = \false;
}
}
<?php
namespace _PHPStan_6dcda722c;
/*
* This file has been auto-generated by the Symfony String Component for internal use.
*
* Unicode version: 15.1.0
* Date: 2023-09-13T11:47:13+00:00
*/
return [[768, 879], [1155, 1159], [1160, 1161], [1425, 1469], [1471, 1471], [1473, 1474], [1476, 1477], [1479, 1479], [1552, 1562], [1611, 1631], [1648, 1648], [1750, 1756], [1759, 1764], [1767, 1768], [1770, 1773], [1809, 1809], [1840, 1866], [1958, 1968], [2027, 2035], [2045, 2045], [2070, 2073], [2075, 2083], [2085, 2087], [2089, 2093], [2137, 2139], [2200, 2207], [2250, 2273], [2275, 2306], [2362, 2362], [2364, 2364], [2369, 2376], [2381, 2381], [2385, 2391], [2402, 2403], [2433, 2433], [2492, 2492], [2497, 2500], [2509, 2509], [2530, 2531], [2558, 2558], [2561, 2562], [2620, 2620], [2625, 2626], [2631, 2632], [2635, 2637], [2641, 2641], [2672, 2673], [2677, 2677], [2689, 2690], [2748, 2748], [2753, 2757], [2759, 2760], [2765, 2765], [2786, 2787], [2810, 2815], [2817, 2817], [2876, 2876], [2879, 2879], [2881, 2884], [2893, 2893], [2901, 2902], [2914, 2915], [2946, 2946], [3008, 3008], [3021, 3021], [3072, 3072], [3076, 3076], [3132, 3132], [3134, 3136], [3142, 3144], [3146, 3149], [3157, 3158], [3170, 3171], [3201, 3201], [3260, 3260], [3263, 3263], [3270, 3270], [3276, 3277], [3298, 3299], [3328, 3329], [3387, 3388], [3393, 3396], [3405, 3405], [3426, 3427], [3457, 3457], [3530, 3530], [3538, 3540], [3542, 3542], [3633, 3633], [3636, 3642], [3655, 3662], [3761, 3761], [3764, 3772], [3784, 3790], [3864, 3865], [3893, 3893], [3895, 3895], [3897, 3897], [3953, 3966], [3968, 3972], [3974, 3975], [3981, 3991], [3993, 4028], [4038, 4038], [4141, 4144], [4146, 4151], [4153, 4154], [4157, 4158], [4184, 4185], [4190, 4192], [4209, 4212], [4226, 4226], [4229, 4230], [4237, 4237], [4253, 4253], [4957, 4959], [5906, 5908], [5938, 5939], [5970, 5971], [6002, 6003], [6068, 6069], [6071, 6077], [6086, 6086], [6089, 6099], [6109, 6109], [6155, 6157], [6159, 6159], [6277, 6278], [6313, 6313], [6432, 6434], [6439, 6440], [6450, 6450], [6457, 6459], [6679, 6680], [6683, 6683], [6742, 6742], [6744, 6750], [6752, 6752], [6754, 6754], [6757, 6764], [6771, 6780], [6783, 6783], [6832, 6845], [6846, 6846], [6847, 6862], [6912, 6915], [6964, 6964], [6966, 6970], [6972, 6972], [6978, 6978], [7019, 7027], [7040, 7041], [7074, 7077], [7080, 7081], [7083, 7085], [7142, 7142], [7144, 7145], [7149, 7149], [7151, 7153], [7212, 7219], [7222, 7223], [7376, 7378], [7380, 7392], [7394, 7400], [7405, 7405], [7412, 7412], [7416, 7417], [7616, 7679], [8400, 8412], [8413, 8416], [8417, 8417], [8418, 8420], [8421, 8432], [11503, 11505], [11647, 11647], [11744, 11775], [12330, 12333], [12441, 12442], [42607, 42607], [42608, 42610], [42612, 42621], [42654, 42655], [42736, 42737], [43010, 43010], [43014, 43014], [43019, 43019], [43045, 43046], [43052, 43052], [43204, 43205], [43232, 43249], [43263, 43263], [43302, 43309], [43335, 43345], [43392, 43394], [43443, 43443], [43446, 43449], [43452, 43453], [43493, 43493], [43561, 43566], [43569, 43570], [43573, 43574], [43587, 43587], [43596, 43596], [43644, 43644], [43696, 43696], [43698, 43700], [43703, 43704], [43710, 43711], [43713, 43713], [43756, 43757], [43766, 43766], [44005, 44005], [44008, 44008], [44013, 44013], [64286, 64286], [65024, 65039], [65056, 65071], [66045, 66045], [66272, 66272], [66422, 66426], [68097, 68099], [68101, 68102], [68108, 68111], [68152, 68154], [68159, 68159], [68325, 68326], [68900, 68903], [69291, 69292], [69373, 69375], [69446, 69456], [69506, 69509], [69633, 69633], [69688, 69702], [69744, 69744], [69747, 69748], [69759, 69761], [69811, 69814], [69817, 69818], [69826, 69826], [69888, 69890], [69927, 69931], [69933, 69940], [70003, 70003], [70016, 70017], [70070, 70078], [70089, 70092], [70095, 70095], [70191, 70193], [70196, 70196], [70198, 70199], [70206, 70206], [70209, 70209], [70367, 70367], [70371, 70378], [70400, 70401], [70459, 70460], [70464, 70464], [70502, 70508], [70512, 70516], [70712, 70719], [70722, 70724], [70726, 70726], [70750, 70750], [70835, 70840], [70842, 70842], [70847, 70848], [70850, 70851], [71090, 71093], [71100, 71101], [71103, 71104], [71132, 71133], [71219, 71226], [71229, 71229], [71231, 71232], [71339, 71339], [71341, 71341], [71344, 71349], [71351, 71351], [71453, 71455], [71458, 71461], [71463, 71467], [71727, 71735], [71737, 71738], [71995, 71996], [71998, 71998], [72003, 72003], [72148, 72151], [72154, 72155], [72160, 72160], [72193, 72202], [72243, 72248], [72251, 72254], [72263, 72263], [72273, 72278], [72281, 72283], [72330, 72342], [72344, 72345], [72752, 72758], [72760, 72765], [72767, 72767], [72850, 72871], [72874, 72880], [72882, 72883], [72885, 72886], [73009, 73014], [73018, 73018], [73020, 73021], [73023, 73029], [73031, 73031], [73104, 73105], [73109, 73109], [73111, 73111], [73459, 73460], [73472, 73473], [73526, 73530], [73536, 73536], [73538, 73538], [78912, 78912], [78919, 78933], [92912, 92916], [92976, 92982], [94031, 94031], [94095, 94098], [94180, 94180], [113821, 113822], [118528, 118573], [118576, 118598], [119143, 119145], [119163, 119170], [119173, 119179], [119210, 119213], [119362, 119364], [121344, 121398], [121403, 121452], [121461, 121461], [121476, 121476], [121499, 121503], [121505, 121519], [122880, 122886], [122888, 122904], [122907, 122913], [122915, 122916], [122918, 122922], [123023, 123023], [123184, 123190], [123566, 123566], [123628, 123631], [124140, 124143], [125136, 125142], [125252, 125258], [917760, 917999]];
<?php
namespace _PHPStan_6dcda722c;
/*
* This file has been auto-generated by the Symfony String Component for internal use.
*
* Unicode version: 15.1.0
* Date: 2023-09-13T11:47:12+00:00
*/
return [[4352, 4447], [8986, 8987], [9001, 9001], [9002, 9002], [9193, 9196], [9200, 9200], [9203, 9203], [9725, 9726], [9748, 9749], [9800, 9811], [9855, 9855], [9875, 9875], [9889, 9889], [9898, 9899], [9917, 9918], [9924, 9925], [9934, 9934], [9940, 9940], [9962, 9962], [9970, 9971], [9973, 9973], [9978, 9978], [9981, 9981], [9989, 9989], [9994, 9995], [10024, 10024], [10060, 10060], [10062, 10062], [10067, 10069], [10071, 10071], [10133, 10135], [10160, 10160], [10175, 10175], [11035, 11036], [11088, 11088], [11093, 11093], [11904, 11929], [11931, 12019], [12032, 12245], [12272, 12287], [12288, 12288], [12289, 12291], [12292, 12292], [12293, 12293], [12294, 12294], [12295, 12295], [12296, 12296], [12297, 12297], [12298, 12298], [12299, 12299], [12300, 12300], [12301, 12301], [12302, 12302], [12303, 12303], [12304, 12304], [12305, 12305], [12306, 12307], [12308, 12308], [12309, 12309], [12310, 12310], [12311, 12311], [12312, 12312], [12313, 12313], [12314, 12314], [12315, 12315], [12316, 12316], [12317, 12317], [12318, 12319], [12320, 12320], [12321, 12329], [12330, 12333], [12334, 12335], [12336, 12336], [12337, 12341], [12342, 12343], [12344, 12346], [12347, 12347], [12348, 12348], [12349, 12349], [12350, 12350], [12353, 12438], [12441, 12442], [12443, 12444], [12445, 12446], [12447, 12447], [12448, 12448], [12449, 12538], [12539, 12539], [12540, 12542], [12543, 12543], [12549, 12591], [12593, 12686], [12688, 12689], [12690, 12693], [12694, 12703], [12704, 12735], [12736, 12771], [12783, 12783], [12784, 12799], [12800, 12830], [12832, 12841], [12842, 12871], [12880, 12880], [12881, 12895], [12896, 12927], [12928, 12937], [12938, 12976], [12977, 12991], [12992, 13055], [13056, 13311], [13312, 19903], [19968, 40959], [40960, 40980], [40981, 40981], [40982, 42124], [42128, 42182], [43360, 43388], [44032, 55203], [63744, 64109], [64110, 64111], [64112, 64217], [64218, 64255], [65040, 65046], [65047, 65047], [65048, 65048], [65049, 65049], [65072, 65072], [65073, 65074], [65075, 65076], [65077, 65077], [65078, 65078], [65079, 65079], [65080, 65080], [65081, 65081], [65082, 65082], [65083, 65083], [65084, 65084], [65085, 65085], [65086, 65086], [65087, 65087], [65088, 65088], [65089, 65089], [65090, 65090], [65091, 65091], [65092, 65092], [65093, 65094], [65095, 65095], [65096, 65096], [65097, 65100], [65101, 65103], [65104, 65106], [65108, 65111], [65112, 65112], [65113, 65113], [65114, 65114], [65115, 65115], [65116, 65116], [65117, 65117], [65118, 65118], [65119, 65121], [65122, 65122], [65123, 65123], [65124, 65126], [65128, 65128], [65129, 65129], [65130, 65131], [65281, 65283], [65284, 65284], [65285, 65287], [65288, 65288], [65289, 65289], [65290, 65290], [65291, 65291], [65292, 65292], [65293, 65293], [65294, 65295], [65296, 65305], [65306, 65307], [65308, 65310], [65311, 65312], [65313, 65338], [65339, 65339], [65340, 65340], [65341, 65341], [65342, 65342], [65343, 65343], [65344, 65344], [65345, 65370], [65371, 65371], [65372, 65372], [65373, 65373], [65374, 65374], [65375, 65375], [65376, 65376], [65504, 65505], [65506, 65506], [65507, 65507], [65508, 65508], [65509, 65510], [94176, 94177], [94178, 94178], [94179, 94179], [94180, 94180], [94192, 94193], [94208, 100343], [100352, 101119], [101120, 101589], [101632, 101640], [110576, 110579], [110581, 110587], [110589, 110590], [110592, 110847], [110848, 110882], [110898, 110898], [110928, 110930], [110933, 110933], [110948, 110951], [110960, 111355], [126980, 126980], [127183, 127183], [127374, 127374], [127377, 127386], [127488, 127490], [127504, 127547], [127552, 127560], [127568, 127569], [127584, 127589], [127744, 127776], [127789, 127797], [127799, 127868], [127870, 127891], [127904, 127946], [127951, 127955], [127968, 127984], [127988, 127988], [127992, 127994], [127995, 127999], [128000, 128062], [128064, 128064], [128066, 128252], [128255, 128317], [128331, 128334], [128336, 128359], [128378, 128378], [128405, 128406], [128420, 128420], [128507, 128511], [128512, 128591], [128640, 128709], [128716, 128716], [128720, 128722], [128725, 128727], [128732, 128735], [128747, 128748], [128756, 128764], [128992, 129003], [129008, 129008], [129292, 129338], [129340, 129349], [129351, 129535], [129648, 129660], [129664, 129672], [129680, 129725], [129727, 129733], [129742, 129755], [129760, 129768], [129776, 129784], [131072, 173791], [173792, 173823], [173824, 177977], [177978, 177983], [177984, 178205], [178206, 178207], [178208, 183969], [183970, 183983], [183984, 191456], [191457, 191471], [191472, 192093], [192094, 194559], [194560, 195101], [195102, 195103], [195104, 196605], [196608, 201546], [201547, 201551], [201552, 205743], [205744, 262141]];
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String;
if (!\function_exists(u::class)) {
function u(?string $string = '') : UnicodeString
{
return new UnicodeString($string ?? '');
}
}
if (!\function_exists(b::class)) {
function b(?string $string = '') : ByteString
{
return new ByteString($string ?? '');
}
}
if (!\function_exists(s::class)) {
/**
* @return UnicodeString|ByteString
*/
function s(?string $string = '') : AbstractString
{
$string = $string ?? '';
return \preg_match('//u', $string) ? new UnicodeString($string) : new ByteString($string);
}
}
Copyright (c) 2019-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\ExceptionInterface;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\InvalidArgumentException;
/**
* Represents a string of Unicode code points encoded as UTF-8.
*
* @author Nicolas Grekas <p@tchwork.com>
* @author Hugo Hamon <hugohamon@neuf.fr>
*
* @throws ExceptionInterface
*/
class CodePointString extends AbstractUnicodeString
{
public function __construct(string $string = '')
{
if ('' !== $string && !\preg_match('//u', $string)) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
$this->string = $string;
}
public function append(string ...$suffix) : AbstractString
{
$str = clone $this;
$str->string .= 1 >= \count($suffix) ? $suffix[0] ?? '' : \implode('', $suffix);
if (!\preg_match('//u', $str->string)) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
return $str;
}
public function chunk(int $length = 1) : array
{
if (1 > $length) {
throw new InvalidArgumentException('The chunk length must be greater than zero.');
}
if ('' === $this->string) {
return [];
}
$rx = '/(';
while (65535 < $length) {
$rx .= '.{65535}';
$length -= 65535;
}
$rx .= '.{' . $length . '})/us';
$str = clone $this;
$chunks = [];
foreach (\preg_split($rx, $this->string, -1, \PREG_SPLIT_DELIM_CAPTURE | \PREG_SPLIT_NO_EMPTY) as $chunk) {
$str->string = $chunk;
$chunks[] = clone $str;
}
return $chunks;
}
public function codePointsAt(int $offset) : array
{
$str = $offset ? $this->slice($offset, 1) : $this;
return '' === $str->string ? [] : [\mb_ord($str->string, 'UTF-8')];
}
public function endsWith($suffix) : bool
{
if ($suffix instanceof AbstractString) {
$suffix = $suffix->string;
} elseif (\is_array($suffix) || $suffix instanceof \Traversable) {
return parent::endsWith($suffix);
} else {
$suffix = (string) $suffix;
}
if ('' === $suffix || !\preg_match('//u', $suffix)) {
return \false;
}
if ($this->ignoreCase) {
return \preg_match('{' . \preg_quote($suffix) . '$}iuD', $this->string);
}
return \strlen($this->string) >= \strlen($suffix) && 0 === \substr_compare($this->string, $suffix, -\strlen($suffix));
}
public function equalsTo($string) : bool
{
if ($string instanceof AbstractString) {
$string = $string->string;
} elseif (\is_array($string) || $string instanceof \Traversable) {
return parent::equalsTo($string);
} else {
$string = (string) $string;
}
if ('' !== $string && $this->ignoreCase) {
return \strlen($string) === \strlen($this->string) && 0 === \mb_stripos($this->string, $string, 0, 'UTF-8');
}
return $string === $this->string;
}
public function indexOf($needle, int $offset = 0) : ?int
{
if ($needle instanceof AbstractString) {
$needle = $needle->string;
} elseif (\is_array($needle) || $needle instanceof \Traversable) {
return parent::indexOf($needle, $offset);
} else {
$needle = (string) $needle;
}
if ('' === $needle) {
return null;
}
$i = $this->ignoreCase ? \mb_stripos($this->string, $needle, $offset, 'UTF-8') : \mb_strpos($this->string, $needle, $offset, 'UTF-8');
return \false === $i ? null : $i;
}
public function indexOfLast($needle, int $offset = 0) : ?int
{
if ($needle instanceof AbstractString) {
$needle = $needle->string;
} elseif (\is_array($needle) || $needle instanceof \Traversable) {
return parent::indexOfLast($needle, $offset);
} else {
$needle = (string) $needle;
}
if ('' === $needle) {
return null;
}
$i = $this->ignoreCase ? \mb_strripos($this->string, $needle, $offset, 'UTF-8') : \mb_strrpos($this->string, $needle, $offset, 'UTF-8');
return \false === $i ? null : $i;
}
public function length() : int
{
return \mb_strlen($this->string, 'UTF-8');
}
public function prepend(string ...$prefix) : AbstractString
{
$str = clone $this;
$str->string = (1 >= \count($prefix) ? $prefix[0] ?? '' : \implode('', $prefix)) . $this->string;
if (!\preg_match('//u', $str->string)) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
return $str;
}
public function replace(string $from, string $to) : AbstractString
{
$str = clone $this;
if ('' === $from || !\preg_match('//u', $from)) {
return $str;
}
if ('' !== $to && !\preg_match('//u', $to)) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
if ($this->ignoreCase) {
$str->string = \implode($to, \preg_split('{' . \preg_quote($from) . '}iuD', $this->string));
} else {
$str->string = \str_replace($from, $to, $this->string);
}
return $str;
}
public function slice(int $start = 0, ?int $length = null) : AbstractString
{
$str = clone $this;
$str->string = \mb_substr($this->string, $start, $length, 'UTF-8');
return $str;
}
public function splice(string $replacement, int $start = 0, ?int $length = null) : AbstractString
{
if (!\preg_match('//u', $replacement)) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
$str = clone $this;
$start = $start ? \strlen(\mb_substr($this->string, 0, $start, 'UTF-8')) : 0;
$length = $length ? \strlen(\mb_substr($this->string, $start, $length, 'UTF-8')) : $length;
$str->string = \substr_replace($this->string, $replacement, $start, $length ?? \PHP_INT_MAX);
return $str;
}
public function split(string $delimiter, ?int $limit = null, ?int $flags = null) : array
{
if (1 > ($limit = $limit ?? \PHP_INT_MAX)) {
throw new InvalidArgumentException('Split limit must be a positive integer.');
}
if ('' === $delimiter) {
throw new InvalidArgumentException('Split delimiter is empty.');
}
if (null !== $flags) {
return parent::split($delimiter . 'u', $limit, $flags);
}
if (!\preg_match('//u', $delimiter)) {
throw new InvalidArgumentException('Split delimiter is not a valid UTF-8 string.');
}
$str = clone $this;
$chunks = $this->ignoreCase ? \preg_split('{' . \preg_quote($delimiter) . '}iuD', $this->string, $limit) : \explode($delimiter, $this->string, $limit);
foreach ($chunks as &$chunk) {
$str->string = $chunk;
$chunk = clone $str;
}
return $chunks;
}
public function startsWith($prefix) : bool
{
if ($prefix instanceof AbstractString) {
$prefix = $prefix->string;
} elseif (\is_array($prefix) || $prefix instanceof \Traversable) {
return parent::startsWith($prefix);
} else {
$prefix = (string) $prefix;
}
if ('' === $prefix || !\preg_match('//u', $prefix)) {
return \false;
}
if ($this->ignoreCase) {
return 0 === \mb_stripos($this->string, $prefix, 0, 'UTF-8');
}
return 0 === \strncmp($this->string, $prefix, \strlen($prefix));
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String;
/**
* A string whose value is computed lazily by a callback.
*
* @author Nicolas Grekas <p@tchwork.com>
*/
class LazyString implements \Stringable, \JsonSerializable
{
private $value;
/**
* @param callable|array $callback A callable or a [Closure, method] lazy-callable
*
* @return static
*/
public static function fromCallable($callback, ...$arguments) : self
{
if (!\is_callable($callback) && !(\is_array($callback) && isset($callback[0]) && $callback[0] instanceof \Closure && 2 >= \count($callback))) {
throw new \TypeError(\sprintf('Argument 1 passed to "%s()" must be a callable or a [Closure, method] lazy-callable, "%s" given.', __METHOD__, \get_debug_type($callback)));
}
$lazyString = new static();
$lazyString->value = static function () use(&$callback, &$arguments, &$value) : string {
if (null !== $arguments) {
if (!\is_callable($callback)) {
$callback[0] = $callback[0]();
$callback[1] = $callback[1] ?? '__invoke';
}
$value = $callback(...$arguments);
$callback = self::getPrettyName($callback);
$arguments = null;
}
return $value ?? '';
};
return $lazyString;
}
/**
* @param string|int|float|bool|\Stringable $value
*
* @return static
*/
public static function fromStringable($value) : self
{
if (!self::isStringable($value)) {
throw new \TypeError(\sprintf('Argument 1 passed to "%s()" must be a scalar or a stringable object, "%s" given.', __METHOD__, \get_debug_type($value)));
}
if (\is_object($value)) {
return static::fromCallable([$value, '__toString']);
}
$lazyString = new static();
$lazyString->value = (string) $value;
return $lazyString;
}
/**
* Tells whether the provided value can be cast to string.
*/
public static final function isStringable($value) : bool
{
return \is_string($value) || $value instanceof self || (\is_object($value) ? \method_exists($value, '__toString') : \is_scalar($value));
}
/**
* Casts scalars and stringable objects to strings.
*
* @param object|string|int|float|bool $value
*
* @throws \TypeError When the provided value is not stringable
*/
public static final function resolve($value) : string
{
return $value;
}
/**
* @return string
*/
public function __toString()
{
if (\is_string($this->value)) {
return $this->value;
}
try {
return $this->value = ($this->value)();
} catch (\Throwable $e) {
if (\TypeError::class === \get_class($e) && __FILE__ === $e->getFile()) {
$type = \explode(', ', $e->getMessage());
$type = \substr(\array_pop($type), 0, -\strlen(' returned'));
$r = new \ReflectionFunction($this->value);
$callback = $r->getStaticVariables()['callback'];
$e = new \TypeError(\sprintf('Return value of %s() passed to %s::fromCallable() must be of the type string, %s returned.', $callback, static::class, $type));
}
if (\PHP_VERSION_ID < 70400) {
// leverage the ErrorHandler component with graceful fallback when it's not available
return \trigger_error($e, \E_USER_ERROR);
}
throw $e;
}
}
public function __sleep() : array
{
$this->__toString();
return ['value'];
}
public function jsonSerialize() : string
{
return $this->__toString();
}
private function __construct()
{
}
private static function getPrettyName(callable $callback) : string
{
if (\is_string($callback)) {
return $callback;
}
if (\is_array($callback)) {
$class = \is_object($callback[0]) ? \get_debug_type($callback[0]) : $callback[0];
$method = $callback[1];
} elseif ($callback instanceof \Closure) {
$r = new \ReflectionFunction($callback);
if (\str_contains($r->name, '{closure') || !($class = \PHP_VERSION_ID >= 80111 ? $r->getClosureCalledClass() : $r->getClosureScopeClass())) {
return $r->name;
}
$class = $class->name;
$method = $r->name;
} else {
$class = \get_debug_type($callback);
$method = '__invoke';
}
return $class . '::' . $method;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String\Exception;
class RuntimeException extends \RuntimeException implements ExceptionInterface
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String\Exception;
interface ExceptionInterface extends \Throwable
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String\Exception;
class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String\Slugger;
use _PHPStan_6dcda722c\Symfony\Component\String\AbstractUnicodeString;
use _PHPStan_6dcda722c\Symfony\Component\String\UnicodeString;
use _PHPStan_6dcda722c\Symfony\Contracts\Translation\LocaleAwareInterface;
if (!\interface_exists(LocaleAwareInterface::class)) {
throw new \LogicException('You cannot use the "Symfony\\Component\\String\\Slugger\\AsciiSlugger" as the "symfony/translation-contracts" package is not installed. Try running "composer require symfony/translation-contracts".');
}
/**
* @author Titouan Galopin <galopintitouan@gmail.com>
*/
class AsciiSlugger implements SluggerInterface, LocaleAwareInterface
{
private const LOCALE_TO_TRANSLITERATOR_ID = ['am' => 'Amharic-Latin', 'ar' => 'Arabic-Latin', 'az' => 'Azerbaijani-Latin', 'be' => 'Belarusian-Latin', 'bg' => 'Bulgarian-Latin', 'bn' => 'Bengali-Latin', 'de' => 'de-ASCII', 'el' => 'Greek-Latin', 'fa' => 'Persian-Latin', 'he' => 'Hebrew-Latin', 'hy' => 'Armenian-Latin', 'ka' => 'Georgian-Latin', 'kk' => 'Kazakh-Latin', 'ky' => 'Kirghiz-Latin', 'ko' => 'Korean-Latin', 'mk' => 'Macedonian-Latin', 'mn' => 'Mongolian-Latin', 'or' => 'Oriya-Latin', 'ps' => 'Pashto-Latin', 'ru' => 'Russian-Latin', 'sr' => 'Serbian-Latin', 'sr_Cyrl' => 'Serbian-Latin', 'th' => 'Thai-Latin', 'tk' => 'Turkmen-Latin', 'uk' => 'Ukrainian-Latin', 'uz' => 'Uzbek-Latin', 'zh' => 'Han-Latin'];
private $defaultLocale;
private $symbolsMap = ['en' => ['@' => 'at', '&' => 'and']];
/**
* Cache of transliterators per locale.
*
* @var \Transliterator[]
*/
private $transliterators = [];
/**
* @param array|\Closure|null $symbolsMap
*/
public function __construct(?string $defaultLocale = null, $symbolsMap = null)
{
if (null !== $symbolsMap && !\is_array($symbolsMap) && !$symbolsMap instanceof \Closure) {
throw new \TypeError(\sprintf('Argument 2 passed to "%s()" must be array, Closure or null, "%s" given.', __METHOD__, \gettype($symbolsMap)));
}
$this->defaultLocale = $defaultLocale;
$this->symbolsMap = $symbolsMap ?? $this->symbolsMap;
}
/**
* {@inheritdoc}
*/
public function setLocale($locale)
{
$this->defaultLocale = $locale;
}
/**
* {@inheritdoc}
*/
public function getLocale()
{
return $this->defaultLocale;
}
/**
* {@inheritdoc}
*/
public function slug(string $string, string $separator = '-', ?string $locale = null) : AbstractUnicodeString
{
$locale = $locale ?? $this->defaultLocale;
$transliterator = [];
if ($locale && ('de' === $locale || 0 === \strpos($locale, 'de_'))) {
// Use the shortcut for German in UnicodeString::ascii() if possible (faster and no requirement on intl)
$transliterator = ['de-ASCII'];
} elseif (\function_exists('transliterator_transliterate') && $locale) {
$transliterator = (array) $this->createTransliterator($locale);
}
if ($this->symbolsMap instanceof \Closure) {
// If the symbols map is passed as a closure, there is no need to fallback to the parent locale
// as the closure can just provide substitutions for all locales of interest.
$symbolsMap = $this->symbolsMap;
\array_unshift($transliterator, static function ($s) use($symbolsMap, $locale) {
return $symbolsMap($s, $locale);
});
}
$unicodeString = (new UnicodeString($string))->ascii($transliterator);
if (\is_array($this->symbolsMap)) {
$map = null;
if (isset($this->symbolsMap[$locale])) {
$map = $this->symbolsMap[$locale];
} else {
$parent = self::getParentLocale($locale);
if ($parent && isset($this->symbolsMap[$parent])) {
$map = $this->symbolsMap[$parent];
}
}
if ($map) {
foreach ($map as $char => $replace) {
$unicodeString = $unicodeString->replace($char, ' ' . $replace . ' ');
}
}
}
return $unicodeString->replaceMatches('/[^A-Za-z0-9]++/', $separator)->trim($separator);
}
private function createTransliterator(string $locale) : ?\Transliterator
{
if (\array_key_exists($locale, $this->transliterators)) {
return $this->transliterators[$locale];
}
// Exact locale supported, cache and return
if ($id = self::LOCALE_TO_TRANSLITERATOR_ID[$locale] ?? null) {
return $this->transliterators[$locale] = \Transliterator::create($id . '/BGN') ?? \Transliterator::create($id);
}
// Locale not supported and no parent, fallback to any-latin
if (!($parent = self::getParentLocale($locale))) {
return $this->transliterators[$locale] = null;
}
// Try to use the parent locale (ie. try "de" for "de_AT") and cache both locales
if ($id = self::LOCALE_TO_TRANSLITERATOR_ID[$parent] ?? null) {
$transliterator = \Transliterator::create($id . '/BGN') ?? \Transliterator::create($id);
}
return $this->transliterators[$locale] = $this->transliterators[$parent] = $transliterator ?? null;
}
private static function getParentLocale(?string $locale) : ?string
{
if (!$locale) {
return null;
}
if (\false === ($str = \strrchr($locale, '_'))) {
// no parent locale
return null;
}
return \substr($locale, 0, -\strlen($str));
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String\Slugger;
use _PHPStan_6dcda722c\Symfony\Component\String\AbstractUnicodeString;
/**
* Creates a URL-friendly slug from a given string.
*
* @author Titouan Galopin <galopintitouan@gmail.com>
*/
interface SluggerInterface
{
/**
* Creates a slug for the given string and locale, using appropriate transliteration when needed.
*/
public function slug(string $string, string $separator = '-', ?string $locale = null) : AbstractUnicodeString;
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\ExceptionInterface;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\RuntimeException;
/**
* Represents a binary-safe string of bytes.
*
* @author Nicolas Grekas <p@tchwork.com>
* @author Hugo Hamon <hugohamon@neuf.fr>
*
* @throws ExceptionInterface
*/
class ByteString extends AbstractString
{
private const ALPHABET_ALPHANUMERIC = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
public function __construct(string $string = '')
{
$this->string = $string;
}
/*
* The following method was derived from code of the Hack Standard Library (v4.40 - 2020-05-03)
*
* https://github.com/hhvm/hsl/blob/80a42c02f036f72a42f0415e80d6b847f4bf62d5/src/random/private.php#L16
*
* Code subject to the MIT license (https://github.com/hhvm/hsl/blob/master/LICENSE).
*
* Copyright (c) 2004-2020, Facebook, Inc. (https://www.facebook.com/)
*/
public static function fromRandom(int $length = 16, ?string $alphabet = null) : self
{
if ($length <= 0) {
throw new InvalidArgumentException(\sprintf('A strictly positive length is expected, "%d" given.', $length));
}
$alphabet = $alphabet ?? self::ALPHABET_ALPHANUMERIC;
$alphabetSize = \strlen($alphabet);
$bits = (int) \ceil(\log($alphabetSize, 2.0));
if ($bits <= 0 || $bits > 56) {
throw new InvalidArgumentException('The length of the alphabet must in the [2^1, 2^56] range.');
}
$ret = '';
while ($length > 0) {
$urandomLength = (int) \ceil(2 * $length * $bits / 8.0);
$data = \random_bytes($urandomLength);
$unpackedData = 0;
$unpackedBits = 0;
for ($i = 0; $i < $urandomLength && $length > 0; ++$i) {
// Unpack 8 bits
$unpackedData = $unpackedData << 8 | \ord($data[$i]);
$unpackedBits += 8;
// While we have enough bits to select a character from the alphabet, keep
// consuming the random data
for (; $unpackedBits >= $bits && $length > 0; $unpackedBits -= $bits) {
$index = $unpackedData & (1 << $bits) - 1;
$unpackedData >>= $bits;
// Unfortunately, the alphabet size is not necessarily a power of two.
// Worst case, it is 2^k + 1, which means we need (k+1) bits and we
// have around a 50% chance of missing as k gets larger
if ($index < $alphabetSize) {
$ret .= $alphabet[$index];
--$length;
}
}
}
}
return new static($ret);
}
public function bytesAt(int $offset) : array
{
$str = $this->string[$offset] ?? '';
return '' === $str ? [] : [\ord($str)];
}
public function append(string ...$suffix) : parent
{
$str = clone $this;
$str->string .= 1 >= \count($suffix) ? $suffix[0] ?? '' : \implode('', $suffix);
return $str;
}
public function camel() : parent
{
$str = clone $this;
$parts = \explode(' ', \trim(\ucwords(\preg_replace('/[^a-zA-Z0-9\\x7f-\\xff]++/', ' ', $this->string))));
$parts[0] = 1 !== \strlen($parts[0]) && \ctype_upper($parts[0]) ? $parts[0] : \lcfirst($parts[0]);
$str->string = \implode('', $parts);
return $str;
}
public function chunk(int $length = 1) : array
{
if (1 > $length) {
throw new InvalidArgumentException('The chunk length must be greater than zero.');
}
if ('' === $this->string) {
return [];
}
$str = clone $this;
$chunks = [];
foreach (\str_split($this->string, $length) as $chunk) {
$str->string = $chunk;
$chunks[] = clone $str;
}
return $chunks;
}
public function endsWith($suffix) : bool
{
if ($suffix instanceof parent) {
$suffix = $suffix->string;
} elseif (\is_array($suffix) || $suffix instanceof \Traversable) {
return parent::endsWith($suffix);
} else {
$suffix = (string) $suffix;
}
return '' !== $suffix && \strlen($this->string) >= \strlen($suffix) && 0 === \substr_compare($this->string, $suffix, -\strlen($suffix), null, $this->ignoreCase);
}
public function equalsTo($string) : bool
{
if ($string instanceof parent) {
$string = $string->string;
} elseif (\is_array($string) || $string instanceof \Traversable) {
return parent::equalsTo($string);
} else {
$string = (string) $string;
}
if ('' !== $string && $this->ignoreCase) {
return 0 === \strcasecmp($string, $this->string);
}
return $string === $this->string;
}
public function folded() : parent
{
$str = clone $this;
$str->string = \strtolower($str->string);
return $str;
}
public function indexOf($needle, int $offset = 0) : ?int
{
if ($needle instanceof parent) {
$needle = $needle->string;
} elseif (\is_array($needle) || $needle instanceof \Traversable) {
return parent::indexOf($needle, $offset);
} else {
$needle = (string) $needle;
}
if ('' === $needle) {
return null;
}
$i = $this->ignoreCase ? \stripos($this->string, $needle, $offset) : \strpos($this->string, $needle, $offset);
return \false === $i ? null : $i;
}
public function indexOfLast($needle, int $offset = 0) : ?int
{
if ($needle instanceof parent) {
$needle = $needle->string;
} elseif (\is_array($needle) || $needle instanceof \Traversable) {
return parent::indexOfLast($needle, $offset);
} else {
$needle = (string) $needle;
}
if ('' === $needle) {
return null;
}
$i = $this->ignoreCase ? \strripos($this->string, $needle, $offset) : \strrpos($this->string, $needle, $offset);
return \false === $i ? null : $i;
}
public function isUtf8() : bool
{
return '' === $this->string || \preg_match('//u', $this->string);
}
public function join(array $strings, ?string $lastGlue = null) : parent
{
$str = clone $this;
$tail = null !== $lastGlue && 1 < \count($strings) ? $lastGlue . \array_pop($strings) : '';
$str->string = \implode($this->string, $strings) . $tail;
return $str;
}
public function length() : int
{
return \strlen($this->string);
}
public function lower() : parent
{
$str = clone $this;
$str->string = \strtolower($str->string);
return $str;
}
public function match(string $regexp, int $flags = 0, int $offset = 0) : array
{
$match = (\PREG_PATTERN_ORDER | \PREG_SET_ORDER) & $flags ? 'preg_match_all' : 'preg_match';
if ($this->ignoreCase) {
$regexp .= 'i';
}
\set_error_handler(static function ($t, $m) {
throw new InvalidArgumentException($m);
});
try {
if (\false === $match($regexp, $this->string, $matches, $flags | \PREG_UNMATCHED_AS_NULL, $offset)) {
$lastError = \preg_last_error();
foreach (\get_defined_constants(\true)['pcre'] as $k => $v) {
if ($lastError === $v && '_ERROR' === \substr($k, -6)) {
throw new RuntimeException('Matching failed with ' . $k . '.');
}
}
throw new RuntimeException('Matching failed with unknown error code.');
}
} finally {
\restore_error_handler();
}
return $matches;
}
public function padBoth(int $length, string $padStr = ' ') : parent
{
$str = clone $this;
$str->string = \str_pad($this->string, $length, $padStr, \STR_PAD_BOTH);
return $str;
}
public function padEnd(int $length, string $padStr = ' ') : parent
{
$str = clone $this;
$str->string = \str_pad($this->string, $length, $padStr, \STR_PAD_RIGHT);
return $str;
}
public function padStart(int $length, string $padStr = ' ') : parent
{
$str = clone $this;
$str->string = \str_pad($this->string, $length, $padStr, \STR_PAD_LEFT);
return $str;
}
public function prepend(string ...$prefix) : parent
{
$str = clone $this;
$str->string = (1 >= \count($prefix) ? $prefix[0] ?? '' : \implode('', $prefix)) . $str->string;
return $str;
}
public function replace(string $from, string $to) : parent
{
$str = clone $this;
if ('' !== $from) {
$str->string = $this->ignoreCase ? \str_ireplace($from, $to, $this->string) : \str_replace($from, $to, $this->string);
}
return $str;
}
public function replaceMatches(string $fromRegexp, $to) : parent
{
if ($this->ignoreCase) {
$fromRegexp .= 'i';
}
if (\is_array($to)) {
if (!\is_callable($to)) {
throw new \TypeError(\sprintf('Argument 2 passed to "%s::replaceMatches()" must be callable, array given.', static::class));
}
$replace = 'preg_replace_callback';
} else {
$replace = $to instanceof \Closure ? 'preg_replace_callback' : 'preg_replace';
}
\set_error_handler(static function ($t, $m) {
throw new InvalidArgumentException($m);
});
try {
if (null === ($string = $replace($fromRegexp, $to, $this->string))) {
$lastError = \preg_last_error();
foreach (\get_defined_constants(\true)['pcre'] as $k => $v) {
if ($lastError === $v && '_ERROR' === \substr($k, -6)) {
throw new RuntimeException('Matching failed with ' . $k . '.');
}
}
throw new RuntimeException('Matching failed with unknown error code.');
}
} finally {
\restore_error_handler();
}
$str = clone $this;
$str->string = $string;
return $str;
}
public function reverse() : parent
{
$str = clone $this;
$str->string = \strrev($str->string);
return $str;
}
public function slice(int $start = 0, ?int $length = null) : parent
{
$str = clone $this;
$str->string = (string) \substr($this->string, $start, $length ?? \PHP_INT_MAX);
return $str;
}
public function snake() : parent
{
$str = clone $this;
$str->string = \str_replace(' ', '_', \strtolower(\preg_replace(['/([A-Z]+)([A-Z][a-z])/', '/([a-z\\d])([A-Z])/'], '\\1 \\2', $str->string)));
return $str;
}
public function splice(string $replacement, int $start = 0, ?int $length = null) : parent
{
$str = clone $this;
$str->string = \substr_replace($this->string, $replacement, $start, $length ?? \PHP_INT_MAX);
return $str;
}
public function split(string $delimiter, ?int $limit = null, ?int $flags = null) : array
{
if (1 > ($limit = $limit ?? \PHP_INT_MAX)) {
throw new InvalidArgumentException('Split limit must be a positive integer.');
}
if ('' === $delimiter) {
throw new InvalidArgumentException('Split delimiter is empty.');
}
if (null !== $flags) {
return parent::split($delimiter, $limit, $flags);
}
$str = clone $this;
$chunks = $this->ignoreCase ? \preg_split('{' . \preg_quote($delimiter) . '}iD', $this->string, $limit) : \explode($delimiter, $this->string, $limit);
foreach ($chunks as &$chunk) {
$str->string = $chunk;
$chunk = clone $str;
}
return $chunks;
}
public function startsWith($prefix) : bool
{
if ($prefix instanceof parent) {
$prefix = $prefix->string;
} elseif (!\is_string($prefix)) {
return parent::startsWith($prefix);
}
return '' !== $prefix && 0 === ($this->ignoreCase ? \strncasecmp($this->string, $prefix, \strlen($prefix)) : \strncmp($this->string, $prefix, \strlen($prefix)));
}
public function title(bool $allWords = \false) : parent
{
$str = clone $this;
$str->string = $allWords ? \ucwords($str->string) : \ucfirst($str->string);
return $str;
}
public function toUnicodeString(?string $fromEncoding = null) : UnicodeString
{
return new UnicodeString($this->toCodePointString($fromEncoding)->string);
}
public function toCodePointString(?string $fromEncoding = null) : CodePointString
{
$u = new CodePointString();
if (\in_array($fromEncoding, [null, 'utf8', 'utf-8', 'UTF8', 'UTF-8'], \true) && \preg_match('//u', $this->string)) {
$u->string = $this->string;
return $u;
}
\set_error_handler(static function ($t, $m) {
throw new InvalidArgumentException($m);
});
try {
try {
$validEncoding = \false !== \mb_detect_encoding($this->string, $fromEncoding ?? 'Windows-1252', \true);
} catch (InvalidArgumentException $e) {
if (!\function_exists('iconv')) {
throw $e;
}
$u->string = \iconv($fromEncoding ?? 'Windows-1252', 'UTF-8', $this->string);
return $u;
}
} finally {
\restore_error_handler();
}
if (!$validEncoding) {
throw new InvalidArgumentException(\sprintf('Invalid "%s" string.', $fromEncoding ?? 'Windows-1252'));
}
$u->string = \mb_convert_encoding($this->string, 'UTF-8', $fromEncoding ?? 'Windows-1252');
return $u;
}
public function trim(string $chars = " \t\n\r\x00\v\f") : parent
{
$str = clone $this;
$str->string = \trim($str->string, $chars);
return $str;
}
public function trimEnd(string $chars = " \t\n\r\x00\v\f") : parent
{
$str = clone $this;
$str->string = \rtrim($str->string, $chars);
return $str;
}
public function trimStart(string $chars = " \t\n\r\x00\v\f") : parent
{
$str = clone $this;
$str->string = \ltrim($str->string, $chars);
return $str;
}
public function upper() : parent
{
$str = clone $this;
$str->string = \strtoupper($str->string);
return $str;
}
public function width(bool $ignoreAnsiDecoration = \true) : int
{
$string = \preg_match('//u', $this->string) ? $this->string : \preg_replace('/[\\x80-\\xFF]/', '?', $this->string);
return (new CodePointString($string))->width($ignoreAnsiDecoration);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\ExceptionInterface;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\RuntimeException;
/**
* Represents a string of abstract Unicode characters.
*
* Unicode defines 3 types of "characters" (bytes, code points and grapheme clusters).
* This class is the abstract type to use as a type-hint when the logic you want to
* implement is Unicode-aware but doesn't care about code points vs grapheme clusters.
*
* @author Nicolas Grekas <p@tchwork.com>
*
* @throws ExceptionInterface
*/
abstract class AbstractUnicodeString extends AbstractString
{
public const NFC = \Normalizer::NFC;
public const NFD = \Normalizer::NFD;
public const NFKC = \Normalizer::NFKC;
public const NFKD = \Normalizer::NFKD;
// all ASCII letters sorted by typical frequency of occurrence
private const ASCII = " eiasntrolud][cmp'\ng|hv.fb,:=-q10C2*yx)(L9AS/P\"EjMIk3>5T<D4}B{8FwR67UGN;JzV#HOW_&!K?XQ%Y\\\tZ+~^\$@`\x00\x01\x02\x03\x04\x05\x06\x07\x08\v\f\r\x0e\x0f\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f";
// the subset of folded case mappings that is not in lower case mappings
private const FOLD_FROM = ['İ', 'µ', 'ſ', "ͅ", 'ς', 'ϐ', 'ϑ', 'ϕ', 'ϖ', 'ϰ', 'ϱ', 'ϵ', 'ẛ', "ι", 'ß', 'ʼn', 'ǰ', 'ΐ', 'ΰ', 'և', 'ẖ', 'ẗ', 'ẘ', 'ẙ', 'ẚ', 'ẞ', 'ὐ', 'ὒ', 'ὔ', 'ὖ', 'ᾀ', 'ᾁ', 'ᾂ', 'ᾃ', 'ᾄ', 'ᾅ', 'ᾆ', 'ᾇ', 'ᾈ', 'ᾉ', 'ᾊ', 'ᾋ', 'ᾌ', 'ᾍ', 'ᾎ', 'ᾏ', 'ᾐ', 'ᾑ', 'ᾒ', 'ᾓ', 'ᾔ', 'ᾕ', 'ᾖ', 'ᾗ', 'ᾘ', 'ᾙ', 'ᾚ', 'ᾛ', 'ᾜ', 'ᾝ', 'ᾞ', 'ᾟ', 'ᾠ', 'ᾡ', 'ᾢ', 'ᾣ', 'ᾤ', 'ᾥ', 'ᾦ', 'ᾧ', 'ᾨ', 'ᾩ', 'ᾪ', 'ᾫ', 'ᾬ', 'ᾭ', 'ᾮ', 'ᾯ', 'ᾲ', 'ᾳ', 'ᾴ', 'ᾶ', 'ᾷ', 'ᾼ', 'ῂ', 'ῃ', 'ῄ', 'ῆ', 'ῇ', 'ῌ', 'ῒ', 'ῖ', 'ῗ', 'ῢ', 'ῤ', 'ῦ', 'ῧ', 'ῲ', 'ῳ', 'ῴ', 'ῶ', 'ῷ', 'ῼ', 'ff', 'fi', 'fl', 'ffi', 'ffl', 'ſt', 'st', 'ﬓ', 'ﬔ', 'ﬕ', 'ﬖ', 'ﬗ'];
private const FOLD_TO = ['i̇', 'μ', 's', 'ι', 'σ', 'β', 'θ', 'φ', 'π', 'κ', 'ρ', 'ε', 'ṡ', 'ι', 'ss', 'ʼn', 'ǰ', 'ΐ', 'ΰ', 'եւ', 'ẖ', 'ẗ', 'ẘ', 'ẙ', 'aʾ', 'ss', 'ὐ', 'ὒ', 'ὔ', 'ὖ', 'ἀι', 'ἁι', 'ἂι', 'ἃι', 'ἄι', 'ἅι', 'ἆι', 'ἇι', 'ἀι', 'ἁι', 'ἂι', 'ἃι', 'ἄι', 'ἅι', 'ἆι', 'ἇι', 'ἠι', 'ἡι', 'ἢι', 'ἣι', 'ἤι', 'ἥι', 'ἦι', 'ἧι', 'ἠι', 'ἡι', 'ἢι', 'ἣι', 'ἤι', 'ἥι', 'ἦι', 'ἧι', 'ὠι', 'ὡι', 'ὢι', 'ὣι', 'ὤι', 'ὥι', 'ὦι', 'ὧι', 'ὠι', 'ὡι', 'ὢι', 'ὣι', 'ὤι', 'ὥι', 'ὦι', 'ὧι', 'ὰι', 'αι', 'άι', 'ᾶ', 'ᾶι', 'αι', 'ὴι', 'ηι', 'ήι', 'ῆ', 'ῆι', 'ηι', 'ῒ', 'ῖ', 'ῗ', 'ῢ', 'ῤ', 'ῦ', 'ῧ', 'ὼι', 'ωι', 'ώι', 'ῶ', 'ῶι', 'ωι', 'ff', 'fi', 'fl', 'ffi', 'ffl', 'st', 'st', 'մն', 'մե', 'մի', 'վն', 'մխ'];
// the subset of upper case mappings that map one code point to many code points
private const UPPER_FROM = ['ß', 'ff', 'fi', 'fl', 'ffi', 'ffl', 'ſt', 'st', 'և', 'ﬓ', 'ﬔ', 'ﬕ', 'ﬖ', 'ﬗ', 'ʼn', 'ΐ', 'ΰ', 'ǰ', 'ẖ', 'ẗ', 'ẘ', 'ẙ', 'ẚ', 'ὐ', 'ὒ', 'ὔ', 'ὖ', 'ᾶ', 'ῆ', 'ῒ', 'ΐ', 'ῖ', 'ῗ', 'ῢ', 'ΰ', 'ῤ', 'ῦ', 'ῧ', 'ῶ'];
private const UPPER_TO = ['SS', 'FF', 'FI', 'FL', 'FFI', 'FFL', 'ST', 'ST', 'ԵՒ', 'ՄՆ', 'ՄԵ', 'ՄԻ', 'ՎՆ', 'ՄԽ', 'ʼN', 'Ϊ́', 'Ϋ́', 'J̌', 'H̱', 'T̈', 'W̊', 'Y̊', 'Aʾ', 'Υ̓', 'Υ̓̀', 'Υ̓́', 'Υ̓͂', 'Α͂', 'Η͂', 'Ϊ̀', 'Ϊ́', 'Ι͂', 'Ϊ͂', 'Ϋ̀', 'Ϋ́', 'Ρ̓', 'Υ͂', 'Ϋ͂', 'Ω͂'];
// the subset of https://github.com/unicode-org/cldr/blob/master/common/transforms/Latin-ASCII.xml that is not in NFKD
private const TRANSLIT_FROM = ['Æ', 'Ð', 'Ø', 'Þ', 'ß', 'æ', 'ð', 'ø', 'þ', 'Đ', 'đ', 'Ħ', 'ħ', 'ı', 'ĸ', 'Ŀ', 'ŀ', 'Ł', 'ł', 'ʼn', 'Ŋ', 'ŋ', 'Œ', 'œ', 'Ŧ', 'ŧ', 'ƀ', 'Ɓ', 'Ƃ', 'ƃ', 'Ƈ', 'ƈ', 'Ɖ', 'Ɗ', 'Ƌ', 'ƌ', 'Ɛ', 'Ƒ', 'ƒ', 'Ɠ', 'ƕ', 'Ɩ', 'Ɨ', 'Ƙ', 'ƙ', 'ƚ', 'Ɲ', 'ƞ', 'Ƣ', 'ƣ', 'Ƥ', 'ƥ', 'ƫ', 'Ƭ', 'ƭ', 'Ʈ', 'Ʋ', 'Ƴ', 'ƴ', 'Ƶ', 'ƶ', 'DŽ', 'Dž', 'dž', 'Ǥ', 'ǥ', 'ȡ', 'Ȥ', 'ȥ', 'ȴ', 'ȵ', 'ȶ', 'ȷ', 'ȸ', 'ȹ', 'Ⱥ', 'Ȼ', 'ȼ', 'Ƚ', 'Ⱦ', 'ȿ', 'ɀ', 'Ƀ', 'Ʉ', 'Ɇ', 'ɇ', 'Ɉ', 'ɉ', 'Ɍ', 'ɍ', 'Ɏ', 'ɏ', 'ɓ', 'ɕ', 'ɖ', 'ɗ', 'ɛ', 'ɟ', 'ɠ', 'ɡ', 'ɢ', 'ɦ', 'ɧ', 'ɨ', 'ɪ', 'ɫ', 'ɬ', 'ɭ', 'ɱ', 'ɲ', 'ɳ', 'ɴ', 'ɶ', 'ɼ', 'ɽ', 'ɾ', 'ʀ', 'ʂ', 'ʈ', 'ʉ', 'ʋ', 'ʏ', 'ʐ', 'ʑ', 'ʙ', 'ʛ', 'ʜ', 'ʝ', 'ʟ', 'ʠ', 'ʣ', 'ʥ', 'ʦ', 'ʪ', 'ʫ', 'ᴀ', 'ᴁ', 'ᴃ', 'ᴄ', 'ᴅ', 'ᴆ', 'ᴇ', 'ᴊ', 'ᴋ', 'ᴌ', 'ᴍ', 'ᴏ', 'ᴘ', 'ᴛ', 'ᴜ', 'ᴠ', 'ᴡ', 'ᴢ', 'ᵫ', 'ᵬ', 'ᵭ', 'ᵮ', 'ᵯ', 'ᵰ', 'ᵱ', 'ᵲ', 'ᵳ', 'ᵴ', 'ᵵ', 'ᵶ', 'ᵺ', 'ᵻ', 'ᵽ', 'ᵾ', 'ᶀ', 'ᶁ', 'ᶂ', 'ᶃ', 'ᶄ', 'ᶅ', 'ᶆ', 'ᶇ', 'ᶈ', 'ᶉ', 'ᶊ', 'ᶌ', 'ᶍ', 'ᶎ', 'ᶏ', 'ᶑ', 'ᶒ', 'ᶓ', 'ᶖ', 'ᶙ', 'ẚ', 'ẜ', 'ẝ', 'ẞ', 'Ỻ', 'ỻ', 'Ỽ', 'ỽ', 'Ỿ', 'ỿ', '©', '®', '₠', '₢', '₣', '₤', '₧', '₺', '₹', 'ℌ', '℞', '㎧', '㎮', '㏆', '㏗', '㏞', '㏟', '¼', '½', '¾', '⅓', '⅔', '⅕', '⅖', '⅗', '⅘', '⅙', '⅚', '⅛', '⅜', '⅝', '⅞', '⅟', '〇', '‘', '’', '‚', '‛', '“', '”', '„', '‟', '′', '″', '〝', '〞', '«', '»', '‹', '›', '‐', '‑', '‒', '–', '—', '―', '︱', '︲', '﹘', '‖', '⁄', '⁅', '⁆', '⁎', '、', '。', '〈', '〉', '《', '》', '〔', '〕', '〘', '〙', '〚', '〛', '︑', '︒', '︹', '︺', '︽', '︾', '︿', '﹀', '﹑', '﹝', '﹞', '｟', '｠', '｡', '､', '×', '÷', '−', '∕', '∖', '∣', '∥', '≪', '≫', '⦅', '⦆'];
private const TRANSLIT_TO = ['AE', 'D', 'O', 'TH', 'ss', 'ae', 'd', 'o', 'th', 'D', 'd', 'H', 'h', 'i', 'q', 'L', 'l', 'L', 'l', '\'n', 'N', 'n', 'OE', 'oe', 'T', 't', 'b', 'B', 'B', 'b', 'C', 'c', 'D', 'D', 'D', 'd', 'E', 'F', 'f', 'G', 'hv', 'I', 'I', 'K', 'k', 'l', 'N', 'n', 'OI', 'oi', 'P', 'p', 't', 'T', 't', 'T', 'V', 'Y', 'y', 'Z', 'z', 'DZ', 'Dz', 'dz', 'G', 'g', 'd', 'Z', 'z', 'l', 'n', 't', 'j', 'db', 'qp', 'A', 'C', 'c', 'L', 'T', 's', 'z', 'B', 'U', 'E', 'e', 'J', 'j', 'R', 'r', 'Y', 'y', 'b', 'c', 'd', 'd', 'e', 'j', 'g', 'g', 'G', 'h', 'h', 'i', 'I', 'l', 'l', 'l', 'm', 'n', 'n', 'N', 'OE', 'r', 'r', 'r', 'R', 's', 't', 'u', 'v', 'Y', 'z', 'z', 'B', 'G', 'H', 'j', 'L', 'q', 'dz', 'dz', 'ts', 'ls', 'lz', 'A', 'AE', 'B', 'C', 'D', 'D', 'E', 'J', 'K', 'L', 'M', 'O', 'P', 'T', 'U', 'V', 'W', 'Z', 'ue', 'b', 'd', 'f', 'm', 'n', 'p', 'r', 'r', 's', 't', 'z', 'th', 'I', 'p', 'U', 'b', 'd', 'f', 'g', 'k', 'l', 'm', 'n', 'p', 'r', 's', 'v', 'x', 'z', 'a', 'd', 'e', 'e', 'i', 'u', 'a', 's', 's', 'SS', 'LL', 'll', 'V', 'v', 'Y', 'y', '(C)', '(R)', 'CE', 'Cr', 'Fr.', 'L.', 'Pts', 'TL', 'Rs', 'x', 'Rx', 'm/s', 'rad/s', 'C/kg', 'pH', 'V/m', 'A/m', ' 1/4', ' 1/2', ' 3/4', ' 1/3', ' 2/3', ' 1/5', ' 2/5', ' 3/5', ' 4/5', ' 1/6', ' 5/6', ' 1/8', ' 3/8', ' 5/8', ' 7/8', ' 1/', '0', '\'', '\'', ',', '\'', '"', '"', ',,', '"', '\'', '"', '"', '"', '<<', '>>', '<', '>', '-', '-', '-', '-', '-', '-', '-', '-', '-', '||', '/', '[', ']', '*', ',', '.', '<', '>', '<<', '>>', '[', ']', '[', ']', '[', ']', ',', '.', '[', ']', '<<', '>>', '<', '>', ',', '[', ']', '((', '))', '.', ',', '*', '/', '-', '/', '\\', '|', '||', '<<', '>>', '((', '))'];
private static $transliterators = [];
private static $tableZero;
private static $tableWide;
/**
* @return static
*/
public static function fromCodePoints(int ...$codes) : self
{
$string = '';
foreach ($codes as $code) {
if (0x80 > ($code %= 0x200000)) {
$string .= \chr($code);
} elseif (0x800 > $code) {
$string .= \chr(0xc0 | $code >> 6) . \chr(0x80 | $code & 0x3f);
} elseif (0x10000 > $code) {
$string .= \chr(0xe0 | $code >> 12) . \chr(0x80 | $code >> 6 & 0x3f) . \chr(0x80 | $code & 0x3f);
} else {
$string .= \chr(0xf0 | $code >> 18) . \chr(0x80 | $code >> 12 & 0x3f) . \chr(0x80 | $code >> 6 & 0x3f) . \chr(0x80 | $code & 0x3f);
}
}
return new static($string);
}
/**
* Generic UTF-8 to ASCII transliteration.
*
* Install the intl extension for best results.
*
* @param string[]|\Transliterator[]|\Closure[] $rules See "*-Latin" rules from Transliterator::listIDs()
*/
public function ascii(array $rules = []) : self
{
$str = clone $this;
$s = $str->string;
$str->string = '';
\array_unshift($rules, 'nfd');
$rules[] = 'latin-ascii';
if (\function_exists('transliterator_transliterate')) {
$rules[] = 'any-latin/bgn';
}
$rules[] = 'nfkd';
$rules[] = '[:nonspacing mark:] remove';
while (\strlen($s) - 1 > ($i = \strspn($s, self::ASCII))) {
if (0 < --$i) {
$str->string .= \substr($s, 0, $i);
$s = \substr($s, $i);
}
if (!($rule = \array_shift($rules))) {
$rules = [];
// An empty rule interrupts the next ones
}
if ($rule instanceof \Transliterator) {
$s = $rule->transliterate($s);
} elseif ($rule instanceof \Closure) {
$s = $rule($s);
} elseif ($rule) {
if ('nfd' === ($rule = \strtolower($rule))) {
\normalizer_is_normalized($s, self::NFD) ?: ($s = \normalizer_normalize($s, self::NFD));
} elseif ('nfkd' === $rule) {
\normalizer_is_normalized($s, self::NFKD) ?: ($s = \normalizer_normalize($s, self::NFKD));
} elseif ('[:nonspacing mark:] remove' === $rule) {
$s = \preg_replace('/\\p{Mn}++/u', '', $s);
} elseif ('latin-ascii' === $rule) {
$s = \str_replace(self::TRANSLIT_FROM, self::TRANSLIT_TO, $s);
} elseif ('de-ascii' === $rule) {
$s = \preg_replace("/([AUO])̈(?=\\p{Ll})/u", '$1e', $s);
$s = \str_replace(["ä", "ö", "ü", "Ä", "Ö", "Ü"], ['ae', 'oe', 'ue', 'AE', 'OE', 'UE'], $s);
} elseif (\function_exists('transliterator_transliterate')) {
if (null === ($transliterator = self::$transliterators[$rule] ?? (self::$transliterators[$rule] = \Transliterator::create($rule)))) {
if ('any-latin/bgn' === $rule) {
$rule = 'any-latin';
$transliterator = self::$transliterators[$rule] ?? (self::$transliterators[$rule] = \Transliterator::create($rule));
}
if (null === $transliterator) {
throw new InvalidArgumentException(\sprintf('Unknown transliteration rule "%s".', $rule));
}
self::$transliterators['any-latin/bgn'] = $transliterator;
}
$s = $transliterator->transliterate($s);
}
} elseif (!\function_exists('iconv')) {
$s = \preg_replace('/[^\\x00-\\x7F]/u', '?', $s);
} else {
$s = @\preg_replace_callback('/[^\\x00-\\x7F]/u', static function ($c) {
$c = (string) \iconv('UTF-8', 'ASCII//TRANSLIT', $c[0]);
if ('' === $c && '' === \iconv('UTF-8', 'ASCII//TRANSLIT', '²')) {
throw new \LogicException(\sprintf('"%s" requires a translit-able iconv implementation, try installing "gnu-libiconv" if you\'re using Alpine Linux.', static::class));
}
return 1 < \strlen($c) ? \ltrim($c, '\'`"^~') : ('' !== $c ? $c : '?');
}, $s);
}
}
$str->string .= $s;
return $str;
}
public function camel() : parent
{
$str = clone $this;
$str->string = \str_replace(' ', '', \preg_replace_callback('/\\b.(?![A-Z]{2,})/u', static function ($m) use(&$i) {
return 1 === ++$i ? 'İ' === $m[0] ? 'i̇' : \mb_strtolower($m[0], 'UTF-8') : \mb_convert_case($m[0], \MB_CASE_TITLE, 'UTF-8');
}, \preg_replace('/[^\\pL0-9]++/u', ' ', $this->string)));
return $str;
}
/**
* @return int[]
*/
public function codePointsAt(int $offset) : array
{
$str = $this->slice($offset, 1);
if ('' === $str->string) {
return [];
}
$codePoints = [];
foreach (\preg_split('//u', $str->string, -1, \PREG_SPLIT_NO_EMPTY) as $c) {
$codePoints[] = \mb_ord($c, 'UTF-8');
}
return $codePoints;
}
public function folded(bool $compat = \true) : parent
{
$str = clone $this;
if (!$compat || \PHP_VERSION_ID < 70300 || !\defined('Normalizer::NFKC_CF')) {
$str->string = \normalizer_normalize($str->string, $compat ? \Normalizer::NFKC : \Normalizer::NFC);
$str->string = \mb_strtolower(\str_replace(self::FOLD_FROM, self::FOLD_TO, $str->string), 'UTF-8');
} else {
$str->string = \normalizer_normalize($str->string, \Normalizer::NFKC_CF);
}
return $str;
}
public function join(array $strings, ?string $lastGlue = null) : parent
{
$str = clone $this;
$tail = null !== $lastGlue && 1 < \count($strings) ? $lastGlue . \array_pop($strings) : '';
$str->string = \implode($this->string, $strings) . $tail;
if (!\preg_match('//u', $str->string)) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
return $str;
}
public function lower() : parent
{
$str = clone $this;
$str->string = \mb_strtolower(\str_replace('İ', 'i̇', $str->string), 'UTF-8');
return $str;
}
public function match(string $regexp, int $flags = 0, int $offset = 0) : array
{
$match = (\PREG_PATTERN_ORDER | \PREG_SET_ORDER) & $flags ? 'preg_match_all' : 'preg_match';
if ($this->ignoreCase) {
$regexp .= 'i';
}
\set_error_handler(static function ($t, $m) {
throw new InvalidArgumentException($m);
});
try {
if (\false === $match($regexp . 'u', $this->string, $matches, $flags | \PREG_UNMATCHED_AS_NULL, $offset)) {
$lastError = \preg_last_error();
foreach (\get_defined_constants(\true)['pcre'] as $k => $v) {
if ($lastError === $v && '_ERROR' === \substr($k, -6)) {
throw new RuntimeException('Matching failed with ' . $k . '.');
}
}
throw new RuntimeException('Matching failed with unknown error code.');
}
} finally {
\restore_error_handler();
}
return $matches;
}
/**
* @return static
*/
public function normalize(int $form = self::NFC) : self
{
if (!\in_array($form, [self::NFC, self::NFD, self::NFKC, self::NFKD])) {
throw new InvalidArgumentException('Unsupported normalization form.');
}
$str = clone $this;
\normalizer_is_normalized($str->string, $form) ?: ($str->string = \normalizer_normalize($str->string, $form));
return $str;
}
public function padBoth(int $length, string $padStr = ' ') : parent
{
if ('' === $padStr || !\preg_match('//u', $padStr)) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
$pad = clone $this;
$pad->string = $padStr;
return $this->pad($length, $pad, \STR_PAD_BOTH);
}
public function padEnd(int $length, string $padStr = ' ') : parent
{
if ('' === $padStr || !\preg_match('//u', $padStr)) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
$pad = clone $this;
$pad->string = $padStr;
return $this->pad($length, $pad, \STR_PAD_RIGHT);
}
public function padStart(int $length, string $padStr = ' ') : parent
{
if ('' === $padStr || !\preg_match('//u', $padStr)) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
}
$pad = clone $this;
$pad->string = $padStr;
return $this->pad($length, $pad, \STR_PAD_LEFT);
}
public function replaceMatches(string $fromRegexp, $to) : parent
{
if ($this->ignoreCase) {
$fromRegexp .= 'i';
}
if (\is_array($to) || $to instanceof \Closure) {
if (!\is_callable($to)) {
throw new \TypeError(\sprintf('Argument 2 passed to "%s::replaceMatches()" must be callable, array given.', static::class));
}
$replace = 'preg_replace_callback';
$to = static function (array $m) use($to) : string {
$to = $to($m);
if ('' !== $to && (!\is_string($to) || !\preg_match('//u', $to))) {
throw new InvalidArgumentException('Replace callback must return a valid UTF-8 string.');
}
return $to;
};
} elseif ('' !== $to && !\preg_match('//u', $to)) {
throw new InvalidArgumentException('Invalid UTF-8 string.');
} else {
$replace = 'preg_replace';
}
\set_error_handler(static function ($t, $m) {
throw new InvalidArgumentException($m);
});
try {
if (null === ($string = $replace($fromRegexp . 'u', $to, $this->string))) {
$lastError = \preg_last_error();
foreach (\get_defined_constants(\true)['pcre'] as $k => $v) {
if ($lastError === $v && '_ERROR' === \substr($k, -6)) {
throw new RuntimeException('Matching failed with ' . $k . '.');
}
}
throw new RuntimeException('Matching failed with unknown error code.');
}
} finally {
\restore_error_handler();
}
$str = clone $this;
$str->string = $string;
return $str;
}
public function reverse() : parent
{
$str = clone $this;
$str->string = \implode('', \array_reverse(\preg_split('/(\\X)/u', $str->string, -1, \PREG_SPLIT_DELIM_CAPTURE | \PREG_SPLIT_NO_EMPTY)));
return $str;
}
public function snake() : parent
{
$str = clone $this;
$str->string = \str_replace(' ', '_', \mb_strtolower(\preg_replace(['/(\\p{Lu}+)(\\p{Lu}\\p{Ll})/u', '/([\\p{Ll}0-9])(\\p{Lu})/u'], '\\1 \\2', $str->string), 'UTF-8'));
return $str;
}
public function title(bool $allWords = \false) : parent
{
$str = clone $this;
$limit = $allWords ? -1 : 1;
$str->string = \preg_replace_callback('/\\b./u', static function (array $m) : string {
return \mb_convert_case($m[0], \MB_CASE_TITLE, 'UTF-8');
}, $str->string, $limit);
return $str;
}
public function trim(string $chars = " \t\n\r\x00\v\f ") : parent
{
if (" \t\n\r\x00\v\f " !== $chars && !\preg_match('//u', $chars)) {
throw new InvalidArgumentException('Invalid UTF-8 chars.');
}
$chars = \preg_quote($chars);
$str = clone $this;
$str->string = \preg_replace("{^[{$chars}]++|[{$chars}]++\$}uD", '', $str->string);
return $str;
}
public function trimEnd(string $chars = " \t\n\r\x00\v\f ") : parent
{
if (" \t\n\r\x00\v\f " !== $chars && !\preg_match('//u', $chars)) {
throw new InvalidArgumentException('Invalid UTF-8 chars.');
}
$chars = \preg_quote($chars);
$str = clone $this;
$str->string = \preg_replace("{[{$chars}]++\$}uD", '', $str->string);
return $str;
}
public function trimPrefix($prefix) : parent
{
if (!$this->ignoreCase) {
return parent::trimPrefix($prefix);
}
$str = clone $this;
if ($prefix instanceof \Traversable) {
$prefix = \iterator_to_array($prefix, \false);
} elseif ($prefix instanceof parent) {
$prefix = $prefix->string;
}
$prefix = \implode('|', \array_map('preg_quote', (array) $prefix));
$str->string = \preg_replace("{^(?:{$prefix})}iuD", '', $this->string);
return $str;
}
public function trimStart(string $chars = " \t\n\r\x00\v\f ") : parent
{
if (" \t\n\r\x00\v\f " !== $chars && !\preg_match('//u', $chars)) {
throw new InvalidArgumentException('Invalid UTF-8 chars.');
}
$chars = \preg_quote($chars);
$str = clone $this;
$str->string = \preg_replace("{^[{$chars}]++}uD", '', $str->string);
return $str;
}
public function trimSuffix($suffix) : parent
{
if (!$this->ignoreCase) {
return parent::trimSuffix($suffix);
}
$str = clone $this;
if ($suffix instanceof \Traversable) {
$suffix = \iterator_to_array($suffix, \false);
} elseif ($suffix instanceof parent) {
$suffix = $suffix->string;
}
$suffix = \implode('|', \array_map('preg_quote', (array) $suffix));
$str->string = \preg_replace("{(?:{$suffix})\$}iuD", '', $this->string);
return $str;
}
public function upper() : parent
{
$str = clone $this;
$str->string = \mb_strtoupper($str->string, 'UTF-8');
if (\PHP_VERSION_ID < 70300) {
$str->string = \str_replace(self::UPPER_FROM, self::UPPER_TO, $str->string);
}
return $str;
}
public function width(bool $ignoreAnsiDecoration = \true) : int
{
$width = 0;
$s = \str_replace(["\x00", "\x05", "\x07"], '', $this->string);
if (\false !== \strpos($s, "\r")) {
$s = \str_replace(["\r\n", "\r"], "\n", $s);
}
if (!$ignoreAnsiDecoration) {
$s = \preg_replace('/[\\p{Cc}\\x7F]++/u', '', $s);
}
foreach (\explode("\n", $s) as $s) {
if ($ignoreAnsiDecoration) {
$s = \preg_replace('/(?:\\x1B(?:
\\[ [\\x30-\\x3F]*+ [\\x20-\\x2F]*+ [\\x40-\\x7E]
| [P\\]X^_] .*? \\x1B\\\\
| [\\x41-\\x7E]
)|[\\p{Cc}\\x7F]++)/xu', '', $s);
}
$lineWidth = $this->wcswidth($s);
if ($lineWidth > $width) {
$width = $lineWidth;
}
}
return $width;
}
/**
* @return static
*/
private function pad(int $len, self $pad, int $type) : parent
{
$sLen = $this->length();
if ($len <= $sLen) {
return clone $this;
}
$padLen = $pad->length();
$freeLen = $len - $sLen;
$len = $freeLen % $padLen;
switch ($type) {
case \STR_PAD_RIGHT:
return $this->append(\str_repeat($pad->string, \intdiv($freeLen, $padLen)) . ($len ? $pad->slice(0, $len) : ''));
case \STR_PAD_LEFT:
return $this->prepend(\str_repeat($pad->string, \intdiv($freeLen, $padLen)) . ($len ? $pad->slice(0, $len) : ''));
case \STR_PAD_BOTH:
$freeLen /= 2;
$rightLen = \ceil($freeLen);
$len = $rightLen % $padLen;
$str = $this->append(\str_repeat($pad->string, \intdiv($rightLen, $padLen)) . ($len ? $pad->slice(0, $len) : ''));
$leftLen = \floor($freeLen);
$len = $leftLen % $padLen;
return $str->prepend(\str_repeat($pad->string, \intdiv($leftLen, $padLen)) . ($len ? $pad->slice(0, $len) : ''));
default:
throw new InvalidArgumentException('Invalid padding type.');
}
}
/**
* Based on https://github.com/jquast/wcwidth, a Python implementation of https://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c.
*/
private function wcswidth(string $string) : int
{
$width = 0;
foreach (\preg_split('//u', $string, -1, \PREG_SPLIT_NO_EMPTY) as $c) {
$codePoint = \mb_ord($c, 'UTF-8');
if (0 === $codePoint || 0x34f === $codePoint || 0x200b <= $codePoint && 0x200f >= $codePoint || 0x2028 === $codePoint || 0x2029 === $codePoint || 0x202a <= $codePoint && 0x202e >= $codePoint || 0x2060 <= $codePoint && 0x2063 >= $codePoint) {
continue;
}
// Non printable characters
if (32 > $codePoint || 0x7f <= $codePoint && 0xa0 > $codePoint) {
return -1;
}
if (null === self::$tableZero) {
self::$tableZero = (require __DIR__ . '/Resources/data/wcswidth_table_zero.php');
}
if ($codePoint >= self::$tableZero[0][0] && $codePoint <= self::$tableZero[$ubound = \count(self::$tableZero) - 1][1]) {
$lbound = 0;
while ($ubound >= $lbound) {
$mid = \floor(($lbound + $ubound) / 2);
if ($codePoint > self::$tableZero[$mid][1]) {
$lbound = $mid + 1;
} elseif ($codePoint < self::$tableZero[$mid][0]) {
$ubound = $mid - 1;
} else {
continue 2;
}
}
}
if (null === self::$tableWide) {
self::$tableWide = (require __DIR__ . '/Resources/data/wcswidth_table_wide.php');
}
if ($codePoint >= self::$tableWide[0][0] && $codePoint <= self::$tableWide[$ubound = \count(self::$tableWide) - 1][1]) {
$lbound = 0;
while ($ubound >= $lbound) {
$mid = \floor(($lbound + $ubound) / 2);
if ($codePoint > self::$tableWide[$mid][1]) {
$lbound = $mid + 1;
} elseif ($codePoint < self::$tableWide[$mid][0]) {
$ubound = $mid - 1;
} else {
$width += 2;
continue 2;
}
}
}
++$width;
}
return $width;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String\Inflector;
/**
* French inflector.
*
* This class does only inflect nouns; not adjectives nor composed words like "soixante-dix".
*/
final class FrenchInflector implements InflectorInterface
{
/**
* A list of all rules for pluralise.
*
* @see https://la-conjugaison.nouvelobs.com/regles/grammaire/le-pluriel-des-noms-121.php
*/
private const PLURALIZE_REGEXP = [
// First entry: regexp
// Second entry: replacement
// Words finishing with "s", "x" or "z" are invariables
// Les mots finissant par "s", "x" ou "z" sont invariables
['/(s|x|z)$/i', '\\1'],
// Words finishing with "eau" are pluralized with a "x"
// Les mots finissant par "eau" prennent tous un "x" au pluriel
['/(eau)$/i', '\\1x'],
// Words finishing with "au" are pluralized with a "x" excepted "landau"
// Les mots finissant par "au" prennent un "x" au pluriel sauf "landau"
['/^(landau)$/i', '\\1s'],
['/(au)$/i', '\\1x'],
// Words finishing with "eu" are pluralized with a "x" excepted "pneu", "bleu", "émeu"
// Les mots finissant en "eu" prennent un "x" au pluriel sauf "pneu", "bleu", "émeu"
['/^(pneu|bleu|émeu)$/i', '\\1s'],
['/(eu)$/i', '\\1x'],
// Words finishing with "al" are pluralized with a "aux" excepted
// Les mots finissant en "al" se terminent en "aux" sauf
['/^(bal|carnaval|caracal|chacal|choral|corral|étal|festival|récital|val)$/i', '\\1s'],
['/al$/i', '\\1aux'],
// Aspirail, bail, corail, émail, fermail, soupirail, travail, vantail et vitrail font leur pluriel en -aux
['/^(aspir|b|cor|ém|ferm|soupir|trav|vant|vitr)ail$/i', '\\1aux'],
// Bijou, caillou, chou, genou, hibou, joujou et pou qui prennent un x au pluriel
['/^(bij|caill|ch|gen|hib|jouj|p)ou$/i', '\\1oux'],
// Invariable words
['/^(cinquante|soixante|mille)$/i', '\\1'],
// French titles
['/^(mon|ma)(sieur|dame|demoiselle|seigneur)$/', '_PHPStan_6dcda722c\\mes\\2s'],
['/^(Mon|Ma)(sieur|dame|demoiselle|seigneur)$/', '_PHPStan_6dcda722c\\Mes\\2s'],
];
/**
* A list of all rules for singularize.
*/
private const SINGULARIZE_REGEXP = [
// First entry: regexp
// Second entry: replacement
// Aspirail, bail, corail, émail, fermail, soupirail, travail, vantail et vitrail font leur pluriel en -aux
['/((aspir|b|cor|ém|ferm|soupir|trav|vant|vitr))aux$/i', '\\1ail'],
// Words finishing with "eau" are pluralized with a "x"
// Les mots finissant par "eau" prennent tous un "x" au pluriel
['/(eau)x$/i', '\\1'],
// Words finishing with "al" are pluralized with a "aux" expected
// Les mots finissant en "al" se terminent en "aux" sauf
['/(amir|anim|arsen|boc|can|capit|capor|chev|crist|génér|hopit|hôpit|idé|journ|littor|loc|m|mét|minér|princip|radic|termin)aux$/i', '\\1al'],
// Words finishing with "au" are pluralized with a "x" excepted "landau"
// Les mots finissant par "au" prennent un "x" au pluriel sauf "landau"
['/(au)x$/i', '\\1'],
// Words finishing with "eu" are pluralized with a "x" excepted "pneu", "bleu", "émeu"
// Les mots finissant en "eu" prennent un "x" au pluriel sauf "pneu", "bleu", "émeu"
['/(eu)x$/i', '\\1'],
// Words finishing with "ou" are pluralized with a "s" excepted bijou, caillou, chou, genou, hibou, joujou, pou
// Les mots finissant par "ou" prennent un "s" sauf bijou, caillou, chou, genou, hibou, joujou, pou
['/(bij|caill|ch|gen|hib|jouj|p)oux$/i', '\\1ou'],
// French titles
['/^mes(dame|demoiselle)s$/', '_PHPStan_6dcda722c\\ma\\1'],
['/^Mes(dame|demoiselle)s$/', '_PHPStan_6dcda722c\\Ma\\1'],
['/^mes(sieur|seigneur)s$/', '_PHPStan_6dcda722c\\mon\\1'],
['/^Mes(sieur|seigneur)s$/', '_PHPStan_6dcda722c\\Mon\\1'],
// Default rule
['/s$/i', ''],
];
/**
* A list of words which should not be inflected.
* This list is only used by singularize.
*/
private const UNINFLECTED = '/^(abcès|accès|abus|albatros|anchois|anglais|autobus|bois|brebis|carquois|cas|chas|colis|concours|corps|cours|cyprès|décès|devis|discours|dos|embarras|engrais|entrelacs|excès|fils|fois|gâchis|gars|glas|héros|intrus|jars|jus|kermès|lacis|legs|lilas|marais|mars|matelas|mépris|mets|mois|mors|obus|os|palais|paradis|parcours|pardessus|pays|plusieurs|poids|pois|pouls|printemps|processus|progrès|puits|pus|rabais|radis|recors|recours|refus|relais|remords|remous|rictus|rhinocéros|repas|rubis|sans|sas|secours|sens|souris|succès|talus|tapis|tas|taudis|temps|tiers|univers|velours|verglas|vernis|virus)$/i';
/**
* {@inheritdoc}
*/
public function singularize(string $plural) : array
{
if ($this->isInflectedWord($plural)) {
return [$plural];
}
foreach (self::SINGULARIZE_REGEXP as $rule) {
[$regexp, $replace] = $rule;
if (1 === \preg_match($regexp, $plural)) {
return [\preg_replace($regexp, $replace, $plural)];
}
}
return [$plural];
}
/**
* {@inheritdoc}
*/
public function pluralize(string $singular) : array
{
if ($this->isInflectedWord($singular)) {
return [$singular];
}
foreach (self::PLURALIZE_REGEXP as $rule) {
[$regexp, $replace] = $rule;
if (1 === \preg_match($regexp, $singular)) {
return [\preg_replace($regexp, $replace, $singular)];
}
}
return [$singular . 's'];
}
private function isInflectedWord(string $word) : bool
{
return 1 === \preg_match(self::UNINFLECTED, $word);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String\Inflector;
final class EnglishInflector implements InflectorInterface
{
/**
* Map English plural to singular suffixes.
*
* @see http://english-zone.com/spelling/plurals.html
*/
private const PLURAL_MAP = [
// First entry: plural suffix, reversed
// Second entry: length of plural suffix
// Third entry: Whether the suffix may succeed a vowel
// Fourth entry: Whether the suffix may succeed a consonant
// Fifth entry: singular suffix, normal
// bacteria (bacterium)
['airetcab', 8, \true, \true, 'bacterium'],
// corpora (corpus)
['aroproc', 7, \true, \true, 'corpus'],
// criteria (criterion)
['airetirc', 8, \true, \true, 'criterion'],
// curricula (curriculum)
['alucirruc', 9, \true, \true, 'curriculum'],
// genera (genus)
['areneg', 6, \true, \true, 'genus'],
// media (medium)
['aidem', 5, \true, \true, 'medium'],
// memoranda (memorandum)
['adnaromem', 9, \true, \true, 'memorandum'],
// phenomena (phenomenon)
['anemonehp', 9, \true, \true, 'phenomenon'],
// strata (stratum)
['atarts', 6, \true, \true, 'stratum'],
// nebulae (nebula)
['ea', 2, \true, \true, 'a'],
// services (service)
['secivres', 8, \true, \true, 'service'],
// mice (mouse), lice (louse)
['eci', 3, \false, \true, 'ouse'],
// geese (goose)
['esee', 4, \false, \true, 'oose'],
// fungi (fungus), alumni (alumnus), syllabi (syllabus), radii (radius)
['i', 1, \true, \true, 'us'],
// men (man), women (woman)
['nem', 3, \true, \true, 'man'],
// children (child)
['nerdlihc', 8, \true, \true, 'child'],
// oxen (ox)
['nexo', 4, \false, \false, 'ox'],
// indices (index), appendices (appendix), prices (price)
['seci', 4, \false, \true, ['ex', 'ix', 'ice']],
// codes (code)
['sedoc', 5, \false, \true, 'code'],
// selfies (selfie)
['seifles', 7, \true, \true, 'selfie'],
// zombies (zombie)
['seibmoz', 7, \true, \true, 'zombie'],
// movies (movie)
['seivom', 6, \true, \true, 'movie'],
// names (name)
['seman', 5, \true, \false, 'name'],
// conspectuses (conspectus), prospectuses (prospectus)
['sesutcep', 8, \true, \true, 'pectus'],
// feet (foot)
['teef', 4, \true, \true, 'foot'],
// geese (goose)
['eseeg', 5, \true, \true, 'goose'],
// teeth (tooth)
['hteet', 5, \true, \true, 'tooth'],
// news (news)
['swen', 4, \true, \true, 'news'],
// series (series)
['seires', 6, \true, \true, 'series'],
// babies (baby)
['sei', 3, \false, \true, 'y'],
// accesses (access), addresses (address), kisses (kiss)
['sess', 4, \true, \false, 'ss'],
// statuses (status)
['sesutats', 8, \true, \true, 'status'],
// analyses (analysis), ellipses (ellipsis), fungi (fungus),
// neuroses (neurosis), theses (thesis), emphases (emphasis),
// oases (oasis), crises (crisis), houses (house), bases (base),
// atlases (atlas)
['ses', 3, \true, \true, ['s', 'se', 'sis']],
// objectives (objective), alternative (alternatives)
['sevit', 5, \true, \true, 'tive'],
// drives (drive)
['sevird', 6, \false, \true, 'drive'],
// lives (life), wives (wife)
['sevi', 4, \false, \true, 'ife'],
// moves (move)
['sevom', 5, \true, \true, 'move'],
// hooves (hoof), dwarves (dwarf), elves (elf), leaves (leaf), caves (cave), staves (staff)
['sev', 3, \true, \true, ['f', 've', 'ff']],
// axes (axis), axes (ax), axes (axe)
['sexa', 4, \false, \false, ['ax', 'axe', 'axis']],
// indexes (index), matrixes (matrix)
['sex', 3, \true, \false, 'x'],
// quizzes (quiz)
['sezz', 4, \true, \false, 'z'],
// bureaus (bureau)
['suae', 4, \false, \true, 'eau'],
// fees (fee), trees (tree), employees (employee)
['see', 3, \true, \true, 'ee'],
// edges (edge)
['segd', 4, \true, \true, 'dge'],
// roses (rose), garages (garage), cassettes (cassette),
// waltzes (waltz), heroes (hero), bushes (bush), arches (arch),
// shoes (shoe)
['se', 2, \true, \true, ['', 'e']],
// status (status)
['sutats', 6, \true, \true, 'status'],
// tags (tag)
['s', 1, \true, \true, ''],
// chateaux (chateau)
['xuae', 4, \false, \true, 'eau'],
// people (person)
['elpoep', 6, \true, \true, 'person'],
];
/**
* Map English singular to plural suffixes.
*
* @see http://english-zone.com/spelling/plurals.html
*/
private const SINGULAR_MAP = [
// First entry: singular suffix, reversed
// Second entry: length of singular suffix
// Third entry: Whether the suffix may succeed a vowel
// Fourth entry: Whether the suffix may succeed a consonant
// Fifth entry: plural suffix, normal
// axes (axis)
['sixa', 4, \false, \false, 'axes'],
// criterion (criteria)
['airetirc', 8, \false, \false, 'criterion'],
// nebulae (nebula)
['aluben', 6, \false, \false, 'nebulae'],
// children (child)
['dlihc', 5, \true, \true, 'children'],
// prices (price)
['eci', 3, \false, \true, 'ices'],
// services (service)
['ecivres', 7, \true, \true, 'services'],
// lives (life), wives (wife)
['efi', 3, \false, \true, 'ives'],
// selfies (selfie)
['eifles', 6, \true, \true, 'selfies'],
// movies (movie)
['eivom', 5, \true, \true, 'movies'],
// lice (louse)
['esuol', 5, \false, \true, 'lice'],
// mice (mouse)
['esuom', 5, \false, \true, 'mice'],
// geese (goose)
['esoo', 4, \false, \true, 'eese'],
// houses (house), bases (base)
['es', 2, \true, \true, 'ses'],
// geese (goose)
['esoog', 5, \true, \true, 'geese'],
// caves (cave)
['ev', 2, \true, \true, 'ves'],
// drives (drive)
['evird', 5, \false, \true, 'drives'],
// objectives (objective), alternative (alternatives)
['evit', 4, \true, \true, 'tives'],
// moves (move)
['evom', 4, \true, \true, 'moves'],
// staves (staff)
['ffats', 5, \true, \true, 'staves'],
// hooves (hoof), dwarves (dwarf), elves (elf), leaves (leaf)
['ff', 2, \true, \true, 'ffs'],
// hooves (hoof), dwarves (dwarf), elves (elf), leaves (leaf)
['f', 1, \true, \true, ['fs', 'ves']],
// arches (arch)
['hc', 2, \true, \true, 'ches'],
// bushes (bush)
['hs', 2, \true, \true, 'shes'],
// teeth (tooth)
['htoot', 5, \true, \true, 'teeth'],
// albums (album)
['mubla', 5, \true, \true, 'albums'],
// bacteria (bacterium), curricula (curriculum), media (medium), memoranda (memorandum), phenomena (phenomenon), strata (stratum)
['mu', 2, \true, \true, 'a'],
// men (man), women (woman)
['nam', 3, \true, \true, 'men'],
// people (person)
['nosrep', 6, \true, \true, ['persons', 'people']],
// criteria (criterion)
['noiretirc', 9, \true, \true, 'criteria'],
// phenomena (phenomenon)
['nonemonehp', 10, \true, \true, 'phenomena'],
// echoes (echo)
['ohce', 4, \true, \true, 'echoes'],
// heroes (hero)
['oreh', 4, \true, \true, 'heroes'],
// atlases (atlas)
['salta', 5, \true, \true, 'atlases'],
// aliases (alias)
['saila', 5, \true, \true, 'aliases'],
// irises (iris)
['siri', 4, \true, \true, 'irises'],
// analyses (analysis), ellipses (ellipsis), neuroses (neurosis)
// theses (thesis), emphases (emphasis), oases (oasis),
// crises (crisis)
['sis', 3, \true, \true, 'ses'],
// accesses (access), addresses (address), kisses (kiss)
['ss', 2, \true, \false, 'sses'],
// syllabi (syllabus)
['suballys', 8, \true, \true, 'syllabi'],
// buses (bus)
['sub', 3, \true, \true, 'buses'],
// circuses (circus)
['suc', 3, \true, \true, 'cuses'],
// hippocampi (hippocampus)
['supmacoppih', 11, \false, \false, 'hippocampi'],
// campuses (campus)
['sup', 3, \true, \true, 'puses'],
// status (status)
['sutats', 6, \true, \true, ['status', 'statuses']],
// conspectuses (conspectus), prospectuses (prospectus)
['sutcep', 6, \true, \true, 'pectuses'],
// fungi (fungus), alumni (alumnus), syllabi (syllabus), radii (radius)
['su', 2, \true, \true, 'i'],
// news (news)
['swen', 4, \true, \true, 'news'],
// feet (foot)
['toof', 4, \true, \true, 'feet'],
// chateaux (chateau), bureaus (bureau)
['uae', 3, \false, \true, ['eaus', 'eaux']],
// oxen (ox)
['xo', 2, \false, \false, 'oxen'],
// hoaxes (hoax)
['xaoh', 4, \true, \false, 'hoaxes'],
// indices (index)
['xedni', 5, \false, \true, ['indicies', 'indexes']],
// boxes (box)
['xo', 2, \false, \true, 'oxes'],
// indexes (index), matrixes (matrix)
['x', 1, \true, \false, ['cies', 'xes']],
// appendices (appendix)
['xi', 2, \false, \true, 'ices'],
// babies (baby)
['y', 1, \false, \true, 'ies'],
// quizzes (quiz)
['ziuq', 4, \true, \false, 'quizzes'],
// waltzes (waltz)
['z', 1, \true, \true, 'zes'],
];
/**
* A list of words which should not be inflected, reversed.
*/
private const UNINFLECTED = [
'',
// data
'atad',
// deer
'reed',
// equipment
'tnempiuqe',
// feedback
'kcabdeef',
// fish
'hsif',
// health
'htlaeh',
// history
'yrotsih',
// info
'ofni',
// information
'noitamrofni',
// money
'yenom',
// moose
'esoom',
// series
'seires',
// sheep
'peehs',
// species
'seiceps',
// traffic
'ciffart',
// aircraft
'tfarcria',
// hardware
'erawdrah',
];
public function singularize(string $plural) : array
{
$pluralRev = \strrev($plural);
$lowerPluralRev = \strtolower($pluralRev);
$pluralLength = \strlen($lowerPluralRev);
// Check if the word is one which is not inflected, return early if so
if (\in_array($lowerPluralRev, self::UNINFLECTED, \true)) {
return [$plural];
}
// The outer loop iterates over the entries of the plural table
// The inner loop $j iterates over the characters of the plural suffix
// in the plural table to compare them with the characters of the actual
// given plural suffix
foreach (self::PLURAL_MAP as $map) {
$suffix = $map[0];
$suffixLength = $map[1];
$j = 0;
// Compare characters in the plural table and of the suffix of the
// given plural one by one
while ($suffix[$j] === $lowerPluralRev[$j]) {
// Let $j point to the next character
++$j;
// Successfully compared the last character
// Add an entry with the singular suffix to the singular array
if ($j === $suffixLength) {
// Is there any character preceding the suffix in the plural string?
if ($j < $pluralLength) {
$nextIsVowel = \str_contains('aeiou', $lowerPluralRev[$j]);
if (!$map[2] && $nextIsVowel) {
// suffix may not succeed a vowel but next char is one
break;
}
if (!$map[3] && !$nextIsVowel) {
// suffix may not succeed a consonant but next char is one
break;
}
}
$newBase = \substr($plural, 0, $pluralLength - $suffixLength);
$newSuffix = $map[4];
// Check whether the first character in the plural suffix
// is uppercased. If yes, uppercase the first character in
// the singular suffix too
$firstUpper = \ctype_upper($pluralRev[$j - 1]);
if (\is_array($newSuffix)) {
$singulars = [];
foreach ($newSuffix as $newSuffixEntry) {
$singulars[] = $newBase . ($firstUpper ? \ucfirst($newSuffixEntry) : $newSuffixEntry);
}
return $singulars;
}
return [$newBase . ($firstUpper ? \ucfirst($newSuffix) : $newSuffix)];
}
// Suffix is longer than word
if ($j === $pluralLength) {
break;
}
}
}
// Assume that plural and singular is identical
return [$plural];
}
public function pluralize(string $singular) : array
{
$singularRev = \strrev($singular);
$lowerSingularRev = \strtolower($singularRev);
$singularLength = \strlen($lowerSingularRev);
// Check if the word is one which is not inflected, return early if so
if (\in_array($lowerSingularRev, self::UNINFLECTED, \true)) {
return [$singular];
}
// The outer loop iterates over the entries of the singular table
// The inner loop $j iterates over the characters of the singular suffix
// in the singular table to compare them with the characters of the actual
// given singular suffix
foreach (self::SINGULAR_MAP as $map) {
$suffix = $map[0];
$suffixLength = $map[1];
$j = 0;
// Compare characters in the singular table and of the suffix of the
// given plural one by one
while ($suffix[$j] === $lowerSingularRev[$j]) {
// Let $j point to the next character
++$j;
// Successfully compared the last character
// Add an entry with the plural suffix to the plural array
if ($j === $suffixLength) {
// Is there any character preceding the suffix in the plural string?
if ($j < $singularLength) {
$nextIsVowel = \str_contains('aeiou', $lowerSingularRev[$j]);
if (!$map[2] && $nextIsVowel) {
// suffix may not succeed a vowel but next char is one
break;
}
if (!$map[3] && !$nextIsVowel) {
// suffix may not succeed a consonant but next char is one
break;
}
}
$newBase = \substr($singular, 0, $singularLength - $suffixLength);
$newSuffix = $map[4];
// Check whether the first character in the singular suffix
// is uppercased. If yes, uppercase the first character in
// the singular suffix too
$firstUpper = \ctype_upper($singularRev[$j - 1]);
if (\is_array($newSuffix)) {
$plurals = [];
foreach ($newSuffix as $newSuffixEntry) {
$plurals[] = $newBase . ($firstUpper ? \ucfirst($newSuffixEntry) : $newSuffixEntry);
}
return $plurals;
}
return [$newBase . ($firstUpper ? \ucfirst($newSuffix) : $newSuffix)];
}
// Suffix is longer than word
if ($j === $singularLength) {
break;
}
}
}
// Assume that plural is singular with a trailing `s`
return [$singular . 's'];
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String\Inflector;
interface InflectorInterface
{
/**
* Returns the singular forms of a string.
*
* If the method can't determine the form with certainty, several possible singulars are returned.
*
* @return string[]
*/
public function singularize(string $plural) : array;
/**
* Returns the plural forms of a string.
*
* If the method can't determine the form with certainty, several possible plurals are returned.
*
* @return string[]
*/
public function pluralize(string $singular) : array;
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\String;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\ExceptionInterface;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\String\Exception\RuntimeException;
/**
* Represents a string of abstract characters.
*
* Unicode defines 3 types of "characters" (bytes, code points and grapheme clusters).
* This class is the abstract type to use as a type-hint when the logic you want to
* implement doesn't care about the exact variant it deals with.
*
* @author Nicolas Grekas <p@tchwork.com>
* @author Hugo Hamon <hugohamon@neuf.fr>
*
* @throws ExceptionInterface
*/
abstract class AbstractString implements \Stringable, \JsonSerializable
{
public const PREG_PATTERN_ORDER = \PREG_PATTERN_ORDER;
public const PREG_SET_ORDER = \PREG_SET_ORDER;
public const PREG_OFFSET_CAPTURE = \PREG_OFFSET_CAPTURE;
public const PREG_UNMATCHED_AS_NULL = \PREG_UNMATCHED_AS_NULL;
public const PREG_SPLIT = 0;
public const PREG_SPLIT_NO_EMPTY = \PREG_SPLIT_NO_EMPTY;
public const PREG_SPLIT_DELIM_CAPTURE = \PREG_SPLIT_DELIM_CAPTURE;
public const PREG_SPLIT_OFFSET_CAPTURE = \PREG_SPLIT_OFFSET_CAPTURE;
protected $string = '';
protected $ignoreCase = \false;
public abstract function __construct(string $string = '');
/**
* Unwraps instances of AbstractString back to strings.
*
* @return string[]|array
*/
public static function unwrap(array $values) : array
{
foreach ($values as $k => $v) {
if ($v instanceof self) {
$values[$k] = $v->__toString();
} elseif (\is_array($v) && $values[$k] !== ($v = static::unwrap($v))) {
$values[$k] = $v;
}
}
return $values;
}
/**
* Wraps (and normalizes) strings in instances of AbstractString.
*
* @return static[]|array
*/
public static function wrap(array $values) : array
{
$i = 0;
$keys = null;
foreach ($values as $k => $v) {
if (\is_string($k) && '' !== $k && $k !== ($j = (string) new static($k))) {
$keys = $keys ?? \array_keys($values);
$keys[$i] = $j;
}
if (\is_string($v)) {
$values[$k] = new static($v);
} elseif (\is_array($v) && $values[$k] !== ($v = static::wrap($v))) {
$values[$k] = $v;
}
++$i;
}
return null !== $keys ? \array_combine($keys, $values) : $values;
}
/**
* @param string|string[] $needle
*
* @return static
*/
public function after($needle, bool $includeNeedle = \false, int $offset = 0) : self
{
$str = clone $this;
$i = \PHP_INT_MAX;
foreach ((array) $needle as $n) {
$n = (string) $n;
$j = $this->indexOf($n, $offset);
if (null !== $j && $j < $i) {
$i = $j;
$str->string = $n;
}
}
if (\PHP_INT_MAX === $i) {
return $str;
}
if (!$includeNeedle) {
$i += $str->length();
}
return $this->slice($i);
}
/**
* @param string|string[] $needle
*
* @return static
*/
public function afterLast($needle, bool $includeNeedle = \false, int $offset = 0) : self
{
$str = clone $this;
$i = null;
foreach ((array) $needle as $n) {
$n = (string) $n;
$j = $this->indexOfLast($n, $offset);
if (null !== $j && $j >= $i) {
$i = $offset = $j;
$str->string = $n;
}
}
if (null === $i) {
return $str;
}
if (!$includeNeedle) {
$i += $str->length();
}
return $this->slice($i);
}
/**
* @return static
*/
public abstract function append(string ...$suffix) : self;
/**
* @param string|string[] $needle
*
* @return static
*/
public function before($needle, bool $includeNeedle = \false, int $offset = 0) : self
{
$str = clone $this;
$i = \PHP_INT_MAX;
foreach ((array) $needle as $n) {
$n = (string) $n;
$j = $this->indexOf($n, $offset);
if (null !== $j && $j < $i) {
$i = $j;
$str->string = $n;
}
}
if (\PHP_INT_MAX === $i) {
return $str;
}
if ($includeNeedle) {
$i += $str->length();
}
return $this->slice(0, $i);
}
/**
* @param string|string[] $needle
*
* @return static
*/
public function beforeLast($needle, bool $includeNeedle = \false, int $offset = 0) : self
{
$str = clone $this;
$i = null;
foreach ((array) $needle as $n) {
$n = (string) $n;
$j = $this->indexOfLast($n, $offset);
if (null !== $j && $j >= $i) {
$i = $offset = $j;
$str->string = $n;
}
}
if (null === $i) {
return $str;
}
if ($includeNeedle) {
$i += $str->length();
}
return $this->slice(0, $i);
}
/**
* @return int[]
*/
public function bytesAt(int $offset) : array
{
$str = $this->slice($offset, 1);
return '' === $str->string ? [] : \array_values(\unpack('C*', $str->string));
}
/**
* @return static
*/
public abstract function camel() : self;
/**
* @return static[]
*/
public abstract function chunk(int $length = 1) : array;
/**
* @return static
*/
public function collapseWhitespace() : self
{
$str = clone $this;
$str->string = \trim(\preg_replace("/(?:[ \n\r\t\f]{2,}+|[\n\r\t\f])/", ' ', $str->string), " \n\r\t\f");
return $str;
}
/**
* @param string|string[] $needle
*/
public function containsAny($needle) : bool
{
return null !== $this->indexOf($needle);
}
/**
* @param string|string[] $suffix
*/
public function endsWith($suffix) : bool
{
if (!\is_array($suffix) && !$suffix instanceof \Traversable) {
throw new \TypeError(\sprintf('Method "%s()" must be overridden by class "%s" to deal with non-iterable values.', __FUNCTION__, static::class));
}
foreach ($suffix as $s) {
if ($this->endsWith((string) $s)) {
return \true;
}
}
return \false;
}
/**
* @return static
*/
public function ensureEnd(string $suffix) : self
{
if (!$this->endsWith($suffix)) {
return $this->append($suffix);
}
$suffix = \preg_quote($suffix);
$regex = '{(' . $suffix . ')(?:' . $suffix . ')++$}D';
return $this->replaceMatches($regex . ($this->ignoreCase ? 'i' : ''), '$1');
}
/**
* @return static
*/
public function ensureStart(string $prefix) : self
{
$prefix = new static($prefix);
if (!$this->startsWith($prefix)) {
return $this->prepend($prefix);
}
$str = clone $this;
$i = $prefixLen = $prefix->length();
while ($this->indexOf($prefix, $i) === $i) {
$str = $str->slice($prefixLen);
$i += $prefixLen;
}
return $str;
}
/**
* @param string|string[] $string
*/
public function equalsTo($string) : bool
{
if (!\is_array($string) && !$string instanceof \Traversable) {
throw new \TypeError(\sprintf('Method "%s()" must be overridden by class "%s" to deal with non-iterable values.', __FUNCTION__, static::class));
}
foreach ($string as $s) {
if ($this->equalsTo((string) $s)) {
return \true;
}
}
return \false;
}
/**
* @return static
*/
public abstract function folded() : self;
/**
* @return static
*/
public function ignoreCase() : self
{
$str = clone $this;
$str->ignoreCase = \true;
return $str;
}
/**
* @param string|string[] $needle
*/
public function indexOf($needle, int $offset = 0) : ?int
{
if (!\is_array($needle) && !$needle instanceof \Traversable) {
throw new \TypeError(\sprintf('Method "%s()" must be overridden by class "%s" to deal with non-iterable values.', __FUNCTION__, static::class));
}
$i = \PHP_INT_MAX;
foreach ($needle as $n) {
$j = $this->indexOf((string) $n, $offset);
if (null !== $j && $j < $i) {
$i = $j;
}
}
return \PHP_INT_MAX === $i ? null : $i;
}
/**
* @param string|string[] $needle
*/
public function indexOfLast($needle, int $offset = 0) : ?int
{
if (!\is_array($needle) && !$needle instanceof \Traversable) {
throw new \TypeError(\sprintf('Method "%s()" must be overridden by class "%s" to deal with non-iterable values.', __FUNCTION__, static::class));
}
$i = null;
foreach ($needle as $n) {
$j = $this->indexOfLast((string) $n, $offset);
if (null !== $j && $j >= $i) {
$i = $offset = $j;
}
}
return $i;
}
public function isEmpty() : bool
{
return '' === $this->string;
}
/**
* @return static
*/
public abstract function join(array $strings, ?string $lastGlue = null) : self;
public function jsonSerialize() : string
{
return $this->string;
}
public abstract function length() : int;
/**
* @return static
*/
public abstract function lower() : self;
/**
* Matches the string using a regular expression.
*
* Pass PREG_PATTERN_ORDER or PREG_SET_ORDER as $flags to get all occurrences matching the regular expression.
*
* @return array All matches in a multi-dimensional array ordered according to flags
*/
public abstract function match(string $regexp, int $flags = 0, int $offset = 0) : array;
/**
* @return static
*/
public abstract function padBoth(int $length, string $padStr = ' ') : self;
/**
* @return static
*/
public abstract function padEnd(int $length, string $padStr = ' ') : self;
/**
* @return static
*/
public abstract function padStart(int $length, string $padStr = ' ') : self;
/**
* @return static
*/
public abstract function prepend(string ...$prefix) : self;
/**
* @return static
*/
public function repeat(int $multiplier) : self
{
if (0 > $multiplier) {
throw new InvalidArgumentException(\sprintf('Multiplier must be positive, %d given.', $multiplier));
}
$str = clone $this;
$str->string = \str_repeat($str->string, $multiplier);
return $str;
}
/**
* @return static
*/
public abstract function replace(string $from, string $to) : self;
/**
* @param string|callable $to
*
* @return static
*/
public abstract function replaceMatches(string $fromRegexp, $to) : self;
/**
* @return static
*/
public abstract function reverse() : self;
/**
* @return static
*/
public abstract function slice(int $start = 0, ?int $length = null) : self;
/**
* @return static
*/
public abstract function snake() : self;
/**
* @return static
*/
public abstract function splice(string $replacement, int $start = 0, ?int $length = null) : self;
/**
* @return static[]
*/
public function split(string $delimiter, ?int $limit = null, ?int $flags = null) : array
{
if (null === $flags) {
throw new \TypeError('Split behavior when $flags is null must be implemented by child classes.');
}
if ($this->ignoreCase) {
$delimiter .= 'i';
}
\set_error_handler(static function ($t, $m) {
throw new InvalidArgumentException($m);
});
try {
if (\false === ($chunks = \preg_split($delimiter, $this->string, $limit, $flags))) {
$lastError = \preg_last_error();
foreach (\get_defined_constants(\true)['pcre'] as $k => $v) {
if ($lastError === $v && '_ERROR' === \substr($k, -6)) {
throw new RuntimeException('Splitting failed with ' . $k . '.');
}
}
throw new RuntimeException('Splitting failed with unknown error code.');
}
} finally {
\restore_error_handler();
}
$str = clone $this;
if (self::PREG_SPLIT_OFFSET_CAPTURE & $flags) {
foreach ($chunks as &$chunk) {
$str->string = $chunk[0];
$chunk[0] = clone $str;
}
} else {
foreach ($chunks as &$chunk) {
$str->string = $chunk;
$chunk = clone $str;
}
}
return $chunks;
}
/**
* @param string|string[] $prefix
*/
public function startsWith($prefix) : bool
{
if (!\is_array($prefix) && !$prefix instanceof \Traversable) {
throw new \TypeError(\sprintf('Method "%s()" must be overridden by class "%s" to deal with non-iterable values.', __FUNCTION__, static::class));
}
foreach ($prefix as $prefix) {
if ($this->startsWith((string) $prefix)) {
return \true;
}
}
return \false;
}
/**
* @return static
*/
public abstract function title(bool $allWords = \false) : self;
public function toByteString(?string $toEncoding = null) : ByteString
{
$b = new ByteString();
$toEncoding = \in_array($toEncoding, ['utf8', 'utf-8', 'UTF8'], \true) ? 'UTF-8' : $toEncoding;
if (null === $toEncoding || $toEncoding === ($fromEncoding = $this instanceof AbstractUnicodeString || \preg_match('//u', $b->string) ? 'UTF-8' : 'Windows-1252')) {
$b->string = $this->string;
return $b;
}
\set_error_handler(static function ($t, $m) {
throw new InvalidArgumentException($m);
});
try {
try {
$b->string = \mb_convert_encoding($this->string, $toEncoding, 'UTF-8');
} catch (InvalidArgumentException|\ValueError $e) {
if (!\function_exists('iconv')) {
if ($e instanceof \ValueError) {
throw new InvalidArgumentException($e->getMessage(), $e->getCode(), $e);
}
throw $e;
}
$b->string = \iconv('UTF-8', $toEncoding, $this->string);
}
} finally {
\restore_error_handler();
}
return $b;
}
public function toCodePointString() : CodePointString
{
return new CodePointString($this->string);
}
public function toString() : string
{
return $this->string;
}
public function toUnicodeString() : UnicodeString
{
return new UnicodeString($this->string);
}
/**
* @return static
*/
public abstract function trim(string $chars = " \t\n\r\x00\v\f ") : self;
/**
* @return static
*/
public abstract function trimEnd(string $chars = " \t\n\r\x00\v\f ") : self;
/**
* @param string|string[] $prefix
*
* @return static
*/
public function trimPrefix($prefix) : self
{
if (\is_array($prefix) || $prefix instanceof \Traversable) {
foreach ($prefix as $s) {
$t = $this->trimPrefix($s);
if ($t->string !== $this->string) {
return $t;
}
}
return clone $this;
}
$str = clone $this;
if ($prefix instanceof self) {
$prefix = $prefix->string;
} else {
$prefix = (string) $prefix;
}
if ('' !== $prefix && \strlen($this->string) >= \strlen($prefix) && 0 === \substr_compare($this->string, $prefix, 0, \strlen($prefix), $this->ignoreCase)) {
$str->string = \substr($this->string, \strlen($prefix));
}
return $str;
}
/**
* @return static
*/
public abstract function trimStart(string $chars = " \t\n\r\x00\v\f ") : self;
/**
* @param string|string[] $suffix
*
* @return static
*/
public function trimSuffix($suffix) : self
{
if (\is_array($suffix) || $suffix instanceof \Traversable) {
foreach ($suffix as $s) {
$t = $this->trimSuffix($s);
if ($t->string !== $this->string) {
return $t;
}
}
return clone $this;
}
$str = clone $this;
if ($suffix instanceof self) {
$suffix = $suffix->string;
} else {
$suffix = (string) $suffix;
}
if ('' !== $suffix && \strlen($this->string) >= \strlen($suffix) && 0 === \substr_compare($this->string, $suffix, -\strlen($suffix), null, $this->ignoreCase)) {
$str->string = \substr($this->string, 0, -\strlen($suffix));
}
return $str;
}
/**
* @return static
*/
public function truncate(int $length, string $ellipsis = '', bool $cut = \true) : self
{
$stringLength = $this->length();
if ($stringLength <= $length) {
return clone $this;
}
$ellipsisLength = '' !== $ellipsis ? (new static($ellipsis))->length() : 0;
if ($length < $ellipsisLength) {
$ellipsisLength = 0;
}
if (!$cut) {
if (null === ($length = $this->indexOf([' ', "\r", "\n", "\t"], ($length ?: 1) - 1))) {
return clone $this;
}
$length += $ellipsisLength;
}
$str = $this->slice(0, $length - $ellipsisLength);
return $ellipsisLength ? $str->trimEnd()->append($ellipsis) : $str;
}
/**
* @return static
*/
public abstract function upper() : self;
/**
* Returns the printable length on a terminal.
*/
public abstract function width(bool $ignoreAnsiDecoration = \true) : int;
/**
* @return static
*/
public function wordwrap(int $width = 75, string $break = "\n", bool $cut = \false) : self
{
$lines = '' !== $break ? $this->split($break) : [clone $this];
$chars = [];
$mask = '';
if (1 === \count($lines) && '' === $lines[0]->string) {
return $lines[0];
}
foreach ($lines as $i => $line) {
if ($i) {
$chars[] = $break;
$mask .= '#';
}
foreach ($line->chunk() as $char) {
$chars[] = $char->string;
$mask .= ' ' === $char->string ? ' ' : '?';
}
}
$string = '';
$j = 0;
$b = $i = -1;
$mask = \wordwrap($mask, $width, '#', $cut);
while (\false !== ($b = \strpos($mask, '#', $b + 1))) {
for (++$i; $i < $b; ++$i) {
$string .= $chars[$j];
unset($chars[$j++]);
}
if ($break === $chars[$j] || ' ' === $chars[$j]) {
unset($chars[$j++]);
}
$string .= $break;
}
$str = clone $this;
$str->string = $string . \implode('', $chars);
return $str;
}
public function __sleep() : array
{
return ['string'];
}
public function __clone()
{
$this->ignoreCase = \false;
}
public function __toString() : string
{
return $this->string;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (\PHP_VERSION_ID < 70300) {
class JsonException extends Exception
{
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use Symfony\Polyfill\Php73 as p;
if (\PHP_VERSION_ID >= 70300) {
return;
}
if (!function_exists('is_countable')) {
function is_countable($value) { return is_array($value) || $value instanceof Countable || $value instanceof ResourceBundle || $value instanceof SimpleXmlElement; }
}
if (!function_exists('hrtime')) {
require_once __DIR__.'/Php73.php';
p\Php73::$startAt = (int) microtime(true);
function hrtime($as_number = false) { return p\Php73::hrtime($as_number); }
}
if (!function_exists('array_key_first')) {
function array_key_first(array $array) { foreach ($array as $key => $value) { return $key; } }
}
if (!function_exists('array_key_last')) {
function array_key_last(array $array) { return key(array_slice($array, -1, 1, true)); }
}
Copyright (c) 2018-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Polyfill\Php73;
/**
* @author Gabriel Caruso <carusogabriel34@gmail.com>
* @author Ion Bazan <ion.bazan@gmail.com>
*
* @internal
*/
final class Php73
{
public static $startAt = 1533462603;
/**
* @param bool $asNum
*
* @return array|float|int
*/
public static function hrtime($asNum = false)
{
$ns = microtime(false);
$s = substr($ns, 11) - self::$startAt;
$ns = 1E9 * (float) $ns;
if ($asNum) {
$ns += $s * 1E9;
return \PHP_INT_SIZE === 4 ? $ns : (int) $ns;
}
return [$s, (int) $ns];
}
}
<?php
return array (
'À' => 'À',
'Á' => 'Á',
'Â' => 'Â',
'Ã' => 'Ã',
'Ä' => 'Ä',
'Å' => 'Å',
'Ç' => 'Ç',
'È' => 'È',
'É' => 'É',
'Ê' => 'Ê',
'Ë' => 'Ë',
'Ì' => 'Ì',
'Í' => 'Í',
'Î' => 'Î',
'Ï' => 'Ï',
'Ñ' => 'Ñ',
'Ò' => 'Ò',
'Ó' => 'Ó',
'Ô' => 'Ô',
'Õ' => 'Õ',
'Ö' => 'Ö',
'Ù' => 'Ù',
'Ú' => 'Ú',
'Û' => 'Û',
'Ü' => 'Ü',
'Ý' => 'Ý',
'à' => 'à',
'á' => 'á',
'â' => 'â',
'ã' => 'ã',
'ä' => 'ä',
'å' => 'å',
'ç' => 'ç',
'è' => 'è',
'é' => 'é',
'ê' => 'ê',
'ë' => 'ë',
'ì' => 'ì',
'í' => 'í',
'î' => 'î',
'ï' => 'ï',
'ñ' => 'ñ',
'ò' => 'ò',
'ó' => 'ó',
'ô' => 'ô',
'õ' => 'õ',
'ö' => 'ö',
'ù' => 'ù',
'ú' => 'ú',
'û' => 'û',
'ü' => 'ü',
'ý' => 'ý',
'ÿ' => 'ÿ',
'Ā' => 'Ā',
'ā' => 'ā',
'Ă' => 'Ă',
'ă' => 'ă',
'Ą' => 'Ą',
'ą' => 'ą',
'Ć' => 'Ć',
'ć' => 'ć',
'Ĉ' => 'Ĉ',
'ĉ' => 'ĉ',
'Ċ' => 'Ċ',
'ċ' => 'ċ',
'Č' => 'Č',
'č' => 'č',
'Ď' => 'Ď',
'ď' => 'ď',
'Ē' => 'Ē',
'ē' => 'ē',
'Ĕ' => 'Ĕ',
'ĕ' => 'ĕ',
'Ė' => 'Ė',
'ė' => 'ė',
'Ę' => 'Ę',
'ę' => 'ę',
'Ě' => 'Ě',
'ě' => 'ě',
'Ĝ' => 'Ĝ',
'ĝ' => 'ĝ',
'Ğ' => 'Ğ',
'ğ' => 'ğ',
'Ġ' => 'Ġ',
'ġ' => 'ġ',
'Ģ' => 'Ģ',
'ģ' => 'ģ',
'Ĥ' => 'Ĥ',
'ĥ' => 'ĥ',
'Ĩ' => 'Ĩ',
'ĩ' => 'ĩ',
'Ī' => 'Ī',
'ī' => 'ī',
'Ĭ' => 'Ĭ',
'ĭ' => 'ĭ',
'Į' => 'Į',
'į' => 'į',
'İ' => 'İ',
'Ĵ' => 'Ĵ',
'ĵ' => 'ĵ',
'Ķ' => 'Ķ',
'ķ' => 'ķ',
'Ĺ' => 'Ĺ',
'ĺ' => 'ĺ',
'Ļ' => 'Ļ',
'ļ' => 'ļ',
'Ľ' => 'Ľ',
'ľ' => 'ľ',
'Ń' => 'Ń',
'ń' => 'ń',
'Ņ' => 'Ņ',
'ņ' => 'ņ',
'Ň' => 'Ň',
'ň' => 'ň',
'Ō' => 'Ō',
'ō' => 'ō',
'Ŏ' => 'Ŏ',
'ŏ' => 'ŏ',
'Ő' => 'Ő',
'ő' => 'ő',
'Ŕ' => 'Ŕ',
'ŕ' => 'ŕ',
'Ŗ' => 'Ŗ',
'ŗ' => 'ŗ',
'Ř' => 'Ř',
'ř' => 'ř',
'Ś' => 'Ś',
'ś' => 'ś',
'Ŝ' => 'Ŝ',
'ŝ' => 'ŝ',
'Ş' => 'Ş',
'ş' => 'ş',
'Š' => 'Š',
'š' => 'š',
'Ţ' => 'Ţ',
'ţ' => 'ţ',
'Ť' => 'Ť',
'ť' => 'ť',
'Ũ' => 'Ũ',
'ũ' => 'ũ',
'Ū' => 'Ū',
'ū' => 'ū',
'Ŭ' => 'Ŭ',
'ŭ' => 'ŭ',
'Ů' => 'Ů',
'ů' => 'ů',
'Ű' => 'Ű',
'ű' => 'ű',
'Ų' => 'Ų',
'ų' => 'ų',
'Ŵ' => 'Ŵ',
'ŵ' => 'ŵ',
'Ŷ' => 'Ŷ',
'ŷ' => 'ŷ',
'Ÿ' => 'Ÿ',
'Ź' => 'Ź',
'ź' => 'ź',
'Ż' => 'Ż',
'ż' => 'ż',
'Ž' => 'Ž',
'ž' => 'ž',
'Ơ' => 'Ơ',
'ơ' => 'ơ',
'Ư' => 'Ư',
'ư' => 'ư',
'Ǎ' => 'Ǎ',
'ǎ' => 'ǎ',
'Ǐ' => 'Ǐ',
'ǐ' => 'ǐ',
'Ǒ' => 'Ǒ',
'ǒ' => 'ǒ',
'Ǔ' => 'Ǔ',
'ǔ' => 'ǔ',
'Ǖ' => 'Ǖ',
'ǖ' => 'ǖ',
'Ǘ' => 'Ǘ',
'ǘ' => 'ǘ',
'Ǚ' => 'Ǚ',
'ǚ' => 'ǚ',
'Ǜ' => 'Ǜ',
'ǜ' => 'ǜ',
'Ǟ' => 'Ǟ',
'ǟ' => 'ǟ',
'Ǡ' => 'Ǡ',
'ǡ' => 'ǡ',
'Ǣ' => 'Ǣ',
'ǣ' => 'ǣ',
'Ǧ' => 'Ǧ',
'ǧ' => 'ǧ',
'Ǩ' => 'Ǩ',
'ǩ' => 'ǩ',
'Ǫ' => 'Ǫ',
'ǫ' => 'ǫ',
'Ǭ' => 'Ǭ',
'ǭ' => 'ǭ',
'Ǯ' => 'Ǯ',
'ǯ' => 'ǯ',
'ǰ' => 'ǰ',
'Ǵ' => 'Ǵ',
'ǵ' => 'ǵ',
'Ǹ' => 'Ǹ',
'ǹ' => 'ǹ',
'Ǻ' => 'Ǻ',
'ǻ' => 'ǻ',
'Ǽ' => 'Ǽ',
'ǽ' => 'ǽ',
'Ǿ' => 'Ǿ',
'ǿ' => 'ǿ',
'Ȁ' => 'Ȁ',
'ȁ' => 'ȁ',
'Ȃ' => 'Ȃ',
'ȃ' => 'ȃ',
'Ȅ' => 'Ȅ',
'ȅ' => 'ȅ',
'Ȇ' => 'Ȇ',
'ȇ' => 'ȇ',
'Ȉ' => 'Ȉ',
'ȉ' => 'ȉ',
'Ȋ' => 'Ȋ',
'ȋ' => 'ȋ',
'Ȍ' => 'Ȍ',
'ȍ' => 'ȍ',
'Ȏ' => 'Ȏ',
'ȏ' => 'ȏ',
'Ȑ' => 'Ȑ',
'ȑ' => 'ȑ',
'Ȓ' => 'Ȓ',
'ȓ' => 'ȓ',
'Ȕ' => 'Ȕ',
'ȕ' => 'ȕ',
'Ȗ' => 'Ȗ',
'ȗ' => 'ȗ',
'Ș' => 'Ș',
'ș' => 'ș',
'Ț' => 'Ț',
'ț' => 'ț',
'Ȟ' => 'Ȟ',
'ȟ' => 'ȟ',
'Ȧ' => 'Ȧ',
'ȧ' => 'ȧ',
'Ȩ' => 'Ȩ',
'ȩ' => 'ȩ',
'Ȫ' => 'Ȫ',
'ȫ' => 'ȫ',
'Ȭ' => 'Ȭ',
'ȭ' => 'ȭ',
'Ȯ' => 'Ȯ',
'ȯ' => 'ȯ',
'Ȱ' => 'Ȱ',
'ȱ' => 'ȱ',
'Ȳ' => 'Ȳ',
'ȳ' => 'ȳ',
'΅' => '΅',
'Ά' => 'Ά',
'Έ' => 'Έ',
'Ή' => 'Ή',
'Ί' => 'Ί',
'Ό' => 'Ό',
'Ύ' => 'Ύ',
'Ώ' => 'Ώ',
'ΐ' => 'ΐ',
'Ϊ' => 'Ϊ',
'Ϋ' => 'Ϋ',
'ά' => 'ά',
'έ' => 'έ',
'ή' => 'ή',
'ί' => 'ί',
'ΰ' => 'ΰ',
'ϊ' => 'ϊ',
'ϋ' => 'ϋ',
'ό' => 'ό',
'ύ' => 'ύ',
'ώ' => 'ώ',
'ϓ' => 'ϓ',
'ϔ' => 'ϔ',
'Ѐ' => 'Ѐ',
'Ё' => 'Ё',
'Ѓ' => 'Ѓ',
'Ї' => 'Ї',
'Ќ' => 'Ќ',
'Ѝ' => 'Ѝ',
'Ў' => 'Ў',
'Й' => 'Й',
'й' => 'й',
'ѐ' => 'ѐ',
'ё' => 'ё',
'ѓ' => 'ѓ',
'ї' => 'ї',
'ќ' => 'ќ',
'ѝ' => 'ѝ',
'ў' => 'ў',
'Ѷ' => 'Ѷ',
'ѷ' => 'ѷ',
'Ӂ' => 'Ӂ',
'ӂ' => 'ӂ',
'Ӑ' => 'Ӑ',
'ӑ' => 'ӑ',
'Ӓ' => 'Ӓ',
'ӓ' => 'ӓ',
'Ӗ' => 'Ӗ',
'ӗ' => 'ӗ',
'Ӛ' => 'Ӛ',
'ӛ' => 'ӛ',
'Ӝ' => 'Ӝ',
'ӝ' => 'ӝ',
'Ӟ' => 'Ӟ',
'ӟ' => 'ӟ',
'Ӣ' => 'Ӣ',
'ӣ' => 'ӣ',
'Ӥ' => 'Ӥ',
'ӥ' => 'ӥ',
'Ӧ' => 'Ӧ',
'ӧ' => 'ӧ',
'Ӫ' => 'Ӫ',
'ӫ' => 'ӫ',
'Ӭ' => 'Ӭ',
'ӭ' => 'ӭ',
'Ӯ' => 'Ӯ',
'ӯ' => 'ӯ',
'Ӱ' => 'Ӱ',
'ӱ' => 'ӱ',
'Ӳ' => 'Ӳ',
'ӳ' => 'ӳ',
'Ӵ' => 'Ӵ',
'ӵ' => 'ӵ',
'Ӹ' => 'Ӹ',
'ӹ' => 'ӹ',
'آ' => 'آ',
'أ' => 'أ',
'ؤ' => 'ؤ',
'إ' => 'إ',
'ئ' => 'ئ',
'ۀ' => 'ۀ',
'ۂ' => 'ۂ',
'ۓ' => 'ۓ',
'ऩ' => 'ऩ',
'ऱ' => 'ऱ',
'ऴ' => 'ऴ',
'ো' => 'ো',
'ৌ' => 'ৌ',
'ୈ' => 'ୈ',
'ୋ' => 'ୋ',
'ୌ' => 'ୌ',
'ஔ' => 'ஔ',
'ொ' => 'ொ',
'ோ' => 'ோ',
'ௌ' => 'ௌ',
'ై' => 'ై',
'ೀ' => 'ೀ',
'ೇ' => 'ೇ',
'ೈ' => 'ೈ',
'ೊ' => 'ೊ',
'ೋ' => 'ೋ',
'ൊ' => 'ൊ',
'ോ' => 'ോ',
'ൌ' => 'ൌ',
'ේ' => 'ේ',
'ො' => 'ො',
'ෝ' => 'ෝ',
'ෞ' => 'ෞ',
'ဦ' => 'ဦ',
'ᬆ' => 'ᬆ',
'ᬈ' => 'ᬈ',
'ᬊ' => 'ᬊ',
'ᬌ' => 'ᬌ',
'ᬎ' => 'ᬎ',
'ᬒ' => 'ᬒ',
'ᬻ' => 'ᬻ',
'ᬽ' => 'ᬽ',
'ᭀ' => 'ᭀ',
'ᭁ' => 'ᭁ',
'ᭃ' => 'ᭃ',
'Ḁ' => 'Ḁ',
'ḁ' => 'ḁ',
'Ḃ' => 'Ḃ',
'ḃ' => 'ḃ',
'Ḅ' => 'Ḅ',
'ḅ' => 'ḅ',
'Ḇ' => 'Ḇ',
'ḇ' => 'ḇ',
'Ḉ' => 'Ḉ',
'ḉ' => 'ḉ',
'Ḋ' => 'Ḋ',
'ḋ' => 'ḋ',
'Ḍ' => 'Ḍ',
'ḍ' => 'ḍ',
'Ḏ' => 'Ḏ',
'ḏ' => 'ḏ',
'Ḑ' => 'Ḑ',
'ḑ' => 'ḑ',
'Ḓ' => 'Ḓ',
'ḓ' => 'ḓ',
'Ḕ' => 'Ḕ',
'ḕ' => 'ḕ',
'Ḗ' => 'Ḗ',
'ḗ' => 'ḗ',
'Ḙ' => 'Ḙ',
'ḙ' => 'ḙ',
'Ḛ' => 'Ḛ',
'ḛ' => 'ḛ',
'Ḝ' => 'Ḝ',
'ḝ' => 'ḝ',
'Ḟ' => 'Ḟ',
'ḟ' => 'ḟ',
'Ḡ' => 'Ḡ',
'ḡ' => 'ḡ',
'Ḣ' => 'Ḣ',
'ḣ' => 'ḣ',
'Ḥ' => 'Ḥ',
'ḥ' => 'ḥ',
'Ḧ' => 'Ḧ',
'ḧ' => 'ḧ',
'Ḩ' => 'Ḩ',
'ḩ' => 'ḩ',
'Ḫ' => 'Ḫ',
'ḫ' => 'ḫ',
'Ḭ' => 'Ḭ',
'ḭ' => 'ḭ',
'Ḯ' => 'Ḯ',
'ḯ' => 'ḯ',
'Ḱ' => 'Ḱ',
'ḱ' => 'ḱ',
'Ḳ' => 'Ḳ',
'ḳ' => 'ḳ',
'Ḵ' => 'Ḵ',
'ḵ' => 'ḵ',
'Ḷ' => 'Ḷ',
'ḷ' => 'ḷ',
'Ḹ' => 'Ḹ',
'ḹ' => 'ḹ',
'Ḻ' => 'Ḻ',
'ḻ' => 'ḻ',
'Ḽ' => 'Ḽ',
'ḽ' => 'ḽ',
'Ḿ' => 'Ḿ',
'ḿ' => 'ḿ',
'Ṁ' => 'Ṁ',
'ṁ' => 'ṁ',
'Ṃ' => 'Ṃ',
'ṃ' => 'ṃ',
'Ṅ' => 'Ṅ',
'ṅ' => 'ṅ',
'Ṇ' => 'Ṇ',
'ṇ' => 'ṇ',
'Ṉ' => 'Ṉ',
'ṉ' => 'ṉ',
'Ṋ' => 'Ṋ',
'ṋ' => 'ṋ',
'Ṍ' => 'Ṍ',
'ṍ' => 'ṍ',
'Ṏ' => 'Ṏ',
'ṏ' => 'ṏ',
'Ṑ' => 'Ṑ',
'ṑ' => 'ṑ',
'Ṓ' => 'Ṓ',
'ṓ' => 'ṓ',
'Ṕ' => 'Ṕ',
'ṕ' => 'ṕ',
'Ṗ' => 'Ṗ',
'ṗ' => 'ṗ',
'Ṙ' => 'Ṙ',
'ṙ' => 'ṙ',
'Ṛ' => 'Ṛ',
'ṛ' => 'ṛ',
'Ṝ' => 'Ṝ',
'ṝ' => 'ṝ',
'Ṟ' => 'Ṟ',
'ṟ' => 'ṟ',
'Ṡ' => 'Ṡ',
'ṡ' => 'ṡ',
'Ṣ' => 'Ṣ',
'ṣ' => 'ṣ',
'Ṥ' => 'Ṥ',
'ṥ' => 'ṥ',
'Ṧ' => 'Ṧ',
'ṧ' => 'ṧ',
'Ṩ' => 'Ṩ',
'ṩ' => 'ṩ',
'Ṫ' => 'Ṫ',
'ṫ' => 'ṫ',
'Ṭ' => 'Ṭ',
'ṭ' => 'ṭ',
'Ṯ' => 'Ṯ',
'ṯ' => 'ṯ',
'Ṱ' => 'Ṱ',
'ṱ' => 'ṱ',
'Ṳ' => 'Ṳ',
'ṳ' => 'ṳ',
'Ṵ' => 'Ṵ',
'ṵ' => 'ṵ',
'Ṷ' => 'Ṷ',
'ṷ' => 'ṷ',
'Ṹ' => 'Ṹ',
'ṹ' => 'ṹ',
'Ṻ' => 'Ṻ',
'ṻ' => 'ṻ',
'Ṽ' => 'Ṽ',
'ṽ' => 'ṽ',
'Ṿ' => 'Ṿ',
'ṿ' => 'ṿ',
'Ẁ' => 'Ẁ',
'ẁ' => 'ẁ',
'Ẃ' => 'Ẃ',
'ẃ' => 'ẃ',
'Ẅ' => 'Ẅ',
'ẅ' => 'ẅ',
'Ẇ' => 'Ẇ',
'ẇ' => 'ẇ',
'Ẉ' => 'Ẉ',
'ẉ' => 'ẉ',
'Ẋ' => 'Ẋ',
'ẋ' => 'ẋ',
'Ẍ' => 'Ẍ',
'ẍ' => 'ẍ',
'Ẏ' => 'Ẏ',
'ẏ' => 'ẏ',
'Ẑ' => 'Ẑ',
'ẑ' => 'ẑ',
'Ẓ' => 'Ẓ',
'ẓ' => 'ẓ',
'Ẕ' => 'Ẕ',
'ẕ' => 'ẕ',
'ẖ' => 'ẖ',
'ẗ' => 'ẗ',
'ẘ' => 'ẘ',
'ẙ' => 'ẙ',
'ẛ' => 'ẛ',
'Ạ' => 'Ạ',
'ạ' => 'ạ',
'Ả' => 'Ả',
'ả' => 'ả',
'Ấ' => 'Ấ',
'ấ' => 'ấ',
'Ầ' => 'Ầ',
'ầ' => 'ầ',
'Ẩ' => 'Ẩ',
'ẩ' => 'ẩ',
'Ẫ' => 'Ẫ',
'ẫ' => 'ẫ',
'Ậ' => 'Ậ',
'ậ' => 'ậ',
'Ắ' => 'Ắ',
'ắ' => 'ắ',
'Ằ' => 'Ằ',
'ằ' => 'ằ',
'Ẳ' => 'Ẳ',
'ẳ' => 'ẳ',
'Ẵ' => 'Ẵ',
'ẵ' => 'ẵ',
'Ặ' => 'Ặ',
'ặ' => 'ặ',
'Ẹ' => 'Ẹ',
'ẹ' => 'ẹ',
'Ẻ' => 'Ẻ',
'ẻ' => 'ẻ',
'Ẽ' => 'Ẽ',
'ẽ' => 'ẽ',
'Ế' => 'Ế',
'ế' => 'ế',
'Ề' => 'Ề',
'ề' => 'ề',
'Ể' => 'Ể',
'ể' => 'ể',
'Ễ' => 'Ễ',
'ễ' => 'ễ',
'Ệ' => 'Ệ',
'ệ' => 'ệ',
'Ỉ' => 'Ỉ',
'ỉ' => 'ỉ',
'Ị' => 'Ị',
'ị' => 'ị',
'Ọ' => 'Ọ',
'ọ' => 'ọ',
'Ỏ' => 'Ỏ',
'ỏ' => 'ỏ',
'Ố' => 'Ố',
'ố' => 'ố',
'Ồ' => 'Ồ',
'ồ' => 'ồ',
'Ổ' => 'Ổ',
'ổ' => 'ổ',
'Ỗ' => 'Ỗ',
'ỗ' => 'ỗ',
'Ộ' => 'Ộ',
'ộ' => 'ộ',
'Ớ' => 'Ớ',
'ớ' => 'ớ',
'Ờ' => 'Ờ',
'ờ' => 'ờ',
'Ở' => 'Ở',
'ở' => 'ở',
'Ỡ' => 'Ỡ',
'ỡ' => 'ỡ',
'Ợ' => 'Ợ',
'ợ' => 'ợ',
'Ụ' => 'Ụ',
'ụ' => 'ụ',
'Ủ' => 'Ủ',
'ủ' => 'ủ',
'Ứ' => 'Ứ',
'ứ' => 'ứ',
'Ừ' => 'Ừ',
'ừ' => 'ừ',
'Ử' => 'Ử',
'ử' => 'ử',
'Ữ' => 'Ữ',
'ữ' => 'ữ',
'Ự' => 'Ự',
'ự' => 'ự',
'Ỳ' => 'Ỳ',
'ỳ' => 'ỳ',
'Ỵ' => 'Ỵ',
'ỵ' => 'ỵ',
'Ỷ' => 'Ỷ',
'ỷ' => 'ỷ',
'Ỹ' => 'Ỹ',
'ỹ' => 'ỹ',
'ἀ' => 'ἀ',
'ἁ' => 'ἁ',
'ἂ' => 'ἂ',
'ἃ' => 'ἃ',
'ἄ' => 'ἄ',
'ἅ' => 'ἅ',
'ἆ' => 'ἆ',
'ἇ' => 'ἇ',
'Ἀ' => 'Ἀ',
'Ἁ' => 'Ἁ',
'Ἂ' => 'Ἂ',
'Ἃ' => 'Ἃ',
'Ἄ' => 'Ἄ',
'Ἅ' => 'Ἅ',
'Ἆ' => 'Ἆ',
'Ἇ' => 'Ἇ',
'ἐ' => 'ἐ',
'ἑ' => 'ἑ',
'ἒ' => 'ἒ',
'ἓ' => 'ἓ',
'ἔ' => 'ἔ',
'ἕ' => 'ἕ',
'Ἐ' => 'Ἐ',
'Ἑ' => 'Ἑ',
'Ἒ' => 'Ἒ',
'Ἓ' => 'Ἓ',
'Ἔ' => 'Ἔ',
'Ἕ' => 'Ἕ',
'ἠ' => 'ἠ',
'ἡ' => 'ἡ',
'ἢ' => 'ἢ',
'ἣ' => 'ἣ',
'ἤ' => 'ἤ',
'ἥ' => 'ἥ',
'ἦ' => 'ἦ',
'ἧ' => 'ἧ',
'Ἠ' => 'Ἠ',
'Ἡ' => 'Ἡ',
'Ἢ' => 'Ἢ',
'Ἣ' => 'Ἣ',
'Ἤ' => 'Ἤ',
'Ἥ' => 'Ἥ',
'Ἦ' => 'Ἦ',
'Ἧ' => 'Ἧ',
'ἰ' => 'ἰ',
'ἱ' => 'ἱ',
'ἲ' => 'ἲ',
'ἳ' => 'ἳ',
'ἴ' => 'ἴ',
'ἵ' => 'ἵ',
'ἶ' => 'ἶ',
'ἷ' => 'ἷ',
'Ἰ' => 'Ἰ',
'Ἱ' => 'Ἱ',
'Ἲ' => 'Ἲ',
'Ἳ' => 'Ἳ',
'Ἴ' => 'Ἴ',
'Ἵ' => 'Ἵ',
'Ἶ' => 'Ἶ',
'Ἷ' => 'Ἷ',
'ὀ' => 'ὀ',
'ὁ' => 'ὁ',
'ὂ' => 'ὂ',
'ὃ' => 'ὃ',
'ὄ' => 'ὄ',
'ὅ' => 'ὅ',
'Ὀ' => 'Ὀ',
'Ὁ' => 'Ὁ',
'Ὂ' => 'Ὂ',
'Ὃ' => 'Ὃ',
'Ὄ' => 'Ὄ',
'Ὅ' => 'Ὅ',
'ὐ' => 'ὐ',
'ὑ' => 'ὑ',
'ὒ' => 'ὒ',
'ὓ' => 'ὓ',
'ὔ' => 'ὔ',
'ὕ' => 'ὕ',
'ὖ' => 'ὖ',
'ὗ' => 'ὗ',
'Ὑ' => 'Ὑ',
'Ὓ' => 'Ὓ',
'Ὕ' => 'Ὕ',
'Ὗ' => 'Ὗ',
'ὠ' => 'ὠ',
'ὡ' => 'ὡ',
'ὢ' => 'ὢ',
'ὣ' => 'ὣ',
'ὤ' => 'ὤ',
'ὥ' => 'ὥ',
'ὦ' => 'ὦ',
'ὧ' => 'ὧ',
'Ὠ' => 'Ὠ',
'Ὡ' => 'Ὡ',
'Ὢ' => 'Ὢ',
'Ὣ' => 'Ὣ',
'Ὤ' => 'Ὤ',
'Ὥ' => 'Ὥ',
'Ὦ' => 'Ὦ',
'Ὧ' => 'Ὧ',
'ὰ' => 'ὰ',
'ὲ' => 'ὲ',
'ὴ' => 'ὴ',
'ὶ' => 'ὶ',
'ὸ' => 'ὸ',
'ὺ' => 'ὺ',
'ὼ' => 'ὼ',
'ᾀ' => 'ᾀ',
'ᾁ' => 'ᾁ',
'ᾂ' => 'ᾂ',
'ᾃ' => 'ᾃ',
'ᾄ' => 'ᾄ',
'ᾅ' => 'ᾅ',
'ᾆ' => 'ᾆ',
'ᾇ' => 'ᾇ',
'ᾈ' => 'ᾈ',
'ᾉ' => 'ᾉ',
'ᾊ' => 'ᾊ',
'ᾋ' => 'ᾋ',
'ᾌ' => 'ᾌ',
'ᾍ' => 'ᾍ',
'ᾎ' => 'ᾎ',
'ᾏ' => 'ᾏ',
'ᾐ' => 'ᾐ',
'ᾑ' => 'ᾑ',
'ᾒ' => 'ᾒ',
'ᾓ' => 'ᾓ',
'ᾔ' => 'ᾔ',
'ᾕ' => 'ᾕ',
'ᾖ' => 'ᾖ',
'ᾗ' => 'ᾗ',
'ᾘ' => 'ᾘ',
'ᾙ' => 'ᾙ',
'ᾚ' => 'ᾚ',
'ᾛ' => 'ᾛ',
'ᾜ' => 'ᾜ',
'ᾝ' => 'ᾝ',
'ᾞ' => 'ᾞ',
'ᾟ' => 'ᾟ',
'ᾠ' => 'ᾠ',
'ᾡ' => 'ᾡ',
'ᾢ' => 'ᾢ',
'ᾣ' => 'ᾣ',
'ᾤ' => 'ᾤ',
'ᾥ' => 'ᾥ',
'ᾦ' => 'ᾦ',
'ᾧ' => 'ᾧ',
'ᾨ' => 'ᾨ',
'ᾩ' => 'ᾩ',
'ᾪ' => 'ᾪ',
'ᾫ' => 'ᾫ',
'ᾬ' => 'ᾬ',
'ᾭ' => 'ᾭ',
'ᾮ' => 'ᾮ',
'ᾯ' => 'ᾯ',
'ᾰ' => 'ᾰ',
'ᾱ' => 'ᾱ',
'ᾲ' => 'ᾲ',
'ᾳ' => 'ᾳ',
'ᾴ' => 'ᾴ',
'ᾶ' => 'ᾶ',
'ᾷ' => 'ᾷ',
'Ᾰ' => 'Ᾰ',
'Ᾱ' => 'Ᾱ',
'Ὰ' => 'Ὰ',
'ᾼ' => 'ᾼ',
'῁' => '῁',
'ῂ' => 'ῂ',
'ῃ' => 'ῃ',
'ῄ' => 'ῄ',
'ῆ' => 'ῆ',
'ῇ' => 'ῇ',
'Ὲ' => 'Ὲ',
'Ὴ' => 'Ὴ',
'ῌ' => 'ῌ',
'῍' => '῍',
'῎' => '῎',
'῏' => '῏',
'ῐ' => 'ῐ',
'ῑ' => 'ῑ',
'ῒ' => 'ῒ',
'ῖ' => 'ῖ',
'ῗ' => 'ῗ',
'Ῐ' => 'Ῐ',
'Ῑ' => 'Ῑ',
'Ὶ' => 'Ὶ',
'῝' => '῝',
'῞' => '῞',
'῟' => '῟',
'ῠ' => 'ῠ',
'ῡ' => 'ῡ',
'ῢ' => 'ῢ',
'ῤ' => 'ῤ',
'ῥ' => 'ῥ',
'ῦ' => 'ῦ',
'ῧ' => 'ῧ',
'Ῠ' => 'Ῠ',
'Ῡ' => 'Ῡ',
'Ὺ' => 'Ὺ',
'Ῥ' => 'Ῥ',
'῭' => '῭',
'ῲ' => 'ῲ',
'ῳ' => 'ῳ',
'ῴ' => 'ῴ',
'ῶ' => 'ῶ',
'ῷ' => 'ῷ',
'Ὸ' => 'Ὸ',
'Ὼ' => 'Ὼ',
'ῼ' => 'ῼ',
'↚' => '↚',
'↛' => '↛',
'↮' => '↮',
'⇍' => '⇍',
'⇎' => '⇎',
'⇏' => '⇏',
'∄' => '∄',
'∉' => '∉',
'∌' => '∌',
'∤' => '∤',
'∦' => '∦',
'≁' => '≁',
'≄' => '≄',
'≇' => '≇',
'≉' => '≉',
'≠' => '≠',
'≢' => '≢',
'≭' => '≭',
'≮' => '≮',
'≯' => '≯',
'≰' => '≰',
'≱' => '≱',
'≴' => '≴',
'≵' => '≵',
'≸' => '≸',
'≹' => '≹',
'⊀' => '⊀',
'⊁' => '⊁',
'⊄' => '⊄',
'⊅' => '⊅',
'⊈' => '⊈',
'⊉' => '⊉',
'⊬' => '⊬',
'⊭' => '⊭',
'⊮' => '⊮',
'⊯' => '⊯',
'⋠' => '⋠',
'⋡' => '⋡',
'⋢' => '⋢',
'⋣' => '⋣',
'⋪' => '⋪',
'⋫' => '⋫',
'⋬' => '⋬',
'⋭' => '⋭',
'が' => 'が',
'ぎ' => 'ぎ',
'ぐ' => 'ぐ',
'げ' => 'げ',
'ご' => 'ご',
'ざ' => 'ざ',
'じ' => 'じ',
'ず' => 'ず',
'ぜ' => 'ぜ',
'ぞ' => 'ぞ',
'だ' => 'だ',
'ぢ' => 'ぢ',
'づ' => 'づ',
'で' => 'で',
'ど' => 'ど',
'ば' => 'ば',
'ぱ' => 'ぱ',
'び' => 'び',
'ぴ' => 'ぴ',
'ぶ' => 'ぶ',
'ぷ' => 'ぷ',
'べ' => 'べ',
'ぺ' => 'ぺ',
'ぼ' => 'ぼ',
'ぽ' => 'ぽ',
'ゔ' => 'ゔ',
'ゞ' => 'ゞ',
'ガ' => 'ガ',
'ギ' => 'ギ',
'グ' => 'グ',
'ゲ' => 'ゲ',
'ゴ' => 'ゴ',
'ザ' => 'ザ',
'ジ' => 'ジ',
'ズ' => 'ズ',
'ゼ' => 'ゼ',
'ゾ' => 'ゾ',
'ダ' => 'ダ',
'ヂ' => 'ヂ',
'ヅ' => 'ヅ',
'デ' => 'デ',
'ド' => 'ド',
'バ' => 'バ',
'パ' => 'パ',
'ビ' => 'ビ',
'ピ' => 'ピ',
'ブ' => 'ブ',
'プ' => 'プ',
'ベ' => 'ベ',
'ペ' => 'ペ',
'ボ' => 'ボ',
'ポ' => 'ポ',
'ヴ' => 'ヴ',
'ヷ' => 'ヷ',
'ヸ' => 'ヸ',
'ヹ' => 'ヹ',
'ヺ' => 'ヺ',
'ヾ' => 'ヾ',
'𑂚' => '𑂚',
'𑂜' => '𑂜',
'𑂫' => '𑂫',
'𑄮' => '𑄮',
'𑄯' => '𑄯',
'𑍋' => '𑍋',
'𑍌' => '𑍌',
'𑒻' => '𑒻',
'𑒼' => '𑒼',
'𑒾' => '𑒾',
'𑖺' => '𑖺',
'𑖻' => '𑖻',
'𑤸' => '𑤸',
);
<?php
return array (
'À' => 'À',
'Á' => 'Á',
'Â' => 'Â',
'Ã' => 'Ã',
'Ä' => 'Ä',
'Å' => 'Å',
'Ç' => 'Ç',
'È' => 'È',
'É' => 'É',
'Ê' => 'Ê',
'Ë' => 'Ë',
'Ì' => 'Ì',
'Í' => 'Í',
'Î' => 'Î',
'Ï' => 'Ï',
'Ñ' => 'Ñ',
'Ò' => 'Ò',
'Ó' => 'Ó',
'Ô' => 'Ô',
'Õ' => 'Õ',
'Ö' => 'Ö',
'Ù' => 'Ù',
'Ú' => 'Ú',
'Û' => 'Û',
'Ü' => 'Ü',
'Ý' => 'Ý',
'à' => 'à',
'á' => 'á',
'â' => 'â',
'ã' => 'ã',
'ä' => 'ä',
'å' => 'å',
'ç' => 'ç',
'è' => 'è',
'é' => 'é',
'ê' => 'ê',
'ë' => 'ë',
'ì' => 'ì',
'í' => 'í',
'î' => 'î',
'ï' => 'ï',
'ñ' => 'ñ',
'ò' => 'ò',
'ó' => 'ó',
'ô' => 'ô',
'õ' => 'õ',
'ö' => 'ö',
'ù' => 'ù',
'ú' => 'ú',
'û' => 'û',
'ü' => 'ü',
'ý' => 'ý',
'ÿ' => 'ÿ',
'Ā' => 'Ā',
'ā' => 'ā',
'Ă' => 'Ă',
'ă' => 'ă',
'Ą' => 'Ą',
'ą' => 'ą',
'Ć' => 'Ć',
'ć' => 'ć',
'Ĉ' => 'Ĉ',
'ĉ' => 'ĉ',
'Ċ' => 'Ċ',
'ċ' => 'ċ',
'Č' => 'Č',
'č' => 'č',
'Ď' => 'Ď',
'ď' => 'ď',
'Ē' => 'Ē',
'ē' => 'ē',
'Ĕ' => 'Ĕ',
'ĕ' => 'ĕ',
'Ė' => 'Ė',
'ė' => 'ė',
'Ę' => 'Ę',
'ę' => 'ę',
'Ě' => 'Ě',
'ě' => 'ě',
'Ĝ' => 'Ĝ',
'ĝ' => 'ĝ',
'Ğ' => 'Ğ',
'ğ' => 'ğ',
'Ġ' => 'Ġ',
'ġ' => 'ġ',
'Ģ' => 'Ģ',
'ģ' => 'ģ',
'Ĥ' => 'Ĥ',
'ĥ' => 'ĥ',
'Ĩ' => 'Ĩ',
'ĩ' => 'ĩ',
'Ī' => 'Ī',
'ī' => 'ī',
'Ĭ' => 'Ĭ',
'ĭ' => 'ĭ',
'Į' => 'Į',
'į' => 'į',
'İ' => 'İ',
'Ĵ' => 'Ĵ',
'ĵ' => 'ĵ',
'Ķ' => 'Ķ',
'ķ' => 'ķ',
'Ĺ' => 'Ĺ',
'ĺ' => 'ĺ',
'Ļ' => 'Ļ',
'ļ' => 'ļ',
'Ľ' => 'Ľ',
'ľ' => 'ľ',
'Ń' => 'Ń',
'ń' => 'ń',
'Ņ' => 'Ņ',
'ņ' => 'ņ',
'Ň' => 'Ň',
'ň' => 'ň',
'Ō' => 'Ō',
'ō' => 'ō',
'Ŏ' => 'Ŏ',
'ŏ' => 'ŏ',
'Ő' => 'Ő',
'ő' => 'ő',
'Ŕ' => 'Ŕ',
'ŕ' => 'ŕ',
'Ŗ' => 'Ŗ',
'ŗ' => 'ŗ',
'Ř' => 'Ř',
'ř' => 'ř',
'Ś' => 'Ś',
'ś' => 'ś',
'Ŝ' => 'Ŝ',
'ŝ' => 'ŝ',
'Ş' => 'Ş',
'ş' => 'ş',
'Š' => 'Š',
'š' => 'š',
'Ţ' => 'Ţ',
'ţ' => 'ţ',
'Ť' => 'Ť',
'ť' => 'ť',
'Ũ' => 'Ũ',
'ũ' => 'ũ',
'Ū' => 'Ū',
'ū' => 'ū',
'Ŭ' => 'Ŭ',
'ŭ' => 'ŭ',
'Ů' => 'Ů',
'ů' => 'ů',
'Ű' => 'Ű',
'ű' => 'ű',
'Ų' => 'Ų',
'ų' => 'ų',
'Ŵ' => 'Ŵ',
'ŵ' => 'ŵ',
'Ŷ' => 'Ŷ',
'ŷ' => 'ŷ',
'Ÿ' => 'Ÿ',
'Ź' => 'Ź',
'ź' => 'ź',
'Ż' => 'Ż',
'ż' => 'ż',
'Ž' => 'Ž',
'ž' => 'ž',
'Ơ' => 'Ơ',
'ơ' => 'ơ',
'Ư' => 'Ư',
'ư' => 'ư',
'Ǎ' => 'Ǎ',
'ǎ' => 'ǎ',
'Ǐ' => 'Ǐ',
'ǐ' => 'ǐ',
'Ǒ' => 'Ǒ',
'ǒ' => 'ǒ',
'Ǔ' => 'Ǔ',
'ǔ' => 'ǔ',
'Ǖ' => 'Ǖ',
'ǖ' => 'ǖ',
'Ǘ' => 'Ǘ',
'ǘ' => 'ǘ',
'Ǚ' => 'Ǚ',
'ǚ' => 'ǚ',
'Ǜ' => 'Ǜ',
'ǜ' => 'ǜ',
'Ǟ' => 'Ǟ',
'ǟ' => 'ǟ',
'Ǡ' => 'Ǡ',
'ǡ' => 'ǡ',
'Ǣ' => 'Ǣ',
'ǣ' => 'ǣ',
'Ǧ' => 'Ǧ',
'ǧ' => 'ǧ',
'Ǩ' => 'Ǩ',
'ǩ' => 'ǩ',
'Ǫ' => 'Ǫ',
'ǫ' => 'ǫ',
'Ǭ' => 'Ǭ',
'ǭ' => 'ǭ',
'Ǯ' => 'Ǯ',
'ǯ' => 'ǯ',
'ǰ' => 'ǰ',
'Ǵ' => 'Ǵ',
'ǵ' => 'ǵ',
'Ǹ' => 'Ǹ',
'ǹ' => 'ǹ',
'Ǻ' => 'Ǻ',
'ǻ' => 'ǻ',
'Ǽ' => 'Ǽ',
'ǽ' => 'ǽ',
'Ǿ' => 'Ǿ',
'ǿ' => 'ǿ',
'Ȁ' => 'Ȁ',
'ȁ' => 'ȁ',
'Ȃ' => 'Ȃ',
'ȃ' => 'ȃ',
'Ȅ' => 'Ȅ',
'ȅ' => 'ȅ',
'Ȇ' => 'Ȇ',
'ȇ' => 'ȇ',
'Ȉ' => 'Ȉ',
'ȉ' => 'ȉ',
'Ȋ' => 'Ȋ',
'ȋ' => 'ȋ',
'Ȍ' => 'Ȍ',
'ȍ' => 'ȍ',
'Ȏ' => 'Ȏ',
'ȏ' => 'ȏ',
'Ȑ' => 'Ȑ',
'ȑ' => 'ȑ',
'Ȓ' => 'Ȓ',
'ȓ' => 'ȓ',
'Ȕ' => 'Ȕ',
'ȕ' => 'ȕ',
'Ȗ' => 'Ȗ',
'ȗ' => 'ȗ',
'Ș' => 'Ș',
'ș' => 'ș',
'Ț' => 'Ț',
'ț' => 'ț',
'Ȟ' => 'Ȟ',
'ȟ' => 'ȟ',
'Ȧ' => 'Ȧ',
'ȧ' => 'ȧ',
'Ȩ' => 'Ȩ',
'ȩ' => 'ȩ',
'Ȫ' => 'Ȫ',
'ȫ' => 'ȫ',
'Ȭ' => 'Ȭ',
'ȭ' => 'ȭ',
'Ȯ' => 'Ȯ',
'ȯ' => 'ȯ',
'Ȱ' => 'Ȱ',
'ȱ' => 'ȱ',
'Ȳ' => 'Ȳ',
'ȳ' => 'ȳ',
'̀' => '̀',
'́' => '́',
'̓' => '̓',
'̈́' => '̈́',
'ʹ' => 'ʹ',
';' => ';',
'΅' => '΅',
'Ά' => 'Ά',
'·' => '·',
'Έ' => 'Έ',
'Ή' => 'Ή',
'Ί' => 'Ί',
'Ό' => 'Ό',
'Ύ' => 'Ύ',
'Ώ' => 'Ώ',
'ΐ' => 'ΐ',
'Ϊ' => 'Ϊ',
'Ϋ' => 'Ϋ',
'ά' => 'ά',
'έ' => 'έ',
'ή' => 'ή',
'ί' => 'ί',
'ΰ' => 'ΰ',
'ϊ' => 'ϊ',
'ϋ' => 'ϋ',
'ό' => 'ό',
'ύ' => 'ύ',
'ώ' => 'ώ',
'ϓ' => 'ϓ',
'ϔ' => 'ϔ',
'Ѐ' => 'Ѐ',
'Ё' => 'Ё',
'Ѓ' => 'Ѓ',
'Ї' => 'Ї',
'Ќ' => 'Ќ',
'Ѝ' => 'Ѝ',
'Ў' => 'Ў',
'Й' => 'Й',
'й' => 'й',
'ѐ' => 'ѐ',
'ё' => 'ё',
'ѓ' => 'ѓ',
'ї' => 'ї',
'ќ' => 'ќ',
'ѝ' => 'ѝ',
'ў' => 'ў',
'Ѷ' => 'Ѷ',
'ѷ' => 'ѷ',
'Ӂ' => 'Ӂ',
'ӂ' => 'ӂ',
'Ӑ' => 'Ӑ',
'ӑ' => 'ӑ',
'Ӓ' => 'Ӓ',
'ӓ' => 'ӓ',
'Ӗ' => 'Ӗ',
'ӗ' => 'ӗ',
'Ӛ' => 'Ӛ',
'ӛ' => 'ӛ',
'Ӝ' => 'Ӝ',
'ӝ' => 'ӝ',
'Ӟ' => 'Ӟ',
'ӟ' => 'ӟ',
'Ӣ' => 'Ӣ',
'ӣ' => 'ӣ',
'Ӥ' => 'Ӥ',
'ӥ' => 'ӥ',
'Ӧ' => 'Ӧ',
'ӧ' => 'ӧ',
'Ӫ' => 'Ӫ',
'ӫ' => 'ӫ',
'Ӭ' => 'Ӭ',
'ӭ' => 'ӭ',
'Ӯ' => 'Ӯ',
'ӯ' => 'ӯ',
'Ӱ' => 'Ӱ',
'ӱ' => 'ӱ',
'Ӳ' => 'Ӳ',
'ӳ' => 'ӳ',
'Ӵ' => 'Ӵ',
'ӵ' => 'ӵ',
'Ӹ' => 'Ӹ',
'ӹ' => 'ӹ',
'آ' => 'آ',
'أ' => 'أ',
'ؤ' => 'ؤ',
'إ' => 'إ',
'ئ' => 'ئ',
'ۀ' => 'ۀ',
'ۂ' => 'ۂ',
'ۓ' => 'ۓ',
'ऩ' => 'ऩ',
'ऱ' => 'ऱ',
'ऴ' => 'ऴ',
'क़' => 'क़',
'ख़' => 'ख़',
'ग़' => 'ग़',
'ज़' => 'ज़',
'ड़' => 'ड़',
'ढ़' => 'ढ़',
'फ़' => 'फ़',
'य़' => 'य़',
'ো' => 'ো',
'ৌ' => 'ৌ',
'ড়' => 'ড়',
'ঢ়' => 'ঢ়',
'য়' => 'য়',
'ਲ਼' => 'ਲ਼',
'ਸ਼' => 'ਸ਼',
'ਖ਼' => 'ਖ਼',
'ਗ਼' => 'ਗ਼',
'ਜ਼' => 'ਜ਼',
'ਫ਼' => 'ਫ਼',
'ୈ' => 'ୈ',
'ୋ' => 'ୋ',
'ୌ' => 'ୌ',
'ଡ଼' => 'ଡ଼',
'ଢ଼' => 'ଢ଼',
'ஔ' => 'ஔ',
'ொ' => 'ொ',
'ோ' => 'ோ',
'ௌ' => 'ௌ',
'ై' => 'ై',
'ೀ' => 'ೀ',
'ೇ' => 'ೇ',
'ೈ' => 'ೈ',
'ೊ' => 'ೊ',
'ೋ' => 'ೋ',
'ൊ' => 'ൊ',
'ോ' => 'ോ',
'ൌ' => 'ൌ',
'ේ' => 'ේ',
'ො' => 'ො',
'ෝ' => 'ෝ',
'ෞ' => 'ෞ',
'གྷ' => 'གྷ',
'ཌྷ' => 'ཌྷ',
'དྷ' => 'དྷ',
'བྷ' => 'བྷ',
'ཛྷ' => 'ཛྷ',
'ཀྵ' => 'ཀྵ',
'ཱི' => 'ཱི',
'ཱུ' => 'ཱུ',
'ྲྀ' => 'ྲྀ',
'ླྀ' => 'ླྀ',
'ཱྀ' => 'ཱྀ',
'ྒྷ' => 'ྒྷ',
'ྜྷ' => 'ྜྷ',
'ྡྷ' => 'ྡྷ',
'ྦྷ' => 'ྦྷ',
'ྫྷ' => 'ྫྷ',
'ྐྵ' => 'ྐྵ',
'ဦ' => 'ဦ',
'ᬆ' => 'ᬆ',
'ᬈ' => 'ᬈ',
'ᬊ' => 'ᬊ',
'ᬌ' => 'ᬌ',
'ᬎ' => 'ᬎ',
'ᬒ' => 'ᬒ',
'ᬻ' => 'ᬻ',
'ᬽ' => 'ᬽ',
'ᭀ' => 'ᭀ',
'ᭁ' => 'ᭁ',
'ᭃ' => 'ᭃ',
'Ḁ' => 'Ḁ',
'ḁ' => 'ḁ',
'Ḃ' => 'Ḃ',
'ḃ' => 'ḃ',
'Ḅ' => 'Ḅ',
'ḅ' => 'ḅ',
'Ḇ' => 'Ḇ',
'ḇ' => 'ḇ',
'Ḉ' => 'Ḉ',
'ḉ' => 'ḉ',
'Ḋ' => 'Ḋ',
'ḋ' => 'ḋ',
'Ḍ' => 'Ḍ',
'ḍ' => 'ḍ',
'Ḏ' => 'Ḏ',
'ḏ' => 'ḏ',
'Ḑ' => 'Ḑ',
'ḑ' => 'ḑ',
'Ḓ' => 'Ḓ',
'ḓ' => 'ḓ',
'Ḕ' => 'Ḕ',
'ḕ' => 'ḕ',
'Ḗ' => 'Ḗ',
'ḗ' => 'ḗ',
'Ḙ' => 'Ḙ',
'ḙ' => 'ḙ',
'Ḛ' => 'Ḛ',
'ḛ' => 'ḛ',
'Ḝ' => 'Ḝ',
'ḝ' => 'ḝ',
'Ḟ' => 'Ḟ',
'ḟ' => 'ḟ',
'Ḡ' => 'Ḡ',
'ḡ' => 'ḡ',
'Ḣ' => 'Ḣ',
'ḣ' => 'ḣ',
'Ḥ' => 'Ḥ',
'ḥ' => 'ḥ',
'Ḧ' => 'Ḧ',
'ḧ' => 'ḧ',
'Ḩ' => 'Ḩ',
'ḩ' => 'ḩ',
'Ḫ' => 'Ḫ',
'ḫ' => 'ḫ',
'Ḭ' => 'Ḭ',
'ḭ' => 'ḭ',
'Ḯ' => 'Ḯ',
'ḯ' => 'ḯ',
'Ḱ' => 'Ḱ',
'ḱ' => 'ḱ',
'Ḳ' => 'Ḳ',
'ḳ' => 'ḳ',
'Ḵ' => 'Ḵ',
'ḵ' => 'ḵ',
'Ḷ' => 'Ḷ',
'ḷ' => 'ḷ',
'Ḹ' => 'Ḹ',
'ḹ' => 'ḹ',
'Ḻ' => 'Ḻ',
'ḻ' => 'ḻ',
'Ḽ' => 'Ḽ',
'ḽ' => 'ḽ',
'Ḿ' => 'Ḿ',
'ḿ' => 'ḿ',
'Ṁ' => 'Ṁ',
'ṁ' => 'ṁ',
'Ṃ' => 'Ṃ',
'ṃ' => 'ṃ',
'Ṅ' => 'Ṅ',
'ṅ' => 'ṅ',
'Ṇ' => 'Ṇ',
'ṇ' => 'ṇ',
'Ṉ' => 'Ṉ',
'ṉ' => 'ṉ',
'Ṋ' => 'Ṋ',
'ṋ' => 'ṋ',
'Ṍ' => 'Ṍ',
'ṍ' => 'ṍ',
'Ṏ' => 'Ṏ',
'ṏ' => 'ṏ',
'Ṑ' => 'Ṑ',
'ṑ' => 'ṑ',
'Ṓ' => 'Ṓ',
'ṓ' => 'ṓ',
'Ṕ' => 'Ṕ',
'ṕ' => 'ṕ',
'Ṗ' => 'Ṗ',
'ṗ' => 'ṗ',
'Ṙ' => 'Ṙ',
'ṙ' => 'ṙ',
'Ṛ' => 'Ṛ',
'ṛ' => 'ṛ',
'Ṝ' => 'Ṝ',
'ṝ' => 'ṝ',
'Ṟ' => 'Ṟ',
'ṟ' => 'ṟ',
'Ṡ' => 'Ṡ',
'ṡ' => 'ṡ',
'Ṣ' => 'Ṣ',
'ṣ' => 'ṣ',
'Ṥ' => 'Ṥ',
'ṥ' => 'ṥ',
'Ṧ' => 'Ṧ',
'ṧ' => 'ṧ',
'Ṩ' => 'Ṩ',
'ṩ' => 'ṩ',
'Ṫ' => 'Ṫ',
'ṫ' => 'ṫ',
'Ṭ' => 'Ṭ',
'ṭ' => 'ṭ',
'Ṯ' => 'Ṯ',
'ṯ' => 'ṯ',
'Ṱ' => 'Ṱ',
'ṱ' => 'ṱ',
'Ṳ' => 'Ṳ',
'ṳ' => 'ṳ',
'Ṵ' => 'Ṵ',
'ṵ' => 'ṵ',
'Ṷ' => 'Ṷ',
'ṷ' => 'ṷ',
'Ṹ' => 'Ṹ',
'ṹ' => 'ṹ',
'Ṻ' => 'Ṻ',
'ṻ' => 'ṻ',
'Ṽ' => 'Ṽ',
'ṽ' => 'ṽ',
'Ṿ' => 'Ṿ',
'ṿ' => 'ṿ',
'Ẁ' => 'Ẁ',
'ẁ' => 'ẁ',
'Ẃ' => 'Ẃ',
'ẃ' => 'ẃ',
'Ẅ' => 'Ẅ',
'ẅ' => 'ẅ',
'Ẇ' => 'Ẇ',
'ẇ' => 'ẇ',
'Ẉ' => 'Ẉ',
'ẉ' => 'ẉ',
'Ẋ' => 'Ẋ',
'ẋ' => 'ẋ',
'Ẍ' => 'Ẍ',
'ẍ' => 'ẍ',
'Ẏ' => 'Ẏ',
'ẏ' => 'ẏ',
'Ẑ' => 'Ẑ',
'ẑ' => 'ẑ',
'Ẓ' => 'Ẓ',
'ẓ' => 'ẓ',
'Ẕ' => 'Ẕ',
'ẕ' => 'ẕ',
'ẖ' => 'ẖ',
'ẗ' => 'ẗ',
'ẘ' => 'ẘ',
'ẙ' => 'ẙ',
'ẛ' => 'ẛ',
'Ạ' => 'Ạ',
'ạ' => 'ạ',
'Ả' => 'Ả',
'ả' => 'ả',
'Ấ' => 'Ấ',
'ấ' => 'ấ',
'Ầ' => 'Ầ',
'ầ' => 'ầ',
'Ẩ' => 'Ẩ',
'ẩ' => 'ẩ',
'Ẫ' => 'Ẫ',
'ẫ' => 'ẫ',
'Ậ' => 'Ậ',
'ậ' => 'ậ',
'Ắ' => 'Ắ',
'ắ' => 'ắ',
'Ằ' => 'Ằ',
'ằ' => 'ằ',
'Ẳ' => 'Ẳ',
'ẳ' => 'ẳ',
'Ẵ' => 'Ẵ',
'ẵ' => 'ẵ',
'Ặ' => 'Ặ',
'ặ' => 'ặ',
'Ẹ' => 'Ẹ',
'ẹ' => 'ẹ',
'Ẻ' => 'Ẻ',
'ẻ' => 'ẻ',
'Ẽ' => 'Ẽ',
'ẽ' => 'ẽ',
'Ế' => 'Ế',
'ế' => 'ế',
'Ề' => 'Ề',
'ề' => 'ề',
'Ể' => 'Ể',
'ể' => 'ể',
'Ễ' => 'Ễ',
'ễ' => 'ễ',
'Ệ' => 'Ệ',
'ệ' => 'ệ',
'Ỉ' => 'Ỉ',
'ỉ' => 'ỉ',
'Ị' => 'Ị',
'ị' => 'ị',
'Ọ' => 'Ọ',
'ọ' => 'ọ',
'Ỏ' => 'Ỏ',
'ỏ' => 'ỏ',
'Ố' => 'Ố',
'ố' => 'ố',
'Ồ' => 'Ồ',
'ồ' => 'ồ',
'Ổ' => 'Ổ',
'ổ' => 'ổ',
'Ỗ' => 'Ỗ',
'ỗ' => 'ỗ',
'Ộ' => 'Ộ',
'ộ' => 'ộ',
'Ớ' => 'Ớ',
'ớ' => 'ớ',
'Ờ' => 'Ờ',
'ờ' => 'ờ',
'Ở' => 'Ở',
'ở' => 'ở',
'Ỡ' => 'Ỡ',
'ỡ' => 'ỡ',
'Ợ' => 'Ợ',
'ợ' => 'ợ',
'Ụ' => 'Ụ',
'ụ' => 'ụ',
'Ủ' => 'Ủ',
'ủ' => 'ủ',
'Ứ' => 'Ứ',
'ứ' => 'ứ',
'Ừ' => 'Ừ',
'ừ' => 'ừ',
'Ử' => 'Ử',
'ử' => 'ử',
'Ữ' => 'Ữ',
'ữ' => 'ữ',
'Ự' => 'Ự',
'ự' => 'ự',
'Ỳ' => 'Ỳ',
'ỳ' => 'ỳ',
'Ỵ' => 'Ỵ',
'ỵ' => 'ỵ',
'Ỷ' => 'Ỷ',
'ỷ' => 'ỷ',
'Ỹ' => 'Ỹ',
'ỹ' => 'ỹ',
'ἀ' => 'ἀ',
'ἁ' => 'ἁ',
'ἂ' => 'ἂ',
'ἃ' => 'ἃ',
'ἄ' => 'ἄ',
'ἅ' => 'ἅ',
'ἆ' => 'ἆ',
'ἇ' => 'ἇ',
'Ἀ' => 'Ἀ',
'Ἁ' => 'Ἁ',
'Ἂ' => 'Ἂ',
'Ἃ' => 'Ἃ',
'Ἄ' => 'Ἄ',
'Ἅ' => 'Ἅ',
'Ἆ' => 'Ἆ',
'Ἇ' => 'Ἇ',
'ἐ' => 'ἐ',
'ἑ' => 'ἑ',
'ἒ' => 'ἒ',
'ἓ' => 'ἓ',
'ἔ' => 'ἔ',
'ἕ' => 'ἕ',
'Ἐ' => 'Ἐ',
'Ἑ' => 'Ἑ',
'Ἒ' => 'Ἒ',
'Ἓ' => 'Ἓ',
'Ἔ' => 'Ἔ',
'Ἕ' => 'Ἕ',
'ἠ' => 'ἠ',
'ἡ' => 'ἡ',
'ἢ' => 'ἢ',
'ἣ' => 'ἣ',
'ἤ' => 'ἤ',
'ἥ' => 'ἥ',
'ἦ' => 'ἦ',
'ἧ' => 'ἧ',
'Ἠ' => 'Ἠ',
'Ἡ' => 'Ἡ',
'Ἢ' => 'Ἢ',
'Ἣ' => 'Ἣ',
'Ἤ' => 'Ἤ',
'Ἥ' => 'Ἥ',
'Ἦ' => 'Ἦ',
'Ἧ' => 'Ἧ',
'ἰ' => 'ἰ',
'ἱ' => 'ἱ',
'ἲ' => 'ἲ',
'ἳ' => 'ἳ',
'ἴ' => 'ἴ',
'ἵ' => 'ἵ',
'ἶ' => 'ἶ',
'ἷ' => 'ἷ',
'Ἰ' => 'Ἰ',
'Ἱ' => 'Ἱ',
'Ἲ' => 'Ἲ',
'Ἳ' => 'Ἳ',
'Ἴ' => 'Ἴ',
'Ἵ' => 'Ἵ',
'Ἶ' => 'Ἶ',
'Ἷ' => 'Ἷ',
'ὀ' => 'ὀ',
'ὁ' => 'ὁ',
'ὂ' => 'ὂ',
'ὃ' => 'ὃ',
'ὄ' => 'ὄ',
'ὅ' => 'ὅ',
'Ὀ' => 'Ὀ',
'Ὁ' => 'Ὁ',
'Ὂ' => 'Ὂ',
'Ὃ' => 'Ὃ',
'Ὄ' => 'Ὄ',
'Ὅ' => 'Ὅ',
'ὐ' => 'ὐ',
'ὑ' => 'ὑ',
'ὒ' => 'ὒ',
'ὓ' => 'ὓ',
'ὔ' => 'ὔ',
'ὕ' => 'ὕ',
'ὖ' => 'ὖ',
'ὗ' => 'ὗ',
'Ὑ' => 'Ὑ',
'Ὓ' => 'Ὓ',
'Ὕ' => 'Ὕ',
'Ὗ' => 'Ὗ',
'ὠ' => 'ὠ',
'ὡ' => 'ὡ',
'ὢ' => 'ὢ',
'ὣ' => 'ὣ',
'ὤ' => 'ὤ',
'ὥ' => 'ὥ',
'ὦ' => 'ὦ',
'ὧ' => 'ὧ',
'Ὠ' => 'Ὠ',
'Ὡ' => 'Ὡ',
'Ὢ' => 'Ὢ',
'Ὣ' => 'Ὣ',
'Ὤ' => 'Ὤ',
'Ὥ' => 'Ὥ',
'Ὦ' => 'Ὦ',
'Ὧ' => 'Ὧ',
'ὰ' => 'ὰ',
'ά' => 'ά',
'ὲ' => 'ὲ',
'έ' => 'έ',
'ὴ' => 'ὴ',
'ή' => 'ή',
'ὶ' => 'ὶ',
'ί' => 'ί',
'ὸ' => 'ὸ',
'ό' => 'ό',
'ὺ' => 'ὺ',
'ύ' => 'ύ',
'ὼ' => 'ὼ',
'ώ' => 'ώ',
'ᾀ' => 'ᾀ',
'ᾁ' => 'ᾁ',
'ᾂ' => 'ᾂ',
'ᾃ' => 'ᾃ',
'ᾄ' => 'ᾄ',
'ᾅ' => 'ᾅ',
'ᾆ' => 'ᾆ',
'ᾇ' => 'ᾇ',
'ᾈ' => 'ᾈ',
'ᾉ' => 'ᾉ',
'ᾊ' => 'ᾊ',
'ᾋ' => 'ᾋ',
'ᾌ' => 'ᾌ',
'ᾍ' => 'ᾍ',
'ᾎ' => 'ᾎ',
'ᾏ' => 'ᾏ',
'ᾐ' => 'ᾐ',
'ᾑ' => 'ᾑ',
'ᾒ' => 'ᾒ',
'ᾓ' => 'ᾓ',
'ᾔ' => 'ᾔ',
'ᾕ' => 'ᾕ',
'ᾖ' => 'ᾖ',
'ᾗ' => 'ᾗ',
'ᾘ' => 'ᾘ',
'ᾙ' => 'ᾙ',
'ᾚ' => 'ᾚ',
'ᾛ' => 'ᾛ',
'ᾜ' => 'ᾜ',
'ᾝ' => 'ᾝ',
'ᾞ' => 'ᾞ',
'ᾟ' => 'ᾟ',
'ᾠ' => 'ᾠ',
'ᾡ' => 'ᾡ',
'ᾢ' => 'ᾢ',
'ᾣ' => 'ᾣ',
'ᾤ' => 'ᾤ',
'ᾥ' => 'ᾥ',
'ᾦ' => 'ᾦ',
'ᾧ' => 'ᾧ',
'ᾨ' => 'ᾨ',
'ᾩ' => 'ᾩ',
'ᾪ' => 'ᾪ',
'ᾫ' => 'ᾫ',
'ᾬ' => 'ᾬ',
'ᾭ' => 'ᾭ',
'ᾮ' => 'ᾮ',
'ᾯ' => 'ᾯ',
'ᾰ' => 'ᾰ',
'ᾱ' => 'ᾱ',
'ᾲ' => 'ᾲ',
'ᾳ' => 'ᾳ',
'ᾴ' => 'ᾴ',
'ᾶ' => 'ᾶ',
'ᾷ' => 'ᾷ',
'Ᾰ' => 'Ᾰ',
'Ᾱ' => 'Ᾱ',
'Ὰ' => 'Ὰ',
'Ά' => 'Ά',
'ᾼ' => 'ᾼ',
'ι' => 'ι',
'῁' => '῁',
'ῂ' => 'ῂ',
'ῃ' => 'ῃ',
'ῄ' => 'ῄ',
'ῆ' => 'ῆ',
'ῇ' => 'ῇ',
'Ὲ' => 'Ὲ',
'Έ' => 'Έ',
'Ὴ' => 'Ὴ',
'Ή' => 'Ή',
'ῌ' => 'ῌ',
'῍' => '῍',
'῎' => '῎',
'῏' => '῏',
'ῐ' => 'ῐ',
'ῑ' => 'ῑ',
'ῒ' => 'ῒ',
'ΐ' => 'ΐ',
'ῖ' => 'ῖ',
'ῗ' => 'ῗ',
'Ῐ' => 'Ῐ',
'Ῑ' => 'Ῑ',
'Ὶ' => 'Ὶ',
'Ί' => 'Ί',
'῝' => '῝',
'῞' => '῞',
'῟' => '῟',
'ῠ' => 'ῠ',
'ῡ' => 'ῡ',
'ῢ' => 'ῢ',
'ΰ' => 'ΰ',
'ῤ' => 'ῤ',
'ῥ' => 'ῥ',
'ῦ' => 'ῦ',
'ῧ' => 'ῧ',
'Ῠ' => 'Ῠ',
'Ῡ' => 'Ῡ',
'Ὺ' => 'Ὺ',
'Ύ' => 'Ύ',
'Ῥ' => 'Ῥ',
'῭' => '῭',
'΅' => '΅',
'`' => '`',
'ῲ' => 'ῲ',
'ῳ' => 'ῳ',
'ῴ' => 'ῴ',
'ῶ' => 'ῶ',
'ῷ' => 'ῷ',
'Ὸ' => 'Ὸ',
'Ό' => 'Ό',
'Ὼ' => 'Ὼ',
'Ώ' => 'Ώ',
'ῼ' => 'ῼ',
'´' => '´',
' ' => ' ',
' ' => ' ',
'Ω' => 'Ω',
'K' => 'K',
'Å' => 'Å',
'↚' => '↚',
'↛' => '↛',
'↮' => '↮',
'⇍' => '⇍',
'⇎' => '⇎',
'⇏' => '⇏',
'∄' => '∄',
'∉' => '∉',
'∌' => '∌',
'∤' => '∤',
'∦' => '∦',
'≁' => '≁',
'≄' => '≄',
'≇' => '≇',
'≉' => '≉',
'≠' => '≠',
'≢' => '≢',
'≭' => '≭',
'≮' => '≮',
'≯' => '≯',
'≰' => '≰',
'≱' => '≱',
'≴' => '≴',
'≵' => '≵',
'≸' => '≸',
'≹' => '≹',
'⊀' => '⊀',
'⊁' => '⊁',
'⊄' => '⊄',
'⊅' => '⊅',
'⊈' => '⊈',
'⊉' => '⊉',
'⊬' => '⊬',
'⊭' => '⊭',
'⊮' => '⊮',
'⊯' => '⊯',
'⋠' => '⋠',
'⋡' => '⋡',
'⋢' => '⋢',
'⋣' => '⋣',
'⋪' => '⋪',
'⋫' => '⋫',
'⋬' => '⋬',
'⋭' => '⋭',
'〈' => '〈',
'〉' => '〉',
'⫝̸' => '⫝̸',
'が' => 'が',
'ぎ' => 'ぎ',
'ぐ' => 'ぐ',
'げ' => 'げ',
'ご' => 'ご',
'ざ' => 'ざ',
'じ' => 'じ',
'ず' => 'ず',
'ぜ' => 'ぜ',
'ぞ' => 'ぞ',
'だ' => 'だ',
'ぢ' => 'ぢ',
'づ' => 'づ',
'で' => 'で',
'ど' => 'ど',
'ば' => 'ば',
'ぱ' => 'ぱ',
'び' => 'び',
'ぴ' => 'ぴ',
'ぶ' => 'ぶ',
'ぷ' => 'ぷ',
'べ' => 'べ',
'ぺ' => 'ぺ',
'ぼ' => 'ぼ',
'ぽ' => 'ぽ',
'ゔ' => 'ゔ',
'ゞ' => 'ゞ',
'ガ' => 'ガ',
'ギ' => 'ギ',
'グ' => 'グ',
'ゲ' => 'ゲ',
'ゴ' => 'ゴ',
'ザ' => 'ザ',
'ジ' => 'ジ',
'ズ' => 'ズ',
'ゼ' => 'ゼ',
'ゾ' => 'ゾ',
'ダ' => 'ダ',
'ヂ' => 'ヂ',
'ヅ' => 'ヅ',
'デ' => 'デ',
'ド' => 'ド',
'バ' => 'バ',
'パ' => 'パ',
'ビ' => 'ビ',
'ピ' => 'ピ',
'ブ' => 'ブ',
'プ' => 'プ',
'ベ' => 'ベ',
'ペ' => 'ペ',
'ボ' => 'ボ',
'ポ' => 'ポ',
'ヴ' => 'ヴ',
'ヷ' => 'ヷ',
'ヸ' => 'ヸ',
'ヹ' => 'ヹ',
'ヺ' => 'ヺ',
'ヾ' => 'ヾ',
'豈' => '豈',
'更' => '更',
'車' => '車',
'賈' => '賈',
'滑' => '滑',
'串' => '串',
'句' => '句',
'龜' => '龜',
'龜' => '龜',
'契' => '契',
'金' => '金',
'喇' => '喇',
'奈' => '奈',
'懶' => '懶',
'癩' => '癩',
'羅' => '羅',
'蘿' => '蘿',
'螺' => '螺',
'裸' => '裸',
'邏' => '邏',
'樂' => '樂',
'洛' => '洛',
'烙' => '烙',
'珞' => '珞',
'落' => '落',
'酪' => '酪',
'駱' => '駱',
'亂' => '亂',
'卵' => '卵',
'欄' => '欄',
'爛' => '爛',
'蘭' => '蘭',
'鸞' => '鸞',
'嵐' => '嵐',
'濫' => '濫',
'藍' => '藍',
'襤' => '襤',
'拉' => '拉',
'臘' => '臘',
'蠟' => '蠟',
'廊' => '廊',
'朗' => '朗',
'浪' => '浪',
'狼' => '狼',
'郎' => '郎',
'來' => '來',
'冷' => '冷',
'勞' => '勞',
'擄' => '擄',
'櫓' => '櫓',
'爐' => '爐',
'盧' => '盧',
'老' => '老',
'蘆' => '蘆',
'虜' => '虜',
'路' => '路',
'露' => '露',
'魯' => '魯',
'鷺' => '鷺',
'碌' => '碌',
'祿' => '祿',
'綠' => '綠',
'菉' => '菉',
'錄' => '錄',
'鹿' => '鹿',
'論' => '論',
'壟' => '壟',
'弄' => '弄',
'籠' => '籠',
'聾' => '聾',
'牢' => '牢',
'磊' => '磊',
'賂' => '賂',
'雷' => '雷',
'壘' => '壘',
'屢' => '屢',
'樓' => '樓',
'淚' => '淚',
'漏' => '漏',
'累' => '累',
'縷' => '縷',
'陋' => '陋',
'勒' => '勒',
'肋' => '肋',
'凜' => '凜',
'凌' => '凌',
'稜' => '稜',
'綾' => '綾',
'菱' => '菱',
'陵' => '陵',
'讀' => '讀',
'拏' => '拏',
'樂' => '樂',
'諾' => '諾',
'丹' => '丹',
'寧' => '寧',
'怒' => '怒',
'率' => '率',
'異' => '異',
'北' => '北',
'磻' => '磻',
'便' => '便',
'復' => '復',
'不' => '不',
'泌' => '泌',
'數' => '數',
'索' => '索',
'參' => '參',
'塞' => '塞',
'省' => '省',
'葉' => '葉',
'說' => '說',
'殺' => '殺',
'辰' => '辰',
'沈' => '沈',
'拾' => '拾',
'若' => '若',
'掠' => '掠',
'略' => '略',
'亮' => '亮',
'兩' => '兩',
'凉' => '凉',
'梁' => '梁',
'糧' => '糧',
'良' => '良',
'諒' => '諒',
'量' => '量',
'勵' => '勵',
'呂' => '呂',
'女' => '女',
'廬' => '廬',
'旅' => '旅',
'濾' => '濾',
'礪' => '礪',
'閭' => '閭',
'驪' => '驪',
'麗' => '麗',
'黎' => '黎',
'力' => '力',
'曆' => '曆',
'歷' => '歷',
'轢' => '轢',
'年' => '年',
'憐' => '憐',
'戀' => '戀',
'撚' => '撚',
'漣' => '漣',
'煉' => '煉',
'璉' => '璉',
'秊' => '秊',
'練' => '練',
'聯' => '聯',
'輦' => '輦',
'蓮' => '蓮',
'連' => '連',
'鍊' => '鍊',
'列' => '列',
'劣' => '劣',
'咽' => '咽',
'烈' => '烈',
'裂' => '裂',
'說' => '說',
'廉' => '廉',
'念' => '念',
'捻' => '捻',
'殮' => '殮',
'簾' => '簾',
'獵' => '獵',
'令' => '令',
'囹' => '囹',
'寧' => '寧',
'嶺' => '嶺',
'怜' => '怜',
'玲' => '玲',
'瑩' => '瑩',
'羚' => '羚',
'聆' => '聆',
'鈴' => '鈴',
'零' => '零',
'靈' => '靈',
'領' => '領',
'例' => '例',
'禮' => '禮',
'醴' => '醴',
'隸' => '隸',
'惡' => '惡',
'了' => '了',
'僚' => '僚',
'寮' => '寮',
'尿' => '尿',
'料' => '料',
'樂' => '樂',
'燎' => '燎',
'療' => '療',
'蓼' => '蓼',
'遼' => '遼',
'龍' => '龍',
'暈' => '暈',
'阮' => '阮',
'劉' => '劉',
'杻' => '杻',
'柳' => '柳',
'流' => '流',
'溜' => '溜',
'琉' => '琉',
'留' => '留',
'硫' => '硫',
'紐' => '紐',
'類' => '類',
'六' => '六',
'戮' => '戮',
'陸' => '陸',
'倫' => '倫',
'崙' => '崙',
'淪' => '淪',
'輪' => '輪',
'律' => '律',
'慄' => '慄',
'栗' => '栗',
'率' => '率',
'隆' => '隆',
'利' => '利',
'吏' => '吏',
'履' => '履',
'易' => '易',
'李' => '李',
'梨' => '梨',
'泥' => '泥',
'理' => '理',
'痢' => '痢',
'罹' => '罹',
'裏' => '裏',
'裡' => '裡',
'里' => '里',
'離' => '離',
'匿' => '匿',
'溺' => '溺',
'吝' => '吝',
'燐' => '燐',
'璘' => '璘',
'藺' => '藺',
'隣' => '隣',
'鱗' => '鱗',
'麟' => '麟',
'林' => '林',
'淋' => '淋',
'臨' => '臨',
'立' => '立',
'笠' => '笠',
'粒' => '粒',
'狀' => '狀',
'炙' => '炙',
'識' => '識',
'什' => '什',
'茶' => '茶',
'刺' => '刺',
'切' => '切',
'度' => '度',
'拓' => '拓',
'糖' => '糖',
'宅' => '宅',
'洞' => '洞',
'暴' => '暴',
'輻' => '輻',
'行' => '行',
'降' => '降',
'見' => '見',
'廓' => '廓',
'兀' => '兀',
'嗀' => '嗀',
'塚' => '塚',
'晴' => '晴',
'凞' => '凞',
'猪' => '猪',
'益' => '益',
'礼' => '礼',
'神' => '神',
'祥' => '祥',
'福' => '福',
'靖' => '靖',
'精' => '精',
'羽' => '羽',
'蘒' => '蘒',
'諸' => '諸',
'逸' => '逸',
'都' => '都',
'飯' => '飯',
'飼' => '飼',
'館' => '館',
'鶴' => '鶴',
'郞' => '郞',
'隷' => '隷',
'侮' => '侮',
'僧' => '僧',
'免' => '免',
'勉' => '勉',
'勤' => '勤',
'卑' => '卑',
'喝' => '喝',
'嘆' => '嘆',
'器' => '器',
'塀' => '塀',
'墨' => '墨',
'層' => '層',
'屮' => '屮',
'悔' => '悔',
'慨' => '慨',
'憎' => '憎',
'懲' => '懲',
'敏' => '敏',
'既' => '既',
'暑' => '暑',
'梅' => '梅',
'海' => '海',
'渚' => '渚',
'漢' => '漢',
'煮' => '煮',
'爫' => '爫',
'琢' => '琢',
'碑' => '碑',
'社' => '社',
'祉' => '祉',
'祈' => '祈',
'祐' => '祐',
'祖' => '祖',
'祝' => '祝',
'禍' => '禍',
'禎' => '禎',
'穀' => '穀',
'突' => '突',
'節' => '節',
'練' => '練',
'縉' => '縉',
'繁' => '繁',
'署' => '署',
'者' => '者',
'臭' => '臭',
'艹' => '艹',
'艹' => '艹',
'著' => '著',
'褐' => '褐',
'視' => '視',
'謁' => '謁',
'謹' => '謹',
'賓' => '賓',
'贈' => '贈',
'辶' => '辶',
'逸' => '逸',
'難' => '難',
'響' => '響',
'頻' => '頻',
'恵' => '恵',
'𤋮' => '𤋮',
'舘' => '舘',
'並' => '並',
'况' => '况',
'全' => '全',
'侀' => '侀',
'充' => '充',
'冀' => '冀',
'勇' => '勇',
'勺' => '勺',
'喝' => '喝',
'啕' => '啕',
'喙' => '喙',
'嗢' => '嗢',
'塚' => '塚',
'墳' => '墳',
'奄' => '奄',
'奔' => '奔',
'婢' => '婢',
'嬨' => '嬨',
'廒' => '廒',
'廙' => '廙',
'彩' => '彩',
'徭' => '徭',
'惘' => '惘',
'慎' => '慎',
'愈' => '愈',
'憎' => '憎',
'慠' => '慠',
'懲' => '懲',
'戴' => '戴',
'揄' => '揄',
'搜' => '搜',
'摒' => '摒',
'敖' => '敖',
'晴' => '晴',
'朗' => '朗',
'望' => '望',
'杖' => '杖',
'歹' => '歹',
'殺' => '殺',
'流' => '流',
'滛' => '滛',
'滋' => '滋',
'漢' => '漢',
'瀞' => '瀞',
'煮' => '煮',
'瞧' => '瞧',
'爵' => '爵',
'犯' => '犯',
'猪' => '猪',
'瑱' => '瑱',
'甆' => '甆',
'画' => '画',
'瘝' => '瘝',
'瘟' => '瘟',
'益' => '益',
'盛' => '盛',
'直' => '直',
'睊' => '睊',
'着' => '着',
'磌' => '磌',
'窱' => '窱',
'節' => '節',
'类' => '类',
'絛' => '絛',
'練' => '練',
'缾' => '缾',
'者' => '者',
'荒' => '荒',
'華' => '華',
'蝹' => '蝹',
'襁' => '襁',
'覆' => '覆',
'視' => '視',
'調' => '調',
'諸' => '諸',
'請' => '請',
'謁' => '謁',
'諾' => '諾',
'諭' => '諭',
'謹' => '謹',
'變' => '變',
'贈' => '贈',
'輸' => '輸',
'遲' => '遲',
'醙' => '醙',
'鉶' => '鉶',
'陼' => '陼',
'難' => '難',
'靖' => '靖',
'韛' => '韛',
'響' => '響',
'頋' => '頋',
'頻' => '頻',
'鬒' => '鬒',
'龜' => '龜',
'𢡊' => '𢡊',
'𢡄' => '𢡄',
'𣏕' => '𣏕',
'㮝' => '㮝',
'䀘' => '䀘',
'䀹' => '䀹',
'𥉉' => '𥉉',
'𥳐' => '𥳐',
'𧻓' => '𧻓',
'齃' => '齃',
'龎' => '龎',
'יִ' => 'יִ',
'ײַ' => 'ײַ',
'שׁ' => 'שׁ',
'שׂ' => 'שׂ',
'שּׁ' => 'שּׁ',
'שּׂ' => 'שּׂ',
'אַ' => 'אַ',
'אָ' => 'אָ',
'אּ' => 'אּ',
'בּ' => 'בּ',
'גּ' => 'גּ',
'דּ' => 'דּ',
'הּ' => 'הּ',
'וּ' => 'וּ',
'זּ' => 'זּ',
'טּ' => 'טּ',
'יּ' => 'יּ',
'ךּ' => 'ךּ',
'כּ' => 'כּ',
'לּ' => 'לּ',
'מּ' => 'מּ',
'נּ' => 'נּ',
'סּ' => 'סּ',
'ףּ' => 'ףּ',
'פּ' => 'פּ',
'צּ' => 'צּ',
'קּ' => 'קּ',
'רּ' => 'רּ',
'שּ' => 'שּ',
'תּ' => 'תּ',
'וֹ' => 'וֹ',
'בֿ' => 'בֿ',
'כֿ' => 'כֿ',
'פֿ' => 'פֿ',
'𑂚' => '𑂚',
'𑂜' => '𑂜',
'𑂫' => '𑂫',
'𑄮' => '𑄮',
'𑄯' => '𑄯',
'𑍋' => '𑍋',
'𑍌' => '𑍌',
'𑒻' => '𑒻',
'𑒼' => '𑒼',
'𑒾' => '𑒾',
'𑖺' => '𑖺',
'𑖻' => '𑖻',
'𑤸' => '𑤸',
'𝅗𝅥' => '𝅗𝅥',
'𝅘𝅥' => '𝅘𝅥',
'𝅘𝅥𝅮' => '𝅘𝅥𝅮',
'𝅘𝅥𝅯' => '𝅘𝅥𝅯',
'𝅘𝅥𝅰' => '𝅘𝅥𝅰',
'𝅘𝅥𝅱' => '𝅘𝅥𝅱',
'𝅘𝅥𝅲' => '𝅘𝅥𝅲',
'𝆹𝅥' => '𝆹𝅥',
'𝆺𝅥' => '𝆺𝅥',
'𝆹𝅥𝅮' => '𝆹𝅥𝅮',
'𝆺𝅥𝅮' => '𝆺𝅥𝅮',
'𝆹𝅥𝅯' => '𝆹𝅥𝅯',
'𝆺𝅥𝅯' => '𝆺𝅥𝅯',
'丽' => '丽',
'丸' => '丸',
'乁' => '乁',
'𠄢' => '𠄢',
'你' => '你',
'侮' => '侮',
'侻' => '侻',
'倂' => '倂',
'偺' => '偺',
'備' => '備',
'僧' => '僧',
'像' => '像',
'㒞' => '㒞',
'𠘺' => '𠘺',
'免' => '免',
'兔' => '兔',
'兤' => '兤',
'具' => '具',
'𠔜' => '𠔜',
'㒹' => '㒹',
'內' => '內',
'再' => '再',
'𠕋' => '𠕋',
'冗' => '冗',
'冤' => '冤',
'仌' => '仌',
'冬' => '冬',
'况' => '况',
'𩇟' => '𩇟',
'凵' => '凵',
'刃' => '刃',
'㓟' => '㓟',
'刻' => '刻',
'剆' => '剆',
'割' => '割',
'剷' => '剷',
'㔕' => '㔕',
'勇' => '勇',
'勉' => '勉',
'勤' => '勤',
'勺' => '勺',
'包' => '包',
'匆' => '匆',
'北' => '北',
'卉' => '卉',
'卑' => '卑',
'博' => '博',
'即' => '即',
'卽' => '卽',
'卿' => '卿',
'卿' => '卿',
'卿' => '卿',
'𠨬' => '𠨬',
'灰' => '灰',
'及' => '及',
'叟' => '叟',
'𠭣' => '𠭣',
'叫' => '叫',
'叱' => '叱',
'吆' => '吆',
'咞' => '咞',
'吸' => '吸',
'呈' => '呈',
'周' => '周',
'咢' => '咢',
'哶' => '哶',
'唐' => '唐',
'啓' => '啓',
'啣' => '啣',
'善' => '善',
'善' => '善',
'喙' => '喙',
'喫' => '喫',
'喳' => '喳',
'嗂' => '嗂',
'圖' => '圖',
'嘆' => '嘆',
'圗' => '圗',
'噑' => '噑',
'噴' => '噴',
'切' => '切',
'壮' => '壮',
'城' => '城',
'埴' => '埴',
'堍' => '堍',
'型' => '型',
'堲' => '堲',
'報' => '報',
'墬' => '墬',
'𡓤' => '𡓤',
'売' => '売',
'壷' => '壷',
'夆' => '夆',
'多' => '多',
'夢' => '夢',
'奢' => '奢',
'𡚨' => '𡚨',
'𡛪' => '𡛪',
'姬' => '姬',
'娛' => '娛',
'娧' => '娧',
'姘' => '姘',
'婦' => '婦',
'㛮' => '㛮',
'㛼' => '㛼',
'嬈' => '嬈',
'嬾' => '嬾',
'嬾' => '嬾',
'𡧈' => '𡧈',
'寃' => '寃',
'寘' => '寘',
'寧' => '寧',
'寳' => '寳',
'𡬘' => '𡬘',
'寿' => '寿',
'将' => '将',
'当' => '当',
'尢' => '尢',
'㞁' => '㞁',
'屠' => '屠',
'屮' => '屮',
'峀' => '峀',
'岍' => '岍',
'𡷤' => '𡷤',
'嵃' => '嵃',
'𡷦' => '𡷦',
'嵮' => '嵮',
'嵫' => '嵫',
'嵼' => '嵼',
'巡' => '巡',
'巢' => '巢',
'㠯' => '㠯',
'巽' => '巽',
'帨' => '帨',
'帽' => '帽',
'幩' => '幩',
'㡢' => '㡢',
'𢆃' => '𢆃',
'㡼' => '㡼',
'庰' => '庰',
'庳' => '庳',
'庶' => '庶',
'廊' => '廊',
'𪎒' => '𪎒',
'廾' => '廾',
'𢌱' => '𢌱',
'𢌱' => '𢌱',
'舁' => '舁',
'弢' => '弢',
'弢' => '弢',
'㣇' => '㣇',
'𣊸' => '𣊸',
'𦇚' => '𦇚',
'形' => '形',
'彫' => '彫',
'㣣' => '㣣',
'徚' => '徚',
'忍' => '忍',
'志' => '志',
'忹' => '忹',
'悁' => '悁',
'㤺' => '㤺',
'㤜' => '㤜',
'悔' => '悔',
'𢛔' => '𢛔',
'惇' => '惇',
'慈' => '慈',
'慌' => '慌',
'慎' => '慎',
'慌' => '慌',
'慺' => '慺',
'憎' => '憎',
'憲' => '憲',
'憤' => '憤',
'憯' => '憯',
'懞' => '懞',
'懲' => '懲',
'懶' => '懶',
'成' => '成',
'戛' => '戛',
'扝' => '扝',
'抱' => '抱',
'拔' => '拔',
'捐' => '捐',
'𢬌' => '𢬌',
'挽' => '挽',
'拼' => '拼',
'捨' => '捨',
'掃' => '掃',
'揤' => '揤',
'𢯱' => '𢯱',
'搢' => '搢',
'揅' => '揅',
'掩' => '掩',
'㨮' => '㨮',
'摩' => '摩',
'摾' => '摾',
'撝' => '撝',
'摷' => '摷',
'㩬' => '㩬',
'敏' => '敏',
'敬' => '敬',
'𣀊' => '𣀊',
'旣' => '旣',
'書' => '書',
'晉' => '晉',
'㬙' => '㬙',
'暑' => '暑',
'㬈' => '㬈',
'㫤' => '㫤',
'冒' => '冒',
'冕' => '冕',
'最' => '最',
'暜' => '暜',
'肭' => '肭',
'䏙' => '䏙',
'朗' => '朗',
'望' => '望',
'朡' => '朡',
'杞' => '杞',
'杓' => '杓',
'𣏃' => '𣏃',
'㭉' => '㭉',
'柺' => '柺',
'枅' => '枅',
'桒' => '桒',
'梅' => '梅',
'𣑭' => '𣑭',
'梎' => '梎',
'栟' => '栟',
'椔' => '椔',
'㮝' => '㮝',
'楂' => '楂',
'榣' => '榣',
'槪' => '槪',
'檨' => '檨',
'𣚣' => '𣚣',
'櫛' => '櫛',
'㰘' => '㰘',
'次' => '次',
'𣢧' => '𣢧',
'歔' => '歔',
'㱎' => '㱎',
'歲' => '歲',
'殟' => '殟',
'殺' => '殺',
'殻' => '殻',
'𣪍' => '𣪍',
'𡴋' => '𡴋',
'𣫺' => '𣫺',
'汎' => '汎',
'𣲼' => '𣲼',
'沿' => '沿',
'泍' => '泍',
'汧' => '汧',
'洖' => '洖',
'派' => '派',
'海' => '海',
'流' => '流',
'浩' => '浩',
'浸' => '浸',
'涅' => '涅',
'𣴞' => '𣴞',
'洴' => '洴',
'港' => '港',
'湮' => '湮',
'㴳' => '㴳',
'滋' => '滋',
'滇' => '滇',
'𣻑' => '𣻑',
'淹' => '淹',
'潮' => '潮',
'𣽞' => '𣽞',
'𣾎' => '𣾎',
'濆' => '濆',
'瀹' => '瀹',
'瀞' => '瀞',
'瀛' => '瀛',
'㶖' => '㶖',
'灊' => '灊',
'災' => '災',
'灷' => '灷',
'炭' => '炭',
'𠔥' => '𠔥',
'煅' => '煅',
'𤉣' => '𤉣',
'熜' => '熜',
'𤎫' => '𤎫',
'爨' => '爨',
'爵' => '爵',
'牐' => '牐',
'𤘈' => '𤘈',
'犀' => '犀',
'犕' => '犕',
'𤜵' => '𤜵',
'𤠔' => '𤠔',
'獺' => '獺',
'王' => '王',
'㺬' => '㺬',
'玥' => '玥',
'㺸' => '㺸',
'㺸' => '㺸',
'瑇' => '瑇',
'瑜' => '瑜',
'瑱' => '瑱',
'璅' => '璅',
'瓊' => '瓊',
'㼛' => '㼛',
'甤' => '甤',
'𤰶' => '𤰶',
'甾' => '甾',
'𤲒' => '𤲒',
'異' => '異',
'𢆟' => '𢆟',
'瘐' => '瘐',
'𤾡' => '𤾡',
'𤾸' => '𤾸',
'𥁄' => '𥁄',
'㿼' => '㿼',
'䀈' => '䀈',
'直' => '直',
'𥃳' => '𥃳',
'𥃲' => '𥃲',
'𥄙' => '𥄙',
'𥄳' => '𥄳',
'眞' => '眞',
'真' => '真',
'真' => '真',
'睊' => '睊',
'䀹' => '䀹',
'瞋' => '瞋',
'䁆' => '䁆',
'䂖' => '䂖',
'𥐝' => '𥐝',
'硎' => '硎',
'碌' => '碌',
'磌' => '磌',
'䃣' => '䃣',
'𥘦' => '𥘦',
'祖' => '祖',
'𥚚' => '𥚚',
'𥛅' => '𥛅',
'福' => '福',
'秫' => '秫',
'䄯' => '䄯',
'穀' => '穀',
'穊' => '穊',
'穏' => '穏',
'𥥼' => '𥥼',
'𥪧' => '𥪧',
'𥪧' => '𥪧',
'竮' => '竮',
'䈂' => '䈂',
'𥮫' => '𥮫',
'篆' => '篆',
'築' => '築',
'䈧' => '䈧',
'𥲀' => '𥲀',
'糒' => '糒',
'䊠' => '䊠',
'糨' => '糨',
'糣' => '糣',
'紀' => '紀',
'𥾆' => '𥾆',
'絣' => '絣',
'䌁' => '䌁',
'緇' => '緇',
'縂' => '縂',
'繅' => '繅',
'䌴' => '䌴',
'𦈨' => '𦈨',
'𦉇' => '𦉇',
'䍙' => '䍙',
'𦋙' => '𦋙',
'罺' => '罺',
'𦌾' => '𦌾',
'羕' => '羕',
'翺' => '翺',
'者' => '者',
'𦓚' => '𦓚',
'𦔣' => '𦔣',
'聠' => '聠',
'𦖨' => '𦖨',
'聰' => '聰',
'𣍟' => '𣍟',
'䏕' => '䏕',
'育' => '育',
'脃' => '脃',
'䐋' => '䐋',
'脾' => '脾',
'媵' => '媵',
'𦞧' => '𦞧',
'𦞵' => '𦞵',
'𣎓' => '𣎓',
'𣎜' => '𣎜',
'舁' => '舁',
'舄' => '舄',
'辞' => '辞',
'䑫' => '䑫',
'芑' => '芑',
'芋' => '芋',
'芝' => '芝',
'劳' => '劳',
'花' => '花',
'芳' => '芳',
'芽' => '芽',
'苦' => '苦',
'𦬼' => '𦬼',
'若' => '若',
'茝' => '茝',
'荣' => '荣',
'莭' => '莭',
'茣' => '茣',
'莽' => '莽',
'菧' => '菧',
'著' => '著',
'荓' => '荓',
'菊' => '菊',
'菌' => '菌',
'菜' => '菜',
'𦰶' => '𦰶',
'𦵫' => '𦵫',
'𦳕' => '𦳕',
'䔫' => '䔫',
'蓱' => '蓱',
'蓳' => '蓳',
'蔖' => '蔖',
'𧏊' => '𧏊',
'蕤' => '蕤',
'𦼬' => '𦼬',
'䕝' => '䕝',
'䕡' => '䕡',
'𦾱' => '𦾱',
'𧃒' => '𧃒',
'䕫' => '䕫',
'虐' => '虐',
'虜' => '虜',
'虧' => '虧',
'虩' => '虩',
'蚩' => '蚩',
'蚈' => '蚈',
'蜎' => '蜎',
'蛢' => '蛢',
'蝹' => '蝹',
'蜨' => '蜨',
'蝫' => '蝫',
'螆' => '螆',
'䗗' => '䗗',
'蟡' => '蟡',
'蠁' => '蠁',
'䗹' => '䗹',
'衠' => '衠',
'衣' => '衣',
'𧙧' => '𧙧',
'裗' => '裗',
'裞' => '裞',
'䘵' => '䘵',
'裺' => '裺',
'㒻' => '㒻',
'𧢮' => '𧢮',
'𧥦' => '𧥦',
'䚾' => '䚾',
'䛇' => '䛇',
'誠' => '誠',
'諭' => '諭',
'變' => '變',
'豕' => '豕',
'𧲨' => '𧲨',
'貫' => '貫',
'賁' => '賁',
'贛' => '贛',
'起' => '起',
'𧼯' => '𧼯',
'𠠄' => '𠠄',
'跋' => '跋',
'趼' => '趼',
'跰' => '跰',
'𠣞' => '𠣞',
'軔' => '軔',
'輸' => '輸',
'𨗒' => '𨗒',
'𨗭' => '𨗭',
'邔' => '邔',
'郱' => '郱',
'鄑' => '鄑',
'𨜮' => '𨜮',
'鄛' => '鄛',
'鈸' => '鈸',
'鋗' => '鋗',
'鋘' => '鋘',
'鉼' => '鉼',
'鏹' => '鏹',
'鐕' => '鐕',
'𨯺' => '𨯺',
'開' => '開',
'䦕' => '䦕',
'閷' => '閷',
'𨵷' => '𨵷',
'䧦' => '䧦',
'雃' => '雃',
'嶲' => '嶲',
'霣' => '霣',
'𩅅' => '𩅅',
'𩈚' => '𩈚',
'䩮' => '䩮',
'䩶' => '䩶',
'韠' => '韠',
'𩐊' => '𩐊',
'䪲' => '䪲',
'𩒖' => '𩒖',
'頋' => '頋',
'頋' => '頋',
'頩' => '頩',
'𩖶' => '𩖶',
'飢' => '飢',
'䬳' => '䬳',
'餩' => '餩',
'馧' => '馧',
'駂' => '駂',
'駾' => '駾',
'䯎' => '䯎',
'𩬰' => '𩬰',
'鬒' => '鬒',
'鱀' => '鱀',
'鳽' => '鳽',
'䳎' => '䳎',
'䳭' => '䳭',
'鵧' => '鵧',
'𪃎' => '𪃎',
'䳸' => '䳸',
'𪄅' => '𪄅',
'𪈎' => '𪈎',
'𪊑' => '𪊑',
'麻' => '麻',
'䵖' => '䵖',
'黹' => '黹',
'黾' => '黾',
'鼅' => '鼅',
'鼏' => '鼏',
'鼖' => '鼖',
'鼻' => '鼻',
'𪘀' => '𪘀',
);
<?php
return array (
' ' => ' ',
'¨' => ' ̈',
'ª' => 'a',
'¯' => ' ̄',
'²' => '2',
'³' => '3',
'´' => ' ́',
'µ' => 'μ',
'¸' => ' ̧',
'¹' => '1',
'º' => 'o',
'¼' => '1⁄4',
'½' => '1⁄2',
'¾' => '3⁄4',
'IJ' => 'IJ',
'ij' => 'ij',
'Ŀ' => 'L·',
'ŀ' => 'l·',
'ʼn' => 'ʼn',
'ſ' => 's',
'DŽ' => 'DŽ',
'Dž' => 'Dž',
'dž' => 'dž',
'LJ' => 'LJ',
'Lj' => 'Lj',
'lj' => 'lj',
'NJ' => 'NJ',
'Nj' => 'Nj',
'nj' => 'nj',
'DZ' => 'DZ',
'Dz' => 'Dz',
'dz' => 'dz',
'ʰ' => 'h',
'ʱ' => 'ɦ',
'ʲ' => 'j',
'ʳ' => 'r',
'ʴ' => 'ɹ',
'ʵ' => 'ɻ',
'ʶ' => 'ʁ',
'ʷ' => 'w',
'ʸ' => 'y',
'˘' => ' ̆',
'˙' => ' ̇',
'˚' => ' ̊',
'˛' => ' ̨',
'˜' => ' ̃',
'˝' => ' ̋',
'ˠ' => 'ɣ',
'ˡ' => 'l',
'ˢ' => 's',
'ˣ' => 'x',
'ˤ' => 'ʕ',
'ͺ' => ' ͅ',
'΄' => ' ́',
'΅' => ' ̈́',
'ϐ' => 'β',
'ϑ' => 'θ',
'ϒ' => 'Υ',
'ϓ' => 'Ύ',
'ϔ' => 'Ϋ',
'ϕ' => 'φ',
'ϖ' => 'π',
'ϰ' => 'κ',
'ϱ' => 'ρ',
'ϲ' => 'ς',
'ϴ' => 'Θ',
'ϵ' => 'ε',
'Ϲ' => 'Σ',
'և' => 'եւ',
'ٵ' => 'اٴ',
'ٶ' => 'وٴ',
'ٷ' => 'ۇٴ',
'ٸ' => 'يٴ',
'ำ' => 'ํา',
'ຳ' => 'ໍາ',
'ໜ' => 'ຫນ',
'ໝ' => 'ຫມ',
'༌' => '་',
'ཷ' => 'ྲཱྀ',
'ཹ' => 'ླཱྀ',
'ჼ' => 'ნ',
'ᴬ' => 'A',
'ᴭ' => 'Æ',
'ᴮ' => 'B',
'ᴰ' => 'D',
'ᴱ' => 'E',
'ᴲ' => 'Ǝ',
'ᴳ' => 'G',
'ᴴ' => 'H',
'ᴵ' => 'I',
'ᴶ' => 'J',
'ᴷ' => 'K',
'ᴸ' => 'L',
'ᴹ' => 'M',
'ᴺ' => 'N',
'ᴼ' => 'O',
'ᴽ' => 'Ȣ',
'ᴾ' => 'P',
'ᴿ' => 'R',
'ᵀ' => 'T',
'ᵁ' => 'U',
'ᵂ' => 'W',
'ᵃ' => 'a',
'ᵄ' => 'ɐ',
'ᵅ' => 'ɑ',
'ᵆ' => 'ᴂ',
'ᵇ' => 'b',
'ᵈ' => 'd',
'ᵉ' => 'e',
'ᵊ' => 'ə',
'ᵋ' => 'ɛ',
'ᵌ' => 'ɜ',
'ᵍ' => 'g',
'ᵏ' => 'k',
'ᵐ' => 'm',
'ᵑ' => 'ŋ',
'ᵒ' => 'o',
'ᵓ' => 'ɔ',
'ᵔ' => 'ᴖ',
'ᵕ' => 'ᴗ',
'ᵖ' => 'p',
'ᵗ' => 't',
'ᵘ' => 'u',
'ᵙ' => 'ᴝ',
'ᵚ' => 'ɯ',
'ᵛ' => 'v',
'ᵜ' => 'ᴥ',
'ᵝ' => 'β',
'ᵞ' => 'γ',
'ᵟ' => 'δ',
'ᵠ' => 'φ',
'ᵡ' => 'χ',
'ᵢ' => 'i',
'ᵣ' => 'r',
'ᵤ' => 'u',
'ᵥ' => 'v',
'ᵦ' => 'β',
'ᵧ' => 'γ',
'ᵨ' => 'ρ',
'ᵩ' => 'φ',
'ᵪ' => 'χ',
'ᵸ' => 'н',
'ᶛ' => 'ɒ',
'ᶜ' => 'c',
'ᶝ' => 'ɕ',
'ᶞ' => 'ð',
'ᶟ' => 'ɜ',
'ᶠ' => 'f',
'ᶡ' => 'ɟ',
'ᶢ' => 'ɡ',
'ᶣ' => 'ɥ',
'ᶤ' => 'ɨ',
'ᶥ' => 'ɩ',
'ᶦ' => 'ɪ',
'ᶧ' => 'ᵻ',
'ᶨ' => 'ʝ',
'ᶩ' => 'ɭ',
'ᶪ' => 'ᶅ',
'ᶫ' => 'ʟ',
'ᶬ' => 'ɱ',
'ᶭ' => 'ɰ',
'ᶮ' => 'ɲ',
'ᶯ' => 'ɳ',
'ᶰ' => 'ɴ',
'ᶱ' => 'ɵ',
'ᶲ' => 'ɸ',
'ᶳ' => 'ʂ',
'ᶴ' => 'ʃ',
'ᶵ' => 'ƫ',
'ᶶ' => 'ʉ',
'ᶷ' => 'ʊ',
'ᶸ' => 'ᴜ',
'ᶹ' => 'ʋ',
'ᶺ' => 'ʌ',
'ᶻ' => 'z',
'ᶼ' => 'ʐ',
'ᶽ' => 'ʑ',
'ᶾ' => 'ʒ',
'ᶿ' => 'θ',
'ẚ' => 'aʾ',
'ẛ' => 'ṡ',
'᾽' => ' ̓',
'᾿' => ' ̓',
'῀' => ' ͂',
'῁' => ' ̈͂',
'῍' => ' ̓̀',
'῎' => ' ̓́',
'῏' => ' ̓͂',
'῝' => ' ̔̀',
'῞' => ' ̔́',
'῟' => ' ̔͂',
'῭' => ' ̈̀',
'΅' => ' ̈́',
'´' => ' ́',
'῾' => ' ̔',
' ' => ' ',
' ' => ' ',
' ' => ' ',
' ' => ' ',
' ' => ' ',
' ' => ' ',
' ' => ' ',
' ' => ' ',
' ' => ' ',
' ' => ' ',
' ' => ' ',
'‑' => '‐',
'‗' => ' ̳',
'․' => '.',
'‥' => '..',
'…' => '...',
' ' => ' ',
'″' => '′′',
'‴' => '′′′',
'‶' => '‵‵',
'‷' => '‵‵‵',
'‼' => '!!',
'‾' => ' ̅',
'⁇' => '??',
'⁈' => '?!',
'⁉' => '!?',
'⁗' => '′′′′',
' ' => ' ',
'⁰' => '0',
'ⁱ' => 'i',
'⁴' => '4',
'⁵' => '5',
'⁶' => '6',
'⁷' => '7',
'⁸' => '8',
'⁹' => '9',
'⁺' => '+',
'⁻' => '−',
'⁼' => '=',
'⁽' => '(',
'⁾' => ')',
'ⁿ' => 'n',
'₀' => '0',
'₁' => '1',
'₂' => '2',
'₃' => '3',
'₄' => '4',
'₅' => '5',
'₆' => '6',
'₇' => '7',
'₈' => '8',
'₉' => '9',
'₊' => '+',
'₋' => '−',
'₌' => '=',
'₍' => '(',
'₎' => ')',
'ₐ' => 'a',
'ₑ' => 'e',
'ₒ' => 'o',
'ₓ' => 'x',
'ₔ' => 'ə',
'ₕ' => 'h',
'ₖ' => 'k',
'ₗ' => 'l',
'ₘ' => 'm',
'ₙ' => 'n',
'ₚ' => 'p',
'ₛ' => 's',
'ₜ' => 't',
'₨' => 'Rs',
'℀' => 'a/c',
'℁' => 'a/s',
'ℂ' => 'C',
'℃' => '°C',
'℅' => 'c/o',
'℆' => 'c/u',
'ℇ' => 'Ɛ',
'℉' => '°F',
'ℊ' => 'g',
'ℋ' => 'H',
'ℌ' => 'H',
'ℍ' => 'H',
'ℎ' => 'h',
'ℏ' => 'ħ',
'ℐ' => 'I',
'ℑ' => 'I',
'ℒ' => 'L',
'ℓ' => 'l',
'ℕ' => 'N',
'№' => 'No',
'ℙ' => 'P',
'ℚ' => 'Q',
'ℛ' => 'R',
'ℜ' => 'R',
'ℝ' => 'R',
'℠' => 'SM',
'℡' => 'TEL',
'™' => 'TM',
'ℤ' => 'Z',
'ℨ' => 'Z',
'ℬ' => 'B',
'ℭ' => 'C',
'ℯ' => 'e',
'ℰ' => 'E',
'ℱ' => 'F',
'ℳ' => 'M',
'ℴ' => 'o',
'ℵ' => 'א',
'ℶ' => 'ב',
'ℷ' => 'ג',
'ℸ' => 'ד',
'ℹ' => 'i',
'℻' => 'FAX',
'ℼ' => 'π',
'ℽ' => 'γ',
'ℾ' => 'Γ',
'ℿ' => 'Π',
'⅀' => '∑',
'ⅅ' => 'D',
'ⅆ' => 'd',
'ⅇ' => 'e',
'ⅈ' => 'i',
'ⅉ' => 'j',
'⅐' => '1⁄7',
'⅑' => '1⁄9',
'⅒' => '1⁄10',
'⅓' => '1⁄3',
'⅔' => '2⁄3',
'⅕' => '1⁄5',
'⅖' => '2⁄5',
'⅗' => '3⁄5',
'⅘' => '4⁄5',
'⅙' => '1⁄6',
'⅚' => '5⁄6',
'⅛' => '1⁄8',
'⅜' => '3⁄8',
'⅝' => '5⁄8',
'⅞' => '7⁄8',
'⅟' => '1⁄',
'Ⅰ' => 'I',
'Ⅱ' => 'II',
'Ⅲ' => 'III',
'Ⅳ' => 'IV',
'Ⅴ' => 'V',
'Ⅵ' => 'VI',
'Ⅶ' => 'VII',
'Ⅷ' => 'VIII',
'Ⅸ' => 'IX',
'Ⅹ' => 'X',
'Ⅺ' => 'XI',
'Ⅻ' => 'XII',
'Ⅼ' => 'L',
'Ⅽ' => 'C',
'Ⅾ' => 'D',
'Ⅿ' => 'M',
'ⅰ' => 'i',
'ⅱ' => 'ii',
'ⅲ' => 'iii',
'ⅳ' => 'iv',
'ⅴ' => 'v',
'ⅵ' => 'vi',
'ⅶ' => 'vii',
'ⅷ' => 'viii',
'ⅸ' => 'ix',
'ⅹ' => 'x',
'ⅺ' => 'xi',
'ⅻ' => 'xii',
'ⅼ' => 'l',
'ⅽ' => 'c',
'ⅾ' => 'd',
'ⅿ' => 'm',
'↉' => '0⁄3',
'∬' => '∫∫',
'∭' => '∫∫∫',
'∯' => '∮∮',
'∰' => '∮∮∮',
'①' => '1',
'②' => '2',
'③' => '3',
'④' => '4',
'⑤' => '5',
'⑥' => '6',
'⑦' => '7',
'⑧' => '8',
'⑨' => '9',
'⑩' => '10',
'⑪' => '11',
'⑫' => '12',
'⑬' => '13',
'⑭' => '14',
'⑮' => '15',
'⑯' => '16',
'⑰' => '17',
'⑱' => '18',
'⑲' => '19',
'⑳' => '20',
'⑴' => '(1)',
'⑵' => '(2)',
'⑶' => '(3)',
'⑷' => '(4)',
'⑸' => '(5)',
'⑹' => '(6)',
'⑺' => '(7)',
'⑻' => '(8)',
'⑼' => '(9)',
'⑽' => '(10)',
'⑾' => '(11)',
'⑿' => '(12)',
'⒀' => '(13)',
'⒁' => '(14)',
'⒂' => '(15)',
'⒃' => '(16)',
'⒄' => '(17)',
'⒅' => '(18)',
'⒆' => '(19)',
'⒇' => '(20)',
'⒈' => '1.',
'⒉' => '2.',
'⒊' => '3.',
'⒋' => '4.',
'⒌' => '5.',
'⒍' => '6.',
'⒎' => '7.',
'⒏' => '8.',
'⒐' => '9.',
'⒑' => '10.',
'⒒' => '11.',
'⒓' => '12.',
'⒔' => '13.',
'⒕' => '14.',
'⒖' => '15.',
'⒗' => '16.',
'⒘' => '17.',
'⒙' => '18.',
'⒚' => '19.',
'⒛' => '20.',
'⒜' => '(a)',
'⒝' => '(b)',
'⒞' => '(c)',
'⒟' => '(d)',
'⒠' => '(e)',
'⒡' => '(f)',
'⒢' => '(g)',
'⒣' => '(h)',
'⒤' => '(i)',
'⒥' => '(j)',
'⒦' => '(k)',
'⒧' => '(l)',
'⒨' => '(m)',
'⒩' => '(n)',
'⒪' => '(o)',
'⒫' => '(p)',
'⒬' => '(q)',
'⒭' => '(r)',
'⒮' => '(s)',
'⒯' => '(t)',
'⒰' => '(u)',
'⒱' => '(v)',
'⒲' => '(w)',
'⒳' => '(x)',
'⒴' => '(y)',
'⒵' => '(z)',
'Ⓐ' => 'A',
'Ⓑ' => 'B',
'Ⓒ' => 'C',
'Ⓓ' => 'D',
'Ⓔ' => 'E',
'Ⓕ' => 'F',
'Ⓖ' => 'G',
'Ⓗ' => 'H',
'Ⓘ' => 'I',
'Ⓙ' => 'J',
'Ⓚ' => 'K',
'Ⓛ' => 'L',
'Ⓜ' => 'M',
'Ⓝ' => 'N',
'Ⓞ' => 'O',
'Ⓟ' => 'P',
'Ⓠ' => 'Q',
'Ⓡ' => 'R',
'Ⓢ' => 'S',
'Ⓣ' => 'T',
'Ⓤ' => 'U',
'Ⓥ' => 'V',
'Ⓦ' => 'W',
'Ⓧ' => 'X',
'Ⓨ' => 'Y',
'Ⓩ' => 'Z',
'ⓐ' => 'a',
'ⓑ' => 'b',
'ⓒ' => 'c',
'ⓓ' => 'd',
'ⓔ' => 'e',
'ⓕ' => 'f',
'ⓖ' => 'g',
'ⓗ' => 'h',
'ⓘ' => 'i',
'ⓙ' => 'j',
'ⓚ' => 'k',
'ⓛ' => 'l',
'ⓜ' => 'm',
'ⓝ' => 'n',
'ⓞ' => 'o',
'ⓟ' => 'p',
'ⓠ' => 'q',
'ⓡ' => 'r',
'ⓢ' => 's',
'ⓣ' => 't',
'ⓤ' => 'u',
'ⓥ' => 'v',
'ⓦ' => 'w',
'ⓧ' => 'x',
'ⓨ' => 'y',
'ⓩ' => 'z',
'⓪' => '0',
'⨌' => '∫∫∫∫',
'⩴' => '::=',
'⩵' => '==',
'⩶' => '===',
'ⱼ' => 'j',
'ⱽ' => 'V',
'ⵯ' => 'ⵡ',
'⺟' => '母',
'⻳' => '龟',
'⼀' => '一',
'⼁' => '丨',
'⼂' => '丶',
'⼃' => '丿',
'⼄' => '乙',
'⼅' => '亅',
'⼆' => '二',
'⼇' => '亠',
'⼈' => '人',
'⼉' => '儿',
'⼊' => '入',
'⼋' => '八',
'⼌' => '冂',
'⼍' => '冖',
'⼎' => '冫',
'⼏' => '几',
'⼐' => '凵',
'⼑' => '刀',
'⼒' => '力',
'⼓' => '勹',
'⼔' => '匕',
'⼕' => '匚',
'⼖' => '匸',
'⼗' => '十',
'⼘' => '卜',
'⼙' => '卩',
'⼚' => '厂',
'⼛' => '厶',
'⼜' => '又',
'⼝' => '口',
'⼞' => '囗',
'⼟' => '土',
'⼠' => '士',
'⼡' => '夂',
'⼢' => '夊',
'⼣' => '夕',
'⼤' => '大',
'⼥' => '女',
'⼦' => '子',
'⼧' => '宀',
'⼨' => '寸',
'⼩' => '小',
'⼪' => '尢',
'⼫' => '尸',
'⼬' => '屮',
'⼭' => '山',
'⼮' => '巛',
'⼯' => '工',
'⼰' => '己',
'⼱' => '巾',
'⼲' => '干',
'⼳' => '幺',
'⼴' => '广',
'⼵' => '廴',
'⼶' => '廾',
'⼷' => '弋',
'⼸' => '弓',
'⼹' => '彐',
'⼺' => '彡',
'⼻' => '彳',
'⼼' => '心',
'⼽' => '戈',
'⼾' => '戶',
'⼿' => '手',
'⽀' => '支',
'⽁' => '攴',
'⽂' => '文',
'⽃' => '斗',
'⽄' => '斤',
'⽅' => '方',
'⽆' => '无',
'⽇' => '日',
'⽈' => '曰',
'⽉' => '月',
'⽊' => '木',
'⽋' => '欠',
'⽌' => '止',
'⽍' => '歹',
'⽎' => '殳',
'⽏' => '毋',
'⽐' => '比',
'⽑' => '毛',
'⽒' => '氏',
'⽓' => '气',
'⽔' => '水',
'⽕' => '火',
'⽖' => '爪',
'⽗' => '父',
'⽘' => '爻',
'⽙' => '爿',
'⽚' => '片',
'⽛' => '牙',
'⽜' => '牛',
'⽝' => '犬',
'⽞' => '玄',
'⽟' => '玉',
'⽠' => '瓜',
'⽡' => '瓦',
'⽢' => '甘',
'⽣' => '生',
'⽤' => '用',
'⽥' => '田',
'⽦' => '疋',
'⽧' => '疒',
'⽨' => '癶',
'⽩' => '白',
'⽪' => '皮',
'⽫' => '皿',
'⽬' => '目',
'⽭' => '矛',
'⽮' => '矢',
'⽯' => '石',
'⽰' => '示',
'⽱' => '禸',
'⽲' => '禾',
'⽳' => '穴',
'⽴' => '立',
'⽵' => '竹',
'⽶' => '米',
'⽷' => '糸',
'⽸' => '缶',
'⽹' => '网',
'⽺' => '羊',
'⽻' => '羽',
'⽼' => '老',
'⽽' => '而',
'⽾' => '耒',
'⽿' => '耳',
'⾀' => '聿',
'⾁' => '肉',
'⾂' => '臣',
'⾃' => '自',
'⾄' => '至',
'⾅' => '臼',
'⾆' => '舌',
'⾇' => '舛',
'⾈' => '舟',
'⾉' => '艮',
'⾊' => '色',
'⾋' => '艸',
'⾌' => '虍',
'⾍' => '虫',
'⾎' => '血',
'⾏' => '行',
'⾐' => '衣',
'⾑' => '襾',
'⾒' => '見',
'⾓' => '角',
'⾔' => '言',
'⾕' => '谷',
'⾖' => '豆',
'⾗' => '豕',
'⾘' => '豸',
'⾙' => '貝',
'⾚' => '赤',
'⾛' => '走',
'⾜' => '足',
'⾝' => '身',
'⾞' => '車',
'⾟' => '辛',
'⾠' => '辰',
'⾡' => '辵',
'⾢' => '邑',
'⾣' => '酉',
'⾤' => '釆',
'⾥' => '里',
'⾦' => '金',
'⾧' => '長',
'⾨' => '門',
'⾩' => '阜',
'⾪' => '隶',
'⾫' => '隹',
'⾬' => '雨',
'⾭' => '靑',
'⾮' => '非',
'⾯' => '面',
'⾰' => '革',
'⾱' => '韋',
'⾲' => '韭',
'⾳' => '音',
'⾴' => '頁',
'⾵' => '風',
'⾶' => '飛',
'⾷' => '食',
'⾸' => '首',
'⾹' => '香',
'⾺' => '馬',
'⾻' => '骨',
'⾼' => '高',
'⾽' => '髟',
'⾾' => '鬥',
'⾿' => '鬯',
'⿀' => '鬲',
'⿁' => '鬼',
'⿂' => '魚',
'⿃' => '鳥',
'⿄' => '鹵',
'⿅' => '鹿',
'⿆' => '麥',
'⿇' => '麻',
'⿈' => '黃',
'⿉' => '黍',
'⿊' => '黑',
'⿋' => '黹',
'⿌' => '黽',
'⿍' => '鼎',
'⿎' => '鼓',
'⿏' => '鼠',
'⿐' => '鼻',
'⿑' => '齊',
'⿒' => '齒',
'⿓' => '龍',
'⿔' => '龜',
'⿕' => '龠',
' ' => ' ',
'〶' => '〒',
'〸' => '十',
'〹' => '卄',
'〺' => '卅',
'゛' => ' ゙',
'゜' => ' ゚',
'ゟ' => 'より',
'ヿ' => 'コト',
'ㄱ' => 'ᄀ',
'ㄲ' => 'ᄁ',
'ㄳ' => 'ᆪ',
'ㄴ' => 'ᄂ',
'ㄵ' => 'ᆬ',
'ㄶ' => 'ᆭ',
'ㄷ' => 'ᄃ',
'ㄸ' => 'ᄄ',
'ㄹ' => 'ᄅ',
'ㄺ' => 'ᆰ',
'ㄻ' => 'ᆱ',
'ㄼ' => 'ᆲ',
'ㄽ' => 'ᆳ',
'ㄾ' => 'ᆴ',
'ㄿ' => 'ᆵ',
'ㅀ' => 'ᄚ',
'ㅁ' => 'ᄆ',
'ㅂ' => 'ᄇ',
'ㅃ' => 'ᄈ',
'ㅄ' => 'ᄡ',
'ㅅ' => 'ᄉ',
'ㅆ' => 'ᄊ',
'ㅇ' => 'ᄋ',
'ㅈ' => 'ᄌ',
'ㅉ' => 'ᄍ',
'ㅊ' => 'ᄎ',
'ㅋ' => 'ᄏ',
'ㅌ' => 'ᄐ',
'ㅍ' => 'ᄑ',
'ㅎ' => 'ᄒ',
'ㅏ' => 'ᅡ',
'ㅐ' => 'ᅢ',
'ㅑ' => 'ᅣ',
'ㅒ' => 'ᅤ',
'ㅓ' => 'ᅥ',
'ㅔ' => 'ᅦ',
'ㅕ' => 'ᅧ',
'ㅖ' => 'ᅨ',
'ㅗ' => 'ᅩ',
'ㅘ' => 'ᅪ',
'ㅙ' => 'ᅫ',
'ㅚ' => 'ᅬ',
'ㅛ' => 'ᅭ',
'ㅜ' => 'ᅮ',
'ㅝ' => 'ᅯ',
'ㅞ' => 'ᅰ',
'ㅟ' => 'ᅱ',
'ㅠ' => 'ᅲ',
'ㅡ' => 'ᅳ',
'ㅢ' => 'ᅴ',
'ㅣ' => 'ᅵ',
'ㅤ' => 'ᅠ',
'ㅥ' => 'ᄔ',
'ㅦ' => 'ᄕ',
'ㅧ' => 'ᇇ',
'ㅨ' => 'ᇈ',
'ㅩ' => 'ᇌ',
'ㅪ' => 'ᇎ',
'ㅫ' => 'ᇓ',
'ㅬ' => 'ᇗ',
'ㅭ' => 'ᇙ',
'ㅮ' => 'ᄜ',
'ㅯ' => 'ᇝ',
'ㅰ' => 'ᇟ',
'ㅱ' => 'ᄝ',
'ㅲ' => 'ᄞ',
'ㅳ' => 'ᄠ',
'ㅴ' => 'ᄢ',
'ㅵ' => 'ᄣ',
'ㅶ' => 'ᄧ',
'ㅷ' => 'ᄩ',
'ㅸ' => 'ᄫ',
'ㅹ' => 'ᄬ',
'ㅺ' => 'ᄭ',
'ㅻ' => 'ᄮ',
'ㅼ' => 'ᄯ',
'ㅽ' => 'ᄲ',
'ㅾ' => 'ᄶ',
'ㅿ' => 'ᅀ',
'ㆀ' => 'ᅇ',
'ㆁ' => 'ᅌ',
'ㆂ' => 'ᇱ',
'ㆃ' => 'ᇲ',
'ㆄ' => 'ᅗ',
'ㆅ' => 'ᅘ',
'ㆆ' => 'ᅙ',
'ㆇ' => 'ᆄ',
'ㆈ' => 'ᆅ',
'ㆉ' => 'ᆈ',
'ㆊ' => 'ᆑ',
'ㆋ' => 'ᆒ',
'ㆌ' => 'ᆔ',
'ㆍ' => 'ᆞ',
'ㆎ' => 'ᆡ',
'㆒' => '一',
'㆓' => '二',
'㆔' => '三',
'㆕' => '四',
'㆖' => '上',
'㆗' => '中',
'㆘' => '下',
'㆙' => '甲',
'㆚' => '乙',
'㆛' => '丙',
'㆜' => '丁',
'㆝' => '天',
'㆞' => '地',
'㆟' => '人',
'㈀' => '(ᄀ)',
'㈁' => '(ᄂ)',
'㈂' => '(ᄃ)',
'㈃' => '(ᄅ)',
'㈄' => '(ᄆ)',
'㈅' => '(ᄇ)',
'㈆' => '(ᄉ)',
'㈇' => '(ᄋ)',
'㈈' => '(ᄌ)',
'㈉' => '(ᄎ)',
'㈊' => '(ᄏ)',
'㈋' => '(ᄐ)',
'㈌' => '(ᄑ)',
'㈍' => '(ᄒ)',
'㈎' => '(가)',
'㈏' => '(나)',
'㈐' => '(다)',
'㈑' => '(라)',
'㈒' => '(마)',
'㈓' => '(바)',
'㈔' => '(사)',
'㈕' => '(아)',
'㈖' => '(자)',
'㈗' => '(차)',
'㈘' => '(카)',
'㈙' => '(타)',
'㈚' => '(파)',
'㈛' => '(하)',
'㈜' => '(주)',
'㈝' => '(오전)',
'㈞' => '(오후)',
'㈠' => '(一)',
'㈡' => '(二)',
'㈢' => '(三)',
'㈣' => '(四)',
'㈤' => '(五)',
'㈥' => '(六)',
'㈦' => '(七)',
'㈧' => '(八)',
'㈨' => '(九)',
'㈩' => '(十)',
'㈪' => '(月)',
'㈫' => '(火)',
'㈬' => '(水)',
'㈭' => '(木)',
'㈮' => '(金)',
'㈯' => '(土)',
'㈰' => '(日)',
'㈱' => '(株)',
'㈲' => '(有)',
'㈳' => '(社)',
'㈴' => '(名)',
'㈵' => '(特)',
'㈶' => '(財)',
'㈷' => '(祝)',
'㈸' => '(労)',
'㈹' => '(代)',
'㈺' => '(呼)',
'㈻' => '(学)',
'㈼' => '(監)',
'㈽' => '(企)',
'㈾' => '(資)',
'㈿' => '(協)',
'㉀' => '(祭)',
'㉁' => '(休)',
'㉂' => '(自)',
'㉃' => '(至)',
'㉄' => '問',
'㉅' => '幼',
'㉆' => '文',
'㉇' => '箏',
'㉐' => 'PTE',
'㉑' => '21',
'㉒' => '22',
'㉓' => '23',
'㉔' => '24',
'㉕' => '25',
'㉖' => '26',
'㉗' => '27',
'㉘' => '28',
'㉙' => '29',
'㉚' => '30',
'㉛' => '31',
'㉜' => '32',
'㉝' => '33',
'㉞' => '34',
'㉟' => '35',
'㉠' => 'ᄀ',
'㉡' => 'ᄂ',
'㉢' => 'ᄃ',
'㉣' => 'ᄅ',
'㉤' => 'ᄆ',
'㉥' => 'ᄇ',
'㉦' => 'ᄉ',
'㉧' => 'ᄋ',
'㉨' => 'ᄌ',
'㉩' => 'ᄎ',
'㉪' => 'ᄏ',
'㉫' => 'ᄐ',
'㉬' => 'ᄑ',
'㉭' => 'ᄒ',
'㉮' => '가',
'㉯' => '나',
'㉰' => '다',
'㉱' => '라',
'㉲' => '마',
'㉳' => '바',
'㉴' => '사',
'㉵' => '아',
'㉶' => '자',
'㉷' => '차',
'㉸' => '카',
'㉹' => '타',
'㉺' => '파',
'㉻' => '하',
'㉼' => '참고',
'㉽' => '주의',
'㉾' => '우',
'㊀' => '一',
'㊁' => '二',
'㊂' => '三',
'㊃' => '四',
'㊄' => '五',
'㊅' => '六',
'㊆' => '七',
'㊇' => '八',
'㊈' => '九',
'㊉' => '十',
'㊊' => '月',
'㊋' => '火',
'㊌' => '水',
'㊍' => '木',
'㊎' => '金',
'㊏' => '土',
'㊐' => '日',
'㊑' => '株',
'㊒' => '有',
'㊓' => '社',
'㊔' => '名',
'㊕' => '特',
'㊖' => '財',
'㊗' => '祝',
'㊘' => '労',
'㊙' => '秘',
'㊚' => '男',
'㊛' => '女',
'㊜' => '適',
'㊝' => '優',
'㊞' => '印',
'㊟' => '注',
'㊠' => '項',
'㊡' => '休',
'㊢' => '写',
'㊣' => '正',
'㊤' => '上',
'㊥' => '中',
'㊦' => '下',
'㊧' => '左',
'㊨' => '右',
'㊩' => '医',
'㊪' => '宗',
'㊫' => '学',
'㊬' => '監',
'㊭' => '企',
'㊮' => '資',
'㊯' => '協',
'㊰' => '夜',
'㊱' => '36',
'㊲' => '37',
'㊳' => '38',
'㊴' => '39',
'㊵' => '40',
'㊶' => '41',
'㊷' => '42',
'㊸' => '43',
'㊹' => '44',
'㊺' => '45',
'㊻' => '46',
'㊼' => '47',
'㊽' => '48',
'㊾' => '49',
'㊿' => '50',
'㋀' => '1月',
'㋁' => '2月',
'㋂' => '3月',
'㋃' => '4月',
'㋄' => '5月',
'㋅' => '6月',
'㋆' => '7月',
'㋇' => '8月',
'㋈' => '9月',
'㋉' => '10月',
'㋊' => '11月',
'㋋' => '12月',
'㋌' => 'Hg',
'㋍' => 'erg',
'㋎' => 'eV',
'㋏' => 'LTD',
'㋐' => 'ア',
'㋑' => 'イ',
'㋒' => 'ウ',
'㋓' => 'エ',
'㋔' => 'オ',
'㋕' => 'カ',
'㋖' => 'キ',
'㋗' => 'ク',
'㋘' => 'ケ',
'㋙' => 'コ',
'㋚' => 'サ',
'㋛' => 'シ',
'㋜' => 'ス',
'㋝' => 'セ',
'㋞' => 'ソ',
'㋟' => 'タ',
'㋠' => 'チ',
'㋡' => 'ツ',
'㋢' => 'テ',
'㋣' => 'ト',
'㋤' => 'ナ',
'㋥' => 'ニ',
'㋦' => 'ヌ',
'㋧' => 'ネ',
'㋨' => 'ノ',
'㋩' => 'ハ',
'㋪' => 'ヒ',
'㋫' => 'フ',
'㋬' => 'ヘ',
'㋭' => 'ホ',
'㋮' => 'マ',
'㋯' => 'ミ',
'㋰' => 'ム',
'㋱' => 'メ',
'㋲' => 'モ',
'㋳' => 'ヤ',
'㋴' => 'ユ',
'㋵' => 'ヨ',
'㋶' => 'ラ',
'㋷' => 'リ',
'㋸' => 'ル',
'㋹' => 'レ',
'㋺' => 'ロ',
'㋻' => 'ワ',
'㋼' => 'ヰ',
'㋽' => 'ヱ',
'㋾' => 'ヲ',
'㋿' => '令和',
'㌀' => 'アパート',
'㌁' => 'アルファ',
'㌂' => 'アンペア',
'㌃' => 'アール',
'㌄' => 'イニング',
'㌅' => 'インチ',
'㌆' => 'ウォン',
'㌇' => 'エスクード',
'㌈' => 'エーカー',
'㌉' => 'オンス',
'㌊' => 'オーム',
'㌋' => 'カイリ',
'㌌' => 'カラット',
'㌍' => 'カロリー',
'㌎' => 'ガロン',
'㌏' => 'ガンマ',
'㌐' => 'ギガ',
'㌑' => 'ギニー',
'㌒' => 'キュリー',
'㌓' => 'ギルダー',
'㌔' => 'キロ',
'㌕' => 'キログラム',
'㌖' => 'キロメートル',
'㌗' => 'キロワット',
'㌘' => 'グラム',
'㌙' => 'グラムトン',
'㌚' => 'クルゼイロ',
'㌛' => 'クローネ',
'㌜' => 'ケース',
'㌝' => 'コルナ',
'㌞' => 'コーポ',
'㌟' => 'サイクル',
'㌠' => 'サンチーム',
'㌡' => 'シリング',
'㌢' => 'センチ',
'㌣' => 'セント',
'㌤' => 'ダース',
'㌥' => 'デシ',
'㌦' => 'ドル',
'㌧' => 'トン',
'㌨' => 'ナノ',
'㌩' => 'ノット',
'㌪' => 'ハイツ',
'㌫' => 'パーセント',
'㌬' => 'パーツ',
'㌭' => 'バーレル',
'㌮' => 'ピアストル',
'㌯' => 'ピクル',
'㌰' => 'ピコ',
'㌱' => 'ビル',
'㌲' => 'ファラッド',
'㌳' => 'フィート',
'㌴' => 'ブッシェル',
'㌵' => 'フラン',
'㌶' => 'ヘクタール',
'㌷' => 'ペソ',
'㌸' => 'ペニヒ',
'㌹' => 'ヘルツ',
'㌺' => 'ペンス',
'㌻' => 'ページ',
'㌼' => 'ベータ',
'㌽' => 'ポイント',
'㌾' => 'ボルト',
'㌿' => 'ホン',
'㍀' => 'ポンド',
'㍁' => 'ホール',
'㍂' => 'ホーン',
'㍃' => 'マイクロ',
'㍄' => 'マイル',
'㍅' => 'マッハ',
'㍆' => 'マルク',
'㍇' => 'マンション',
'㍈' => 'ミクロン',
'㍉' => 'ミリ',
'㍊' => 'ミリバール',
'㍋' => 'メガ',
'㍌' => 'メガトン',
'㍍' => 'メートル',
'㍎' => 'ヤード',
'㍏' => 'ヤール',
'㍐' => 'ユアン',
'㍑' => 'リットル',
'㍒' => 'リラ',
'㍓' => 'ルピー',
'㍔' => 'ルーブル',
'㍕' => 'レム',
'㍖' => 'レントゲン',
'㍗' => 'ワット',
'㍘' => '0点',
'㍙' => '1点',
'㍚' => '2点',
'㍛' => '3点',
'㍜' => '4点',
'㍝' => '5点',
'㍞' => '6点',
'㍟' => '7点',
'㍠' => '8点',
'㍡' => '9点',
'㍢' => '10点',
'㍣' => '11点',
'㍤' => '12点',
'㍥' => '13点',
'㍦' => '14点',
'㍧' => '15点',
'㍨' => '16点',
'㍩' => '17点',
'㍪' => '18点',
'㍫' => '19点',
'㍬' => '20点',
'㍭' => '21点',
'㍮' => '22点',
'㍯' => '23点',
'㍰' => '24点',
'㍱' => 'hPa',
'㍲' => 'da',
'㍳' => 'AU',
'㍴' => 'bar',
'㍵' => 'oV',
'㍶' => 'pc',
'㍷' => 'dm',
'㍸' => 'dm2',
'㍹' => 'dm3',
'㍺' => 'IU',
'㍻' => '平成',
'㍼' => '昭和',
'㍽' => '大正',
'㍾' => '明治',
'㍿' => '株式会社',
'㎀' => 'pA',
'㎁' => 'nA',
'㎂' => 'μA',
'㎃' => 'mA',
'㎄' => 'kA',
'㎅' => 'KB',
'㎆' => 'MB',
'㎇' => 'GB',
'㎈' => 'cal',
'㎉' => 'kcal',
'㎊' => 'pF',
'㎋' => 'nF',
'㎌' => 'μF',
'㎍' => 'μg',
'㎎' => 'mg',
'㎏' => 'kg',
'㎐' => 'Hz',
'㎑' => 'kHz',
'㎒' => 'MHz',
'㎓' => 'GHz',
'㎔' => 'THz',
'㎕' => 'μl',
'㎖' => 'ml',
'㎗' => 'dl',
'㎘' => 'kl',
'㎙' => 'fm',
'㎚' => 'nm',
'㎛' => 'μm',
'㎜' => 'mm',
'㎝' => 'cm',
'㎞' => 'km',
'㎟' => 'mm2',
'㎠' => 'cm2',
'㎡' => 'm2',
'㎢' => 'km2',
'㎣' => 'mm3',
'㎤' => 'cm3',
'㎥' => 'm3',
'㎦' => 'km3',
'㎧' => 'm∕s',
'㎨' => 'm∕s2',
'㎩' => 'Pa',
'㎪' => 'kPa',
'㎫' => 'MPa',
'㎬' => 'GPa',
'㎭' => 'rad',
'㎮' => 'rad∕s',
'㎯' => 'rad∕s2',
'㎰' => 'ps',
'㎱' => 'ns',
'㎲' => 'μs',
'㎳' => 'ms',
'㎴' => 'pV',
'㎵' => 'nV',
'㎶' => 'μV',
'㎷' => 'mV',
'㎸' => 'kV',
'㎹' => 'MV',
'㎺' => 'pW',
'㎻' => 'nW',
'㎼' => 'μW',
'㎽' => 'mW',
'㎾' => 'kW',
'㎿' => 'MW',
'㏀' => 'kΩ',
'㏁' => 'MΩ',
'㏂' => 'a.m.',
'㏃' => 'Bq',
'㏄' => 'cc',
'㏅' => 'cd',
'㏆' => 'C∕kg',
'㏇' => 'Co.',
'㏈' => 'dB',
'㏉' => 'Gy',
'㏊' => 'ha',
'㏋' => 'HP',
'㏌' => 'in',
'㏍' => 'KK',
'㏎' => 'KM',
'㏏' => 'kt',
'㏐' => 'lm',
'㏑' => 'ln',
'㏒' => 'log',
'㏓' => 'lx',
'㏔' => 'mb',
'㏕' => 'mil',
'㏖' => 'mol',
'㏗' => 'PH',
'㏘' => 'p.m.',
'㏙' => 'PPM',
'㏚' => 'PR',
'㏛' => 'sr',
'㏜' => 'Sv',
'㏝' => 'Wb',
'㏞' => 'V∕m',
'㏟' => 'A∕m',
'㏠' => '1日',
'㏡' => '2日',
'㏢' => '3日',
'㏣' => '4日',
'㏤' => '5日',
'㏥' => '6日',
'㏦' => '7日',
'㏧' => '8日',
'㏨' => '9日',
'㏩' => '10日',
'㏪' => '11日',
'㏫' => '12日',
'㏬' => '13日',
'㏭' => '14日',
'㏮' => '15日',
'㏯' => '16日',
'㏰' => '17日',
'㏱' => '18日',
'㏲' => '19日',
'㏳' => '20日',
'㏴' => '21日',
'㏵' => '22日',
'㏶' => '23日',
'㏷' => '24日',
'㏸' => '25日',
'㏹' => '26日',
'㏺' => '27日',
'㏻' => '28日',
'㏼' => '29日',
'㏽' => '30日',
'㏾' => '31日',
'㏿' => 'gal',
'ꚜ' => 'ъ',
'ꚝ' => 'ь',
'ꝰ' => 'ꝯ',
'ꟸ' => 'Ħ',
'ꟹ' => 'œ',
'ꭜ' => 'ꜧ',
'ꭝ' => 'ꬷ',
'ꭞ' => 'ɫ',
'ꭟ' => 'ꭒ',
'ꭩ' => 'ʍ',
'ff' => 'ff',
'fi' => 'fi',
'fl' => 'fl',
'ffi' => 'ffi',
'ffl' => 'ffl',
'ſt' => 'st',
'st' => 'st',
'ﬓ' => 'մն',
'ﬔ' => 'մե',
'ﬕ' => 'մի',
'ﬖ' => 'վն',
'ﬗ' => 'մխ',
'ﬠ' => 'ע',
'ﬡ' => 'א',
'ﬢ' => 'ד',
'ﬣ' => 'ה',
'ﬤ' => 'כ',
'ﬥ' => 'ל',
'ﬦ' => 'ם',
'ﬧ' => 'ר',
'ﬨ' => 'ת',
'﬩' => '+',
'ﭏ' => 'אל',
'ﭐ' => 'ٱ',
'ﭑ' => 'ٱ',
'ﭒ' => 'ٻ',
'ﭓ' => 'ٻ',
'ﭔ' => 'ٻ',
'ﭕ' => 'ٻ',
'ﭖ' => 'پ',
'ﭗ' => 'پ',
'ﭘ' => 'پ',
'ﭙ' => 'پ',
'ﭚ' => 'ڀ',
'ﭛ' => 'ڀ',
'ﭜ' => 'ڀ',
'ﭝ' => 'ڀ',
'ﭞ' => 'ٺ',
'ﭟ' => 'ٺ',
'ﭠ' => 'ٺ',
'ﭡ' => 'ٺ',
'ﭢ' => 'ٿ',
'ﭣ' => 'ٿ',
'ﭤ' => 'ٿ',
'ﭥ' => 'ٿ',
'ﭦ' => 'ٹ',
'ﭧ' => 'ٹ',
'ﭨ' => 'ٹ',
'ﭩ' => 'ٹ',
'ﭪ' => 'ڤ',
'ﭫ' => 'ڤ',
'ﭬ' => 'ڤ',
'ﭭ' => 'ڤ',
'ﭮ' => 'ڦ',
'ﭯ' => 'ڦ',
'ﭰ' => 'ڦ',
'ﭱ' => 'ڦ',
'ﭲ' => 'ڄ',
'ﭳ' => 'ڄ',
'ﭴ' => 'ڄ',
'ﭵ' => 'ڄ',
'ﭶ' => 'ڃ',
'ﭷ' => 'ڃ',
'ﭸ' => 'ڃ',
'ﭹ' => 'ڃ',
'ﭺ' => 'چ',
'ﭻ' => 'چ',
'ﭼ' => 'چ',
'ﭽ' => 'چ',
'ﭾ' => 'ڇ',
'ﭿ' => 'ڇ',
'ﮀ' => 'ڇ',
'ﮁ' => 'ڇ',
'ﮂ' => 'ڍ',
'ﮃ' => 'ڍ',
'ﮄ' => 'ڌ',
'ﮅ' => 'ڌ',
'ﮆ' => 'ڎ',
'ﮇ' => 'ڎ',
'ﮈ' => 'ڈ',
'ﮉ' => 'ڈ',
'ﮊ' => 'ژ',
'ﮋ' => 'ژ',
'ﮌ' => 'ڑ',
'ﮍ' => 'ڑ',
'ﮎ' => 'ک',
'ﮏ' => 'ک',
'ﮐ' => 'ک',
'ﮑ' => 'ک',
'ﮒ' => 'گ',
'ﮓ' => 'گ',
'ﮔ' => 'گ',
'ﮕ' => 'گ',
'ﮖ' => 'ڳ',
'ﮗ' => 'ڳ',
'ﮘ' => 'ڳ',
'ﮙ' => 'ڳ',
'ﮚ' => 'ڱ',
'ﮛ' => 'ڱ',
'ﮜ' => 'ڱ',
'ﮝ' => 'ڱ',
'ﮞ' => 'ں',
'ﮟ' => 'ں',
'ﮠ' => 'ڻ',
'ﮡ' => 'ڻ',
'ﮢ' => 'ڻ',
'ﮣ' => 'ڻ',
'ﮤ' => 'ۀ',
'ﮥ' => 'ۀ',
'ﮦ' => 'ہ',
'ﮧ' => 'ہ',
'ﮨ' => 'ہ',
'ﮩ' => 'ہ',
'ﮪ' => 'ھ',
'ﮫ' => 'ھ',
'ﮬ' => 'ھ',
'ﮭ' => 'ھ',
'ﮮ' => 'ے',
'ﮯ' => 'ے',
'ﮰ' => 'ۓ',
'ﮱ' => 'ۓ',
'ﯓ' => 'ڭ',
'ﯔ' => 'ڭ',
'ﯕ' => 'ڭ',
'ﯖ' => 'ڭ',
'ﯗ' => 'ۇ',
'ﯘ' => 'ۇ',
'ﯙ' => 'ۆ',
'ﯚ' => 'ۆ',
'ﯛ' => 'ۈ',
'ﯜ' => 'ۈ',
'ﯝ' => 'ۇٴ',
'ﯞ' => 'ۋ',
'ﯟ' => 'ۋ',
'ﯠ' => 'ۅ',
'ﯡ' => 'ۅ',
'ﯢ' => 'ۉ',
'ﯣ' => 'ۉ',
'ﯤ' => 'ې',
'ﯥ' => 'ې',
'ﯦ' => 'ې',
'ﯧ' => 'ې',
'ﯨ' => 'ى',
'ﯩ' => 'ى',
'ﯪ' => 'ئا',
'ﯫ' => 'ئا',
'ﯬ' => 'ئە',
'ﯭ' => 'ئە',
'ﯮ' => 'ئو',
'ﯯ' => 'ئو',
'ﯰ' => 'ئۇ',
'ﯱ' => 'ئۇ',
'ﯲ' => 'ئۆ',
'ﯳ' => 'ئۆ',
'ﯴ' => 'ئۈ',
'ﯵ' => 'ئۈ',
'ﯶ' => 'ئې',
'ﯷ' => 'ئې',
'ﯸ' => 'ئې',
'ﯹ' => 'ئى',
'ﯺ' => 'ئى',
'ﯻ' => 'ئى',
'ﯼ' => 'ی',
'ﯽ' => 'ی',
'ﯾ' => 'ی',
'ﯿ' => 'ی',
'ﰀ' => 'ئج',
'ﰁ' => 'ئح',
'ﰂ' => 'ئم',
'ﰃ' => 'ئى',
'ﰄ' => 'ئي',
'ﰅ' => 'بج',
'ﰆ' => 'بح',
'ﰇ' => 'بخ',
'ﰈ' => 'بم',
'ﰉ' => 'بى',
'ﰊ' => 'بي',
'ﰋ' => 'تج',
'ﰌ' => 'تح',
'ﰍ' => 'تخ',
'ﰎ' => 'تم',
'ﰏ' => 'تى',
'ﰐ' => 'تي',
'ﰑ' => 'ثج',
'ﰒ' => 'ثم',
'ﰓ' => 'ثى',
'ﰔ' => 'ثي',
'ﰕ' => 'جح',
'ﰖ' => 'جم',
'ﰗ' => 'حج',
'ﰘ' => 'حم',
'ﰙ' => 'خج',
'ﰚ' => 'خح',
'ﰛ' => 'خم',
'ﰜ' => 'سج',
'ﰝ' => 'سح',
'ﰞ' => 'سخ',
'ﰟ' => 'سم',
'ﰠ' => 'صح',
'ﰡ' => 'صم',
'ﰢ' => 'ضج',
'ﰣ' => 'ضح',
'ﰤ' => 'ضخ',
'ﰥ' => 'ضم',
'ﰦ' => 'طح',
'ﰧ' => 'طم',
'ﰨ' => 'ظم',
'ﰩ' => 'عج',
'ﰪ' => 'عم',
'ﰫ' => 'غج',
'ﰬ' => 'غم',
'ﰭ' => 'فج',
'ﰮ' => 'فح',
'ﰯ' => 'فخ',
'ﰰ' => 'فم',
'ﰱ' => 'فى',
'ﰲ' => 'في',
'ﰳ' => 'قح',
'ﰴ' => 'قم',
'ﰵ' => 'قى',
'ﰶ' => 'قي',
'ﰷ' => 'كا',
'ﰸ' => 'كج',
'ﰹ' => 'كح',
'ﰺ' => 'كخ',
'ﰻ' => 'كل',
'ﰼ' => 'كم',
'ﰽ' => 'كى',
'ﰾ' => 'كي',
'ﰿ' => 'لج',
'ﱀ' => 'لح',
'ﱁ' => 'لخ',
'ﱂ' => 'لم',
'ﱃ' => 'لى',
'ﱄ' => 'لي',
'ﱅ' => 'مج',
'ﱆ' => 'مح',
'ﱇ' => 'مخ',
'ﱈ' => 'مم',
'ﱉ' => 'مى',
'ﱊ' => 'مي',
'ﱋ' => 'نج',
'ﱌ' => 'نح',
'ﱍ' => 'نخ',
'ﱎ' => 'نم',
'ﱏ' => 'نى',
'ﱐ' => 'ني',
'ﱑ' => 'هج',
'ﱒ' => 'هم',
'ﱓ' => 'هى',
'ﱔ' => 'هي',
'ﱕ' => 'يج',
'ﱖ' => 'يح',
'ﱗ' => 'يخ',
'ﱘ' => 'يم',
'ﱙ' => 'يى',
'ﱚ' => 'يي',
'ﱛ' => 'ذٰ',
'ﱜ' => 'رٰ',
'ﱝ' => 'ىٰ',
'ﱞ' => ' ٌّ',
'ﱟ' => ' ٍّ',
'ﱠ' => ' َّ',
'ﱡ' => ' ُّ',
'ﱢ' => ' ِّ',
'ﱣ' => ' ّٰ',
'ﱤ' => 'ئر',
'ﱥ' => 'ئز',
'ﱦ' => 'ئم',
'ﱧ' => 'ئن',
'ﱨ' => 'ئى',
'ﱩ' => 'ئي',
'ﱪ' => 'بر',
'ﱫ' => 'بز',
'ﱬ' => 'بم',
'ﱭ' => 'بن',
'ﱮ' => 'بى',
'ﱯ' => 'بي',
'ﱰ' => 'تر',
'ﱱ' => 'تز',
'ﱲ' => 'تم',
'ﱳ' => 'تن',
'ﱴ' => 'تى',
'ﱵ' => 'تي',
'ﱶ' => 'ثر',
'ﱷ' => 'ثز',
'ﱸ' => 'ثم',
'ﱹ' => 'ثن',
'ﱺ' => 'ثى',
'ﱻ' => 'ثي',
'ﱼ' => 'فى',
'ﱽ' => 'في',
'ﱾ' => 'قى',
'ﱿ' => 'قي',
'ﲀ' => 'كا',
'ﲁ' => 'كل',
'ﲂ' => 'كم',
'ﲃ' => 'كى',
'ﲄ' => 'كي',
'ﲅ' => 'لم',
'ﲆ' => 'لى',
'ﲇ' => 'لي',
'ﲈ' => 'ما',
'ﲉ' => 'مم',
'ﲊ' => 'نر',
'ﲋ' => 'نز',
'ﲌ' => 'نم',
'ﲍ' => 'نن',
'ﲎ' => 'نى',
'ﲏ' => 'ني',
'ﲐ' => 'ىٰ',
'ﲑ' => 'ير',
'ﲒ' => 'يز',
'ﲓ' => 'يم',
'ﲔ' => 'ين',
'ﲕ' => 'يى',
'ﲖ' => 'يي',
'ﲗ' => 'ئج',
'ﲘ' => 'ئح',
'ﲙ' => 'ئخ',
'ﲚ' => 'ئم',
'ﲛ' => 'ئه',
'ﲜ' => 'بج',
'ﲝ' => 'بح',
'ﲞ' => 'بخ',
'ﲟ' => 'بم',
'ﲠ' => 'به',
'ﲡ' => 'تج',
'ﲢ' => 'تح',
'ﲣ' => 'تخ',
'ﲤ' => 'تم',
'ﲥ' => 'ته',
'ﲦ' => 'ثم',
'ﲧ' => 'جح',
'ﲨ' => 'جم',
'ﲩ' => 'حج',
'ﲪ' => 'حم',
'ﲫ' => 'خج',
'ﲬ' => 'خم',
'ﲭ' => 'سج',
'ﲮ' => 'سح',
'ﲯ' => 'سخ',
'ﲰ' => 'سم',
'ﲱ' => 'صح',
'ﲲ' => 'صخ',
'ﲳ' => 'صم',
'ﲴ' => 'ضج',
'ﲵ' => 'ضح',
'ﲶ' => 'ضخ',
'ﲷ' => 'ضم',
'ﲸ' => 'طح',
'ﲹ' => 'ظم',
'ﲺ' => 'عج',
'ﲻ' => 'عم',
'ﲼ' => 'غج',
'ﲽ' => 'غم',
'ﲾ' => 'فج',
'ﲿ' => 'فح',
'ﳀ' => 'فخ',
'ﳁ' => 'فم',
'ﳂ' => 'قح',
'ﳃ' => 'قم',
'ﳄ' => 'كج',
'ﳅ' => 'كح',
'ﳆ' => 'كخ',
'ﳇ' => 'كل',
'ﳈ' => 'كم',
'ﳉ' => 'لج',
'ﳊ' => 'لح',
'ﳋ' => 'لخ',
'ﳌ' => 'لم',
'ﳍ' => 'له',
'ﳎ' => 'مج',
'ﳏ' => 'مح',
'ﳐ' => 'مخ',
'ﳑ' => 'مم',
'ﳒ' => 'نج',
'ﳓ' => 'نح',
'ﳔ' => 'نخ',
'ﳕ' => 'نم',
'ﳖ' => 'نه',
'ﳗ' => 'هج',
'ﳘ' => 'هم',
'ﳙ' => 'هٰ',
'ﳚ' => 'يج',
'ﳛ' => 'يح',
'ﳜ' => 'يخ',
'ﳝ' => 'يم',
'ﳞ' => 'يه',
'ﳟ' => 'ئم',
'ﳠ' => 'ئه',
'ﳡ' => 'بم',
'ﳢ' => 'به',
'ﳣ' => 'تم',
'ﳤ' => 'ته',
'ﳥ' => 'ثم',
'ﳦ' => 'ثه',
'ﳧ' => 'سم',
'ﳨ' => 'سه',
'ﳩ' => 'شم',
'ﳪ' => 'شه',
'ﳫ' => 'كل',
'ﳬ' => 'كم',
'ﳭ' => 'لم',
'ﳮ' => 'نم',
'ﳯ' => 'نه',
'ﳰ' => 'يم',
'ﳱ' => 'يه',
'ﳲ' => 'ـَّ',
'ﳳ' => 'ـُّ',
'ﳴ' => 'ـِّ',
'ﳵ' => 'طى',
'ﳶ' => 'طي',
'ﳷ' => 'عى',
'ﳸ' => 'عي',
'ﳹ' => 'غى',
'ﳺ' => 'غي',
'ﳻ' => 'سى',
'ﳼ' => 'سي',
'ﳽ' => 'شى',
'ﳾ' => 'شي',
'ﳿ' => 'حى',
'ﴀ' => 'حي',
'ﴁ' => 'جى',
'ﴂ' => 'جي',
'ﴃ' => 'خى',
'ﴄ' => 'خي',
'ﴅ' => 'صى',
'ﴆ' => 'صي',
'ﴇ' => 'ضى',
'ﴈ' => 'ضي',
'ﴉ' => 'شج',
'ﴊ' => 'شح',
'ﴋ' => 'شخ',
'ﴌ' => 'شم',
'ﴍ' => 'شر',
'ﴎ' => 'سر',
'ﴏ' => 'صر',
'ﴐ' => 'ضر',
'ﴑ' => 'طى',
'ﴒ' => 'طي',
'ﴓ' => 'عى',
'ﴔ' => 'عي',
'ﴕ' => 'غى',
'ﴖ' => 'غي',
'ﴗ' => 'سى',
'ﴘ' => 'سي',
'ﴙ' => 'شى',
'ﴚ' => 'شي',
'ﴛ' => 'حى',
'ﴜ' => 'حي',
'ﴝ' => 'جى',
'ﴞ' => 'جي',
'ﴟ' => 'خى',
'ﴠ' => 'خي',
'ﴡ' => 'صى',
'ﴢ' => 'صي',
'ﴣ' => 'ضى',
'ﴤ' => 'ضي',
'ﴥ' => 'شج',
'ﴦ' => 'شح',
'ﴧ' => 'شخ',
'ﴨ' => 'شم',
'ﴩ' => 'شر',
'ﴪ' => 'سر',
'ﴫ' => 'صر',
'ﴬ' => 'ضر',
'ﴭ' => 'شج',
'ﴮ' => 'شح',
'ﴯ' => 'شخ',
'ﴰ' => 'شم',
'ﴱ' => 'سه',
'ﴲ' => 'شه',
'ﴳ' => 'طم',
'ﴴ' => 'سج',
'ﴵ' => 'سح',
'ﴶ' => 'سخ',
'ﴷ' => 'شج',
'ﴸ' => 'شح',
'ﴹ' => 'شخ',
'ﴺ' => 'طم',
'ﴻ' => 'ظم',
'ﴼ' => 'اً',
'ﴽ' => 'اً',
'ﵐ' => 'تجم',
'ﵑ' => 'تحج',
'ﵒ' => 'تحج',
'ﵓ' => 'تحم',
'ﵔ' => 'تخم',
'ﵕ' => 'تمج',
'ﵖ' => 'تمح',
'ﵗ' => 'تمخ',
'ﵘ' => 'جمح',
'ﵙ' => 'جمح',
'ﵚ' => 'حمي',
'ﵛ' => 'حمى',
'ﵜ' => 'سحج',
'ﵝ' => 'سجح',
'ﵞ' => 'سجى',
'ﵟ' => 'سمح',
'ﵠ' => 'سمح',
'ﵡ' => 'سمج',
'ﵢ' => 'سمم',
'ﵣ' => 'سمم',
'ﵤ' => 'صحح',
'ﵥ' => 'صحح',
'ﵦ' => 'صمم',
'ﵧ' => 'شحم',
'ﵨ' => 'شحم',
'ﵩ' => 'شجي',
'ﵪ' => 'شمخ',
'ﵫ' => 'شمخ',
'ﵬ' => 'شمم',
'ﵭ' => 'شمم',
'ﵮ' => 'ضحى',
'ﵯ' => 'ضخم',
'ﵰ' => 'ضخم',
'ﵱ' => 'طمح',
'ﵲ' => 'طمح',
'ﵳ' => 'طمم',
'ﵴ' => 'طمي',
'ﵵ' => 'عجم',
'ﵶ' => 'عمم',
'ﵷ' => 'عمم',
'ﵸ' => 'عمى',
'ﵹ' => 'غمم',
'ﵺ' => 'غمي',
'ﵻ' => 'غمى',
'ﵼ' => 'فخم',
'ﵽ' => 'فخم',
'ﵾ' => 'قمح',
'ﵿ' => 'قمم',
'ﶀ' => 'لحم',
'ﶁ' => 'لحي',
'ﶂ' => 'لحى',
'ﶃ' => 'لجج',
'ﶄ' => 'لجج',
'ﶅ' => 'لخم',
'ﶆ' => 'لخم',
'ﶇ' => 'لمح',
'ﶈ' => 'لمح',
'ﶉ' => 'محج',
'ﶊ' => 'محم',
'ﶋ' => 'محي',
'ﶌ' => 'مجح',
'ﶍ' => 'مجم',
'ﶎ' => 'مخج',
'ﶏ' => 'مخم',
'ﶒ' => 'مجخ',
'ﶓ' => 'همج',
'ﶔ' => 'همم',
'ﶕ' => 'نحم',
'ﶖ' => 'نحى',
'ﶗ' => 'نجم',
'ﶘ' => 'نجم',
'ﶙ' => 'نجى',
'ﶚ' => 'نمي',
'ﶛ' => 'نمى',
'ﶜ' => 'يمم',
'ﶝ' => 'يمم',
'ﶞ' => 'بخي',
'ﶟ' => 'تجي',
'ﶠ' => 'تجى',
'ﶡ' => 'تخي',
'ﶢ' => 'تخى',
'ﶣ' => 'تمي',
'ﶤ' => 'تمى',
'ﶥ' => 'جمي',
'ﶦ' => 'جحى',
'ﶧ' => 'جمى',
'ﶨ' => 'سخى',
'ﶩ' => 'صحي',
'ﶪ' => 'شحي',
'ﶫ' => 'ضحي',
'ﶬ' => 'لجي',
'ﶭ' => 'لمي',
'ﶮ' => 'يحي',
'ﶯ' => 'يجي',
'ﶰ' => 'يمي',
'ﶱ' => 'ممي',
'ﶲ' => 'قمي',
'ﶳ' => 'نحي',
'ﶴ' => 'قمح',
'ﶵ' => 'لحم',
'ﶶ' => 'عمي',
'ﶷ' => 'كمي',
'ﶸ' => 'نجح',
'ﶹ' => 'مخي',
'ﶺ' => 'لجم',
'ﶻ' => 'كمم',
'ﶼ' => 'لجم',
'ﶽ' => 'نجح',
'ﶾ' => 'جحي',
'ﶿ' => 'حجي',
'ﷀ' => 'مجي',
'ﷁ' => 'فمي',
'ﷂ' => 'بحي',
'ﷃ' => 'كمم',
'ﷄ' => 'عجم',
'ﷅ' => 'صمم',
'ﷆ' => 'سخي',
'ﷇ' => 'نجي',
'ﷰ' => 'صلے',
'ﷱ' => 'قلے',
'ﷲ' => 'الله',
'ﷳ' => 'اكبر',
'ﷴ' => 'محمد',
'ﷵ' => 'صلعم',
'ﷶ' => 'رسول',
'ﷷ' => 'عليه',
'ﷸ' => 'وسلم',
'ﷹ' => 'صلى',
'ﷺ' => 'صلى الله عليه وسلم',
'ﷻ' => 'جل جلاله',
'﷼' => 'ریال',
'︐' => ',',
'︑' => '、',
'︒' => '。',
'︓' => ':',
'︔' => ';',
'︕' => '!',
'︖' => '?',
'︗' => '〖',
'︘' => '〗',
'︙' => '...',
'︰' => '..',
'︱' => '—',
'︲' => '–',
'︳' => '_',
'︴' => '_',
'︵' => '(',
'︶' => ')',
'︷' => '{',
'︸' => '}',
'︹' => '〔',
'︺' => '〕',
'︻' => '【',
'︼' => '】',
'︽' => '《',
'︾' => '》',
'︿' => '〈',
'﹀' => '〉',
'﹁' => '「',
'﹂' => '」',
'﹃' => '『',
'﹄' => '』',
'﹇' => '[',
'﹈' => ']',
'﹉' => ' ̅',
'﹊' => ' ̅',
'﹋' => ' ̅',
'﹌' => ' ̅',
'﹍' => '_',
'﹎' => '_',
'﹏' => '_',
'﹐' => ',',
'﹑' => '、',
'﹒' => '.',
'﹔' => ';',
'﹕' => ':',
'﹖' => '?',
'﹗' => '!',
'﹘' => '—',
'﹙' => '(',
'﹚' => ')',
'﹛' => '{',
'﹜' => '}',
'﹝' => '〔',
'﹞' => '〕',
'﹟' => '#',
'﹠' => '&',
'﹡' => '*',
'﹢' => '+',
'﹣' => '-',
'﹤' => '<',
'﹥' => '>',
'﹦' => '=',
'﹨' => '\\',
'﹩' => '$',
'﹪' => '%',
'﹫' => '@',
'ﹰ' => ' ً',
'ﹱ' => 'ـً',
'ﹲ' => ' ٌ',
'ﹴ' => ' ٍ',
'ﹶ' => ' َ',
'ﹷ' => 'ـَ',
'ﹸ' => ' ُ',
'ﹹ' => 'ـُ',
'ﹺ' => ' ِ',
'ﹻ' => 'ـِ',
'ﹼ' => ' ّ',
'ﹽ' => 'ـّ',
'ﹾ' => ' ْ',
'ﹿ' => 'ـْ',
'ﺀ' => 'ء',
'ﺁ' => 'آ',
'ﺂ' => 'آ',
'ﺃ' => 'أ',
'ﺄ' => 'أ',
'ﺅ' => 'ؤ',
'ﺆ' => 'ؤ',
'ﺇ' => 'إ',
'ﺈ' => 'إ',
'ﺉ' => 'ئ',
'ﺊ' => 'ئ',
'ﺋ' => 'ئ',
'ﺌ' => 'ئ',
'ﺍ' => 'ا',
'ﺎ' => 'ا',
'ﺏ' => 'ب',
'ﺐ' => 'ب',
'ﺑ' => 'ب',
'ﺒ' => 'ب',
'ﺓ' => 'ة',
'ﺔ' => 'ة',
'ﺕ' => 'ت',
'ﺖ' => 'ت',
'ﺗ' => 'ت',
'ﺘ' => 'ت',
'ﺙ' => 'ث',
'ﺚ' => 'ث',
'ﺛ' => 'ث',
'ﺜ' => 'ث',
'ﺝ' => 'ج',
'ﺞ' => 'ج',
'ﺟ' => 'ج',
'ﺠ' => 'ج',
'ﺡ' => 'ح',
'ﺢ' => 'ح',
'ﺣ' => 'ح',
'ﺤ' => 'ح',
'ﺥ' => 'خ',
'ﺦ' => 'خ',
'ﺧ' => 'خ',
'ﺨ' => 'خ',
'ﺩ' => 'د',
'ﺪ' => 'د',
'ﺫ' => 'ذ',
'ﺬ' => 'ذ',
'ﺭ' => 'ر',
'ﺮ' => 'ر',
'ﺯ' => 'ز',
'ﺰ' => 'ز',
'ﺱ' => 'س',
'ﺲ' => 'س',
'ﺳ' => 'س',
'ﺴ' => 'س',
'ﺵ' => 'ش',
'ﺶ' => 'ش',
'ﺷ' => 'ش',
'ﺸ' => 'ش',
'ﺹ' => 'ص',
'ﺺ' => 'ص',
'ﺻ' => 'ص',
'ﺼ' => 'ص',
'ﺽ' => 'ض',
'ﺾ' => 'ض',
'ﺿ' => 'ض',
'ﻀ' => 'ض',
'ﻁ' => 'ط',
'ﻂ' => 'ط',
'ﻃ' => 'ط',
'ﻄ' => 'ط',
'ﻅ' => 'ظ',
'ﻆ' => 'ظ',
'ﻇ' => 'ظ',
'ﻈ' => 'ظ',
'ﻉ' => 'ع',
'ﻊ' => 'ع',
'ﻋ' => 'ع',
'ﻌ' => 'ع',
'ﻍ' => 'غ',
'ﻎ' => 'غ',
'ﻏ' => 'غ',
'ﻐ' => 'غ',
'ﻑ' => 'ف',
'ﻒ' => 'ف',
'ﻓ' => 'ف',
'ﻔ' => 'ف',
'ﻕ' => 'ق',
'ﻖ' => 'ق',
'ﻗ' => 'ق',
'ﻘ' => 'ق',
'ﻙ' => 'ك',
'ﻚ' => 'ك',
'ﻛ' => 'ك',
'ﻜ' => 'ك',
'ﻝ' => 'ل',
'ﻞ' => 'ل',
'ﻟ' => 'ل',
'ﻠ' => 'ل',
'ﻡ' => 'م',
'ﻢ' => 'م',
'ﻣ' => 'م',
'ﻤ' => 'م',
'ﻥ' => 'ن',
'ﻦ' => 'ن',
'ﻧ' => 'ن',
'ﻨ' => 'ن',
'ﻩ' => 'ه',
'ﻪ' => 'ه',
'ﻫ' => 'ه',
'ﻬ' => 'ه',
'ﻭ' => 'و',
'ﻮ' => 'و',
'ﻯ' => 'ى',
'ﻰ' => 'ى',
'ﻱ' => 'ي',
'ﻲ' => 'ي',
'ﻳ' => 'ي',
'ﻴ' => 'ي',
'ﻵ' => 'لآ',
'ﻶ' => 'لآ',
'ﻷ' => 'لأ',
'ﻸ' => 'لأ',
'ﻹ' => 'لإ',
'ﻺ' => 'لإ',
'ﻻ' => 'لا',
'ﻼ' => 'لا',
'！' => '!',
'＂' => '"',
'＃' => '#',
'＄' => '$',
'％' => '%',
'＆' => '&',
'＇' => '\'',
'（' => '(',
'）' => ')',
'＊' => '*',
'＋' => '+',
'，' => ',',
'－' => '-',
'．' => '.',
'／' => '/',
'０' => '0',
'１' => '1',
'２' => '2',
'３' => '3',
'４' => '4',
'５' => '5',
'６' => '6',
'７' => '7',
'８' => '8',
'９' => '9',
'：' => ':',
'；' => ';',
'＜' => '<',
'＝' => '=',
'＞' => '>',
'？' => '?',
'＠' => '@',
'Ａ' => 'A',
'Ｂ' => 'B',
'Ｃ' => 'C',
'Ｄ' => 'D',
'Ｅ' => 'E',
'Ｆ' => 'F',
'Ｇ' => 'G',
'Ｈ' => 'H',
'Ｉ' => 'I',
'Ｊ' => 'J',
'Ｋ' => 'K',
'Ｌ' => 'L',
'Ｍ' => 'M',
'Ｎ' => 'N',
'Ｏ' => 'O',
'Ｐ' => 'P',
'Ｑ' => 'Q',
'Ｒ' => 'R',
'Ｓ' => 'S',
'Ｔ' => 'T',
'Ｕ' => 'U',
'Ｖ' => 'V',
'Ｗ' => 'W',
'Ｘ' => 'X',
'Ｙ' => 'Y',
'Ｚ' => 'Z',
'［' => '[',
'＼' => '\\',
'］' => ']',
'＾' => '^',
'＿' => '_',
'｀' => '`',
'ａ' => 'a',
'ｂ' => 'b',
'ｃ' => 'c',
'ｄ' => 'd',
'ｅ' => 'e',
'ｆ' => 'f',
'ｇ' => 'g',
'ｈ' => 'h',
'ｉ' => 'i',
'ｊ' => 'j',
'ｋ' => 'k',
'ｌ' => 'l',
'ｍ' => 'm',
'ｎ' => 'n',
'ｏ' => 'o',
'ｐ' => 'p',
'ｑ' => 'q',
'ｒ' => 'r',
'ｓ' => 's',
'ｔ' => 't',
'ｕ' => 'u',
'ｖ' => 'v',
'ｗ' => 'w',
'ｘ' => 'x',
'ｙ' => 'y',
'ｚ' => 'z',
'｛' => '{',
'｜' => '|',
'｝' => '}',
'～' => '~',
'｟' => '⦅',
'｠' => '⦆',
'｡' => '。',
'｢' => '「',
'｣' => '」',
'､' => '、',
'･' => '・',
'ｦ' => 'ヲ',
'ｧ' => 'ァ',
'ｨ' => 'ィ',
'ｩ' => 'ゥ',
'ｪ' => 'ェ',
'ｫ' => 'ォ',
'ｬ' => 'ャ',
'ｭ' => 'ュ',
'ｮ' => 'ョ',
'ｯ' => 'ッ',
'ｰ' => 'ー',
'ｱ' => 'ア',
'ｲ' => 'イ',
'ｳ' => 'ウ',
'ｴ' => 'エ',
'ｵ' => 'オ',
'ｶ' => 'カ',
'ｷ' => 'キ',
'ｸ' => 'ク',
'ｹ' => 'ケ',
'ｺ' => 'コ',
'ｻ' => 'サ',
'ｼ' => 'シ',
'ｽ' => 'ス',
'ｾ' => 'セ',
'ｿ' => 'ソ',
'ﾀ' => 'タ',
'ﾁ' => 'チ',
'ﾂ' => 'ツ',
'ﾃ' => 'テ',
'ﾄ' => 'ト',
'ﾅ' => 'ナ',
'ﾆ' => 'ニ',
'ﾇ' => 'ヌ',
'ﾈ' => 'ネ',
'ﾉ' => 'ノ',
'ﾊ' => 'ハ',
'ﾋ' => 'ヒ',
'ﾌ' => 'フ',
'ﾍ' => 'ヘ',
'ﾎ' => 'ホ',
'ﾏ' => 'マ',
'ﾐ' => 'ミ',
'ﾑ' => 'ム',
'ﾒ' => 'メ',
'ﾓ' => 'モ',
'ﾔ' => 'ヤ',
'ﾕ' => 'ユ',
'ﾖ' => 'ヨ',
'ﾗ' => 'ラ',
'ﾘ' => 'リ',
'ﾙ' => 'ル',
'ﾚ' => 'レ',
'ﾛ' => 'ロ',
'ﾜ' => 'ワ',
'ﾝ' => 'ン',
'ﾞ' => '゙',
'ﾟ' => '゚',
'ﾠ' => 'ᅠ',
'ﾡ' => 'ᄀ',
'ﾢ' => 'ᄁ',
'ﾣ' => 'ᆪ',
'ﾤ' => 'ᄂ',
'ﾥ' => 'ᆬ',
'ﾦ' => 'ᆭ',
'ﾧ' => 'ᄃ',
'ﾨ' => 'ᄄ',
'ﾩ' => 'ᄅ',
'ﾪ' => 'ᆰ',
'ﾫ' => 'ᆱ',
'ﾬ' => 'ᆲ',
'ﾭ' => 'ᆳ',
'ﾮ' => 'ᆴ',
'ﾯ' => 'ᆵ',
'ﾰ' => 'ᄚ',
'ﾱ' => 'ᄆ',
'ﾲ' => 'ᄇ',
'ﾳ' => 'ᄈ',
'ﾴ' => 'ᄡ',
'ﾵ' => 'ᄉ',
'ﾶ' => 'ᄊ',
'ﾷ' => 'ᄋ',
'ﾸ' => 'ᄌ',
'ﾹ' => 'ᄍ',
'ﾺ' => 'ᄎ',
'ﾻ' => 'ᄏ',
'ﾼ' => 'ᄐ',
'ﾽ' => 'ᄑ',
'ﾾ' => 'ᄒ',
'ￂ' => 'ᅡ',
'ￃ' => 'ᅢ',
'ￄ' => 'ᅣ',
'ￅ' => 'ᅤ',
'ￆ' => 'ᅥ',
'ￇ' => 'ᅦ',
'ￊ' => 'ᅧ',
'ￋ' => 'ᅨ',
'ￌ' => 'ᅩ',
'ￍ' => 'ᅪ',
'ￎ' => 'ᅫ',
'ￏ' => 'ᅬ',
'ￒ' => 'ᅭ',
'ￓ' => 'ᅮ',
'ￔ' => 'ᅯ',
'ￕ' => 'ᅰ',
'ￖ' => 'ᅱ',
'ￗ' => 'ᅲ',
'ￚ' => 'ᅳ',
'ￛ' => 'ᅴ',
'ￜ' => 'ᅵ',
'￠' => '¢',
'￡' => '£',
'￢' => '¬',
'￣' => ' ̄',
'￤' => '¦',
'￥' => '¥',
'￦' => '₩',
'￨' => '│',
'￩' => '←',
'￪' => '↑',
'￫' => '→',
'￬' => '↓',
'￭' => '■',
'￮' => '○',
'𝐀' => 'A',
'𝐁' => 'B',
'𝐂' => 'C',
'𝐃' => 'D',
'𝐄' => 'E',
'𝐅' => 'F',
'𝐆' => 'G',
'𝐇' => 'H',
'𝐈' => 'I',
'𝐉' => 'J',
'𝐊' => 'K',
'𝐋' => 'L',
'𝐌' => 'M',
'𝐍' => 'N',
'𝐎' => 'O',
'𝐏' => 'P',
'𝐐' => 'Q',
'𝐑' => 'R',
'𝐒' => 'S',
'𝐓' => 'T',
'𝐔' => 'U',
'𝐕' => 'V',
'𝐖' => 'W',
'𝐗' => 'X',
'𝐘' => 'Y',
'𝐙' => 'Z',
'𝐚' => 'a',
'𝐛' => 'b',
'𝐜' => 'c',
'𝐝' => 'd',
'𝐞' => 'e',
'𝐟' => 'f',
'𝐠' => 'g',
'𝐡' => 'h',
'𝐢' => 'i',
'𝐣' => 'j',
'𝐤' => 'k',
'𝐥' => 'l',
'𝐦' => 'm',
'𝐧' => 'n',
'𝐨' => 'o',
'𝐩' => 'p',
'𝐪' => 'q',
'𝐫' => 'r',
'𝐬' => 's',
'𝐭' => 't',
'𝐮' => 'u',
'𝐯' => 'v',
'𝐰' => 'w',
'𝐱' => 'x',
'𝐲' => 'y',
'𝐳' => 'z',
'𝐴' => 'A',
'𝐵' => 'B',
'𝐶' => 'C',
'𝐷' => 'D',
'𝐸' => 'E',
'𝐹' => 'F',
'𝐺' => 'G',
'𝐻' => 'H',
'𝐼' => 'I',
'𝐽' => 'J',
'𝐾' => 'K',
'𝐿' => 'L',
'𝑀' => 'M',
'𝑁' => 'N',
'𝑂' => 'O',
'𝑃' => 'P',
'𝑄' => 'Q',
'𝑅' => 'R',
'𝑆' => 'S',
'𝑇' => 'T',
'𝑈' => 'U',
'𝑉' => 'V',
'𝑊' => 'W',
'𝑋' => 'X',
'𝑌' => 'Y',
'𝑍' => 'Z',
'𝑎' => 'a',
'𝑏' => 'b',
'𝑐' => 'c',
'𝑑' => 'd',
'𝑒' => 'e',
'𝑓' => 'f',
'𝑔' => 'g',
'𝑖' => 'i',
'𝑗' => 'j',
'𝑘' => 'k',
'𝑙' => 'l',
'𝑚' => 'm',
'𝑛' => 'n',
'𝑜' => 'o',
'𝑝' => 'p',
'𝑞' => 'q',
'𝑟' => 'r',
'𝑠' => 's',
'𝑡' => 't',
'𝑢' => 'u',
'𝑣' => 'v',
'𝑤' => 'w',
'𝑥' => 'x',
'𝑦' => 'y',
'𝑧' => 'z',
'𝑨' => 'A',
'𝑩' => 'B',
'𝑪' => 'C',
'𝑫' => 'D',
'𝑬' => 'E',
'𝑭' => 'F',
'𝑮' => 'G',
'𝑯' => 'H',
'𝑰' => 'I',
'𝑱' => 'J',
'𝑲' => 'K',
'𝑳' => 'L',
'𝑴' => 'M',
'𝑵' => 'N',
'𝑶' => 'O',
'𝑷' => 'P',
'𝑸' => 'Q',
'𝑹' => 'R',
'𝑺' => 'S',
'𝑻' => 'T',
'𝑼' => 'U',
'𝑽' => 'V',
'𝑾' => 'W',
'𝑿' => 'X',
'𝒀' => 'Y',
'𝒁' => 'Z',
'𝒂' => 'a',
'𝒃' => 'b',
'𝒄' => 'c',
'𝒅' => 'd',
'𝒆' => 'e',
'𝒇' => 'f',
'𝒈' => 'g',
'𝒉' => 'h',
'𝒊' => 'i',
'𝒋' => 'j',
'𝒌' => 'k',
'𝒍' => 'l',
'𝒎' => 'm',
'𝒏' => 'n',
'𝒐' => 'o',
'𝒑' => 'p',
'𝒒' => 'q',
'𝒓' => 'r',
'𝒔' => 's',
'𝒕' => 't',
'𝒖' => 'u',
'𝒗' => 'v',
'𝒘' => 'w',
'𝒙' => 'x',
'𝒚' => 'y',
'𝒛' => 'z',
'𝒜' => 'A',
'𝒞' => 'C',
'𝒟' => 'D',
'𝒢' => 'G',
'𝒥' => 'J',
'𝒦' => 'K',
'𝒩' => 'N',
'𝒪' => 'O',
'𝒫' => 'P',
'𝒬' => 'Q',
'𝒮' => 'S',
'𝒯' => 'T',
'𝒰' => 'U',
'𝒱' => 'V',
'𝒲' => 'W',
'𝒳' => 'X',
'𝒴' => 'Y',
'𝒵' => 'Z',
'𝒶' => 'a',
'𝒷' => 'b',
'𝒸' => 'c',
'𝒹' => 'd',
'𝒻' => 'f',
'𝒽' => 'h',
'𝒾' => 'i',
'𝒿' => 'j',
'𝓀' => 'k',
'𝓁' => 'l',
'𝓂' => 'm',
'𝓃' => 'n',
'𝓅' => 'p',
'𝓆' => 'q',
'𝓇' => 'r',
'𝓈' => 's',
'𝓉' => 't',
'𝓊' => 'u',
'𝓋' => 'v',
'𝓌' => 'w',
'𝓍' => 'x',
'𝓎' => 'y',
'𝓏' => 'z',
'𝓐' => 'A',
'𝓑' => 'B',
'𝓒' => 'C',
'𝓓' => 'D',
'𝓔' => 'E',
'𝓕' => 'F',
'𝓖' => 'G',
'𝓗' => 'H',
'𝓘' => 'I',
'𝓙' => 'J',
'𝓚' => 'K',
'𝓛' => 'L',
'𝓜' => 'M',
'𝓝' => 'N',
'𝓞' => 'O',
'𝓟' => 'P',
'𝓠' => 'Q',
'𝓡' => 'R',
'𝓢' => 'S',
'𝓣' => 'T',
'𝓤' => 'U',
'𝓥' => 'V',
'𝓦' => 'W',
'𝓧' => 'X',
'𝓨' => 'Y',
'𝓩' => 'Z',
'𝓪' => 'a',
'𝓫' => 'b',
'𝓬' => 'c',
'𝓭' => 'd',
'𝓮' => 'e',
'𝓯' => 'f',
'𝓰' => 'g',
'𝓱' => 'h',
'𝓲' => 'i',
'𝓳' => 'j',
'𝓴' => 'k',
'𝓵' => 'l',
'𝓶' => 'm',
'𝓷' => 'n',
'𝓸' => 'o',
'𝓹' => 'p',
'𝓺' => 'q',
'𝓻' => 'r',
'𝓼' => 's',
'𝓽' => 't',
'𝓾' => 'u',
'𝓿' => 'v',
'𝔀' => 'w',
'𝔁' => 'x',
'𝔂' => 'y',
'𝔃' => 'z',
'𝔄' => 'A',
'𝔅' => 'B',
'𝔇' => 'D',
'𝔈' => 'E',
'𝔉' => 'F',
'𝔊' => 'G',
'𝔍' => 'J',
'𝔎' => 'K',
'𝔏' => 'L',
'𝔐' => 'M',
'𝔑' => 'N',
'𝔒' => 'O',
'𝔓' => 'P',
'𝔔' => 'Q',
'𝔖' => 'S',
'𝔗' => 'T',
'𝔘' => 'U',
'𝔙' => 'V',
'𝔚' => 'W',
'𝔛' => 'X',
'𝔜' => 'Y',
'𝔞' => 'a',
'𝔟' => 'b',
'𝔠' => 'c',
'𝔡' => 'd',
'𝔢' => 'e',
'𝔣' => 'f',
'𝔤' => 'g',
'𝔥' => 'h',
'𝔦' => 'i',
'𝔧' => 'j',
'𝔨' => 'k',
'𝔩' => 'l',
'𝔪' => 'm',
'𝔫' => 'n',
'𝔬' => 'o',
'𝔭' => 'p',
'𝔮' => 'q',
'𝔯' => 'r',
'𝔰' => 's',
'𝔱' => 't',
'𝔲' => 'u',
'𝔳' => 'v',
'𝔴' => 'w',
'𝔵' => 'x',
'𝔶' => 'y',
'𝔷' => 'z',
'𝔸' => 'A',
'𝔹' => 'B',
'𝔻' => 'D',
'𝔼' => 'E',
'𝔽' => 'F',
'𝔾' => 'G',
'𝕀' => 'I',
'𝕁' => 'J',
'𝕂' => 'K',
'𝕃' => 'L',
'𝕄' => 'M',
'𝕆' => 'O',
'𝕊' => 'S',
'𝕋' => 'T',
'𝕌' => 'U',
'𝕍' => 'V',
'𝕎' => 'W',
'𝕏' => 'X',
'𝕐' => 'Y',
'𝕒' => 'a',
'𝕓' => 'b',
'𝕔' => 'c',
'𝕕' => 'd',
'𝕖' => 'e',
'𝕗' => 'f',
'𝕘' => 'g',
'𝕙' => 'h',
'𝕚' => 'i',
'𝕛' => 'j',
'𝕜' => 'k',
'𝕝' => 'l',
'𝕞' => 'm',
'𝕟' => 'n',
'𝕠' => 'o',
'𝕡' => 'p',
'𝕢' => 'q',
'𝕣' => 'r',
'𝕤' => 's',
'𝕥' => 't',
'𝕦' => 'u',
'𝕧' => 'v',
'𝕨' => 'w',
'𝕩' => 'x',
'𝕪' => 'y',
'𝕫' => 'z',
'𝕬' => 'A',
'𝕭' => 'B',
'𝕮' => 'C',
'𝕯' => 'D',
'𝕰' => 'E',
'𝕱' => 'F',
'𝕲' => 'G',
'𝕳' => 'H',
'𝕴' => 'I',
'𝕵' => 'J',
'𝕶' => 'K',
'𝕷' => 'L',
'𝕸' => 'M',
'𝕹' => 'N',
'𝕺' => 'O',
'𝕻' => 'P',
'𝕼' => 'Q',
'𝕽' => 'R',
'𝕾' => 'S',
'𝕿' => 'T',
'𝖀' => 'U',
'𝖁' => 'V',
'𝖂' => 'W',
'𝖃' => 'X',
'𝖄' => 'Y',
'𝖅' => 'Z',
'𝖆' => 'a',
'𝖇' => 'b',
'𝖈' => 'c',
'𝖉' => 'd',
'𝖊' => 'e',
'𝖋' => 'f',
'𝖌' => 'g',
'𝖍' => 'h',
'𝖎' => 'i',
'𝖏' => 'j',
'𝖐' => 'k',
'𝖑' => 'l',
'𝖒' => 'm',
'𝖓' => 'n',
'𝖔' => 'o',
'𝖕' => 'p',
'𝖖' => 'q',
'𝖗' => 'r',
'𝖘' => 's',
'𝖙' => 't',
'𝖚' => 'u',
'𝖛' => 'v',
'𝖜' => 'w',
'𝖝' => 'x',
'𝖞' => 'y',
'𝖟' => 'z',
'𝖠' => 'A',
'𝖡' => 'B',
'𝖢' => 'C',
'𝖣' => 'D',
'𝖤' => 'E',
'𝖥' => 'F',
'𝖦' => 'G',
'𝖧' => 'H',
'𝖨' => 'I',
'𝖩' => 'J',
'𝖪' => 'K',
'𝖫' => 'L',
'𝖬' => 'M',
'𝖭' => 'N',
'𝖮' => 'O',
'𝖯' => 'P',
'𝖰' => 'Q',
'𝖱' => 'R',
'𝖲' => 'S',
'𝖳' => 'T',
'𝖴' => 'U',
'𝖵' => 'V',
'𝖶' => 'W',
'𝖷' => 'X',
'𝖸' => 'Y',
'𝖹' => 'Z',
'𝖺' => 'a',
'𝖻' => 'b',
'𝖼' => 'c',
'𝖽' => 'd',
'𝖾' => 'e',
'𝖿' => 'f',
'𝗀' => 'g',
'𝗁' => 'h',
'𝗂' => 'i',
'𝗃' => 'j',
'𝗄' => 'k',
'𝗅' => 'l',
'𝗆' => 'm',
'𝗇' => 'n',
'𝗈' => 'o',
'𝗉' => 'p',
'𝗊' => 'q',
'𝗋' => 'r',
'𝗌' => 's',
'𝗍' => 't',
'𝗎' => 'u',
'𝗏' => 'v',
'𝗐' => 'w',
'𝗑' => 'x',
'𝗒' => 'y',
'𝗓' => 'z',
'𝗔' => 'A',
'𝗕' => 'B',
'𝗖' => 'C',
'𝗗' => 'D',
'𝗘' => 'E',
'𝗙' => 'F',
'𝗚' => 'G',
'𝗛' => 'H',
'𝗜' => 'I',
'𝗝' => 'J',
'𝗞' => 'K',
'𝗟' => 'L',
'𝗠' => 'M',
'𝗡' => 'N',
'𝗢' => 'O',
'𝗣' => 'P',
'𝗤' => 'Q',
'𝗥' => 'R',
'𝗦' => 'S',
'𝗧' => 'T',
'𝗨' => 'U',
'𝗩' => 'V',
'𝗪' => 'W',
'𝗫' => 'X',
'𝗬' => 'Y',
'𝗭' => 'Z',
'𝗮' => 'a',
'𝗯' => 'b',
'𝗰' => 'c',
'𝗱' => 'd',
'𝗲' => 'e',
'𝗳' => 'f',
'𝗴' => 'g',
'𝗵' => 'h',
'𝗶' => 'i',
'𝗷' => 'j',
'𝗸' => 'k',
'𝗹' => 'l',
'𝗺' => 'm',
'𝗻' => 'n',
'𝗼' => 'o',
'𝗽' => 'p',
'𝗾' => 'q',
'𝗿' => 'r',
'𝘀' => 's',
'𝘁' => 't',
'𝘂' => 'u',
'𝘃' => 'v',
'𝘄' => 'w',
'𝘅' => 'x',
'𝘆' => 'y',
'𝘇' => 'z',
'𝘈' => 'A',
'𝘉' => 'B',
'𝘊' => 'C',
'𝘋' => 'D',
'𝘌' => 'E',
'𝘍' => 'F',
'𝘎' => 'G',
'𝘏' => 'H',
'𝘐' => 'I',
'𝘑' => 'J',
'𝘒' => 'K',
'𝘓' => 'L',
'𝘔' => 'M',
'𝘕' => 'N',
'𝘖' => 'O',
'𝘗' => 'P',
'𝘘' => 'Q',
'𝘙' => 'R',
'𝘚' => 'S',
'𝘛' => 'T',
'𝘜' => 'U',
'𝘝' => 'V',
'𝘞' => 'W',
'𝘟' => 'X',
'𝘠' => 'Y',
'𝘡' => 'Z',
'𝘢' => 'a',
'𝘣' => 'b',
'𝘤' => 'c',
'𝘥' => 'd',
'𝘦' => 'e',
'𝘧' => 'f',
'𝘨' => 'g',
'𝘩' => 'h',
'𝘪' => 'i',
'𝘫' => 'j',
'𝘬' => 'k',
'𝘭' => 'l',
'𝘮' => 'm',
'𝘯' => 'n',
'𝘰' => 'o',
'𝘱' => 'p',
'𝘲' => 'q',
'𝘳' => 'r',
'𝘴' => 's',
'𝘵' => 't',
'𝘶' => 'u',
'𝘷' => 'v',
'𝘸' => 'w',
'𝘹' => 'x',
'𝘺' => 'y',
'𝘻' => 'z',
'𝘼' => 'A',
'𝘽' => 'B',
'𝘾' => 'C',
'𝘿' => 'D',
'𝙀' => 'E',
'𝙁' => 'F',
'𝙂' => 'G',
'𝙃' => 'H',
'𝙄' => 'I',
'𝙅' => 'J',
'𝙆' => 'K',
'𝙇' => 'L',
'𝙈' => 'M',
'𝙉' => 'N',
'𝙊' => 'O',
'𝙋' => 'P',
'𝙌' => 'Q',
'𝙍' => 'R',
'𝙎' => 'S',
'𝙏' => 'T',
'𝙐' => 'U',
'𝙑' => 'V',
'𝙒' => 'W',
'𝙓' => 'X',
'𝙔' => 'Y',
'𝙕' => 'Z',
'𝙖' => 'a',
'𝙗' => 'b',
'𝙘' => 'c',
'𝙙' => 'd',
'𝙚' => 'e',
'𝙛' => 'f',
'𝙜' => 'g',
'𝙝' => 'h',
'𝙞' => 'i',
'𝙟' => 'j',
'𝙠' => 'k',
'𝙡' => 'l',
'𝙢' => 'm',
'𝙣' => 'n',
'𝙤' => 'o',
'𝙥' => 'p',
'𝙦' => 'q',
'𝙧' => 'r',
'𝙨' => 's',
'𝙩' => 't',
'𝙪' => 'u',
'𝙫' => 'v',
'𝙬' => 'w',
'𝙭' => 'x',
'𝙮' => 'y',
'𝙯' => 'z',
'𝙰' => 'A',
'𝙱' => 'B',
'𝙲' => 'C',
'𝙳' => 'D',
'𝙴' => 'E',
'𝙵' => 'F',
'𝙶' => 'G',
'𝙷' => 'H',
'𝙸' => 'I',
'𝙹' => 'J',
'𝙺' => 'K',
'𝙻' => 'L',
'𝙼' => 'M',
'𝙽' => 'N',
'𝙾' => 'O',
'𝙿' => 'P',
'𝚀' => 'Q',
'𝚁' => 'R',
'𝚂' => 'S',
'𝚃' => 'T',
'𝚄' => 'U',
'𝚅' => 'V',
'𝚆' => 'W',
'𝚇' => 'X',
'𝚈' => 'Y',
'𝚉' => 'Z',
'𝚊' => 'a',
'𝚋' => 'b',
'𝚌' => 'c',
'𝚍' => 'd',
'𝚎' => 'e',
'𝚏' => 'f',
'𝚐' => 'g',
'𝚑' => 'h',
'𝚒' => 'i',
'𝚓' => 'j',
'𝚔' => 'k',
'𝚕' => 'l',
'𝚖' => 'm',
'𝚗' => 'n',
'𝚘' => 'o',
'𝚙' => 'p',
'𝚚' => 'q',
'𝚛' => 'r',
'𝚜' => 's',
'𝚝' => 't',
'𝚞' => 'u',
'𝚟' => 'v',
'𝚠' => 'w',
'𝚡' => 'x',
'𝚢' => 'y',
'𝚣' => 'z',
'𝚤' => 'ı',
'𝚥' => 'ȷ',
'𝚨' => 'Α',
'𝚩' => 'Β',
'𝚪' => 'Γ',
'𝚫' => 'Δ',
'𝚬' => 'Ε',
'𝚭' => 'Ζ',
'𝚮' => 'Η',
'𝚯' => 'Θ',
'𝚰' => 'Ι',
'𝚱' => 'Κ',
'𝚲' => 'Λ',
'𝚳' => 'Μ',
'𝚴' => 'Ν',
'𝚵' => 'Ξ',
'𝚶' => 'Ο',
'𝚷' => 'Π',
'𝚸' => 'Ρ',
'𝚹' => 'Θ',
'𝚺' => 'Σ',
'𝚻' => 'Τ',
'𝚼' => 'Υ',
'𝚽' => 'Φ',
'𝚾' => 'Χ',
'𝚿' => 'Ψ',
'𝛀' => 'Ω',
'𝛁' => '∇',
'𝛂' => 'α',
'𝛃' => 'β',
'𝛄' => 'γ',
'𝛅' => 'δ',
'𝛆' => 'ε',
'𝛇' => 'ζ',
'𝛈' => 'η',
'𝛉' => 'θ',
'𝛊' => 'ι',
'𝛋' => 'κ',
'𝛌' => 'λ',
'𝛍' => 'μ',
'𝛎' => 'ν',
'𝛏' => 'ξ',
'𝛐' => 'ο',
'𝛑' => 'π',
'𝛒' => 'ρ',
'𝛓' => 'ς',
'𝛔' => 'σ',
'𝛕' => 'τ',
'𝛖' => 'υ',
'𝛗' => 'φ',
'𝛘' => 'χ',
'𝛙' => 'ψ',
'𝛚' => 'ω',
'𝛛' => '∂',
'𝛜' => 'ε',
'𝛝' => 'θ',
'𝛞' => 'κ',
'𝛟' => 'φ',
'𝛠' => 'ρ',
'𝛡' => 'π',
'𝛢' => 'Α',
'𝛣' => 'Β',
'𝛤' => 'Γ',
'𝛥' => 'Δ',
'𝛦' => 'Ε',
'𝛧' => 'Ζ',
'𝛨' => 'Η',
'𝛩' => 'Θ',
'𝛪' => 'Ι',
'𝛫' => 'Κ',
'𝛬' => 'Λ',
'𝛭' => 'Μ',
'𝛮' => 'Ν',
'𝛯' => 'Ξ',
'𝛰' => 'Ο',
'𝛱' => 'Π',
'𝛲' => 'Ρ',
'𝛳' => 'Θ',
'𝛴' => 'Σ',
'𝛵' => 'Τ',
'𝛶' => 'Υ',
'𝛷' => 'Φ',
'𝛸' => 'Χ',
'𝛹' => 'Ψ',
'𝛺' => 'Ω',
'𝛻' => '∇',
'𝛼' => 'α',
'𝛽' => 'β',
'𝛾' => 'γ',
'𝛿' => 'δ',
'𝜀' => 'ε',
'𝜁' => 'ζ',
'𝜂' => 'η',
'𝜃' => 'θ',
'𝜄' => 'ι',
'𝜅' => 'κ',
'𝜆' => 'λ',
'𝜇' => 'μ',
'𝜈' => 'ν',
'𝜉' => 'ξ',
'𝜊' => 'ο',
'𝜋' => 'π',
'𝜌' => 'ρ',
'𝜍' => 'ς',
'𝜎' => 'σ',
'𝜏' => 'τ',
'𝜐' => 'υ',
'𝜑' => 'φ',
'𝜒' => 'χ',
'𝜓' => 'ψ',
'𝜔' => 'ω',
'𝜕' => '∂',
'𝜖' => 'ε',
'𝜗' => 'θ',
'𝜘' => 'κ',
'𝜙' => 'φ',
'𝜚' => 'ρ',
'𝜛' => 'π',
'𝜜' => 'Α',
'𝜝' => 'Β',
'𝜞' => 'Γ',
'𝜟' => 'Δ',
'𝜠' => 'Ε',
'𝜡' => 'Ζ',
'𝜢' => 'Η',
'𝜣' => 'Θ',
'𝜤' => 'Ι',
'𝜥' => 'Κ',
'𝜦' => 'Λ',
'𝜧' => 'Μ',
'𝜨' => 'Ν',
'𝜩' => 'Ξ',
'𝜪' => 'Ο',
'𝜫' => 'Π',
'𝜬' => 'Ρ',
'𝜭' => 'Θ',
'𝜮' => 'Σ',
'𝜯' => 'Τ',
'𝜰' => 'Υ',
'𝜱' => 'Φ',
'𝜲' => 'Χ',
'𝜳' => 'Ψ',
'𝜴' => 'Ω',
'𝜵' => '∇',
'𝜶' => 'α',
'𝜷' => 'β',
'𝜸' => 'γ',
'𝜹' => 'δ',
'𝜺' => 'ε',
'𝜻' => 'ζ',
'𝜼' => 'η',
'𝜽' => 'θ',
'𝜾' => 'ι',
'𝜿' => 'κ',
'𝝀' => 'λ',
'𝝁' => 'μ',
'𝝂' => 'ν',
'𝝃' => 'ξ',
'𝝄' => 'ο',
'𝝅' => 'π',
'𝝆' => 'ρ',
'𝝇' => 'ς',
'𝝈' => 'σ',
'𝝉' => 'τ',
'𝝊' => 'υ',
'𝝋' => 'φ',
'𝝌' => 'χ',
'𝝍' => 'ψ',
'𝝎' => 'ω',
'𝝏' => '∂',
'𝝐' => 'ε',
'𝝑' => 'θ',
'𝝒' => 'κ',
'𝝓' => 'φ',
'𝝔' => 'ρ',
'𝝕' => 'π',
'𝝖' => 'Α',
'𝝗' => 'Β',
'𝝘' => 'Γ',
'𝝙' => 'Δ',
'𝝚' => 'Ε',
'𝝛' => 'Ζ',
'𝝜' => 'Η',
'𝝝' => 'Θ',
'𝝞' => 'Ι',
'𝝟' => 'Κ',
'𝝠' => 'Λ',
'𝝡' => 'Μ',
'𝝢' => 'Ν',
'𝝣' => 'Ξ',
'𝝤' => 'Ο',
'𝝥' => 'Π',
'𝝦' => 'Ρ',
'𝝧' => 'Θ',
'𝝨' => 'Σ',
'𝝩' => 'Τ',
'𝝪' => 'Υ',
'𝝫' => 'Φ',
'𝝬' => 'Χ',
'𝝭' => 'Ψ',
'𝝮' => 'Ω',
'𝝯' => '∇',
'𝝰' => 'α',
'𝝱' => 'β',
'𝝲' => 'γ',
'𝝳' => 'δ',
'𝝴' => 'ε',
'𝝵' => 'ζ',
'𝝶' => 'η',
'𝝷' => 'θ',
'𝝸' => 'ι',
'𝝹' => 'κ',
'𝝺' => 'λ',
'𝝻' => 'μ',
'𝝼' => 'ν',
'𝝽' => 'ξ',
'𝝾' => 'ο',
'𝝿' => 'π',
'𝞀' => 'ρ',
'𝞁' => 'ς',
'𝞂' => 'σ',
'𝞃' => 'τ',
'𝞄' => 'υ',
'𝞅' => 'φ',
'𝞆' => 'χ',
'𝞇' => 'ψ',
'𝞈' => 'ω',
'𝞉' => '∂',
'𝞊' => 'ε',
'𝞋' => 'θ',
'𝞌' => 'κ',
'𝞍' => 'φ',
'𝞎' => 'ρ',
'𝞏' => 'π',
'𝞐' => 'Α',
'𝞑' => 'Β',
'𝞒' => 'Γ',
'𝞓' => 'Δ',
'𝞔' => 'Ε',
'𝞕' => 'Ζ',
'𝞖' => 'Η',
'𝞗' => 'Θ',
'𝞘' => 'Ι',
'𝞙' => 'Κ',
'𝞚' => 'Λ',
'𝞛' => 'Μ',
'𝞜' => 'Ν',
'𝞝' => 'Ξ',
'𝞞' => 'Ο',
'𝞟' => 'Π',
'𝞠' => 'Ρ',
'𝞡' => 'Θ',
'𝞢' => 'Σ',
'𝞣' => 'Τ',
'𝞤' => 'Υ',
'𝞥' => 'Φ',
'𝞦' => 'Χ',
'𝞧' => 'Ψ',
'𝞨' => 'Ω',
'𝞩' => '∇',
'𝞪' => 'α',
'𝞫' => 'β',
'𝞬' => 'γ',
'𝞭' => 'δ',
'𝞮' => 'ε',
'𝞯' => 'ζ',
'𝞰' => 'η',
'𝞱' => 'θ',
'𝞲' => 'ι',
'𝞳' => 'κ',
'𝞴' => 'λ',
'𝞵' => 'μ',
'𝞶' => 'ν',
'𝞷' => 'ξ',
'𝞸' => 'ο',
'𝞹' => 'π',
'𝞺' => 'ρ',
'𝞻' => 'ς',
'𝞼' => 'σ',
'𝞽' => 'τ',
'𝞾' => 'υ',
'𝞿' => 'φ',
'𝟀' => 'χ',
'𝟁' => 'ψ',
'𝟂' => 'ω',
'𝟃' => '∂',
'𝟄' => 'ε',
'𝟅' => 'θ',
'𝟆' => 'κ',
'𝟇' => 'φ',
'𝟈' => 'ρ',
'𝟉' => 'π',
'𝟊' => 'Ϝ',
'𝟋' => 'ϝ',
'𝟎' => '0',
'𝟏' => '1',
'𝟐' => '2',
'𝟑' => '3',
'𝟒' => '4',
'𝟓' => '5',
'𝟔' => '6',
'𝟕' => '7',
'𝟖' => '8',
'𝟗' => '9',
'𝟘' => '0',
'𝟙' => '1',
'𝟚' => '2',
'𝟛' => '3',
'𝟜' => '4',
'𝟝' => '5',
'𝟞' => '6',
'𝟟' => '7',
'𝟠' => '8',
'𝟡' => '9',
'𝟢' => '0',
'𝟣' => '1',
'𝟤' => '2',
'𝟥' => '3',
'𝟦' => '4',
'𝟧' => '5',
'𝟨' => '6',
'𝟩' => '7',
'𝟪' => '8',
'𝟫' => '9',
'𝟬' => '0',
'𝟭' => '1',
'𝟮' => '2',
'𝟯' => '3',
'𝟰' => '4',
'𝟱' => '5',
'𝟲' => '6',
'𝟳' => '7',
'𝟴' => '8',
'𝟵' => '9',
'𝟶' => '0',
'𝟷' => '1',
'𝟸' => '2',
'𝟹' => '3',
'𝟺' => '4',
'𝟻' => '5',
'𝟼' => '6',
'𝟽' => '7',
'𝟾' => '8',
'𝟿' => '9',
'𞸀' => 'ا',
'𞸁' => 'ب',
'𞸂' => 'ج',
'𞸃' => 'د',
'𞸅' => 'و',
'𞸆' => 'ز',
'𞸇' => 'ح',
'𞸈' => 'ط',
'𞸉' => 'ي',
'𞸊' => 'ك',
'𞸋' => 'ل',
'𞸌' => 'م',
'𞸍' => 'ن',
'𞸎' => 'س',
'𞸏' => 'ع',
'𞸐' => 'ف',
'𞸑' => 'ص',
'𞸒' => 'ق',
'𞸓' => 'ر',
'𞸔' => 'ش',
'𞸕' => 'ت',
'𞸖' => 'ث',
'𞸗' => 'خ',
'𞸘' => 'ذ',
'𞸙' => 'ض',
'𞸚' => 'ظ',
'𞸛' => 'غ',
'𞸜' => 'ٮ',
'𞸝' => 'ں',
'𞸞' => 'ڡ',
'𞸟' => 'ٯ',
'𞸡' => 'ب',
'𞸢' => 'ج',
'𞸤' => 'ه',
'𞸧' => 'ح',
'𞸩' => 'ي',
'𞸪' => 'ك',
'𞸫' => 'ل',
'𞸬' => 'م',
'𞸭' => 'ن',
'𞸮' => 'س',
'𞸯' => 'ع',
'𞸰' => 'ف',
'𞸱' => 'ص',
'𞸲' => 'ق',
'𞸴' => 'ش',
'𞸵' => 'ت',
'𞸶' => 'ث',
'𞸷' => 'خ',
'𞸹' => 'ض',
'𞸻' => 'غ',
'𞹂' => 'ج',
'𞹇' => 'ح',
'𞹉' => 'ي',
'𞹋' => 'ل',
'𞹍' => 'ن',
'𞹎' => 'س',
'𞹏' => 'ع',
'𞹑' => 'ص',
'𞹒' => 'ق',
'𞹔' => 'ش',
'𞹗' => 'خ',
'𞹙' => 'ض',
'𞹛' => 'غ',
'𞹝' => 'ں',
'𞹟' => 'ٯ',
'𞹡' => 'ب',
'𞹢' => 'ج',
'𞹤' => 'ه',
'𞹧' => 'ح',
'𞹨' => 'ط',
'𞹩' => 'ي',
'𞹪' => 'ك',
'𞹬' => 'م',
'𞹭' => 'ن',
'𞹮' => 'س',
'𞹯' => 'ع',
'𞹰' => 'ف',
'𞹱' => 'ص',
'𞹲' => 'ق',
'𞹴' => 'ش',
'𞹵' => 'ت',
'𞹶' => 'ث',
'𞹷' => 'خ',
'𞹹' => 'ض',
'𞹺' => 'ظ',
'𞹻' => 'غ',
'𞹼' => 'ٮ',
'𞹾' => 'ڡ',
'𞺀' => 'ا',
'𞺁' => 'ب',
'𞺂' => 'ج',
'𞺃' => 'د',
'𞺄' => 'ه',
'𞺅' => 'و',
'𞺆' => 'ز',
'𞺇' => 'ح',
'𞺈' => 'ط',
'𞺉' => 'ي',
'𞺋' => 'ل',
'𞺌' => 'م',
'𞺍' => 'ن',
'𞺎' => 'س',
'𞺏' => 'ع',
'𞺐' => 'ف',
'𞺑' => 'ص',
'𞺒' => 'ق',
'𞺓' => 'ر',
'𞺔' => 'ش',
'𞺕' => 'ت',
'𞺖' => 'ث',
'𞺗' => 'خ',
'𞺘' => 'ذ',
'𞺙' => 'ض',
'𞺚' => 'ظ',
'𞺛' => 'غ',
'𞺡' => 'ب',
'𞺢' => 'ج',
'𞺣' => 'د',
'𞺥' => 'و',
'𞺦' => 'ز',
'𞺧' => 'ح',
'𞺨' => 'ط',
'𞺩' => 'ي',
'𞺫' => 'ل',
'𞺬' => 'م',
'𞺭' => 'ن',
'𞺮' => 'س',
'𞺯' => 'ع',
'𞺰' => 'ف',
'𞺱' => 'ص',
'𞺲' => 'ق',
'𞺳' => 'ر',
'𞺴' => 'ش',
'𞺵' => 'ت',
'𞺶' => 'ث',
'𞺷' => 'خ',
'𞺸' => 'ذ',
'𞺹' => 'ض',
'𞺺' => 'ظ',
'𞺻' => 'غ',
'🄀' => '0.',
'🄁' => '0,',
'🄂' => '1,',
'🄃' => '2,',
'🄄' => '3,',
'🄅' => '4,',
'🄆' => '5,',
'🄇' => '6,',
'🄈' => '7,',
'🄉' => '8,',
'🄊' => '9,',
'🄐' => '(A)',
'🄑' => '(B)',
'🄒' => '(C)',
'🄓' => '(D)',
'🄔' => '(E)',
'🄕' => '(F)',
'🄖' => '(G)',
'🄗' => '(H)',
'🄘' => '(I)',
'🄙' => '(J)',
'🄚' => '(K)',
'🄛' => '(L)',
'🄜' => '(M)',
'🄝' => '(N)',
'🄞' => '(O)',
'🄟' => '(P)',
'🄠' => '(Q)',
'🄡' => '(R)',
'🄢' => '(S)',
'🄣' => '(T)',
'🄤' => '(U)',
'🄥' => '(V)',
'🄦' => '(W)',
'🄧' => '(X)',
'🄨' => '(Y)',
'🄩' => '(Z)',
'🄪' => '〔S〕',
'🄫' => 'C',
'🄬' => 'R',
'🄭' => 'CD',
'🄮' => 'WZ',
'🄰' => 'A',
'🄱' => 'B',
'🄲' => 'C',
'🄳' => 'D',
'🄴' => 'E',
'🄵' => 'F',
'🄶' => 'G',
'🄷' => 'H',
'🄸' => 'I',
'🄹' => 'J',
'🄺' => 'K',
'🄻' => 'L',
'🄼' => 'M',
'🄽' => 'N',
'🄾' => 'O',
'🄿' => 'P',
'🅀' => 'Q',
'🅁' => 'R',
'🅂' => 'S',
'🅃' => 'T',
'🅄' => 'U',
'🅅' => 'V',
'🅆' => 'W',
'🅇' => 'X',
'🅈' => 'Y',
'🅉' => 'Z',
'🅊' => 'HV',
'🅋' => 'MV',
'🅌' => 'SD',
'🅍' => 'SS',
'🅎' => 'PPV',
'🅏' => 'WC',
'🅪' => 'MC',
'🅫' => 'MD',
'🅬' => 'MR',
'🆐' => 'DJ',
'🈀' => 'ほか',
'🈁' => 'ココ',
'🈂' => 'サ',
'🈐' => '手',
'🈑' => '字',
'🈒' => '双',
'🈓' => 'デ',
'🈔' => '二',
'🈕' => '多',
'🈖' => '解',
'🈗' => '天',
'🈘' => '交',
'🈙' => '映',
'🈚' => '無',
'🈛' => '料',
'🈜' => '前',
'🈝' => '後',
'🈞' => '再',
'🈟' => '新',
'🈠' => '初',
'🈡' => '終',
'🈢' => '生',
'🈣' => '販',
'🈤' => '声',
'🈥' => '吹',
'🈦' => '演',
'🈧' => '投',
'🈨' => '捕',
'🈩' => '一',
'🈪' => '三',
'🈫' => '遊',
'🈬' => '左',
'🈭' => '中',
'🈮' => '右',
'🈯' => '指',
'🈰' => '走',
'🈱' => '打',
'🈲' => '禁',
'🈳' => '空',
'🈴' => '合',
'🈵' => '満',
'🈶' => '有',
'🈷' => '月',
'🈸' => '申',
'🈹' => '割',
'🈺' => '営',
'🈻' => '配',
'🉀' => '〔本〕',
'🉁' => '〔三〕',
'🉂' => '〔二〕',
'🉃' => '〔安〕',
'🉄' => '〔点〕',
'🉅' => '〔打〕',
'🉆' => '〔盗〕',
'🉇' => '〔勝〕',
'🉈' => '〔敗〕',
'🉐' => '得',
'🉑' => '可',
'🯰' => '0',
'🯱' => '1',
'🯲' => '2',
'🯳' => '3',
'🯴' => '4',
'🯵' => '5',
'🯶' => '6',
'🯷' => '7',
'🯸' => '8',
'🯹' => '9',
);
<?php
return array (
'̀' => 230,
'́' => 230,
'̂' => 230,
'̃' => 230,
'̄' => 230,
'̅' => 230,
'̆' => 230,
'̇' => 230,
'̈' => 230,
'̉' => 230,
'̊' => 230,
'̋' => 230,
'̌' => 230,
'̍' => 230,
'̎' => 230,
'̏' => 230,
'̐' => 230,
'̑' => 230,
'̒' => 230,
'̓' => 230,
'̔' => 230,
'̕' => 232,
'̖' => 220,
'̗' => 220,
'̘' => 220,
'̙' => 220,
'̚' => 232,
'̛' => 216,
'̜' => 220,
'̝' => 220,
'̞' => 220,
'̟' => 220,
'̠' => 220,
'̡' => 202,
'̢' => 202,
'̣' => 220,
'̤' => 220,
'̥' => 220,
'̦' => 220,
'̧' => 202,
'̨' => 202,
'̩' => 220,
'̪' => 220,
'̫' => 220,
'̬' => 220,
'̭' => 220,
'̮' => 220,
'̯' => 220,
'̰' => 220,
'̱' => 220,
'̲' => 220,
'̳' => 220,
'̴' => 1,
'̵' => 1,
'̶' => 1,
'̷' => 1,
'̸' => 1,
'̹' => 220,
'̺' => 220,
'̻' => 220,
'̼' => 220,
'̽' => 230,
'̾' => 230,
'̿' => 230,
'̀' => 230,
'́' => 230,
'͂' => 230,
'̓' => 230,
'̈́' => 230,
'ͅ' => 240,
'͆' => 230,
'͇' => 220,
'͈' => 220,
'͉' => 220,
'͊' => 230,
'͋' => 230,
'͌' => 230,
'͍' => 220,
'͎' => 220,
'͐' => 230,
'͑' => 230,
'͒' => 230,
'͓' => 220,
'͔' => 220,
'͕' => 220,
'͖' => 220,
'͗' => 230,
'͘' => 232,
'͙' => 220,
'͚' => 220,
'͛' => 230,
'͜' => 233,
'͝' => 234,
'͞' => 234,
'͟' => 233,
'͠' => 234,
'͡' => 234,
'͢' => 233,
'ͣ' => 230,
'ͤ' => 230,
'ͥ' => 230,
'ͦ' => 230,
'ͧ' => 230,
'ͨ' => 230,
'ͩ' => 230,
'ͪ' => 230,
'ͫ' => 230,
'ͬ' => 230,
'ͭ' => 230,
'ͮ' => 230,
'ͯ' => 230,
'҃' => 230,
'҄' => 230,
'҅' => 230,
'҆' => 230,
'҇' => 230,
'֑' => 220,
'֒' => 230,
'֓' => 230,
'֔' => 230,
'֕' => 230,
'֖' => 220,
'֗' => 230,
'֘' => 230,
'֙' => 230,
'֚' => 222,
'֛' => 220,
'֜' => 230,
'֝' => 230,
'֞' => 230,
'֟' => 230,
'֠' => 230,
'֡' => 230,
'֢' => 220,
'֣' => 220,
'֤' => 220,
'֥' => 220,
'֦' => 220,
'֧' => 220,
'֨' => 230,
'֩' => 230,
'֪' => 220,
'֫' => 230,
'֬' => 230,
'֭' => 222,
'֮' => 228,
'֯' => 230,
'ְ' => 10,
'ֱ' => 11,
'ֲ' => 12,
'ֳ' => 13,
'ִ' => 14,
'ֵ' => 15,
'ֶ' => 16,
'ַ' => 17,
'ָ' => 18,
'ֹ' => 19,
'ֺ' => 19,
'ֻ' => 20,
'ּ' => 21,
'ֽ' => 22,
'ֿ' => 23,
'ׁ' => 24,
'ׂ' => 25,
'ׄ' => 230,
'ׅ' => 220,
'ׇ' => 18,
'ؐ' => 230,
'ؑ' => 230,
'ؒ' => 230,
'ؓ' => 230,
'ؔ' => 230,
'ؕ' => 230,
'ؖ' => 230,
'ؗ' => 230,
'ؘ' => 30,
'ؙ' => 31,
'ؚ' => 32,
'ً' => 27,
'ٌ' => 28,
'ٍ' => 29,
'َ' => 30,
'ُ' => 31,
'ِ' => 32,
'ّ' => 33,
'ْ' => 34,
'ٓ' => 230,
'ٔ' => 230,
'ٕ' => 220,
'ٖ' => 220,
'ٗ' => 230,
'٘' => 230,
'ٙ' => 230,
'ٚ' => 230,
'ٛ' => 230,
'ٜ' => 220,
'ٝ' => 230,
'ٞ' => 230,
'ٟ' => 220,
'ٰ' => 35,
'ۖ' => 230,
'ۗ' => 230,
'ۘ' => 230,
'ۙ' => 230,
'ۚ' => 230,
'ۛ' => 230,
'ۜ' => 230,
'۟' => 230,
'۠' => 230,
'ۡ' => 230,
'ۢ' => 230,
'ۣ' => 220,
'ۤ' => 230,
'ۧ' => 230,
'ۨ' => 230,
'۪' => 220,
'۫' => 230,
'۬' => 230,
'ۭ' => 220,
'ܑ' => 36,
'ܰ' => 230,
'ܱ' => 220,
'ܲ' => 230,
'ܳ' => 230,
'ܴ' => 220,
'ܵ' => 230,
'ܶ' => 230,
'ܷ' => 220,
'ܸ' => 220,
'ܹ' => 220,
'ܺ' => 230,
'ܻ' => 220,
'ܼ' => 220,
'ܽ' => 230,
'ܾ' => 220,
'ܿ' => 230,
'݀' => 230,
'݁' => 230,
'݂' => 220,
'݃' => 230,
'݄' => 220,
'݅' => 230,
'݆' => 220,
'݇' => 230,
'݈' => 220,
'݉' => 230,
'݊' => 230,
'߫' => 230,
'߬' => 230,
'߭' => 230,
'߮' => 230,
'߯' => 230,
'߰' => 230,
'߱' => 230,
'߲' => 220,
'߳' => 230,
'߽' => 220,
'ࠖ' => 230,
'ࠗ' => 230,
'࠘' => 230,
'࠙' => 230,
'ࠛ' => 230,
'ࠜ' => 230,
'ࠝ' => 230,
'ࠞ' => 230,
'ࠟ' => 230,
'ࠠ' => 230,
'ࠡ' => 230,
'ࠢ' => 230,
'ࠣ' => 230,
'ࠥ' => 230,
'ࠦ' => 230,
'ࠧ' => 230,
'ࠩ' => 230,
'ࠪ' => 230,
'ࠫ' => 230,
'ࠬ' => 230,
'࠭' => 230,
'࡙' => 220,
'࡚' => 220,
'࡛' => 220,
'࣓' => 220,
'ࣔ' => 230,
'ࣕ' => 230,
'ࣖ' => 230,
'ࣗ' => 230,
'ࣘ' => 230,
'ࣙ' => 230,
'ࣚ' => 230,
'ࣛ' => 230,
'ࣜ' => 230,
'ࣝ' => 230,
'ࣞ' => 230,
'ࣟ' => 230,
'࣠' => 230,
'࣡' => 230,
'ࣣ' => 220,
'ࣤ' => 230,
'ࣥ' => 230,
'ࣦ' => 220,
'ࣧ' => 230,
'ࣨ' => 230,
'ࣩ' => 220,
'࣪' => 230,
'࣫' => 230,
'࣬' => 230,
'࣭' => 220,
'࣮' => 220,
'࣯' => 220,
'ࣰ' => 27,
'ࣱ' => 28,
'ࣲ' => 29,
'ࣳ' => 230,
'ࣴ' => 230,
'ࣵ' => 230,
'ࣶ' => 220,
'ࣷ' => 230,
'ࣸ' => 230,
'ࣹ' => 220,
'ࣺ' => 220,
'ࣻ' => 230,
'ࣼ' => 230,
'ࣽ' => 230,
'ࣾ' => 230,
'ࣿ' => 230,
'़' => 7,
'्' => 9,
'॑' => 230,
'॒' => 220,
'॓' => 230,
'॔' => 230,
'়' => 7,
'্' => 9,
'৾' => 230,
'਼' => 7,
'੍' => 9,
'઼' => 7,
'્' => 9,
'଼' => 7,
'୍' => 9,
'்' => 9,
'్' => 9,
'ౕ' => 84,
'ౖ' => 91,
'಼' => 7,
'್' => 9,
'഻' => 9,
'഼' => 9,
'്' => 9,
'්' => 9,
'ุ' => 103,
'ู' => 103,
'ฺ' => 9,
'่' => 107,
'้' => 107,
'๊' => 107,
'๋' => 107,
'ຸ' => 118,
'ູ' => 118,
'຺' => 9,
'່' => 122,
'້' => 122,
'໊' => 122,
'໋' => 122,
'༘' => 220,
'༙' => 220,
'༵' => 220,
'༷' => 220,
'༹' => 216,
'ཱ' => 129,
'ི' => 130,
'ུ' => 132,
'ེ' => 130,
'ཻ' => 130,
'ོ' => 130,
'ཽ' => 130,
'ྀ' => 130,
'ྂ' => 230,
'ྃ' => 230,
'྄' => 9,
'྆' => 230,
'྇' => 230,
'࿆' => 220,
'့' => 7,
'္' => 9,
'်' => 9,
'ႍ' => 220,
'፝' => 230,
'፞' => 230,
'፟' => 230,
'᜔' => 9,
'᜴' => 9,
'្' => 9,
'៝' => 230,
'ᢩ' => 228,
'᤹' => 222,
'᤺' => 230,
'᤻' => 220,
'ᨗ' => 230,
'ᨘ' => 220,
'᩠' => 9,
'᩵' => 230,
'᩶' => 230,
'᩷' => 230,
'᩸' => 230,
'᩹' => 230,
'᩺' => 230,
'᩻' => 230,
'᩼' => 230,
'᩿' => 220,
'᪰' => 230,
'᪱' => 230,
'᪲' => 230,
'᪳' => 230,
'᪴' => 230,
'᪵' => 220,
'᪶' => 220,
'᪷' => 220,
'᪸' => 220,
'᪹' => 220,
'᪺' => 220,
'᪻' => 230,
'᪼' => 230,
'᪽' => 220,
'ᪿ' => 220,
'ᫀ' => 220,
'᬴' => 7,
'᭄' => 9,
'᭫' => 230,
'᭬' => 220,
'᭭' => 230,
'᭮' => 230,
'᭯' => 230,
'᭰' => 230,
'᭱' => 230,
'᭲' => 230,
'᭳' => 230,
'᮪' => 9,
'᮫' => 9,
'᯦' => 7,
'᯲' => 9,
'᯳' => 9,
'᰷' => 7,
'᳐' => 230,
'᳑' => 230,
'᳒' => 230,
'᳔' => 1,
'᳕' => 220,
'᳖' => 220,
'᳗' => 220,
'᳘' => 220,
'᳙' => 220,
'᳚' => 230,
'᳛' => 230,
'᳜' => 220,
'᳝' => 220,
'᳞' => 220,
'᳟' => 220,
'᳠' => 230,
'᳢' => 1,
'᳣' => 1,
'᳤' => 1,
'᳥' => 1,
'᳦' => 1,
'᳧' => 1,
'᳨' => 1,
'᳭' => 220,
'᳴' => 230,
'᳸' => 230,
'᳹' => 230,
'᷀' => 230,
'᷁' => 230,
'᷂' => 220,
'᷃' => 230,
'᷄' => 230,
'᷅' => 230,
'᷆' => 230,
'᷇' => 230,
'᷈' => 230,
'᷉' => 230,
'᷊' => 220,
'᷋' => 230,
'᷌' => 230,
'᷍' => 234,
'᷎' => 214,
'᷏' => 220,
'᷐' => 202,
'᷑' => 230,
'᷒' => 230,
'ᷓ' => 230,
'ᷔ' => 230,
'ᷕ' => 230,
'ᷖ' => 230,
'ᷗ' => 230,
'ᷘ' => 230,
'ᷙ' => 230,
'ᷚ' => 230,
'ᷛ' => 230,
'ᷜ' => 230,
'ᷝ' => 230,
'ᷞ' => 230,
'ᷟ' => 230,
'ᷠ' => 230,
'ᷡ' => 230,
'ᷢ' => 230,
'ᷣ' => 230,
'ᷤ' => 230,
'ᷥ' => 230,
'ᷦ' => 230,
'ᷧ' => 230,
'ᷨ' => 230,
'ᷩ' => 230,
'ᷪ' => 230,
'ᷫ' => 230,
'ᷬ' => 230,
'ᷭ' => 230,
'ᷮ' => 230,
'ᷯ' => 230,
'ᷰ' => 230,
'ᷱ' => 230,
'ᷲ' => 230,
'ᷳ' => 230,
'ᷴ' => 230,
'᷵' => 230,
'᷶' => 232,
'᷷' => 228,
'᷸' => 228,
'᷹' => 220,
'᷻' => 230,
'᷼' => 233,
'᷽' => 220,
'᷾' => 230,
'᷿' => 220,
'⃐' => 230,
'⃑' => 230,
'⃒' => 1,
'⃓' => 1,
'⃔' => 230,
'⃕' => 230,
'⃖' => 230,
'⃗' => 230,
'⃘' => 1,
'⃙' => 1,
'⃚' => 1,
'⃛' => 230,
'⃜' => 230,
'⃡' => 230,
'⃥' => 1,
'⃦' => 1,
'⃧' => 230,
'⃨' => 220,
'⃩' => 230,
'⃪' => 1,
'⃫' => 1,
'⃬' => 220,
'⃭' => 220,
'⃮' => 220,
'⃯' => 220,
'⃰' => 230,
'⳯' => 230,
'⳰' => 230,
'⳱' => 230,
'⵿' => 9,
'ⷠ' => 230,
'ⷡ' => 230,
'ⷢ' => 230,
'ⷣ' => 230,
'ⷤ' => 230,
'ⷥ' => 230,
'ⷦ' => 230,
'ⷧ' => 230,
'ⷨ' => 230,
'ⷩ' => 230,
'ⷪ' => 230,
'ⷫ' => 230,
'ⷬ' => 230,
'ⷭ' => 230,
'ⷮ' => 230,
'ⷯ' => 230,
'ⷰ' => 230,
'ⷱ' => 230,
'ⷲ' => 230,
'ⷳ' => 230,
'ⷴ' => 230,
'ⷵ' => 230,
'ⷶ' => 230,
'ⷷ' => 230,
'ⷸ' => 230,
'ⷹ' => 230,
'ⷺ' => 230,
'ⷻ' => 230,
'ⷼ' => 230,
'ⷽ' => 230,
'ⷾ' => 230,
'ⷿ' => 230,
'〪' => 218,
'〫' => 228,
'〬' => 232,
'〭' => 222,
'〮' => 224,
'〯' => 224,
'゙' => 8,
'゚' => 8,
'꙯' => 230,
'ꙴ' => 230,
'ꙵ' => 230,
'ꙶ' => 230,
'ꙷ' => 230,
'ꙸ' => 230,
'ꙹ' => 230,
'ꙺ' => 230,
'ꙻ' => 230,
'꙼' => 230,
'꙽' => 230,
'ꚞ' => 230,
'ꚟ' => 230,
'꛰' => 230,
'꛱' => 230,
'꠆' => 9,
'꠬' => 9,
'꣄' => 9,
'꣠' => 230,
'꣡' => 230,
'꣢' => 230,
'꣣' => 230,
'꣤' => 230,
'꣥' => 230,
'꣦' => 230,
'꣧' => 230,
'꣨' => 230,
'꣩' => 230,
'꣪' => 230,
'꣫' => 230,
'꣬' => 230,
'꣭' => 230,
'꣮' => 230,
'꣯' => 230,
'꣰' => 230,
'꣱' => 230,
'꤫' => 220,
'꤬' => 220,
'꤭' => 220,
'꥓' => 9,
'꦳' => 7,
'꧀' => 9,
'ꪰ' => 230,
'ꪲ' => 230,
'ꪳ' => 230,
'ꪴ' => 220,
'ꪷ' => 230,
'ꪸ' => 230,
'ꪾ' => 230,
'꪿' => 230,
'꫁' => 230,
'꫶' => 9,
'꯭' => 9,
'ﬞ' => 26,
'︠' => 230,
'︡' => 230,
'︢' => 230,
'︣' => 230,
'︤' => 230,
'︥' => 230,
'︦' => 230,
'︧' => 220,
'︨' => 220,
'︩' => 220,
'︪' => 220,
'︫' => 220,
'︬' => 220,
'︭' => 220,
'︮' => 230,
'︯' => 230,
'𐇽' => 220,
'𐋠' => 220,
'𐍶' => 230,
'𐍷' => 230,
'𐍸' => 230,
'𐍹' => 230,
'𐍺' => 230,
'𐨍' => 220,
'𐨏' => 230,
'𐨸' => 230,
'𐨹' => 1,
'𐨺' => 220,
'𐨿' => 9,
'𐫥' => 230,
'𐫦' => 220,
'𐴤' => 230,
'𐴥' => 230,
'𐴦' => 230,
'𐴧' => 230,
'𐺫' => 230,
'𐺬' => 230,
'𐽆' => 220,
'𐽇' => 220,
'𐽈' => 230,
'𐽉' => 230,
'𐽊' => 230,
'𐽋' => 220,
'𐽌' => 230,
'𐽍' => 220,
'𐽎' => 220,
'𐽏' => 220,
'𐽐' => 220,
'𑁆' => 9,
'𑁿' => 9,
'𑂹' => 9,
'𑂺' => 7,
'𑄀' => 230,
'𑄁' => 230,
'𑄂' => 230,
'𑄳' => 9,
'𑄴' => 9,
'𑅳' => 7,
'𑇀' => 9,
'𑇊' => 7,
'𑈵' => 9,
'𑈶' => 7,
'𑋩' => 7,
'𑋪' => 9,
'𑌻' => 7,
'𑌼' => 7,
'𑍍' => 9,
'𑍦' => 230,
'𑍧' => 230,
'𑍨' => 230,
'𑍩' => 230,
'𑍪' => 230,
'𑍫' => 230,
'𑍬' => 230,
'𑍰' => 230,
'𑍱' => 230,
'𑍲' => 230,
'𑍳' => 230,
'𑍴' => 230,
'𑑂' => 9,
'𑑆' => 7,
'𑑞' => 230,
'𑓂' => 9,
'𑓃' => 7,
'𑖿' => 9,
'𑗀' => 7,
'𑘿' => 9,
'𑚶' => 9,
'𑚷' => 7,
'𑜫' => 9,
'𑠹' => 9,
'𑠺' => 7,
'𑤽' => 9,
'𑤾' => 9,
'𑥃' => 7,
'𑧠' => 9,
'𑨴' => 9,
'𑩇' => 9,
'𑪙' => 9,
'𑰿' => 9,
'𑵂' => 7,
'𑵄' => 9,
'𑵅' => 9,
'𑶗' => 9,
'𖫰' => 1,
'𖫱' => 1,
'𖫲' => 1,
'𖫳' => 1,
'𖫴' => 1,
'𖬰' => 230,
'𖬱' => 230,
'𖬲' => 230,
'𖬳' => 230,
'𖬴' => 230,
'𖬵' => 230,
'𖬶' => 230,
'𖿰' => 6,
'𖿱' => 6,
'𛲞' => 1,
'𝅥' => 216,
'𝅦' => 216,
'𝅧' => 1,
'𝅨' => 1,
'𝅩' => 1,
'𝅭' => 226,
'𝅮' => 216,
'𝅯' => 216,
'𝅰' => 216,
'𝅱' => 216,
'𝅲' => 216,
'𝅻' => 220,
'𝅼' => 220,
'𝅽' => 220,
'𝅾' => 220,
'𝅿' => 220,
'𝆀' => 220,
'𝆁' => 220,
'𝆂' => 220,
'𝆅' => 230,
'𝆆' => 230,
'𝆇' => 230,
'𝆈' => 230,
'𝆉' => 230,
'𝆊' => 220,
'𝆋' => 220,
'𝆪' => 230,
'𝆫' => 230,
'𝆬' => 230,
'𝆭' => 230,
'𝉂' => 230,
'𝉃' => 230,
'𝉄' => 230,
'𞀀' => 230,
'𞀁' => 230,
'𞀂' => 230,
'𞀃' => 230,
'𞀄' => 230,
'𞀅' => 230,
'𞀆' => 230,
'𞀈' => 230,
'𞀉' => 230,
'𞀊' => 230,
'𞀋' => 230,
'𞀌' => 230,
'𞀍' => 230,
'𞀎' => 230,
'𞀏' => 230,
'𞀐' => 230,
'𞀑' => 230,
'𞀒' => 230,
'𞀓' => 230,
'𞀔' => 230,
'𞀕' => 230,
'𞀖' => 230,
'𞀗' => 230,
'𞀘' => 230,
'𞀛' => 230,
'𞀜' => 230,
'𞀝' => 230,
'𞀞' => 230,
'𞀟' => 230,
'𞀠' => 230,
'𞀡' => 230,
'𞀣' => 230,
'𞀤' => 230,
'𞀦' => 230,
'𞀧' => 230,
'𞀨' => 230,
'𞀩' => 230,
'𞀪' => 230,
'𞄰' => 230,
'𞄱' => 230,
'𞄲' => 230,
'𞄳' => 230,
'𞄴' => 230,
'𞄵' => 230,
'𞄶' => 230,
'𞋬' => 230,
'𞋭' => 230,
'𞋮' => 230,
'𞋯' => 230,
'𞣐' => 220,
'𞣑' => 220,
'𞣒' => 220,
'𞣓' => 220,
'𞣔' => 220,
'𞣕' => 220,
'𞣖' => 220,
'𞥄' => 230,
'𞥅' => 230,
'𞥆' => 230,
'𞥇' => 230,
'𞥈' => 230,
'𞥉' => 230,
'𞥊' => 7,
);
<?php
class Normalizer extends Symfony\Polyfill\Intl\Normalizer\Normalizer
{
/**
* @deprecated since ICU 56 and removed in PHP 8
*/
public const NONE = 2;
public const FORM_D = 4;
public const FORM_KD = 8;
public const FORM_C = 16;
public const FORM_KC = 32;
public const NFD = 4;
public const NFKD = 8;
public const NFC = 16;
public const NFKC = 32;
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use Symfony\Polyfill\Intl\Normalizer as p;
if (\PHP_VERSION_ID >= 80000) {
return require __DIR__.'/bootstrap80.php';
}
if (!function_exists('normalizer_is_normalized')) {
function normalizer_is_normalized($string, $form = p\Normalizer::FORM_C) { return p\Normalizer::isNormalized($string, $form); }
}
if (!function_exists('normalizer_normalize')) {
function normalizer_normalize($string, $form = p\Normalizer::FORM_C) { return p\Normalizer::normalize($string, $form); }
}
Copyright (c) 2015-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Polyfill\Intl\Normalizer;
/**
* Normalizer is a PHP fallback implementation of the Normalizer class provided by the intl extension.
*
* It has been validated with Unicode 6.3 Normalization Conformance Test.
* See http://www.unicode.org/reports/tr15/ for detailed info about Unicode normalizations.
*
* @author Nicolas Grekas <p@tchwork.com>
*
* @internal
*/
class Normalizer
{
public const FORM_D = \Normalizer::FORM_D;
public const FORM_KD = \Normalizer::FORM_KD;
public const FORM_C = \Normalizer::FORM_C;
public const FORM_KC = \Normalizer::FORM_KC;
public const NFD = \Normalizer::NFD;
public const NFKD = \Normalizer::NFKD;
public const NFC = \Normalizer::NFC;
public const NFKC = \Normalizer::NFKC;
private static $C;
private static $D;
private static $KD;
private static $cC;
private static $ulenMask = ["\xC0" => 2, "\xD0" => 2, "\xE0" => 3, "\xF0" => 4];
private static $ASCII = "\x20\x65\x69\x61\x73\x6E\x74\x72\x6F\x6C\x75\x64\x5D\x5B\x63\x6D\x70\x27\x0A\x67\x7C\x68\x76\x2E\x66\x62\x2C\x3A\x3D\x2D\x71\x31\x30\x43\x32\x2A\x79\x78\x29\x28\x4C\x39\x41\x53\x2F\x50\x22\x45\x6A\x4D\x49\x6B\x33\x3E\x35\x54\x3C\x44\x34\x7D\x42\x7B\x38\x46\x77\x52\x36\x37\x55\x47\x4E\x3B\x4A\x7A\x56\x23\x48\x4F\x57\x5F\x26\x21\x4B\x3F\x58\x51\x25\x59\x5C\x09\x5A\x2B\x7E\x5E\x24\x40\x60\x7F\x00\x01\x02\x03\x04\x05\x06\x07\x08\x0B\x0C\x0D\x0E\x0F\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1A\x1B\x1C\x1D\x1E\x1F";
public static function isNormalized(string $s, int $form = self::FORM_C)
{
if (!\in_array($form, [self::NFD, self::NFKD, self::NFC, self::NFKC])) {
return false;
}
if (!isset($s[strspn($s, self::$ASCII)])) {
return true;
}
if (self::NFC == $form && preg_match('//u', $s) && !preg_match('/[^\x00-\x{2FF}]/u', $s)) {
return true;
}
return self::normalize($s, $form) === $s;
}
public static function normalize(string $s, int $form = self::FORM_C)
{
if (!preg_match('//u', $s)) {
return false;
}
switch ($form) {
case self::NFC: $C = true; $K = false; break;
case self::NFD: $C = false; $K = false; break;
case self::NFKC: $C = true; $K = true; break;
case self::NFKD: $C = false; $K = true; break;
default:
if (\defined('Normalizer::NONE') && \Normalizer::NONE == $form) {
return $s;
}
if (80000 > \PHP_VERSION_ID) {
return false;
}
throw new \ValueError('normalizer_normalize(): Argument #2 ($form) must be a a valid normalization form');
}
if ('' === $s) {
return '';
}
if ($K && null === self::$KD) {
self::$KD = self::getData('compatibilityDecomposition');
}
if (null === self::$D) {
self::$D = self::getData('canonicalDecomposition');
self::$cC = self::getData('combiningClass');
}
if (null !== $mbEncoding = (2 /* MB_OVERLOAD_STRING */ & (int) \ini_get('mbstring.func_overload')) ? mb_internal_encoding() : null) {
mb_internal_encoding('8bit');
}
$r = self::decompose($s, $K);
if ($C) {
if (null === self::$C) {
self::$C = self::getData('canonicalComposition');
}
$r = self::recompose($r);
}
if (null !== $mbEncoding) {
mb_internal_encoding($mbEncoding);
}
return $r;
}
private static function recompose($s)
{
$ASCII = self::$ASCII;
$compMap = self::$C;
$combClass = self::$cC;
$ulenMask = self::$ulenMask;
$result = $tail = '';
$i = $s[0] < "\x80" ? 1 : $ulenMask[$s[0] & "\xF0"];
$len = \strlen($s);
$lastUchr = substr($s, 0, $i);
$lastUcls = isset($combClass[$lastUchr]) ? 256 : 0;
while ($i < $len) {
if ($s[$i] < "\x80") {
// ASCII chars
if ($tail) {
$lastUchr .= $tail;
$tail = '';
}
if ($j = strspn($s, $ASCII, $i + 1)) {
$lastUchr .= substr($s, $i, $j);
$i += $j;
}
$result .= $lastUchr;
$lastUchr = $s[$i];
$lastUcls = 0;
++$i;
continue;
}
$ulen = $ulenMask[$s[$i] & "\xF0"];
$uchr = substr($s, $i, $ulen);
if ($lastUchr < "\xE1\x84\x80" || "\xE1\x84\x92" < $lastUchr
|| $uchr < "\xE1\x85\xA1" || "\xE1\x85\xB5" < $uchr
|| $lastUcls) {
// Table lookup and combining chars composition
$ucls = $combClass[$uchr] ?? 0;
if (isset($compMap[$lastUchr.$uchr]) && (!$lastUcls || $lastUcls < $ucls)) {
$lastUchr = $compMap[$lastUchr.$uchr];
} elseif ($lastUcls = $ucls) {
$tail .= $uchr;
} else {
if ($tail) {
$lastUchr .= $tail;
$tail = '';
}
$result .= $lastUchr;
$lastUchr = $uchr;
}
} else {
// Hangul chars
$L = \ord($lastUchr[2]) - 0x80;
$V = \ord($uchr[2]) - 0xA1;
$T = 0;
$uchr = substr($s, $i + $ulen, 3);
if ("\xE1\x86\xA7" <= $uchr && $uchr <= "\xE1\x87\x82") {
$T = \ord($uchr[2]) - 0xA7;
0 > $T && $T += 0x40;
$ulen += 3;
}
$L = 0xAC00 + ($L * 21 + $V) * 28 + $T;
$lastUchr = \chr(0xE0 | $L >> 12).\chr(0x80 | $L >> 6 & 0x3F).\chr(0x80 | $L & 0x3F);
}
$i += $ulen;
}
return $result.$lastUchr.$tail;
}
private static function decompose($s, $c)
{
$result = '';
$ASCII = self::$ASCII;
$decompMap = self::$D;
$combClass = self::$cC;
$ulenMask = self::$ulenMask;
if ($c) {
$compatMap = self::$KD;
}
$c = [];
$i = 0;
$len = \strlen($s);
while ($i < $len) {
if ($s[$i] < "\x80") {
// ASCII chars
if ($c) {
ksort($c);
$result .= implode('', $c);
$c = [];
}
$j = 1 + strspn($s, $ASCII, $i + 1);
$result .= substr($s, $i, $j);
$i += $j;
continue;
}
$ulen = $ulenMask[$s[$i] & "\xF0"];
$uchr = substr($s, $i, $ulen);
$i += $ulen;
if ($uchr < "\xEA\xB0\x80" || "\xED\x9E\xA3" < $uchr) {
// Table lookup
if ($uchr !== $j = $compatMap[$uchr] ?? ($decompMap[$uchr] ?? $uchr)) {
$uchr = $j;
$j = \strlen($uchr);
$ulen = $uchr[0] < "\x80" ? 1 : $ulenMask[$uchr[0] & "\xF0"];
if ($ulen != $j) {
// Put trailing chars in $s
$j -= $ulen;
$i -= $j;
if (0 > $i) {
$s = str_repeat(' ', -$i).$s;
$len -= $i;
$i = 0;
}
while ($j--) {
$s[$i + $j] = $uchr[$ulen + $j];
}
$uchr = substr($uchr, 0, $ulen);
}
}
if (isset($combClass[$uchr])) {
// Combining chars, for sorting
if (!isset($c[$combClass[$uchr]])) {
$c[$combClass[$uchr]] = '';
}
$c[$combClass[$uchr]] .= $uchr;
continue;
}
} else {
// Hangul chars
$uchr = unpack('C*', $uchr);
$j = (($uchr[1] - 224) << 12) + (($uchr[2] - 128) << 6) + $uchr[3] - 0xAC80;
$uchr = "\xE1\x84".\chr(0x80 + (int) ($j / 588))
."\xE1\x85".\chr(0xA1 + (int) (($j % 588) / 28));
if ($j %= 28) {
$uchr .= $j < 25
? ("\xE1\x86".\chr(0xA7 + $j))
: ("\xE1\x87".\chr(0x67 + $j));
}
}
if ($c) {
ksort($c);
$result .= implode('', $c);
$c = [];
}
$result .= $uchr;
}
if ($c) {
ksort($c);
$result .= implode('', $c);
}
return $result;
}
private static function getData($file)
{
if (file_exists($file = __DIR__.'/Resources/unidata/'.$file.'.php')) {
return require $file;
}
return false;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use Symfony\Polyfill\Intl\Normalizer as p;
if (!function_exists('normalizer_is_normalized')) {
function normalizer_is_normalized(?string $string, ?int $form = p\Normalizer::FORM_C): bool { return p\Normalizer::isNormalized((string) $string, (int) $form); }
}
if (!function_exists('normalizer_normalize')) {
function normalizer_normalize(?string $string, ?int $form = p\Normalizer::FORM_C): string|false { return p\Normalizer::normalize((string) $string, (int) $form); }
}
<?php
namespace _PHPStan_6dcda722c;
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use _PHPStan_6dcda722c\Symfony\Polyfill\Ctype as p;
if (\PHP_VERSION_ID >= 80000) {
return require __DIR__ . '/bootstrap80.php';
}
if (!\function_exists('ctype_alnum')) {
function ctype_alnum($text)
{
return p\Ctype::ctype_alnum($text);
}
}
if (!\function_exists('ctype_alpha')) {
function ctype_alpha($text)
{
return p\Ctype::ctype_alpha($text);
}
}
if (!\function_exists('ctype_cntrl')) {
function ctype_cntrl($text)
{
return p\Ctype::ctype_cntrl($text);
}
}
if (!\function_exists('ctype_digit')) {
function ctype_digit($text)
{
return p\Ctype::ctype_digit($text);
}
}
if (!\function_exists('ctype_graph')) {
function ctype_graph($text)
{
return p\Ctype::ctype_graph($text);
}
}
if (!\function_exists('ctype_lower')) {
function ctype_lower($text)
{
return p\Ctype::ctype_lower($text);
}
}
if (!\function_exists('ctype_print')) {
function ctype_print($text)
{
return p\Ctype::ctype_print($text);
}
}
if (!\function_exists('ctype_punct')) {
function ctype_punct($text)
{
return p\Ctype::ctype_punct($text);
}
}
if (!\function_exists('ctype_space')) {
function ctype_space($text)
{
return p\Ctype::ctype_space($text);
}
}
if (!\function_exists('ctype_upper')) {
function ctype_upper($text)
{
return p\Ctype::ctype_upper($text);
}
}
if (!\function_exists('ctype_xdigit')) {
function ctype_xdigit($text)
{
return p\Ctype::ctype_xdigit($text);
}
}
Copyright (c) 2018-present Fabien Potencier
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_6dcda722c;
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use _PHPStan_6dcda722c\Symfony\Polyfill\Ctype as p;
if (!\function_exists('ctype_alnum')) {
function ctype_alnum(mixed $text) : bool
{
return p\Ctype::ctype_alnum($text);
}
}
if (!\function_exists('ctype_alpha')) {
function ctype_alpha(mixed $text) : bool
{
return p\Ctype::ctype_alpha($text);
}
}
if (!\function_exists('ctype_cntrl')) {
function ctype_cntrl(mixed $text) : bool
{
return p\Ctype::ctype_cntrl($text);
}
}
if (!\function_exists('ctype_digit')) {
function ctype_digit(mixed $text) : bool
{
return p\Ctype::ctype_digit($text);
}
}
if (!\function_exists('ctype_graph')) {
function ctype_graph(mixed $text) : bool
{
return p\Ctype::ctype_graph($text);
}
}
if (!\function_exists('ctype_lower')) {
function ctype_lower(mixed $text) : bool
{
return p\Ctype::ctype_lower($text);
}
}
if (!\function_exists('ctype_print')) {
function ctype_print(mixed $text) : bool
{
return p\Ctype::ctype_print($text);
}
}
if (!\function_exists('ctype_punct')) {
function ctype_punct(mixed $text) : bool
{
return p\Ctype::ctype_punct($text);
}
}
if (!\function_exists('ctype_space')) {
function ctype_space(mixed $text) : bool
{
return p\Ctype::ctype_space($text);
}
}
if (!\function_exists('ctype_upper')) {
function ctype_upper(mixed $text) : bool
{
return p\Ctype::ctype_upper($text);
}
}
if (!\function_exists('ctype_xdigit')) {
function ctype_xdigit(mixed $text) : bool
{
return p\Ctype::ctype_xdigit($text);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Polyfill\Ctype;
/**
* Ctype implementation through regex.
*
* @internal
*
* @author Gert de Pagter <BackEndTea@gmail.com>
*/
final class Ctype
{
/**
* Returns TRUE if every character in text is either a letter or a digit, FALSE otherwise.
*
* @see https://php.net/ctype-alnum
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_alnum($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^A-Za-z0-9]/', $text);
}
/**
* Returns TRUE if every character in text is a letter, FALSE otherwise.
*
* @see https://php.net/ctype-alpha
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_alpha($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^A-Za-z]/', $text);
}
/**
* Returns TRUE if every character in text is a control character from the current locale, FALSE otherwise.
*
* @see https://php.net/ctype-cntrl
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_cntrl($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^\\x00-\\x1f\\x7f]/', $text);
}
/**
* Returns TRUE if every character in the string text is a decimal digit, FALSE otherwise.
*
* @see https://php.net/ctype-digit
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_digit($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^0-9]/', $text);
}
/**
* Returns TRUE if every character in text is printable and actually creates visible output (no white space), FALSE otherwise.
*
* @see https://php.net/ctype-graph
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_graph($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^!-~]/', $text);
}
/**
* Returns TRUE if every character in text is a lowercase letter.
*
* @see https://php.net/ctype-lower
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_lower($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^a-z]/', $text);
}
/**
* Returns TRUE if every character in text will actually create output (including blanks). Returns FALSE if text contains control characters or characters that do not have any output or control function at all.
*
* @see https://php.net/ctype-print
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_print($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^ -~]/', $text);
}
/**
* Returns TRUE if every character in text is printable, but neither letter, digit or blank, FALSE otherwise.
*
* @see https://php.net/ctype-punct
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_punct($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^!-\\/\\:-@\\[-`\\{-~]/', $text);
}
/**
* Returns TRUE if every character in text creates some sort of white space, FALSE otherwise. Besides the blank character this also includes tab, vertical tab, line feed, carriage return and form feed characters.
*
* @see https://php.net/ctype-space
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_space($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^\\s]/', $text);
}
/**
* Returns TRUE if every character in text is an uppercase letter.
*
* @see https://php.net/ctype-upper
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_upper($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^A-Z]/', $text);
}
/**
* Returns TRUE if every character in text is a hexadecimal 'digit', that is a decimal digit or a character from [A-Fa-f] , FALSE otherwise.
*
* @see https://php.net/ctype-xdigit
*
* @param mixed $text
*
* @return bool
*/
public static function ctype_xdigit($text)
{
$text = self::convert_int_to_char_for_ctype($text, __FUNCTION__);
return \is_string($text) && '' !== $text && !\preg_match('/[^A-Fa-f0-9]/', $text);
}
/**
* Converts integers to their char versions according to normal ctype behaviour, if needed.
*
* If an integer between -128 and 255 inclusive is provided,
* it is interpreted as the ASCII value of a single character
* (negative values have 256 added in order to allow characters in the Extended ASCII range).
* Any other integer is interpreted as a string containing the decimal digits of the integer.
*
* @param mixed $int
* @param string $function
*
* @return mixed
*/
private static function convert_int_to_char_for_ctype($int, $function)
{
if (!\is_int($int)) {
return $int;
}
if ($int < -128 || $int > 255) {
return (string) $int;
}
if (\PHP_VERSION_ID >= 80100) {
@\trigger_error($function . '(): Argument of type int will be interpreted as string in the future', \E_USER_DEPRECATED);
}
if ($int < 0) {
$int += 256;
}
return \chr($int);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
/**
* @author Fabien Potencier <fabien@symfony.com>
*/
final class Color
{
private const COLORS = ['black' => 0, 'red' => 1, 'green' => 2, 'yellow' => 3, 'blue' => 4, 'magenta' => 5, 'cyan' => 6, 'white' => 7, 'default' => 9];
private const BRIGHT_COLORS = ['gray' => 0, 'bright-red' => 1, 'bright-green' => 2, 'bright-yellow' => 3, 'bright-blue' => 4, 'bright-magenta' => 5, 'bright-cyan' => 6, 'bright-white' => 7];
private const AVAILABLE_OPTIONS = ['bold' => ['set' => 1, 'unset' => 22], 'underscore' => ['set' => 4, 'unset' => 24], 'blink' => ['set' => 5, 'unset' => 25], 'reverse' => ['set' => 7, 'unset' => 27], 'conceal' => ['set' => 8, 'unset' => 28]];
private $foreground;
private $background;
private $options = [];
public function __construct(string $foreground = '', string $background = '', array $options = [])
{
$this->foreground = $this->parseColor($foreground);
$this->background = $this->parseColor($background, \true);
foreach ($options as $option) {
if (!isset(self::AVAILABLE_OPTIONS[$option])) {
throw new InvalidArgumentException(\sprintf('Invalid option specified: "%s". Expected one of (%s).', $option, \implode(', ', \array_keys(self::AVAILABLE_OPTIONS))));
}
$this->options[$option] = self::AVAILABLE_OPTIONS[$option];
}
}
public function apply(string $text) : string
{
return $this->set() . $text . $this->unset();
}
public function set() : string
{
$setCodes = [];
if ('' !== $this->foreground) {
$setCodes[] = $this->foreground;
}
if ('' !== $this->background) {
$setCodes[] = $this->background;
}
foreach ($this->options as $option) {
$setCodes[] = $option['set'];
}
if (0 === \count($setCodes)) {
return '';
}
return \sprintf("\x1b[%sm", \implode(';', $setCodes));
}
public function unset() : string
{
$unsetCodes = [];
if ('' !== $this->foreground) {
$unsetCodes[] = 39;
}
if ('' !== $this->background) {
$unsetCodes[] = 49;
}
foreach ($this->options as $option) {
$unsetCodes[] = $option['unset'];
}
if (0 === \count($unsetCodes)) {
return '';
}
return \sprintf("\x1b[%sm", \implode(';', $unsetCodes));
}
private function parseColor(string $color, bool $background = \false) : string
{
if ('' === $color) {
return '';
}
if ('#' === $color[0]) {
$color = \substr($color, 1);
if (3 === \strlen($color)) {
$color = $color[0] . $color[0] . $color[1] . $color[1] . $color[2] . $color[2];
}
if (6 !== \strlen($color)) {
throw new InvalidArgumentException(\sprintf('Invalid "%s" color.', $color));
}
return ($background ? '4' : '3') . $this->convertHexColorToAnsi(\hexdec($color));
}
if (isset(self::COLORS[$color])) {
return ($background ? '4' : '3') . self::COLORS[$color];
}
if (isset(self::BRIGHT_COLORS[$color])) {
return ($background ? '10' : '9') . self::BRIGHT_COLORS[$color];
}
throw new InvalidArgumentException(\sprintf('Invalid "%s" color; expected one of (%s).', $color, \implode(', ', \array_merge(\array_keys(self::COLORS), \array_keys(self::BRIGHT_COLORS)))));
}
private function convertHexColorToAnsi(int $color) : string
{
$r = $color >> 16 & 255;
$g = $color >> 8 & 255;
$b = $color & 255;
// see https://github.com/termstandard/colors/ for more information about true color support
if ('truecolor' !== \getenv('COLORTERM')) {
return (string) $this->degradeHexColorToAnsi($r, $g, $b);
}
return \sprintf('8;2;%d;%d;%d', $r, $g, $b);
}
private function degradeHexColorToAnsi(int $r, int $g, int $b) : int
{
if (0 === \round($this->getSaturation($r, $g, $b) / 50)) {
return 0;
}
return \round($b / 255) << 2 | \round($g / 255) << 1 | \round($r / 255);
}
private function getSaturation(int $r, int $g, int $b) : int
{
$r = $r / 255;
$g = $g / 255;
$b = $b / 255;
$v = \max($r, $g, $b);
if (0 === ($diff = $v - \min($r, $g, $b))) {
return 0;
}
return (int) $diff * 100 / $v;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\CompleteCommand;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\DumpCompletionCommand;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\HelpCommand;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\LazyCommand;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\ListCommand;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\SignalableCommandInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\CommandLoader\CommandLoaderInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionSuggestions;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleCommandEvent;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleErrorEvent;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleSignalEvent;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleTerminateEvent;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\CommandNotFoundException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\ExceptionInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\LogicException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\NamespaceNotFoundException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\RuntimeException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\DebugFormatterHelper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\FormatterHelper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\HelperSet;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\ProcessHelper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\QuestionHelper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\ArgvInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\ArrayInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputAwareInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputDefinition;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\SignalRegistry\SignalRegistry;
use _PHPStan_6dcda722c\Symfony\Component\Console\Style\SymfonyStyle;
use _PHPStan_6dcda722c\Symfony\Component\ErrorHandler\ErrorHandler;
use _PHPStan_6dcda722c\Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
use _PHPStan_6dcda722c\Symfony\Contracts\Service\ResetInterface;
/**
* An Application is the container for a collection of commands.
*
* It is the main entry point of a Console application.
*
* This class is optimized for a standard CLI environment.
*
* Usage:
*
* $app = new Application('myapp', '1.0 (stable)');
* $app->add(new SimpleCommand());
* $app->run();
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class Application implements ResetInterface
{
private $commands = [];
private $wantHelps = \false;
private $runningCommand;
private $name;
private $version;
private $commandLoader;
private $catchExceptions = \true;
private $autoExit = \true;
private $definition;
private $helperSet;
private $dispatcher;
private $terminal;
private $defaultCommand;
private $singleCommand = \false;
private $initialized;
private $signalRegistry;
private $signalsToDispatchEvent = [];
public function __construct(string $name = 'UNKNOWN', string $version = 'UNKNOWN')
{
$this->name = $name;
$this->version = $version;
$this->terminal = new Terminal();
$this->defaultCommand = 'list';
if (\defined('SIGINT') && SignalRegistry::isSupported()) {
$this->signalRegistry = new SignalRegistry();
$this->signalsToDispatchEvent = [\SIGINT, \SIGTERM, \SIGUSR1, \SIGUSR2];
}
}
/**
* @final
*/
public function setDispatcher(EventDispatcherInterface $dispatcher)
{
$this->dispatcher = $dispatcher;
}
public function setCommandLoader(CommandLoaderInterface $commandLoader)
{
$this->commandLoader = $commandLoader;
}
public function getSignalRegistry() : SignalRegistry
{
if (!$this->signalRegistry) {
throw new RuntimeException('Signals are not supported. Make sure that the `pcntl` extension is installed and that "pcntl_*" functions are not disabled by your php.ini\'s "disable_functions" directive.');
}
return $this->signalRegistry;
}
public function setSignalsToDispatchEvent(int ...$signalsToDispatchEvent)
{
$this->signalsToDispatchEvent = $signalsToDispatchEvent;
}
/**
* Runs the current application.
*
* @return int 0 if everything went fine, or an error code
*
* @throws \Exception When running fails. Bypass this when {@link setCatchExceptions()}.
*/
public function run(?InputInterface $input = null, ?OutputInterface $output = null)
{
if (\function_exists('putenv')) {
@\putenv('LINES=' . $this->terminal->getHeight());
@\putenv('COLUMNS=' . $this->terminal->getWidth());
}
if (null === $input) {
$input = new ArgvInput();
}
if (null === $output) {
$output = new ConsoleOutput();
}
$renderException = function (\Throwable $e) use($output) {
if ($output instanceof ConsoleOutputInterface) {
$this->renderThrowable($e, $output->getErrorOutput());
} else {
$this->renderThrowable($e, $output);
}
};
if ($phpHandler = \set_exception_handler($renderException)) {
\restore_exception_handler();
if (!\is_array($phpHandler) || !$phpHandler[0] instanceof ErrorHandler) {
$errorHandler = \true;
} elseif ($errorHandler = $phpHandler[0]->setExceptionHandler($renderException)) {
$phpHandler[0]->setExceptionHandler($errorHandler);
}
}
$this->configureIO($input, $output);
try {
$exitCode = $this->doRun($input, $output);
} catch (\Exception $e) {
if (!$this->catchExceptions) {
throw $e;
}
$renderException($e);
$exitCode = $e->getCode();
if (\is_numeric($exitCode)) {
$exitCode = (int) $exitCode;
if ($exitCode <= 0) {
$exitCode = 1;
}
} else {
$exitCode = 1;
}
} finally {
// if the exception handler changed, keep it
// otherwise, unregister $renderException
if (!$phpHandler) {
if (\set_exception_handler($renderException) === $renderException) {
\restore_exception_handler();
}
\restore_exception_handler();
} elseif (!$errorHandler) {
$finalHandler = $phpHandler[0]->setExceptionHandler(null);
if ($finalHandler !== $renderException) {
$phpHandler[0]->setExceptionHandler($finalHandler);
}
}
}
if ($this->autoExit) {
if ($exitCode > 255) {
$exitCode = 255;
}
exit($exitCode);
}
return $exitCode;
}
/**
* Runs the current application.
*
* @return int 0 if everything went fine, or an error code
*/
public function doRun(InputInterface $input, OutputInterface $output)
{
if (\true === $input->hasParameterOption(['--version', '-V'], \true)) {
$output->writeln($this->getLongVersion());
return 0;
}
try {
// Makes ArgvInput::getFirstArgument() able to distinguish an option from an argument.
$input->bind($this->getDefinition());
} catch (ExceptionInterface $e) {
// Errors must be ignored, full binding/validation happens later when the command is known.
}
$name = $this->getCommandName($input);
if (\true === $input->hasParameterOption(['--help', '-h'], \true)) {
if (!$name) {
$name = 'help';
$input = new ArrayInput(['command_name' => $this->defaultCommand]);
} else {
$this->wantHelps = \true;
}
}
if (!$name) {
$name = $this->defaultCommand;
$definition = $this->getDefinition();
$definition->setArguments(\array_merge($definition->getArguments(), ['command' => new InputArgument('command', InputArgument::OPTIONAL, $definition->getArgument('command')->getDescription(), $name)]));
}
try {
$this->runningCommand = null;
// the command name MUST be the first element of the input
$command = $this->find($name);
} catch (\Throwable $e) {
if (!($e instanceof CommandNotFoundException && !$e instanceof NamespaceNotFoundException) || 1 !== \count($alternatives = $e->getAlternatives()) || !$input->isInteractive()) {
if (null !== $this->dispatcher) {
$event = new ConsoleErrorEvent($input, $output, $e);
$this->dispatcher->dispatch($event, ConsoleEvents::ERROR);
if (0 === $event->getExitCode()) {
return 0;
}
$e = $event->getError();
}
throw $e;
}
$alternative = $alternatives[0];
$style = new SymfonyStyle($input, $output);
$output->writeln('');
$formattedBlock = (new FormatterHelper())->formatBlock(\sprintf('Command "%s" is not defined.', $name), 'error', \true);
$output->writeln($formattedBlock);
if (!$style->confirm(\sprintf('Do you want to run "%s" instead? ', $alternative), \false)) {
if (null !== $this->dispatcher) {
$event = new ConsoleErrorEvent($input, $output, $e);
$this->dispatcher->dispatch($event, ConsoleEvents::ERROR);
return $event->getExitCode();
}
return 1;
}
$command = $this->find($alternative);
}
if ($command instanceof LazyCommand) {
$command = $command->getCommand();
}
$this->runningCommand = $command;
$exitCode = $this->doRunCommand($command, $input, $output);
$this->runningCommand = null;
return $exitCode;
}
/**
* {@inheritdoc}
*/
public function reset()
{
}
public function setHelperSet(HelperSet $helperSet)
{
$this->helperSet = $helperSet;
}
/**
* Get the helper set associated with the command.
*
* @return HelperSet
*/
public function getHelperSet()
{
if (!$this->helperSet) {
$this->helperSet = $this->getDefaultHelperSet();
}
return $this->helperSet;
}
public function setDefinition(InputDefinition $definition)
{
$this->definition = $definition;
}
/**
* Gets the InputDefinition related to this Application.
*
* @return InputDefinition
*/
public function getDefinition()
{
if (!$this->definition) {
$this->definition = $this->getDefaultInputDefinition();
}
if ($this->singleCommand) {
$inputDefinition = $this->definition;
$inputDefinition->setArguments();
return $inputDefinition;
}
return $this->definition;
}
/**
* Adds suggestions to $suggestions for the current completion input (e.g. option or argument).
*/
public function complete(CompletionInput $input, CompletionSuggestions $suggestions) : void
{
if (CompletionInput::TYPE_ARGUMENT_VALUE === $input->getCompletionType() && 'command' === $input->getCompletionName()) {
$commandNames = [];
foreach ($this->all() as $name => $command) {
// skip hidden commands and aliased commands as they already get added below
if ($command->isHidden() || $command->getName() !== $name) {
continue;
}
$commandNames[] = $command->getName();
foreach ($command->getAliases() as $name) {
$commandNames[] = $name;
}
}
$suggestions->suggestValues(\array_filter($commandNames));
return;
}
if (CompletionInput::TYPE_OPTION_NAME === $input->getCompletionType()) {
$suggestions->suggestOptions($this->getDefinition()->getOptions());
return;
}
}
/**
* Gets the help message.
*
* @return string
*/
public function getHelp()
{
return $this->getLongVersion();
}
/**
* Gets whether to catch exceptions or not during commands execution.
*
* @return bool
*/
public function areExceptionsCaught()
{
return $this->catchExceptions;
}
/**
* Sets whether to catch exceptions or not during commands execution.
*/
public function setCatchExceptions(bool $boolean)
{
$this->catchExceptions = $boolean;
}
/**
* Gets whether to automatically exit after a command execution or not.
*
* @return bool
*/
public function isAutoExitEnabled()
{
return $this->autoExit;
}
/**
* Sets whether to automatically exit after a command execution or not.
*/
public function setAutoExit(bool $boolean)
{
$this->autoExit = $boolean;
}
/**
* Gets the name of the application.
*
* @return string
*/
public function getName()
{
return $this->name;
}
/**
* Sets the application name.
**/
public function setName(string $name)
{
$this->name = $name;
}
/**
* Gets the application version.
*
* @return string
*/
public function getVersion()
{
return $this->version;
}
/**
* Sets the application version.
*/
public function setVersion(string $version)
{
$this->version = $version;
}
/**
* Returns the long version of the application.
*
* @return string
*/
public function getLongVersion()
{
if ('UNKNOWN' !== $this->getName()) {
if ('UNKNOWN' !== $this->getVersion()) {
return \sprintf('%s <info>%s</info>', $this->getName(), $this->getVersion());
}
return $this->getName();
}
return 'Console Tool';
}
/**
* Registers a new command.
*
* @return Command
*/
public function register(string $name)
{
return $this->add(new Command($name));
}
/**
* Adds an array of command objects.
*
* If a Command is not enabled it will not be added.
*
* @param Command[] $commands An array of commands
*/
public function addCommands(array $commands)
{
foreach ($commands as $command) {
$this->add($command);
}
}
/**
* Adds a command object.
*
* If a command with the same name already exists, it will be overridden.
* If the command is not enabled it will not be added.
*
* @return Command|null
*/
public function add(Command $command)
{
$this->init();
$command->setApplication($this);
if (!$command->isEnabled()) {
$command->setApplication(null);
return null;
}
if (!$command instanceof LazyCommand) {
// Will throw if the command is not correctly initialized.
$command->getDefinition();
}
if (!$command->getName()) {
throw new LogicException(\sprintf('The command defined in "%s" cannot have an empty name.', \get_debug_type($command)));
}
$this->commands[$command->getName()] = $command;
foreach ($command->getAliases() as $alias) {
$this->commands[$alias] = $command;
}
return $command;
}
/**
* Returns a registered command by name or alias.
*
* @return Command
*
* @throws CommandNotFoundException When given command name does not exist
*/
public function get(string $name)
{
$this->init();
if (!$this->has($name)) {
throw new CommandNotFoundException(\sprintf('The command "%s" does not exist.', $name));
}
// When the command has a different name than the one used at the command loader level
if (!isset($this->commands[$name])) {
throw new CommandNotFoundException(\sprintf('The "%s" command cannot be found because it is registered under multiple names. Make sure you don\'t set a different name via constructor or "setName()".', $name));
}
$command = $this->commands[$name];
if ($this->wantHelps) {
$this->wantHelps = \false;
$helpCommand = $this->get('help');
$helpCommand->setCommand($command);
return $helpCommand;
}
return $command;
}
/**
* Returns true if the command exists, false otherwise.
*
* @return bool
*/
public function has(string $name)
{
$this->init();
return isset($this->commands[$name]) || $this->commandLoader && $this->commandLoader->has($name) && $this->add($this->commandLoader->get($name));
}
/**
* Returns an array of all unique namespaces used by currently registered commands.
*
* It does not return the global namespace which always exists.
*
* @return string[]
*/
public function getNamespaces()
{
$namespaces = [];
foreach ($this->all() as $command) {
if ($command->isHidden()) {
continue;
}
$namespaces[] = $this->extractAllNamespaces($command->getName());
foreach ($command->getAliases() as $alias) {
$namespaces[] = $this->extractAllNamespaces($alias);
}
}
return \array_values(\array_unique(\array_filter(\array_merge([], ...$namespaces))));
}
/**
* Finds a registered namespace by a name or an abbreviation.
*
* @return string
*
* @throws NamespaceNotFoundException When namespace is incorrect or ambiguous
*/
public function findNamespace(string $namespace)
{
$allNamespaces = $this->getNamespaces();
$expr = \implode('[^:]*:', \array_map('preg_quote', \explode(':', $namespace))) . '[^:]*';
$namespaces = \preg_grep('{^' . $expr . '}', $allNamespaces);
if (empty($namespaces)) {
$message = \sprintf('There are no commands defined in the "%s" namespace.', $namespace);
if ($alternatives = $this->findAlternatives($namespace, $allNamespaces)) {
if (1 == \count($alternatives)) {
$message .= "\n\nDid you mean this?\n ";
} else {
$message .= "\n\nDid you mean one of these?\n ";
}
$message .= \implode("\n ", $alternatives);
}
throw new NamespaceNotFoundException($message, $alternatives);
}
$exact = \in_array($namespace, $namespaces, \true);
if (\count($namespaces) > 1 && !$exact) {
throw new NamespaceNotFoundException(\sprintf("The namespace \"%s\" is ambiguous.\nDid you mean one of these?\n%s.", $namespace, $this->getAbbreviationSuggestions(\array_values($namespaces))), \array_values($namespaces));
}
return $exact ? $namespace : \reset($namespaces);
}
/**
* Finds a command by name or alias.
*
* Contrary to get, this command tries to find the best
* match if you give it an abbreviation of a name or alias.
*
* @return Command
*
* @throws CommandNotFoundException When command name is incorrect or ambiguous
*/
public function find(string $name)
{
$this->init();
$aliases = [];
foreach ($this->commands as $command) {
foreach ($command->getAliases() as $alias) {
if (!$this->has($alias)) {
$this->commands[$alias] = $command;
}
}
}
if ($this->has($name)) {
return $this->get($name);
}
$allCommands = $this->commandLoader ? \array_merge($this->commandLoader->getNames(), \array_keys($this->commands)) : \array_keys($this->commands);
$expr = \implode('[^:]*:', \array_map('preg_quote', \explode(':', $name))) . '[^:]*';
$commands = \preg_grep('{^' . $expr . '}', $allCommands);
if (empty($commands)) {
$commands = \preg_grep('{^' . $expr . '}i', $allCommands);
}
// if no commands matched or we just matched namespaces
if (empty($commands) || \count(\preg_grep('{^' . $expr . '$}i', $commands)) < 1) {
if (\false !== ($pos = \strrpos($name, ':'))) {
// check if a namespace exists and contains commands
$this->findNamespace(\substr($name, 0, $pos));
}
$message = \sprintf('Command "%s" is not defined.', $name);
if ($alternatives = $this->findAlternatives($name, $allCommands)) {
// remove hidden commands
$alternatives = \array_filter($alternatives, function ($name) {
return !$this->get($name)->isHidden();
});
if (1 == \count($alternatives)) {
$message .= "\n\nDid you mean this?\n ";
} else {
$message .= "\n\nDid you mean one of these?\n ";
}
$message .= \implode("\n ", $alternatives);
}
throw new CommandNotFoundException($message, \array_values($alternatives));
}
// filter out aliases for commands which are already on the list
if (\count($commands) > 1) {
$commandList = $this->commandLoader ? \array_merge(\array_flip($this->commandLoader->getNames()), $this->commands) : $this->commands;
$commands = \array_unique(\array_filter($commands, function ($nameOrAlias) use(&$commandList, $commands, &$aliases) {
if (!$commandList[$nameOrAlias] instanceof Command) {
$commandList[$nameOrAlias] = $this->commandLoader->get($nameOrAlias);
}
$commandName = $commandList[$nameOrAlias]->getName();
$aliases[$nameOrAlias] = $commandName;
return $commandName === $nameOrAlias || !\in_array($commandName, $commands);
}));
}
if (\count($commands) > 1) {
$usableWidth = $this->terminal->getWidth() - 10;
$abbrevs = \array_values($commands);
$maxLen = 0;
foreach ($abbrevs as $abbrev) {
$maxLen = \max(Helper::width($abbrev), $maxLen);
}
$abbrevs = \array_map(function ($cmd) use($commandList, $usableWidth, $maxLen, &$commands) {
if ($commandList[$cmd]->isHidden()) {
unset($commands[\array_search($cmd, $commands)]);
return \false;
}
$abbrev = \str_pad($cmd, $maxLen, ' ') . ' ' . $commandList[$cmd]->getDescription();
return Helper::width($abbrev) > $usableWidth ? Helper::substr($abbrev, 0, $usableWidth - 3) . '...' : $abbrev;
}, \array_values($commands));
if (\count($commands) > 1) {
$suggestions = $this->getAbbreviationSuggestions(\array_filter($abbrevs));
throw new CommandNotFoundException(\sprintf("Command \"%s\" is ambiguous.\nDid you mean one of these?\n%s.", $name, $suggestions), \array_values($commands));
}
}
$command = $this->get(\reset($commands));
if ($command->isHidden()) {
throw new CommandNotFoundException(\sprintf('The command "%s" does not exist.', $name));
}
return $command;
}
/**
* Gets the commands (registered in the given namespace if provided).
*
* The array keys are the full names and the values the command instances.
*
* @return Command[]
*/
public function all(?string $namespace = null)
{
$this->init();
if (null === $namespace) {
if (!$this->commandLoader) {
return $this->commands;
}
$commands = $this->commands;
foreach ($this->commandLoader->getNames() as $name) {
if (!isset($commands[$name]) && $this->has($name)) {
$commands[$name] = $this->get($name);
}
}
return $commands;
}
$commands = [];
foreach ($this->commands as $name => $command) {
if ($namespace === $this->extractNamespace($name, \substr_count($namespace, ':') + 1)) {
$commands[$name] = $command;
}
}
if ($this->commandLoader) {
foreach ($this->commandLoader->getNames() as $name) {
if (!isset($commands[$name]) && $namespace === $this->extractNamespace($name, \substr_count($namespace, ':') + 1) && $this->has($name)) {
$commands[$name] = $this->get($name);
}
}
}
return $commands;
}
/**
* Returns an array of possible abbreviations given a set of names.
*
* @return string[][]
*/
public static function getAbbreviations(array $names)
{
$abbrevs = [];
foreach ($names as $name) {
for ($len = \strlen($name); $len > 0; --$len) {
$abbrev = \substr($name, 0, $len);
$abbrevs[$abbrev][] = $name;
}
}
return $abbrevs;
}
public function renderThrowable(\Throwable $e, OutputInterface $output) : void
{
$output->writeln('', OutputInterface::VERBOSITY_QUIET);
$this->doRenderThrowable($e, $output);
if (null !== $this->runningCommand) {
$output->writeln(\sprintf('<info>%s</info>', OutputFormatter::escape(\sprintf($this->runningCommand->getSynopsis(), $this->getName()))), OutputInterface::VERBOSITY_QUIET);
$output->writeln('', OutputInterface::VERBOSITY_QUIET);
}
}
protected function doRenderThrowable(\Throwable $e, OutputInterface $output) : void
{
do {
$message = \trim($e->getMessage());
if ('' === $message || OutputInterface::VERBOSITY_VERBOSE <= $output->getVerbosity()) {
$class = \get_debug_type($e);
$title = \sprintf(' [%s%s] ', $class, 0 !== ($code = $e->getCode()) ? ' (' . $code . ')' : '');
$len = Helper::width($title);
} else {
$len = 0;
}
if (\str_contains($message, "@anonymous\x00")) {
$message = \preg_replace_callback('/[a-zA-Z_\\x7f-\\xff][\\\\a-zA-Z0-9_\\x7f-\\xff]*+@anonymous\\x00.*?\\.php(?:0x?|:[0-9]++\\$)[0-9a-fA-F]++/', function ($m) {
return \class_exists($m[0], \false) ? ((\get_parent_class($m[0]) ?: \key(\class_implements($m[0]))) ?: 'class') . '@anonymous' : $m[0];
}, $message);
}
$width = $this->terminal->getWidth() ? $this->terminal->getWidth() - 1 : \PHP_INT_MAX;
$lines = [];
foreach ('' !== $message ? \preg_split('/\\r?\\n/', $message) : [] as $line) {
foreach ($this->splitStringByWidth($line, $width - 4) as $line) {
// pre-format lines to get the right string length
$lineLength = Helper::width($line) + 4;
$lines[] = [$line, $lineLength];
$len = \max($lineLength, $len);
}
}
$messages = [];
if (!$e instanceof ExceptionInterface || OutputInterface::VERBOSITY_VERBOSE <= $output->getVerbosity()) {
$messages[] = \sprintf('<comment>%s</comment>', OutputFormatter::escape(\sprintf('In %s line %s:', \basename($e->getFile()) ?: 'n/a', $e->getLine() ?: 'n/a')));
}
$messages[] = $emptyLine = \sprintf('<error>%s</error>', \str_repeat(' ', $len));
if ('' === $message || OutputInterface::VERBOSITY_VERBOSE <= $output->getVerbosity()) {
$messages[] = \sprintf('<error>%s%s</error>', $title, \str_repeat(' ', \max(0, $len - Helper::width($title))));
}
foreach ($lines as $line) {
$messages[] = \sprintf('<error> %s %s</error>', OutputFormatter::escape($line[0]), \str_repeat(' ', $len - $line[1]));
}
$messages[] = $emptyLine;
$messages[] = '';
$output->writeln($messages, OutputInterface::VERBOSITY_QUIET);
if (OutputInterface::VERBOSITY_VERBOSE <= $output->getVerbosity()) {
$output->writeln('<comment>Exception trace:</comment>', OutputInterface::VERBOSITY_QUIET);
// exception related properties
$trace = $e->getTrace();
\array_unshift($trace, ['function' => '', 'file' => $e->getFile() ?: 'n/a', 'line' => $e->getLine() ?: 'n/a', 'args' => []]);
for ($i = 0, $count = \count($trace); $i < $count; ++$i) {
$class = $trace[$i]['class'] ?? '';
$type = $trace[$i]['type'] ?? '';
$function = $trace[$i]['function'] ?? '';
$file = $trace[$i]['file'] ?? 'n/a';
$line = $trace[$i]['line'] ?? 'n/a';
$output->writeln(\sprintf(' %s%s at <info>%s:%s</info>', $class, $function ? $type . $function . '()' : '', $file, $line), OutputInterface::VERBOSITY_QUIET);
}
$output->writeln('', OutputInterface::VERBOSITY_QUIET);
}
} while ($e = $e->getPrevious());
}
/**
* Configures the input and output instances based on the user arguments and options.
*/
protected function configureIO(InputInterface $input, OutputInterface $output)
{
if (\true === $input->hasParameterOption(['--ansi'], \true)) {
$output->setDecorated(\true);
} elseif (\true === $input->hasParameterOption(['--no-ansi'], \true)) {
$output->setDecorated(\false);
}
if (\true === $input->hasParameterOption(['--no-interaction', '-n'], \true)) {
$input->setInteractive(\false);
}
switch ($shellVerbosity = (int) \getenv('SHELL_VERBOSITY')) {
case -1:
$output->setVerbosity(OutputInterface::VERBOSITY_QUIET);
break;
case 1:
$output->setVerbosity(OutputInterface::VERBOSITY_VERBOSE);
break;
case 2:
$output->setVerbosity(OutputInterface::VERBOSITY_VERY_VERBOSE);
break;
case 3:
$output->setVerbosity(OutputInterface::VERBOSITY_DEBUG);
break;
default:
$shellVerbosity = 0;
break;
}
if (\true === $input->hasParameterOption(['--quiet', '-q'], \true)) {
$output->setVerbosity(OutputInterface::VERBOSITY_QUIET);
$shellVerbosity = -1;
} else {
if ($input->hasParameterOption('-vvv', \true) || $input->hasParameterOption('--verbose=3', \true) || 3 === $input->getParameterOption('--verbose', \false, \true)) {
$output->setVerbosity(OutputInterface::VERBOSITY_DEBUG);
$shellVerbosity = 3;
} elseif ($input->hasParameterOption('-vv', \true) || $input->hasParameterOption('--verbose=2', \true) || 2 === $input->getParameterOption('--verbose', \false, \true)) {
$output->setVerbosity(OutputInterface::VERBOSITY_VERY_VERBOSE);
$shellVerbosity = 2;
} elseif ($input->hasParameterOption('-v', \true) || $input->hasParameterOption('--verbose=1', \true) || $input->hasParameterOption('--verbose', \true) || $input->getParameterOption('--verbose', \false, \true)) {
$output->setVerbosity(OutputInterface::VERBOSITY_VERBOSE);
$shellVerbosity = 1;
}
}
if (-1 === $shellVerbosity) {
$input->setInteractive(\false);
}
if (\function_exists('putenv')) {
@\putenv('SHELL_VERBOSITY=' . $shellVerbosity);
}
$_ENV['SHELL_VERBOSITY'] = $shellVerbosity;
$_SERVER['SHELL_VERBOSITY'] = $shellVerbosity;
}
/**
* Runs the current command.
*
* If an event dispatcher has been attached to the application,
* events are also dispatched during the life-cycle of the command.
*
* @return int 0 if everything went fine, or an error code
*/
protected function doRunCommand(Command $command, InputInterface $input, OutputInterface $output)
{
foreach ($command->getHelperSet() as $helper) {
if ($helper instanceof InputAwareInterface) {
$helper->setInput($input);
}
}
if ($this->signalsToDispatchEvent) {
$commandSignals = $command instanceof SignalableCommandInterface ? $command->getSubscribedSignals() : [];
if ($commandSignals || null !== $this->dispatcher) {
if (!$this->signalRegistry) {
throw new RuntimeException('Unable to subscribe to signal events. Make sure that the `pcntl` extension is installed and that "pcntl_*" functions are not disabled by your php.ini\'s "disable_functions" directive.');
}
if (Terminal::hasSttyAvailable()) {
$sttyMode = \shell_exec('stty -g');
foreach ([\SIGINT, \SIGTERM] as $signal) {
$this->signalRegistry->register($signal, static function () use($sttyMode) {
\shell_exec('stty ' . $sttyMode);
});
}
}
}
if (null !== $this->dispatcher) {
foreach ($this->signalsToDispatchEvent as $signal) {
$event = new ConsoleSignalEvent($command, $input, $output, $signal);
$this->signalRegistry->register($signal, function ($signal, $hasNext) use($event) {
$this->dispatcher->dispatch($event, ConsoleEvents::SIGNAL);
// No more handlers, we try to simulate PHP default behavior
if (!$hasNext) {
if (!\in_array($signal, [\SIGUSR1, \SIGUSR2], \true)) {
exit(0);
}
}
});
}
}
foreach ($commandSignals as $signal) {
$this->signalRegistry->register($signal, [$command, 'handleSignal']);
}
}
if (null === $this->dispatcher) {
return $command->run($input, $output);
}
// bind before the console.command event, so the listeners have access to input options/arguments
try {
$command->mergeApplicationDefinition();
$input->bind($command->getDefinition());
} catch (ExceptionInterface $e) {
// ignore invalid options/arguments for now, to allow the event listeners to customize the InputDefinition
}
$event = new ConsoleCommandEvent($command, $input, $output);
$e = null;
try {
$this->dispatcher->dispatch($event, ConsoleEvents::COMMAND);
if ($event->commandShouldRun()) {
$exitCode = $command->run($input, $output);
} else {
$exitCode = ConsoleCommandEvent::RETURN_CODE_DISABLED;
}
} catch (\Throwable $e) {
$event = new ConsoleErrorEvent($input, $output, $e, $command);
$this->dispatcher->dispatch($event, ConsoleEvents::ERROR);
$e = $event->getError();
if (0 === ($exitCode = $event->getExitCode())) {
$e = null;
}
}
$event = new ConsoleTerminateEvent($command, $input, $output, $exitCode);
$this->dispatcher->dispatch($event, ConsoleEvents::TERMINATE);
if (null !== $e) {
throw $e;
}
return $event->getExitCode();
}
/**
* Gets the name of the command based on input.
*
* @return string|null
*/
protected function getCommandName(InputInterface $input)
{
return $this->singleCommand ? $this->defaultCommand : $input->getFirstArgument();
}
/**
* Gets the default input definition.
*
* @return InputDefinition
*/
protected function getDefaultInputDefinition()
{
return new InputDefinition([new InputArgument('command', InputArgument::REQUIRED, 'The command to execute'), new InputOption('--help', '-h', InputOption::VALUE_NONE, 'Display help for the given command. When no command is given display help for the <info>' . $this->defaultCommand . '</info> command'), new InputOption('--quiet', '-q', InputOption::VALUE_NONE, 'Do not output any message'), new InputOption('--verbose', '-v|vv|vvv', InputOption::VALUE_NONE, 'Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug'), new InputOption('--version', '-V', InputOption::VALUE_NONE, 'Display this application version'), new InputOption('--ansi', '', InputOption::VALUE_NEGATABLE, 'Force (or disable --no-ansi) ANSI output', null), new InputOption('--no-interaction', '-n', InputOption::VALUE_NONE, 'Do not ask any interactive question')]);
}
/**
* Gets the default commands that should always be available.
*
* @return Command[]
*/
protected function getDefaultCommands()
{
return [new HelpCommand(), new ListCommand(), new CompleteCommand(), new DumpCompletionCommand()];
}
/**
* Gets the default helper set with the helpers that should always be available.
*
* @return HelperSet
*/
protected function getDefaultHelperSet()
{
return new HelperSet([new FormatterHelper(), new DebugFormatterHelper(), new ProcessHelper(), new QuestionHelper()]);
}
/**
* Returns abbreviated suggestions in string format.
*/
private function getAbbreviationSuggestions(array $abbrevs) : string
{
return ' ' . \implode("\n ", $abbrevs);
}
/**
* Returns the namespace part of the command name.
*
* This method is not part of public API and should not be used directly.
*
* @return string
*/
public function extractNamespace(string $name, ?int $limit = null)
{
$parts = \explode(':', $name, -1);
return \implode(':', null === $limit ? $parts : \array_slice($parts, 0, $limit));
}
/**
* Finds alternative of $name among $collection,
* if nothing is found in $collection, try in $abbrevs.
*
* @return string[]
*/
private function findAlternatives(string $name, iterable $collection) : array
{
$threshold = 1000.0;
$alternatives = [];
$collectionParts = [];
foreach ($collection as $item) {
$collectionParts[$item] = \explode(':', $item);
}
foreach (\explode(':', $name) as $i => $subname) {
foreach ($collectionParts as $collectionName => $parts) {
$exists = isset($alternatives[$collectionName]);
if (!isset($parts[$i]) && $exists) {
$alternatives[$collectionName] += $threshold;
continue;
} elseif (!isset($parts[$i])) {
continue;
}
$lev = \levenshtein($subname, $parts[$i]);
if ($lev <= \strlen($subname) / 3 || '' !== $subname && \str_contains($parts[$i], $subname)) {
$alternatives[$collectionName] = $exists ? $alternatives[$collectionName] + $lev : $lev;
} elseif ($exists) {
$alternatives[$collectionName] += $threshold;
}
}
}
foreach ($collection as $item) {
$lev = \levenshtein($name, $item);
if ($lev <= \strlen($name) / 3 || \str_contains($item, $name)) {
$alternatives[$item] = isset($alternatives[$item]) ? $alternatives[$item] - $lev : $lev;
}
}
$alternatives = \array_filter($alternatives, function ($lev) use($threshold) {
return $lev < 2 * $threshold;
});
\ksort($alternatives, \SORT_NATURAL | \SORT_FLAG_CASE);
return \array_keys($alternatives);
}
/**
* Sets the default Command name.
*
* @return $this
*/
public function setDefaultCommand(string $commandName, bool $isSingleCommand = \false)
{
$this->defaultCommand = \explode('|', \ltrim($commandName, '|'))[0];
if ($isSingleCommand) {
// Ensure the command exist
$this->find($commandName);
$this->singleCommand = \true;
}
return $this;
}
/**
* @internal
*/
public function isSingleCommand() : bool
{
return $this->singleCommand;
}
private function splitStringByWidth(string $string, int $width) : array
{
// str_split is not suitable for multi-byte characters, we should use preg_split to get char array properly.
// additionally, array_slice() is not enough as some character has doubled width.
// we need a function to split string not by character count but by string width
if (\false === ($encoding = \mb_detect_encoding($string, null, \true))) {
return \str_split($string, $width);
}
$utf8String = \mb_convert_encoding($string, 'utf8', $encoding);
$lines = [];
$line = '';
$offset = 0;
while (\preg_match('/.{1,10000}/u', $utf8String, $m, 0, $offset)) {
$offset += \strlen($m[0]);
foreach (\preg_split('//u', $m[0]) as $char) {
// test if $char could be appended to current line
if (\mb_strwidth($line . $char, 'utf8') <= $width) {
$line .= $char;
continue;
}
// if not, push current line to array and make new line
$lines[] = \str_pad($line, $width);
$line = $char;
}
}
$lines[] = \count($lines) ? \str_pad($line, $width) : $line;
\mb_convert_variables($encoding, 'utf8', $lines);
return $lines;
}
/**
* Returns all namespaces of the command name.
*
* @return string[]
*/
private function extractAllNamespaces(string $name) : array
{
// -1 as third argument is needed to skip the command short name when exploding
$parts = \explode(':', $name, -1);
$namespaces = [];
foreach ($parts as $part) {
if (\count($namespaces)) {
$namespaces[] = \end($namespaces) . ':' . $part;
} else {
$namespaces[] = $part;
}
}
return $namespaces;
}
private function init()
{
if ($this->initialized) {
return;
}
$this->initialized = \true;
foreach ($this->getDefaultCommands() as $command) {
$this->add($command);
}
}
}
# This file is part of the Symfony package.
#
# (c) Fabien Potencier <fabien@symfony.com>
#
# For the full copyright and license information, please view
# https://symfony.com/doc/current/contributing/code/license.html
_sf_{{ COMMAND_NAME }}() {
# Use newline as only separator to allow space in completion values
IFS=$'\n'
local sf_cmd="${COMP_WORDS[0]}"
# for an alias, get the real script behind it
sf_cmd_type=$(type -t $sf_cmd)
if [[ $sf_cmd_type == "alias" ]]; then
sf_cmd=$(alias $sf_cmd | sed -E "s/alias $sf_cmd='(.*)'/\1/")
elif [[ $sf_cmd_type == "file" ]]; then
sf_cmd=$(type -p $sf_cmd)
fi
if [[ $sf_cmd_type != "function" && ! -x $sf_cmd ]]; then
return 1
fi
local cur prev words cword
_get_comp_words_by_ref -n := cur prev words cword
local completecmd=("$sf_cmd" "_complete" "--no-interaction" "-sbash" "-c$cword" "-S{{ VERSION }}")
for w in ${words[@]}; do
w=$(printf -- '%b' "$w")
# remove quotes from typed values
quote="${w:0:1}"
if [ "$quote" == \' ]; then
w="${w%\'}"
w="${w#\'}"
elif [ "$quote" == \" ]; then
w="${w%\"}"
w="${w#\"}"
fi
# empty values are ignored
if [ ! -z "$w" ]; then
completecmd+=("-i$w")
fi
done
local sfcomplete
if sfcomplete=$(${completecmd[@]} 2>&1); then
local quote suggestions
quote=${cur:0:1}
# Use single quotes by default if suggestions contains backslash (FQCN)
if [ "$quote" == '' ] && [[ "$sfcomplete" =~ \\ ]]; then
quote=\'
fi
if [ "$quote" == \' ]; then
# single quotes: no additional escaping (does not accept ' in values)
suggestions=$(for s in $sfcomplete; do printf $'%q%q%q\n' "$quote" "$s" "$quote"; done)
elif [ "$quote" == \" ]; then
# double quotes: double escaping for \ $ ` "
suggestions=$(for s in $sfcomplete; do
s=${s//\\/\\\\}
s=${s//\$/\\\$}
s=${s//\`/\\\`}
s=${s//\"/\\\"}
printf $'%q%q%q\n' "$quote" "$s" "$quote";
done)
else
# no quotes: double escaping
suggestions=$(for s in $sfcomplete; do printf $'%q\n' $(printf '%q' "$s"); done)
fi
COMPREPLY=($(IFS=$'\n' compgen -W "$suggestions" -- $(printf -- "%q" "$cur")))
__ltrim_colon_completions "$cur"
else
if [[ "$sfcomplete" != *"Command \"_complete\" is not defined."* ]]; then
>&2 echo
>&2 echo $sfcomplete
fi
return 1
fi
}
complete -F _sf_{{ COMMAND_NAME }} {{ COMMAND_NAME }}
MZ� �� � @ � � � �!�L�!This program cannot be run in DOS mode.
$ �,�;�B�;�B�;�B�2�מ:�B�2��-�B�2�ƞ9�B�2�ў?�B� a9�8�B�;�C��B�2�Ȟ:�B�2�֞:�B�2�Ӟ:�B�Rich;�B� PE L �MoO �
8 @ ` ?� @� �" P @ P p ! 8! @ � .text
`.rdata �
@ @.data � 0 @ �.rsrc @ @ @.reloc � P " @ B j$��@ �x j�� @ �e� ��E�PV� @ �EЃ�PV� @ �M�X @ �e� �E�P�5H @ �L @ YY�5\ @ �E�P�5` @ �D @ YY��P @ �M���M�T @ 3��H �;
0@ u��� h�@ � �l3@ �$40@ �5h3@ �40@ h$0@ h(0@ h 0@ �� @ ���00@ ��}j� Y�jh"@ � 3ۉ]�d� �p�]俀3@ SVW�0 @ ;�t;�u3�F�u��h� �4 @ ��3�F�|3@ ;�u
j �\ Y�;�|3@ ��u,�5|3@ h� @ h� @ � YY��t�E������� �� �5<0@ �|3@ ;�uh� @ h� @ �l YY�|3@ 9]�uSW�8 @ 9 �3@ th�3@ � Y��t
SjS��3@ �$0@ �
� @ ��5$0@ �5(0@ �5 0@ ������ �80@ 9 ,0@ u7P�� @ �E�� �M�PQ� YYËe�E�80@ 3�9 ,0@ uP�h @ 9 <0@ u�� @ �E������80@ � øMZ f9 @ t3��M�< @ �� @ �8PE u��H�� t�� uՃ�� v�3�9�� ��xtv�3�9�� ����j�,0@ �p @ j��l @ YY��3@ ��3@ �� @ �
t3@ ��� @ �
p3@ ��� @ � �x3@ �V � �=0@ u h�@ �� @ Y�g �=0@ �u j��� @ Y3���{ �����U���( �H1@ �
D1@ �@1@ � <1@ �581@ �=41@ f�`1@ f�
T1@ f� 01@ f�,1@ f�%(1@ f�-$1@ ��X1@ �E �L1@ �E�P1@ �E�\1@ ������0@ �P1@ �L0@ �@0@ ��D0@ � 0@ ������0@ ������ @ ��0@ j�? Yj � @ h !@ �$ @ �=�0@ uj� Yh ��( @ P�, @ �Ë�U��E� �8csm�u*�xu$�@= �t=!�t="�t= @�u�� 3�]� hH@ � @ 3��%� @ jh("@ �b �5�3@ �5� @ ��Y�E��u �u�� @ Y�gj� Y�e� �5�3@ �։E�5�3@ ��YY�E�E�P�E�P�u�5l @ ��YP�U �E�u�֣�3@ �u�փ���3@ �E������ �E�� �j� YË�U��u�N��������YH]Ë�V��!@ ��!@ W��;�s���t�Ѓ�;�r�_^Ë�V�"@ �"@ W��;�s���t�Ѓ�;�r�_^�%� @ ���̋�U��M�MZ f9t3�]ËA<��8PE u�3ҹ f9H��]�����������̋�U��E�H<��ASV�q3�W�D��v�} �H ;�r �X�;�r
B��(;�r�3�_^[]������������̋�U��j�hH"@ he@ d� P��SVW� 0@ 1E�3�P�E�d� �e��E� h @ �*�������tU�E- @ Ph @ �P�������t;�@$�� �Ѓ��E������M�d�
Y_^[��]ËE��3�= ���Ëe��E�����3��M�d�
Y_^[��]��%� @ �%� @ ��he@ d�5 �D$�l$�l$+�SVW� 0@ 1E�3�P�e�u��E��E������E��E�d� ËM�d�
Y__^[��]Q�U��u�u�u �uh�@ h 0@ �� ��]�Vh h 3�V�� �� ��t
VVVVV�� ��^�3��U���� 0@ �e� �e� SW�N�@�� ��;�t
��t �У0@ �`V�E�P�< @ �u�3u�� @ 3� @ 3� @ 3�E�P� @ �E�3E�3�;�u�O�@�� ��u��� �5 0@ �։50@ ^_[��%t @ �%x @ �%| @ �%� @ �%� @ �%� @ �%� @ �%� @ �%� @ Pd�5 �D$ +d$ SVW�(�� 0@ 3�P�E�u��E������E�d� ËM�d�
Y__^[��]QËM�3���������M�%T @ �T$�B �J�3�����J�3�����l"@ �s��� �# �# �# �) r) b) H) 4) ) �( �( �( �( �( �( �) �# �$ % �% & d& �& �$ (' �' �' �' �' ( (( 6( �' H( Z( t( �( ' ' ' �' �' l' ^' R' F' >' >( 0' �' �) �@ W@ �@ �MoO l �! � @0@ �0@ bad allocation H 0@ �!@ RSDSь���J�!���LZ c:\users\seld\documents\visual studio 2010\Projects\hiddeninp\Release\hiddeninp.pdb e � ���� ��� ����@ @ ���� ��� ���� :@ ���� ��� �����@ �@ �����@ "� d"@ �" �# $# �& D H# ( h �# �# �# �) r) b) H) 4) ) �( �( �( �( �( �( �) �# �$ % �% & d& �& �$ (' �' �' �' �' ( (( 6( �' H( Z( t( �( ' ' ' �' �' l' ^' R' F' >' >( 0' �' �) �GetConsoleMode �SetConsoleMode ;GetStdHandle KERNEL32.dll ??$?6DU?$char_traits@D@std@@V?$allocator@D@1@@std@@YAAAV?$basic_ostream@DU?$char_traits@D@std@@@0@AAV10@ABV?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@0@@Z �?cout@std@@3V?$basic_ostream@DU?$char_traits@D@std@@@1@A J?cin@std@@3V?$basic_istream@DU?$char_traits@D@std@@@1@A � ??$getline@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@YAAAV?$basic_istream@DU?$char_traits@D@std@@@0@AAV10@AAV?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@0@@Z ??6?$basic_ostream@DU?$char_traits@D@std@@@std@@QAEAAV01@P6AAAV01@AAV01@@Z@Z _??1?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@QAE@XZ {??0?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@QAE@XZ �?endl@std@@YAAAV?$basic_ostream@DU?$char_traits@D@std@@@1@AAV21@@Z MSVCP90.dll _amsg_exit � __getmainargs ,_cexit |_exit f _XcptFilter �exit � __initenv _initterm _initterm_e <_configthreadlocale � __setusermatherr _adjust_fdiv � __p__commode � __p__fmode j_encode_pointer � __set_app_type K_crt_debugger_hook C ?terminate@@YAXXZ MSVCR90.dll �_unlock � __dllonexit v_lock _onexit `_decode_pointer s_except_handler4_common _invoke_watson ?_controlfp_s �InterlockedExchange !Sleep �InterlockedCompareExchange -TerminateProcess �GetCurrentProcess >UnhandledExceptionFilter SetUnhandledExceptionFilter �IsDebuggerPresent TQueryPerformanceCounter fGetTickCount �GetCurrentThreadId �GetCurrentProcessId OGetSystemTimeAsFileTime s __CxxFrameHandler3 N�@���D������������ $!@ � 8 � P � h � � � �@ ( � �C V � (4 V S _ V E R S I O N _ I N F O �� � S t r i n g F i l e I n f o b 0 4 0 9 0 4 b 0 � Q F i l e D e s c r i p t i o n R e a d s f r o m s t d i n w i t h o u t l e a k i n g i n f o t o t h e t e r m i n a l a n d o u t p u t s b a c k t o s t d o u t 6 F i l e V e r s i o n 1 , 0 , 0 , 0 8 I n t e r n a l N a m e h i d d e n i n p u t P L e g a l C o p y r i g h t J o r d i B o g g i a n o - 2 0 1 2 H O r i g i n a l F i l e n a m e h i d d e n i n p u t . e x e :
P r o d u c t N a m e H i d d e n I n p u t : P r o d u c t V e r s i o n 1 , 0 , 0 , 0 D V a r F i l e I n f o $ T r a n s l a t i o n �<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
<trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
<security>
<requestedPrivileges>
<requestedExecutionLevel level="asInvoker" uiAccess="false"></requestedExecutionLevel>
</requestedPrivileges>
</security>
</trustInfo>
<dependency>
<dependentAssembly>
<assemblyIdentity type="win32" name="Microsoft.VC90.CRT" version="9.0.21022.8" processorArchitecture="x86" publicKeyToken="1fc8b3b9a1e18e3b"></assemblyIdentity>
</dependentAssembly>
</dependency>
</assembly>PAPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDINGPADDINGXXPADDING @ 00!0/080F0L0T0^0d0n0{0�0�0�0�0�0�0�0�0�0�0�0�0�01#1-1@1J1O1T1v1{1�1�1�1�1�1�1�1�1�1�1�1�1�1�12"2*23292A2M2_2j2p2�2�2�2�2�2�2�2�2�2�2�2 333%303N3T3Z3`3f3l3s3z3�3�3�3�3�3�3�3�3�3�3�3�3�3�3�3�3444 4%4;4B4�4�4�4�4�4�4�4�4�4�45!5^5c5�5�5�5H6M6_6}6�6�6 77
7*7w7|7�7�7�7�78
88=8E8P8V8\8b8h8n8t8z8�8�8�89 $ �0�0�0 1 1t1x1 2 2@2\2`2h2t2 0 0 <?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* @author Pierre du Plessis <pdples@gmail.com>
*/
final class Cursor
{
private $output;
private $input;
/**
* @param resource|null $input
*/
public function __construct(OutputInterface $output, $input = null)
{
$this->output = $output;
$this->input = $input ?? (\defined('STDIN') ? \STDIN : \fopen('php://input', 'r+'));
}
/**
* @return $this
*/
public function moveUp(int $lines = 1) : self
{
$this->output->write(\sprintf("\x1b[%dA", $lines));
return $this;
}
/**
* @return $this
*/
public function moveDown(int $lines = 1) : self
{
$this->output->write(\sprintf("\x1b[%dB", $lines));
return $this;
}
/**
* @return $this
*/
public function moveRight(int $columns = 1) : self
{
$this->output->write(\sprintf("\x1b[%dC", $columns));
return $this;
}
/**
* @return $this
*/
public function moveLeft(int $columns = 1) : self
{
$this->output->write(\sprintf("\x1b[%dD", $columns));
return $this;
}
/**
* @return $this
*/
public function moveToColumn(int $column) : self
{
$this->output->write(\sprintf("\x1b[%dG", $column));
return $this;
}
/**
* @return $this
*/
public function moveToPosition(int $column, int $row) : self
{
$this->output->write(\sprintf("\x1b[%d;%dH", $row + 1, $column));
return $this;
}
/**
* @return $this
*/
public function savePosition() : self
{
$this->output->write("\x1b7");
return $this;
}
/**
* @return $this
*/
public function restorePosition() : self
{
$this->output->write("\x1b8");
return $this;
}
/**
* @return $this
*/
public function hide() : self
{
$this->output->write("\x1b[?25l");
return $this;
}
/**
* @return $this
*/
public function show() : self
{
$this->output->write("\x1b[?25h\x1b[?0c");
return $this;
}
/**
* Clears all the output from the current line.
*
* @return $this
*/
public function clearLine() : self
{
$this->output->write("\x1b[2K");
return $this;
}
/**
* Clears all the output from the current line after the current position.
*/
public function clearLineAfter() : self
{
$this->output->write("\x1b[K");
return $this;
}
/**
* Clears all the output from the cursors' current position to the end of the screen.
*
* @return $this
*/
public function clearOutput() : self
{
$this->output->write("\x1b[0J");
return $this;
}
/**
* Clears the entire screen.
*
* @return $this
*/
public function clearScreen() : self
{
$this->output->write("\x1b[2J");
return $this;
}
/**
* Returns the current cursor position as x,y coordinates.
*/
public function getCurrentPosition() : array
{
static $isTtySupported;
if (null === $isTtySupported && \function_exists('proc_open')) {
$isTtySupported = (bool) @\proc_open('echo 1 >/dev/null', [['file', '/dev/tty', 'r'], ['file', '/dev/tty', 'w'], ['file', '/dev/tty', 'w']], $pipes);
}
if (!$isTtySupported) {
return [1, 1];
}
$sttyMode = \shell_exec('stty -g');
\shell_exec('stty -icanon -echo');
@\fwrite($this->input, "\x1b[6n");
$code = \trim(\fread($this->input, 1024));
\shell_exec(\sprintf('stty %s', $sttyMode));
\sscanf($code, "\x1b[%d;%dR", $row, $col);
return [$col, $row];
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Attribute;
/**
* Service tag to autoconfigure commands.
*/
#[\Attribute(\Attribute::TARGET_CLASS)]
class AsCommand
{
public function __construct(public string $name, public ?string $description = null, array $aliases = [], bool $hidden = \false)
{
if (!$hidden && !$aliases) {
return;
}
$name = \explode('|', $name);
$name = \array_merge($name, $aliases);
if ($hidden && '' !== $name[0]) {
\array_unshift($name, '');
}
$this->name = \implode('|', $name);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Completion;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\RuntimeException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\ArgvInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputDefinition;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
/**
* An input specialized for shell completion.
*
* This input allows unfinished option names or values and exposes what kind of
* completion is expected.
*
* @author Wouter de Jong <wouter@wouterj.nl>
*/
final class CompletionInput extends ArgvInput
{
public const TYPE_ARGUMENT_VALUE = 'argument_value';
public const TYPE_OPTION_VALUE = 'option_value';
public const TYPE_OPTION_NAME = 'option_name';
public const TYPE_NONE = 'none';
private $tokens;
private $currentIndex;
private $completionType;
private $completionName = null;
private $completionValue = '';
/**
* Converts a terminal string into tokens.
*
* This is required for shell completions without COMP_WORDS support.
*/
public static function fromString(string $inputStr, int $currentIndex) : self
{
\preg_match_all('/(?<=^|\\s)([\'"]?)(.+?)(?<!\\\\)\\1(?=$|\\s)/', $inputStr, $tokens);
return self::fromTokens($tokens[0], $currentIndex);
}
/**
* Create an input based on an COMP_WORDS token list.
*
* @param string[] $tokens the set of split tokens (e.g. COMP_WORDS or argv)
* @param int $currentIndex the index of the cursor (e.g. COMP_CWORD)
*/
public static function fromTokens(array $tokens, int $currentIndex) : self
{
$input = new self($tokens);
$input->tokens = $tokens;
$input->currentIndex = $currentIndex;
return $input;
}
/**
* {@inheritdoc}
*/
public function bind(InputDefinition $definition) : void
{
parent::bind($definition);
$relevantToken = $this->getRelevantToken();
if ('-' === $relevantToken[0]) {
// the current token is an input option: complete either option name or option value
[$optionToken, $optionValue] = \explode('=', $relevantToken, 2) + ['', ''];
$option = $this->getOptionFromToken($optionToken);
if (null === $option && !$this->isCursorFree()) {
$this->completionType = self::TYPE_OPTION_NAME;
$this->completionValue = $relevantToken;
return;
}
if (null !== $option && $option->acceptValue()) {
$this->completionType = self::TYPE_OPTION_VALUE;
$this->completionName = $option->getName();
$this->completionValue = $optionValue ?: (!\str_starts_with($optionToken, '--') ? \substr($optionToken, 2) : '');
return;
}
}
$previousToken = $this->tokens[$this->currentIndex - 1];
if ('-' === $previousToken[0] && '' !== \trim($previousToken, '-')) {
// check if previous option accepted a value
$previousOption = $this->getOptionFromToken($previousToken);
if (null !== $previousOption && $previousOption->acceptValue()) {
$this->completionType = self::TYPE_OPTION_VALUE;
$this->completionName = $previousOption->getName();
$this->completionValue = $relevantToken;
return;
}
}
// complete argument value
$this->completionType = self::TYPE_ARGUMENT_VALUE;
foreach ($this->definition->getArguments() as $argumentName => $argument) {
if (!isset($this->arguments[$argumentName])) {
break;
}
$argumentValue = $this->arguments[$argumentName];
$this->completionName = $argumentName;
if (\is_array($argumentValue)) {
$this->completionValue = $argumentValue ? $argumentValue[\array_key_last($argumentValue)] : null;
} else {
$this->completionValue = $argumentValue;
}
}
if ($this->currentIndex >= \count($this->tokens)) {
if (!isset($this->arguments[$argumentName]) || $this->definition->getArgument($argumentName)->isArray()) {
$this->completionName = $argumentName;
$this->completionValue = '';
} else {
// we've reached the end
$this->completionType = self::TYPE_NONE;
$this->completionName = null;
$this->completionValue = '';
}
}
}
/**
* Returns the type of completion required.
*
* TYPE_ARGUMENT_VALUE when completing the value of an input argument
* TYPE_OPTION_VALUE when completing the value of an input option
* TYPE_OPTION_NAME when completing the name of an input option
* TYPE_NONE when nothing should be completed
*
* @return string One of self::TYPE_* constants. TYPE_OPTION_NAME and TYPE_NONE are already implemented by the Console component
*/
public function getCompletionType() : string
{
return $this->completionType;
}
/**
* The name of the input option or argument when completing a value.
*
* @return string|null returns null when completing an option name
*/
public function getCompletionName() : ?string
{
return $this->completionName;
}
/**
* The value already typed by the user (or empty string).
*/
public function getCompletionValue() : string
{
return $this->completionValue;
}
public function mustSuggestOptionValuesFor(string $optionName) : bool
{
return self::TYPE_OPTION_VALUE === $this->getCompletionType() && $optionName === $this->getCompletionName();
}
public function mustSuggestArgumentValuesFor(string $argumentName) : bool
{
return self::TYPE_ARGUMENT_VALUE === $this->getCompletionType() && $argumentName === $this->getCompletionName();
}
protected function parseToken(string $token, bool $parseOptions) : bool
{
try {
return parent::parseToken($token, $parseOptions);
} catch (RuntimeException $e) {
// suppress errors, completed input is almost never valid
}
return $parseOptions;
}
private function getOptionFromToken(string $optionToken) : ?InputOption
{
$optionName = \ltrim($optionToken, '-');
if (!$optionName) {
return null;
}
if ('-' === ($optionToken[1] ?? ' ')) {
// long option name
return $this->definition->hasOption($optionName) ? $this->definition->getOption($optionName) : null;
}
// short option name
return $this->definition->hasShortcut($optionName[0]) ? $this->definition->getOptionForShortcut($optionName[0]) : null;
}
/**
* The token of the cursor, or the last token if the cursor is at the end of the input.
*/
private function getRelevantToken() : string
{
return $this->tokens[$this->isCursorFree() ? $this->currentIndex - 1 : $this->currentIndex];
}
/**
* Whether the cursor is "free" (i.e. at the end of the input preceded by a space).
*/
private function isCursorFree() : bool
{
$nrOfTokens = \count($this->tokens);
if ($this->currentIndex > $nrOfTokens) {
throw new \LogicException('Current index is invalid, it must be the number of input tokens or one more.');
}
return $this->currentIndex >= $nrOfTokens;
}
public function __toString()
{
$str = '';
foreach ($this->tokens as $i => $token) {
$str .= $token;
if ($this->currentIndex === $i) {
$str .= '|';
}
$str .= ' ';
}
if ($this->currentIndex > $i) {
$str .= '|';
}
return \rtrim($str);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Completion;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
/**
* Stores all completion suggestions for the current input.
*
* @author Wouter de Jong <wouter@wouterj.nl>
*/
final class CompletionSuggestions
{
private $valueSuggestions = [];
private $optionSuggestions = [];
/**
* Add a suggested value for an input option or argument.
*
* @param string|Suggestion $value
*
* @return $this
*/
public function suggestValue($value) : self
{
$this->valueSuggestions[] = !$value instanceof Suggestion ? new Suggestion($value) : $value;
return $this;
}
/**
* Add multiple suggested values at once for an input option or argument.
*
* @param list<string|Suggestion> $values
*
* @return $this
*/
public function suggestValues(array $values) : self
{
foreach ($values as $value) {
$this->suggestValue($value);
}
return $this;
}
/**
* Add a suggestion for an input option name.
*
* @return $this
*/
public function suggestOption(InputOption $option) : self
{
$this->optionSuggestions[] = $option;
return $this;
}
/**
* Add multiple suggestions for input option names at once.
*
* @param InputOption[] $options
*
* @return $this
*/
public function suggestOptions(array $options) : self
{
foreach ($options as $option) {
$this->suggestOption($option);
}
return $this;
}
/**
* @return InputOption[]
*/
public function getOptionSuggestions() : array
{
return $this->optionSuggestions;
}
/**
* @return Suggestion[]
*/
public function getValueSuggestions() : array
{
return $this->valueSuggestions;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Completion\Output;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionSuggestions;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* Transforms the {@see CompletionSuggestions} object into output readable by the shell completion.
*
* @author Wouter de Jong <wouter@wouterj.nl>
*/
interface CompletionOutputInterface
{
public function write(CompletionSuggestions $suggestions, OutputInterface $output) : void;
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Completion\Output;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionSuggestions;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* @author Wouter de Jong <wouter@wouterj.nl>
*/
class BashCompletionOutput implements CompletionOutputInterface
{
public function write(CompletionSuggestions $suggestions, OutputInterface $output) : void
{
$values = $suggestions->getValueSuggestions();
foreach ($suggestions->getOptionSuggestions() as $option) {
$values[] = '--' . $option->getName();
if ($option->isNegatable()) {
$values[] = '--no-' . $option->getName();
}
}
$output->writeln(\implode("\n", $values));
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Completion;
/**
* Represents a single suggested value.
*
* @author Wouter de Jong <wouter@wouterj.nl>
*/
class Suggestion
{
private $value;
public function __construct(string $value)
{
$this->value = $value;
}
public function getValue() : string
{
return $this->value;
}
public function __toString() : string
{
return $this->getValue();
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Style;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\RuntimeException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\ProgressBar;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\SymfonyQuestionHelper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\Table;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\TableCell;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\TableSeparator;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\TrimmedBufferOutput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Question\ChoiceQuestion;
use _PHPStan_6dcda722c\Symfony\Component\Console\Question\ConfirmationQuestion;
use _PHPStan_6dcda722c\Symfony\Component\Console\Question\Question;
use _PHPStan_6dcda722c\Symfony\Component\Console\Terminal;
/**
* Output decorator helpers for the Symfony Style Guide.
*
* @author Kevin Bond <kevinbond@gmail.com>
*/
class SymfonyStyle extends OutputStyle
{
public const MAX_LINE_LENGTH = 120;
private $input;
private $output;
private $questionHelper;
private $progressBar;
private $lineLength;
private $bufferedOutput;
public function __construct(InputInterface $input, OutputInterface $output)
{
$this->input = $input;
$this->bufferedOutput = new TrimmedBufferOutput(\DIRECTORY_SEPARATOR === '\\' ? 4 : 2, $output->getVerbosity(), \false, clone $output->getFormatter());
// Windows cmd wraps lines as soon as the terminal width is reached, whether there are following chars or not.
$width = (new Terminal())->getWidth() ?: self::MAX_LINE_LENGTH;
$this->lineLength = \min($width - (int) (\DIRECTORY_SEPARATOR === '\\'), self::MAX_LINE_LENGTH);
parent::__construct($this->output = $output);
}
/**
* Formats a message as a block of text.
*
* @param string|array $messages The message to write in the block
*/
public function block($messages, ?string $type = null, ?string $style = null, string $prefix = ' ', bool $padding = \false, bool $escape = \true)
{
$messages = \is_array($messages) ? \array_values($messages) : [$messages];
$this->autoPrependBlock();
$this->writeln($this->createBlock($messages, $type, $style, $prefix, $padding, $escape));
$this->newLine();
}
/**
* {@inheritdoc}
*/
public function title(string $message)
{
$this->autoPrependBlock();
$this->writeln([\sprintf('<comment>%s</>', OutputFormatter::escapeTrailingBackslash($message)), \sprintf('<comment>%s</>', \str_repeat('=', Helper::width(Helper::removeDecoration($this->getFormatter(), $message))))]);
$this->newLine();
}
/**
* {@inheritdoc}
*/
public function section(string $message)
{
$this->autoPrependBlock();
$this->writeln([\sprintf('<comment>%s</>', OutputFormatter::escapeTrailingBackslash($message)), \sprintf('<comment>%s</>', \str_repeat('-', Helper::width(Helper::removeDecoration($this->getFormatter(), $message))))]);
$this->newLine();
}
/**
* {@inheritdoc}
*/
public function listing(array $elements)
{
$this->autoPrependText();
$elements = \array_map(function ($element) {
return \sprintf(' * %s', $element);
}, $elements);
$this->writeln($elements);
$this->newLine();
}
/**
* {@inheritdoc}
*/
public function text($message)
{
$this->autoPrependText();
$messages = \is_array($message) ? \array_values($message) : [$message];
foreach ($messages as $message) {
$this->writeln(\sprintf(' %s', $message));
}
}
/**
* Formats a command comment.
*
* @param string|array $message
*/
public function comment($message)
{
$this->block($message, null, null, '<fg=default;bg=default> // </>', \false, \false);
}
/**
* {@inheritdoc}
*/
public function success($message)
{
$this->block($message, 'OK', 'fg=black;bg=green', ' ', \true);
}
/**
* {@inheritdoc}
*/
public function error($message)
{
$this->block($message, 'ERROR', 'fg=white;bg=red', ' ', \true);
}
/**
* {@inheritdoc}
*/
public function warning($message)
{
$this->block($message, 'WARNING', 'fg=black;bg=yellow', ' ', \true);
}
/**
* {@inheritdoc}
*/
public function note($message)
{
$this->block($message, 'NOTE', 'fg=yellow', ' ! ');
}
/**
* Formats an info message.
*
* @param string|array $message
*/
public function info($message)
{
$this->block($message, 'INFO', 'fg=green', ' ', \true);
}
/**
* {@inheritdoc}
*/
public function caution($message)
{
$this->block($message, 'CAUTION', 'fg=white;bg=red', ' ! ', \true);
}
/**
* {@inheritdoc}
*/
public function table(array $headers, array $rows)
{
$this->createTable()->setHeaders($headers)->setRows($rows)->render();
$this->newLine();
}
/**
* Formats a horizontal table.
*/
public function horizontalTable(array $headers, array $rows)
{
$this->createTable()->setHorizontal(\true)->setHeaders($headers)->setRows($rows)->render();
$this->newLine();
}
/**
* Formats a list of key/value horizontally.
*
* Each row can be one of:
* * 'A title'
* * ['key' => 'value']
* * new TableSeparator()
*
* @param string|array|TableSeparator ...$list
*/
public function definitionList(...$list)
{
$headers = [];
$row = [];
foreach ($list as $value) {
if ($value instanceof TableSeparator) {
$headers[] = $value;
$row[] = $value;
continue;
}
if (\is_string($value)) {
$headers[] = new TableCell($value, ['colspan' => 2]);
$row[] = null;
continue;
}
if (!\is_array($value)) {
throw new InvalidArgumentException('Value should be an array, string, or an instance of TableSeparator.');
}
$headers[] = \key($value);
$row[] = \current($value);
}
$this->horizontalTable($headers, [$row]);
}
/**
* {@inheritdoc}
*/
public function ask(string $question, ?string $default = null, ?callable $validator = null)
{
$question = new Question($question, $default);
$question->setValidator($validator);
return $this->askQuestion($question);
}
/**
* {@inheritdoc}
*/
public function askHidden(string $question, ?callable $validator = null)
{
$question = new Question($question);
$question->setHidden(\true);
$question->setValidator($validator);
return $this->askQuestion($question);
}
/**
* {@inheritdoc}
*/
public function confirm(string $question, bool $default = \true)
{
return $this->askQuestion(new ConfirmationQuestion($question, $default));
}
/**
* {@inheritdoc}
*/
public function choice(string $question, array $choices, $default = null)
{
if (null !== $default) {
$values = \array_flip($choices);
$default = $values[$default] ?? $default;
}
return $this->askQuestion(new ChoiceQuestion($question, $choices, $default));
}
/**
* {@inheritdoc}
*/
public function progressStart(int $max = 0)
{
$this->progressBar = $this->createProgressBar($max);
$this->progressBar->start();
}
/**
* {@inheritdoc}
*/
public function progressAdvance(int $step = 1)
{
$this->getProgressBar()->advance($step);
}
/**
* {@inheritdoc}
*/
public function progressFinish()
{
$this->getProgressBar()->finish();
$this->newLine(2);
$this->progressBar = null;
}
/**
* {@inheritdoc}
*/
public function createProgressBar(int $max = 0)
{
$progressBar = parent::createProgressBar($max);
if ('\\' !== \DIRECTORY_SEPARATOR || 'Hyper' === \getenv('TERM_PROGRAM')) {
$progressBar->setEmptyBarCharacter('░');
// light shade character \u2591
$progressBar->setProgressCharacter('');
$progressBar->setBarCharacter('▓');
// dark shade character \u2593
}
return $progressBar;
}
/**
* @see ProgressBar::iterate()
*/
public function progressIterate(iterable $iterable, ?int $max = null) : iterable
{
yield from $this->createProgressBar()->iterate($iterable, $max);
$this->newLine(2);
}
/**
* @return mixed
*/
public function askQuestion(Question $question)
{
if ($this->input->isInteractive()) {
$this->autoPrependBlock();
}
if (!$this->questionHelper) {
$this->questionHelper = new SymfonyQuestionHelper();
}
$answer = $this->questionHelper->ask($this->input, $this, $question);
if ($this->input->isInteractive()) {
$this->newLine();
$this->bufferedOutput->write("\n");
}
return $answer;
}
/**
* {@inheritdoc}
*/
public function writeln($messages, int $type = self::OUTPUT_NORMAL)
{
if (!\is_iterable($messages)) {
$messages = [$messages];
}
foreach ($messages as $message) {
parent::writeln($message, $type);
$this->writeBuffer($message, \true, $type);
}
}
/**
* {@inheritdoc}
*/
public function write($messages, bool $newline = \false, int $type = self::OUTPUT_NORMAL)
{
if (!\is_iterable($messages)) {
$messages = [$messages];
}
foreach ($messages as $message) {
parent::write($message, $newline, $type);
$this->writeBuffer($message, $newline, $type);
}
}
/**
* {@inheritdoc}
*/
public function newLine(int $count = 1)
{
parent::newLine($count);
$this->bufferedOutput->write(\str_repeat("\n", $count));
}
/**
* Returns a new instance which makes use of stderr if available.
*
* @return self
*/
public function getErrorStyle()
{
return new self($this->input, $this->getErrorOutput());
}
public function createTable() : Table
{
$output = $this->output instanceof ConsoleOutputInterface ? $this->output->section() : $this->output;
$style = clone Table::getStyleDefinition('symfony-style-guide');
$style->setCellHeaderFormat('<info>%s</info>');
return (new Table($output))->setStyle($style);
}
private function getProgressBar() : ProgressBar
{
if (!$this->progressBar) {
throw new RuntimeException('The ProgressBar is not started.');
}
return $this->progressBar;
}
private function autoPrependBlock() : void
{
$chars = \substr(\str_replace(\PHP_EOL, "\n", $this->bufferedOutput->fetch()), -2);
if (!isset($chars[0])) {
$this->newLine();
// empty history, so we should start with a new line.
return;
}
// Prepend new line for each non LF chars (This means no blank line was output before)
$this->newLine(2 - \substr_count($chars, "\n"));
}
private function autoPrependText() : void
{
$fetched = $this->bufferedOutput->fetch();
// Prepend new line if last char isn't EOL:
if (!\str_ends_with($fetched, "\n")) {
$this->newLine();
}
}
private function writeBuffer(string $message, bool $newLine, int $type) : void
{
// We need to know if the last chars are PHP_EOL
$this->bufferedOutput->write($message, $newLine, $type);
}
private function createBlock(iterable $messages, ?string $type = null, ?string $style = null, string $prefix = ' ', bool $padding = \false, bool $escape = \false) : array
{
$indentLength = 0;
$prefixLength = Helper::width(Helper::removeDecoration($this->getFormatter(), $prefix));
$lines = [];
if (null !== $type) {
$type = \sprintf('[%s] ', $type);
$indentLength = \strlen($type);
$lineIndentation = \str_repeat(' ', $indentLength);
}
// wrap and add newlines for each element
foreach ($messages as $key => $message) {
if ($escape) {
$message = OutputFormatter::escape($message);
}
$decorationLength = Helper::width($message) - Helper::width(Helper::removeDecoration($this->getFormatter(), $message));
$messageLineLength = \min($this->lineLength - $prefixLength - $indentLength + $decorationLength, $this->lineLength);
$messageLines = \explode(\PHP_EOL, \wordwrap($message, $messageLineLength, \PHP_EOL, \true));
foreach ($messageLines as $messageLine) {
$lines[] = $messageLine;
}
if (\count($messages) > 1 && $key < \count($messages) - 1) {
$lines[] = '';
}
}
$firstLineIndex = 0;
if ($padding && $this->isDecorated()) {
$firstLineIndex = 1;
\array_unshift($lines, '');
$lines[] = '';
}
foreach ($lines as $i => &$line) {
if (null !== $type) {
$line = $firstLineIndex === $i ? $type . $line : $lineIndentation . $line;
}
$line = $prefix . $line;
$line .= \str_repeat(' ', \max($this->lineLength - Helper::width(Helper::removeDecoration($this->getFormatter(), $line)), 0));
if ($style) {
$line = \sprintf('<%s>%s</>', $style, $line);
}
}
return $lines;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Style;
/**
* Output style helpers.
*
* @author Kevin Bond <kevinbond@gmail.com>
*/
interface StyleInterface
{
/**
* Formats a command title.
*/
public function title(string $message);
/**
* Formats a section title.
*/
public function section(string $message);
/**
* Formats a list.
*/
public function listing(array $elements);
/**
* Formats informational text.
*
* @param string|array $message
*/
public function text($message);
/**
* Formats a success result bar.
*
* @param string|array $message
*/
public function success($message);
/**
* Formats an error result bar.
*
* @param string|array $message
*/
public function error($message);
/**
* Formats an warning result bar.
*
* @param string|array $message
*/
public function warning($message);
/**
* Formats a note admonition.
*
* @param string|array $message
*/
public function note($message);
/**
* Formats a caution admonition.
*
* @param string|array $message
*/
public function caution($message);
/**
* Formats a table.
*/
public function table(array $headers, array $rows);
/**
* Asks a question.
*
* @return mixed
*/
public function ask(string $question, ?string $default = null, ?callable $validator = null);
/**
* Asks a question with the user input hidden.
*
* @return mixed
*/
public function askHidden(string $question, ?callable $validator = null);
/**
* Asks for confirmation.
*
* @return bool
*/
public function confirm(string $question, bool $default = \true);
/**
* Asks a choice question.
*
* @param string|int|null $default
*
* @return mixed
*/
public function choice(string $question, array $choices, $default = null);
/**
* Add newline(s).
*/
public function newLine(int $count = 1);
/**
* Starts the progress output.
*/
public function progressStart(int $max = 0);
/**
* Advances the progress output X steps.
*/
public function progressAdvance(int $step = 1);
/**
* Finishes the progress output.
*/
public function progressFinish();
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Style;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatterInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\ProgressBar;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* Decorates output to add console style guide helpers.
*
* @author Kevin Bond <kevinbond@gmail.com>
*/
abstract class OutputStyle implements OutputInterface, StyleInterface
{
private $output;
public function __construct(OutputInterface $output)
{
$this->output = $output;
}
/**
* {@inheritdoc}
*/
public function newLine(int $count = 1)
{
$this->output->write(\str_repeat(\PHP_EOL, $count));
}
/**
* @return ProgressBar
*/
public function createProgressBar(int $max = 0)
{
return new ProgressBar($this->output, $max);
}
/**
* {@inheritdoc}
*/
public function write($messages, bool $newline = \false, int $type = self::OUTPUT_NORMAL)
{
$this->output->write($messages, $newline, $type);
}
/**
* {@inheritdoc}
*/
public function writeln($messages, int $type = self::OUTPUT_NORMAL)
{
$this->output->writeln($messages, $type);
}
/**
* {@inheritdoc}
*/
public function setVerbosity(int $level)
{
$this->output->setVerbosity($level);
}
/**
* {@inheritdoc}
*/
public function getVerbosity()
{
return $this->output->getVerbosity();
}
/**
* {@inheritdoc}
*/
public function setDecorated(bool $decorated)
{
$this->output->setDecorated($decorated);
}
/**
* {@inheritdoc}
*/
public function isDecorated()
{
return $this->output->isDecorated();
}
/**
* {@inheritdoc}
*/
public function setFormatter(OutputFormatterInterface $formatter)
{
$this->output->setFormatter($formatter);
}
/**
* {@inheritdoc}
*/
public function getFormatter()
{
return $this->output->getFormatter();
}
/**
* {@inheritdoc}
*/
public function isQuiet()
{
return $this->output->isQuiet();
}
/**
* {@inheritdoc}
*/
public function isVerbose()
{
return $this->output->isVerbose();
}
/**
* {@inheritdoc}
*/
public function isVeryVerbose()
{
return $this->output->isVeryVerbose();
}
/**
* {@inheritdoc}
*/
public function isDebug()
{
return $this->output->isDebug();
}
protected function getErrorOutput()
{
if (!$this->output instanceof ConsoleOutputInterface) {
return $this->output;
}
return $this->output->getErrorOutput();
}
}
Copyright (c) 2004-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Command;
/**
* Interface for command reacting to signal.
*
* @author Grégoire Pineau <lyrixx@lyrix.info>
*/
interface SignalableCommandInterface
{
/**
* Returns the list of signals to subscribe.
*/
public function getSubscribedSignals() : array;
/**
* The method will be called when the application is signaled.
*/
public function handleSignal(int $signal) : void;
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Application;
use _PHPStan_6dcda722c\Symfony\Component\Console\Attribute\AsCommand;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionSuggestions;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\ExceptionInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\LogicException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\HelperSet;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputDefinition;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* Base class for all commands.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class Command
{
// see https://tldp.org/LDP/abs/html/exitcodes.html
public const SUCCESS = 0;
public const FAILURE = 1;
public const INVALID = 2;
/**
* @var string|null The default command name
*/
protected static $defaultName;
/**
* @var string|null The default command description
*/
protected static $defaultDescription;
private $application;
private $name;
private $processTitle;
private $aliases = [];
private $definition;
private $hidden = \false;
private $help = '';
private $description = '';
private $fullDefinition;
private $ignoreValidationErrors = \false;
private $code;
private $synopsis = [];
private $usages = [];
private $helperSet;
/**
* @return string|null
*/
public static function getDefaultName()
{
$class = static::class;
if (\PHP_VERSION_ID >= 80000 && ($attribute = (new \ReflectionClass($class))->getAttributes(AsCommand::class))) {
return $attribute[0]->newInstance()->name;
}
$r = new \ReflectionProperty($class, 'defaultName');
return $class === $r->class ? static::$defaultName : null;
}
public static function getDefaultDescription() : ?string
{
$class = static::class;
if (\PHP_VERSION_ID >= 80000 && ($attribute = (new \ReflectionClass($class))->getAttributes(AsCommand::class))) {
return $attribute[0]->newInstance()->description;
}
$r = new \ReflectionProperty($class, 'defaultDescription');
return $class === $r->class ? static::$defaultDescription : null;
}
/**
* @param string|null $name The name of the command; passing null means it must be set in configure()
*
* @throws LogicException When the command name is empty
*/
public function __construct(?string $name = null)
{
$this->definition = new InputDefinition();
if (null === $name && null !== ($name = static::getDefaultName())) {
$aliases = \explode('|', $name);
if ('' === ($name = \array_shift($aliases))) {
$this->setHidden(\true);
$name = \array_shift($aliases);
}
$this->setAliases($aliases);
}
if (null !== $name) {
$this->setName($name);
}
if ('' === $this->description) {
$this->setDescription(static::getDefaultDescription() ?? '');
}
$this->configure();
}
/**
* Ignores validation errors.
*
* This is mainly useful for the help command.
*/
public function ignoreValidationErrors()
{
$this->ignoreValidationErrors = \true;
}
public function setApplication(?Application $application = null)
{
$this->application = $application;
if ($application) {
$this->setHelperSet($application->getHelperSet());
} else {
$this->helperSet = null;
}
$this->fullDefinition = null;
}
public function setHelperSet(HelperSet $helperSet)
{
$this->helperSet = $helperSet;
}
/**
* Gets the helper set.
*
* @return HelperSet|null
*/
public function getHelperSet()
{
return $this->helperSet;
}
/**
* Gets the application instance for this command.
*
* @return Application|null
*/
public function getApplication()
{
return $this->application;
}
/**
* Checks whether the command is enabled or not in the current environment.
*
* Override this to check for x or y and return false if the command cannot
* run properly under the current conditions.
*
* @return bool
*/
public function isEnabled()
{
return \true;
}
/**
* Configures the current command.
*/
protected function configure()
{
}
/**
* Executes the current command.
*
* This method is not abstract because you can use this class
* as a concrete class. In this case, instead of defining the
* execute() method, you set the code to execute by passing
* a Closure to the setCode() method.
*
* @return int 0 if everything went fine, or an exit code
*
* @throws LogicException When this abstract method is not implemented
*
* @see setCode()
*/
protected function execute(InputInterface $input, OutputInterface $output)
{
throw new LogicException('You must override the execute() method in the concrete command class.');
}
/**
* Interacts with the user.
*
* This method is executed before the InputDefinition is validated.
* This means that this is the only place where the command can
* interactively ask for values of missing required arguments.
*/
protected function interact(InputInterface $input, OutputInterface $output)
{
}
/**
* Initializes the command after the input has been bound and before the input
* is validated.
*
* This is mainly useful when a lot of commands extends one main command
* where some things need to be initialized based on the input arguments and options.
*
* @see InputInterface::bind()
* @see InputInterface::validate()
*/
protected function initialize(InputInterface $input, OutputInterface $output)
{
}
/**
* Runs the command.
*
* The code to execute is either defined directly with the
* setCode() method or by overriding the execute() method
* in a sub-class.
*
* @return int The command exit code
*
* @throws ExceptionInterface When input binding fails. Bypass this by calling {@link ignoreValidationErrors()}.
*
* @see setCode()
* @see execute()
*/
public function run(InputInterface $input, OutputInterface $output)
{
// add the application arguments and options
$this->mergeApplicationDefinition();
// bind the input against the command specific arguments/options
try {
$input->bind($this->getDefinition());
} catch (ExceptionInterface $e) {
if (!$this->ignoreValidationErrors) {
throw $e;
}
}
$this->initialize($input, $output);
if (null !== $this->processTitle) {
if (\function_exists('cli_set_process_title')) {
if (!@\cli_set_process_title($this->processTitle)) {
if ('Darwin' === \PHP_OS) {
$output->writeln('<comment>Running "cli_set_process_title" as an unprivileged user is not supported on MacOS.</comment>', OutputInterface::VERBOSITY_VERY_VERBOSE);
} else {
\cli_set_process_title($this->processTitle);
}
}
} elseif (\function_exists('_PHPStan_6dcda722c\\setproctitle')) {
setproctitle($this->processTitle);
} elseif (OutputInterface::VERBOSITY_VERY_VERBOSE === $output->getVerbosity()) {
$output->writeln('<comment>Install the proctitle PECL to be able to change the process title.</comment>');
}
}
if ($input->isInteractive()) {
$this->interact($input, $output);
}
// The command name argument is often omitted when a command is executed directly with its run() method.
// It would fail the validation if we didn't make sure the command argument is present,
// since it's required by the application.
if ($input->hasArgument('command') && null === $input->getArgument('command')) {
$input->setArgument('command', $this->getName());
}
$input->validate();
if ($this->code) {
$statusCode = ($this->code)($input, $output);
} else {
$statusCode = $this->execute($input, $output);
if (!\is_int($statusCode)) {
throw new \TypeError(\sprintf('Return value of "%s::execute()" must be of the type int, "%s" returned.', static::class, \get_debug_type($statusCode)));
}
}
return \is_numeric($statusCode) ? (int) $statusCode : 0;
}
/**
* Adds suggestions to $suggestions for the current completion input (e.g. option or argument).
*/
public function complete(CompletionInput $input, CompletionSuggestions $suggestions) : void
{
}
/**
* Sets the code to execute when running this command.
*
* If this method is used, it overrides the code defined
* in the execute() method.
*
* @param callable $code A callable(InputInterface $input, OutputInterface $output)
*
* @return $this
*
* @throws InvalidArgumentException
*
* @see execute()
*/
public function setCode(callable $code)
{
if ($code instanceof \Closure) {
$r = new \ReflectionFunction($code);
if (null === $r->getClosureThis()) {
\set_error_handler(static function () {
});
try {
if ($c = \Closure::bind($code, $this)) {
$code = $c;
}
} finally {
\restore_error_handler();
}
}
}
$this->code = $code;
return $this;
}
/**
* Merges the application definition with the command definition.
*
* This method is not part of public API and should not be used directly.
*
* @param bool $mergeArgs Whether to merge or not the Application definition arguments to Command definition arguments
*
* @internal
*/
public function mergeApplicationDefinition(bool $mergeArgs = \true)
{
if (null === $this->application) {
return;
}
$this->fullDefinition = new InputDefinition();
$this->fullDefinition->setOptions($this->definition->getOptions());
$this->fullDefinition->addOptions($this->application->getDefinition()->getOptions());
if ($mergeArgs) {
$this->fullDefinition->setArguments($this->application->getDefinition()->getArguments());
$this->fullDefinition->addArguments($this->definition->getArguments());
} else {
$this->fullDefinition->setArguments($this->definition->getArguments());
}
}
/**
* Sets an array of argument and option instances.
*
* @param array|InputDefinition $definition An array of argument and option instances or a definition instance
*
* @return $this
*/
public function setDefinition($definition)
{
if ($definition instanceof InputDefinition) {
$this->definition = $definition;
} else {
$this->definition->setDefinition($definition);
}
$this->fullDefinition = null;
return $this;
}
/**
* Gets the InputDefinition attached to this Command.
*
* @return InputDefinition
*/
public function getDefinition()
{
return $this->fullDefinition ?? $this->getNativeDefinition();
}
/**
* Gets the InputDefinition to be used to create representations of this Command.
*
* Can be overridden to provide the original command representation when it would otherwise
* be changed by merging with the application InputDefinition.
*
* This method is not part of public API and should not be used directly.
*
* @return InputDefinition
*/
public function getNativeDefinition()
{
if (null === $this->definition) {
throw new LogicException(\sprintf('Command class "%s" is not correctly initialized. You probably forgot to call the parent constructor.', static::class));
}
return $this->definition;
}
/**
* Adds an argument.
*
* @param int|null $mode The argument mode: InputArgument::REQUIRED or InputArgument::OPTIONAL
* @param mixed $default The default value (for InputArgument::OPTIONAL mode only)
*
* @return $this
*
* @throws InvalidArgumentException When argument mode is not valid
*/
public function addArgument(string $name, ?int $mode = null, string $description = '', $default = null)
{
$this->definition->addArgument(new InputArgument($name, $mode, $description, $default));
if (null !== $this->fullDefinition) {
$this->fullDefinition->addArgument(new InputArgument($name, $mode, $description, $default));
}
return $this;
}
/**
* Adds an option.
*
* @param string|array|null $shortcut The shortcuts, can be null, a string of shortcuts delimited by | or an array of shortcuts
* @param int|null $mode The option mode: One of the InputOption::VALUE_* constants
* @param mixed $default The default value (must be null for InputOption::VALUE_NONE)
*
* @return $this
*
* @throws InvalidArgumentException If option mode is invalid or incompatible
*/
public function addOption(string $name, $shortcut = null, ?int $mode = null, string $description = '', $default = null)
{
$this->definition->addOption(new InputOption($name, $shortcut, $mode, $description, $default));
if (null !== $this->fullDefinition) {
$this->fullDefinition->addOption(new InputOption($name, $shortcut, $mode, $description, $default));
}
return $this;
}
/**
* Sets the name of the command.
*
* This method can set both the namespace and the name if
* you separate them by a colon (:)
*
* $command->setName('foo:bar');
*
* @return $this
*
* @throws InvalidArgumentException When the name is invalid
*/
public function setName(string $name)
{
$this->validateName($name);
$this->name = $name;
return $this;
}
/**
* Sets the process title of the command.
*
* This feature should be used only when creating a long process command,
* like a daemon.
*
* @return $this
*/
public function setProcessTitle(string $title)
{
$this->processTitle = $title;
return $this;
}
/**
* Returns the command name.
*
* @return string|null
*/
public function getName()
{
return $this->name;
}
/**
* @param bool $hidden Whether or not the command should be hidden from the list of commands
* The default value will be true in Symfony 6.0
*
* @return $this
*
* @final since Symfony 5.1
*/
public function setHidden(bool $hidden)
{
$this->hidden = $hidden;
return $this;
}
/**
* @return bool whether the command should be publicly shown or not
*/
public function isHidden()
{
return $this->hidden;
}
/**
* Sets the description for the command.
*
* @return $this
*/
public function setDescription(string $description)
{
$this->description = $description;
return $this;
}
/**
* Returns the description for the command.
*
* @return string
*/
public function getDescription()
{
return $this->description;
}
/**
* Sets the help for the command.
*
* @return $this
*/
public function setHelp(string $help)
{
$this->help = $help;
return $this;
}
/**
* Returns the help for the command.
*
* @return string
*/
public function getHelp()
{
return $this->help;
}
/**
* Returns the processed help for the command replacing the %command.name% and
* %command.full_name% patterns with the real values dynamically.
*
* @return string
*/
public function getProcessedHelp()
{
$name = $this->name;
$isSingleCommand = $this->application && $this->application->isSingleCommand();
$placeholders = ['%command.name%', '%command.full_name%'];
$replacements = [$name, $isSingleCommand ? $_SERVER['PHP_SELF'] : $_SERVER['PHP_SELF'] . ' ' . $name];
return \str_replace($placeholders, $replacements, $this->getHelp() ?: $this->getDescription());
}
/**
* Sets the aliases for the command.
*
* @param string[] $aliases An array of aliases for the command
*
* @return $this
*
* @throws InvalidArgumentException When an alias is invalid
*/
public function setAliases(iterable $aliases)
{
$list = [];
foreach ($aliases as $alias) {
$this->validateName($alias);
$list[] = $alias;
}
$this->aliases = \is_array($aliases) ? $aliases : $list;
return $this;
}
/**
* Returns the aliases for the command.
*
* @return array
*/
public function getAliases()
{
return $this->aliases;
}
/**
* Returns the synopsis for the command.
*
* @param bool $short Whether to show the short version of the synopsis (with options folded) or not
*
* @return string
*/
public function getSynopsis(bool $short = \false)
{
$key = $short ? 'short' : 'long';
if (!isset($this->synopsis[$key])) {
$this->synopsis[$key] = \trim(\sprintf('%s %s', $this->name, $this->definition->getSynopsis($short)));
}
return $this->synopsis[$key];
}
/**
* Add a command usage example, it'll be prefixed with the command name.
*
* @return $this
*/
public function addUsage(string $usage)
{
if (!\str_starts_with($usage, $this->name)) {
$usage = \sprintf('%s %s', $this->name, $usage);
}
$this->usages[] = $usage;
return $this;
}
/**
* Returns alternative usages of the command.
*
* @return array
*/
public function getUsages()
{
return $this->usages;
}
/**
* Gets a helper instance by name.
*
* @return mixed
*
* @throws LogicException if no HelperSet is defined
* @throws InvalidArgumentException if the helper is not defined
*/
public function getHelper(string $name)
{
if (null === $this->helperSet) {
throw new LogicException(\sprintf('Cannot retrieve helper "%s" because there is no HelperSet defined. Did you forget to add your command to the application or to set the application on the command using the setApplication() method? You can also set the HelperSet directly using the setHelperSet() method.', $name));
}
return $this->helperSet->get($name);
}
/**
* Validates a command name.
*
* It must be non-empty and parts can optionally be separated by ":".
*
* @throws InvalidArgumentException When the name is invalid
*/
private function validateName(string $name)
{
if (!\preg_match('/^[^\\:]++(\\:[^\\:]++)*$/', $name)) {
throw new InvalidArgumentException(\sprintf('Command name "%s" is invalid.', $name));
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionSuggestions;
use _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor\ApplicationDescription;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\DescriptorHelper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* ListCommand displays the list of all available commands for the application.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class ListCommand extends Command
{
/**
* {@inheritdoc}
*/
protected function configure()
{
$this->setName('list')->setDefinition([new InputArgument('namespace', InputArgument::OPTIONAL, 'The namespace name'), new InputOption('raw', null, InputOption::VALUE_NONE, 'To output raw command list'), new InputOption('format', null, InputOption::VALUE_REQUIRED, 'The output format (txt, xml, json, or md)', 'txt'), new InputOption('short', null, InputOption::VALUE_NONE, 'To skip describing commands\' arguments')])->setDescription('List commands')->setHelp(<<<'EOF'
The <info>%command.name%</info> command lists all commands:
<info>%command.full_name%</info>
You can also display the commands for a specific namespace:
<info>%command.full_name% test</info>
You can also output the information in other formats by using the <comment>--format</comment> option:
<info>%command.full_name% --format=xml</info>
It's also possible to get raw list of commands (useful for embedding command runner):
<info>%command.full_name% --raw</info>
EOF
);
}
/**
* {@inheritdoc}
*/
protected function execute(InputInterface $input, OutputInterface $output)
{
$helper = new DescriptorHelper();
$helper->describe($output, $this->getApplication(), ['format' => $input->getOption('format'), 'raw_text' => $input->getOption('raw'), 'namespace' => $input->getArgument('namespace'), 'short' => $input->getOption('short')]);
return 0;
}
public function complete(CompletionInput $input, CompletionSuggestions $suggestions) : void
{
if ($input->mustSuggestArgumentValuesFor('namespace')) {
$descriptor = new ApplicationDescription($this->getApplication());
$suggestions->suggestValues(\array_keys($descriptor->getNamespaces()));
return;
}
if ($input->mustSuggestOptionValuesFor('format')) {
$helper = new DescriptorHelper();
$suggestions->suggestValues($helper->getFormats());
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionSuggestions;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Process\Process;
/**
* Dumps the completion script for the current shell.
*
* @author Wouter de Jong <wouter@wouterj.nl>
*/
final class DumpCompletionCommand extends Command
{
protected static $defaultName = 'completion';
protected static $defaultDescription = 'Dump the shell completion script';
public function complete(CompletionInput $input, CompletionSuggestions $suggestions) : void
{
if ($input->mustSuggestArgumentValuesFor('shell')) {
$suggestions->suggestValues($this->getSupportedShells());
}
}
protected function configure()
{
$fullCommand = $_SERVER['PHP_SELF'];
$commandName = \basename($fullCommand);
$fullCommand = @\realpath($fullCommand) ?: $fullCommand;
$this->setHelp(<<<EOH
The <info>%command.name%</> command dumps the shell completion script required
to use shell autocompletion (currently only bash completion is supported).
<comment>Static installation
-------------------</>
Dump the script to a global completion file and restart your shell:
<info>%command.full_name% bash | sudo tee /etc/bash_completion.d/{$commandName}</>
Or dump the script to a local file and source it:
<info>%command.full_name% bash > completion.sh</>
<comment># source the file whenever you use the project</>
<info>source completion.sh</>
<comment># or add this line at the end of your "~/.bashrc" file:</>
<info>source /path/to/completion.sh</>
<comment>Dynamic installation
--------------------</>
Add this to the end of your shell configuration file (e.g. <info>"~/.bashrc"</>):
<info>eval "\$({$fullCommand} completion bash)"</>
EOH
)->addArgument('shell', InputArgument::OPTIONAL, 'The shell type (e.g. "bash"), the value of the "$SHELL" env var will be used if this is not given')->addOption('debug', null, InputOption::VALUE_NONE, 'Tail the completion debug log');
}
protected function execute(InputInterface $input, OutputInterface $output) : int
{
$commandName = \basename($_SERVER['argv'][0]);
if ($input->getOption('debug')) {
$this->tailDebugLog($commandName, $output);
return 0;
}
$shell = $input->getArgument('shell') ?? self::guessShell();
$completionFile = __DIR__ . '/../Resources/completion.' . $shell;
if (!\file_exists($completionFile)) {
$supportedShells = $this->getSupportedShells();
if ($output instanceof ConsoleOutputInterface) {
$output = $output->getErrorOutput();
}
if ($shell) {
$output->writeln(\sprintf('<error>Detected shell "%s", which is not supported by Symfony shell completion (supported shells: "%s").</>', $shell, \implode('", "', $supportedShells)));
} else {
$output->writeln(\sprintf('<error>Shell not detected, Symfony shell completion only supports "%s").</>', \implode('", "', $supportedShells)));
}
return 2;
}
$output->write(\str_replace(['{{ COMMAND_NAME }}', '{{ VERSION }}'], [$commandName, $this->getApplication()->getVersion()], \file_get_contents($completionFile)));
return 0;
}
private static function guessShell() : string
{
return \basename($_SERVER['SHELL'] ?? '');
}
private function tailDebugLog(string $commandName, OutputInterface $output) : void
{
$debugFile = \sys_get_temp_dir() . '/sf_' . $commandName . '.log';
if (!\file_exists($debugFile)) {
\touch($debugFile);
}
$process = new Process(['tail', '-f', $debugFile], null, null, null, 0);
$process->run(function (string $type, string $line) use($output) : void {
$output->write($line);
});
}
/**
* @return string[]
*/
private function getSupportedShells() : array
{
$shells = [];
foreach (new \DirectoryIterator(__DIR__ . '/../Resources/') as $file) {
if (\str_starts_with($file->getBasename(), 'completion.') && $file->isFile()) {
$shells[] = $file->getExtension();
}
}
return $shells;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Application;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionSuggestions;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\HelperSet;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputDefinition;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* @author Nicolas Grekas <p@tchwork.com>
*/
final class LazyCommand extends Command
{
private $command;
private $isEnabled;
public function __construct(string $name, array $aliases, string $description, bool $isHidden, \Closure $commandFactory, ?bool $isEnabled = \true)
{
$this->setName($name)->setAliases($aliases)->setHidden($isHidden)->setDescription($description);
$this->command = $commandFactory;
$this->isEnabled = $isEnabled;
}
public function ignoreValidationErrors() : void
{
$this->getCommand()->ignoreValidationErrors();
}
public function setApplication(?Application $application = null) : void
{
if ($this->command instanceof parent) {
$this->command->setApplication($application);
}
parent::setApplication($application);
}
public function setHelperSet(HelperSet $helperSet) : void
{
if ($this->command instanceof parent) {
$this->command->setHelperSet($helperSet);
}
parent::setHelperSet($helperSet);
}
public function isEnabled() : bool
{
return $this->isEnabled ?? $this->getCommand()->isEnabled();
}
public function run(InputInterface $input, OutputInterface $output) : int
{
return $this->getCommand()->run($input, $output);
}
public function complete(CompletionInput $input, CompletionSuggestions $suggestions) : void
{
$this->getCommand()->complete($input, $suggestions);
}
/**
* @return $this
*/
public function setCode(callable $code) : self
{
$this->getCommand()->setCode($code);
return $this;
}
/**
* @internal
*/
public function mergeApplicationDefinition(bool $mergeArgs = \true) : void
{
$this->getCommand()->mergeApplicationDefinition($mergeArgs);
}
/**
* @return $this
*/
public function setDefinition($definition) : self
{
$this->getCommand()->setDefinition($definition);
return $this;
}
public function getDefinition() : InputDefinition
{
return $this->getCommand()->getDefinition();
}
public function getNativeDefinition() : InputDefinition
{
return $this->getCommand()->getNativeDefinition();
}
/**
* @return $this
*/
public function addArgument(string $name, ?int $mode = null, string $description = '', $default = null) : self
{
$this->getCommand()->addArgument($name, $mode, $description, $default);
return $this;
}
/**
* @return $this
*/
public function addOption(string $name, $shortcut = null, ?int $mode = null, string $description = '', $default = null) : self
{
$this->getCommand()->addOption($name, $shortcut, $mode, $description, $default);
return $this;
}
/**
* @return $this
*/
public function setProcessTitle(string $title) : self
{
$this->getCommand()->setProcessTitle($title);
return $this;
}
/**
* @return $this
*/
public function setHelp(string $help) : self
{
$this->getCommand()->setHelp($help);
return $this;
}
public function getHelp() : string
{
return $this->getCommand()->getHelp();
}
public function getProcessedHelp() : string
{
return $this->getCommand()->getProcessedHelp();
}
public function getSynopsis(bool $short = \false) : string
{
return $this->getCommand()->getSynopsis($short);
}
/**
* @return $this
*/
public function addUsage(string $usage) : self
{
$this->getCommand()->addUsage($usage);
return $this;
}
public function getUsages() : array
{
return $this->getCommand()->getUsages();
}
/**
* @return mixed
*/
public function getHelper(string $name)
{
return $this->getCommand()->getHelper($name);
}
public function getCommand() : parent
{
if (!$this->command instanceof \Closure) {
return $this->command;
}
$command = $this->command = ($this->command)();
$command->setApplication($this->getApplication());
if (null !== $this->getHelperSet()) {
$command->setHelperSet($this->getHelperSet());
}
$command->setName($this->getName())->setAliases($this->getAliases())->setHidden($this->isHidden())->setDescription($this->getDescription());
// Will throw if the command is not correctly initialized.
$command->getDefinition();
return $command;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\LogicException;
use _PHPStan_6dcda722c\Symfony\Component\Lock\LockFactory;
use _PHPStan_6dcda722c\Symfony\Component\Lock\LockInterface;
use _PHPStan_6dcda722c\Symfony\Component\Lock\Store\FlockStore;
use _PHPStan_6dcda722c\Symfony\Component\Lock\Store\SemaphoreStore;
/**
* Basic lock feature for commands.
*
* @author Geoffrey Brier <geoffrey.brier@gmail.com>
*/
trait LockableTrait
{
/** @var LockInterface|null */
private $lock;
/**
* Locks a command.
*/
private function lock(?string $name = null, bool $blocking = \false) : bool
{
if (!\class_exists(SemaphoreStore::class)) {
throw new LogicException('To enable the locking feature you must install the symfony/lock component.');
}
if (null !== $this->lock) {
throw new LogicException('A lock is already in place.');
}
if (SemaphoreStore::isSupported()) {
$store = new SemaphoreStore();
} else {
$store = new FlockStore();
}
$this->lock = (new LockFactory($store))->createLock($name ?: $this->getName());
if (!$this->lock->acquire($blocking)) {
$this->lock = null;
return \false;
}
return \true;
}
/**
* Releases the command lock if there is one.
*/
private function release()
{
if ($this->lock) {
$this->lock->release();
$this->lock = null;
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionSuggestions;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\Output\BashCompletionOutput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\Output\CompletionOutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\CommandNotFoundException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\ExceptionInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* Responsible for providing the values to the shell completion.
*
* @author Wouter de Jong <wouter@wouterj.nl>
*/
final class CompleteCommand extends Command
{
protected static $defaultName = '|_complete';
protected static $defaultDescription = 'Internal command to provide shell completion suggestions';
private $completionOutputs;
private $isDebug = \false;
/**
* @param array<string, class-string<CompletionOutputInterface>> $completionOutputs A list of additional completion outputs, with shell name as key and FQCN as value
*/
public function __construct(array $completionOutputs = [])
{
// must be set before the parent constructor, as the property value is used in configure()
$this->completionOutputs = $completionOutputs + ['bash' => BashCompletionOutput::class];
parent::__construct();
}
protected function configure() : void
{
$this->addOption('shell', 's', InputOption::VALUE_REQUIRED, 'The shell type ("' . \implode('", "', \array_keys($this->completionOutputs)) . '")')->addOption('input', 'i', InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY, 'An array of input tokens (e.g. COMP_WORDS or argv)')->addOption('current', 'c', InputOption::VALUE_REQUIRED, 'The index of the "input" array that the cursor is in (e.g. COMP_CWORD)')->addOption('symfony', 'S', InputOption::VALUE_REQUIRED, 'The version of the completion script');
}
protected function initialize(InputInterface $input, OutputInterface $output)
{
$this->isDebug = \filter_var(\getenv('SYMFONY_COMPLETION_DEBUG'), \FILTER_VALIDATE_BOOLEAN);
}
protected function execute(InputInterface $input, OutputInterface $output) : int
{
try {
// uncomment when a bugfix or BC break has been introduced in the shell completion scripts
// $version = $input->getOption('symfony');
// if ($version && version_compare($version, 'x.y', '>=')) {
// $message = sprintf('Completion script version is not supported ("%s" given, ">=x.y" required).', $version);
// $this->log($message);
// $output->writeln($message.' Install the Symfony completion script again by using the "completion" command.');
// return 126;
// }
$shell = $input->getOption('shell');
if (!$shell) {
throw new \RuntimeException('The "--shell" option must be set.');
}
if (!($completionOutput = $this->completionOutputs[$shell] ?? \false)) {
throw new \RuntimeException(\sprintf('Shell completion is not supported for your shell: "%s" (supported: "%s").', $shell, \implode('", "', \array_keys($this->completionOutputs))));
}
$completionInput = $this->createCompletionInput($input);
$suggestions = new CompletionSuggestions();
$this->log(['', '<comment>' . \date('Y-m-d H:i:s') . '</>', '<info>Input:</> <comment>("|" indicates the cursor position)</>', ' ' . (string) $completionInput, '<info>Command:</>', ' ' . (string) \implode(' ', $_SERVER['argv']), '<info>Messages:</>']);
$command = $this->findCommand($completionInput, $output);
if (null === $command) {
$this->log(' No command found, completing using the Application class.');
$this->getApplication()->complete($completionInput, $suggestions);
} elseif ($completionInput->mustSuggestArgumentValuesFor('command') && $command->getName() !== $completionInput->getCompletionValue() && !\in_array($completionInput->getCompletionValue(), $command->getAliases(), \true)) {
$this->log(' No command found, completing using the Application class.');
// expand shortcut names ("cache:cl<TAB>") into their full name ("cache:clear")
$suggestions->suggestValues(\array_filter(\array_merge([$command->getName()], $command->getAliases())));
} else {
$command->mergeApplicationDefinition();
$completionInput->bind($command->getDefinition());
if (CompletionInput::TYPE_OPTION_NAME === $completionInput->getCompletionType()) {
$this->log(' Completing option names for the <comment>' . \get_class($command instanceof LazyCommand ? $command->getCommand() : $command) . '</> command.');
$suggestions->suggestOptions($command->getDefinition()->getOptions());
} else {
$this->log([' Completing using the <comment>' . \get_class($command instanceof LazyCommand ? $command->getCommand() : $command) . '</> class.', ' Completing <comment>' . $completionInput->getCompletionType() . '</> for <comment>' . $completionInput->getCompletionName() . '</>']);
if (null !== ($compval = $completionInput->getCompletionValue())) {
$this->log(' Current value: <comment>' . $compval . '</>');
}
$command->complete($completionInput, $suggestions);
}
}
/** @var CompletionOutputInterface $completionOutput */
$completionOutput = new $completionOutput();
$this->log('<info>Suggestions:</>');
if ($options = $suggestions->getOptionSuggestions()) {
$this->log(' --' . \implode(' --', \array_map(function ($o) {
return $o->getName();
}, $options)));
} elseif ($values = $suggestions->getValueSuggestions()) {
$this->log(' ' . \implode(' ', $values));
} else {
$this->log(' <comment>No suggestions were provided</>');
}
$completionOutput->write($suggestions, $output);
} catch (\Throwable $e) {
$this->log(['<error>Error!</error>', (string) $e]);
if ($output->isDebug()) {
throw $e;
}
return 2;
}
return 0;
}
private function createCompletionInput(InputInterface $input) : CompletionInput
{
$currentIndex = $input->getOption('current');
if (!$currentIndex || !\ctype_digit($currentIndex)) {
throw new \RuntimeException('The "--current" option must be set and it must be an integer.');
}
$completionInput = CompletionInput::fromTokens($input->getOption('input'), (int) $currentIndex);
try {
$completionInput->bind($this->getApplication()->getDefinition());
} catch (ExceptionInterface $e) {
}
return $completionInput;
}
private function findCommand(CompletionInput $completionInput, OutputInterface $output) : ?Command
{
try {
$inputName = $completionInput->getFirstArgument();
if (null === $inputName) {
return null;
}
return $this->getApplication()->find($inputName);
} catch (CommandNotFoundException $e) {
}
return null;
}
private function log($messages) : void
{
if (!$this->isDebug) {
return;
}
$commandName = \basename($_SERVER['argv'][0]);
\file_put_contents(\sys_get_temp_dir() . '/sf_' . $commandName . '.log', \implode(\PHP_EOL, (array) $messages) . \PHP_EOL, \FILE_APPEND);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionSuggestions;
use _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor\ApplicationDescription;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\DescriptorHelper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* HelpCommand displays the help for a given command.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class HelpCommand extends Command
{
private $command;
/**
* {@inheritdoc}
*/
protected function configure()
{
$this->ignoreValidationErrors();
$this->setName('help')->setDefinition([new InputArgument('command_name', InputArgument::OPTIONAL, 'The command name', 'help'), new InputOption('format', null, InputOption::VALUE_REQUIRED, 'The output format (txt, xml, json, or md)', 'txt'), new InputOption('raw', null, InputOption::VALUE_NONE, 'To output raw command help')])->setDescription('Display help for a command')->setHelp(<<<'EOF'
The <info>%command.name%</info> command displays help for a given command:
<info>%command.full_name% list</info>
You can also output the help in other formats by using the <comment>--format</comment> option:
<info>%command.full_name% --format=xml list</info>
To display the list of available commands, please use the <info>list</info> command.
EOF
);
}
public function setCommand(Command $command)
{
$this->command = $command;
}
/**
* {@inheritdoc}
*/
protected function execute(InputInterface $input, OutputInterface $output)
{
if (null === $this->command) {
$this->command = $this->getApplication()->find($input->getArgument('command_name'));
}
$helper = new DescriptorHelper();
$helper->describe($output, $this->command, ['format' => $input->getOption('format'), 'raw_text' => $input->getOption('raw')]);
$this->command = null;
return 0;
}
public function complete(CompletionInput $input, CompletionSuggestions $suggestions) : void
{
if ($input->mustSuggestArgumentValuesFor('command_name')) {
$descriptor = new ApplicationDescription($this->getApplication());
$suggestions->suggestValues(\array_keys($descriptor->getCommands()));
return;
}
if ($input->mustSuggestOptionValuesFor('format')) {
$helper = new DescriptorHelper();
$suggestions->suggestValues($helper->getFormats());
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Logger;
use _PHPStan_6dcda722c\Psr\Log\AbstractLogger;
use _PHPStan_6dcda722c\Psr\Log\InvalidArgumentException;
use _PHPStan_6dcda722c\Psr\Log\LogLevel;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* PSR-3 compliant console logger.
*
* @author Kévin Dunglas <dunglas@gmail.com>
*
* @see https://www.php-fig.org/psr/psr-3/
*/
class ConsoleLogger extends AbstractLogger
{
public const INFO = 'info';
public const ERROR = 'error';
private $output;
private $verbosityLevelMap = [LogLevel::EMERGENCY => OutputInterface::VERBOSITY_NORMAL, LogLevel::ALERT => OutputInterface::VERBOSITY_NORMAL, LogLevel::CRITICAL => OutputInterface::VERBOSITY_NORMAL, LogLevel::ERROR => OutputInterface::VERBOSITY_NORMAL, LogLevel::WARNING => OutputInterface::VERBOSITY_NORMAL, LogLevel::NOTICE => OutputInterface::VERBOSITY_VERBOSE, LogLevel::INFO => OutputInterface::VERBOSITY_VERY_VERBOSE, LogLevel::DEBUG => OutputInterface::VERBOSITY_DEBUG];
private $formatLevelMap = [LogLevel::EMERGENCY => self::ERROR, LogLevel::ALERT => self::ERROR, LogLevel::CRITICAL => self::ERROR, LogLevel::ERROR => self::ERROR, LogLevel::WARNING => self::INFO, LogLevel::NOTICE => self::INFO, LogLevel::INFO => self::INFO, LogLevel::DEBUG => self::INFO];
private $errored = \false;
public function __construct(OutputInterface $output, array $verbosityLevelMap = [], array $formatLevelMap = [])
{
$this->output = $output;
$this->verbosityLevelMap = $verbosityLevelMap + $this->verbosityLevelMap;
$this->formatLevelMap = $formatLevelMap + $this->formatLevelMap;
}
/**
* {@inheritdoc}
*
* @return void
*/
public function log($level, $message, array $context = [])
{
if (!isset($this->verbosityLevelMap[$level])) {
throw new InvalidArgumentException(\sprintf('The log level "%s" does not exist.', $level));
}
$output = $this->output;
// Write to the error output if necessary and available
if (self::ERROR === $this->formatLevelMap[$level]) {
if ($this->output instanceof ConsoleOutputInterface) {
$output = $output->getErrorOutput();
}
$this->errored = \true;
}
// the if condition check isn't necessary -- it's the same one that $output will do internally anyway.
// We only do it for efficiency here as the message formatting is relatively expensive.
if ($output->getVerbosity() >= $this->verbosityLevelMap[$level]) {
$output->writeln(\sprintf('<%1$s>[%2$s] %3$s</%1$s>', $this->formatLevelMap[$level], $level, $this->interpolate($message, $context)), $this->verbosityLevelMap[$level]);
}
}
/**
* Returns true when any messages have been logged at error levels.
*
* @return bool
*/
public function hasErrored()
{
return $this->errored;
}
/**
* Interpolates context values into the message placeholders.
*
* @author PHP Framework Interoperability Group
*/
private function interpolate(string $message, array $context) : string
{
if (!\str_contains($message, '{')) {
return $message;
}
$replacements = [];
foreach ($context as $key => $val) {
if (null === $val || \is_scalar($val) || \is_object($val) && \method_exists($val, '__toString')) {
$replacements["{{$key}}"] = $val;
} elseif ($val instanceof \DateTimeInterface) {
$replacements["{{$key}}"] = $val->format(\DateTime::RFC3339);
} elseif (\is_object($val)) {
$replacements["{{$key}}"] = '[object ' . \get_class($val) . ']';
} else {
$replacements["{{$key}}"] = '[' . \gettype($val) . ']';
}
}
return \strtr($message, $replacements);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Tester;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\ArrayInput;
/**
* Eases the testing of console commands.
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Robin Chalas <robin.chalas@gmail.com>
*/
class CommandTester
{
use TesterTrait;
private $command;
public function __construct(Command $command)
{
$this->command = $command;
}
/**
* Executes the command.
*
* Available execution options:
*
* * interactive: Sets the input interactive flag
* * decorated: Sets the output decorated flag
* * verbosity: Sets the output verbosity flag
* * capture_stderr_separately: Make output of stdOut and stdErr separately available
*
* @param array $input An array of command arguments and options
* @param array $options An array of execution options
*
* @return int The command exit code
*/
public function execute(array $input, array $options = [])
{
// set the command name automatically if the application requires
// this argument and no command name was passed
if (!isset($input['command']) && null !== ($application = $this->command->getApplication()) && $application->getDefinition()->hasArgument('command')) {
$input = \array_merge(['command' => $this->command->getName()], $input);
}
$this->input = new ArrayInput($input);
// Use an in-memory input stream even if no inputs are set so that QuestionHelper::ask() does not rely on the blocking STDIN.
$this->input->setStream(self::createStream($this->inputs));
if (isset($options['interactive'])) {
$this->input->setInteractive($options['interactive']);
}
if (!isset($options['decorated'])) {
$options['decorated'] = \false;
}
$this->initOutput($options);
return $this->statusCode = $this->command->run($this->input, $this->output);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Tester;
use PHPUnit\Framework\Assert;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\StreamOutput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Tester\Constraint\CommandIsSuccessful;
/**
* @author Amrouche Hamza <hamza.simperfit@gmail.com>
*/
trait TesterTrait
{
/** @var StreamOutput */
private $output;
private $inputs = [];
private $captureStreamsIndependently = \false;
/** @var InputInterface */
private $input;
/** @var int */
private $statusCode;
/**
* Gets the display returned by the last execution of the command or application.
*
* @return string
*
* @throws \RuntimeException If it's called before the execute method
*/
public function getDisplay(bool $normalize = \false)
{
if (null === $this->output) {
throw new \RuntimeException('Output not initialized, did you execute the command before requesting the display?');
}
\rewind($this->output->getStream());
$display = \stream_get_contents($this->output->getStream());
if ($normalize) {
$display = \str_replace(\PHP_EOL, "\n", $display);
}
return $display;
}
/**
* Gets the output written to STDERR by the application.
*
* @param bool $normalize Whether to normalize end of lines to \n or not
*
* @return string
*/
public function getErrorOutput(bool $normalize = \false)
{
if (!$this->captureStreamsIndependently) {
throw new \LogicException('The error output is not available when the tester is run without "capture_stderr_separately" option set.');
}
\rewind($this->output->getErrorOutput()->getStream());
$display = \stream_get_contents($this->output->getErrorOutput()->getStream());
if ($normalize) {
$display = \str_replace(\PHP_EOL, "\n", $display);
}
return $display;
}
/**
* Gets the input instance used by the last execution of the command or application.
*
* @return InputInterface
*/
public function getInput()
{
return $this->input;
}
/**
* Gets the output instance used by the last execution of the command or application.
*
* @return OutputInterface
*/
public function getOutput()
{
return $this->output;
}
/**
* Gets the status code returned by the last execution of the command or application.
*
* @return int
*
* @throws \RuntimeException If it's called before the execute method
*/
public function getStatusCode()
{
if (null === $this->statusCode) {
throw new \RuntimeException('Status code not initialized, did you execute the command before requesting the status code?');
}
return $this->statusCode;
}
public function assertCommandIsSuccessful(string $message = '') : void
{
Assert::assertThat($this->statusCode, new CommandIsSuccessful(), $message);
}
/**
* Sets the user inputs.
*
* @param array $inputs An array of strings representing each input
* passed to the command input stream
*
* @return $this
*/
public function setInputs(array $inputs)
{
$this->inputs = $inputs;
return $this;
}
/**
* Initializes the output property.
*
* Available options:
*
* * decorated: Sets the output decorated flag
* * verbosity: Sets the output verbosity flag
* * capture_stderr_separately: Make output of stdOut and stdErr separately available
*/
private function initOutput(array $options)
{
$this->captureStreamsIndependently = \array_key_exists('capture_stderr_separately', $options) && $options['capture_stderr_separately'];
if (!$this->captureStreamsIndependently) {
$this->output = new StreamOutput(\fopen('php://memory', 'w', \false));
if (isset($options['decorated'])) {
$this->output->setDecorated($options['decorated']);
}
if (isset($options['verbosity'])) {
$this->output->setVerbosity($options['verbosity']);
}
} else {
$this->output = new ConsoleOutput($options['verbosity'] ?? ConsoleOutput::VERBOSITY_NORMAL, $options['decorated'] ?? null);
$errorOutput = new StreamOutput(\fopen('php://memory', 'w', \false));
$errorOutput->setFormatter($this->output->getFormatter());
$errorOutput->setVerbosity($this->output->getVerbosity());
$errorOutput->setDecorated($this->output->isDecorated());
$reflectedOutput = new \ReflectionObject($this->output);
$strErrProperty = $reflectedOutput->getProperty('stderr');
$strErrProperty->setAccessible(\true);
$strErrProperty->setValue($this->output, $errorOutput);
$reflectedParent = $reflectedOutput->getParentClass();
$streamProperty = $reflectedParent->getProperty('stream');
$streamProperty->setAccessible(\true);
$streamProperty->setValue($this->output, \fopen('php://memory', 'w', \false));
}
}
/**
* @return resource
*/
private static function createStream(array $inputs)
{
$stream = \fopen('php://memory', 'r+', \false);
foreach ($inputs as $input) {
\fwrite($stream, $input . \PHP_EOL);
}
\rewind($stream);
return $stream;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Tester\Constraint;
use PHPUnit\Framework\Constraint\Constraint;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
final class CommandIsSuccessful extends Constraint
{
/**
* {@inheritdoc}
*/
public function toString() : string
{
return 'is successful';
}
/**
* {@inheritdoc}
*/
protected function matches($other) : bool
{
return Command::SUCCESS === $other;
}
/**
* {@inheritdoc}
*/
protected function failureDescription($other) : string
{
return 'the command ' . $this->toString();
}
/**
* {@inheritdoc}
*/
protected function additionalFailureDescription($other) : string
{
$mapping = [Command::FAILURE => 'Command failed.', Command::INVALID => 'Command was invalid.'];
return $mapping[$other] ?? \sprintf('Command returned exit status %d.', $other);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Tester;
use _PHPStan_6dcda722c\Symfony\Component\Console\Application;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\ArrayInput;
/**
* Eases the testing of console applications.
*
* When testing an application, don't forget to disable the auto exit flag:
*
* $application = new Application();
* $application->setAutoExit(false);
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class ApplicationTester
{
use TesterTrait;
private $application;
public function __construct(Application $application)
{
$this->application = $application;
}
/**
* Executes the application.
*
* Available options:
*
* * interactive: Sets the input interactive flag
* * decorated: Sets the output decorated flag
* * verbosity: Sets the output verbosity flag
* * capture_stderr_separately: Make output of stdOut and stdErr separately available
*
* @return int The command exit code
*/
public function run(array $input, array $options = [])
{
$prevShellVerbosity = \getenv('SHELL_VERBOSITY');
try {
$this->input = new ArrayInput($input);
if (isset($options['interactive'])) {
$this->input->setInteractive($options['interactive']);
}
if ($this->inputs) {
$this->input->setStream(self::createStream($this->inputs));
}
$this->initOutput($options);
return $this->statusCode = $this->application->run($this->input, $this->output);
} finally {
// SHELL_VERBOSITY is set by Application::configureIO so we need to unset/reset it
// to its previous value to avoid one test's verbosity to spread to the following tests
if (\false === $prevShellVerbosity) {
if (\function_exists('putenv')) {
@\putenv('SHELL_VERBOSITY');
}
unset($_ENV['SHELL_VERBOSITY']);
unset($_SERVER['SHELL_VERBOSITY']);
} else {
if (\function_exists('putenv')) {
@\putenv('SHELL_VERBOSITY=' . $prevShellVerbosity);
}
$_ENV['SHELL_VERBOSITY'] = $prevShellVerbosity;
$_SERVER['SHELL_VERBOSITY'] = $prevShellVerbosity;
}
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Tester;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionInput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Completion\CompletionSuggestions;
/**
* Eases the testing of command completion.
*
* @author Jérôme Tamarelle <jerome@tamarelle.net>
*/
class CommandCompletionTester
{
private $command;
public function __construct(Command $command)
{
$this->command = $command;
}
/**
* Create completion suggestions from input tokens.
*/
public function complete(array $input) : array
{
$currentIndex = \count($input);
if ('' === \end($input)) {
\array_pop($input);
}
\array_unshift($input, $this->command->getName());
$completionInput = CompletionInput::fromTokens($input, $currentIndex);
$completionInput->bind($this->command->getDefinition());
$suggestions = new CompletionSuggestions();
$this->command->complete($completionInput, $suggestions);
$options = [];
foreach ($suggestions->getOptionSuggestions() as $option) {
$options[] = '--' . $option->getName();
}
return \array_map('strval', \array_merge($options, $suggestions->getValueSuggestions()));
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\CI;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* Utility class for Github actions.
*
* @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
*/
class GithubActionReporter
{
private $output;
/**
* @see https://github.com/actions/toolkit/blob/5e5e1b7aacba68a53836a34db4a288c3c1c1585b/packages/core/src/command.ts#L80-L85
*/
private const ESCAPED_DATA = ['%' => '%25', "\r" => '%0D', "\n" => '%0A'];
/**
* @see https://github.com/actions/toolkit/blob/5e5e1b7aacba68a53836a34db4a288c3c1c1585b/packages/core/src/command.ts#L87-L94
*/
private const ESCAPED_PROPERTIES = ['%' => '%25', "\r" => '%0D', "\n" => '%0A', ':' => '%3A', ',' => '%2C'];
public function __construct(OutputInterface $output)
{
$this->output = $output;
}
public static function isGithubActionEnvironment() : bool
{
return \false !== \getenv('GITHUB_ACTIONS');
}
/**
* Output an error using the Github annotations format.
*
* @see https://docs.github.com/en/free-pro-team@latest/actions/reference/workflow-commands-for-github-actions#setting-an-error-message
*/
public function error(string $message, ?string $file = null, ?int $line = null, ?int $col = null) : void
{
$this->log('error', $message, $file, $line, $col);
}
/**
* Output a warning using the Github annotations format.
*
* @see https://docs.github.com/en/free-pro-team@latest/actions/reference/workflow-commands-for-github-actions#setting-a-warning-message
*/
public function warning(string $message, ?string $file = null, ?int $line = null, ?int $col = null) : void
{
$this->log('warning', $message, $file, $line, $col);
}
/**
* Output a debug log using the Github annotations format.
*
* @see https://docs.github.com/en/free-pro-team@latest/actions/reference/workflow-commands-for-github-actions#setting-a-debug-message
*/
public function debug(string $message, ?string $file = null, ?int $line = null, ?int $col = null) : void
{
$this->log('debug', $message, $file, $line, $col);
}
private function log(string $type, string $message, ?string $file = null, ?int $line = null, ?int $col = null) : void
{
// Some values must be encoded.
$message = \strtr($message, self::ESCAPED_DATA);
if (!$file) {
// No file provided, output the message solely:
$this->output->writeln(\sprintf('::%s::%s', $type, $message));
return;
}
$this->output->writeln(\sprintf('::%s file=%s,line=%s,col=%s::%s', $type, \strtr($file, self::ESCAPED_PROPERTIES), \strtr($line ?? 1, self::ESCAPED_PROPERTIES), \strtr($col ?? 0, self::ESCAPED_PROPERTIES), $message));
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Exception;
/**
* Represents failure to read input from stdin.
*
* @author Gabriel Ostrolucký <gabriel.ostrolucky@gmail.com>
*/
class MissingInputException extends RuntimeException implements ExceptionInterface
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Exception;
/**
* Represents an incorrect namespace typed in the console.
*
* @author Pierre du Plessis <pdples@gmail.com>
*/
class NamespaceNotFoundException extends CommandNotFoundException
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Exception;
/**
* @author Jérôme Tamarelle <jerome@tamarelle.net>
*/
class RuntimeException extends \RuntimeException implements ExceptionInterface
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Exception;
/**
* Represents an incorrect option name or value typed in the console.
*
* @author Jérôme Tamarelle <jerome@tamarelle.net>
*/
class InvalidOptionException extends \InvalidArgumentException implements ExceptionInterface
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Exception;
/**
* Represents an incorrect command name typed in the console.
*
* @author Jérôme Tamarelle <jerome@tamarelle.net>
*/
class CommandNotFoundException extends \InvalidArgumentException implements ExceptionInterface
{
private $alternatives;
/**
* @param string $message Exception message to throw
* @param string[] $alternatives List of similar defined names
* @param int $code Exception code
* @param \Throwable|null $previous Previous exception used for the exception chaining
*/
public function __construct(string $message, array $alternatives = [], int $code = 0, ?\Throwable $previous = null)
{
parent::__construct($message, $code, $previous);
$this->alternatives = $alternatives;
}
/**
* @return string[]
*/
public function getAlternatives()
{
return $this->alternatives;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Exception;
/**
* ExceptionInterface.
*
* @author Jérôme Tamarelle <jerome@tamarelle.net>
*/
interface ExceptionInterface extends \Throwable
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Exception;
/**
* @author Jérôme Tamarelle <jerome@tamarelle.net>
*/
class LogicException extends \LogicException implements ExceptionInterface
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Exception;
/**
* @author Jérôme Tamarelle <jerome@tamarelle.net>
*/
class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Formatter;
/**
* Formatter interface for console output that supports word wrapping.
*
* @author Roland Franssen <franssen.roland@gmail.com>
*/
interface WrappableOutputFormatterInterface extends OutputFormatterInterface
{
/**
* Formats a message according to the given styles, wrapping at `$width` (0 means no wrapping).
*/
public function formatAndWrap(?string $message, int $width);
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Formatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Contracts\Service\ResetInterface;
/**
* @author Jean-François Simon <contact@jfsimon.fr>
*/
class OutputFormatterStyleStack implements ResetInterface
{
/**
* @var OutputFormatterStyleInterface[]
*/
private $styles;
private $emptyStyle;
public function __construct(?OutputFormatterStyleInterface $emptyStyle = null)
{
$this->emptyStyle = $emptyStyle ?? new OutputFormatterStyle();
$this->reset();
}
/**
* Resets stack (ie. empty internal arrays).
*/
public function reset()
{
$this->styles = [];
}
/**
* Pushes a style in the stack.
*/
public function push(OutputFormatterStyleInterface $style)
{
$this->styles[] = $style;
}
/**
* Pops a style from the stack.
*
* @return OutputFormatterStyleInterface
*
* @throws InvalidArgumentException When style tags incorrectly nested
*/
public function pop(?OutputFormatterStyleInterface $style = null)
{
if (empty($this->styles)) {
return $this->emptyStyle;
}
if (null === $style) {
return \array_pop($this->styles);
}
foreach (\array_reverse($this->styles, \true) as $index => $stackedStyle) {
if ($style->apply('') === $stackedStyle->apply('')) {
$this->styles = \array_slice($this->styles, 0, $index);
return $stackedStyle;
}
}
throw new InvalidArgumentException('Incorrectly nested style tag found.');
}
/**
* Computes current style with stacks top codes.
*
* @return OutputFormatterStyle
*/
public function getCurrent()
{
if (empty($this->styles)) {
return $this->emptyStyle;
}
return $this->styles[\count($this->styles) - 1];
}
/**
* @return $this
*/
public function setEmptyStyle(OutputFormatterStyleInterface $emptyStyle)
{
$this->emptyStyle = $emptyStyle;
return $this;
}
/**
* @return OutputFormatterStyleInterface
*/
public function getEmptyStyle()
{
return $this->emptyStyle;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Formatter;
/**
* @author Tien Xuan Vo <tien.xuan.vo@gmail.com>
*/
final class NullOutputFormatterStyle implements OutputFormatterStyleInterface
{
/**
* {@inheritdoc}
*/
public function apply(string $text) : string
{
return $text;
}
/**
* {@inheritdoc}
*/
public function setBackground(?string $color = null) : void
{
// do nothing
}
/**
* {@inheritdoc}
*/
public function setForeground(?string $color = null) : void
{
// do nothing
}
/**
* {@inheritdoc}
*/
public function setOption(string $option) : void
{
// do nothing
}
/**
* {@inheritdoc}
*/
public function setOptions(array $options) : void
{
// do nothing
}
/**
* {@inheritdoc}
*/
public function unsetOption(string $option) : void
{
// do nothing
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Formatter;
/**
* Formatter style interface for defining styles.
*
* @author Konstantin Kudryashov <ever.zet@gmail.com>
*/
interface OutputFormatterStyleInterface
{
/**
* Sets style foreground color.
*/
public function setForeground(?string $color = null);
/**
* Sets style background color.
*/
public function setBackground(?string $color = null);
/**
* Sets some specific style option.
*/
public function setOption(string $option);
/**
* Unsets some specific style option.
*/
public function unsetOption(string $option);
/**
* Sets multiple style options at once.
*/
public function setOptions(array $options);
/**
* Applies the style to a given text.
*
* @return string
*/
public function apply(string $text);
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Formatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Color;
/**
* Formatter style class for defining styles.
*
* @author Konstantin Kudryashov <ever.zet@gmail.com>
*/
class OutputFormatterStyle implements OutputFormatterStyleInterface
{
private $color;
private $foreground;
private $background;
private $options;
private $href;
private $handlesHrefGracefully;
/**
* Initializes output formatter style.
*
* @param string|null $foreground The style foreground color name
* @param string|null $background The style background color name
*/
public function __construct(?string $foreground = null, ?string $background = null, array $options = [])
{
$this->color = new Color($this->foreground = $foreground ?: '', $this->background = $background ?: '', $this->options = $options);
}
/**
* {@inheritdoc}
*/
public function setForeground(?string $color = null)
{
$this->color = new Color($this->foreground = $color ?: '', $this->background, $this->options);
}
/**
* {@inheritdoc}
*/
public function setBackground(?string $color = null)
{
$this->color = new Color($this->foreground, $this->background = $color ?: '', $this->options);
}
public function setHref(string $url) : void
{
$this->href = $url;
}
/**
* {@inheritdoc}
*/
public function setOption(string $option)
{
$this->options[] = $option;
$this->color = new Color($this->foreground, $this->background, $this->options);
}
/**
* {@inheritdoc}
*/
public function unsetOption(string $option)
{
$pos = \array_search($option, $this->options);
if (\false !== $pos) {
unset($this->options[$pos]);
}
$this->color = new Color($this->foreground, $this->background, $this->options);
}
/**
* {@inheritdoc}
*/
public function setOptions(array $options)
{
$this->color = new Color($this->foreground, $this->background, $this->options = $options);
}
/**
* {@inheritdoc}
*/
public function apply(string $text)
{
if (null === $this->handlesHrefGracefully) {
$this->handlesHrefGracefully = 'JetBrains-JediTerm' !== \getenv('TERMINAL_EMULATOR') && (!\getenv('KONSOLE_VERSION') || (int) \getenv('KONSOLE_VERSION') > 201100) && !isset($_SERVER['IDEA_INITIAL_DIRECTORY']);
}
if (null !== $this->href && $this->handlesHrefGracefully) {
$text = "\x1b]8;;{$this->href}\x1b\\{$text}\x1b]8;;\x1b\\";
}
return $this->color->apply($text);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Formatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use function _PHPStan_6dcda722c\Symfony\Component\String\b;
/**
* Formatter class for console output.
*
* @author Konstantin Kudryashov <ever.zet@gmail.com>
* @author Roland Franssen <franssen.roland@gmail.com>
*/
class OutputFormatter implements WrappableOutputFormatterInterface
{
private $decorated;
private $styles = [];
private $styleStack;
public function __clone()
{
$this->styleStack = clone $this->styleStack;
foreach ($this->styles as $key => $value) {
$this->styles[$key] = clone $value;
}
}
/**
* Escapes "<" and ">" special chars in given text.
*
* @return string
*/
public static function escape(string $text)
{
$text = \preg_replace('/([^\\\\]|^)([<>])/', '$1\\\\$2', $text);
return self::escapeTrailingBackslash($text);
}
/**
* Escapes trailing "\" in given text.
*
* @internal
*/
public static function escapeTrailingBackslash(string $text) : string
{
if (\str_ends_with($text, '\\')) {
$len = \strlen($text);
$text = \rtrim($text, '\\');
$text = \str_replace("\x00", '', $text);
$text .= \str_repeat("\x00", $len - \strlen($text));
}
return $text;
}
/**
* Initializes console output formatter.
*
* @param OutputFormatterStyleInterface[] $styles Array of "name => FormatterStyle" instances
*/
public function __construct(bool $decorated = \false, array $styles = [])
{
$this->decorated = $decorated;
$this->setStyle('error', new OutputFormatterStyle('white', 'red'));
$this->setStyle('info', new OutputFormatterStyle('green'));
$this->setStyle('comment', new OutputFormatterStyle('yellow'));
$this->setStyle('question', new OutputFormatterStyle('black', 'cyan'));
foreach ($styles as $name => $style) {
$this->setStyle($name, $style);
}
$this->styleStack = new OutputFormatterStyleStack();
}
/**
* {@inheritdoc}
*/
public function setDecorated(bool $decorated)
{
$this->decorated = $decorated;
}
/**
* {@inheritdoc}
*/
public function isDecorated()
{
return $this->decorated;
}
/**
* {@inheritdoc}
*/
public function setStyle(string $name, OutputFormatterStyleInterface $style)
{
$this->styles[\strtolower($name)] = $style;
}
/**
* {@inheritdoc}
*/
public function hasStyle(string $name)
{
return isset($this->styles[\strtolower($name)]);
}
/**
* {@inheritdoc}
*/
public function getStyle(string $name)
{
if (!$this->hasStyle($name)) {
throw new InvalidArgumentException(\sprintf('Undefined style: "%s".', $name));
}
return $this->styles[\strtolower($name)];
}
/**
* {@inheritdoc}
*/
public function format(?string $message)
{
return $this->formatAndWrap($message, 0);
}
/**
* {@inheritdoc}
*/
public function formatAndWrap(?string $message, int $width)
{
if (null === $message) {
return '';
}
$offset = 0;
$output = '';
$openTagRegex = '[a-z](?:[^\\\\<>]*+ | \\\\.)*';
$closeTagRegex = '[a-z][^<>]*+';
$currentLineLength = 0;
\preg_match_all("#<(({$openTagRegex}) | /({$closeTagRegex})?)>#ix", $message, $matches, \PREG_OFFSET_CAPTURE);
foreach ($matches[0] as $i => $match) {
$pos = $match[1];
$text = $match[0];
if (0 != $pos && '\\' == $message[$pos - 1]) {
continue;
}
// add the text up to the next tag
$output .= $this->applyCurrentStyle(\substr($message, $offset, $pos - $offset), $output, $width, $currentLineLength);
$offset = $pos + \strlen($text);
// opening tag?
if ($open = '/' != $text[1]) {
$tag = $matches[1][$i][0];
} else {
$tag = $matches[3][$i][0] ?? '';
}
if (!$open && !$tag) {
// </>
$this->styleStack->pop();
} elseif (null === ($style = $this->createStyleFromString($tag))) {
$output .= $this->applyCurrentStyle($text, $output, $width, $currentLineLength);
} elseif ($open) {
$this->styleStack->push($style);
} else {
$this->styleStack->pop($style);
}
}
$output .= $this->applyCurrentStyle(\substr($message, $offset), $output, $width, $currentLineLength);
return \strtr($output, ["\x00" => '\\', '\\<' => '<', '\\>' => '>']);
}
/**
* @return OutputFormatterStyleStack
*/
public function getStyleStack()
{
return $this->styleStack;
}
/**
* Tries to create new style instance from string.
*/
private function createStyleFromString(string $string) : ?OutputFormatterStyleInterface
{
if (isset($this->styles[$string])) {
return $this->styles[$string];
}
if (!\preg_match_all('/([^=]+)=([^;]+)(;|$)/', $string, $matches, \PREG_SET_ORDER)) {
return null;
}
$style = new OutputFormatterStyle();
foreach ($matches as $match) {
\array_shift($match);
$match[0] = \strtolower($match[0]);
if ('fg' == $match[0]) {
$style->setForeground(\strtolower($match[1]));
} elseif ('bg' == $match[0]) {
$style->setBackground(\strtolower($match[1]));
} elseif ('href' === $match[0]) {
$url = \preg_replace('{\\\\([<>])}', '$1', $match[1]);
$style->setHref($url);
} elseif ('options' === $match[0]) {
\preg_match_all('([^,;]+)', \strtolower($match[1]), $options);
$options = \array_shift($options);
foreach ($options as $option) {
$style->setOption($option);
}
} else {
return null;
}
}
return $style;
}
/**
* Applies current style from stack to text, if must be applied.
*/
private function applyCurrentStyle(string $text, string $current, int $width, int &$currentLineLength) : string
{
if ('' === $text) {
return '';
}
if (!$width) {
return $this->isDecorated() ? $this->styleStack->getCurrent()->apply($text) : $text;
}
if (!$currentLineLength && '' !== $current) {
$text = \ltrim($text);
}
if ($currentLineLength) {
$prefix = \substr($text, 0, $i = $width - $currentLineLength) . "\n";
$text = \substr($text, $i);
} else {
$prefix = '';
}
\preg_match('~(\\n)$~', $text, $matches);
$text = $prefix . $this->addLineBreaks($text, $width);
$text = \rtrim($text, "\n") . ($matches[1] ?? '');
if (!$currentLineLength && '' !== $current && "\n" !== \substr($current, -1)) {
$text = "\n" . $text;
}
$lines = \explode("\n", $text);
foreach ($lines as $line) {
$currentLineLength += \strlen($line);
if ($width <= $currentLineLength) {
$currentLineLength = 0;
}
}
if ($this->isDecorated()) {
foreach ($lines as $i => $line) {
$lines[$i] = $this->styleStack->getCurrent()->apply($line);
}
}
return \implode("\n", $lines);
}
private function addLineBreaks(string $text, int $width) : string
{
$encoding = \mb_detect_encoding($text, null, \true) ?: 'UTF-8';
return b($text)->toCodePointString($encoding)->wordwrap($width, "\n", \true)->toByteString($encoding);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Formatter;
/**
* Formatter interface for console output.
*
* @author Konstantin Kudryashov <ever.zet@gmail.com>
*/
interface OutputFormatterInterface
{
/**
* Sets the decorated flag.
*/
public function setDecorated(bool $decorated);
/**
* Whether the output will decorate messages.
*
* @return bool
*/
public function isDecorated();
/**
* Sets a new style.
*/
public function setStyle(string $name, OutputFormatterStyleInterface $style);
/**
* Checks if output formatter has style with specified name.
*
* @return bool
*/
public function hasStyle(string $name);
/**
* Gets style options from style with specified name.
*
* @return OutputFormatterStyleInterface
*
* @throws \InvalidArgumentException When style isn't defined
*/
public function getStyle(string $name);
/**
* Formats a message according to the given styles.
*
* @return string|null
*/
public function format(?string $message);
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Formatter;
/**
* @author Tien Xuan Vo <tien.xuan.vo@gmail.com>
*/
final class NullOutputFormatter implements OutputFormatterInterface
{
private $style;
/**
* {@inheritdoc}
*/
public function format(?string $message) : ?string
{
return null;
}
/**
* {@inheritdoc}
*/
public function getStyle(string $name) : OutputFormatterStyleInterface
{
// to comply with the interface we must return a OutputFormatterStyleInterface
return $this->style ?? ($this->style = new NullOutputFormatterStyle());
}
/**
* {@inheritdoc}
*/
public function hasStyle(string $name) : bool
{
return \false;
}
/**
* {@inheritdoc}
*/
public function isDecorated() : bool
{
return \false;
}
/**
* {@inheritdoc}
*/
public function setDecorated(bool $decorated) : void
{
// do nothing
}
/**
* {@inheritdoc}
*/
public function setStyle(string $name, OutputFormatterStyleInterface $style) : void
{
// do nothing
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleCommandEvent;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleErrorEvent;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleSignalEvent;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleTerminateEvent;
/**
* Contains all events dispatched by an Application.
*
* @author Francesco Levorato <git@flevour.net>
*/
final class ConsoleEvents
{
/**
* The COMMAND event allows you to attach listeners before any command is
* executed by the console. It also allows you to modify the command, input and output
* before they are handed to the command.
*
* @Event("Symfony\Component\Console\Event\ConsoleCommandEvent")
*/
public const COMMAND = 'console.command';
/**
* The SIGNAL event allows you to perform some actions
* after the command execution was interrupted.
*
* @Event("Symfony\Component\Console\Event\ConsoleSignalEvent")
*/
public const SIGNAL = 'console.signal';
/**
* The TERMINATE event allows you to attach listeners after a command is
* executed by the console.
*
* @Event("Symfony\Component\Console\Event\ConsoleTerminateEvent")
*/
public const TERMINATE = 'console.terminate';
/**
* The ERROR event occurs when an uncaught exception or error appears.
*
* This event allows you to deal with the exception/error or
* to modify the thrown exception.
*
* @Event("Symfony\Component\Console\Event\ConsoleErrorEvent")
*/
public const ERROR = 'console.error';
/**
* Event aliases.
*
* These aliases can be consumed by RegisterListenersPass.
*/
public const ALIASES = [ConsoleCommandEvent::class => self::COMMAND, ConsoleErrorEvent::class => self::ERROR, ConsoleSignalEvent::class => self::SIGNAL, ConsoleTerminateEvent::class => self::TERMINATE];
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Event;
/**
* Allows to do things before the command is executed, like skipping the command or executing code before the command is
* going to be executed.
*
* Changing the input arguments will have no effect.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
final class ConsoleCommandEvent extends ConsoleEvent
{
/**
* The return code for skipped commands, this will also be passed into the terminate event.
*/
public const RETURN_CODE_DISABLED = 113;
/**
* Indicates if the command should be run or skipped.
*/
private $commandShouldRun = \true;
/**
* Disables the command, so it won't be run.
*/
public function disableCommand() : bool
{
return $this->commandShouldRun = \false;
}
public function enableCommand() : bool
{
return $this->commandShouldRun = \true;
}
/**
* Returns true if the command is runnable, false otherwise.
*/
public function commandShouldRun() : bool
{
return $this->commandShouldRun;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Event;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* Allows to manipulate the exit code of a command after its execution.
*
* @author Francesco Levorato <git@flevour.net>
*/
final class ConsoleTerminateEvent extends ConsoleEvent
{
private $exitCode;
public function __construct(Command $command, InputInterface $input, OutputInterface $output, int $exitCode)
{
parent::__construct($command, $input, $output);
$this->setExitCode($exitCode);
}
public function setExitCode(int $exitCode) : void
{
$this->exitCode = $exitCode;
}
public function getExitCode() : int
{
return $this->exitCode;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Event;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* Allows to handle throwables thrown while running a command.
*
* @author Wouter de Jong <wouter@wouterj.nl>
*/
final class ConsoleErrorEvent extends ConsoleEvent
{
private $error;
private $exitCode;
public function __construct(InputInterface $input, OutputInterface $output, \Throwable $error, ?Command $command = null)
{
parent::__construct($command, $input, $output);
$this->error = $error;
}
public function getError() : \Throwable
{
return $this->error;
}
public function setError(\Throwable $error) : void
{
$this->error = $error;
}
public function setExitCode(int $exitCode) : void
{
$this->exitCode = $exitCode;
$r = new \ReflectionProperty($this->error, 'code');
$r->setAccessible(\true);
$r->setValue($this->error, $this->exitCode);
}
public function getExitCode() : int
{
return $this->exitCode ?? (\is_int($this->error->getCode()) && 0 !== $this->error->getCode() ? $this->error->getCode() : 1);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Event;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* @author marie <marie@users.noreply.github.com>
*/
final class ConsoleSignalEvent extends ConsoleEvent
{
private $handlingSignal;
public function __construct(Command $command, InputInterface $input, OutputInterface $output, int $handlingSignal)
{
parent::__construct($command, $input, $output);
$this->handlingSignal = $handlingSignal;
}
public function getHandlingSignal() : int
{
return $this->handlingSignal;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Event;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Contracts\EventDispatcher\Event;
/**
* Allows to inspect input and output of a command.
*
* @author Francesco Levorato <git@flevour.net>
*/
class ConsoleEvent extends Event
{
protected $command;
private $input;
private $output;
public function __construct(?Command $command, InputInterface $input, OutputInterface $output)
{
$this->command = $command;
$this->input = $input;
$this->output = $output;
}
/**
* Gets the command that is executed.
*
* @return Command|null
*/
public function getCommand()
{
return $this->command;
}
/**
* Gets the input instance.
*
* @return InputInterface
*/
public function getInput()
{
return $this->input;
}
/**
* Gets the output instance.
*
* @return OutputInterface
*/
public function getOutput()
{
return $this->output;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* @author Grégoire Pineau <lyrixx@lyrixx.info>
*/
class SingleCommandApplication extends Command
{
private $version = 'UNKNOWN';
private $autoExit = \true;
private $running = \false;
/**
* @return $this
*/
public function setVersion(string $version) : self
{
$this->version = $version;
return $this;
}
/**
* @final
*
* @return $this
*/
public function setAutoExit(bool $autoExit) : self
{
$this->autoExit = $autoExit;
return $this;
}
public function run(?InputInterface $input = null, ?OutputInterface $output = null) : int
{
if ($this->running) {
return parent::run($input, $output);
}
// We use the command name as the application name
$application = new Application($this->getName() ?: 'UNKNOWN', $this->version);
$application->setAutoExit($this->autoExit);
// Fix the usage of the command displayed with "--help"
$this->setName($_SERVER['argv'][0]);
$application->add($this);
$application->setDefaultCommand($this->getName(), \true);
$this->running = \true;
try {
$ret = $application->run($input, $output);
} finally {
$this->running = \false;
}
return $ret ?? 1;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\SignalRegistry;
final class SignalRegistry
{
private $signalHandlers = [];
public function __construct()
{
if (\function_exists('pcntl_async_signals')) {
\pcntl_async_signals(\true);
}
}
public function register(int $signal, callable $signalHandler) : void
{
if (!isset($this->signalHandlers[$signal])) {
$previousCallback = \pcntl_signal_get_handler($signal);
if (\is_callable($previousCallback)) {
$this->signalHandlers[$signal][] = $previousCallback;
}
}
$this->signalHandlers[$signal][] = $signalHandler;
\pcntl_signal($signal, [$this, 'handle']);
}
public static function isSupported() : bool
{
if (!\function_exists('pcntl_signal')) {
return \false;
}
if (\in_array('pcntl_signal', \explode(',', \ini_get('disable_functions')))) {
return \false;
}
return \true;
}
/**
* @internal
*/
public function handle(int $signal) : void
{
$count = \count($this->signalHandlers[$signal]);
foreach ($this->signalHandlers[$signal] as $i => $signalHandler) {
$hasNext = $i !== $count - 1;
$signalHandler($signal, $hasNext);
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\DependencyInjection;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\LazyCommand;
use _PHPStan_6dcda722c\Symfony\Component\Console\CommandLoader\ContainerCommandLoader;
use _PHPStan_6dcda722c\Symfony\Component\DependencyInjection\Argument\ServiceClosureArgument;
use _PHPStan_6dcda722c\Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
use _PHPStan_6dcda722c\Symfony\Component\DependencyInjection\Compiler\ServiceLocatorTagPass;
use _PHPStan_6dcda722c\Symfony\Component\DependencyInjection\ContainerBuilder;
use _PHPStan_6dcda722c\Symfony\Component\DependencyInjection\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\DependencyInjection\Reference;
use _PHPStan_6dcda722c\Symfony\Component\DependencyInjection\TypedReference;
/**
* Registers console commands.
*
* @author Grégoire Pineau <lyrixx@lyrixx.info>
*/
class AddConsoleCommandPass implements CompilerPassInterface
{
private $commandLoaderServiceId;
private $commandTag;
private $noPreloadTag;
private $privateTagName;
public function __construct(string $commandLoaderServiceId = 'console.command_loader', string $commandTag = 'console.command', string $noPreloadTag = 'container.no_preload', string $privateTagName = 'container.private')
{
if (0 < \func_num_args()) {
trigger_deprecation('symfony/console', '5.3', 'Configuring "%s" is deprecated.', __CLASS__);
}
$this->commandLoaderServiceId = $commandLoaderServiceId;
$this->commandTag = $commandTag;
$this->noPreloadTag = $noPreloadTag;
$this->privateTagName = $privateTagName;
}
public function process(ContainerBuilder $container)
{
$commandServices = $container->findTaggedServiceIds($this->commandTag, \true);
$lazyCommandMap = [];
$lazyCommandRefs = [];
$serviceIds = [];
foreach ($commandServices as $id => $tags) {
$definition = $container->getDefinition($id);
$definition->addTag($this->noPreloadTag);
$class = $container->getParameterBag()->resolveValue($definition->getClass());
if (isset($tags[0]['command'])) {
$aliases = $tags[0]['command'];
} else {
if (!($r = $container->getReflectionClass($class))) {
throw new InvalidArgumentException(\sprintf('Class "%s" used for service "%s" cannot be found.', $class, $id));
}
if (!$r->isSubclassOf(Command::class)) {
throw new InvalidArgumentException(\sprintf('The service "%s" tagged "%s" must be a subclass of "%s".', $id, $this->commandTag, Command::class));
}
$aliases = \str_replace('%', '%%', $class::getDefaultName() ?? '');
}
$aliases = \explode('|', $aliases ?? '');
$commandName = \array_shift($aliases);
if ($isHidden = '' === $commandName) {
$commandName = \array_shift($aliases);
}
if (null === $commandName) {
if (!$definition->isPublic() || $definition->isPrivate() || $definition->hasTag($this->privateTagName)) {
$commandId = 'console.command.public_alias.' . $id;
$container->setAlias($commandId, $id)->setPublic(\true);
$id = $commandId;
}
$serviceIds[] = $id;
continue;
}
$description = $tags[0]['description'] ?? null;
unset($tags[0]);
$lazyCommandMap[$commandName] = $id;
$lazyCommandRefs[$id] = new TypedReference($id, $class);
foreach ($aliases as $alias) {
$lazyCommandMap[$alias] = $id;
}
foreach ($tags as $tag) {
if (isset($tag['command'])) {
$aliases[] = $tag['command'];
$lazyCommandMap[$tag['command']] = $id;
}
$description = $description ?? $tag['description'] ?? null;
}
$definition->addMethodCall('setName', [$commandName]);
if ($aliases) {
$definition->addMethodCall('setAliases', [$aliases]);
}
if ($isHidden) {
$definition->addMethodCall('setHidden', [\true]);
}
if (!$description) {
if (!($r = $container->getReflectionClass($class))) {
throw new InvalidArgumentException(\sprintf('Class "%s" used for service "%s" cannot be found.', $class, $id));
}
if (!$r->isSubclassOf(Command::class)) {
throw new InvalidArgumentException(\sprintf('The service "%s" tagged "%s" must be a subclass of "%s".', $id, $this->commandTag, Command::class));
}
$description = \str_replace('%', '%%', $class::getDefaultDescription() ?? '');
}
if ($description) {
$definition->addMethodCall('setDescription', [$description]);
$container->register('.' . $id . '.lazy', LazyCommand::class)->setArguments([$commandName, $aliases, $description, $isHidden, new ServiceClosureArgument($lazyCommandRefs[$id])]);
$lazyCommandRefs[$id] = new Reference('.' . $id . '.lazy');
}
}
$container->register($this->commandLoaderServiceId, ContainerCommandLoader::class)->setPublic(\true)->addTag($this->noPreloadTag)->setArguments([ServiceLocatorTagPass::register($container, $lazyCommandRefs), $lazyCommandMap]);
$container->setParameter('console.command.ids', $serviceIds);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\EventListener;
use _PHPStan_6dcda722c\Psr\Log\LoggerInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\ConsoleEvents;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleErrorEvent;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleEvent;
use _PHPStan_6dcda722c\Symfony\Component\Console\Event\ConsoleTerminateEvent;
use _PHPStan_6dcda722c\Symfony\Component\EventDispatcher\EventSubscriberInterface;
/**
* @author James Halsall <james.t.halsall@googlemail.com>
* @author Robin Chalas <robin.chalas@gmail.com>
*/
class ErrorListener implements EventSubscriberInterface
{
private $logger;
public function __construct(?LoggerInterface $logger = null)
{
$this->logger = $logger;
}
public function onConsoleError(ConsoleErrorEvent $event)
{
if (null === $this->logger) {
return;
}
$error = $event->getError();
if (!($inputString = $this->getInputString($event))) {
$this->logger->critical('An error occurred while using the console. Message: "{message}"', ['exception' => $error, 'message' => $error->getMessage()]);
return;
}
$this->logger->critical('Error thrown while running command "{command}". Message: "{message}"', ['exception' => $error, 'command' => $inputString, 'message' => $error->getMessage()]);
}
public function onConsoleTerminate(ConsoleTerminateEvent $event)
{
if (null === $this->logger) {
return;
}
$exitCode = $event->getExitCode();
if (0 === $exitCode) {
return;
}
if (!($inputString = $this->getInputString($event))) {
$this->logger->debug('The console exited with code "{code}"', ['code' => $exitCode]);
return;
}
$this->logger->debug('Command "{command}" exited with code "{code}"', ['command' => $inputString, 'code' => $exitCode]);
}
public static function getSubscribedEvents()
{
return [ConsoleEvents::ERROR => ['onConsoleError', -128], ConsoleEvents::TERMINATE => ['onConsoleTerminate', -128]];
}
private static function getInputString(ConsoleEvent $event) : ?string
{
$commandName = $event->getCommand() ? $event->getCommand()->getName() : null;
$input = $event->getInput();
if (\method_exists($input, '__toString')) {
if ($commandName) {
return \str_replace(["'{$commandName}'", "\"{$commandName}\""], $commandName, (string) $input);
}
return (string) $input;
}
return $commandName;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console;
class Terminal
{
private static $width;
private static $height;
private static $stty;
/**
* Gets the terminal width.
*
* @return int
*/
public function getWidth()
{
$width = \getenv('COLUMNS');
if (\false !== $width) {
return (int) \trim($width);
}
if (null === self::$width) {
self::initDimensions();
}
return self::$width ?: 80;
}
/**
* Gets the terminal height.
*
* @return int
*/
public function getHeight()
{
$height = \getenv('LINES');
if (\false !== $height) {
return (int) \trim($height);
}
if (null === self::$height) {
self::initDimensions();
}
return self::$height ?: 50;
}
/**
* @internal
*/
public static function hasSttyAvailable() : bool
{
if (null !== self::$stty) {
return self::$stty;
}
// skip check if shell_exec function is disabled
if (!\function_exists('shell_exec')) {
return \false;
}
return self::$stty = (bool) \shell_exec('stty 2> ' . ('\\' === \DIRECTORY_SEPARATOR ? 'NUL' : '/dev/null'));
}
private static function initDimensions()
{
if ('\\' === \DIRECTORY_SEPARATOR) {
$ansicon = \getenv('ANSICON');
if (\false !== $ansicon && \preg_match('/^(\\d+)x(\\d+)(?: \\((\\d+)x(\\d+)\\))?$/', \trim($ansicon), $matches)) {
// extract [w, H] from "wxh (WxH)"
// or [w, h] from "wxh"
self::$width = (int) $matches[1];
self::$height = isset($matches[4]) ? (int) $matches[4] : (int) $matches[2];
} elseif (!self::hasVt100Support() && self::hasSttyAvailable()) {
// only use stty on Windows if the terminal does not support vt100 (e.g. Windows 7 + git-bash)
// testing for stty in a Windows 10 vt100-enabled console will implicitly disable vt100 support on STDOUT
self::initDimensionsUsingStty();
} elseif (null !== ($dimensions = self::getConsoleMode())) {
// extract [w, h] from "wxh"
self::$width = (int) $dimensions[0];
self::$height = (int) $dimensions[1];
}
} else {
self::initDimensionsUsingStty();
}
}
/**
* Returns whether STDOUT has vt100 support (some Windows 10+ configurations).
*/
private static function hasVt100Support() : bool
{
return \function_exists('sapi_windows_vt100_support') && \sapi_windows_vt100_support(\fopen('php://stdout', 'w'));
}
/**
* Initializes dimensions using the output of an stty columns line.
*/
private static function initDimensionsUsingStty()
{
if ($sttyString = self::getSttyColumns()) {
if (\preg_match('/rows.(\\d+);.columns.(\\d+);/i', $sttyString, $matches)) {
// extract [w, h] from "rows h; columns w;"
self::$width = (int) $matches[2];
self::$height = (int) $matches[1];
} elseif (\preg_match('/;.(\\d+).rows;.(\\d+).columns/i', $sttyString, $matches)) {
// extract [w, h] from "; h rows; w columns"
self::$width = (int) $matches[2];
self::$height = (int) $matches[1];
}
}
}
/**
* Runs and parses mode CON if it's available, suppressing any error output.
*
* @return int[]|null An array composed of the width and the height or null if it could not be parsed
*/
private static function getConsoleMode() : ?array
{
$info = self::readFromProcess('mode CON');
if (null === $info || !\preg_match('/--------+\\r?\\n.+?(\\d+)\\r?\\n.+?(\\d+)\\r?\\n/', $info, $matches)) {
return null;
}
return [(int) $matches[2], (int) $matches[1]];
}
/**
* Runs and parses stty -a if it's available, suppressing any error output.
*/
private static function getSttyColumns() : ?string
{
return self::readFromProcess('stty -a | grep columns');
}
private static function readFromProcess(string $command) : ?string
{
if (!\function_exists('proc_open')) {
return null;
}
$descriptorspec = [1 => ['pipe', 'w'], 2 => ['pipe', 'w']];
$cp = \function_exists('sapi_windows_cp_set') ? \sapi_windows_cp_get() : 0;
$process = \proc_open($command, $descriptorspec, $pipes, null, null, ['suppress_errors' => \true]);
if (!\is_resource($process)) {
return null;
}
$info = \stream_get_contents($pipes[1]);
\fclose($pipes[1]);
\fclose($pipes[2]);
\proc_close($process);
if ($cp) {
\sapi_windows_cp_set($cp);
}
return $info;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Output;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatterInterface;
/**
* StreamOutput writes the output to a given stream.
*
* Usage:
*
* $output = new StreamOutput(fopen('php://stdout', 'w'));
*
* As `StreamOutput` can use any stream, you can also use a file:
*
* $output = new StreamOutput(fopen('/path/to/output.log', 'a', false));
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class StreamOutput extends Output
{
private $stream;
/**
* @param resource $stream A stream resource
* @param int $verbosity The verbosity level (one of the VERBOSITY constants in OutputInterface)
* @param bool|null $decorated Whether to decorate messages (null for auto-guessing)
* @param OutputFormatterInterface|null $formatter Output formatter instance (null to use default OutputFormatter)
*
* @throws InvalidArgumentException When first argument is not a real stream
*/
public function __construct($stream, int $verbosity = self::VERBOSITY_NORMAL, ?bool $decorated = null, ?OutputFormatterInterface $formatter = null)
{
if (!\is_resource($stream) || 'stream' !== \get_resource_type($stream)) {
throw new InvalidArgumentException('The StreamOutput class needs a stream as its first argument.');
}
$this->stream = $stream;
if (null === $decorated) {
$decorated = $this->hasColorSupport();
}
parent::__construct($verbosity, $decorated, $formatter);
}
/**
* Gets the stream attached to this StreamOutput instance.
*
* @return resource
*/
public function getStream()
{
return $this->stream;
}
protected function doWrite(string $message, bool $newline)
{
if ($newline) {
$message .= \PHP_EOL;
}
@\fwrite($this->stream, $message);
\fflush($this->stream);
}
/**
* Returns true if the stream supports colorization.
*
* Colorization is disabled if not supported by the stream:
*
* This is tricky on Windows, because Cygwin, Msys2 etc emulate pseudo
* terminals via named pipes, so we can only check the environment.
*
* Reference: Composer\XdebugHandler\Process::supportsColor
* https://github.com/composer/xdebug-handler
*
* @return bool true if the stream supports colorization, false otherwise
*/
protected function hasColorSupport()
{
// Follow https://no-color.org/
if (isset($_SERVER['NO_COLOR']) || \false !== \getenv('NO_COLOR')) {
return \false;
}
// Detect msysgit/mingw and assume this is a tty because detection
// does not work correctly, see https://github.com/composer/composer/issues/9690
if (!@\stream_isatty($this->stream) && !\in_array(\strtoupper((string) \getenv('MSYSTEM')), ['MINGW32', 'MINGW64'], \true)) {
return \false;
}
if ('\\' === \DIRECTORY_SEPARATOR && @\sapi_windows_vt100_support($this->stream)) {
return \true;
}
if ('Hyper' === \getenv('TERM_PROGRAM') || \false !== \getenv('COLORTERM') || \false !== \getenv('ANSICON') || 'ON' === \getenv('ConEmuANSI')) {
return \true;
}
if ('dumb' === ($term = (string) \getenv('TERM'))) {
return \false;
}
// See https://github.com/chalk/supports-color/blob/d4f413efaf8da045c5ab440ed418ef02dbb28bf1/index.js#L157
return \preg_match('/^((screen|xterm|vt100|vt220|putty|rxvt|ansi|cygwin|linux).*)|(.*-256(color)?(-bce)?)$/', $term);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Output;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatterInterface;
/**
* ConsoleOutput is the default class for all CLI output. It uses STDOUT and STDERR.
*
* This class is a convenient wrapper around `StreamOutput` for both STDOUT and STDERR.
*
* $output = new ConsoleOutput();
*
* This is equivalent to:
*
* $output = new StreamOutput(fopen('php://stdout', 'w'));
* $stdErr = new StreamOutput(fopen('php://stderr', 'w'));
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class ConsoleOutput extends StreamOutput implements ConsoleOutputInterface
{
private $stderr;
private $consoleSectionOutputs = [];
/**
* @param int $verbosity The verbosity level (one of the VERBOSITY constants in OutputInterface)
* @param bool|null $decorated Whether to decorate messages (null for auto-guessing)
* @param OutputFormatterInterface|null $formatter Output formatter instance (null to use default OutputFormatter)
*/
public function __construct(int $verbosity = self::VERBOSITY_NORMAL, ?bool $decorated = null, ?OutputFormatterInterface $formatter = null)
{
parent::__construct($this->openOutputStream(), $verbosity, $decorated, $formatter);
if (null === $formatter) {
// for BC reasons, stdErr has it own Formatter only when user don't inject a specific formatter.
$this->stderr = new StreamOutput($this->openErrorStream(), $verbosity, $decorated);
return;
}
$actualDecorated = $this->isDecorated();
$this->stderr = new StreamOutput($this->openErrorStream(), $verbosity, $decorated, $this->getFormatter());
if (null === $decorated) {
$this->setDecorated($actualDecorated && $this->stderr->isDecorated());
}
}
/**
* Creates a new output section.
*/
public function section() : ConsoleSectionOutput
{
return new ConsoleSectionOutput($this->getStream(), $this->consoleSectionOutputs, $this->getVerbosity(), $this->isDecorated(), $this->getFormatter());
}
/**
* {@inheritdoc}
*/
public function setDecorated(bool $decorated)
{
parent::setDecorated($decorated);
$this->stderr->setDecorated($decorated);
}
/**
* {@inheritdoc}
*/
public function setFormatter(OutputFormatterInterface $formatter)
{
parent::setFormatter($formatter);
$this->stderr->setFormatter($formatter);
}
/**
* {@inheritdoc}
*/
public function setVerbosity(int $level)
{
parent::setVerbosity($level);
$this->stderr->setVerbosity($level);
}
/**
* {@inheritdoc}
*/
public function getErrorOutput()
{
return $this->stderr;
}
/**
* {@inheritdoc}
*/
public function setErrorOutput(OutputInterface $error)
{
$this->stderr = $error;
}
/**
* Returns true if current environment supports writing console output to
* STDOUT.
*
* @return bool
*/
protected function hasStdoutSupport()
{
return \false === $this->isRunningOS400();
}
/**
* Returns true if current environment supports writing console output to
* STDERR.
*
* @return bool
*/
protected function hasStderrSupport()
{
return \false === $this->isRunningOS400();
}
/**
* Checks if current executing environment is IBM iSeries (OS400), which
* doesn't properly convert character-encodings between ASCII to EBCDIC.
*/
private function isRunningOS400() : bool
{
$checks = [\function_exists('php_uname') ? \php_uname('s') : '', \getenv('OSTYPE'), \PHP_OS];
return \false !== \stripos(\implode(';', $checks), 'OS400');
}
/**
* @return resource
*/
private function openOutputStream()
{
if (!$this->hasStdoutSupport()) {
return \fopen('php://output', 'w');
}
// Use STDOUT when possible to prevent from opening too many file descriptors
return \defined('STDOUT') ? \STDOUT : (@\fopen('php://stdout', 'w') ?: \fopen('php://output', 'w'));
}
/**
* @return resource
*/
private function openErrorStream()
{
if (!$this->hasStderrSupport()) {
return \fopen('php://output', 'w');
}
// Use STDERR when possible to prevent from opening too many file descriptors
return \defined('STDERR') ? \STDERR : (@\fopen('php://stderr', 'w') ?: \fopen('php://output', 'w'));
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Output;
/**
* @author Jean-François Simon <contact@jfsimon.fr>
*/
class BufferedOutput extends Output
{
private $buffer = '';
/**
* Empties buffer and returns its content.
*
* @return string
*/
public function fetch()
{
$content = $this->buffer;
$this->buffer = '';
return $content;
}
/**
* {@inheritdoc}
*/
protected function doWrite(string $message, bool $newline)
{
$this->buffer .= $message;
if ($newline) {
$this->buffer .= \PHP_EOL;
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Output;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatterInterface;
/**
* OutputInterface is the interface implemented by all Output classes.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
interface OutputInterface
{
public const VERBOSITY_QUIET = 16;
public const VERBOSITY_NORMAL = 32;
public const VERBOSITY_VERBOSE = 64;
public const VERBOSITY_VERY_VERBOSE = 128;
public const VERBOSITY_DEBUG = 256;
public const OUTPUT_NORMAL = 1;
public const OUTPUT_RAW = 2;
public const OUTPUT_PLAIN = 4;
/**
* Writes a message to the output.
*
* @param string|iterable $messages The message as an iterable of strings or a single string
* @param bool $newline Whether to add a newline
* @param int $options A bitmask of options (one of the OUTPUT or VERBOSITY constants), 0 is considered the same as self::OUTPUT_NORMAL | self::VERBOSITY_NORMAL
*/
public function write($messages, bool $newline = \false, int $options = 0);
/**
* Writes a message to the output and adds a newline at the end.
*
* @param string|iterable $messages The message as an iterable of strings or a single string
* @param int $options A bitmask of options (one of the OUTPUT or VERBOSITY constants), 0 is considered the same as self::OUTPUT_NORMAL | self::VERBOSITY_NORMAL
*/
public function writeln($messages, int $options = 0);
/**
* Sets the verbosity of the output.
*/
public function setVerbosity(int $level);
/**
* Gets the current verbosity of the output.
*
* @return int
*/
public function getVerbosity();
/**
* Returns whether verbosity is quiet (-q).
*
* @return bool
*/
public function isQuiet();
/**
* Returns whether verbosity is verbose (-v).
*
* @return bool
*/
public function isVerbose();
/**
* Returns whether verbosity is very verbose (-vv).
*
* @return bool
*/
public function isVeryVerbose();
/**
* Returns whether verbosity is debug (-vvv).
*
* @return bool
*/
public function isDebug();
/**
* Sets the decorated flag.
*/
public function setDecorated(bool $decorated);
/**
* Gets the decorated flag.
*
* @return bool
*/
public function isDecorated();
public function setFormatter(OutputFormatterInterface $formatter);
/**
* Returns current output formatter instance.
*
* @return OutputFormatterInterface
*/
public function getFormatter();
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Output;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatterInterface;
/**
* Base class for output classes.
*
* There are five levels of verbosity:
*
* * normal: no option passed (normal output)
* * verbose: -v (more output)
* * very verbose: -vv (highly extended output)
* * debug: -vvv (all debug output)
* * quiet: -q (no output)
*
* @author Fabien Potencier <fabien@symfony.com>
*/
abstract class Output implements OutputInterface
{
private $verbosity;
private $formatter;
/**
* @param int|null $verbosity The verbosity level (one of the VERBOSITY constants in OutputInterface)
* @param bool $decorated Whether to decorate messages
* @param OutputFormatterInterface|null $formatter Output formatter instance (null to use default OutputFormatter)
*/
public function __construct(?int $verbosity = self::VERBOSITY_NORMAL, bool $decorated = \false, ?OutputFormatterInterface $formatter = null)
{
$this->verbosity = $verbosity ?? self::VERBOSITY_NORMAL;
$this->formatter = $formatter ?? new OutputFormatter();
$this->formatter->setDecorated($decorated);
}
/**
* {@inheritdoc}
*/
public function setFormatter(OutputFormatterInterface $formatter)
{
$this->formatter = $formatter;
}
/**
* {@inheritdoc}
*/
public function getFormatter()
{
return $this->formatter;
}
/**
* {@inheritdoc}
*/
public function setDecorated(bool $decorated)
{
$this->formatter->setDecorated($decorated);
}
/**
* {@inheritdoc}
*/
public function isDecorated()
{
return $this->formatter->isDecorated();
}
/**
* {@inheritdoc}
*/
public function setVerbosity(int $level)
{
$this->verbosity = $level;
}
/**
* {@inheritdoc}
*/
public function getVerbosity()
{
return $this->verbosity;
}
/**
* {@inheritdoc}
*/
public function isQuiet()
{
return self::VERBOSITY_QUIET === $this->verbosity;
}
/**
* {@inheritdoc}
*/
public function isVerbose()
{
return self::VERBOSITY_VERBOSE <= $this->verbosity;
}
/**
* {@inheritdoc}
*/
public function isVeryVerbose()
{
return self::VERBOSITY_VERY_VERBOSE <= $this->verbosity;
}
/**
* {@inheritdoc}
*/
public function isDebug()
{
return self::VERBOSITY_DEBUG <= $this->verbosity;
}
/**
* {@inheritdoc}
*/
public function writeln($messages, int $options = self::OUTPUT_NORMAL)
{
$this->write($messages, \true, $options);
}
/**
* {@inheritdoc}
*/
public function write($messages, bool $newline = \false, int $options = self::OUTPUT_NORMAL)
{
if (!\is_iterable($messages)) {
$messages = [$messages];
}
$types = self::OUTPUT_NORMAL | self::OUTPUT_RAW | self::OUTPUT_PLAIN;
$type = $types & $options ?: self::OUTPUT_NORMAL;
$verbosities = self::VERBOSITY_QUIET | self::VERBOSITY_NORMAL | self::VERBOSITY_VERBOSE | self::VERBOSITY_VERY_VERBOSE | self::VERBOSITY_DEBUG;
$verbosity = $verbosities & $options ?: self::VERBOSITY_NORMAL;
if ($verbosity > $this->getVerbosity()) {
return;
}
foreach ($messages as $message) {
switch ($type) {
case OutputInterface::OUTPUT_NORMAL:
$message = $this->formatter->format($message);
break;
case OutputInterface::OUTPUT_RAW:
break;
case OutputInterface::OUTPUT_PLAIN:
$message = \strip_tags($this->formatter->format($message));
break;
}
$this->doWrite($message ?? '', $newline);
}
}
/**
* Writes a message to the output.
*/
protected abstract function doWrite(string $message, bool $newline);
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Output;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\NullOutputFormatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatterInterface;
/**
* NullOutput suppresses all output.
*
* $output = new NullOutput();
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Tobias Schultze <http://tobion.de>
*/
class NullOutput implements OutputInterface
{
private $formatter;
/**
* {@inheritdoc}
*/
public function setFormatter(OutputFormatterInterface $formatter)
{
// do nothing
}
/**
* {@inheritdoc}
*/
public function getFormatter()
{
if ($this->formatter) {
return $this->formatter;
}
// to comply with the interface we must return a OutputFormatterInterface
return $this->formatter = new NullOutputFormatter();
}
/**
* {@inheritdoc}
*/
public function setDecorated(bool $decorated)
{
// do nothing
}
/**
* {@inheritdoc}
*/
public function isDecorated()
{
return \false;
}
/**
* {@inheritdoc}
*/
public function setVerbosity(int $level)
{
// do nothing
}
/**
* {@inheritdoc}
*/
public function getVerbosity()
{
return self::VERBOSITY_QUIET;
}
/**
* {@inheritdoc}
*/
public function isQuiet()
{
return \true;
}
/**
* {@inheritdoc}
*/
public function isVerbose()
{
return \false;
}
/**
* {@inheritdoc}
*/
public function isVeryVerbose()
{
return \false;
}
/**
* {@inheritdoc}
*/
public function isDebug()
{
return \false;
}
/**
* {@inheritdoc}
*/
public function writeln($messages, int $options = self::OUTPUT_NORMAL)
{
// do nothing
}
/**
* {@inheritdoc}
*/
public function write($messages, bool $newline = \false, int $options = self::OUTPUT_NORMAL)
{
// do nothing
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Output;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatterInterface;
/**
* A BufferedOutput that keeps only the last N chars.
*
* @author Jérémy Derussé <jeremy@derusse.com>
*/
class TrimmedBufferOutput extends Output
{
private $maxLength;
private $buffer = '';
public function __construct(int $maxLength, ?int $verbosity = self::VERBOSITY_NORMAL, bool $decorated = \false, ?OutputFormatterInterface $formatter = null)
{
if ($maxLength <= 0) {
throw new InvalidArgumentException(\sprintf('"%s()" expects a strictly positive maxLength. Got %d.', __METHOD__, $maxLength));
}
parent::__construct($verbosity, $decorated, $formatter);
$this->maxLength = $maxLength;
}
/**
* Empties buffer and returns its content.
*
* @return string
*/
public function fetch()
{
$content = $this->buffer;
$this->buffer = '';
return $content;
}
/**
* {@inheritdoc}
*/
protected function doWrite(string $message, bool $newline)
{
$this->buffer .= $message;
if ($newline) {
$this->buffer .= \PHP_EOL;
}
$this->buffer = \substr($this->buffer, 0 - $this->maxLength);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Output;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatterInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Terminal;
/**
* @author Pierre du Plessis <pdples@gmail.com>
* @author Gabriel Ostrolucký <gabriel.ostrolucky@gmail.com>
*/
class ConsoleSectionOutput extends StreamOutput
{
private $content = [];
private $lines = 0;
private $sections;
private $terminal;
/**
* @param resource $stream
* @param ConsoleSectionOutput[] $sections
*/
public function __construct($stream, array &$sections, int $verbosity, bool $decorated, OutputFormatterInterface $formatter)
{
parent::__construct($stream, $verbosity, $decorated, $formatter);
\array_unshift($sections, $this);
$this->sections =& $sections;
$this->terminal = new Terminal();
}
/**
* Clears previous output for this section.
*
* @param int $lines Number of lines to clear. If null, then the entire output of this section is cleared
*/
public function clear(?int $lines = null)
{
if (empty($this->content) || !$this->isDecorated()) {
return;
}
if ($lines) {
\array_splice($this->content, -($lines * 2));
// Multiply lines by 2 to cater for each new line added between content
} else {
$lines = $this->lines;
$this->content = [];
}
$this->lines -= $lines;
parent::doWrite($this->popStreamContentUntilCurrentSection($lines), \false);
}
/**
* Overwrites the previous output with a new message.
*
* @param array|string $message
*/
public function overwrite($message)
{
$this->clear();
$this->writeln($message);
}
public function getContent() : string
{
return \implode('', $this->content);
}
/**
* @internal
*/
public function addContent(string $input)
{
foreach (\explode(\PHP_EOL, $input) as $lineContent) {
$this->lines += \ceil($this->getDisplayLength($lineContent) / $this->terminal->getWidth()) ?: 1;
$this->content[] = $lineContent;
$this->content[] = \PHP_EOL;
}
}
/**
* {@inheritdoc}
*/
protected function doWrite(string $message, bool $newline)
{
if (!$this->isDecorated()) {
parent::doWrite($message, $newline);
return;
}
$erasedContent = $this->popStreamContentUntilCurrentSection();
$this->addContent($message);
parent::doWrite($message, \true);
parent::doWrite($erasedContent, \false);
}
/**
* At initial stage, cursor is at the end of stream output. This method makes cursor crawl upwards until it hits
* current section. Then it erases content it crawled through. Optionally, it erases part of current section too.
*/
private function popStreamContentUntilCurrentSection(int $numberOfLinesToClearFromCurrentSection = 0) : string
{
$numberOfLinesToClear = $numberOfLinesToClearFromCurrentSection;
$erasedContent = [];
foreach ($this->sections as $section) {
if ($section === $this) {
break;
}
$numberOfLinesToClear += $section->lines;
$erasedContent[] = $section->getContent();
}
if ($numberOfLinesToClear > 0) {
// move cursor up n lines
parent::doWrite(\sprintf("\x1b[%dA", $numberOfLinesToClear), \false);
// erase to end of screen
parent::doWrite("\x1b[0J", \false);
}
return \implode('', \array_reverse($erasedContent));
}
private function getDisplayLength(string $text) : int
{
return Helper::width(Helper::removeDecoration($this->getFormatter(), \str_replace("\t", ' ', $text)));
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Output;
/**
* ConsoleOutputInterface is the interface implemented by ConsoleOutput class.
* This adds information about stderr and section output stream.
*
* @author Dariusz Górecki <darek.krk@gmail.com>
*/
interface ConsoleOutputInterface extends OutputInterface
{
/**
* Gets the OutputInterface for errors.
*
* @return OutputInterface
*/
public function getErrorOutput();
public function setErrorOutput(OutputInterface $error);
public function section() : ConsoleSectionOutput;
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Question;
/**
* Represents a yes/no question.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class ConfirmationQuestion extends Question
{
private $trueAnswerRegex;
/**
* @param string $question The question to ask to the user
* @param bool $default The default answer to return, true or false
* @param string $trueAnswerRegex A regex to match the "yes" answer
*/
public function __construct(string $question, bool $default = \true, string $trueAnswerRegex = '/^y/i')
{
parent::__construct($question, $default);
$this->trueAnswerRegex = $trueAnswerRegex;
$this->setNormalizer($this->getDefaultNormalizer());
}
/**
* Returns the default answer normalizer.
*/
private function getDefaultNormalizer() : callable
{
$default = $this->getDefault();
$regex = $this->trueAnswerRegex;
return function ($answer) use($default, $regex) {
if (\is_bool($answer)) {
return $answer;
}
$answerIsTrue = (bool) \preg_match($regex, $answer);
if (\false === $default) {
return $answer && $answerIsTrue;
}
return '' === $answer || $answerIsTrue;
};
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Question;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
/**
* Represents a choice question.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class ChoiceQuestion extends Question
{
private $choices;
private $multiselect = \false;
private $prompt = ' > ';
private $errorMessage = 'Value "%s" is invalid';
/**
* @param string $question The question to ask to the user
* @param array $choices The list of available choices
* @param mixed $default The default answer to return
*/
public function __construct(string $question, array $choices, $default = null)
{
if (!$choices) {
throw new \LogicException('Choice question must have at least 1 choice available.');
}
parent::__construct($question, $default);
$this->choices = $choices;
$this->setValidator($this->getDefaultValidator());
$this->setAutocompleterValues($choices);
}
/**
* Returns available choices.
*
* @return array
*/
public function getChoices()
{
return $this->choices;
}
/**
* Sets multiselect option.
*
* When multiselect is set to true, multiple choices can be answered.
*
* @return $this
*/
public function setMultiselect(bool $multiselect)
{
$this->multiselect = $multiselect;
$this->setValidator($this->getDefaultValidator());
return $this;
}
/**
* Returns whether the choices are multiselect.
*
* @return bool
*/
public function isMultiselect()
{
return $this->multiselect;
}
/**
* Gets the prompt for choices.
*
* @return string
*/
public function getPrompt()
{
return $this->prompt;
}
/**
* Sets the prompt for choices.
*
* @return $this
*/
public function setPrompt(string $prompt)
{
$this->prompt = $prompt;
return $this;
}
/**
* Sets the error message for invalid values.
*
* The error message has a string placeholder (%s) for the invalid value.
*
* @return $this
*/
public function setErrorMessage(string $errorMessage)
{
$this->errorMessage = $errorMessage;
$this->setValidator($this->getDefaultValidator());
return $this;
}
private function getDefaultValidator() : callable
{
$choices = $this->choices;
$errorMessage = $this->errorMessage;
$multiselect = $this->multiselect;
$isAssoc = $this->isAssoc($choices);
return function ($selected) use($choices, $errorMessage, $multiselect, $isAssoc) {
if ($multiselect) {
// Check for a separated comma values
if (!\preg_match('/^[^,]+(?:,[^,]+)*$/', (string) $selected, $matches)) {
throw new InvalidArgumentException(\sprintf($errorMessage, $selected));
}
$selectedChoices = \explode(',', (string) $selected);
} else {
$selectedChoices = [$selected];
}
if ($this->isTrimmable()) {
foreach ($selectedChoices as $k => $v) {
$selectedChoices[$k] = \trim((string) $v);
}
}
$multiselectChoices = [];
foreach ($selectedChoices as $value) {
$results = [];
foreach ($choices as $key => $choice) {
if ($choice === $value) {
$results[] = $key;
}
}
if (\count($results) > 1) {
throw new InvalidArgumentException(\sprintf('The provided answer is ambiguous. Value should be one of "%s".', \implode('" or "', $results)));
}
$result = \array_search($value, $choices);
if (!$isAssoc) {
if (\false !== $result) {
$result = $choices[$result];
} elseif (isset($choices[$value])) {
$result = $choices[$value];
}
} elseif (\false === $result && isset($choices[$value])) {
$result = $value;
}
if (\false === $result) {
throw new InvalidArgumentException(\sprintf($errorMessage, $value));
}
// For associative choices, consistently return the key as string:
$multiselectChoices[] = $isAssoc ? (string) $result : $result;
}
if ($multiselect) {
return $multiselectChoices;
}
return \current($multiselectChoices);
};
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Question;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\LogicException;
/**
* Represents a Question.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class Question
{
private $question;
private $attempts;
private $hidden = \false;
private $hiddenFallback = \true;
private $autocompleterCallback;
private $validator;
private $default;
private $normalizer;
private $trimmable = \true;
private $multiline = \false;
/**
* @param string $question The question to ask to the user
* @param string|bool|int|float|null $default The default answer to return if the user enters nothing
*/
public function __construct(string $question, $default = null)
{
$this->question = $question;
$this->default = $default;
}
/**
* Returns the question.
*
* @return string
*/
public function getQuestion()
{
return $this->question;
}
/**
* Returns the default answer.
*
* @return string|bool|int|float|null
*/
public function getDefault()
{
return $this->default;
}
/**
* Returns whether the user response accepts newline characters.
*/
public function isMultiline() : bool
{
return $this->multiline;
}
/**
* Sets whether the user response should accept newline characters.
*
* @return $this
*/
public function setMultiline(bool $multiline) : self
{
$this->multiline = $multiline;
return $this;
}
/**
* Returns whether the user response must be hidden.
*
* @return bool
*/
public function isHidden()
{
return $this->hidden;
}
/**
* Sets whether the user response must be hidden or not.
*
* @return $this
*
* @throws LogicException In case the autocompleter is also used
*/
public function setHidden(bool $hidden)
{
if ($this->autocompleterCallback) {
throw new LogicException('A hidden question cannot use the autocompleter.');
}
$this->hidden = $hidden;
return $this;
}
/**
* In case the response cannot be hidden, whether to fallback on non-hidden question or not.
*
* @return bool
*/
public function isHiddenFallback()
{
return $this->hiddenFallback;
}
/**
* Sets whether to fallback on non-hidden question if the response cannot be hidden.
*
* @return $this
*/
public function setHiddenFallback(bool $fallback)
{
$this->hiddenFallback = $fallback;
return $this;
}
/**
* Gets values for the autocompleter.
*
* @return iterable|null
*/
public function getAutocompleterValues()
{
$callback = $this->getAutocompleterCallback();
return $callback ? $callback('') : null;
}
/**
* Sets values for the autocompleter.
*
* @return $this
*
* @throws LogicException
*/
public function setAutocompleterValues(?iterable $values)
{
if (\is_array($values)) {
$values = $this->isAssoc($values) ? \array_merge(\array_keys($values), \array_values($values)) : \array_values($values);
$callback = static function () use($values) {
return $values;
};
} elseif ($values instanceof \Traversable) {
$valueCache = null;
$callback = static function () use($values, &$valueCache) {
return $valueCache ?? ($valueCache = \iterator_to_array($values, \false));
};
} else {
$callback = null;
}
return $this->setAutocompleterCallback($callback);
}
/**
* Gets the callback function used for the autocompleter.
*/
public function getAutocompleterCallback() : ?callable
{
return $this->autocompleterCallback;
}
/**
* Sets the callback function used for the autocompleter.
*
* The callback is passed the user input as argument and should return an iterable of corresponding suggestions.
*
* @return $this
*/
public function setAutocompleterCallback(?callable $callback = null) : self
{
if ($this->hidden && null !== $callback) {
throw new LogicException('A hidden question cannot use the autocompleter.');
}
$this->autocompleterCallback = $callback;
return $this;
}
/**
* Sets a validator for the question.
*
* @return $this
*/
public function setValidator(?callable $validator = null)
{
$this->validator = $validator;
return $this;
}
/**
* Gets the validator for the question.
*
* @return callable|null
*/
public function getValidator()
{
return $this->validator;
}
/**
* Sets the maximum number of attempts.
*
* Null means an unlimited number of attempts.
*
* @return $this
*
* @throws InvalidArgumentException in case the number of attempts is invalid
*/
public function setMaxAttempts(?int $attempts)
{
if (null !== $attempts && $attempts < 1) {
throw new InvalidArgumentException('Maximum number of attempts must be a positive value.');
}
$this->attempts = $attempts;
return $this;
}
/**
* Gets the maximum number of attempts.
*
* Null means an unlimited number of attempts.
*
* @return int|null
*/
public function getMaxAttempts()
{
return $this->attempts;
}
/**
* Sets a normalizer for the response.
*
* The normalizer can be a callable (a string), a closure or a class implementing __invoke.
*
* @return $this
*/
public function setNormalizer(callable $normalizer)
{
$this->normalizer = $normalizer;
return $this;
}
/**
* Gets the normalizer for the response.
*
* The normalizer can ba a callable (a string), a closure or a class implementing __invoke.
*
* @return callable|null
*/
public function getNormalizer()
{
return $this->normalizer;
}
protected function isAssoc(array $array)
{
return (bool) \count(\array_filter(\array_keys($array), 'is_string'));
}
public function isTrimmable() : bool
{
return $this->trimmable;
}
/**
* @return $this
*/
public function setTrimmable(bool $trimmable) : self
{
$this->trimmable = $trimmable;
return $this;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Application;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputDefinition;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* Markdown descriptor.
*
* @author Jean-François Simon <contact@jfsimon.fr>
*
* @internal
*/
class MarkdownDescriptor extends Descriptor
{
/**
* {@inheritdoc}
*/
public function describe(OutputInterface $output, object $object, array $options = [])
{
$decorated = $output->isDecorated();
$output->setDecorated(\false);
parent::describe($output, $object, $options);
$output->setDecorated($decorated);
}
/**
* {@inheritdoc}
*/
protected function write(string $content, bool $decorated = \true)
{
parent::write($content, $decorated);
}
/**
* {@inheritdoc}
*/
protected function describeInputArgument(InputArgument $argument, array $options = [])
{
$this->write('#### `' . ($argument->getName() ?: '<none>') . "`\n\n" . ($argument->getDescription() ? \preg_replace('/\\s*[\\r\\n]\\s*/', "\n", $argument->getDescription()) . "\n\n" : '') . '* Is required: ' . ($argument->isRequired() ? 'yes' : 'no') . "\n" . '* Is array: ' . ($argument->isArray() ? 'yes' : 'no') . "\n" . '* Default: `' . \str_replace("\n", '', \var_export($argument->getDefault(), \true)) . '`');
}
/**
* {@inheritdoc}
*/
protected function describeInputOption(InputOption $option, array $options = [])
{
$name = '--' . $option->getName();
if ($option->isNegatable()) {
$name .= '|--no-' . $option->getName();
}
if ($option->getShortcut()) {
$name .= '|-' . \str_replace('|', '|-', $option->getShortcut()) . '';
}
$this->write('#### `' . $name . '`' . "\n\n" . ($option->getDescription() ? \preg_replace('/\\s*[\\r\\n]\\s*/', "\n", $option->getDescription()) . "\n\n" : '') . '* Accept value: ' . ($option->acceptValue() ? 'yes' : 'no') . "\n" . '* Is value required: ' . ($option->isValueRequired() ? 'yes' : 'no') . "\n" . '* Is multiple: ' . ($option->isArray() ? 'yes' : 'no') . "\n" . '* Is negatable: ' . ($option->isNegatable() ? 'yes' : 'no') . "\n" . '* Default: `' . \str_replace("\n", '', \var_export($option->getDefault(), \true)) . '`');
}
/**
* {@inheritdoc}
*/
protected function describeInputDefinition(InputDefinition $definition, array $options = [])
{
if ($showArguments = \count($definition->getArguments()) > 0) {
$this->write('### Arguments');
foreach ($definition->getArguments() as $argument) {
$this->write("\n\n");
if (null !== ($describeInputArgument = $this->describeInputArgument($argument))) {
$this->write($describeInputArgument);
}
}
}
if (\count($definition->getOptions()) > 0) {
if ($showArguments) {
$this->write("\n\n");
}
$this->write('### Options');
foreach ($definition->getOptions() as $option) {
$this->write("\n\n");
if (null !== ($describeInputOption = $this->describeInputOption($option))) {
$this->write($describeInputOption);
}
}
}
}
/**
* {@inheritdoc}
*/
protected function describeCommand(Command $command, array $options = [])
{
if ($options['short'] ?? \false) {
$this->write('`' . $command->getName() . "`\n" . \str_repeat('-', Helper::width($command->getName()) + 2) . "\n\n" . ($command->getDescription() ? $command->getDescription() . "\n\n" : '') . '### Usage' . "\n\n" . \array_reduce($command->getAliases(), function ($carry, $usage) {
return $carry . '* `' . $usage . '`' . "\n";
}));
return;
}
$command->mergeApplicationDefinition(\false);
$this->write('`' . $command->getName() . "`\n" . \str_repeat('-', Helper::width($command->getName()) + 2) . "\n\n" . ($command->getDescription() ? $command->getDescription() . "\n\n" : '') . '### Usage' . "\n\n" . \array_reduce(\array_merge([$command->getSynopsis()], $command->getAliases(), $command->getUsages()), function ($carry, $usage) {
return $carry . '* `' . $usage . '`' . "\n";
}));
if ($help = $command->getProcessedHelp()) {
$this->write("\n");
$this->write($help);
}
$definition = $command->getDefinition();
if ($definition->getOptions() || $definition->getArguments()) {
$this->write("\n\n");
$this->describeInputDefinition($definition);
}
}
/**
* {@inheritdoc}
*/
protected function describeApplication(Application $application, array $options = [])
{
$describedNamespace = $options['namespace'] ?? null;
$description = new ApplicationDescription($application, $describedNamespace);
$title = $this->getApplicationTitle($application);
$this->write($title . "\n" . \str_repeat('=', Helper::width($title)));
foreach ($description->getNamespaces() as $namespace) {
if (ApplicationDescription::GLOBAL_NAMESPACE !== $namespace['id']) {
$this->write("\n\n");
$this->write('**' . $namespace['id'] . ':**');
}
$this->write("\n\n");
$this->write(\implode("\n", \array_map(function ($commandName) use($description) {
return \sprintf('* [`%s`](#%s)', $commandName, \str_replace(':', '', $description->getCommand($commandName)->getName()));
}, $namespace['commands'])));
}
foreach ($description->getCommands() as $command) {
$this->write("\n\n");
if (null !== ($describeCommand = $this->describeCommand($command, $options))) {
$this->write($describeCommand);
}
}
}
private function getApplicationTitle(Application $application) : string
{
if ('UNKNOWN' !== $application->getName()) {
if ('UNKNOWN' !== $application->getVersion()) {
return \sprintf('%s %s', $application->getName(), $application->getVersion());
}
return $application->getName();
}
return 'Console Tool';
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Application;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputDefinition;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* @author Jean-François Simon <jeanfrancois.simon@sensiolabs.com>
*
* @internal
*/
abstract class Descriptor implements DescriptorInterface
{
/**
* @var OutputInterface
*/
protected $output;
/**
* {@inheritdoc}
*/
public function describe(OutputInterface $output, object $object, array $options = [])
{
$this->output = $output;
switch (\true) {
case $object instanceof InputArgument:
$this->describeInputArgument($object, $options);
break;
case $object instanceof InputOption:
$this->describeInputOption($object, $options);
break;
case $object instanceof InputDefinition:
$this->describeInputDefinition($object, $options);
break;
case $object instanceof Command:
$this->describeCommand($object, $options);
break;
case $object instanceof Application:
$this->describeApplication($object, $options);
break;
default:
throw new InvalidArgumentException(\sprintf('Object of type "%s" is not describable.', \get_debug_type($object)));
}
}
/**
* Writes content to output.
*/
protected function write(string $content, bool $decorated = \false)
{
$this->output->write($content, \false, $decorated ? OutputInterface::OUTPUT_NORMAL : OutputInterface::OUTPUT_RAW);
}
/**
* Describes an InputArgument instance.
*/
protected abstract function describeInputArgument(InputArgument $argument, array $options = []);
/**
* Describes an InputOption instance.
*/
protected abstract function describeInputOption(InputOption $option, array $options = []);
/**
* Describes an InputDefinition instance.
*/
protected abstract function describeInputDefinition(InputDefinition $definition, array $options = []);
/**
* Describes a Command instance.
*/
protected abstract function describeCommand(Command $command, array $options = []);
/**
* Describes an Application instance.
*/
protected abstract function describeApplication(Application $application, array $options = []);
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Application;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Helper\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputDefinition;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
/**
* Text descriptor.
*
* @author Jean-François Simon <contact@jfsimon.fr>
*
* @internal
*/
class TextDescriptor extends Descriptor
{
/**
* {@inheritdoc}
*/
protected function describeInputArgument(InputArgument $argument, array $options = [])
{
if (null !== $argument->getDefault() && (!\is_array($argument->getDefault()) || \count($argument->getDefault()))) {
$default = \sprintf('<comment> [default: %s]</comment>', $this->formatDefaultValue($argument->getDefault()));
} else {
$default = '';
}
$totalWidth = $options['total_width'] ?? Helper::width($argument->getName());
$spacingWidth = $totalWidth - \strlen($argument->getName());
$this->writeText(\sprintf(
' <info>%s</info> %s%s%s',
$argument->getName(),
\str_repeat(' ', $spacingWidth),
// + 4 = 2 spaces before <info>, 2 spaces after </info>
\preg_replace('/\\s*[\\r\\n]\\s*/', "\n" . \str_repeat(' ', $totalWidth + 4), $argument->getDescription()),
$default
), $options);
}
/**
* {@inheritdoc}
*/
protected function describeInputOption(InputOption $option, array $options = [])
{
if ($option->acceptValue() && null !== $option->getDefault() && (!\is_array($option->getDefault()) || \count($option->getDefault()))) {
$default = \sprintf('<comment> [default: %s]</comment>', $this->formatDefaultValue($option->getDefault()));
} else {
$default = '';
}
$value = '';
if ($option->acceptValue()) {
$value = '=' . \strtoupper($option->getName());
if ($option->isValueOptional()) {
$value = '[' . $value . ']';
}
}
$totalWidth = $options['total_width'] ?? $this->calculateTotalWidthForOptions([$option]);
$synopsis = \sprintf('%s%s', $option->getShortcut() ? \sprintf('-%s, ', $option->getShortcut()) : ' ', \sprintf($option->isNegatable() ? '--%1$s|--no-%1$s' : '--%1$s%2$s', $option->getName(), $value));
$spacingWidth = $totalWidth - Helper::width($synopsis);
$this->writeText(\sprintf(
' <info>%s</info> %s%s%s%s',
$synopsis,
\str_repeat(' ', $spacingWidth),
// + 4 = 2 spaces before <info>, 2 spaces after </info>
\preg_replace('/\\s*[\\r\\n]\\s*/', "\n" . \str_repeat(' ', $totalWidth + 4), $option->getDescription()),
$default,
$option->isArray() ? '<comment> (multiple values allowed)</comment>' : ''
), $options);
}
/**
* {@inheritdoc}
*/
protected function describeInputDefinition(InputDefinition $definition, array $options = [])
{
$totalWidth = $this->calculateTotalWidthForOptions($definition->getOptions());
foreach ($definition->getArguments() as $argument) {
$totalWidth = \max($totalWidth, Helper::width($argument->getName()));
}
if ($definition->getArguments()) {
$this->writeText('<comment>Arguments:</comment>', $options);
$this->writeText("\n");
foreach ($definition->getArguments() as $argument) {
$this->describeInputArgument($argument, \array_merge($options, ['total_width' => $totalWidth]));
$this->writeText("\n");
}
}
if ($definition->getArguments() && $definition->getOptions()) {
$this->writeText("\n");
}
if ($definition->getOptions()) {
$laterOptions = [];
$this->writeText('<comment>Options:</comment>', $options);
foreach ($definition->getOptions() as $option) {
if (\strlen($option->getShortcut() ?? '') > 1) {
$laterOptions[] = $option;
continue;
}
$this->writeText("\n");
$this->describeInputOption($option, \array_merge($options, ['total_width' => $totalWidth]));
}
foreach ($laterOptions as $option) {
$this->writeText("\n");
$this->describeInputOption($option, \array_merge($options, ['total_width' => $totalWidth]));
}
}
}
/**
* {@inheritdoc}
*/
protected function describeCommand(Command $command, array $options = [])
{
$command->mergeApplicationDefinition(\false);
if ($description = $command->getDescription()) {
$this->writeText('<comment>Description:</comment>', $options);
$this->writeText("\n");
$this->writeText(' ' . $description);
$this->writeText("\n\n");
}
$this->writeText('<comment>Usage:</comment>', $options);
foreach (\array_merge([$command->getSynopsis(\true)], $command->getAliases(), $command->getUsages()) as $usage) {
$this->writeText("\n");
$this->writeText(' ' . OutputFormatter::escape($usage), $options);
}
$this->writeText("\n");
$definition = $command->getDefinition();
if ($definition->getOptions() || $definition->getArguments()) {
$this->writeText("\n");
$this->describeInputDefinition($definition, $options);
$this->writeText("\n");
}
$help = $command->getProcessedHelp();
if ($help && $help !== $description) {
$this->writeText("\n");
$this->writeText('<comment>Help:</comment>', $options);
$this->writeText("\n");
$this->writeText(' ' . \str_replace("\n", "\n ", $help), $options);
$this->writeText("\n");
}
}
/**
* {@inheritdoc}
*/
protected function describeApplication(Application $application, array $options = [])
{
$describedNamespace = $options['namespace'] ?? null;
$description = new ApplicationDescription($application, $describedNamespace);
if (isset($options['raw_text']) && $options['raw_text']) {
$width = $this->getColumnWidth($description->getCommands());
foreach ($description->getCommands() as $command) {
$this->writeText(\sprintf("%-{$width}s %s", $command->getName(), $command->getDescription()), $options);
$this->writeText("\n");
}
} else {
if ('' != ($help = $application->getHelp())) {
$this->writeText("{$help}\n\n", $options);
}
$this->writeText("<comment>Usage:</comment>\n", $options);
$this->writeText(" command [options] [arguments]\n\n", $options);
$this->describeInputDefinition(new InputDefinition($application->getDefinition()->getOptions()), $options);
$this->writeText("\n");
$this->writeText("\n");
$commands = $description->getCommands();
$namespaces = $description->getNamespaces();
if ($describedNamespace && $namespaces) {
// make sure all alias commands are included when describing a specific namespace
$describedNamespaceInfo = \reset($namespaces);
foreach ($describedNamespaceInfo['commands'] as $name) {
$commands[$name] = $description->getCommand($name);
}
}
// calculate max. width based on available commands per namespace
$width = $this->getColumnWidth(\array_merge(...\array_values(\array_map(function ($namespace) use($commands) {
return \array_intersect($namespace['commands'], \array_keys($commands));
}, \array_values($namespaces)))));
if ($describedNamespace) {
$this->writeText(\sprintf('<comment>Available commands for the "%s" namespace:</comment>', $describedNamespace), $options);
} else {
$this->writeText('<comment>Available commands:</comment>', $options);
}
foreach ($namespaces as $namespace) {
$namespace['commands'] = \array_filter($namespace['commands'], function ($name) use($commands) {
return isset($commands[$name]);
});
if (!$namespace['commands']) {
continue;
}
if (!$describedNamespace && ApplicationDescription::GLOBAL_NAMESPACE !== $namespace['id']) {
$this->writeText("\n");
$this->writeText(' <comment>' . $namespace['id'] . '</comment>', $options);
}
foreach ($namespace['commands'] as $name) {
$this->writeText("\n");
$spacingWidth = $width - Helper::width($name);
$command = $commands[$name];
$commandAliases = $name === $command->getName() ? $this->getCommandAliasesText($command) : '';
$this->writeText(\sprintf(' <info>%s</info>%s%s', $name, \str_repeat(' ', $spacingWidth), $commandAliases . $command->getDescription()), $options);
}
}
$this->writeText("\n");
}
}
/**
* {@inheritdoc}
*/
private function writeText(string $content, array $options = [])
{
$this->write(isset($options['raw_text']) && $options['raw_text'] ? \strip_tags($content) : $content, isset($options['raw_output']) ? !$options['raw_output'] : \true);
}
/**
* Formats command aliases to show them in the command description.
*/
private function getCommandAliasesText(Command $command) : string
{
$text = '';
$aliases = $command->getAliases();
if ($aliases) {
$text = '[' . \implode('|', $aliases) . '] ';
}
return $text;
}
/**
* Formats input option/argument default value.
*
* @param mixed $default
*/
private function formatDefaultValue($default) : string
{
if (\INF === $default) {
return 'INF';
}
if (\is_string($default)) {
$default = OutputFormatter::escape($default);
} elseif (\is_array($default)) {
foreach ($default as $key => $value) {
if (\is_string($value)) {
$default[$key] = OutputFormatter::escape($value);
}
}
}
return \str_replace('\\\\', '\\', \json_encode($default, \JSON_UNESCAPED_SLASHES | \JSON_UNESCAPED_UNICODE));
}
/**
* @param array<Command|string> $commands
*/
private function getColumnWidth(array $commands) : int
{
$widths = [];
foreach ($commands as $command) {
if ($command instanceof Command) {
$widths[] = Helper::width($command->getName());
foreach ($command->getAliases() as $alias) {
$widths[] = Helper::width($alias);
}
} else {
$widths[] = Helper::width($command);
}
}
return $widths ? \max($widths) + 2 : 0;
}
/**
* @param InputOption[] $options
*/
private function calculateTotalWidthForOptions(array $options) : int
{
$totalWidth = 0;
foreach ($options as $option) {
// "-" + shortcut + ", --" + name
$nameLength = 1 + \max(Helper::width($option->getShortcut()), 1) + 4 + Helper::width($option->getName());
if ($option->isNegatable()) {
$nameLength += 6 + Helper::width($option->getName());
// |--no- + name
} elseif ($option->acceptValue()) {
$valueLength = 1 + Helper::width($option->getName());
// = + value
$valueLength += $option->isValueOptional() ? 2 : 0;
// [ + ]
$nameLength += $valueLength;
}
$totalWidth = \max($totalWidth, $nameLength);
}
return $totalWidth;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Application;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputDefinition;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
/**
* XML descriptor.
*
* @author Jean-François Simon <contact@jfsimon.fr>
*
* @internal
*/
class XmlDescriptor extends Descriptor
{
public function getInputDefinitionDocument(InputDefinition $definition) : \DOMDocument
{
$dom = new \DOMDocument('1.0', 'UTF-8');
$dom->appendChild($definitionXML = $dom->createElement('definition'));
$definitionXML->appendChild($argumentsXML = $dom->createElement('arguments'));
foreach ($definition->getArguments() as $argument) {
$this->appendDocument($argumentsXML, $this->getInputArgumentDocument($argument));
}
$definitionXML->appendChild($optionsXML = $dom->createElement('options'));
foreach ($definition->getOptions() as $option) {
$this->appendDocument($optionsXML, $this->getInputOptionDocument($option));
}
return $dom;
}
public function getCommandDocument(Command $command, bool $short = \false) : \DOMDocument
{
$dom = new \DOMDocument('1.0', 'UTF-8');
$dom->appendChild($commandXML = $dom->createElement('command'));
$commandXML->setAttribute('id', $command->getName());
$commandXML->setAttribute('name', $command->getName());
$commandXML->setAttribute('hidden', $command->isHidden() ? 1 : 0);
$commandXML->appendChild($usagesXML = $dom->createElement('usages'));
$commandXML->appendChild($descriptionXML = $dom->createElement('description'));
$descriptionXML->appendChild($dom->createTextNode(\str_replace("\n", "\n ", $command->getDescription())));
if ($short) {
foreach ($command->getAliases() as $usage) {
$usagesXML->appendChild($dom->createElement('usage', $usage));
}
} else {
$command->mergeApplicationDefinition(\false);
foreach (\array_merge([$command->getSynopsis()], $command->getAliases(), $command->getUsages()) as $usage) {
$usagesXML->appendChild($dom->createElement('usage', $usage));
}
$commandXML->appendChild($helpXML = $dom->createElement('help'));
$helpXML->appendChild($dom->createTextNode(\str_replace("\n", "\n ", $command->getProcessedHelp())));
$definitionXML = $this->getInputDefinitionDocument($command->getDefinition());
$this->appendDocument($commandXML, $definitionXML->getElementsByTagName('definition')->item(0));
}
return $dom;
}
public function getApplicationDocument(Application $application, ?string $namespace = null, bool $short = \false) : \DOMDocument
{
$dom = new \DOMDocument('1.0', 'UTF-8');
$dom->appendChild($rootXml = $dom->createElement('symfony'));
if ('UNKNOWN' !== $application->getName()) {
$rootXml->setAttribute('name', $application->getName());
if ('UNKNOWN' !== $application->getVersion()) {
$rootXml->setAttribute('version', $application->getVersion());
}
}
$rootXml->appendChild($commandsXML = $dom->createElement('commands'));
$description = new ApplicationDescription($application, $namespace, \true);
if ($namespace) {
$commandsXML->setAttribute('namespace', $namespace);
}
foreach ($description->getCommands() as $command) {
$this->appendDocument($commandsXML, $this->getCommandDocument($command, $short));
}
if (!$namespace) {
$rootXml->appendChild($namespacesXML = $dom->createElement('namespaces'));
foreach ($description->getNamespaces() as $namespaceDescription) {
$namespacesXML->appendChild($namespaceArrayXML = $dom->createElement('namespace'));
$namespaceArrayXML->setAttribute('id', $namespaceDescription['id']);
foreach ($namespaceDescription['commands'] as $name) {
$namespaceArrayXML->appendChild($commandXML = $dom->createElement('command'));
$commandXML->appendChild($dom->createTextNode($name));
}
}
}
return $dom;
}
/**
* {@inheritdoc}
*/
protected function describeInputArgument(InputArgument $argument, array $options = [])
{
$this->writeDocument($this->getInputArgumentDocument($argument));
}
/**
* {@inheritdoc}
*/
protected function describeInputOption(InputOption $option, array $options = [])
{
$this->writeDocument($this->getInputOptionDocument($option));
}
/**
* {@inheritdoc}
*/
protected function describeInputDefinition(InputDefinition $definition, array $options = [])
{
$this->writeDocument($this->getInputDefinitionDocument($definition));
}
/**
* {@inheritdoc}
*/
protected function describeCommand(Command $command, array $options = [])
{
$this->writeDocument($this->getCommandDocument($command, $options['short'] ?? \false));
}
/**
* {@inheritdoc}
*/
protected function describeApplication(Application $application, array $options = [])
{
$this->writeDocument($this->getApplicationDocument($application, $options['namespace'] ?? null, $options['short'] ?? \false));
}
/**
* Appends document children to parent node.
*/
private function appendDocument(\DOMNode $parentNode, \DOMNode $importedParent)
{
foreach ($importedParent->childNodes as $childNode) {
$parentNode->appendChild($parentNode->ownerDocument->importNode($childNode, \true));
}
}
/**
* Writes DOM document.
*/
private function writeDocument(\DOMDocument $dom)
{
$dom->formatOutput = \true;
$this->write($dom->saveXML());
}
private function getInputArgumentDocument(InputArgument $argument) : \DOMDocument
{
$dom = new \DOMDocument('1.0', 'UTF-8');
$dom->appendChild($objectXML = $dom->createElement('argument'));
$objectXML->setAttribute('name', $argument->getName());
$objectXML->setAttribute('is_required', $argument->isRequired() ? 1 : 0);
$objectXML->setAttribute('is_array', $argument->isArray() ? 1 : 0);
$objectXML->appendChild($descriptionXML = $dom->createElement('description'));
$descriptionXML->appendChild($dom->createTextNode($argument->getDescription()));
$objectXML->appendChild($defaultsXML = $dom->createElement('defaults'));
$defaults = \is_array($argument->getDefault()) ? $argument->getDefault() : (\is_bool($argument->getDefault()) ? [\var_export($argument->getDefault(), \true)] : ($argument->getDefault() ? [$argument->getDefault()] : []));
foreach ($defaults as $default) {
$defaultsXML->appendChild($defaultXML = $dom->createElement('default'));
$defaultXML->appendChild($dom->createTextNode($default));
}
return $dom;
}
private function getInputOptionDocument(InputOption $option) : \DOMDocument
{
$dom = new \DOMDocument('1.0', 'UTF-8');
$dom->appendChild($objectXML = $dom->createElement('option'));
$objectXML->setAttribute('name', '--' . $option->getName());
$pos = \strpos($option->getShortcut() ?? '', '|');
if (\false !== $pos) {
$objectXML->setAttribute('shortcut', '-' . \substr($option->getShortcut(), 0, $pos));
$objectXML->setAttribute('shortcuts', '-' . \str_replace('|', '|-', $option->getShortcut()));
} else {
$objectXML->setAttribute('shortcut', $option->getShortcut() ? '-' . $option->getShortcut() : '');
}
$objectXML->setAttribute('accept_value', $option->acceptValue() ? 1 : 0);
$objectXML->setAttribute('is_value_required', $option->isValueRequired() ? 1 : 0);
$objectXML->setAttribute('is_multiple', $option->isArray() ? 1 : 0);
$objectXML->appendChild($descriptionXML = $dom->createElement('description'));
$descriptionXML->appendChild($dom->createTextNode($option->getDescription()));
if ($option->acceptValue()) {
$defaults = \is_array($option->getDefault()) ? $option->getDefault() : (\is_bool($option->getDefault()) ? [\var_export($option->getDefault(), \true)] : ($option->getDefault() ? [$option->getDefault()] : []));
$objectXML->appendChild($defaultsXML = $dom->createElement('defaults'));
if (!empty($defaults)) {
foreach ($defaults as $default) {
$defaultsXML->appendChild($defaultXML = $dom->createElement('default'));
$defaultXML->appendChild($dom->createTextNode($default));
}
}
}
if ($option->isNegatable()) {
$dom->appendChild($objectXML = $dom->createElement('option'));
$objectXML->setAttribute('name', '--no-' . $option->getName());
$objectXML->setAttribute('shortcut', '');
$objectXML->setAttribute('accept_value', 0);
$objectXML->setAttribute('is_value_required', 0);
$objectXML->setAttribute('is_multiple', 0);
$objectXML->appendChild($descriptionXML = $dom->createElement('description'));
$descriptionXML->appendChild($dom->createTextNode('Negate the "--' . $option->getName() . '" option'));
}
return $dom;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Application;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputArgument;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputDefinition;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputOption;
/**
* JSON descriptor.
*
* @author Jean-François Simon <contact@jfsimon.fr>
*
* @internal
*/
class JsonDescriptor extends Descriptor
{
/**
* {@inheritdoc}
*/
protected function describeInputArgument(InputArgument $argument, array $options = [])
{
$this->writeData($this->getInputArgumentData($argument), $options);
}
/**
* {@inheritdoc}
*/
protected function describeInputOption(InputOption $option, array $options = [])
{
$this->writeData($this->getInputOptionData($option), $options);
if ($option->isNegatable()) {
$this->writeData($this->getInputOptionData($option, \true), $options);
}
}
/**
* {@inheritdoc}
*/
protected function describeInputDefinition(InputDefinition $definition, array $options = [])
{
$this->writeData($this->getInputDefinitionData($definition), $options);
}
/**
* {@inheritdoc}
*/
protected function describeCommand(Command $command, array $options = [])
{
$this->writeData($this->getCommandData($command, $options['short'] ?? \false), $options);
}
/**
* {@inheritdoc}
*/
protected function describeApplication(Application $application, array $options = [])
{
$describedNamespace = $options['namespace'] ?? null;
$description = new ApplicationDescription($application, $describedNamespace, \true);
$commands = [];
foreach ($description->getCommands() as $command) {
$commands[] = $this->getCommandData($command, $options['short'] ?? \false);
}
$data = [];
if ('UNKNOWN' !== $application->getName()) {
$data['application']['name'] = $application->getName();
if ('UNKNOWN' !== $application->getVersion()) {
$data['application']['version'] = $application->getVersion();
}
}
$data['commands'] = $commands;
if ($describedNamespace) {
$data['namespace'] = $describedNamespace;
} else {
$data['namespaces'] = \array_values($description->getNamespaces());
}
$this->writeData($data, $options);
}
/**
* Writes data as json.
*/
private function writeData(array $data, array $options)
{
$flags = $options['json_encoding'] ?? 0;
$this->write(\json_encode($data, $flags));
}
private function getInputArgumentData(InputArgument $argument) : array
{
return ['name' => $argument->getName(), 'is_required' => $argument->isRequired(), 'is_array' => $argument->isArray(), 'description' => \preg_replace('/\\s*[\\r\\n]\\s*/', ' ', $argument->getDescription()), 'default' => \INF === $argument->getDefault() ? 'INF' : $argument->getDefault()];
}
private function getInputOptionData(InputOption $option, bool $negated = \false) : array
{
return $negated ? ['name' => '--no-' . $option->getName(), 'shortcut' => '', 'accept_value' => \false, 'is_value_required' => \false, 'is_multiple' => \false, 'description' => 'Negate the "--' . $option->getName() . '" option', 'default' => \false] : ['name' => '--' . $option->getName(), 'shortcut' => $option->getShortcut() ? '-' . \str_replace('|', '|-', $option->getShortcut()) : '', 'accept_value' => $option->acceptValue(), 'is_value_required' => $option->isValueRequired(), 'is_multiple' => $option->isArray(), 'description' => \preg_replace('/\\s*[\\r\\n]\\s*/', ' ', $option->getDescription()), 'default' => \INF === $option->getDefault() ? 'INF' : $option->getDefault()];
}
private function getInputDefinitionData(InputDefinition $definition) : array
{
$inputArguments = [];
foreach ($definition->getArguments() as $name => $argument) {
$inputArguments[$name] = $this->getInputArgumentData($argument);
}
$inputOptions = [];
foreach ($definition->getOptions() as $name => $option) {
$inputOptions[$name] = $this->getInputOptionData($option);
if ($option->isNegatable()) {
$inputOptions['no-' . $name] = $this->getInputOptionData($option, \true);
}
}
return ['arguments' => $inputArguments, 'options' => $inputOptions];
}
private function getCommandData(Command $command, bool $short = \false) : array
{
$data = ['name' => $command->getName(), 'description' => $command->getDescription()];
if ($short) {
$data += ['usage' => $command->getAliases()];
} else {
$command->mergeApplicationDefinition(\false);
$data += ['usage' => \array_merge([$command->getSynopsis()], $command->getUsages(), $command->getAliases()), 'help' => $command->getProcessedHelp(), 'definition' => $this->getInputDefinitionData($command->getDefinition())];
}
$data['hidden'] = $command->isHidden();
return $data;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* Descriptor interface.
*
* @author Jean-François Simon <contact@jfsimon.fr>
*/
interface DescriptorInterface
{
public function describe(OutputInterface $output, object $object, array $options = []);
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Application;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\CommandNotFoundException;
/**
* @author Jean-François Simon <jeanfrancois.simon@sensiolabs.com>
*
* @internal
*/
class ApplicationDescription
{
public const GLOBAL_NAMESPACE = '_global';
private $application;
private $namespace;
private $showHidden;
/**
* @var array
*/
private $namespaces;
/**
* @var array<string, Command>
*/
private $commands;
/**
* @var array<string, Command>
*/
private $aliases;
public function __construct(Application $application, ?string $namespace = null, bool $showHidden = \false)
{
$this->application = $application;
$this->namespace = $namespace;
$this->showHidden = $showHidden;
}
public function getNamespaces() : array
{
if (null === $this->namespaces) {
$this->inspectApplication();
}
return $this->namespaces;
}
/**
* @return Command[]
*/
public function getCommands() : array
{
if (null === $this->commands) {
$this->inspectApplication();
}
return $this->commands;
}
/**
* @throws CommandNotFoundException
*/
public function getCommand(string $name) : Command
{
if (!isset($this->commands[$name]) && !isset($this->aliases[$name])) {
throw new CommandNotFoundException(\sprintf('Command "%s" does not exist.', $name));
}
return $this->commands[$name] ?? $this->aliases[$name];
}
private function inspectApplication()
{
$this->commands = [];
$this->namespaces = [];
$all = $this->application->all($this->namespace ? $this->application->findNamespace($this->namespace) : null);
foreach ($this->sortCommands($all) as $namespace => $commands) {
$names = [];
/** @var Command $command */
foreach ($commands as $name => $command) {
if (!$command->getName() || !$this->showHidden && $command->isHidden()) {
continue;
}
if ($command->getName() === $name) {
$this->commands[$name] = $command;
} else {
$this->aliases[$name] = $command;
}
$names[] = $name;
}
$this->namespaces[$namespace] = ['id' => $namespace, 'commands' => $names];
}
}
private function sortCommands(array $commands) : array
{
$namespacedCommands = [];
$globalCommands = [];
$sortedCommands = [];
foreach ($commands as $name => $command) {
$key = $this->application->extractNamespace($name, 1);
if (\in_array($key, ['', self::GLOBAL_NAMESPACE], \true)) {
$globalCommands[$name] = $command;
} else {
$namespacedCommands[$key][$name] = $command;
}
}
if ($globalCommands) {
\ksort($globalCommands);
$sortedCommands[self::GLOBAL_NAMESPACE] = $globalCommands;
}
if ($namespacedCommands) {
\ksort($namespacedCommands, \SORT_STRING);
foreach ($namespacedCommands as $key => $commandsSet) {
\ksort($commandsSet);
$sortedCommands[$key] = $commandsSet;
}
}
return $sortedCommands;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\CommandLoader;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\CommandNotFoundException;
/**
* @author Robin Chalas <robin.chalas@gmail.com>
*/
interface CommandLoaderInterface
{
/**
* Loads a command.
*
* @return Command
*
* @throws CommandNotFoundException
*/
public function get(string $name);
/**
* Checks if a command exists.
*
* @return bool
*/
public function has(string $name);
/**
* @return string[]
*/
public function getNames();
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\CommandLoader;
use _PHPStan_6dcda722c\Psr\Container\ContainerInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\CommandNotFoundException;
/**
* Loads commands from a PSR-11 container.
*
* @author Robin Chalas <robin.chalas@gmail.com>
*/
class ContainerCommandLoader implements CommandLoaderInterface
{
private $container;
private $commandMap;
/**
* @param array $commandMap An array with command names as keys and service ids as values
*/
public function __construct(ContainerInterface $container, array $commandMap)
{
$this->container = $container;
$this->commandMap = $commandMap;
}
/**
* {@inheritdoc}
*/
public function get(string $name)
{
if (!$this->has($name)) {
throw new CommandNotFoundException(\sprintf('Command "%s" does not exist.', $name));
}
return $this->container->get($this->commandMap[$name]);
}
/**
* {@inheritdoc}
*/
public function has(string $name)
{
return isset($this->commandMap[$name]) && $this->container->has($this->commandMap[$name]);
}
/**
* {@inheritdoc}
*/
public function getNames()
{
return \array_keys($this->commandMap);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\CommandLoader;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\CommandNotFoundException;
/**
* A simple command loader using factories to instantiate commands lazily.
*
* @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
*/
class FactoryCommandLoader implements CommandLoaderInterface
{
private $factories;
/**
* @param callable[] $factories Indexed by command names
*/
public function __construct(array $factories)
{
$this->factories = $factories;
}
/**
* {@inheritdoc}
*/
public function has(string $name)
{
return isset($this->factories[$name]);
}
/**
* {@inheritdoc}
*/
public function get(string $name)
{
if (!isset($this->factories[$name])) {
throw new CommandNotFoundException(\sprintf('Command "%s" does not exist.', $name));
}
$factory = $this->factories[$name];
return $factory();
}
/**
* {@inheritdoc}
*/
public function getNames()
{
return \array_keys($this->factories);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Input;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
/**
* StringInput represents an input provided as a string.
*
* Usage:
*
* $input = new StringInput('foo --bar="foobar"');
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class StringInput extends ArgvInput
{
public const REGEX_STRING = '([^\\s]+?)(?:\\s|(?<!\\\\)"|(?<!\\\\)\'|$)';
public const REGEX_UNQUOTED_STRING = '([^\\s\\\\]+?)';
public const REGEX_QUOTED_STRING = '(?:"([^"\\\\]*(?:\\\\.[^"\\\\]*)*)"|\'([^\'\\\\]*(?:\\\\.[^\'\\\\]*)*)\')';
/**
* @param string $input A string representing the parameters from the CLI
*/
public function __construct(string $input)
{
parent::__construct([]);
$this->setTokens($this->tokenize($input));
}
/**
* Tokenizes a string.
*
* @throws InvalidArgumentException When unable to parse input (should never happen)
*/
private function tokenize(string $input) : array
{
$tokens = [];
$length = \strlen($input);
$cursor = 0;
$token = null;
while ($cursor < $length) {
if ('\\' === $input[$cursor]) {
$token .= $input[++$cursor] ?? '';
++$cursor;
continue;
}
if (\preg_match('/\\s+/A', $input, $match, 0, $cursor)) {
if (null !== $token) {
$tokens[] = $token;
$token = null;
}
} elseif (\preg_match('/([^="\'\\s]+?)(=?)(' . self::REGEX_QUOTED_STRING . '+)/A', $input, $match, 0, $cursor)) {
$token .= $match[1] . $match[2] . \stripcslashes(\str_replace(['"\'', '\'"', '\'\'', '""'], '', \substr($match[3], 1, -1)));
} elseif (\preg_match('/' . self::REGEX_QUOTED_STRING . '/A', $input, $match, 0, $cursor)) {
$token .= \stripcslashes(\substr($match[0], 1, -1));
} elseif (\preg_match('/' . self::REGEX_UNQUOTED_STRING . '/A', $input, $match, 0, $cursor)) {
$token .= $match[1];
} else {
// should never happen
throw new InvalidArgumentException(\sprintf('Unable to parse input near "... %s ...".', \substr($input, $cursor, 10)));
}
$cursor += \strlen($match[0]);
}
if (null !== $token) {
$tokens[] = $token;
}
return $tokens;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Input;
/**
* StreamableInputInterface is the interface implemented by all input classes
* that have an input stream.
*
* @author Robin Chalas <robin.chalas@gmail.com>
*/
interface StreamableInputInterface extends InputInterface
{
/**
* Sets the input stream to read from when interacting with the user.
*
* This is mainly useful for testing purpose.
*
* @param resource $stream The input stream
*/
public function setStream($stream);
/**
* Returns the input stream.
*
* @return resource|null
*/
public function getStream();
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Input;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\LogicException;
/**
* Represents a command line option.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class InputOption
{
/**
* Do not accept input for the option (e.g. --yell). This is the default behavior of options.
*/
public const VALUE_NONE = 1;
/**
* A value must be passed when the option is used (e.g. --iterations=5 or -i5).
*/
public const VALUE_REQUIRED = 2;
/**
* The option may or may not have a value (e.g. --yell or --yell=loud).
*/
public const VALUE_OPTIONAL = 4;
/**
* The option accepts multiple values (e.g. --dir=/foo --dir=/bar).
*/
public const VALUE_IS_ARRAY = 8;
/**
* The option may have either positive or negative value (e.g. --ansi or --no-ansi).
*/
public const VALUE_NEGATABLE = 16;
private $name;
private $shortcut;
private $mode;
private $default;
private $description;
/**
* @param string|array|null $shortcut The shortcuts, can be null, a string of shortcuts delimited by | or an array of shortcuts
* @param int|null $mode The option mode: One of the VALUE_* constants
* @param string|bool|int|float|array|null $default The default value (must be null for self::VALUE_NONE)
*
* @throws InvalidArgumentException If option mode is invalid or incompatible
*/
public function __construct(string $name, $shortcut = null, ?int $mode = null, string $description = '', $default = null)
{
if (\str_starts_with($name, '--')) {
$name = \substr($name, 2);
}
if (empty($name)) {
throw new InvalidArgumentException('An option name cannot be empty.');
}
if ('' === $shortcut || [] === $shortcut || \false === $shortcut) {
$shortcut = null;
}
if (null !== $shortcut) {
if (\is_array($shortcut)) {
$shortcut = \implode('|', $shortcut);
}
$shortcuts = \preg_split('{(\\|)-?}', \ltrim($shortcut, '-'));
$shortcuts = \array_filter($shortcuts, 'strlen');
$shortcut = \implode('|', $shortcuts);
if ('' === $shortcut) {
throw new InvalidArgumentException('An option shortcut cannot be empty.');
}
}
if (null === $mode) {
$mode = self::VALUE_NONE;
} elseif ($mode >= self::VALUE_NEGATABLE << 1 || $mode < 1) {
throw new InvalidArgumentException(\sprintf('Option mode "%s" is not valid.', $mode));
}
$this->name = $name;
$this->shortcut = $shortcut;
$this->mode = $mode;
$this->description = $description;
if ($this->isArray() && !$this->acceptValue()) {
throw new InvalidArgumentException('Impossible to have an option mode VALUE_IS_ARRAY if the option does not accept a value.');
}
if ($this->isNegatable() && $this->acceptValue()) {
throw new InvalidArgumentException('Impossible to have an option mode VALUE_NEGATABLE if the option also accepts a value.');
}
$this->setDefault($default);
}
/**
* Returns the option shortcut.
*
* @return string|null
*/
public function getShortcut()
{
return $this->shortcut;
}
/**
* Returns the option name.
*
* @return string
*/
public function getName()
{
return $this->name;
}
/**
* Returns true if the option accepts a value.
*
* @return bool true if value mode is not self::VALUE_NONE, false otherwise
*/
public function acceptValue()
{
return $this->isValueRequired() || $this->isValueOptional();
}
/**
* Returns true if the option requires a value.
*
* @return bool true if value mode is self::VALUE_REQUIRED, false otherwise
*/
public function isValueRequired()
{
return self::VALUE_REQUIRED === (self::VALUE_REQUIRED & $this->mode);
}
/**
* Returns true if the option takes an optional value.
*
* @return bool true if value mode is self::VALUE_OPTIONAL, false otherwise
*/
public function isValueOptional()
{
return self::VALUE_OPTIONAL === (self::VALUE_OPTIONAL & $this->mode);
}
/**
* Returns true if the option can take multiple values.
*
* @return bool true if mode is self::VALUE_IS_ARRAY, false otherwise
*/
public function isArray()
{
return self::VALUE_IS_ARRAY === (self::VALUE_IS_ARRAY & $this->mode);
}
public function isNegatable() : bool
{
return self::VALUE_NEGATABLE === (self::VALUE_NEGATABLE & $this->mode);
}
/**
* @param string|bool|int|float|array|null $default
*/
public function setDefault($default = null)
{
if (self::VALUE_NONE === (self::VALUE_NONE & $this->mode) && null !== $default) {
throw new LogicException('Cannot set a default value when using InputOption::VALUE_NONE mode.');
}
if ($this->isArray()) {
if (null === $default) {
$default = [];
} elseif (!\is_array($default)) {
throw new LogicException('A default value for an array option must be an array.');
}
}
$this->default = $this->acceptValue() || $this->isNegatable() ? $default : \false;
}
/**
* Returns the default value.
*
* @return string|bool|int|float|array|null
*/
public function getDefault()
{
return $this->default;
}
/**
* Returns the description text.
*
* @return string
*/
public function getDescription()
{
return $this->description;
}
/**
* Checks whether the given option equals this one.
*
* @return bool
*/
public function equals(self $option)
{
return $option->getName() === $this->getName() && $option->getShortcut() === $this->getShortcut() && $option->getDefault() === $this->getDefault() && $option->isNegatable() === $this->isNegatable() && $option->isArray() === $this->isArray() && $option->isValueRequired() === $this->isValueRequired() && $option->isValueOptional() === $this->isValueOptional();
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Input;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\LogicException;
/**
* A InputDefinition represents a set of valid command line arguments and options.
*
* Usage:
*
* $definition = new InputDefinition([
* new InputArgument('name', InputArgument::REQUIRED),
* new InputOption('foo', 'f', InputOption::VALUE_REQUIRED),
* ]);
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class InputDefinition
{
private $arguments;
private $requiredCount;
private $lastArrayArgument;
private $lastOptionalArgument;
private $options;
private $negations;
private $shortcuts;
/**
* @param array $definition An array of InputArgument and InputOption instance
*/
public function __construct(array $definition = [])
{
$this->setDefinition($definition);
}
/**
* Sets the definition of the input.
*/
public function setDefinition(array $definition)
{
$arguments = [];
$options = [];
foreach ($definition as $item) {
if ($item instanceof InputOption) {
$options[] = $item;
} else {
$arguments[] = $item;
}
}
$this->setArguments($arguments);
$this->setOptions($options);
}
/**
* Sets the InputArgument objects.
*
* @param InputArgument[] $arguments An array of InputArgument objects
*/
public function setArguments(array $arguments = [])
{
$this->arguments = [];
$this->requiredCount = 0;
$this->lastOptionalArgument = null;
$this->lastArrayArgument = null;
$this->addArguments($arguments);
}
/**
* Adds an array of InputArgument objects.
*
* @param InputArgument[] $arguments An array of InputArgument objects
*/
public function addArguments(?array $arguments = [])
{
if (null !== $arguments) {
foreach ($arguments as $argument) {
$this->addArgument($argument);
}
}
}
/**
* @throws LogicException When incorrect argument is given
*/
public function addArgument(InputArgument $argument)
{
if (isset($this->arguments[$argument->getName()])) {
throw new LogicException(\sprintf('An argument with name "%s" already exists.', $argument->getName()));
}
if (null !== $this->lastArrayArgument) {
throw new LogicException(\sprintf('Cannot add a required argument "%s" after an array argument "%s".', $argument->getName(), $this->lastArrayArgument->getName()));
}
if ($argument->isRequired() && null !== $this->lastOptionalArgument) {
throw new LogicException(\sprintf('Cannot add a required argument "%s" after an optional one "%s".', $argument->getName(), $this->lastOptionalArgument->getName()));
}
if ($argument->isArray()) {
$this->lastArrayArgument = $argument;
}
if ($argument->isRequired()) {
++$this->requiredCount;
} else {
$this->lastOptionalArgument = $argument;
}
$this->arguments[$argument->getName()] = $argument;
}
/**
* Returns an InputArgument by name or by position.
*
* @param string|int $name The InputArgument name or position
*
* @return InputArgument
*
* @throws InvalidArgumentException When argument given doesn't exist
*/
public function getArgument($name)
{
if (!$this->hasArgument($name)) {
throw new InvalidArgumentException(\sprintf('The "%s" argument does not exist.', $name));
}
$arguments = \is_int($name) ? \array_values($this->arguments) : $this->arguments;
return $arguments[$name];
}
/**
* Returns true if an InputArgument object exists by name or position.
*
* @param string|int $name The InputArgument name or position
*
* @return bool
*/
public function hasArgument($name)
{
$arguments = \is_int($name) ? \array_values($this->arguments) : $this->arguments;
return isset($arguments[$name]);
}
/**
* Gets the array of InputArgument objects.
*
* @return InputArgument[]
*/
public function getArguments()
{
return $this->arguments;
}
/**
* Returns the number of InputArguments.
*
* @return int
*/
public function getArgumentCount()
{
return null !== $this->lastArrayArgument ? \PHP_INT_MAX : \count($this->arguments);
}
/**
* Returns the number of required InputArguments.
*
* @return int
*/
public function getArgumentRequiredCount()
{
return $this->requiredCount;
}
/**
* @return array<string|bool|int|float|array|null>
*/
public function getArgumentDefaults()
{
$values = [];
foreach ($this->arguments as $argument) {
$values[$argument->getName()] = $argument->getDefault();
}
return $values;
}
/**
* Sets the InputOption objects.
*
* @param InputOption[] $options An array of InputOption objects
*/
public function setOptions(array $options = [])
{
$this->options = [];
$this->shortcuts = [];
$this->negations = [];
$this->addOptions($options);
}
/**
* Adds an array of InputOption objects.
*
* @param InputOption[] $options An array of InputOption objects
*/
public function addOptions(array $options = [])
{
foreach ($options as $option) {
$this->addOption($option);
}
}
/**
* @throws LogicException When option given already exist
*/
public function addOption(InputOption $option)
{
if (isset($this->options[$option->getName()]) && !$option->equals($this->options[$option->getName()])) {
throw new LogicException(\sprintf('An option named "%s" already exists.', $option->getName()));
}
if (isset($this->negations[$option->getName()])) {
throw new LogicException(\sprintf('An option named "%s" already exists.', $option->getName()));
}
if ($option->getShortcut()) {
foreach (\explode('|', $option->getShortcut()) as $shortcut) {
if (isset($this->shortcuts[$shortcut]) && !$option->equals($this->options[$this->shortcuts[$shortcut]])) {
throw new LogicException(\sprintf('An option with shortcut "%s" already exists.', $shortcut));
}
}
}
$this->options[$option->getName()] = $option;
if ($option->getShortcut()) {
foreach (\explode('|', $option->getShortcut()) as $shortcut) {
$this->shortcuts[$shortcut] = $option->getName();
}
}
if ($option->isNegatable()) {
$negatedName = 'no-' . $option->getName();
if (isset($this->options[$negatedName])) {
throw new LogicException(\sprintf('An option named "%s" already exists.', $negatedName));
}
$this->negations[$negatedName] = $option->getName();
}
}
/**
* Returns an InputOption by name.
*
* @return InputOption
*
* @throws InvalidArgumentException When option given doesn't exist
*/
public function getOption(string $name)
{
if (!$this->hasOption($name)) {
throw new InvalidArgumentException(\sprintf('The "--%s" option does not exist.', $name));
}
return $this->options[$name];
}
/**
* Returns true if an InputOption object exists by name.
*
* This method can't be used to check if the user included the option when
* executing the command (use getOption() instead).
*
* @return bool
*/
public function hasOption(string $name)
{
return isset($this->options[$name]);
}
/**
* Gets the array of InputOption objects.
*
* @return InputOption[]
*/
public function getOptions()
{
return $this->options;
}
/**
* Returns true if an InputOption object exists by shortcut.
*
* @return bool
*/
public function hasShortcut(string $name)
{
return isset($this->shortcuts[$name]);
}
/**
* Returns true if an InputOption object exists by negated name.
*/
public function hasNegation(string $name) : bool
{
return isset($this->negations[$name]);
}
/**
* Gets an InputOption by shortcut.
*
* @return InputOption
*/
public function getOptionForShortcut(string $shortcut)
{
return $this->getOption($this->shortcutToName($shortcut));
}
/**
* @return array<string|bool|int|float|array|null>
*/
public function getOptionDefaults()
{
$values = [];
foreach ($this->options as $option) {
$values[$option->getName()] = $option->getDefault();
}
return $values;
}
/**
* Returns the InputOption name given a shortcut.
*
* @throws InvalidArgumentException When option given does not exist
*
* @internal
*/
public function shortcutToName(string $shortcut) : string
{
if (!isset($this->shortcuts[$shortcut])) {
throw new InvalidArgumentException(\sprintf('The "-%s" option does not exist.', $shortcut));
}
return $this->shortcuts[$shortcut];
}
/**
* Returns the InputOption name given a negation.
*
* @throws InvalidArgumentException When option given does not exist
*
* @internal
*/
public function negationToName(string $negation) : string
{
if (!isset($this->negations[$negation])) {
throw new InvalidArgumentException(\sprintf('The "--%s" option does not exist.', $negation));
}
return $this->negations[$negation];
}
/**
* Gets the synopsis.
*
* @return string
*/
public function getSynopsis(bool $short = \false)
{
$elements = [];
if ($short && $this->getOptions()) {
$elements[] = '[options]';
} elseif (!$short) {
foreach ($this->getOptions() as $option) {
$value = '';
if ($option->acceptValue()) {
$value = \sprintf(' %s%s%s', $option->isValueOptional() ? '[' : '', \strtoupper($option->getName()), $option->isValueOptional() ? ']' : '');
}
$shortcut = $option->getShortcut() ? \sprintf('-%s|', $option->getShortcut()) : '';
$negation = $option->isNegatable() ? \sprintf('|--no-%s', $option->getName()) : '';
$elements[] = \sprintf('[%s--%s%s%s]', $shortcut, $option->getName(), $value, $negation);
}
}
if (\count($elements) && $this->getArguments()) {
$elements[] = '[--]';
}
$tail = '';
foreach ($this->getArguments() as $argument) {
$element = '<' . $argument->getName() . '>';
if ($argument->isArray()) {
$element .= '...';
}
if (!$argument->isRequired()) {
$element = '[' . $element;
$tail .= ']';
}
$elements[] = $element;
}
return \implode(' ', $elements) . $tail;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Input;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\RuntimeException;
/**
* ArgvInput represents an input coming from the CLI arguments.
*
* Usage:
*
* $input = new ArgvInput();
*
* By default, the `$_SERVER['argv']` array is used for the input values.
*
* This can be overridden by explicitly passing the input values in the constructor:
*
* $input = new ArgvInput($_SERVER['argv']);
*
* If you pass it yourself, don't forget that the first element of the array
* is the name of the running application.
*
* When passing an argument to the constructor, be sure that it respects
* the same rules as the argv one. It's almost always better to use the
* `StringInput` when you want to provide your own input.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @see http://www.gnu.org/software/libc/manual/html_node/Argument-Syntax.html
* @see http://www.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap12.html#tag_12_02
*/
class ArgvInput extends Input
{
private $tokens;
private $parsed;
public function __construct(?array $argv = null, ?InputDefinition $definition = null)
{
$argv = $argv ?? $_SERVER['argv'] ?? [];
// strip the application name
\array_shift($argv);
$this->tokens = $argv;
parent::__construct($definition);
}
protected function setTokens(array $tokens)
{
$this->tokens = $tokens;
}
/**
* {@inheritdoc}
*/
protected function parse()
{
$parseOptions = \true;
$this->parsed = $this->tokens;
while (null !== ($token = \array_shift($this->parsed))) {
$parseOptions = $this->parseToken($token, $parseOptions);
}
}
protected function parseToken(string $token, bool $parseOptions) : bool
{
if ($parseOptions && '' == $token) {
$this->parseArgument($token);
} elseif ($parseOptions && '--' == $token) {
return \false;
} elseif ($parseOptions && \str_starts_with($token, '--')) {
$this->parseLongOption($token);
} elseif ($parseOptions && '-' === $token[0] && '-' !== $token) {
$this->parseShortOption($token);
} else {
$this->parseArgument($token);
}
return $parseOptions;
}
/**
* Parses a short option.
*/
private function parseShortOption(string $token)
{
$name = \substr($token, 1);
if (\strlen($name) > 1) {
if ($this->definition->hasShortcut($name[0]) && $this->definition->getOptionForShortcut($name[0])->acceptValue()) {
// an option with a value (with no space)
$this->addShortOption($name[0], \substr($name, 1));
} else {
$this->parseShortOptionSet($name);
}
} else {
$this->addShortOption($name, null);
}
}
/**
* Parses a short option set.
*
* @throws RuntimeException When option given doesn't exist
*/
private function parseShortOptionSet(string $name)
{
$len = \strlen($name);
for ($i = 0; $i < $len; ++$i) {
if (!$this->definition->hasShortcut($name[$i])) {
$encoding = \mb_detect_encoding($name, null, \true);
throw new RuntimeException(\sprintf('The "-%s" option does not exist.', \false === $encoding ? $name[$i] : \mb_substr($name, $i, 1, $encoding)));
}
$option = $this->definition->getOptionForShortcut($name[$i]);
if ($option->acceptValue()) {
$this->addLongOption($option->getName(), $i === $len - 1 ? null : \substr($name, $i + 1));
break;
} else {
$this->addLongOption($option->getName(), null);
}
}
}
/**
* Parses a long option.
*/
private function parseLongOption(string $token)
{
$name = \substr($token, 2);
if (\false !== ($pos = \strpos($name, '='))) {
if ('' === ($value = \substr($name, $pos + 1))) {
\array_unshift($this->parsed, $value);
}
$this->addLongOption(\substr($name, 0, $pos), $value);
} else {
$this->addLongOption($name, null);
}
}
/**
* Parses an argument.
*
* @throws RuntimeException When too many arguments are given
*/
private function parseArgument(string $token)
{
$c = \count($this->arguments);
// if input is expecting another argument, add it
if ($this->definition->hasArgument($c)) {
$arg = $this->definition->getArgument($c);
$this->arguments[$arg->getName()] = $arg->isArray() ? [$token] : $token;
// if last argument isArray(), append token to last argument
} elseif ($this->definition->hasArgument($c - 1) && $this->definition->getArgument($c - 1)->isArray()) {
$arg = $this->definition->getArgument($c - 1);
$this->arguments[$arg->getName()][] = $token;
// unexpected argument
} else {
$all = $this->definition->getArguments();
$symfonyCommandName = null;
if (($inputArgument = $all[$key = \array_key_first($all)] ?? null) && 'command' === $inputArgument->getName()) {
$symfonyCommandName = $this->arguments['command'] ?? null;
unset($all[$key]);
}
if (\count($all)) {
if ($symfonyCommandName) {
$message = \sprintf('Too many arguments to "%s" command, expected arguments "%s".', $symfonyCommandName, \implode('" "', \array_keys($all)));
} else {
$message = \sprintf('Too many arguments, expected arguments "%s".', \implode('" "', \array_keys($all)));
}
} elseif ($symfonyCommandName) {
$message = \sprintf('No arguments expected for "%s" command, got "%s".', $symfonyCommandName, $token);
} else {
$message = \sprintf('No arguments expected, got "%s".', $token);
}
throw new RuntimeException($message);
}
}
/**
* Adds a short option value.
*
* @throws RuntimeException When option given doesn't exist
*/
private function addShortOption(string $shortcut, $value)
{
if (!$this->definition->hasShortcut($shortcut)) {
throw new RuntimeException(\sprintf('The "-%s" option does not exist.', $shortcut));
}
$this->addLongOption($this->definition->getOptionForShortcut($shortcut)->getName(), $value);
}
/**
* Adds a long option value.
*
* @throws RuntimeException When option given doesn't exist
*/
private function addLongOption(string $name, $value)
{
if (!$this->definition->hasOption($name)) {
if (!$this->definition->hasNegation($name)) {
throw new RuntimeException(\sprintf('The "--%s" option does not exist.', $name));
}
$optionName = $this->definition->negationToName($name);
if (null !== $value) {
throw new RuntimeException(\sprintf('The "--%s" option does not accept a value.', $name));
}
$this->options[$optionName] = \false;
return;
}
$option = $this->definition->getOption($name);
if (null !== $value && !$option->acceptValue()) {
throw new RuntimeException(\sprintf('The "--%s" option does not accept a value.', $name));
}
if (\in_array($value, ['', null], \true) && $option->acceptValue() && \count($this->parsed)) {
// if option accepts an optional or mandatory argument
// let's see if there is one provided
$next = \array_shift($this->parsed);
if (isset($next[0]) && '-' !== $next[0] || \in_array($next, ['', null], \true)) {
$value = $next;
} else {
\array_unshift($this->parsed, $next);
}
}
if (null === $value) {
if ($option->isValueRequired()) {
throw new RuntimeException(\sprintf('The "--%s" option requires a value.', $name));
}
if (!$option->isArray() && !$option->isValueOptional()) {
$value = \true;
}
}
if ($option->isArray()) {
$this->options[$name][] = $value;
} else {
$this->options[$name] = $value;
}
}
/**
* {@inheritdoc}
*/
public function getFirstArgument()
{
$isOption = \false;
foreach ($this->tokens as $i => $token) {
if ($token && '-' === $token[0]) {
if (\str_contains($token, '=') || !isset($this->tokens[$i + 1])) {
continue;
}
// If it's a long option, consider that everything after "--" is the option name.
// Otherwise, use the last char (if it's a short option set, only the last one can take a value with space separator)
$name = '-' === $token[1] ? \substr($token, 2) : \substr($token, -1);
if (!isset($this->options[$name]) && !$this->definition->hasShortcut($name)) {
// noop
} elseif ((isset($this->options[$name]) || isset($this->options[$name = $this->definition->shortcutToName($name)])) && $this->tokens[$i + 1] === $this->options[$name]) {
$isOption = \true;
}
continue;
}
if ($isOption) {
$isOption = \false;
continue;
}
return $token;
}
return null;
}
/**
* {@inheritdoc}
*/
public function hasParameterOption($values, bool $onlyParams = \false)
{
$values = (array) $values;
foreach ($this->tokens as $token) {
if ($onlyParams && '--' === $token) {
return \false;
}
foreach ($values as $value) {
// Options with values:
// For long options, test for '--option=' at beginning
// For short options, test for '-o' at beginning
$leading = \str_starts_with($value, '--') ? $value . '=' : $value;
if ($token === $value || '' !== $leading && \str_starts_with($token, $leading)) {
return \true;
}
}
}
return \false;
}
/**
* {@inheritdoc}
*/
public function getParameterOption($values, $default = \false, bool $onlyParams = \false)
{
$values = (array) $values;
$tokens = $this->tokens;
while (0 < \count($tokens)) {
$token = \array_shift($tokens);
if ($onlyParams && '--' === $token) {
return $default;
}
foreach ($values as $value) {
if ($token === $value) {
return \array_shift($tokens);
}
// Options with values:
// For long options, test for '--option=' at beginning
// For short options, test for '-o' at beginning
$leading = \str_starts_with($value, '--') ? $value . '=' : $value;
if ('' !== $leading && \str_starts_with($token, $leading)) {
return \substr($token, \strlen($leading));
}
}
}
return $default;
}
/**
* Returns a stringified representation of the args passed to the command.
*
* @return string
*/
public function __toString()
{
$tokens = \array_map(function ($token) {
if (\preg_match('{^(-[^=]+=)(.+)}', $token, $match)) {
return $match[1] . $this->escapeToken($match[2]);
}
if ($token && '-' !== $token[0]) {
return $this->escapeToken($token);
}
return $token;
}, $this->tokens);
return \implode(' ', $tokens);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Input;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidOptionException;
/**
* ArrayInput represents an input provided as an array.
*
* Usage:
*
* $input = new ArrayInput(['command' => 'foo:bar', 'foo' => 'bar', '--bar' => 'foobar']);
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class ArrayInput extends Input
{
private $parameters;
public function __construct(array $parameters, ?InputDefinition $definition = null)
{
$this->parameters = $parameters;
parent::__construct($definition);
}
/**
* {@inheritdoc}
*/
public function getFirstArgument()
{
foreach ($this->parameters as $param => $value) {
if ($param && \is_string($param) && '-' === $param[0]) {
continue;
}
return $value;
}
return null;
}
/**
* {@inheritdoc}
*/
public function hasParameterOption($values, bool $onlyParams = \false)
{
$values = (array) $values;
foreach ($this->parameters as $k => $v) {
if (!\is_int($k)) {
$v = $k;
}
if ($onlyParams && '--' === $v) {
return \false;
}
if (\in_array($v, $values)) {
return \true;
}
}
return \false;
}
/**
* {@inheritdoc}
*/
public function getParameterOption($values, $default = \false, bool $onlyParams = \false)
{
$values = (array) $values;
foreach ($this->parameters as $k => $v) {
if ($onlyParams && ('--' === $k || \is_int($k) && '--' === $v)) {
return $default;
}
if (\is_int($k)) {
if (\in_array($v, $values)) {
return \true;
}
} elseif (\in_array($k, $values)) {
return $v;
}
}
return $default;
}
/**
* Returns a stringified representation of the args passed to the command.
*
* @return string
*/
public function __toString()
{
$params = [];
foreach ($this->parameters as $param => $val) {
if ($param && \is_string($param) && '-' === $param[0]) {
$glue = '-' === $param[1] ? '=' : ' ';
if (\is_array($val)) {
foreach ($val as $v) {
$params[] = $param . ('' != $v ? $glue . $this->escapeToken($v) : '');
}
} else {
$params[] = $param . ('' != $val ? $glue . $this->escapeToken($val) : '');
}
} else {
$params[] = \is_array($val) ? \implode(' ', \array_map([$this, 'escapeToken'], $val)) : $this->escapeToken($val);
}
}
return \implode(' ', $params);
}
/**
* {@inheritdoc}
*/
protected function parse()
{
foreach ($this->parameters as $key => $value) {
if ('--' === $key) {
return;
}
if (\str_starts_with($key, '--')) {
$this->addLongOption(\substr($key, 2), $value);
} elseif (\str_starts_with($key, '-')) {
$this->addShortOption(\substr($key, 1), $value);
} else {
$this->addArgument($key, $value);
}
}
}
/**
* Adds a short option value.
*
* @throws InvalidOptionException When option given doesn't exist
*/
private function addShortOption(string $shortcut, $value)
{
if (!$this->definition->hasShortcut($shortcut)) {
throw new InvalidOptionException(\sprintf('The "-%s" option does not exist.', $shortcut));
}
$this->addLongOption($this->definition->getOptionForShortcut($shortcut)->getName(), $value);
}
/**
* Adds a long option value.
*
* @throws InvalidOptionException When option given doesn't exist
* @throws InvalidOptionException When a required value is missing
*/
private function addLongOption(string $name, $value)
{
if (!$this->definition->hasOption($name)) {
if (!$this->definition->hasNegation($name)) {
throw new InvalidOptionException(\sprintf('The "--%s" option does not exist.', $name));
}
$optionName = $this->definition->negationToName($name);
$this->options[$optionName] = \false;
return;
}
$option = $this->definition->getOption($name);
if (null === $value) {
if ($option->isValueRequired()) {
throw new InvalidOptionException(\sprintf('The "--%s" option requires a value.', $name));
}
if (!$option->isValueOptional()) {
$value = \true;
}
}
$this->options[$name] = $value;
}
/**
* Adds an argument value.
*
* @param string|int $name The argument name
* @param mixed $value The value for the argument
*
* @throws InvalidArgumentException When argument given doesn't exist
*/
private function addArgument($name, $value)
{
if (!$this->definition->hasArgument($name)) {
throw new InvalidArgumentException(\sprintf('The "%s" argument does not exist.', $name));
}
$this->arguments[$name] = $value;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Input;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\RuntimeException;
/**
* Input is the base class for all concrete Input classes.
*
* Three concrete classes are provided by default:
*
* * `ArgvInput`: The input comes from the CLI arguments (argv)
* * `StringInput`: The input is provided as a string
* * `ArrayInput`: The input is provided as an array
*
* @author Fabien Potencier <fabien@symfony.com>
*/
abstract class Input implements InputInterface, StreamableInputInterface
{
protected $definition;
protected $stream;
protected $options = [];
protected $arguments = [];
protected $interactive = \true;
public function __construct(?InputDefinition $definition = null)
{
if (null === $definition) {
$this->definition = new InputDefinition();
} else {
$this->bind($definition);
$this->validate();
}
}
/**
* {@inheritdoc}
*/
public function bind(InputDefinition $definition)
{
$this->arguments = [];
$this->options = [];
$this->definition = $definition;
$this->parse();
}
/**
* Processes command line arguments.
*/
protected abstract function parse();
/**
* {@inheritdoc}
*/
public function validate()
{
$definition = $this->definition;
$givenArguments = $this->arguments;
$missingArguments = \array_filter(\array_keys($definition->getArguments()), function ($argument) use($definition, $givenArguments) {
return !\array_key_exists($argument, $givenArguments) && $definition->getArgument($argument)->isRequired();
});
if (\count($missingArguments) > 0) {
throw new RuntimeException(\sprintf('Not enough arguments (missing: "%s").', \implode(', ', $missingArguments)));
}
}
/**
* {@inheritdoc}
*/
public function isInteractive()
{
return $this->interactive;
}
/**
* {@inheritdoc}
*/
public function setInteractive(bool $interactive)
{
$this->interactive = $interactive;
}
/**
* {@inheritdoc}
*/
public function getArguments()
{
return \array_merge($this->definition->getArgumentDefaults(), $this->arguments);
}
/**
* {@inheritdoc}
*/
public function getArgument(string $name)
{
if (!$this->definition->hasArgument($name)) {
throw new InvalidArgumentException(\sprintf('The "%s" argument does not exist.', $name));
}
return $this->arguments[$name] ?? $this->definition->getArgument($name)->getDefault();
}
/**
* {@inheritdoc}
*/
public function setArgument(string $name, $value)
{
if (!$this->definition->hasArgument($name)) {
throw new InvalidArgumentException(\sprintf('The "%s" argument does not exist.', $name));
}
$this->arguments[$name] = $value;
}
/**
* {@inheritdoc}
*/
public function hasArgument(string $name)
{
return $this->definition->hasArgument($name);
}
/**
* {@inheritdoc}
*/
public function getOptions()
{
return \array_merge($this->definition->getOptionDefaults(), $this->options);
}
/**
* {@inheritdoc}
*/
public function getOption(string $name)
{
if ($this->definition->hasNegation($name)) {
if (null === ($value = $this->getOption($this->definition->negationToName($name)))) {
return $value;
}
return !$value;
}
if (!$this->definition->hasOption($name)) {
throw new InvalidArgumentException(\sprintf('The "%s" option does not exist.', $name));
}
return \array_key_exists($name, $this->options) ? $this->options[$name] : $this->definition->getOption($name)->getDefault();
}
/**
* {@inheritdoc}
*/
public function setOption(string $name, $value)
{
if ($this->definition->hasNegation($name)) {
$this->options[$this->definition->negationToName($name)] = !$value;
return;
} elseif (!$this->definition->hasOption($name)) {
throw new InvalidArgumentException(\sprintf('The "%s" option does not exist.', $name));
}
$this->options[$name] = $value;
}
/**
* {@inheritdoc}
*/
public function hasOption(string $name)
{
return $this->definition->hasOption($name) || $this->definition->hasNegation($name);
}
/**
* Escapes a token through escapeshellarg if it contains unsafe chars.
*
* @return string
*/
public function escapeToken(string $token)
{
return \preg_match('{^[\\w-]+$}', $token) ? $token : \escapeshellarg($token);
}
/**
* {@inheritdoc}
*/
public function setStream($stream)
{
$this->stream = $stream;
}
/**
* {@inheritdoc}
*/
public function getStream()
{
return $this->stream;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Input;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\LogicException;
/**
* Represents a command line argument.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class InputArgument
{
public const REQUIRED = 1;
public const OPTIONAL = 2;
public const IS_ARRAY = 4;
private $name;
private $mode;
private $default;
private $description;
/**
* @param string $name The argument name
* @param int|null $mode The argument mode: a bit mask of self::REQUIRED, self::OPTIONAL and self::IS_ARRAY
* @param string $description A description text
* @param string|bool|int|float|array|null $default The default value (for self::OPTIONAL mode only)
*
* @throws InvalidArgumentException When argument mode is not valid
*/
public function __construct(string $name, ?int $mode = null, string $description = '', $default = null)
{
if (null === $mode) {
$mode = self::OPTIONAL;
} elseif ($mode > 7 || $mode < 1) {
throw new InvalidArgumentException(\sprintf('Argument mode "%s" is not valid.', $mode));
}
$this->name = $name;
$this->mode = $mode;
$this->description = $description;
$this->setDefault($default);
}
/**
* Returns the argument name.
*
* @return string
*/
public function getName()
{
return $this->name;
}
/**
* Returns true if the argument is required.
*
* @return bool true if parameter mode is self::REQUIRED, false otherwise
*/
public function isRequired()
{
return self::REQUIRED === (self::REQUIRED & $this->mode);
}
/**
* Returns true if the argument can take multiple values.
*
* @return bool true if mode is self::IS_ARRAY, false otherwise
*/
public function isArray()
{
return self::IS_ARRAY === (self::IS_ARRAY & $this->mode);
}
/**
* Sets the default value.
*
* @param string|bool|int|float|array|null $default
*
* @throws LogicException When incorrect default value is given
*/
public function setDefault($default = null)
{
if ($this->isRequired() && null !== $default) {
throw new LogicException('Cannot set a default value except for InputArgument::OPTIONAL mode.');
}
if ($this->isArray()) {
if (null === $default) {
$default = [];
} elseif (!\is_array($default)) {
throw new LogicException('A default value for an array argument must be an array.');
}
}
$this->default = $default;
}
/**
* Returns the default value.
*
* @return string|bool|int|float|array|null
*/
public function getDefault()
{
return $this->default;
}
/**
* Returns the description text.
*
* @return string
*/
public function getDescription()
{
return $this->description;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Input;
/**
* InputAwareInterface should be implemented by classes that depends on the
* Console Input.
*
* @author Wouter J <waldio.webdesign@gmail.com>
*/
interface InputAwareInterface
{
/**
* Sets the Console Input.
*/
public function setInput(InputInterface $input);
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Input;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\RuntimeException;
/**
* InputInterface is the interface implemented by all input classes.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
interface InputInterface
{
/**
* Returns the first argument from the raw parameters (not parsed).
*
* @return string|null
*/
public function getFirstArgument();
/**
* Returns true if the raw parameters (not parsed) contain a value.
*
* This method is to be used to introspect the input parameters
* before they have been validated. It must be used carefully.
* Does not necessarily return the correct result for short options
* when multiple flags are combined in the same option.
*
* @param string|array $values The values to look for in the raw parameters (can be an array)
* @param bool $onlyParams Only check real parameters, skip those following an end of options (--) signal
*
* @return bool
*/
public function hasParameterOption($values, bool $onlyParams = \false);
/**
* Returns the value of a raw option (not parsed).
*
* This method is to be used to introspect the input parameters
* before they have been validated. It must be used carefully.
* Does not necessarily return the correct result for short options
* when multiple flags are combined in the same option.
*
* @param string|array $values The value(s) to look for in the raw parameters (can be an array)
* @param string|bool|int|float|array|null $default The default value to return if no result is found
* @param bool $onlyParams Only check real parameters, skip those following an end of options (--) signal
*
* @return mixed
*/
public function getParameterOption($values, $default = \false, bool $onlyParams = \false);
/**
* Binds the current Input instance with the given arguments and options.
*
* @throws RuntimeException
*/
public function bind(InputDefinition $definition);
/**
* Validates the input.
*
* @throws RuntimeException When not enough arguments are given
*/
public function validate();
/**
* Returns all the given arguments merged with the default values.
*
* @return array<string|bool|int|float|array|null>
*/
public function getArguments();
/**
* Returns the argument value for a given argument name.
*
* @return mixed
*
* @throws InvalidArgumentException When argument given doesn't exist
*/
public function getArgument(string $name);
/**
* Sets an argument value by name.
*
* @param mixed $value The argument value
*
* @throws InvalidArgumentException When argument given doesn't exist
*/
public function setArgument(string $name, $value);
/**
* Returns true if an InputArgument object exists by name or position.
*
* @return bool
*/
public function hasArgument(string $name);
/**
* Returns all the given options merged with the default values.
*
* @return array<string|bool|int|float|array|null>
*/
public function getOptions();
/**
* Returns the option value for a given option name.
*
* @return mixed
*
* @throws InvalidArgumentException When option given doesn't exist
*/
public function getOption(string $name);
/**
* Sets an option value by name.
*
* @param mixed $value The option value
*
* @throws InvalidArgumentException When option given doesn't exist
*/
public function setOption(string $name, $value);
/**
* Returns true if an InputOption object exists by name.
*
* @return bool
*/
public function hasOption(string $name);
/**
* Is this input means interactive?
*
* @return bool
*/
public function isInteractive();
/**
* Sets the input interactivity.
*/
public function setInteractive(bool $interactive);
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
/**
* Helps outputting debug information when running an external program from a command.
*
* An external program can be a Process, an HTTP request, or anything else.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class DebugFormatterHelper extends Helper
{
private const COLORS = ['black', 'red', 'green', 'yellow', 'blue', 'magenta', 'cyan', 'white', 'default'];
private $started = [];
private $count = -1;
/**
* Starts a debug formatting session.
*
* @return string
*/
public function start(string $id, string $message, string $prefix = 'RUN')
{
$this->started[$id] = ['border' => ++$this->count % \count(self::COLORS)];
return \sprintf("%s<bg=blue;fg=white> %s </> <fg=blue>%s</>\n", $this->getBorder($id), $prefix, $message);
}
/**
* Adds progress to a formatting session.
*
* @return string
*/
public function progress(string $id, string $buffer, bool $error = \false, string $prefix = 'OUT', string $errorPrefix = 'ERR')
{
$message = '';
if ($error) {
if (isset($this->started[$id]['out'])) {
$message .= "\n";
unset($this->started[$id]['out']);
}
if (!isset($this->started[$id]['err'])) {
$message .= \sprintf('%s<bg=red;fg=white> %s </> ', $this->getBorder($id), $errorPrefix);
$this->started[$id]['err'] = \true;
}
$message .= \str_replace("\n", \sprintf("\n%s<bg=red;fg=white> %s </> ", $this->getBorder($id), $errorPrefix), $buffer);
} else {
if (isset($this->started[$id]['err'])) {
$message .= "\n";
unset($this->started[$id]['err']);
}
if (!isset($this->started[$id]['out'])) {
$message .= \sprintf('%s<bg=green;fg=white> %s </> ', $this->getBorder($id), $prefix);
$this->started[$id]['out'] = \true;
}
$message .= \str_replace("\n", \sprintf("\n%s<bg=green;fg=white> %s </> ", $this->getBorder($id), $prefix), $buffer);
}
return $message;
}
/**
* Stops a formatting session.
*
* @return string
*/
public function stop(string $id, string $message, bool $successful, string $prefix = 'RES')
{
$trailingEOL = isset($this->started[$id]['out']) || isset($this->started[$id]['err']) ? "\n" : '';
if ($successful) {
return \sprintf("%s%s<bg=green;fg=white> %s </> <fg=green>%s</>\n", $trailingEOL, $this->getBorder($id), $prefix, $message);
}
$message = \sprintf("%s%s<bg=red;fg=white> %s </> <fg=red>%s</>\n", $trailingEOL, $this->getBorder($id), $prefix, $message);
unset($this->started[$id]['out'], $this->started[$id]['err']);
return $message;
}
private function getBorder(string $id) : string
{
return \sprintf('<bg=%s> </>', self::COLORS[$this->started[$id]['border']]);
}
/**
* {@inheritdoc}
*/
public function getName()
{
return 'debug_formatter';
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\VarDumper\Cloner\ClonerInterface;
use _PHPStan_6dcda722c\Symfony\Component\VarDumper\Cloner\VarCloner;
use _PHPStan_6dcda722c\Symfony\Component\VarDumper\Dumper\CliDumper;
/**
* @author Roland Franssen <franssen.roland@gmail.com>
*/
final class Dumper
{
private $output;
private $dumper;
private $cloner;
private $handler;
public function __construct(OutputInterface $output, ?CliDumper $dumper = null, ?ClonerInterface $cloner = null)
{
$this->output = $output;
$this->dumper = $dumper;
$this->cloner = $cloner;
if (\class_exists(CliDumper::class)) {
$this->handler = function ($var) : string {
$dumper = $this->dumper ?? ($this->dumper = new CliDumper(null, null, CliDumper::DUMP_LIGHT_ARRAY | CliDumper::DUMP_COMMA_SEPARATOR));
$dumper->setColors($this->output->isDecorated());
return \rtrim($dumper->dump(($this->cloner ?? ($this->cloner = new VarCloner()))->cloneVar($var)->withRefHandles(\false), \true));
};
} else {
$this->handler = function ($var) : string {
switch (\true) {
case null === $var:
return 'null';
case \true === $var:
return 'true';
case \false === $var:
return 'false';
case \is_string($var):
return '"' . $var . '"';
default:
return \rtrim(\print_r($var, \true));
}
};
}
}
public function __invoke($var) : string
{
return ($this->handler)($var);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatter;
/**
* The Formatter class provides helpers to format messages.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class FormatterHelper extends Helper
{
/**
* Formats a message within a section.
*
* @return string
*/
public function formatSection(string $section, string $message, string $style = 'info')
{
return \sprintf('<%s>[%s]</%s> %s', $style, $section, $style, $message);
}
/**
* Formats a message as a block of text.
*
* @param string|array $messages The message to write in the block
*
* @return string
*/
public function formatBlock($messages, string $style, bool $large = \false)
{
if (!\is_array($messages)) {
$messages = [$messages];
}
$len = 0;
$lines = [];
foreach ($messages as $message) {
$message = OutputFormatter::escape($message);
$lines[] = \sprintf($large ? ' %s ' : ' %s ', $message);
$len = \max(self::width($message) + ($large ? 4 : 2), $len);
}
$messages = $large ? [\str_repeat(' ', $len)] : [];
for ($i = 0; isset($lines[$i]); ++$i) {
$messages[] = $lines[$i] . \str_repeat(' ', $len - self::width($lines[$i]));
}
if ($large) {
$messages[] = \str_repeat(' ', $len);
}
for ($i = 0; isset($messages[$i]); ++$i) {
$messages[$i] = \sprintf('<%s>%s</%s>', $style, $messages[$i], $style);
}
return \implode("\n", $messages);
}
/**
* Truncates a message to the given length.
*
* @return string
*/
public function truncate(string $message, int $length, string $suffix = '...')
{
$computedLength = $length - self::width($suffix);
if ($computedLength > self::width($message)) {
return $message;
}
return self::substr($message, 0, $length) . $suffix;
}
/**
* {@inheritdoc}
*/
public function getName()
{
return 'formatter';
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Command\Command;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
/**
* HelperSet represents a set of helpers to be used with a command.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @implements \IteratorAggregate<string, Helper>
*/
class HelperSet implements \IteratorAggregate
{
/** @var array<string, Helper> */
private $helpers = [];
private $command;
/**
* @param Helper[] $helpers An array of helper
*/
public function __construct(array $helpers = [])
{
foreach ($helpers as $alias => $helper) {
$this->set($helper, \is_int($alias) ? null : $alias);
}
}
public function set(HelperInterface $helper, ?string $alias = null)
{
$this->helpers[$helper->getName()] = $helper;
if (null !== $alias) {
$this->helpers[$alias] = $helper;
}
$helper->setHelperSet($this);
}
/**
* Returns true if the helper if defined.
*
* @return bool
*/
public function has(string $name)
{
return isset($this->helpers[$name]);
}
/**
* Gets a helper value.
*
* @return HelperInterface
*
* @throws InvalidArgumentException if the helper is not defined
*/
public function get(string $name)
{
if (!$this->has($name)) {
throw new InvalidArgumentException(\sprintf('The helper "%s" is not defined.', $name));
}
return $this->helpers[$name];
}
/**
* @deprecated since Symfony 5.4
*/
public function setCommand(?Command $command = null)
{
trigger_deprecation('symfony/console', '5.4', 'Method "%s()" is deprecated.', __METHOD__);
$this->command = $command;
}
/**
* Gets the command associated with this helper set.
*
* @return Command
*
* @deprecated since Symfony 5.4
*/
public function getCommand()
{
trigger_deprecation('symfony/console', '5.4', 'Method "%s()" is deprecated.', __METHOD__);
return $this->command;
}
/**
* @return \Traversable<string, Helper>
*/
#[\ReturnTypeWillChange]
public function getIterator()
{
return new \ArrayIterator($this->helpers);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Question\ChoiceQuestion;
use _PHPStan_6dcda722c\Symfony\Component\Console\Question\ConfirmationQuestion;
use _PHPStan_6dcda722c\Symfony\Component\Console\Question\Question;
use _PHPStan_6dcda722c\Symfony\Component\Console\Style\SymfonyStyle;
/**
* Symfony Style Guide compliant question helper.
*
* @author Kevin Bond <kevinbond@gmail.com>
*/
class SymfonyQuestionHelper extends QuestionHelper
{
/**
* {@inheritdoc}
*/
protected function writePrompt(OutputInterface $output, Question $question)
{
$text = OutputFormatter::escapeTrailingBackslash($question->getQuestion());
$default = $question->getDefault();
if ($question->isMultiline()) {
$text .= \sprintf(' (press %s to continue)', $this->getEofShortcut());
}
switch (\true) {
case null === $default:
$text = \sprintf(' <info>%s</info>:', $text);
break;
case $question instanceof ConfirmationQuestion:
$text = \sprintf(' <info>%s (yes/no)</info> [<comment>%s</comment>]:', $text, $default ? 'yes' : 'no');
break;
case $question instanceof ChoiceQuestion && $question->isMultiselect():
$choices = $question->getChoices();
$default = \explode(',', $default);
foreach ($default as $key => $value) {
$default[$key] = $choices[\trim($value)];
}
$text = \sprintf(' <info>%s</info> [<comment>%s</comment>]:', $text, OutputFormatter::escape(\implode(', ', $default)));
break;
case $question instanceof ChoiceQuestion:
$choices = $question->getChoices();
$text = \sprintf(' <info>%s</info> [<comment>%s</comment>]:', $text, OutputFormatter::escape($choices[$default] ?? $default));
break;
default:
$text = \sprintf(' <info>%s</info> [<comment>%s</comment>]:', $text, OutputFormatter::escape($default));
}
$output->writeln($text);
$prompt = ' > ';
if ($question instanceof ChoiceQuestion) {
$output->writeln($this->formatChoiceQuestionChoices($question, 'comment'));
$prompt = $question->getPrompt();
}
$output->write($prompt);
}
/**
* {@inheritdoc}
*/
protected function writeError(OutputInterface $output, \Exception $error)
{
if ($output instanceof SymfonyStyle) {
$output->newLine();
$output->error($error->getMessage());
return;
}
parent::writeError($output, $error);
}
private function getEofShortcut() : string
{
if ('Windows' === \PHP_OS_FAMILY) {
return '<comment>Ctrl+Z</comment> then <comment>Enter</comment>';
}
return '<comment>Ctrl+D</comment>';
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Process\Exception\ProcessFailedException;
use _PHPStan_6dcda722c\Symfony\Component\Process\Process;
/**
* The ProcessHelper class provides helpers to run external processes.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @final
*/
class ProcessHelper extends Helper
{
/**
* Runs an external process.
*
* @param array|Process $cmd An instance of Process or an array of the command and arguments
* @param callable|null $callback A PHP callback to run whenever there is some
* output available on STDOUT or STDERR
*/
public function run(OutputInterface $output, $cmd, ?string $error = null, ?callable $callback = null, int $verbosity = OutputInterface::VERBOSITY_VERY_VERBOSE) : Process
{
if (!\class_exists(Process::class)) {
throw new \LogicException('The ProcessHelper cannot be run as the Process component is not installed. Try running "compose require symfony/process".');
}
if ($output instanceof ConsoleOutputInterface) {
$output = $output->getErrorOutput();
}
$formatter = $this->getHelperSet()->get('debug_formatter');
if ($cmd instanceof Process) {
$cmd = [$cmd];
}
if (!\is_array($cmd)) {
throw new \TypeError(\sprintf('The "command" argument of "%s()" must be an array or a "%s" instance, "%s" given.', __METHOD__, Process::class, \get_debug_type($cmd)));
}
if (\is_string($cmd[0] ?? null)) {
$process = new Process($cmd);
$cmd = [];
} elseif (($cmd[0] ?? null) instanceof Process) {
$process = $cmd[0];
unset($cmd[0]);
} else {
throw new \InvalidArgumentException(\sprintf('Invalid command provided to "%s()": the command should be an array whose first element is either the path to the binary to run or a "Process" object.', __METHOD__));
}
if ($verbosity <= $output->getVerbosity()) {
$output->write($formatter->start(\spl_object_hash($process), $this->escapeString($process->getCommandLine())));
}
if ($output->isDebug()) {
$callback = $this->wrapCallback($output, $process, $callback);
}
$process->run($callback, $cmd);
if ($verbosity <= $output->getVerbosity()) {
$message = $process->isSuccessful() ? 'Command ran successfully' : \sprintf('%s Command did not run successfully', $process->getExitCode());
$output->write($formatter->stop(\spl_object_hash($process), $message, $process->isSuccessful()));
}
if (!$process->isSuccessful() && null !== $error) {
$output->writeln(\sprintf('<error>%s</error>', $this->escapeString($error)));
}
return $process;
}
/**
* Runs the process.
*
* This is identical to run() except that an exception is thrown if the process
* exits with a non-zero exit code.
*
* @param array|Process $cmd An instance of Process or a command to run
* @param callable|null $callback A PHP callback to run whenever there is some
* output available on STDOUT or STDERR
*
* @throws ProcessFailedException
*
* @see run()
*/
public function mustRun(OutputInterface $output, $cmd, ?string $error = null, ?callable $callback = null) : Process
{
$process = $this->run($output, $cmd, $error, $callback);
if (!$process->isSuccessful()) {
throw new ProcessFailedException($process);
}
return $process;
}
/**
* Wraps a Process callback to add debugging output.
*/
public function wrapCallback(OutputInterface $output, Process $process, ?callable $callback = null) : callable
{
if ($output instanceof ConsoleOutputInterface) {
$output = $output->getErrorOutput();
}
$formatter = $this->getHelperSet()->get('debug_formatter');
return function ($type, $buffer) use($output, $process, $callback, $formatter) {
$output->write($formatter->progress(\spl_object_hash($process), $this->escapeString($buffer), Process::ERR === $type));
if (null !== $callback) {
$callback($type, $buffer);
}
};
}
private function escapeString(string $str) : string
{
return \str_replace('<', '\\<', $str);
}
/**
* {@inheritdoc}
*/
public function getName() : string
{
return 'process';
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatterInterface;
use _PHPStan_6dcda722c\Symfony\Component\String\UnicodeString;
/**
* Helper is the base class for all helper classes.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
abstract class Helper implements HelperInterface
{
protected $helperSet = null;
/**
* {@inheritdoc}
*/
public function setHelperSet(?HelperSet $helperSet = null)
{
$this->helperSet = $helperSet;
}
/**
* {@inheritdoc}
*/
public function getHelperSet()
{
return $this->helperSet;
}
/**
* Returns the length of a string, using mb_strwidth if it is available.
*
* @deprecated since Symfony 5.3
*
* @return int
*/
public static function strlen(?string $string)
{
trigger_deprecation('symfony/console', '5.3', 'Method "%s()" is deprecated and will be removed in Symfony 6.0. Use Helper::width() or Helper::length() instead.', __METHOD__);
return self::width($string);
}
/**
* Returns the width of a string, using mb_strwidth if it is available.
* The width is how many characters positions the string will use.
*/
public static function width(?string $string) : int
{
$string ?? ($string = '');
if (\preg_match('//u', $string)) {
return (new UnicodeString($string))->width(\false);
}
if (\false === ($encoding = \mb_detect_encoding($string, null, \true))) {
return \strlen($string);
}
return \mb_strwidth($string, $encoding);
}
/**
* Returns the length of a string, using mb_strlen if it is available.
* The length is related to how many bytes the string will use.
*/
public static function length(?string $string) : int
{
$string ?? ($string = '');
if (\preg_match('//u', $string)) {
return (new UnicodeString($string))->length();
}
if (\false === ($encoding = \mb_detect_encoding($string, null, \true))) {
return \strlen($string);
}
return \mb_strlen($string, $encoding);
}
/**
* Returns the subset of a string, using mb_substr if it is available.
*
* @return string
*/
public static function substr(?string $string, int $from, ?int $length = null)
{
$string ?? ($string = '');
if (\false === ($encoding = \mb_detect_encoding($string, null, \true))) {
return \substr($string, $from, $length);
}
return \mb_substr($string, $from, $length, $encoding);
}
public static function formatTime($secs)
{
static $timeFormats = [[0, '< 1 sec'], [1, '1 sec'], [2, 'secs', 1], [60, '1 min'], [120, 'mins', 60], [3600, '1 hr'], [7200, 'hrs', 3600], [86400, '1 day'], [172800, 'days', 86400]];
foreach ($timeFormats as $index => $format) {
if ($secs >= $format[0]) {
if (isset($timeFormats[$index + 1]) && $secs < $timeFormats[$index + 1][0] || $index == \count($timeFormats) - 1) {
if (2 == \count($format)) {
return $format[1];
}
return \floor($secs / $format[2]) . ' ' . $format[1];
}
}
}
}
public static function formatMemory(int $memory)
{
if ($memory >= 1024 * 1024 * 1024) {
return \sprintf('%.1f GiB', $memory / 1024 / 1024 / 1024);
}
if ($memory >= 1024 * 1024) {
return \sprintf('%.1f MiB', $memory / 1024 / 1024);
}
if ($memory >= 1024) {
return \sprintf('%d KiB', $memory / 1024);
}
return \sprintf('%d B', $memory);
}
/**
* @deprecated since Symfony 5.3
*/
public static function strlenWithoutDecoration(OutputFormatterInterface $formatter, ?string $string)
{
trigger_deprecation('symfony/console', '5.3', 'Method "%s()" is deprecated and will be removed in Symfony 6.0. Use Helper::removeDecoration() instead.', __METHOD__);
return self::width(self::removeDecoration($formatter, $string));
}
public static function removeDecoration(OutputFormatterInterface $formatter, ?string $string)
{
$isDecorated = $formatter->isDecorated();
$formatter->setDecorated(\false);
// remove <...> formatting
$string = $formatter->format($string ?? '');
// remove already formatted characters
$string = \preg_replace("/\x1b\\[[^m]*m/", '', $string ?? '');
// remove terminal hyperlinks
$string = \preg_replace('/\\033]8;[^;]*;[^\\033]*\\033\\\\/', '', $string ?? '');
$formatter->setDecorated($isDecorated);
return $string;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputAwareInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
/**
* An implementation of InputAwareInterface for Helpers.
*
* @author Wouter J <waldio.webdesign@gmail.com>
*/
abstract class InputAwareHelper extends Helper implements InputAwareInterface
{
protected $input;
/**
* {@inheritdoc}
*/
public function setInput(InputInterface $input)
{
$this->input = $input;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
/**
* Marks a row as being a separator.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class TableSeparator extends TableCell
{
public function __construct(array $options = [])
{
parent::__construct('', $options);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\LogicException;
/**
* Defines the styles for a Table.
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Саша Стаменковић <umpirsky@gmail.com>
* @author Dany Maillard <danymaillard93b@gmail.com>
*/
class TableStyle
{
private $paddingChar = ' ';
private $horizontalOutsideBorderChar = '-';
private $horizontalInsideBorderChar = '-';
private $verticalOutsideBorderChar = '|';
private $verticalInsideBorderChar = '|';
private $crossingChar = '+';
private $crossingTopRightChar = '+';
private $crossingTopMidChar = '+';
private $crossingTopLeftChar = '+';
private $crossingMidRightChar = '+';
private $crossingBottomRightChar = '+';
private $crossingBottomMidChar = '+';
private $crossingBottomLeftChar = '+';
private $crossingMidLeftChar = '+';
private $crossingTopLeftBottomChar = '+';
private $crossingTopMidBottomChar = '+';
private $crossingTopRightBottomChar = '+';
private $headerTitleFormat = '<fg=black;bg=white;options=bold> %s </>';
private $footerTitleFormat = '<fg=black;bg=white;options=bold> %s </>';
private $cellHeaderFormat = '<info>%s</info>';
private $cellRowFormat = '%s';
private $cellRowContentFormat = ' %s ';
private $borderFormat = '%s';
private $padType = \STR_PAD_RIGHT;
/**
* Sets padding character, used for cell padding.
*
* @return $this
*/
public function setPaddingChar(string $paddingChar)
{
if (!$paddingChar) {
throw new LogicException('The padding char must not be empty.');
}
$this->paddingChar = $paddingChar;
return $this;
}
/**
* Gets padding character, used for cell padding.
*
* @return string
*/
public function getPaddingChar()
{
return $this->paddingChar;
}
/**
* Sets horizontal border characters.
*
* <code>
* ╔═══════════════╤══════════════════════════╤══════════════════╗
* 1 ISBN 2 Title │ Author ║
* ╠═══════════════╪══════════════════════════╪══════════════════╣
* ║ 99921-58-10-7 │ Divine Comedy │ Dante Alighieri ║
* ║ 9971-5-0210-0 │ A Tale of Two Cities │ Charles Dickens ║
* ║ 960-425-059-0 │ The Lord of the Rings │ J. R. R. Tolkien ║
* ║ 80-902734-1-6 │ And Then There Were None │ Agatha Christie ║
* ╚═══════════════╧══════════════════════════╧══════════════════╝
* </code>
*
* @return $this
*/
public function setHorizontalBorderChars(string $outside, ?string $inside = null) : self
{
$this->horizontalOutsideBorderChar = $outside;
$this->horizontalInsideBorderChar = $inside ?? $outside;
return $this;
}
/**
* Sets vertical border characters.
*
* <code>
* ╔═══════════════╤══════════════════════════╤══════════════════╗
* ║ ISBN │ Title │ Author ║
* ╠═══════1═══════╪══════════════════════════╪══════════════════╣
* ║ 99921-58-10-7 │ Divine Comedy │ Dante Alighieri ║
* ║ 9971-5-0210-0 │ A Tale of Two Cities │ Charles Dickens ║
* ╟───────2───────┼──────────────────────────┼──────────────────╢
* ║ 960-425-059-0 │ The Lord of the Rings │ J. R. R. Tolkien ║
* ║ 80-902734-1-6 │ And Then There Were None │ Agatha Christie ║
* ╚═══════════════╧══════════════════════════╧══════════════════╝
* </code>
*
* @return $this
*/
public function setVerticalBorderChars(string $outside, ?string $inside = null) : self
{
$this->verticalOutsideBorderChar = $outside;
$this->verticalInsideBorderChar = $inside ?? $outside;
return $this;
}
/**
* Gets border characters.
*
* @internal
*/
public function getBorderChars() : array
{
return [$this->horizontalOutsideBorderChar, $this->verticalOutsideBorderChar, $this->horizontalInsideBorderChar, $this->verticalInsideBorderChar];
}
/**
* Sets crossing characters.
*
* Example:
* <code>
* 1═══════════════2══════════════════════════2══════════════════3
* ║ ISBN │ Title │ Author ║
* 8'══════════════0'═════════════════════════0'═════════════════4'
* ║ 99921-58-10-7 │ Divine Comedy │ Dante Alighieri ║
* ║ 9971-5-0210-0 │ A Tale of Two Cities │ Charles Dickens ║
* 8───────────────0──────────────────────────0──────────────────4
* ║ 960-425-059-0 │ The Lord of the Rings │ J. R. R. Tolkien ║
* ║ 80-902734-1-6 │ And Then There Were None │ Agatha Christie ║
* 7═══════════════6══════════════════════════6══════════════════5
* </code>
*
* @param string $cross Crossing char (see #0 of example)
* @param string $topLeft Top left char (see #1 of example)
* @param string $topMid Top mid char (see #2 of example)
* @param string $topRight Top right char (see #3 of example)
* @param string $midRight Mid right char (see #4 of example)
* @param string $bottomRight Bottom right char (see #5 of example)
* @param string $bottomMid Bottom mid char (see #6 of example)
* @param string $bottomLeft Bottom left char (see #7 of example)
* @param string $midLeft Mid left char (see #8 of example)
* @param string|null $topLeftBottom Top left bottom char (see #8' of example), equals to $midLeft if null
* @param string|null $topMidBottom Top mid bottom char (see #0' of example), equals to $cross if null
* @param string|null $topRightBottom Top right bottom char (see #4' of example), equals to $midRight if null
*
* @return $this
*/
public function setCrossingChars(string $cross, string $topLeft, string $topMid, string $topRight, string $midRight, string $bottomRight, string $bottomMid, string $bottomLeft, string $midLeft, ?string $topLeftBottom = null, ?string $topMidBottom = null, ?string $topRightBottom = null) : self
{
$this->crossingChar = $cross;
$this->crossingTopLeftChar = $topLeft;
$this->crossingTopMidChar = $topMid;
$this->crossingTopRightChar = $topRight;
$this->crossingMidRightChar = $midRight;
$this->crossingBottomRightChar = $bottomRight;
$this->crossingBottomMidChar = $bottomMid;
$this->crossingBottomLeftChar = $bottomLeft;
$this->crossingMidLeftChar = $midLeft;
$this->crossingTopLeftBottomChar = $topLeftBottom ?? $midLeft;
$this->crossingTopMidBottomChar = $topMidBottom ?? $cross;
$this->crossingTopRightBottomChar = $topRightBottom ?? $midRight;
return $this;
}
/**
* Sets default crossing character used for each cross.
*
* @see {@link setCrossingChars()} for setting each crossing individually.
*/
public function setDefaultCrossingChar(string $char) : self
{
return $this->setCrossingChars($char, $char, $char, $char, $char, $char, $char, $char, $char);
}
/**
* Gets crossing character.
*
* @return string
*/
public function getCrossingChar()
{
return $this->crossingChar;
}
/**
* Gets crossing characters.
*
* @internal
*/
public function getCrossingChars() : array
{
return [$this->crossingChar, $this->crossingTopLeftChar, $this->crossingTopMidChar, $this->crossingTopRightChar, $this->crossingMidRightChar, $this->crossingBottomRightChar, $this->crossingBottomMidChar, $this->crossingBottomLeftChar, $this->crossingMidLeftChar, $this->crossingTopLeftBottomChar, $this->crossingTopMidBottomChar, $this->crossingTopRightBottomChar];
}
/**
* Sets header cell format.
*
* @return $this
*/
public function setCellHeaderFormat(string $cellHeaderFormat)
{
$this->cellHeaderFormat = $cellHeaderFormat;
return $this;
}
/**
* Gets header cell format.
*
* @return string
*/
public function getCellHeaderFormat()
{
return $this->cellHeaderFormat;
}
/**
* Sets row cell format.
*
* @return $this
*/
public function setCellRowFormat(string $cellRowFormat)
{
$this->cellRowFormat = $cellRowFormat;
return $this;
}
/**
* Gets row cell format.
*
* @return string
*/
public function getCellRowFormat()
{
return $this->cellRowFormat;
}
/**
* Sets row cell content format.
*
* @return $this
*/
public function setCellRowContentFormat(string $cellRowContentFormat)
{
$this->cellRowContentFormat = $cellRowContentFormat;
return $this;
}
/**
* Gets row cell content format.
*
* @return string
*/
public function getCellRowContentFormat()
{
return $this->cellRowContentFormat;
}
/**
* Sets table border format.
*
* @return $this
*/
public function setBorderFormat(string $borderFormat)
{
$this->borderFormat = $borderFormat;
return $this;
}
/**
* Gets table border format.
*
* @return string
*/
public function getBorderFormat()
{
return $this->borderFormat;
}
/**
* Sets cell padding type.
*
* @return $this
*/
public function setPadType(int $padType)
{
if (!\in_array($padType, [\STR_PAD_LEFT, \STR_PAD_RIGHT, \STR_PAD_BOTH], \true)) {
throw new InvalidArgumentException('Invalid padding type. Expected one of (STR_PAD_LEFT, STR_PAD_RIGHT, STR_PAD_BOTH).');
}
$this->padType = $padType;
return $this;
}
/**
* Gets cell padding type.
*
* @return int
*/
public function getPadType()
{
return $this->padType;
}
public function getHeaderTitleFormat() : string
{
return $this->headerTitleFormat;
}
/**
* @return $this
*/
public function setHeaderTitleFormat(string $format) : self
{
$this->headerTitleFormat = $format;
return $this;
}
public function getFooterTitleFormat() : string
{
return $this->footerTitleFormat;
}
/**
* @return $this
*/
public function setFooterTitleFormat(string $format) : self
{
$this->footerTitleFormat = $format;
return $this;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Cursor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\LogicException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleSectionOutput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Terminal;
/**
* The ProgressBar provides helpers to display progress output.
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Chris Jones <leeked@gmail.com>
*/
final class ProgressBar
{
public const FORMAT_VERBOSE = 'verbose';
public const FORMAT_VERY_VERBOSE = 'very_verbose';
public const FORMAT_DEBUG = 'debug';
public const FORMAT_NORMAL = 'normal';
private const FORMAT_VERBOSE_NOMAX = 'verbose_nomax';
private const FORMAT_VERY_VERBOSE_NOMAX = 'very_verbose_nomax';
private const FORMAT_DEBUG_NOMAX = 'debug_nomax';
private const FORMAT_NORMAL_NOMAX = 'normal_nomax';
private $barWidth = 28;
private $barChar;
private $emptyBarChar = '-';
private $progressChar = '>';
private $format;
private $internalFormat;
private $redrawFreq = 1;
private $writeCount;
private $lastWriteTime;
private $minSecondsBetweenRedraws = 0;
private $maxSecondsBetweenRedraws = 1;
private $output;
private $step = 0;
private $max;
private $startTime;
private $stepWidth;
private $percent = 0.0;
private $messages = [];
private $overwrite = \true;
private $terminal;
private $previousMessage;
private $cursor;
private static $formatters;
private static $formats;
/**
* @param int $max Maximum steps (0 if unknown)
*/
public function __construct(OutputInterface $output, int $max = 0, float $minSecondsBetweenRedraws = 1 / 25)
{
if ($output instanceof ConsoleOutputInterface) {
$output = $output->getErrorOutput();
}
$this->output = $output;
$this->setMaxSteps($max);
$this->terminal = new Terminal();
if (0 < $minSecondsBetweenRedraws) {
$this->redrawFreq = null;
$this->minSecondsBetweenRedraws = $minSecondsBetweenRedraws;
}
if (!$this->output->isDecorated()) {
// disable overwrite when output does not support ANSI codes.
$this->overwrite = \false;
// set a reasonable redraw frequency so output isn't flooded
$this->redrawFreq = null;
}
$this->startTime = \time();
$this->cursor = new Cursor($output);
}
/**
* Sets a placeholder formatter for a given name.
*
* This method also allow you to override an existing placeholder.
*
* @param string $name The placeholder name (including the delimiter char like %)
* @param callable $callable A PHP callable
*/
public static function setPlaceholderFormatterDefinition(string $name, callable $callable) : void
{
if (!self::$formatters) {
self::$formatters = self::initPlaceholderFormatters();
}
self::$formatters[$name] = $callable;
}
/**
* Gets the placeholder formatter for a given name.
*
* @param string $name The placeholder name (including the delimiter char like %)
*/
public static function getPlaceholderFormatterDefinition(string $name) : ?callable
{
if (!self::$formatters) {
self::$formatters = self::initPlaceholderFormatters();
}
return self::$formatters[$name] ?? null;
}
/**
* Sets a format for a given name.
*
* This method also allow you to override an existing format.
*
* @param string $name The format name
* @param string $format A format string
*/
public static function setFormatDefinition(string $name, string $format) : void
{
if (!self::$formats) {
self::$formats = self::initFormats();
}
self::$formats[$name] = $format;
}
/**
* Gets the format for a given name.
*
* @param string $name The format name
*/
public static function getFormatDefinition(string $name) : ?string
{
if (!self::$formats) {
self::$formats = self::initFormats();
}
return self::$formats[$name] ?? null;
}
/**
* Associates a text with a named placeholder.
*
* The text is displayed when the progress bar is rendered but only
* when the corresponding placeholder is part of the custom format line
* (by wrapping the name with %).
*
* @param string $message The text to associate with the placeholder
* @param string $name The name of the placeholder
*/
public function setMessage(string $message, string $name = 'message')
{
$this->messages[$name] = $message;
}
/**
* @return string|null
*/
public function getMessage(string $name = 'message')
{
return $this->messages[$name] ?? null;
}
public function getStartTime() : int
{
return $this->startTime;
}
public function getMaxSteps() : int
{
return $this->max;
}
public function getProgress() : int
{
return $this->step;
}
private function getStepWidth() : int
{
return $this->stepWidth;
}
public function getProgressPercent() : float
{
return $this->percent;
}
public function getBarOffset() : float
{
return \floor($this->max ? $this->percent * $this->barWidth : (null === $this->redrawFreq ? (int) (\min(5, $this->barWidth / 15) * $this->writeCount) : $this->step) % $this->barWidth);
}
public function getEstimated() : float
{
if (!$this->step) {
return 0;
}
return \round((\time() - $this->startTime) / $this->step * $this->max);
}
public function getRemaining() : float
{
if (!$this->step) {
return 0;
}
return \round((\time() - $this->startTime) / $this->step * ($this->max - $this->step));
}
public function setBarWidth(int $size)
{
$this->barWidth = \max(1, $size);
}
public function getBarWidth() : int
{
return $this->barWidth;
}
public function setBarCharacter(string $char)
{
$this->barChar = $char;
}
public function getBarCharacter() : string
{
return $this->barChar ?? ($this->max ? '=' : $this->emptyBarChar);
}
public function setEmptyBarCharacter(string $char)
{
$this->emptyBarChar = $char;
}
public function getEmptyBarCharacter() : string
{
return $this->emptyBarChar;
}
public function setProgressCharacter(string $char)
{
$this->progressChar = $char;
}
public function getProgressCharacter() : string
{
return $this->progressChar;
}
public function setFormat(string $format)
{
$this->format = null;
$this->internalFormat = $format;
}
/**
* Sets the redraw frequency.
*
* @param int|null $freq The frequency in steps
*/
public function setRedrawFrequency(?int $freq)
{
$this->redrawFreq = null !== $freq ? \max(1, $freq) : null;
}
public function minSecondsBetweenRedraws(float $seconds) : void
{
$this->minSecondsBetweenRedraws = $seconds;
}
public function maxSecondsBetweenRedraws(float $seconds) : void
{
$this->maxSecondsBetweenRedraws = $seconds;
}
/**
* Returns an iterator that will automatically update the progress bar when iterated.
*
* @param int|null $max Number of steps to complete the bar (0 if indeterminate), if null it will be inferred from $iterable
*/
public function iterate(iterable $iterable, ?int $max = null) : iterable
{
$this->start($max ?? (\is_countable($iterable) ? \count($iterable) : 0));
foreach ($iterable as $key => $value) {
(yield $key => $value);
$this->advance();
}
$this->finish();
}
/**
* Starts the progress output.
*
* @param int|null $max Number of steps to complete the bar (0 if indeterminate), null to leave unchanged
*/
public function start(?int $max = null)
{
$this->startTime = \time();
$this->step = 0;
$this->percent = 0.0;
if (null !== $max) {
$this->setMaxSteps($max);
}
$this->display();
}
/**
* Advances the progress output X steps.
*
* @param int $step Number of steps to advance
*/
public function advance(int $step = 1)
{
$this->setProgress($this->step + $step);
}
/**
* Sets whether to overwrite the progressbar, false for new line.
*/
public function setOverwrite(bool $overwrite)
{
$this->overwrite = $overwrite;
}
public function setProgress(int $step)
{
if ($this->max && $step > $this->max) {
$this->max = $step;
} elseif ($step < 0) {
$step = 0;
}
$redrawFreq = $this->redrawFreq ?? ($this->max ?: 10) / 10;
$prevPeriod = (int) ($this->step / $redrawFreq);
$currPeriod = (int) ($step / $redrawFreq);
$this->step = $step;
$this->percent = $this->max ? (float) $this->step / $this->max : 0;
$timeInterval = \microtime(\true) - $this->lastWriteTime;
// Draw regardless of other limits
if ($this->max === $step) {
$this->display();
return;
}
// Throttling
if ($timeInterval < $this->minSecondsBetweenRedraws) {
return;
}
// Draw each step period, but not too late
if ($prevPeriod !== $currPeriod || $timeInterval >= $this->maxSecondsBetweenRedraws) {
$this->display();
}
}
public function setMaxSteps(int $max)
{
$this->format = null;
$this->max = \max(0, $max);
$this->stepWidth = $this->max ? Helper::width((string) $this->max) : 4;
}
/**
* Finishes the progress output.
*/
public function finish() : void
{
if (!$this->max) {
$this->max = $this->step;
}
if ($this->step === $this->max && !$this->overwrite) {
// prevent double 100% output
return;
}
$this->setProgress($this->max);
}
/**
* Outputs the current progress string.
*/
public function display() : void
{
if (OutputInterface::VERBOSITY_QUIET === $this->output->getVerbosity()) {
return;
}
if (null === $this->format) {
$this->setRealFormat($this->internalFormat ?: $this->determineBestFormat());
}
$this->overwrite($this->buildLine());
}
/**
* Removes the progress bar from the current line.
*
* This is useful if you wish to write some output
* while a progress bar is running.
* Call display() to show the progress bar again.
*/
public function clear() : void
{
if (!$this->overwrite) {
return;
}
if (null === $this->format) {
$this->setRealFormat($this->internalFormat ?: $this->determineBestFormat());
}
$this->overwrite('');
}
private function setRealFormat(string $format)
{
// try to use the _nomax variant if available
if (!$this->max && null !== self::getFormatDefinition($format . '_nomax')) {
$this->format = self::getFormatDefinition($format . '_nomax');
} elseif (null !== self::getFormatDefinition($format)) {
$this->format = self::getFormatDefinition($format);
} else {
$this->format = $format;
}
}
/**
* Overwrites a previous message to the output.
*/
private function overwrite(string $message) : void
{
if ($this->previousMessage === $message) {
return;
}
$originalMessage = $message;
if ($this->overwrite) {
if (null !== $this->previousMessage) {
if ($this->output instanceof ConsoleSectionOutput) {
$messageLines = \explode("\n", $this->previousMessage);
$lineCount = \count($messageLines);
foreach ($messageLines as $messageLine) {
$messageLineLength = Helper::width(Helper::removeDecoration($this->output->getFormatter(), $messageLine));
if ($messageLineLength > $this->terminal->getWidth()) {
$lineCount += \floor($messageLineLength / $this->terminal->getWidth());
}
}
$this->output->clear($lineCount);
} else {
$lineCount = \substr_count($this->previousMessage, "\n");
for ($i = 0; $i < $lineCount; ++$i) {
$this->cursor->moveToColumn(1);
$this->cursor->clearLine();
$this->cursor->moveUp();
}
$this->cursor->moveToColumn(1);
$this->cursor->clearLine();
}
}
} elseif ($this->step > 0) {
$message = \PHP_EOL . $message;
}
$this->previousMessage = $originalMessage;
$this->lastWriteTime = \microtime(\true);
$this->output->write($message);
++$this->writeCount;
}
private function determineBestFormat() : string
{
switch ($this->output->getVerbosity()) {
// OutputInterface::VERBOSITY_QUIET: display is disabled anyway
case OutputInterface::VERBOSITY_VERBOSE:
return $this->max ? self::FORMAT_VERBOSE : self::FORMAT_VERBOSE_NOMAX;
case OutputInterface::VERBOSITY_VERY_VERBOSE:
return $this->max ? self::FORMAT_VERY_VERBOSE : self::FORMAT_VERY_VERBOSE_NOMAX;
case OutputInterface::VERBOSITY_DEBUG:
return $this->max ? self::FORMAT_DEBUG : self::FORMAT_DEBUG_NOMAX;
default:
return $this->max ? self::FORMAT_NORMAL : self::FORMAT_NORMAL_NOMAX;
}
}
private static function initPlaceholderFormatters() : array
{
return ['bar' => function (self $bar, OutputInterface $output) {
$completeBars = $bar->getBarOffset();
$display = \str_repeat($bar->getBarCharacter(), $completeBars);
if ($completeBars < $bar->getBarWidth()) {
$emptyBars = $bar->getBarWidth() - $completeBars - Helper::length(Helper::removeDecoration($output->getFormatter(), $bar->getProgressCharacter()));
$display .= $bar->getProgressCharacter() . \str_repeat($bar->getEmptyBarCharacter(), $emptyBars);
}
return $display;
}, 'elapsed' => function (self $bar) {
return Helper::formatTime(\time() - $bar->getStartTime());
}, 'remaining' => function (self $bar) {
if (!$bar->getMaxSteps()) {
throw new LogicException('Unable to display the remaining time if the maximum number of steps is not set.');
}
return Helper::formatTime($bar->getRemaining());
}, 'estimated' => function (self $bar) {
if (!$bar->getMaxSteps()) {
throw new LogicException('Unable to display the estimated time if the maximum number of steps is not set.');
}
return Helper::formatTime($bar->getEstimated());
}, 'memory' => function (self $bar) {
return Helper::formatMemory(\memory_get_usage(\true));
}, 'current' => function (self $bar) {
return \str_pad($bar->getProgress(), $bar->getStepWidth(), ' ', \STR_PAD_LEFT);
}, 'max' => function (self $bar) {
return $bar->getMaxSteps();
}, 'percent' => function (self $bar) {
return \floor($bar->getProgressPercent() * 100);
}];
}
private static function initFormats() : array
{
return [self::FORMAT_NORMAL => ' %current%/%max% [%bar%] %percent:3s%%', self::FORMAT_NORMAL_NOMAX => ' %current% [%bar%]', self::FORMAT_VERBOSE => ' %current%/%max% [%bar%] %percent:3s%% %elapsed:6s%', self::FORMAT_VERBOSE_NOMAX => ' %current% [%bar%] %elapsed:6s%', self::FORMAT_VERY_VERBOSE => ' %current%/%max% [%bar%] %percent:3s%% %elapsed:6s%/%estimated:-6s%', self::FORMAT_VERY_VERBOSE_NOMAX => ' %current% [%bar%] %elapsed:6s%', self::FORMAT_DEBUG => ' %current%/%max% [%bar%] %percent:3s%% %elapsed:6s%/%estimated:-6s% %memory:6s%', self::FORMAT_DEBUG_NOMAX => ' %current% [%bar%] %elapsed:6s% %memory:6s%'];
}
private function buildLine() : string
{
$regex = "{%([a-z\\-_]+)(?:\\:([^%]+))?%}i";
$callback = function ($matches) {
if ($formatter = $this::getPlaceholderFormatterDefinition($matches[1])) {
$text = $formatter($this, $this->output);
} elseif (isset($this->messages[$matches[1]])) {
$text = $this->messages[$matches[1]];
} else {
return $matches[0];
}
if (isset($matches[2])) {
$text = \sprintf('%' . $matches[2], $text);
}
return $text;
};
$line = \preg_replace_callback($regex, $callback, $this->format);
// gets string length for each sub line with multiline format
$linesLength = \array_map(function ($subLine) {
return Helper::width(Helper::removeDecoration($this->output->getFormatter(), \rtrim($subLine, "\r")));
}, \explode("\n", $line));
$linesWidth = \max($linesLength);
$terminalWidth = $this->terminal->getWidth();
if ($linesWidth <= $terminalWidth) {
return $line;
}
$this->setBarWidth($this->barWidth - $linesWidth + $terminalWidth);
return \preg_replace_callback($regex, $callback, $this->format);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
/**
* @internal
*/
class TableRows implements \IteratorAggregate
{
private $generator;
public function __construct(\Closure $generator)
{
$this->generator = $generator;
}
public function getIterator() : \Traversable
{
return ($this->generator)();
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Cursor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\MissingInputException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\RuntimeException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatterStyle;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\InputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Input\StreamableInputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleOutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleSectionOutput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Question\ChoiceQuestion;
use _PHPStan_6dcda722c\Symfony\Component\Console\Question\Question;
use _PHPStan_6dcda722c\Symfony\Component\Console\Terminal;
use function _PHPStan_6dcda722c\Symfony\Component\String\s;
/**
* The QuestionHelper class provides helpers to interact with the user.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class QuestionHelper extends Helper
{
/**
* @var resource|null
*/
private $inputStream;
private static $stty = \true;
private static $stdinIsInteractive;
/**
* Asks a question to the user.
*
* @return mixed The user answer
*
* @throws RuntimeException If there is no data to read in the input stream
*/
public function ask(InputInterface $input, OutputInterface $output, Question $question)
{
if ($output instanceof ConsoleOutputInterface) {
$output = $output->getErrorOutput();
}
if (!$input->isInteractive()) {
return $this->getDefaultAnswer($question);
}
if ($input instanceof StreamableInputInterface && ($stream = $input->getStream())) {
$this->inputStream = $stream;
}
try {
if (!$question->getValidator()) {
return $this->doAsk($output, $question);
}
$interviewer = function () use($output, $question) {
return $this->doAsk($output, $question);
};
return $this->validateAttempts($interviewer, $output, $question);
} catch (MissingInputException $exception) {
$input->setInteractive(\false);
if (null === ($fallbackOutput = $this->getDefaultAnswer($question))) {
throw $exception;
}
return $fallbackOutput;
}
}
/**
* {@inheritdoc}
*/
public function getName()
{
return 'question';
}
/**
* Prevents usage of stty.
*/
public static function disableStty()
{
self::$stty = \false;
}
/**
* Asks the question to the user.
*
* @return mixed
*
* @throws RuntimeException In case the fallback is deactivated and the response cannot be hidden
*/
private function doAsk(OutputInterface $output, Question $question)
{
$this->writePrompt($output, $question);
$inputStream = $this->inputStream ?: \STDIN;
$autocomplete = $question->getAutocompleterCallback();
if (null === $autocomplete || !self::$stty || !Terminal::hasSttyAvailable()) {
$ret = \false;
if ($question->isHidden()) {
try {
$hiddenResponse = $this->getHiddenResponse($output, $inputStream, $question->isTrimmable());
$ret = $question->isTrimmable() ? \trim($hiddenResponse) : $hiddenResponse;
} catch (RuntimeException $e) {
if (!$question->isHiddenFallback()) {
throw $e;
}
}
}
if (\false === $ret) {
$isBlocked = \stream_get_meta_data($inputStream)['blocked'] ?? \true;
if (!$isBlocked) {
\stream_set_blocking($inputStream, \true);
}
$ret = $this->readInput($inputStream, $question);
if (!$isBlocked) {
\stream_set_blocking($inputStream, \false);
}
if (\false === $ret) {
throw new MissingInputException('Aborted.');
}
if ($question->isTrimmable()) {
$ret = \trim($ret);
}
}
} else {
$autocomplete = $this->autocomplete($output, $question, $inputStream, $autocomplete);
$ret = $question->isTrimmable() ? \trim($autocomplete) : $autocomplete;
}
if ($output instanceof ConsoleSectionOutput) {
$output->addContent($ret);
}
$ret = \strlen($ret) > 0 ? $ret : $question->getDefault();
if ($normalizer = $question->getNormalizer()) {
return $normalizer($ret);
}
return $ret;
}
/**
* @return mixed
*/
private function getDefaultAnswer(Question $question)
{
$default = $question->getDefault();
if (null === $default) {
return $default;
}
if ($validator = $question->getValidator()) {
return \call_user_func($question->getValidator(), $default);
} elseif ($question instanceof ChoiceQuestion) {
$choices = $question->getChoices();
if (!$question->isMultiselect()) {
return $choices[$default] ?? $default;
}
$default = \explode(',', $default);
foreach ($default as $k => $v) {
$v = $question->isTrimmable() ? \trim($v) : $v;
$default[$k] = $choices[$v] ?? $v;
}
}
return $default;
}
/**
* Outputs the question prompt.
*/
protected function writePrompt(OutputInterface $output, Question $question)
{
$message = $question->getQuestion();
if ($question instanceof ChoiceQuestion) {
$output->writeln(\array_merge([$question->getQuestion()], $this->formatChoiceQuestionChoices($question, 'info')));
$message = $question->getPrompt();
}
$output->write($message);
}
/**
* @return string[]
*/
protected function formatChoiceQuestionChoices(ChoiceQuestion $question, string $tag)
{
$messages = [];
$maxWidth = \max(\array_map([__CLASS__, 'width'], \array_keys($choices = $question->getChoices())));
foreach ($choices as $key => $value) {
$padding = \str_repeat(' ', $maxWidth - self::width($key));
$messages[] = \sprintf(" [<{$tag}>%s{$padding}</{$tag}>] %s", $key, $value);
}
return $messages;
}
/**
* Outputs an error message.
*/
protected function writeError(OutputInterface $output, \Exception $error)
{
if (null !== $this->getHelperSet() && $this->getHelperSet()->has('formatter')) {
$message = $this->getHelperSet()->get('formatter')->formatBlock($error->getMessage(), 'error');
} else {
$message = '<error>' . $error->getMessage() . '</error>';
}
$output->writeln($message);
}
/**
* Autocompletes a question.
*
* @param resource $inputStream
*/
private function autocomplete(OutputInterface $output, Question $question, $inputStream, callable $autocomplete) : string
{
$cursor = new Cursor($output, $inputStream);
$fullChoice = '';
$ret = '';
$i = 0;
$ofs = -1;
$matches = $autocomplete($ret);
$numMatches = \count($matches);
$sttyMode = \shell_exec('stty -g');
$isStdin = 'php://stdin' === (\stream_get_meta_data($inputStream)['uri'] ?? null);
$r = [$inputStream];
$w = [];
// Disable icanon (so we can fread each keypress) and echo (we'll do echoing here instead)
\shell_exec('stty -icanon -echo');
// Add highlighted text style
$output->getFormatter()->setStyle('hl', new OutputFormatterStyle('black', 'white'));
// Read a keypress
while (!\feof($inputStream)) {
while ($isStdin && 0 === @\stream_select($r, $w, $w, 0, 100)) {
// Give signal handlers a chance to run
$r = [$inputStream];
}
$c = \fread($inputStream, 1);
// as opposed to fgets(), fread() returns an empty string when the stream content is empty, not false.
if (\false === $c || '' === $ret && '' === $c && null === $question->getDefault()) {
\shell_exec('stty ' . $sttyMode);
throw new MissingInputException('Aborted.');
} elseif ("" === $c) {
// Backspace Character
if (0 === $numMatches && 0 !== $i) {
--$i;
$cursor->moveLeft(s($fullChoice)->slice(-1)->width(\false));
$fullChoice = self::substr($fullChoice, 0, $i);
}
if (0 === $i) {
$ofs = -1;
$matches = $autocomplete($ret);
$numMatches = \count($matches);
} else {
$numMatches = 0;
}
// Pop the last character off the end of our string
$ret = self::substr($ret, 0, $i);
} elseif ("\x1b" === $c) {
// Did we read an escape sequence?
$c .= \fread($inputStream, 2);
// A = Up Arrow. B = Down Arrow
if (isset($c[2]) && ('A' === $c[2] || 'B' === $c[2])) {
if ('A' === $c[2] && -1 === $ofs) {
$ofs = 0;
}
if (0 === $numMatches) {
continue;
}
$ofs += 'A' === $c[2] ? -1 : 1;
$ofs = ($numMatches + $ofs) % $numMatches;
}
} elseif (\ord($c) < 32) {
if ("\t" === $c || "\n" === $c) {
if ($numMatches > 0 && -1 !== $ofs) {
$ret = (string) $matches[$ofs];
// Echo out remaining chars for current match
$remainingCharacters = \substr($ret, \strlen(\trim($this->mostRecentlyEnteredValue($fullChoice))));
$output->write($remainingCharacters);
$fullChoice .= $remainingCharacters;
$i = \false === ($encoding = \mb_detect_encoding($fullChoice, null, \true)) ? \strlen($fullChoice) : \mb_strlen($fullChoice, $encoding);
$matches = \array_filter($autocomplete($ret), function ($match) use($ret) {
return '' === $ret || \str_starts_with($match, $ret);
});
$numMatches = \count($matches);
$ofs = -1;
}
if ("\n" === $c) {
$output->write($c);
break;
}
$numMatches = 0;
}
continue;
} else {
if ("\x80" <= $c) {
$c .= \fread($inputStream, ["\xc0" => 1, "\xd0" => 1, "\xe0" => 2, "\xf0" => 3][$c & "\xf0"]);
}
$output->write($c);
$ret .= $c;
$fullChoice .= $c;
++$i;
$tempRet = $ret;
if ($question instanceof ChoiceQuestion && $question->isMultiselect()) {
$tempRet = $this->mostRecentlyEnteredValue($fullChoice);
}
$numMatches = 0;
$ofs = 0;
foreach ($autocomplete($ret) as $value) {
// If typed characters match the beginning chunk of value (e.g. [AcmeDe]moBundle)
if (\str_starts_with($value, $tempRet)) {
$matches[$numMatches++] = $value;
}
}
}
$cursor->clearLineAfter();
if ($numMatches > 0 && -1 !== $ofs) {
$cursor->savePosition();
// Write highlighted text, complete the partially entered response
$charactersEntered = \strlen(\trim($this->mostRecentlyEnteredValue($fullChoice)));
$output->write('<hl>' . OutputFormatter::escapeTrailingBackslash(\substr($matches[$ofs], $charactersEntered)) . '</hl>');
$cursor->restorePosition();
}
}
// Reset stty so it behaves normally again
\shell_exec('stty ' . $sttyMode);
return $fullChoice;
}
private function mostRecentlyEnteredValue(string $entered) : string
{
// Determine the most recent value that the user entered
if (!\str_contains($entered, ',')) {
return $entered;
}
$choices = \explode(',', $entered);
if ('' !== ($lastChoice = \trim($choices[\count($choices) - 1]))) {
return $lastChoice;
}
return $entered;
}
/**
* Gets a hidden response from user.
*
* @param resource $inputStream The handler resource
* @param bool $trimmable Is the answer trimmable
*
* @throws RuntimeException In case the fallback is deactivated and the response cannot be hidden
*/
private function getHiddenResponse(OutputInterface $output, $inputStream, bool $trimmable = \true) : string
{
if ('\\' === \DIRECTORY_SEPARATOR) {
$exe = __DIR__ . '/../Resources/bin/hiddeninput.exe';
// handle code running from a phar
if ('phar:' === \substr(__FILE__, 0, 5)) {
$tmpExe = \sys_get_temp_dir() . '/hiddeninput.exe';
\copy($exe, $tmpExe);
$exe = $tmpExe;
}
$sExec = \shell_exec('"' . $exe . '"');
$value = $trimmable ? \rtrim($sExec) : $sExec;
$output->writeln('');
if (isset($tmpExe)) {
\unlink($tmpExe);
}
return $value;
}
if (self::$stty && Terminal::hasSttyAvailable()) {
$sttyMode = \shell_exec('stty -g');
\shell_exec('stty -echo');
} elseif ($this->isInteractiveInput($inputStream)) {
throw new RuntimeException('Unable to hide the response.');
}
$value = \fgets($inputStream, 4096);
if (self::$stty && Terminal::hasSttyAvailable()) {
\shell_exec('stty ' . $sttyMode);
}
if (\false === $value) {
throw new MissingInputException('Aborted.');
}
if ($trimmable) {
$value = \trim($value);
}
$output->writeln('');
return $value;
}
/**
* Validates an attempt.
*
* @param callable $interviewer A callable that will ask for a question and return the result
*
* @return mixed The validated response
*
* @throws \Exception In case the max number of attempts has been reached and no valid response has been given
*/
private function validateAttempts(callable $interviewer, OutputInterface $output, Question $question)
{
$error = null;
$attempts = $question->getMaxAttempts();
while (null === $attempts || $attempts--) {
if (null !== $error) {
$this->writeError($output, $error);
}
try {
return $question->getValidator()($interviewer());
} catch (RuntimeException $e) {
throw $e;
} catch (\Exception $error) {
}
}
throw $error;
}
private function isInteractiveInput($inputStream) : bool
{
if ('php://stdin' !== (\stream_get_meta_data($inputStream)['uri'] ?? null)) {
return \false;
}
if (null !== self::$stdinIsInteractive) {
return self::$stdinIsInteractive;
}
return self::$stdinIsInteractive = @\stream_isatty(\fopen('php://stdin', 'r'));
}
/**
* Reads one or more lines of input and returns what is read.
*
* @param resource $inputStream The handler resource
* @param Question $question The question being asked
*
* @return string|false The input received, false in case input could not be read
*/
private function readInput($inputStream, Question $question)
{
if (!$question->isMultiline()) {
$cp = $this->setIOCodepage();
$ret = \fgets($inputStream, 4096);
return $this->resetIOCodepage($cp, $ret);
}
$multiLineStreamReader = $this->cloneInputStream($inputStream);
if (null === $multiLineStreamReader) {
return \false;
}
$ret = '';
$cp = $this->setIOCodepage();
while (\false !== ($char = \fgetc($multiLineStreamReader))) {
if (\PHP_EOL === "{$ret}{$char}") {
break;
}
$ret .= $char;
}
return $this->resetIOCodepage($cp, $ret);
}
/**
* Sets console I/O to the host code page.
*
* @return int Previous code page in IBM/EBCDIC format
*/
private function setIOCodepage() : int
{
if (\function_exists('sapi_windows_cp_set')) {
$cp = \sapi_windows_cp_get();
\sapi_windows_cp_set(\sapi_windows_cp_get('oem'));
return $cp;
}
return 0;
}
/**
* Sets console I/O to the specified code page and converts the user input.
*
* @param string|false $input
*
* @return string|false
*/
private function resetIOCodepage(int $cp, $input)
{
if (0 !== $cp) {
\sapi_windows_cp_set($cp);
if (\false !== $input && '' !== $input) {
$input = \sapi_windows_cp_conv(\sapi_windows_cp_get('oem'), $cp, $input);
}
}
return $input;
}
/**
* Clones an input stream in order to act on one instance of the same
* stream without affecting the other instance.
*
* @param resource $inputStream The handler resource
*
* @return resource|null The cloned resource, null in case it could not be cloned
*/
private function cloneInputStream($inputStream)
{
$streamMetaData = \stream_get_meta_data($inputStream);
$seekable = $streamMetaData['seekable'] ?? \false;
$mode = $streamMetaData['mode'] ?? 'rb';
$uri = $streamMetaData['uri'] ?? null;
if (null === $uri) {
return null;
}
$cloneStream = \fopen($uri, $mode);
// For seekable and writable streams, add all the same data to the
// cloned stream and then seek to the same offset.
if (\true === $seekable && !\in_array($mode, ['r', 'rb', 'rt'])) {
$offset = \ftell($inputStream);
\rewind($inputStream);
\stream_copy_to_stream($inputStream, $cloneStream);
\fseek($inputStream, $offset);
\fseek($cloneStream, $offset);
}
return $cloneStream;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
/**
* @author Yewhen Khoptynskyi <khoptynskyi@gmail.com>
*/
class TableCellStyle
{
public const DEFAULT_ALIGN = 'left';
private const TAG_OPTIONS = ['fg', 'bg', 'options'];
private const ALIGN_MAP = ['left' => \STR_PAD_RIGHT, 'center' => \STR_PAD_BOTH, 'right' => \STR_PAD_LEFT];
private $options = ['fg' => 'default', 'bg' => 'default', 'options' => null, 'align' => self::DEFAULT_ALIGN, 'cellFormat' => null];
public function __construct(array $options = [])
{
if ($diff = \array_diff(\array_keys($options), \array_keys($this->options))) {
throw new InvalidArgumentException(\sprintf('The TableCellStyle does not support the following options: \'%s\'.', \implode('\', \'', $diff)));
}
if (isset($options['align']) && !\array_key_exists($options['align'], self::ALIGN_MAP)) {
throw new InvalidArgumentException(\sprintf('Wrong align value. Value must be following: \'%s\'.', \implode('\', \'', \array_keys(self::ALIGN_MAP))));
}
$this->options = \array_merge($this->options, $options);
}
public function getOptions() : array
{
return $this->options;
}
/**
* Gets options we need for tag for example fg, bg.
*
* @return string[]
*/
public function getTagOptions()
{
return \array_filter($this->getOptions(), function ($key) {
return \in_array($key, self::TAG_OPTIONS) && isset($this->options[$key]);
}, \ARRAY_FILTER_USE_KEY);
}
/**
* @return int
*/
public function getPadByAlign()
{
return self::ALIGN_MAP[$this->getOptions()['align']];
}
public function getCellFormat() : ?string
{
return $this->getOptions()['cellFormat'];
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
/**
* @author Abdellatif Ait boudad <a.aitboudad@gmail.com>
*/
class TableCell
{
private $value;
private $options = ['rowspan' => 1, 'colspan' => 1, 'style' => null];
public function __construct(string $value = '', array $options = [])
{
$this->value = $value;
// check option names
if ($diff = \array_diff(\array_keys($options), \array_keys($this->options))) {
throw new InvalidArgumentException(\sprintf('The TableCell does not support the following options: \'%s\'.', \implode('\', \'', $diff)));
}
if (isset($options['style']) && !$options['style'] instanceof TableCellStyle) {
throw new InvalidArgumentException('The style option must be an instance of "TableCellStyle".');
}
$this->options = \array_merge($this->options, $options);
}
/**
* Returns the cell value.
*
* @return string
*/
public function __toString()
{
return $this->value;
}
/**
* Gets number of colspan.
*
* @return int
*/
public function getColspan()
{
return (int) $this->options['colspan'];
}
/**
* Gets number of rowspan.
*
* @return int
*/
public function getRowspan()
{
return (int) $this->options['rowspan'];
}
public function getStyle() : ?TableCellStyle
{
return $this->options['style'];
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\LogicException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* @author Kevin Bond <kevinbond@gmail.com>
*/
class ProgressIndicator
{
private const FORMATS = ['normal' => ' %indicator% %message%', 'normal_no_ansi' => ' %message%', 'verbose' => ' %indicator% %message% (%elapsed:6s%)', 'verbose_no_ansi' => ' %message% (%elapsed:6s%)', 'very_verbose' => ' %indicator% %message% (%elapsed:6s%, %memory:6s%)', 'very_verbose_no_ansi' => ' %message% (%elapsed:6s%, %memory:6s%)'];
private $output;
private $startTime;
private $format;
private $message;
private $indicatorValues;
private $indicatorCurrent;
private $indicatorChangeInterval;
private $indicatorUpdateTime;
private $started = \false;
/**
* @var array<string, callable>
*/
private static $formatters;
/**
* @param int $indicatorChangeInterval Change interval in milliseconds
* @param array|null $indicatorValues Animated indicator characters
*/
public function __construct(OutputInterface $output, ?string $format = null, int $indicatorChangeInterval = 100, ?array $indicatorValues = null)
{
$this->output = $output;
if (null === $format) {
$format = $this->determineBestFormat();
}
if (null === $indicatorValues) {
$indicatorValues = ['-', '\\', '|', '/'];
}
$indicatorValues = \array_values($indicatorValues);
if (2 > \count($indicatorValues)) {
throw new InvalidArgumentException('Must have at least 2 indicator value characters.');
}
$this->format = self::getFormatDefinition($format);
$this->indicatorChangeInterval = $indicatorChangeInterval;
$this->indicatorValues = $indicatorValues;
$this->startTime = \time();
}
/**
* Sets the current indicator message.
*/
public function setMessage(?string $message)
{
$this->message = $message;
$this->display();
}
/**
* Starts the indicator output.
*/
public function start(string $message)
{
if ($this->started) {
throw new LogicException('Progress indicator already started.');
}
$this->message = $message;
$this->started = \true;
$this->startTime = \time();
$this->indicatorUpdateTime = $this->getCurrentTimeInMilliseconds() + $this->indicatorChangeInterval;
$this->indicatorCurrent = 0;
$this->display();
}
/**
* Advances the indicator.
*/
public function advance()
{
if (!$this->started) {
throw new LogicException('Progress indicator has not yet been started.');
}
if (!$this->output->isDecorated()) {
return;
}
$currentTime = $this->getCurrentTimeInMilliseconds();
if ($currentTime < $this->indicatorUpdateTime) {
return;
}
$this->indicatorUpdateTime = $currentTime + $this->indicatorChangeInterval;
++$this->indicatorCurrent;
$this->display();
}
/**
* Finish the indicator with message.
*/
public function finish(string $message)
{
if (!$this->started) {
throw new LogicException('Progress indicator has not yet been started.');
}
$this->message = $message;
$this->display();
$this->output->writeln('');
$this->started = \false;
}
/**
* Gets the format for a given name.
*
* @return string|null
*/
public static function getFormatDefinition(string $name)
{
return self::FORMATS[$name] ?? null;
}
/**
* Sets a placeholder formatter for a given name.
*
* This method also allow you to override an existing placeholder.
*/
public static function setPlaceholderFormatterDefinition(string $name, callable $callable)
{
if (!self::$formatters) {
self::$formatters = self::initPlaceholderFormatters();
}
self::$formatters[$name] = $callable;
}
/**
* Gets the placeholder formatter for a given name (including the delimiter char like %).
*
* @return callable|null
*/
public static function getPlaceholderFormatterDefinition(string $name)
{
if (!self::$formatters) {
self::$formatters = self::initPlaceholderFormatters();
}
return self::$formatters[$name] ?? null;
}
private function display()
{
if (OutputInterface::VERBOSITY_QUIET === $this->output->getVerbosity()) {
return;
}
$this->overwrite(\preg_replace_callback("{%([a-z\\-_]+)(?:\\:([^%]+))?%}i", function ($matches) {
if ($formatter = self::getPlaceholderFormatterDefinition($matches[1])) {
return $formatter($this);
}
return $matches[0];
}, $this->format ?? ''));
}
private function determineBestFormat() : string
{
switch ($this->output->getVerbosity()) {
// OutputInterface::VERBOSITY_QUIET: display is disabled anyway
case OutputInterface::VERBOSITY_VERBOSE:
return $this->output->isDecorated() ? 'verbose' : 'verbose_no_ansi';
case OutputInterface::VERBOSITY_VERY_VERBOSE:
case OutputInterface::VERBOSITY_DEBUG:
return $this->output->isDecorated() ? 'very_verbose' : 'very_verbose_no_ansi';
default:
return $this->output->isDecorated() ? 'normal' : 'normal_no_ansi';
}
}
/**
* Overwrites a previous message to the output.
*/
private function overwrite(string $message)
{
if ($this->output->isDecorated()) {
$this->output->write("\r\x1b[2K");
$this->output->write($message);
} else {
$this->output->writeln($message);
}
}
private function getCurrentTimeInMilliseconds() : float
{
return \round(\microtime(\true) * 1000);
}
private static function initPlaceholderFormatters() : array
{
return ['indicator' => function (self $indicator) {
return $indicator->indicatorValues[$indicator->indicatorCurrent % \count($indicator->indicatorValues)];
}, 'message' => function (self $indicator) {
return $indicator->message;
}, 'elapsed' => function (self $indicator) {
return Helper::formatTime(\time() - $indicator->startTime);
}, 'memory' => function () {
return Helper::formatMemory(\memory_get_usage(\true));
}];
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\RuntimeException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\OutputFormatter;
use _PHPStan_6dcda722c\Symfony\Component\Console\Formatter\WrappableOutputFormatterInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\ConsoleSectionOutput;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* Provides helpers to display a table.
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Саша Стаменковић <umpirsky@gmail.com>
* @author Abdellatif Ait boudad <a.aitboudad@gmail.com>
* @author Max Grigorian <maxakawizard@gmail.com>
* @author Dany Maillard <danymaillard93b@gmail.com>
*/
class Table
{
private const SEPARATOR_TOP = 0;
private const SEPARATOR_TOP_BOTTOM = 1;
private const SEPARATOR_MID = 2;
private const SEPARATOR_BOTTOM = 3;
private const BORDER_OUTSIDE = 0;
private const BORDER_INSIDE = 1;
private $headerTitle;
private $footerTitle;
/**
* Table headers.
*/
private $headers = [];
/**
* Table rows.
*/
private $rows = [];
private $horizontal = \false;
/**
* Column widths cache.
*/
private $effectiveColumnWidths = [];
/**
* Number of columns cache.
*
* @var int
*/
private $numberOfColumns;
/**
* @var OutputInterface
*/
private $output;
/**
* @var TableStyle
*/
private $style;
/**
* @var array
*/
private $columnStyles = [];
/**
* User set column widths.
*
* @var array
*/
private $columnWidths = [];
private $columnMaxWidths = [];
/**
* @var array<string, TableStyle>|null
*/
private static $styles;
private $rendered = \false;
public function __construct(OutputInterface $output)
{
$this->output = $output;
if (!self::$styles) {
self::$styles = self::initStyles();
}
$this->setStyle('default');
}
/**
* Sets a style definition.
*/
public static function setStyleDefinition(string $name, TableStyle $style)
{
if (!self::$styles) {
self::$styles = self::initStyles();
}
self::$styles[$name] = $style;
}
/**
* Gets a style definition by name.
*
* @return TableStyle
*/
public static function getStyleDefinition(string $name)
{
if (!self::$styles) {
self::$styles = self::initStyles();
}
if (isset(self::$styles[$name])) {
return self::$styles[$name];
}
throw new InvalidArgumentException(\sprintf('Style "%s" is not defined.', $name));
}
/**
* Sets table style.
*
* @param TableStyle|string $name The style name or a TableStyle instance
*
* @return $this
*/
public function setStyle($name)
{
$this->style = $this->resolveStyle($name);
return $this;
}
/**
* Gets the current table style.
*
* @return TableStyle
*/
public function getStyle()
{
return $this->style;
}
/**
* Sets table column style.
*
* @param TableStyle|string $name The style name or a TableStyle instance
*
* @return $this
*/
public function setColumnStyle(int $columnIndex, $name)
{
$this->columnStyles[$columnIndex] = $this->resolveStyle($name);
return $this;
}
/**
* Gets the current style for a column.
*
* If style was not set, it returns the global table style.
*
* @return TableStyle
*/
public function getColumnStyle(int $columnIndex)
{
return $this->columnStyles[$columnIndex] ?? $this->getStyle();
}
/**
* Sets the minimum width of a column.
*
* @return $this
*/
public function setColumnWidth(int $columnIndex, int $width)
{
$this->columnWidths[$columnIndex] = $width;
return $this;
}
/**
* Sets the minimum width of all columns.
*
* @return $this
*/
public function setColumnWidths(array $widths)
{
$this->columnWidths = [];
foreach ($widths as $index => $width) {
$this->setColumnWidth($index, $width);
}
return $this;
}
/**
* Sets the maximum width of a column.
*
* Any cell within this column which contents exceeds the specified width will be wrapped into multiple lines, while
* formatted strings are preserved.
*
* @return $this
*/
public function setColumnMaxWidth(int $columnIndex, int $width) : self
{
if (!$this->output->getFormatter() instanceof WrappableOutputFormatterInterface) {
throw new \LogicException(\sprintf('Setting a maximum column width is only supported when using a "%s" formatter, got "%s".', WrappableOutputFormatterInterface::class, \get_debug_type($this->output->getFormatter())));
}
$this->columnMaxWidths[$columnIndex] = $width;
return $this;
}
/**
* @return $this
*/
public function setHeaders(array $headers)
{
$headers = \array_values($headers);
if (!empty($headers) && !\is_array($headers[0])) {
$headers = [$headers];
}
$this->headers = $headers;
return $this;
}
public function setRows(array $rows)
{
$this->rows = [];
return $this->addRows($rows);
}
/**
* @return $this
*/
public function addRows(array $rows)
{
foreach ($rows as $row) {
$this->addRow($row);
}
return $this;
}
/**
* @return $this
*/
public function addRow($row)
{
if ($row instanceof TableSeparator) {
$this->rows[] = $row;
return $this;
}
if (!\is_array($row)) {
throw new InvalidArgumentException('A row must be an array or a TableSeparator instance.');
}
$this->rows[] = \array_values($row);
return $this;
}
/**
* Adds a row to the table, and re-renders the table.
*
* @return $this
*/
public function appendRow($row) : self
{
if (!$this->output instanceof ConsoleSectionOutput) {
throw new RuntimeException(\sprintf('Output should be an instance of "%s" when calling "%s".', ConsoleSectionOutput::class, __METHOD__));
}
if ($this->rendered) {
$this->output->clear($this->calculateRowCount());
}
$this->addRow($row);
$this->render();
return $this;
}
/**
* @return $this
*/
public function setRow($column, array $row)
{
$this->rows[$column] = $row;
return $this;
}
/**
* @return $this
*/
public function setHeaderTitle(?string $title) : self
{
$this->headerTitle = $title;
return $this;
}
/**
* @return $this
*/
public function setFooterTitle(?string $title) : self
{
$this->footerTitle = $title;
return $this;
}
/**
* @return $this
*/
public function setHorizontal(bool $horizontal = \true) : self
{
$this->horizontal = $horizontal;
return $this;
}
/**
* Renders table to output.
*
* Example:
*
* +---------------+-----------------------+------------------+
* | ISBN | Title | Author |
* +---------------+-----------------------+------------------+
* | 99921-58-10-7 | Divine Comedy | Dante Alighieri |
* | 9971-5-0210-0 | A Tale of Two Cities | Charles Dickens |
* | 960-425-059-0 | The Lord of the Rings | J. R. R. Tolkien |
* +---------------+-----------------------+------------------+
*/
public function render()
{
$divider = new TableSeparator();
if ($this->horizontal) {
$rows = [];
foreach ($this->headers[0] ?? [] as $i => $header) {
$rows[$i] = [$header];
foreach ($this->rows as $row) {
if ($row instanceof TableSeparator) {
continue;
}
if (isset($row[$i])) {
$rows[$i][] = $row[$i];
} elseif ($rows[$i][0] instanceof TableCell && $rows[$i][0]->getColspan() >= 2) {
// Noop, there is a "title"
} else {
$rows[$i][] = null;
}
}
}
} else {
$rows = \array_merge($this->headers, [$divider], $this->rows);
}
$this->calculateNumberOfColumns($rows);
$rowGroups = $this->buildTableRows($rows);
$this->calculateColumnsWidth($rowGroups);
$isHeader = !$this->horizontal;
$isFirstRow = $this->horizontal;
$hasTitle = (bool) $this->headerTitle;
foreach ($rowGroups as $rowGroup) {
$isHeaderSeparatorRendered = \false;
foreach ($rowGroup as $row) {
if ($divider === $row) {
$isHeader = \false;
$isFirstRow = \true;
continue;
}
if ($row instanceof TableSeparator) {
$this->renderRowSeparator();
continue;
}
if (!$row) {
continue;
}
if ($isHeader && !$isHeaderSeparatorRendered) {
$this->renderRowSeparator($isHeader ? self::SEPARATOR_TOP : self::SEPARATOR_TOP_BOTTOM, $hasTitle ? $this->headerTitle : null, $hasTitle ? $this->style->getHeaderTitleFormat() : null);
$hasTitle = \false;
$isHeaderSeparatorRendered = \true;
}
if ($isFirstRow) {
$this->renderRowSeparator($isHeader ? self::SEPARATOR_TOP : self::SEPARATOR_TOP_BOTTOM, $hasTitle ? $this->headerTitle : null, $hasTitle ? $this->style->getHeaderTitleFormat() : null);
$isFirstRow = \false;
$hasTitle = \false;
}
if ($this->horizontal) {
$this->renderRow($row, $this->style->getCellRowFormat(), $this->style->getCellHeaderFormat());
} else {
$this->renderRow($row, $isHeader ? $this->style->getCellHeaderFormat() : $this->style->getCellRowFormat());
}
}
}
$this->renderRowSeparator(self::SEPARATOR_BOTTOM, $this->footerTitle, $this->style->getFooterTitleFormat());
$this->cleanup();
$this->rendered = \true;
}
/**
* Renders horizontal header separator.
*
* Example:
*
* +-----+-----------+-------+
*/
private function renderRowSeparator(int $type = self::SEPARATOR_MID, ?string $title = null, ?string $titleFormat = null)
{
if (0 === ($count = $this->numberOfColumns)) {
return;
}
$borders = $this->style->getBorderChars();
if (!$borders[0] && !$borders[2] && !$this->style->getCrossingChar()) {
return;
}
$crossings = $this->style->getCrossingChars();
if (self::SEPARATOR_MID === $type) {
[$horizontal, $leftChar, $midChar, $rightChar] = [$borders[2], $crossings[8], $crossings[0], $crossings[4]];
} elseif (self::SEPARATOR_TOP === $type) {
[$horizontal, $leftChar, $midChar, $rightChar] = [$borders[0], $crossings[1], $crossings[2], $crossings[3]];
} elseif (self::SEPARATOR_TOP_BOTTOM === $type) {
[$horizontal, $leftChar, $midChar, $rightChar] = [$borders[0], $crossings[9], $crossings[10], $crossings[11]];
} else {
[$horizontal, $leftChar, $midChar, $rightChar] = [$borders[0], $crossings[7], $crossings[6], $crossings[5]];
}
$markup = $leftChar;
for ($column = 0; $column < $count; ++$column) {
$markup .= \str_repeat($horizontal, $this->effectiveColumnWidths[$column]);
$markup .= $column === $count - 1 ? $rightChar : $midChar;
}
if (null !== $title) {
$titleLength = Helper::width(Helper::removeDecoration($formatter = $this->output->getFormatter(), $formattedTitle = \sprintf($titleFormat, $title)));
$markupLength = Helper::width($markup);
if ($titleLength > ($limit = $markupLength - 4)) {
$titleLength = $limit;
$formatLength = Helper::width(Helper::removeDecoration($formatter, \sprintf($titleFormat, '')));
$formattedTitle = \sprintf($titleFormat, Helper::substr($title, 0, $limit - $formatLength - 3) . '...');
}
$titleStart = \intdiv($markupLength - $titleLength, 2);
if (\false === \mb_detect_encoding($markup, null, \true)) {
$markup = \substr_replace($markup, $formattedTitle, $titleStart, $titleLength);
} else {
$markup = \mb_substr($markup, 0, $titleStart) . $formattedTitle . \mb_substr($markup, $titleStart + $titleLength);
}
}
$this->output->writeln(\sprintf($this->style->getBorderFormat(), $markup));
}
/**
* Renders vertical column separator.
*/
private function renderColumnSeparator(int $type = self::BORDER_OUTSIDE) : string
{
$borders = $this->style->getBorderChars();
return \sprintf($this->style->getBorderFormat(), self::BORDER_OUTSIDE === $type ? $borders[1] : $borders[3]);
}
/**
* Renders table row.
*
* Example:
*
* | 9971-5-0210-0 | A Tale of Two Cities | Charles Dickens |
*/
private function renderRow(array $row, string $cellFormat, ?string $firstCellFormat = null)
{
$rowContent = $this->renderColumnSeparator(self::BORDER_OUTSIDE);
$columns = $this->getRowColumns($row);
$last = \count($columns) - 1;
foreach ($columns as $i => $column) {
if ($firstCellFormat && 0 === $i) {
$rowContent .= $this->renderCell($row, $column, $firstCellFormat);
} else {
$rowContent .= $this->renderCell($row, $column, $cellFormat);
}
$rowContent .= $this->renderColumnSeparator($last === $i ? self::BORDER_OUTSIDE : self::BORDER_INSIDE);
}
$this->output->writeln($rowContent);
}
/**
* Renders table cell with padding.
*/
private function renderCell(array $row, int $column, string $cellFormat) : string
{
$cell = $row[$column] ?? '';
$width = $this->effectiveColumnWidths[$column];
if ($cell instanceof TableCell && $cell->getColspan() > 1) {
// add the width of the following columns(numbers of colspan).
foreach (\range($column + 1, $column + $cell->getColspan() - 1) as $nextColumn) {
$width += $this->getColumnSeparatorWidth() + $this->effectiveColumnWidths[$nextColumn];
}
}
// str_pad won't work properly with multi-byte strings, we need to fix the padding
if (\false !== ($encoding = \mb_detect_encoding($cell, null, \true))) {
$width += \strlen($cell) - \mb_strwidth($cell, $encoding);
}
$style = $this->getColumnStyle($column);
if ($cell instanceof TableSeparator) {
return \sprintf($style->getBorderFormat(), \str_repeat($style->getBorderChars()[2], $width));
}
$width += Helper::length($cell) - Helper::length(Helper::removeDecoration($this->output->getFormatter(), $cell));
$content = \sprintf($style->getCellRowContentFormat(), $cell);
$padType = $style->getPadType();
if ($cell instanceof TableCell && $cell->getStyle() instanceof TableCellStyle) {
$isNotStyledByTag = !\preg_match('/^<(\\w+|(\\w+=[\\w,]+;?)*)>.+<\\/(\\w+|(\\w+=\\w+;?)*)?>$/', $cell);
if ($isNotStyledByTag) {
$cellFormat = $cell->getStyle()->getCellFormat();
if (!\is_string($cellFormat)) {
$tag = \http_build_query($cell->getStyle()->getTagOptions(), '', ';');
$cellFormat = '<' . $tag . '>%s</>';
}
if (\strstr($content, '</>')) {
$content = \str_replace('</>', '', $content);
$width -= 3;
}
if (\strstr($content, '<fg=default;bg=default>')) {
$content = \str_replace('<fg=default;bg=default>', '', $content);
$width -= \strlen('<fg=default;bg=default>');
}
}
$padType = $cell->getStyle()->getPadByAlign();
}
return \sprintf($cellFormat, \str_pad($content, $width, $style->getPaddingChar(), $padType));
}
/**
* Calculate number of columns for this table.
*/
private function calculateNumberOfColumns(array $rows)
{
$columns = [0];
foreach ($rows as $row) {
if ($row instanceof TableSeparator) {
continue;
}
$columns[] = $this->getNumberOfColumns($row);
}
$this->numberOfColumns = \max($columns);
}
private function buildTableRows(array $rows) : TableRows
{
/** @var WrappableOutputFormatterInterface $formatter */
$formatter = $this->output->getFormatter();
$unmergedRows = [];
for ($rowKey = 0; $rowKey < \count($rows); ++$rowKey) {
$rows = $this->fillNextRows($rows, $rowKey);
// Remove any new line breaks and replace it with a new line
foreach ($rows[$rowKey] as $column => $cell) {
$colspan = $cell instanceof TableCell ? $cell->getColspan() : 1;
if (isset($this->columnMaxWidths[$column]) && Helper::width(Helper::removeDecoration($formatter, $cell)) > $this->columnMaxWidths[$column]) {
$cell = $formatter->formatAndWrap($cell, $this->columnMaxWidths[$column] * $colspan);
}
if (!\strstr($cell ?? '', "\n")) {
continue;
}
$eol = \str_contains($cell ?? '', "\r\n") ? "\r\n" : "\n";
$escaped = \implode($eol, \array_map([OutputFormatter::class, 'escapeTrailingBackslash'], \explode($eol, $cell)));
$cell = $cell instanceof TableCell ? new TableCell($escaped, ['colspan' => $cell->getColspan()]) : $escaped;
$lines = \explode($eol, \str_replace($eol, '<fg=default;bg=default></>' . $eol, $cell));
foreach ($lines as $lineKey => $line) {
if ($colspan > 1) {
$line = new TableCell($line, ['colspan' => $colspan]);
}
if (0 === $lineKey) {
$rows[$rowKey][$column] = $line;
} else {
if (!\array_key_exists($rowKey, $unmergedRows) || !\array_key_exists($lineKey, $unmergedRows[$rowKey])) {
$unmergedRows[$rowKey][$lineKey] = $this->copyRow($rows, $rowKey);
}
$unmergedRows[$rowKey][$lineKey][$column] = $line;
}
}
}
}
return new TableRows(function () use($rows, $unmergedRows) : \Traversable {
foreach ($rows as $rowKey => $row) {
$rowGroup = [$row instanceof TableSeparator ? $row : $this->fillCells($row)];
if (isset($unmergedRows[$rowKey])) {
foreach ($unmergedRows[$rowKey] as $row) {
$rowGroup[] = $row instanceof TableSeparator ? $row : $this->fillCells($row);
}
}
(yield $rowGroup);
}
});
}
private function calculateRowCount() : int
{
$numberOfRows = \count(\iterator_to_array($this->buildTableRows(\array_merge($this->headers, [new TableSeparator()], $this->rows))));
if ($this->headers) {
++$numberOfRows;
// Add row for header separator
}
if (\count($this->rows) > 0) {
++$numberOfRows;
// Add row for footer separator
}
return $numberOfRows;
}
/**
* fill rows that contains rowspan > 1.
*
* @throws InvalidArgumentException
*/
private function fillNextRows(array $rows, int $line) : array
{
$unmergedRows = [];
foreach ($rows[$line] as $column => $cell) {
if (null !== $cell && !$cell instanceof TableCell && !\is_scalar($cell) && !(\is_object($cell) && \method_exists($cell, '__toString'))) {
throw new InvalidArgumentException(\sprintf('A cell must be a TableCell, a scalar or an object implementing "__toString()", "%s" given.', \get_debug_type($cell)));
}
if ($cell instanceof TableCell && $cell->getRowspan() > 1) {
$nbLines = $cell->getRowspan() - 1;
$lines = [$cell];
if (\strstr($cell, "\n")) {
$eol = \str_contains($cell, "\r\n") ? "\r\n" : "\n";
$lines = \explode($eol, \str_replace($eol, '<fg=default;bg=default>' . $eol . '</>', $cell));
$nbLines = \count($lines) > $nbLines ? \substr_count($cell, $eol) : $nbLines;
$rows[$line][$column] = new TableCell($lines[0], ['colspan' => $cell->getColspan(), 'style' => $cell->getStyle()]);
unset($lines[0]);
}
// create a two dimensional array (rowspan x colspan)
$unmergedRows = \array_replace_recursive(\array_fill($line + 1, $nbLines, []), $unmergedRows);
foreach ($unmergedRows as $unmergedRowKey => $unmergedRow) {
$value = $lines[$unmergedRowKey - $line] ?? '';
$unmergedRows[$unmergedRowKey][$column] = new TableCell($value, ['colspan' => $cell->getColspan(), 'style' => $cell->getStyle()]);
if ($nbLines === $unmergedRowKey - $line) {
break;
}
}
}
}
foreach ($unmergedRows as $unmergedRowKey => $unmergedRow) {
// we need to know if $unmergedRow will be merged or inserted into $rows
if (isset($rows[$unmergedRowKey]) && \is_array($rows[$unmergedRowKey]) && $this->getNumberOfColumns($rows[$unmergedRowKey]) + $this->getNumberOfColumns($unmergedRows[$unmergedRowKey]) <= $this->numberOfColumns) {
foreach ($unmergedRow as $cellKey => $cell) {
// insert cell into row at cellKey position
\array_splice($rows[$unmergedRowKey], $cellKey, 0, [$cell]);
}
} else {
$row = $this->copyRow($rows, $unmergedRowKey - 1);
foreach ($unmergedRow as $column => $cell) {
if (!empty($cell)) {
$row[$column] = $unmergedRow[$column];
}
}
\array_splice($rows, $unmergedRowKey, 0, [$row]);
}
}
return $rows;
}
/**
* fill cells for a row that contains colspan > 1.
*/
private function fillCells(iterable $row)
{
$newRow = [];
foreach ($row as $column => $cell) {
$newRow[] = $cell;
if ($cell instanceof TableCell && $cell->getColspan() > 1) {
foreach (\range($column + 1, $column + $cell->getColspan() - 1) as $position) {
// insert empty value at column position
$newRow[] = '';
}
}
}
return $newRow ?: $row;
}
private function copyRow(array $rows, int $line) : array
{
$row = $rows[$line];
foreach ($row as $cellKey => $cellValue) {
$row[$cellKey] = '';
if ($cellValue instanceof TableCell) {
$row[$cellKey] = new TableCell('', ['colspan' => $cellValue->getColspan()]);
}
}
return $row;
}
/**
* Gets number of columns by row.
*/
private function getNumberOfColumns(array $row) : int
{
$columns = \count($row);
foreach ($row as $column) {
$columns += $column instanceof TableCell ? $column->getColspan() - 1 : 0;
}
return $columns;
}
/**
* Gets list of columns for the given row.
*/
private function getRowColumns(array $row) : array
{
$columns = \range(0, $this->numberOfColumns - 1);
foreach ($row as $cellKey => $cell) {
if ($cell instanceof TableCell && $cell->getColspan() > 1) {
// exclude grouped columns.
$columns = \array_diff($columns, \range($cellKey + 1, $cellKey + $cell->getColspan() - 1));
}
}
return $columns;
}
/**
* Calculates columns widths.
*/
private function calculateColumnsWidth(iterable $groups)
{
for ($column = 0; $column < $this->numberOfColumns; ++$column) {
$lengths = [];
foreach ($groups as $group) {
foreach ($group as $row) {
if ($row instanceof TableSeparator) {
continue;
}
foreach ($row as $i => $cell) {
if ($cell instanceof TableCell) {
$textContent = Helper::removeDecoration($this->output->getFormatter(), $cell);
$textLength = Helper::width($textContent);
if ($textLength > 0) {
$contentColumns = \mb_str_split($textContent, \ceil($textLength / $cell->getColspan()));
foreach ($contentColumns as $position => $content) {
$row[$i + $position] = $content;
}
}
}
}
$lengths[] = $this->getCellWidth($row, $column);
}
}
$this->effectiveColumnWidths[$column] = \max($lengths) + Helper::width($this->style->getCellRowContentFormat()) - 2;
}
}
private function getColumnSeparatorWidth() : int
{
return Helper::width(\sprintf($this->style->getBorderFormat(), $this->style->getBorderChars()[3]));
}
private function getCellWidth(array $row, int $column) : int
{
$cellWidth = 0;
if (isset($row[$column])) {
$cell = $row[$column];
$cellWidth = Helper::width(Helper::removeDecoration($this->output->getFormatter(), $cell));
}
$columnWidth = $this->columnWidths[$column] ?? 0;
$cellWidth = \max($cellWidth, $columnWidth);
return isset($this->columnMaxWidths[$column]) ? \min($this->columnMaxWidths[$column], $cellWidth) : $cellWidth;
}
/**
* Called after rendering to cleanup cache data.
*/
private function cleanup()
{
$this->effectiveColumnWidths = [];
$this->numberOfColumns = null;
}
/**
* @return array<string, TableStyle>
*/
private static function initStyles() : array
{
$borderless = new TableStyle();
$borderless->setHorizontalBorderChars('=')->setVerticalBorderChars(' ')->setDefaultCrossingChar(' ');
$compact = new TableStyle();
$compact->setHorizontalBorderChars('')->setVerticalBorderChars('')->setDefaultCrossingChar('')->setCellRowContentFormat('%s ');
$styleGuide = new TableStyle();
$styleGuide->setHorizontalBorderChars('-')->setVerticalBorderChars(' ')->setDefaultCrossingChar(' ')->setCellHeaderFormat('%s');
$box = (new TableStyle())->setHorizontalBorderChars('─')->setVerticalBorderChars('│')->setCrossingChars('┼', '┌', '┬', '┐', '┤', '┘', '┴', '└', '├');
$boxDouble = (new TableStyle())->setHorizontalBorderChars('═', '─')->setVerticalBorderChars('║', '│')->setCrossingChars('┼', '╔', '╤', '╗', '╢', '╝', '╧', '╚', '╟', '╠', '╪', '╣');
return ['default' => new TableStyle(), 'borderless' => $borderless, 'compact' => $compact, 'symfony-style-guide' => $styleGuide, 'box' => $box, 'box-double' => $boxDouble];
}
private function resolveStyle($name) : TableStyle
{
if ($name instanceof TableStyle) {
return $name;
}
if (isset(self::$styles[$name])) {
return self::$styles[$name];
}
throw new InvalidArgumentException(\sprintf('Style "%s" is not defined.', $name));
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
use _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor\DescriptorInterface;
use _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor\JsonDescriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor\MarkdownDescriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor\TextDescriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Descriptor\XmlDescriptor;
use _PHPStan_6dcda722c\Symfony\Component\Console\Exception\InvalidArgumentException;
use _PHPStan_6dcda722c\Symfony\Component\Console\Output\OutputInterface;
/**
* This class adds helper method to describe objects in various formats.
*
* @author Jean-François Simon <contact@jfsimon.fr>
*/
class DescriptorHelper extends Helper
{
/**
* @var DescriptorInterface[]
*/
private $descriptors = [];
public function __construct()
{
$this->register('txt', new TextDescriptor())->register('xml', new XmlDescriptor())->register('json', new JsonDescriptor())->register('md', new MarkdownDescriptor());
}
/**
* Describes an object if supported.
*
* Available options are:
* * format: string, the output format name
* * raw_text: boolean, sets output type as raw
*
* @throws InvalidArgumentException when the given format is not supported
*/
public function describe(OutputInterface $output, ?object $object, array $options = [])
{
$options = \array_merge(['raw_text' => \false, 'format' => 'txt'], $options);
if (!isset($this->descriptors[$options['format']])) {
throw new InvalidArgumentException(\sprintf('Unsupported format "%s".', $options['format']));
}
$descriptor = $this->descriptors[$options['format']];
$descriptor->describe($output, $object, $options);
}
/**
* Registers a descriptor.
*
* @return $this
*/
public function register(string $format, DescriptorInterface $descriptor)
{
$this->descriptors[$format] = $descriptor;
return $this;
}
/**
* {@inheritdoc}
*/
public function getName()
{
return 'descriptor';
}
public function getFormats() : array
{
return \array_keys($this->descriptors);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Console\Helper;
/**
* HelperInterface is the interface all helpers must implement.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
interface HelperInterface
{
/**
* Sets the helper set associated with this helper.
*/
public function setHelperSet(?HelperSet $helperSet = null);
/**
* Gets the helper set associated with this helper.
*
* @return HelperSet|null
*/
public function getHelperSet();
/**
* Returns the canonical name of this helper.
*
* @return string
*/
public function getName();
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (\PHP_VERSION_ID < 80100) {
#[Attribute(Attribute::TARGET_METHOD)]
final class ReturnTypeWillChange
{
public function __construct()
{
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (\PHP_VERSION_ID >= 70400 && extension_loaded('curl')) {
/**
* @property string $data
*/
class CURLStringFile extends CURLFile
{
private $data;
public function __construct(string $data, string $postname, string $mime = 'application/octet-stream')
{
$this->data = $data;
parent::__construct('data://application/octet-stream;base64,'.base64_encode($data), $mime, $postname);
}
public function __set(string $name, $value): void
{
if ('data' !== $name) {
$this->$name = $value;
return;
}
if (is_object($value) ? !method_exists($value, '__toString') : !is_scalar($value)) {
throw new TypeError('Cannot assign '.gettype($value).' to property CURLStringFile::$data of type string');
}
$this->name = 'data://application/octet-stream;base64,'.base64_encode($value);
}
public function __isset(string $name): bool
{
return isset($this->$name);
}
public function &__get(string $name)
{
return $this->$name;
}
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use Symfony\Polyfill\Php81 as p;
if (\PHP_VERSION_ID >= 80100) {
return;
}
if (defined('MYSQLI_REFRESH_SLAVE') && !defined('MYSQLI_REFRESH_REPLICA')) {
define('MYSQLI_REFRESH_REPLICA', 64);
}
if (!function_exists('array_is_list')) {
function array_is_list(array $array): bool { return p\Php81::array_is_list($array); }
}
if (!function_exists('enum_exists')) {
function enum_exists(string $enum, bool $autoload = true): bool { return $autoload && class_exists($enum) && false; }
}
Copyright (c) 2021-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Polyfill\Php81;
/**
* @author Nicolas Grekas <p@tchwork.com>
*
* @internal
*/
final class Php81
{
public static function array_is_list(array $array): bool
{
if ([] === $array || $array === array_values($array)) {
return true;
}
$nextKey = -1;
foreach ($array as $k => $v) {
if ($k !== ++$nextKey) {
return false;
}
}
return true;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (\PHP_VERSION_ID < 80000) {
interface Stringable
{
/**
* @return string
*/
public function __toString();
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (\PHP_VERSION_ID < 80000 && extension_loaded('tokenizer')) {
class PhpToken extends Symfony\Polyfill\Php80\PhpToken
{
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class Attribute
{
public const TARGET_CLASS = 1;
public const TARGET_FUNCTION = 2;
public const TARGET_METHOD = 4;
public const TARGET_PROPERTY = 8;
public const TARGET_CLASS_CONSTANT = 16;
public const TARGET_PARAMETER = 32;
public const TARGET_ALL = 63;
public const IS_REPEATABLE = 64;
/** @var int */
public $flags;
public function __construct(int $flags = self::TARGET_ALL)
{
$this->flags = $flags;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (\PHP_VERSION_ID < 80000) {
class UnhandledMatchError extends Error
{
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (\PHP_VERSION_ID < 80000) {
class ValueError extends Error
{
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Polyfill\Php80;
/**
* @author Ion Bazan <ion.bazan@gmail.com>
* @author Nico Oelgart <nicoswd@gmail.com>
* @author Nicolas Grekas <p@tchwork.com>
*
* @internal
*/
final class Php80
{
public static function fdiv(float $dividend, float $divisor): float
{
return @($dividend / $divisor);
}
public static function get_debug_type($value): string
{
switch (true) {
case null === $value: return 'null';
case \is_bool($value): return 'bool';
case \is_string($value): return 'string';
case \is_array($value): return 'array';
case \is_int($value): return 'int';
case \is_float($value): return 'float';
case \is_object($value): break;
case $value instanceof \__PHP_Incomplete_Class: return '__PHP_Incomplete_Class';
default:
if (null === $type = @get_resource_type($value)) {
return 'unknown';
}
if ('Unknown' === $type) {
$type = 'closed';
}
return "resource ($type)";
}
$class = \get_class($value);
if (false === strpos($class, '@')) {
return $class;
}
return (get_parent_class($class) ?: key(class_implements($class)) ?: 'class').'@anonymous';
}
public static function get_resource_id($res): int
{
if (!\is_resource($res) && null === @get_resource_type($res)) {
throw new \TypeError(sprintf('Argument 1 passed to get_resource_id() must be of the type resource, %s given', get_debug_type($res)));
}
return (int) $res;
}
public static function preg_last_error_msg(): string
{
switch (preg_last_error()) {
case \PREG_INTERNAL_ERROR:
return 'Internal error';
case \PREG_BAD_UTF8_ERROR:
return 'Malformed UTF-8 characters, possibly incorrectly encoded';
case \PREG_BAD_UTF8_OFFSET_ERROR:
return 'The offset did not correspond to the beginning of a valid UTF-8 code point';
case \PREG_BACKTRACK_LIMIT_ERROR:
return 'Backtrack limit exhausted';
case \PREG_RECURSION_LIMIT_ERROR:
return 'Recursion limit exhausted';
case \PREG_JIT_STACKLIMIT_ERROR:
return 'JIT stack limit exhausted';
case \PREG_NO_ERROR:
return 'No error';
default:
return 'Unknown error';
}
}
public static function str_contains(string $haystack, string $needle): bool
{
return '' === $needle || false !== strpos($haystack, $needle);
}
public static function str_starts_with(string $haystack, string $needle): bool
{
return 0 === strncmp($haystack, $needle, \strlen($needle));
}
public static function str_ends_with(string $haystack, string $needle): bool
{
if ('' === $needle || $needle === $haystack) {
return true;
}
if ('' === $haystack) {
return false;
}
$needleLength = \strlen($needle);
return $needleLength <= \strlen($haystack) && 0 === substr_compare($haystack, $needle, -$needleLength);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Polyfill\Php80;
/**
* @author Fedonyuk Anton <info@ensostudio.ru>
*
* @internal
*/
class PhpToken implements \Stringable
{
/**
* @var int
*/
public $id;
/**
* @var string
*/
public $text;
/**
* @var int
*/
public $line;
/**
* @var int
*/
public $pos;
public function __construct(int $id, string $text, int $line = -1, int $position = -1)
{
$this->id = $id;
$this->text = $text;
$this->line = $line;
$this->pos = $position;
}
public function getTokenName(): ?string
{
if ('UNKNOWN' === $name = token_name($this->id)) {
$name = \strlen($this->text) > 1 || \ord($this->text) < 32 ? null : $this->text;
}
return $name;
}
/**
* @param int|string|array $kind
*/
public function is($kind): bool
{
foreach ((array) $kind as $value) {
if (\in_array($value, [$this->id, $this->text], true)) {
return true;
}
}
return false;
}
public function isIgnorable(): bool
{
return \in_array($this->id, [\T_WHITESPACE, \T_COMMENT, \T_DOC_COMMENT, \T_OPEN_TAG], true);
}
public function __toString(): string
{
return (string) $this->text;
}
/**
* @return static[]
*/
public static function tokenize(string $code, int $flags = 0): array
{
$line = 1;
$position = 0;
$tokens = token_get_all($code, $flags);
foreach ($tokens as $index => $token) {
if (\is_string($token)) {
$id = \ord($token);
$text = $token;
} else {
[$id, $text, $line] = $token;
}
$tokens[$index] = new static($id, $text, $line, $position);
$position += \strlen($text);
}
return $tokens;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use Symfony\Polyfill\Php80 as p;
if (\PHP_VERSION_ID >= 80000) {
return;
}
if (!defined('FILTER_VALIDATE_BOOL') && defined('FILTER_VALIDATE_BOOLEAN')) {
define('FILTER_VALIDATE_BOOL', \FILTER_VALIDATE_BOOLEAN);
}
if (!function_exists('fdiv')) {
function fdiv(float $num1, float $num2): float { return p\Php80::fdiv($num1, $num2); }
}
if (!function_exists('preg_last_error_msg')) {
function preg_last_error_msg(): string { return p\Php80::preg_last_error_msg(); }
}
if (!function_exists('str_contains')) {
function str_contains(?string $haystack, ?string $needle): bool { return p\Php80::str_contains($haystack ?? '', $needle ?? ''); }
}
if (!function_exists('str_starts_with')) {
function str_starts_with(?string $haystack, ?string $needle): bool { return p\Php80::str_starts_with($haystack ?? '', $needle ?? ''); }
}
if (!function_exists('str_ends_with')) {
function str_ends_with(?string $haystack, ?string $needle): bool { return p\Php80::str_ends_with($haystack ?? '', $needle ?? ''); }
}
if (!function_exists('get_debug_type')) {
function get_debug_type($value): string { return p\Php80::get_debug_type($value); }
}
if (!function_exists('get_resource_id')) {
function get_resource_id($resource): int { return p\Php80::get_resource_id($resource); }
}
Copyright (c) 2020-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
use Symfony\Polyfill\Php74 as p;
if (\PHP_VERSION_ID >= 70400) {
return;
}
if (!function_exists('get_mangled_object_vars')) {
function get_mangled_object_vars($object) { return p\Php74::get_mangled_object_vars($object); }
}
if (!function_exists('mb_str_split') && function_exists('mb_substr')) {
function mb_str_split($string, $length = 1, $encoding = null) { return p\Php74::mb_str_split($string, $length, $encoding); }
}
if (!function_exists('password_algos')) {
function password_algos() { return p\Php74::password_algos(); }
}
Copyright (c) 2019-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Polyfill\Php74;
/**
* @author Ion Bazan <ion.bazan@gmail.com>
*
* @internal
*/
final class Php74
{
public static function get_mangled_object_vars($obj)
{
if (!\is_object($obj)) {
trigger_error('get_mangled_object_vars() expects parameter 1 to be object, '.\gettype($obj).' given', \E_USER_WARNING);
return null;
}
if ($obj instanceof \ArrayIterator || $obj instanceof \ArrayObject) {
$reflector = new \ReflectionClass($obj instanceof \ArrayIterator ? 'ArrayIterator' : 'ArrayObject');
$flags = $reflector->getMethod('getFlags')->invoke($obj);
$reflector = $reflector->getMethod('setFlags');
$reflector->invoke($obj, ($flags & \ArrayObject::STD_PROP_LIST) ? 0 : \ArrayObject::STD_PROP_LIST);
$arr = (array) $obj;
$reflector->invoke($obj, $flags);
} else {
$arr = (array) $obj;
}
return array_combine(array_keys($arr), array_values($arr));
}
public static function mb_str_split($string, $split_length = 1, $encoding = null)
{
if (null !== $string && !\is_scalar($string) && !(\is_object($string) && method_exists($string, '__toString'))) {
trigger_error('mb_str_split() expects parameter 1 to be string, '.\gettype($string).' given', \E_USER_WARNING);
return null;
}
if (1 > $split_length = (int) $split_length) {
trigger_error('The length of each segment must be greater than zero', \E_USER_WARNING);
return false;
}
if (null === $encoding) {
$encoding = mb_internal_encoding();
}
if ('UTF-8' === $encoding || \in_array(strtoupper($encoding), ['UTF-8', 'UTF8'], true)) {
return preg_split("/(.{{$split_length}})/u", $string, -1, \PREG_SPLIT_DELIM_CAPTURE | \PREG_SPLIT_NO_EMPTY);
}
$result = [];
$length = mb_strlen($string, $encoding);
for ($i = 0; $i < $length; $i += $split_length) {
$result[] = mb_substr($string, $i, $split_length, $encoding);
}
return $result;
}
public static function password_algos()
{
$algos = [];
if (\defined('PASSWORD_BCRYPT')) {
$algos[] = \PASSWORD_BCRYPT;
}
if (\defined('PASSWORD_ARGON2I')) {
$algos[] = \PASSWORD_ARGON2I;
}
if (\defined('PASSWORD_ARGON2ID')) {
$algos[] = \PASSWORD_ARGON2ID;
}
return $algos;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
/**
* CustomFilterIterator filters files by applying anonymous functions.
*
* The anonymous function receives a \SplFileInfo and must return false
* to remove files.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @extends \FilterIterator<string, \SplFileInfo>
*/
class CustomFilterIterator extends \FilterIterator
{
private $filters = [];
/**
* @param \Iterator<string, \SplFileInfo> $iterator The Iterator to filter
* @param callable[] $filters An array of PHP callbacks
*
* @throws \InvalidArgumentException
*/
public function __construct(\Iterator $iterator, array $filters)
{
foreach ($filters as $filter) {
if (!\is_callable($filter)) {
throw new \InvalidArgumentException('Invalid PHP callback.');
}
}
$this->filters = $filters;
parent::__construct($iterator);
}
/**
* Filters the iterator values.
*
* @return bool
*/
#[\ReturnTypeWillChange]
public function accept()
{
$fileinfo = $this->current();
foreach ($this->filters as $filter) {
if (\false === $filter($fileinfo)) {
return \false;
}
}
return \true;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
/**
* @author Jérémy Derussé <jeremy@derusse.com>
*
* @internal
*/
class LazyIterator implements \IteratorAggregate
{
private $iteratorFactory;
public function __construct(callable $iteratorFactory)
{
$this->iteratorFactory = $iteratorFactory;
}
public function getIterator() : \Traversable
{
yield from ($this->iteratorFactory)();
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
/**
* FileTypeFilterIterator only keeps files, directories, or both.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @extends \FilterIterator<string, \SplFileInfo>
*/
class FileTypeFilterIterator extends \FilterIterator
{
public const ONLY_FILES = 1;
public const ONLY_DIRECTORIES = 2;
private $mode;
/**
* @param \Iterator $iterator The Iterator to filter
* @param int $mode The mode (self::ONLY_FILES or self::ONLY_DIRECTORIES)
*/
public function __construct(\Iterator $iterator, int $mode)
{
$this->mode = $mode;
parent::__construct($iterator);
}
/**
* Filters the iterator values.
*
* @return bool
*/
#[\ReturnTypeWillChange]
public function accept()
{
$fileinfo = $this->current();
if (self::ONLY_DIRECTORIES === (self::ONLY_DIRECTORIES & $this->mode) && $fileinfo->isFile()) {
return \false;
} elseif (self::ONLY_FILES === (self::ONLY_FILES & $this->mode) && $fileinfo->isDir()) {
return \false;
}
return \true;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
/**
* ExcludeDirectoryFilterIterator filters out directories.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @extends \FilterIterator<string, \SplFileInfo>
*
* @implements \RecursiveIterator<string, \SplFileInfo>
*/
class ExcludeDirectoryFilterIterator extends \FilterIterator implements \RecursiveIterator
{
private $iterator;
private $isRecursive;
private $excludedDirs = [];
private $excludedPattern;
/**
* @param \Iterator $iterator The Iterator to filter
* @param string[] $directories An array of directories to exclude
*/
public function __construct(\Iterator $iterator, array $directories)
{
$this->iterator = $iterator;
$this->isRecursive = $iterator instanceof \RecursiveIterator;
$patterns = [];
foreach ($directories as $directory) {
$directory = \rtrim($directory, '/');
if (!$this->isRecursive || \str_contains($directory, '/')) {
$patterns[] = \preg_quote($directory, '#');
} else {
$this->excludedDirs[$directory] = \true;
}
}
if ($patterns) {
$this->excludedPattern = '#(?:^|/)(?:' . \implode('|', $patterns) . ')(?:/|$)#';
}
parent::__construct($iterator);
}
/**
* Filters the iterator values.
*
* @return bool
*/
#[\ReturnTypeWillChange]
public function accept()
{
if ($this->isRecursive && isset($this->excludedDirs[$this->getFilename()]) && $this->isDir()) {
return \false;
}
if ($this->excludedPattern) {
$path = $this->isDir() ? $this->current()->getRelativePathname() : $this->current()->getRelativePath();
$path = \str_replace('\\', '/', $path);
return !\preg_match($this->excludedPattern, $path);
}
return \true;
}
/**
* @return bool
*/
#[\ReturnTypeWillChange]
public function hasChildren()
{
return $this->isRecursive && $this->iterator->hasChildren();
}
/**
* @return self
*/
#[\ReturnTypeWillChange]
public function getChildren()
{
$children = new self($this->iterator->getChildren(), []);
$children->excludedDirs = $this->excludedDirs;
$children->excludedPattern = $this->excludedPattern;
return $children;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Exception\AccessDeniedException;
use _PHPStan_6dcda722c\Symfony\Component\Finder\SplFileInfo;
/**
* Extends the \RecursiveDirectoryIterator to support relative paths.
*
* @author Victor Berchet <victor@suumit.com>
*/
class RecursiveDirectoryIterator extends \RecursiveDirectoryIterator
{
/**
* @var bool
*/
private $ignoreUnreadableDirs;
/**
* @var bool
*/
private $ignoreFirstRewind = \true;
// these 3 properties take part of the performance optimization to avoid redoing the same work in all iterations
private $rootPath;
private $subPath;
private $directorySeparator = '/';
/**
* @throws \RuntimeException
*/
public function __construct(string $path, int $flags, bool $ignoreUnreadableDirs = \false)
{
if ($flags & (self::CURRENT_AS_PATHNAME | self::CURRENT_AS_SELF)) {
throw new \RuntimeException('This iterator only support returning current as fileinfo.');
}
parent::__construct($path, $flags);
$this->ignoreUnreadableDirs = $ignoreUnreadableDirs;
$this->rootPath = $path;
if ('/' !== \DIRECTORY_SEPARATOR && !($flags & self::UNIX_PATHS)) {
$this->directorySeparator = \DIRECTORY_SEPARATOR;
}
}
/**
* Return an instance of SplFileInfo with support for relative paths.
*
* @return SplFileInfo
*/
#[\ReturnTypeWillChange]
public function current()
{
// the logic here avoids redoing the same work in all iterations
if (null === ($subPathname = $this->subPath)) {
$subPathname = $this->subPath = $this->getSubPath();
}
if ('' !== $subPathname) {
$subPathname .= $this->directorySeparator;
}
$subPathname .= $this->getFilename();
if ('/' !== ($basePath = $this->rootPath)) {
$basePath .= $this->directorySeparator;
}
return new SplFileInfo($basePath . $subPathname, $this->subPath, $subPathname);
}
/**
* @param bool $allowLinks
*
* @return bool
*/
#[\ReturnTypeWillChange]
public function hasChildren($allowLinks = \false)
{
$hasChildren = parent::hasChildren($allowLinks);
if (!$hasChildren || !$this->ignoreUnreadableDirs) {
return $hasChildren;
}
try {
parent::getChildren();
return \true;
} catch (\UnexpectedValueException $e) {
// If directory is unreadable and finder is set to ignore it, skip children
return \false;
}
}
/**
* @return \RecursiveDirectoryIterator
*
* @throws AccessDeniedException
*/
#[\ReturnTypeWillChange]
public function getChildren()
{
try {
$children = parent::getChildren();
if ($children instanceof self) {
// parent method will call the constructor with default arguments, so unreadable dirs won't be ignored anymore
$children->ignoreUnreadableDirs = $this->ignoreUnreadableDirs;
// performance optimization to avoid redoing the same work in all children
$children->rootPath = $this->rootPath;
}
return $children;
} catch (\UnexpectedValueException $e) {
throw new AccessDeniedException($e->getMessage(), $e->getCode(), $e);
}
}
/**
* @return void
*/
#[\ReturnTypeWillChange]
public function next()
{
$this->ignoreFirstRewind = \false;
parent::next();
}
/**
* @return void
*/
#[\ReturnTypeWillChange]
public function rewind()
{
// some streams like FTP are not rewindable, ignore the first rewind after creation,
// as newly created DirectoryIterator does not need to be rewound
if ($this->ignoreFirstRewind) {
$this->ignoreFirstRewind = \false;
return;
}
parent::rewind();
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Glob;
/**
* FilenameFilterIterator filters files by patterns (a regexp, a glob, or a string).
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @extends MultiplePcreFilterIterator<string, \SplFileInfo>
*/
class FilenameFilterIterator extends MultiplePcreFilterIterator
{
/**
* Filters the iterator values.
*
* @return bool
*/
#[\ReturnTypeWillChange]
public function accept()
{
return $this->isAccepted($this->current()->getFilename());
}
/**
* Converts glob to regexp.
*
* PCRE patterns are left unchanged.
* Glob strings are transformed with Glob::toRegex().
*
* @param string $str Pattern: glob or regexp
*
* @return string
*/
protected function toRegex(string $str)
{
return $this->isRegex($str) ? $str : Glob::toRegex($str);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
/**
* FilecontentFilterIterator filters files by their contents using patterns (regexps or strings).
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Włodzimierz Gajda <gajdaw@gajdaw.pl>
*
* @extends MultiplePcreFilterIterator<string, \SplFileInfo>
*/
class FilecontentFilterIterator extends MultiplePcreFilterIterator
{
/**
* Filters the iterator values.
*
* @return bool
*/
#[\ReturnTypeWillChange]
public function accept()
{
if (!$this->matchRegexps && !$this->noMatchRegexps) {
return \true;
}
$fileinfo = $this->current();
if ($fileinfo->isDir() || !$fileinfo->isReadable()) {
return \false;
}
$content = $fileinfo->getContents();
if (!$content) {
return \false;
}
return $this->isAccepted($content);
}
/**
* Converts string to regexp if necessary.
*
* @param string $str Pattern: string or regexp
*
* @return string
*/
protected function toRegex(string $str)
{
return $this->isRegex($str) ? $str : '/' . \preg_quote($str, '/') . '/';
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
/**
* SortableIterator applies a sort on a given Iterator.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @implements \IteratorAggregate<string, \SplFileInfo>
*/
class SortableIterator implements \IteratorAggregate
{
public const SORT_BY_NONE = 0;
public const SORT_BY_NAME = 1;
public const SORT_BY_TYPE = 2;
public const SORT_BY_ACCESSED_TIME = 3;
public const SORT_BY_CHANGED_TIME = 4;
public const SORT_BY_MODIFIED_TIME = 5;
public const SORT_BY_NAME_NATURAL = 6;
private $iterator;
private $sort;
/**
* @param \Traversable<string, \SplFileInfo> $iterator
* @param int|callable $sort The sort type (SORT_BY_NAME, SORT_BY_TYPE, or a PHP callback)
*
* @throws \InvalidArgumentException
*/
public function __construct(\Traversable $iterator, $sort, bool $reverseOrder = \false)
{
$this->iterator = $iterator;
$order = $reverseOrder ? -1 : 1;
if (self::SORT_BY_NAME === $sort) {
$this->sort = static function (\SplFileInfo $a, \SplFileInfo $b) use($order) {
return $order * \strcmp($a->getRealPath() ?: $a->getPathname(), $b->getRealPath() ?: $b->getPathname());
};
} elseif (self::SORT_BY_NAME_NATURAL === $sort) {
$this->sort = static function (\SplFileInfo $a, \SplFileInfo $b) use($order) {
return $order * \strnatcmp($a->getRealPath() ?: $a->getPathname(), $b->getRealPath() ?: $b->getPathname());
};
} elseif (self::SORT_BY_TYPE === $sort) {
$this->sort = static function (\SplFileInfo $a, \SplFileInfo $b) use($order) {
if ($a->isDir() && $b->isFile()) {
return -$order;
} elseif ($a->isFile() && $b->isDir()) {
return $order;
}
return $order * \strcmp($a->getRealPath() ?: $a->getPathname(), $b->getRealPath() ?: $b->getPathname());
};
} elseif (self::SORT_BY_ACCESSED_TIME === $sort) {
$this->sort = static function (\SplFileInfo $a, \SplFileInfo $b) use($order) {
return $order * ($a->getATime() - $b->getATime());
};
} elseif (self::SORT_BY_CHANGED_TIME === $sort) {
$this->sort = static function (\SplFileInfo $a, \SplFileInfo $b) use($order) {
return $order * ($a->getCTime() - $b->getCTime());
};
} elseif (self::SORT_BY_MODIFIED_TIME === $sort) {
$this->sort = static function (\SplFileInfo $a, \SplFileInfo $b) use($order) {
return $order * ($a->getMTime() - $b->getMTime());
};
} elseif (self::SORT_BY_NONE === $sort) {
$this->sort = $order;
} elseif (\is_callable($sort)) {
$this->sort = $reverseOrder ? static function (\SplFileInfo $a, \SplFileInfo $b) use($sort) {
return -$sort($a, $b);
} : $sort;
} else {
throw new \InvalidArgumentException('The SortableIterator takes a PHP callable or a valid built-in sort algorithm as an argument.');
}
}
/**
* @return \Traversable<string, \SplFileInfo>
*/
#[\ReturnTypeWillChange]
public function getIterator()
{
if (1 === $this->sort) {
return $this->iterator;
}
$array = \iterator_to_array($this->iterator, \true);
if (-1 === $this->sort) {
$array = \array_reverse($array);
} else {
\uasort($array, $this->sort);
}
return new \ArrayIterator($array);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Comparator\NumberComparator;
/**
* SizeRangeFilterIterator filters out files that are not in the given size range.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @extends \FilterIterator<string, \SplFileInfo>
*/
class SizeRangeFilterIterator extends \FilterIterator
{
private $comparators = [];
/**
* @param \Iterator<string, \SplFileInfo> $iterator
* @param NumberComparator[] $comparators
*/
public function __construct(\Iterator $iterator, array $comparators)
{
$this->comparators = $comparators;
parent::__construct($iterator);
}
/**
* Filters the iterator values.
*
* @return bool
*/
#[\ReturnTypeWillChange]
public function accept()
{
$fileinfo = $this->current();
if (!$fileinfo->isFile()) {
return \true;
}
$filesize = $fileinfo->getSize();
foreach ($this->comparators as $compare) {
if (!$compare->test($filesize)) {
return \false;
}
}
return \true;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
/**
* PathFilterIterator filters files by path patterns (e.g. some/special/dir).
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Włodzimierz Gajda <gajdaw@gajdaw.pl>
*
* @extends MultiplePcreFilterIterator<string, \SplFileInfo>
*/
class PathFilterIterator extends MultiplePcreFilterIterator
{
/**
* Filters the iterator values.
*
* @return bool
*/
#[\ReturnTypeWillChange]
public function accept()
{
$filename = $this->current()->getRelativePathname();
if ('\\' === \DIRECTORY_SEPARATOR) {
$filename = \str_replace('\\', '/', $filename);
}
return $this->isAccepted($filename);
}
/**
* Converts strings to regexp.
*
* PCRE patterns are left unchanged.
*
* Default conversion:
* 'lorem/ipsum/dolor' ==> 'lorem\/ipsum\/dolor/'
*
* Use only / as directory separator (on Windows also).
*
* @param string $str Pattern: regexp or dirname
*
* @return string
*/
protected function toRegex(string $str)
{
return $this->isRegex($str) ? $str : '/' . \preg_quote($str, '/') . '/';
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Comparator\DateComparator;
/**
* DateRangeFilterIterator filters out files that are not in the given date range (last modified dates).
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @extends \FilterIterator<string, \SplFileInfo>
*/
class DateRangeFilterIterator extends \FilterIterator
{
private $comparators = [];
/**
* @param \Iterator<string, \SplFileInfo> $iterator
* @param DateComparator[] $comparators
*/
public function __construct(\Iterator $iterator, array $comparators)
{
$this->comparators = $comparators;
parent::__construct($iterator);
}
/**
* Filters the iterator values.
*
* @return bool
*/
#[\ReturnTypeWillChange]
public function accept()
{
$fileinfo = $this->current();
if (!\file_exists($fileinfo->getPathname())) {
return \false;
}
$filedate = $fileinfo->getMTime();
foreach ($this->comparators as $compare) {
if (!$compare->test($filedate)) {
return \false;
}
}
return \true;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
/**
* MultiplePcreFilterIterator filters files using patterns (regexps, globs or strings).
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @template-covariant TKey
* @template-covariant TValue
*
* @extends \FilterIterator<TKey, TValue>
*/
abstract class MultiplePcreFilterIterator extends \FilterIterator
{
protected $matchRegexps = [];
protected $noMatchRegexps = [];
/**
* @param \Iterator $iterator The Iterator to filter
* @param string[] $matchPatterns An array of patterns that need to match
* @param string[] $noMatchPatterns An array of patterns that need to not match
*/
public function __construct(\Iterator $iterator, array $matchPatterns, array $noMatchPatterns)
{
foreach ($matchPatterns as $pattern) {
$this->matchRegexps[] = $this->toRegex($pattern);
}
foreach ($noMatchPatterns as $pattern) {
$this->noMatchRegexps[] = $this->toRegex($pattern);
}
parent::__construct($iterator);
}
/**
* Checks whether the string is accepted by the regex filters.
*
* If there is no regexps defined in the class, this method will accept the string.
* Such case can be handled by child classes before calling the method if they want to
* apply a different behavior.
*
* @return bool
*/
protected function isAccepted(string $string)
{
// should at least not match one rule to exclude
foreach ($this->noMatchRegexps as $regex) {
if (\preg_match($regex, $string)) {
return \false;
}
}
// should at least match one rule
if ($this->matchRegexps) {
foreach ($this->matchRegexps as $regex) {
if (\preg_match($regex, $string)) {
return \true;
}
}
return \false;
}
// If there is no match rules, the file is accepted
return \true;
}
/**
* Checks whether the string is a regex.
*
* @return bool
*/
protected function isRegex(string $str)
{
$availableModifiers = 'imsxuADU';
if (\PHP_VERSION_ID >= 80200) {
$availableModifiers .= 'n';
}
if (\preg_match('/^(.{3,}?)[' . $availableModifiers . ']*$/', $str, $m)) {
$start = \substr($m[1], 0, 1);
$end = \substr($m[1], -1);
if ($start === $end) {
return !\preg_match('/[*?[:alnum:] \\\\]/', $start);
}
foreach ([['{', '}'], ['(', ')'], ['[', ']'], ['<', '>']] as $delimiters) {
if ($start === $delimiters[0] && $end === $delimiters[1]) {
return \true;
}
}
}
return \false;
}
/**
* Converts string into regexp.
*
* @return string
*/
protected abstract function toRegex(string $str);
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
/**
* DepthRangeFilterIterator limits the directory depth.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @template-covariant TKey
* @template-covariant TValue
*
* @extends \FilterIterator<TKey, TValue>
*/
class DepthRangeFilterIterator extends \FilterIterator
{
private $minDepth = 0;
/**
* @param \RecursiveIteratorIterator<\RecursiveIterator<TKey, TValue>> $iterator The Iterator to filter
* @param int $minDepth The min depth
* @param int $maxDepth The max depth
*/
public function __construct(\RecursiveIteratorIterator $iterator, int $minDepth = 0, int $maxDepth = \PHP_INT_MAX)
{
$this->minDepth = $minDepth;
$iterator->setMaxDepth(\PHP_INT_MAX === $maxDepth ? -1 : $maxDepth);
parent::__construct($iterator);
}
/**
* Filters the iterator values.
*
* @return bool
*/
#[\ReturnTypeWillChange]
public function accept()
{
return $this->getInnerIterator()->getDepth() >= $this->minDepth;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Gitignore;
final class VcsIgnoredFilterIterator extends \FilterIterator
{
/**
* @var string
*/
private $baseDir;
/**
* @var array<string, array{0: string, 1: string}|null>
*/
private $gitignoreFilesCache = [];
/**
* @var array<string, bool>
*/
private $ignoredPathsCache = [];
public function __construct(\Iterator $iterator, string $baseDir)
{
$this->baseDir = $this->normalizePath($baseDir);
parent::__construct($iterator);
}
public function accept() : bool
{
$file = $this->current();
$fileRealPath = $this->normalizePath($file->getRealPath());
return !$this->isIgnored($fileRealPath);
}
private function isIgnored(string $fileRealPath) : bool
{
if (\is_dir($fileRealPath) && !\str_ends_with($fileRealPath, '/')) {
$fileRealPath .= '/';
}
if (isset($this->ignoredPathsCache[$fileRealPath])) {
return $this->ignoredPathsCache[$fileRealPath];
}
$ignored = \false;
foreach ($this->parentsDirectoryDownward($fileRealPath) as $parentDirectory) {
if ($this->isIgnored($parentDirectory)) {
// rules in ignored directories are ignored, no need to check further.
break;
}
$fileRelativePath = \substr($fileRealPath, \strlen($parentDirectory) + 1);
if (null === ($regexps = $this->readGitignoreFile("{$parentDirectory}/.gitignore"))) {
continue;
}
[$exclusionRegex, $inclusionRegex] = $regexps;
if (\preg_match($exclusionRegex, $fileRelativePath)) {
$ignored = \true;
continue;
}
if (\preg_match($inclusionRegex, $fileRelativePath)) {
$ignored = \false;
}
}
return $this->ignoredPathsCache[$fileRealPath] = $ignored;
}
/**
* @return list<string>
*/
private function parentsDirectoryDownward(string $fileRealPath) : array
{
$parentDirectories = [];
$parentDirectory = $fileRealPath;
while (\true) {
$newParentDirectory = \dirname($parentDirectory);
// dirname('/') = '/'
if ($newParentDirectory === $parentDirectory) {
break;
}
$parentDirectory = $newParentDirectory;
if (0 !== \strpos($parentDirectory, $this->baseDir)) {
break;
}
$parentDirectories[] = $parentDirectory;
}
return \array_reverse($parentDirectories);
}
/**
* @return array{0: string, 1: string}|null
*/
private function readGitignoreFile(string $path) : ?array
{
if (\array_key_exists($path, $this->gitignoreFilesCache)) {
return $this->gitignoreFilesCache[$path];
}
if (!\file_exists($path)) {
return $this->gitignoreFilesCache[$path] = null;
}
if (!\is_file($path) || !\is_readable($path)) {
throw new \RuntimeException("The \"ignoreVCSIgnored\" option cannot be used by the Finder as the \"{$path}\" file is not readable.");
}
$gitignoreFileContent = \file_get_contents($path);
return $this->gitignoreFilesCache[$path] = [Gitignore::toRegex($gitignoreFileContent), Gitignore::toRegexMatchingNegatedPatterns($gitignoreFileContent)];
}
private function normalizePath(string $path) : string
{
if ('\\' === \DIRECTORY_SEPARATOR) {
return \str_replace('\\', '/', $path);
}
return $path;
}
}
Copyright (c) 2004-present Fabien Potencier
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
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder;
/**
* Gitignore matches against text.
*
* @author Michael Voříšek <vorismi3@fel.cvut.cz>
* @author Ahmed Abdou <mail@ahmd.io>
*/
class Gitignore
{
/**
* Returns a regexp which is the equivalent of the gitignore pattern.
*
* Format specification: https://git-scm.com/docs/gitignore#_pattern_format
*/
public static function toRegex(string $gitignoreFileContent) : string
{
return self::buildRegex($gitignoreFileContent, \false);
}
public static function toRegexMatchingNegatedPatterns(string $gitignoreFileContent) : string
{
return self::buildRegex($gitignoreFileContent, \true);
}
private static function buildRegex(string $gitignoreFileContent, bool $inverted) : string
{
$gitignoreFileContent = \preg_replace('~(?<!\\\\)#[^\\n\\r]*~', '', $gitignoreFileContent);
$gitignoreLines = \preg_split('~\\r\\n?|\\n~', $gitignoreFileContent);
$res = self::lineToRegex('');
foreach ($gitignoreLines as $line) {
$line = \preg_replace('~(?<!\\\\)[ \\t]+$~', '', $line);
if ('!' === \substr($line, 0, 1)) {
$line = \substr($line, 1);
$isNegative = \true;
} else {
$isNegative = \false;
}
if ('' !== $line) {
if ($isNegative xor $inverted) {
$res = '(?!' . self::lineToRegex($line) . '$)' . $res;
} else {
$res = '(?:' . $res . '|' . self::lineToRegex($line) . ')';
}
}
}
return '~^(?:' . $res . ')~s';
}
private static function lineToRegex(string $gitignoreLine) : string
{
if ('' === $gitignoreLine) {
return '$f';
// always false
}
$slashPos = \strpos($gitignoreLine, '/');
if (\false !== $slashPos && \strlen($gitignoreLine) - 1 !== $slashPos) {
if (0 === $slashPos) {
$gitignoreLine = \substr($gitignoreLine, 1);
}
$isAbsolute = \true;
} else {
$isAbsolute = \false;
}
$regex = \preg_quote(\str_replace('\\', '', $gitignoreLine), '~');
$regex = \preg_replace_callback('~\\\\\\[((?:\\\\!)?)([^\\[\\]]*)\\\\\\]~', function (array $matches) : string {
return '[' . ('' !== $matches[1] ? '^' : '') . \str_replace('\\-', '-', $matches[2]) . ']';
}, $regex);
$regex = \preg_replace('~(?:(?:\\\\\\*){2,}(/?))+~', '(?:(?:(?!//).(?<!//))+$1)?', $regex);
$regex = \preg_replace('~\\\\\\*~', '[^/]*', $regex);
$regex = \preg_replace('~\\\\\\?~', '[^/]', $regex);
return ($isAbsolute ? '' : '(?:[^/]+/)*') . $regex . (!\str_ends_with($gitignoreLine, '/') ? '(?:$|/)' : '');
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Comparator\DateComparator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Comparator\NumberComparator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Exception\DirectoryNotFoundException;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator\CustomFilterIterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator\DateRangeFilterIterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator\DepthRangeFilterIterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator\ExcludeDirectoryFilterIterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator\FilecontentFilterIterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator\FilenameFilterIterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator\LazyIterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator\SizeRangeFilterIterator;
use _PHPStan_6dcda722c\Symfony\Component\Finder\Iterator\SortableIterator;
/**
* Finder allows to build rules to find files and directories.
*
* It is a thin wrapper around several specialized iterator classes.
*
* All rules may be invoked several times.
*
* All methods return the current Finder object to allow chaining:
*
* $finder = Finder::create()->files()->name('*.php')->in(__DIR__);
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @implements \IteratorAggregate<string, SplFileInfo>
*/
class Finder implements \IteratorAggregate, \Countable
{
public const IGNORE_VCS_FILES = 1;
public const IGNORE_DOT_FILES = 2;
public const IGNORE_VCS_IGNORED_FILES = 4;
private $mode = 0;
private $names = [];
private $notNames = [];
private $exclude = [];
private $filters = [];
private $depths = [];
private $sizes = [];
private $followLinks = \false;
private $reverseSorting = \false;
private $sort = \false;
private $ignore = 0;
private $dirs = [];
private $dates = [];
private $iterators = [];
private $contains = [];
private $notContains = [];
private $paths = [];
private $notPaths = [];
private $ignoreUnreadableDirs = \false;
private static $vcsPatterns = ['.svn', '_svn', 'CVS', '_darcs', '.arch-params', '.monotone', '.bzr', '.git', '.hg'];
public function __construct()
{
$this->ignore = static::IGNORE_VCS_FILES | static::IGNORE_DOT_FILES;
}
/**
* Creates a new Finder.
*
* @return static
*/
public static function create()
{
return new static();
}
/**
* Restricts the matching to directories only.
*
* @return $this
*/
public function directories()
{
$this->mode = Iterator\FileTypeFilterIterator::ONLY_DIRECTORIES;
return $this;
}
/**
* Restricts the matching to files only.
*
* @return $this
*/
public function files()
{
$this->mode = Iterator\FileTypeFilterIterator::ONLY_FILES;
return $this;
}
/**
* Adds tests for the directory depth.
*
* Usage:
*
* $finder->depth('> 1') // the Finder will start matching at level 1.
* $finder->depth('< 3') // the Finder will descend at most 3 levels of directories below the starting point.
* $finder->depth(['>= 1', '< 3'])
*
* @param string|int|string[]|int[] $levels The depth level expression or an array of depth levels
*
* @return $this
*
* @see DepthRangeFilterIterator
* @see NumberComparator
*/
public function depth($levels)
{
foreach ((array) $levels as $level) {
$this->depths[] = new Comparator\NumberComparator($level);
}
return $this;
}
/**
* Adds tests for file dates (last modified).
*
* The date must be something that strtotime() is able to parse:
*
* $finder->date('since yesterday');
* $finder->date('until 2 days ago');
* $finder->date('> now - 2 hours');
* $finder->date('>= 2005-10-15');
* $finder->date(['>= 2005-10-15', '<= 2006-05-27']);
*
* @param string|string[] $dates A date range string or an array of date ranges
*
* @return $this
*
* @see strtotime
* @see DateRangeFilterIterator
* @see DateComparator
*/
public function date($dates)
{
foreach ((array) $dates as $date) {
$this->dates[] = new Comparator\DateComparator($date);
}
return $this;
}
/**
* Adds rules that files must match.
*
* You can use patterns (delimited with / sign), globs or simple strings.
*
* $finder->name('/\.php$/')
* $finder->name('*.php') // same as above, without dot files
* $finder->name('test.php')
* $finder->name(['test.py', 'test.php'])
*
* @param string|string[] $patterns A pattern (a regexp, a glob, or a string) or an array of patterns
*
* @return $this
*
* @see FilenameFilterIterator
*/
public function name($patterns)
{
$this->names = \array_merge($this->names, (array) $patterns);
return $this;
}
/**
* Adds rules that files must not match.
*
* @param string|string[] $patterns A pattern (a regexp, a glob, or a string) or an array of patterns
*
* @return $this
*
* @see FilenameFilterIterator
*/
public function notName($patterns)
{
$this->notNames = \array_merge($this->notNames, (array) $patterns);
return $this;
}
/**
* Adds tests that file contents must match.
*
* Strings or PCRE patterns can be used:
*
* $finder->contains('Lorem ipsum')
* $finder->contains('/Lorem ipsum/i')
* $finder->contains(['dolor', '/ipsum/i'])
*
* @param string|string[] $patterns A pattern (string or regexp) or an array of patterns
*
* @return $this
*
* @see FilecontentFilterIterator
*/
public function contains($patterns)
{
$this->contains = \array_merge($this->contains, (array) $patterns);
return $this;
}
/**
* Adds tests that file contents must not match.
*
* Strings or PCRE patterns can be used:
*
* $finder->notContains('Lorem ipsum')
* $finder->notContains('/Lorem ipsum/i')
* $finder->notContains(['lorem', '/dolor/i'])
*
* @param string|string[] $patterns A pattern (string or regexp) or an array of patterns
*
* @return $this
*
* @see FilecontentFilterIterator
*/
public function notContains($patterns)
{
$this->notContains = \array_merge($this->notContains, (array) $patterns);
return $this;
}
/**
* Adds rules that filenames must match.
*
* You can use patterns (delimited with / sign) or simple strings.
*
* $finder->path('some/special/dir')
* $finder->path('/some\/special\/dir/') // same as above
* $finder->path(['some dir', 'another/dir'])
*
* Use only / as dirname separator.
*
* @param string|string[] $patterns A pattern (a regexp or a string) or an array of patterns
*
* @return $this
*
* @see FilenameFilterIterator
*/
public function path($patterns)
{
$this->paths = \array_merge($this->paths, (array) $patterns);
return $this;
}
/**
* Adds rules that filenames must not match.
*
* You can use patterns (delimited with / sign) or simple strings.
*
* $finder->notPath('some/special/dir')
* $finder->notPath('/some\/special\/dir/') // same as above
* $finder->notPath(['some/file.txt', 'another/file.log'])
*
* Use only / as dirname separator.
*
* @param string|string[] $patterns A pattern (a regexp or a string) or an array of patterns
*
* @return $this
*
* @see FilenameFilterIterator
*/
public function notPath($patterns)
{
$this->notPaths = \array_merge($this->notPaths, (array) $patterns);
return $this;
}
/**
* Adds tests for file sizes.
*
* $finder->size('> 10K');
* $finder->size('<= 1Ki');
* $finder->size(4);
* $finder->size(['> 10K', '< 20K'])
*
* @param string|int|string[]|int[] $sizes A size range string or an integer or an array of size ranges
*
* @return $this
*
* @see SizeRangeFilterIterator
* @see NumberComparator
*/
public function size($sizes)
{
foreach ((array) $sizes as $size) {
$this->sizes[] = new Comparator\NumberComparator($size);
}
return $this;
}
/**
* Excludes directories.
*
* Directories passed as argument must be relative to the ones defined with the `in()` method. For example:
*
* $finder->in(__DIR__)->exclude('ruby');
*
* @param string|array $dirs A directory path or an array of directories
*
* @return $this
*
* @see ExcludeDirectoryFilterIterator
*/
public function exclude($dirs)
{
$this->exclude = \array_merge($this->exclude, (array) $dirs);
return $this;
}
/**
* Excludes "hidden" directories and files (starting with a dot).
*
* This option is enabled by default.
*
* @return $this
*
* @see ExcludeDirectoryFilterIterator
*/
public function ignoreDotFiles(bool $ignoreDotFiles)
{
if ($ignoreDotFiles) {
$this->ignore |= static::IGNORE_DOT_FILES;
} else {
$this->ignore &= ~static::IGNORE_DOT_FILES;
}
return $this;
}
/**
* Forces the finder to ignore version control directories.
*
* This option is enabled by default.
*
* @return $this
*
* @see ExcludeDirectoryFilterIterator
*/
public function ignoreVCS(bool $ignoreVCS)
{
if ($ignoreVCS) {
$this->ignore |= static::IGNORE_VCS_FILES;
} else {
$this->ignore &= ~static::IGNORE_VCS_FILES;
}
return $this;
}
/**
* Forces Finder to obey .gitignore and ignore files based on rules listed there.
*
* This option is disabled by default.
*
* @return $this
*/
public function ignoreVCSIgnored(bool $ignoreVCSIgnored)
{
if ($ignoreVCSIgnored) {
$this->ignore |= static::IGNORE_VCS_IGNORED_FILES;
} else {
$this->ignore &= ~static::IGNORE_VCS_IGNORED_FILES;
}
return $this;
}
/**
* Adds VCS patterns.
*
* @see ignoreVCS()
*
* @param string|string[] $pattern VCS patterns to ignore
*/
public static function addVCSPattern($pattern)
{
foreach ((array) $pattern as $p) {
self::$vcsPatterns[] = $p;
}
self::$vcsPatterns = \array_unique(self::$vcsPatterns);
}
/**
* Sorts files and directories by an anonymous function.
*
* The anonymous function receives two \SplFileInfo instances to compare.
*
* This can be slow as all the matching files and directories must be retrieved for comparison.
*
* @return $this
*
* @see SortableIterator
*/
public function sort(\Closure $closure)
{
$this->sort = $closure;
return $this;
}
/**
* Sorts files and directories by name.
*
* This can be slow as all the matching files and directories must be retrieved for comparison.
*
* @return $this
*
* @see SortableIterator
*/
public function sortByName(bool $useNaturalSort = \false)
{
$this->sort = $useNaturalSort ? Iterator\SortableIterator::SORT_BY_NAME_NATURAL : Iterator\SortableIterator::SORT_BY_NAME;
return $this;
}
/**
* Sorts files and directories by type (directories before files), then by name.
*
* This can be slow as all the matching files and directories must be retrieved for comparison.
*
* @return $this
*
* @see SortableIterator
*/
public function sortByType()
{
$this->sort = Iterator\SortableIterator::SORT_BY_TYPE;
return $this;
}
/**
* Sorts files and directories by the last accessed time.
*
* This is the time that the file was last accessed, read or written to.
*
* This can be slow as all the matching files and directories must be retrieved for comparison.
*
* @return $this
*
* @see SortableIterator
*/
public function sortByAccessedTime()
{
$this->sort = Iterator\SortableIterator::SORT_BY_ACCESSED_TIME;
return $this;
}
/**
* Reverses the sorting.
*
* @return $this
*/
public function reverseSorting()
{
$this->reverseSorting = \true;
return $this;
}
/**
* Sorts files and directories by the last inode changed time.
*
* This is the time that the inode information was last modified (permissions, owner, group or other metadata).
*
* On Windows, since inode is not available, changed time is actually the file creation time.
*
* This can be slow as all the matching files and directories must be retrieved for comparison.
*
* @return $this
*
* @see SortableIterator
*/
public function sortByChangedTime()
{
$this->sort = Iterator\SortableIterator::SORT_BY_CHANGED_TIME;
return $this;
}
/**
* Sorts files and directories by the last modified time.
*
* This is the last time the actual contents of the file were last modified.
*
* This can be slow as all the matching files and directories must be retrieved for comparison.
*
* @return $this
*
* @see SortableIterator
*/
public function sortByModifiedTime()
{
$this->sort = Iterator\SortableIterator::SORT_BY_MODIFIED_TIME;
return $this;
}
/**
* Filters the iterator with an anonymous function.
*
* The anonymous function receives a \SplFileInfo and must return false
* to remove files.
*
* @return $this
*
* @see CustomFilterIterator
*/
public function filter(\Closure $closure)
{
$this->filters[] = $closure;
return $this;
}
/**
* Forces the following of symlinks.
*
* @return $this
*/
public function followLinks()
{
$this->followLinks = \true;
return $this;
}
/**
* Tells finder to ignore unreadable directories.
*
* By default, scanning unreadable directories content throws an AccessDeniedException.
*
* @return $this
*/
public function ignoreUnreadableDirs(bool $ignore = \true)
{
$this->ignoreUnreadableDirs = $ignore;
return $this;
}
/**
* Searches files and directories which match defined rules.
*
* @param string|string[] $dirs A directory path or an array of directories
*
* @return $this
*
* @throws DirectoryNotFoundException if one of the directories does not exist
*/
public function in($dirs)
{
$resolvedDirs = [];
foreach ((array) $dirs as $dir) {
if (\is_dir($dir)) {
$resolvedDirs[] = [$this->normalizeDir($dir)];
} elseif ($glob = \glob($dir, (\defined('GLOB_BRACE') ? \GLOB_BRACE : 0) | \GLOB_ONLYDIR | \GLOB_NOSORT)) {
\sort($glob);
$resolvedDirs[] = \array_map([$this, 'normalizeDir'], $glob);
} else {
throw new DirectoryNotFoundException(\sprintf('The "%s" directory does not exist.', $dir));
}
}
$this->dirs = \array_merge($this->dirs, ...$resolvedDirs);
return $this;
}
/**
* Returns an Iterator for the current Finder configuration.
*
* This method implements the IteratorAggregate interface.
*
* @return \Iterator<string, SplFileInfo>
*
* @throws \LogicException if the in() method has not been called
*/
#[\ReturnTypeWillChange]
public function getIterator()
{
if (0 === \count($this->dirs) && 0 === \count($this->iterators)) {
throw new \LogicException('You must call one of in() or append() methods before iterating over a Finder.');
}
if (1 === \count($this->dirs) && 0 === \count($this->iterators)) {
$iterator = $this->searchInDirectory($this->dirs[0]);
if ($this->sort || $this->reverseSorting) {
$iterator = (new Iterator\SortableIterator($iterator, $this->sort, $this->reverseSorting))->getIterator();
}
return $iterator;
}
$iterator = new \AppendIterator();
foreach ($this->dirs as $dir) {
$iterator->append(new \IteratorIterator(new LazyIterator(function () use($dir) {
return $this->searchInDirectory($dir);
})));
}
foreach ($this->iterators as $it) {
$iterator->append($it);
}
if ($this->sort || $this->reverseSorting) {
$iterator = (new Iterator\SortableIterator($iterator, $this->sort, $this->reverseSorting))->getIterator();
}
return $iterator;
}
/**
* Appends an existing set of files/directories to the finder.
*
* The set can be another Finder, an Iterator, an IteratorAggregate, or even a plain array.
*
* @return $this
*
* @throws \InvalidArgumentException when the given argument is not iterable
*/
public function append(iterable $iterator)
{
if ($iterator instanceof \IteratorAggregate) {
$this->iterators[] = $iterator->getIterator();
} elseif ($iterator instanceof \Iterator) {
$this->iterators[] = $iterator;
} elseif (\is_iterable($iterator)) {
$it = new \ArrayIterator();
foreach ($iterator as $file) {
$file = $file instanceof \SplFileInfo ? $file : new \SplFileInfo($file);
$it[$file->getPathname()] = $file;
}
$this->iterators[] = $it;
} else {
throw new \InvalidArgumentException('Finder::append() method wrong argument type.');
}
return $this;
}
/**
* Check if any results were found.
*
* @return bool
*/
public function hasResults()
{
foreach ($this->getIterator() as $_) {
return \true;
}
return \false;
}
/**
* Counts all the results collected by the iterators.
*
* @return int
*/
#[\ReturnTypeWillChange]
public function count()
{
return \iterator_count($this->getIterator());
}
private function searchInDirectory(string $dir) : \Iterator
{
$exclude = $this->exclude;
$notPaths = $this->notPaths;
if (static::IGNORE_VCS_FILES === (static::IGNORE_VCS_FILES & $this->ignore)) {
$exclude = \array_merge($exclude, self::$vcsPatterns);
}
if (static::IGNORE_DOT_FILES === (static::IGNORE_DOT_FILES & $this->ignore)) {
$notPaths[] = '#(^|/)\\..+(/|$)#';
}
$minDepth = 0;
$maxDepth = \PHP_INT_MAX;
foreach ($this->depths as $comparator) {
switch ($comparator->getOperator()) {
case '>':
$minDepth = $comparator->getTarget() + 1;
break;
case '>=':
$minDepth = $comparator->getTarget();
break;
case '<':
$maxDepth = $comparator->getTarget() - 1;
break;
case '<=':
$maxDepth = $comparator->getTarget();
break;
default:
$minDepth = $maxDepth = $comparator->getTarget();
}
}
$flags = \RecursiveDirectoryIterator::SKIP_DOTS;
if ($this->followLinks) {
$flags |= \RecursiveDirectoryIterator::FOLLOW_SYMLINKS;
}
$iterator = new Iterator\RecursiveDirectoryIterator($dir, $flags, $this->ignoreUnreadableDirs);
if ($exclude) {
$iterator = new Iterator\ExcludeDirectoryFilterIterator($iterator, $exclude);
}
$iterator = new \RecursiveIteratorIterator($iterator, \RecursiveIteratorIterator::SELF_FIRST);
if ($minDepth > 0 || $maxDepth < \PHP_INT_MAX) {
$iterator = new Iterator\DepthRangeFilterIterator($iterator, $minDepth, $maxDepth);
}
if ($this->mode) {
$iterator = new Iterator\FileTypeFilterIterator($iterator, $this->mode);
}
if ($this->names || $this->notNames) {
$iterator = new Iterator\FilenameFilterIterator($iterator, $this->names, $this->notNames);
}
if ($this->contains || $this->notContains) {
$iterator = new Iterator\FilecontentFilterIterator($iterator, $this->contains, $this->notContains);
}
if ($this->sizes) {
$iterator = new Iterator\SizeRangeFilterIterator($iterator, $this->sizes);
}
if ($this->dates) {
$iterator = new Iterator\DateRangeFilterIterator($iterator, $this->dates);
}
if ($this->filters) {
$iterator = new Iterator\CustomFilterIterator($iterator, $this->filters);
}
if ($this->paths || $notPaths) {
$iterator = new Iterator\PathFilterIterator($iterator, $this->paths, $notPaths);
}
if (static::IGNORE_VCS_IGNORED_FILES === (static::IGNORE_VCS_IGNORED_FILES & $this->ignore)) {
$iterator = new Iterator\VcsIgnoredFilterIterator($iterator, $dir);
}
return $iterator;
}
/**
* Normalizes given directory names by removing trailing slashes.
*
* Excluding: (s)ftp:// or ssh2.(s)ftp:// wrapper
*/
private function normalizeDir(string $dir) : string
{
if ('/' === $dir) {
return $dir;
}
$dir = \rtrim($dir, '/' . \DIRECTORY_SEPARATOR);
if (\preg_match('#^(ssh2\\.)?s?ftp://#', $dir)) {
$dir .= '/';
}
return $dir;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Exception;
/**
* @author Andreas Erhard <andreas.erhard@i-med.ac.at>
*/
class DirectoryNotFoundException extends \InvalidArgumentException
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Exception;
/**
* @author Jean-François Simon <jeanfrancois.simon@sensiolabs.com>
*/
class AccessDeniedException extends \UnexpectedValueException
{
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder;
/**
* Extends \SplFileInfo to support relative paths.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class SplFileInfo extends \SplFileInfo
{
private $relativePath;
private $relativePathname;
/**
* @param string $file The file name
* @param string $relativePath The relative path
* @param string $relativePathname The relative path name
*/
public function __construct(string $file, string $relativePath, string $relativePathname)
{
parent::__construct($file);
$this->relativePath = $relativePath;
$this->relativePathname = $relativePathname;
}
/**
* Returns the relative path.
*
* This path does not contain the file name.
*
* @return string
*/
public function getRelativePath()
{
return $this->relativePath;
}
/**
* Returns the relative path name.
*
* This path contains the file name.
*
* @return string
*/
public function getRelativePathname()
{
return $this->relativePathname;
}
public function getFilenameWithoutExtension() : string
{
$filename = $this->getFilename();
return \pathinfo($filename, \PATHINFO_FILENAME);
}
/**
* Returns the contents of the file.
*
* @return string
*
* @throws \RuntimeException
*/
public function getContents()
{
\set_error_handler(function ($type, $msg) use(&$error) {
$error = $msg;
});
try {
$content = \file_get_contents($this->getPathname());
} finally {
\restore_error_handler();
}
if (\false === $content) {
throw new \RuntimeException($error);
}
return $content;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Comparator;
/**
* DateCompare compiles date comparisons.
*
* @author Fabien Potencier <fabien@symfony.com>
*/
class DateComparator extends Comparator
{
/**
* @param string $test A comparison string
*
* @throws \InvalidArgumentException If the test is not understood
*/
public function __construct(string $test)
{
if (!\preg_match('#^\\s*(==|!=|[<>]=?|after|since|before|until)?\\s*(.+?)\\s*$#i', $test, $matches)) {
throw new \InvalidArgumentException(\sprintf('Don\'t understand "%s" as a date test.', $test));
}
try {
$date = new \DateTime($matches[2]);
$target = $date->format('U');
} catch (\Exception $e) {
throw new \InvalidArgumentException(\sprintf('"%s" is not a valid date.', $matches[2]));
}
$operator = $matches[1] ?? '==';
if ('since' === $operator || 'after' === $operator) {
$operator = '>';
}
if ('until' === $operator || 'before' === $operator) {
$operator = '<';
}
parent::__construct($target, $operator);
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Comparator;
/**
* NumberComparator compiles a simple comparison to an anonymous
* subroutine, which you can call with a value to be tested again.
*
* Now this would be very pointless, if NumberCompare didn't understand
* magnitudes.
*
* The target value may use magnitudes of kilobytes (k, ki),
* megabytes (m, mi), or gigabytes (g, gi). Those suffixed
* with an i use the appropriate 2**n version in accordance with the
* IEC standard: http://physics.nist.gov/cuu/Units/binary.html
*
* Based on the Perl Number::Compare module.
*
* @author Fabien Potencier <fabien@symfony.com> PHP port
* @author Richard Clamp <richardc@unixbeard.net> Perl version
* @copyright 2004-2005 Fabien Potencier <fabien@symfony.com>
* @copyright 2002 Richard Clamp <richardc@unixbeard.net>
*
* @see http://physics.nist.gov/cuu/Units/binary.html
*/
class NumberComparator extends Comparator
{
/**
* @param string|null $test A comparison string or null
*
* @throws \InvalidArgumentException If the test is not understood
*/
public function __construct(?string $test)
{
if (null === $test || !\preg_match('#^\\s*(==|!=|[<>]=?)?\\s*([0-9\\.]+)\\s*([kmg]i?)?\\s*$#i', $test, $matches)) {
throw new \InvalidArgumentException(\sprintf('Don\'t understand "%s" as a number test.', $test ?? 'null'));
}
$target = $matches[2];
if (!\is_numeric($target)) {
throw new \InvalidArgumentException(\sprintf('Invalid number "%s".', $target));
}
if (isset($matches[3])) {
// magnitude
switch (\strtolower($matches[3])) {
case 'k':
$target *= 1000;
break;
case 'ki':
$target *= 1024;
break;
case 'm':
$target *= 1000000;
break;
case 'mi':
$target *= 1024 * 1024;
break;
case 'g':
$target *= 1000000000;
break;
case 'gi':
$target *= 1024 * 1024 * 1024;
break;
}
}
parent::__construct($target, $matches[1] ?: '==');
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder\Comparator;
/**
* @author Fabien Potencier <fabien@symfony.com>
*/
class Comparator
{
private $target;
private $operator = '==';
public function __construct(?string $target = null, string $operator = '==')
{
if (null === $target) {
trigger_deprecation('symfony/finder', '5.4', 'Constructing a "%s" without setting "$target" is deprecated.', __CLASS__);
}
$this->target = $target;
$this->doSetOperator($operator);
}
/**
* Gets the target value.
*
* @return string
*/
public function getTarget()
{
if (null === $this->target) {
trigger_deprecation('symfony/finder', '5.4', 'Calling "%s" without initializing the target is deprecated.', __METHOD__);
}
return $this->target;
}
/**
* @deprecated set the target via the constructor instead
*/
public function setTarget(string $target)
{
trigger_deprecation('symfony/finder', '5.4', '"%s" is deprecated. Set the target via the constructor instead.', __METHOD__);
$this->target = $target;
}
/**
* Gets the comparison operator.
*
* @return string
*/
public function getOperator()
{
return $this->operator;
}
/**
* Sets the comparison operator.
*
* @throws \InvalidArgumentException
*
* @deprecated set the operator via the constructor instead
*/
public function setOperator(string $operator)
{
trigger_deprecation('symfony/finder', '5.4', '"%s" is deprecated. Set the operator via the constructor instead.', __METHOD__);
$this->doSetOperator('' === $operator ? '==' : $operator);
}
/**
* Tests against the target.
*
* @param mixed $test A test value
*
* @return bool
*/
public function test($test)
{
if (null === $this->target) {
trigger_deprecation('symfony/finder', '5.4', 'Calling "%s" without initializing the target is deprecated.', __METHOD__);
}
switch ($this->operator) {
case '>':
return $test > $this->target;
case '>=':
return $test >= $this->target;
case '<':
return $test < $this->target;
case '<=':
return $test <= $this->target;
case '!=':
return $test != $this->target;
}
return $test == $this->target;
}
private function doSetOperator(string $operator) : void
{
if (!\in_array($operator, ['>', '<', '>=', '<=', '==', '!='])) {
throw new \InvalidArgumentException(\sprintf('Invalid operator "%s".', $operator));
}
$this->operator = $operator;
}
}
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Symfony\Component\Finder;
/**
* Glob matches globbing patterns against text.
*
* if match_glob("foo.*", "foo.bar") echo "matched\n";
*
* // prints foo.bar and foo.baz
* $regex = glob_to_regex("foo.*");
* for (['foo.bar', 'foo.baz', 'foo', 'bar'] as $t)
* {
* if (/$regex/) echo "matched: $car\n";
* }
*
* Glob implements glob(3) style matching that can be used to match
* against text, rather than fetching names from a filesystem.
*
* Based on the Perl Text::Glob module.
*
* @author Fabien Potencier <fabien@symfony.com> PHP port
* @author Richard Clamp <richardc@unixbeard.net> Perl version
* @copyright 2004-2005 Fabien Potencier <fabien@symfony.com>
* @copyright 2002 Richard Clamp <richardc@unixbeard.net>
*/
class Glob
{
/**
* Returns a regexp which is the equivalent of the glob pattern.
*
* @return string
*/
public static function toRegex(string $glob, bool $strictLeadingDot = \true, bool $strictWildcardSlash = \true, string $delimiter = '#')
{
$firstByte = \true;
$escaping = \false;
$inCurlies = 0;
$regex = '';
$sizeGlob = \strlen($glob);
for ($i = 0; $i < $sizeGlob; ++$i) {
$car = $glob[$i];
if ($firstByte && $strictLeadingDot && '.' !== $car) {
$regex .= '(?=[^\\.])';
}
$firstByte = '/' === $car;
if ($firstByte && $strictWildcardSlash && isset($glob[$i + 2]) && '**' === $glob[$i + 1] . $glob[$i + 2] && (!isset($glob[$i + 3]) || '/' === $glob[$i + 3])) {
$car = '[^/]++/';
if (!isset($glob[$i + 3])) {
$car .= '?';
}
if ($strictLeadingDot) {
$car = '(?=[^\\.])' . $car;
}
$car = '/(?:' . $car . ')*';
$i += 2 + isset($glob[$i + 3]);
if ('/' === $delimiter) {
$car = \str_replace('/', '\\/', $car);
}
}
if ($delimiter === $car || '.' === $car || '(' === $car || ')' === $car || '|' === $car || '+' === $car || '^' === $car || '$' === $car) {
$regex .= "\\{$car}";
} elseif ('*' === $car) {
$regex .= $escaping ? '\\*' : ($strictWildcardSlash ? '[^/]*' : '.*');
} elseif ('?' === $car) {
$regex .= $escaping ? '\\?' : ($strictWildcardSlash ? '[^/]' : '.');
} elseif ('{' === $car) {
$regex .= $escaping ? '\\{' : '(';
if (!$escaping) {
++$inCurlies;
}
} elseif ('}' === $car && $inCurlies) {
$regex .= $escaping ? '}' : ')';
if (!$escaping) {
--$inCurlies;
}
} elseif (',' === $car && $inCurlies) {
$regex .= $escaping ? ',' : '|';
} elseif ('\\' === $car) {
if ($escaping) {
$regex .= '\\\\';
$escaping = \false;
} else {
$escaping = \true;
}
continue;
} else {
$regex .= $car;
}
$escaping = \false;
}
return $delimiter . '^' . $regex . '$' . $delimiter;
}
}
{
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
"extends": [
"local>Ocramius/.github:renovate-config"
]
}
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\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 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\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 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\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 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 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 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 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 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\Exception;
use LogicException;
class NotImplemented extends LogicException
{
}
<?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;
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 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 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 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 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 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 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 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 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;
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\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 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 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\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;
/**
* 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\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 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 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 LogicException;
class NoParent extends LogicException
{
}
<?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 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 RuntimeException;
class InvalidDefaultValueType extends RuntimeException
{
}
<?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 ReflectionException;
class MethodPrototypeNotFound extends ReflectionException
{
}
<?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 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;
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 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;
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;
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;
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;
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 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\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\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\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\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\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\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\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\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\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\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\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 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 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 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 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;
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\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 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\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;
/** @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\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 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\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 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;
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;
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]));
}
}
<?php
declare (strict_types=1);
namespace PHPStan\BetterReflection\SourceLocator\SourceStubber;
use BackedEnum;
use _PHPStan_6dcda722c\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\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 CompileError;
use DatePeriod;
use Error;
use Generator;
use Iterator;
use IteratorAggregate;
use _PHPStan_6dcda722c\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;
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\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;
/** @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;
/** @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\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;
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 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 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 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;
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 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\Exception;
use LogicException;
class NotInternalClass extends LogicException
{
}
<?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 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\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;
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 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 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\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;
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 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 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\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 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 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 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\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\Exception;
use Throwable;
interface Exception extends Throwable
{
}
<?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\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;
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 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\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\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\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 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 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;
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;
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 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;
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\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;
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 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;
/**
* @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 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\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\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\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\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;
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\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;
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\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 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\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\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\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\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\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 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();
}
}
Copyright (c) 2011 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
declare (strict_types=1);
/*
* This file is part of Evenement.
*
* (c) Igor Wiedler <igor@wiedler.ch>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Evenement;
interface EventEmitterInterface
{
public function on($event, callable $listener);
public function once($event, callable $listener);
public function removeListener($event, callable $listener);
public function removeAllListeners($event = null);
public function listeners($event = null);
public function emit($event, array $arguments = []);
}
<?php
declare (strict_types=1);
/*
* This file is part of Evenement.
*
* (c) Igor Wiedler <igor@wiedler.ch>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Evenement;
class EventEmitter implements EventEmitterInterface
{
use EventEmitterTrait;
}
<?php
declare (strict_types=1);
/*
* This file is part of Evenement.
*
* (c) Igor Wiedler <igor@wiedler.ch>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace _PHPStan_6dcda722c\Evenement;
use InvalidArgumentException;
use function count;
use function array_keys;
use function array_merge;
use function array_search;
use function array_unique;
use function array_values;
trait EventEmitterTrait
{
protected $listeners = [];
protected $onceListeners = [];
public function on($event, callable $listener)
{
if ($event === null) {
throw new InvalidArgumentException('event name must not be null');
}
if (!isset($this->listeners[$event])) {
$this->listeners[$event] = [];
}
$this->listeners[$event][] = $listener;
return $this;
}
public function once($event, callable $listener)
{
if ($event === null) {
throw new InvalidArgumentException('event name must not be null');
}
if (!isset($this->onceListeners[$event])) {
$this->onceListeners[$event] = [];
}
$this->onceListeners[$event][] = $listener;
return $this;
}
public function removeListener($event, callable $listener)
{
if ($event === null) {
throw new InvalidArgumentException('event name must not be null');
}
if (isset($this->listeners[$event])) {
$index = array_search($listener, $this->listeners[$event], \true);
if (\false !== $index) {
unset($this->listeners[$event][$index]);
if (count($this->listeners[$event]) === 0) {
unset($this->listeners[$event]);
}
}
}
if (isset($this->onceListeners[$event])) {
$index = array_search($listener, $this->onceListeners[$event], \true);
if (\false !== $index) {
unset($this->onceListeners[$event][$index]);
if (count($this->onceListeners[$event]) === 0) {
unset($this->onceListeners[$event]);
}
}
}
}
public function removeAllListeners($event = null)
{
if ($event !== null) {
unset($this->listeners[$event]);
} else {
$this->listeners = [];
}
if ($event !== null) {
unset($this->onceListeners[$event]);
} else {
$this->onceListeners = [];
}
}
public function listeners($event = null) : array
{
if ($event === null) {
$events = [];
$eventNames = array_unique(array_merge(array_keys($this->listeners), array_keys($this->onceListeners)));
foreach ($eventNames as $eventName) {
$events[$eventName] = array_merge(isset($this->listeners[$eventName]) ? $this->listeners[$eventName] : [], isset($this->onceListeners[$eventName]) ? $this->onceListeners[$eventName] : []);
}
return $events;
}
return array_merge(isset($this->listeners[$event]) ? $this->listeners[$event] : [], isset($this->onceListeners[$event]) ? $this->onceListeners[$event] : []);
}
public function emit($event, array $arguments = [])
{
if ($event === null) {
throw new InvalidArgumentException('event name must not be null');
}
$listeners = [];
if (isset($this->listeners[$event])) {
$listeners = array_values($this->listeners[$event]);
}
$onceListeners = [];
if (isset($this->onceListeners[$event])) {
$onceListeners = array_values($this->onceListeners[$event]);
}
if (empty($listeners) === \false) {
foreach ($listeners as $listener) {
$listener(...$arguments);
}
}
if (empty($onceListeners) === \false) {
unset($this->onceListeners[$event]);
foreach ($onceListeners as $listener) {
$listener(...$arguments);
}
}
}
}
<?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.
<?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>
<?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>
<?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');
}
<?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\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\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;
}
}
<?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>
<?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>
<?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\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
{
}
<?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;
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;
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\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;
/**
* 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;
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\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\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\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\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;
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\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;
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');
//
// 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\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\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\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\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\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;
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\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
{
}
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;
/**
* Define the __ constant, so useful in compiler :-).
*/
!\defined('_PHPStan_6dcda722c\\GO') and \define('_PHPStan_6dcda722c\\GO', 'GO');
!\defined('_PHPStan_6dcda722c\\__') and \define('_PHPStan_6dcda722c\\__', '__');
/**
* 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;
}
}
<?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\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\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\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\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\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();
}
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\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\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;
/**
* 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\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\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\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\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\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\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\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\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\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\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;
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\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;
}
}
<?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\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);
}
}
//
// 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;
/**
* 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
/**
* 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\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\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;
/**
* 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);
}
}
<?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
<?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\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;
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\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\Demultiplexer.
*
* Demux result from another iterator.
* This iterator is somehow the opposite of the Hoa\Iterator\Multiple iterator.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Demultiplexer implements \Hoa\Iterator\Iterator
{
/**
* Current iterator.
*
* @var \Traversable
*/
protected $_iterator = null;
/**
* Current computed value.
*
* @var mixed
*/
protected $_current = null;
/**
* Demuxer (callable to execute each time).
*
* @var callable
*/
protected $_demuxer = null;
/**
* Constructor.
*
* @param \Traversable $iterator Iterator.
* @param callable $demuxer Demuxer.
* @throws \Hoa\Iterator\Exception
*/
public function __construct(\Traversable $iterator, $demuxer)
{
if ($iterator instanceof \IteratorAggregate) {
$iterator = $iterator->getIterator();
}
$this->_iterator = $iterator;
$this->_demuxer = $demuxer;
return;
}
/**
* Return the current element.
*
* @return mixed
*/
public function current()
{
if (null !== $this->_current) {
return $this->_current;
}
$demuxer = $this->_demuxer;
return $this->_current = $demuxer($this->_iterator->current());
}
/**
* Return the key of the current element.
*
* @return mixed
*/
public function key()
{
return $this->_iterator->key();
}
/**
* Move forward to next element.
*
* @return void
*/
public function next()
{
$this->_current = null;
return $this->_iterator->next();
}
/**
* Rewind the iterator to the first element.
*
* @return void
*/
public function rewind()
{
return $this->_iterator->rewind();
}
/**
* Check if current position is valid.
*
* @return bool
*/
public function valid()
{
return $this->_iterator->valid();
}
}
<?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\Directory.
*
* Extending the SPL DirectoryIterator class.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Directory extends \DirectoryIterator
{
/**
* SplFileInfo classname.
*
* @var string
*/
protected $_splFileInfoClass = null;
/**
* Relative path.
*
* @var string
*/
protected $_relativePath = null;
/**
* Constructor.
* Please, see \DirectoryIterator::__construct() method.
* We add the $splFileInfoClass parameter.
*
* @param string $path Path.
* @param string $splFileInfoClass SplFileInfo classname.
*/
public function __construct($path, $splFileInfoClass = null)
{
$this->_splFileInfoClass = $splFileInfoClass;
parent::__construct($path);
$this->setRelativePath($path);
return;
}
/**
* Current.
* Please, see \DirectoryIterator::current() method.
*
* @return mixed
*/
public function current()
{
$out = parent::current();
if (null !== $this->_splFileInfoClass && $out instanceof \SplFileInfo) {
$out->setInfoClass($this->_splFileInfoClass);
$out = $out->getFileInfo();
if ($out instanceof \Hoa\Iterator\SplFileInfo) {
$out->setRelativePath($this->getRelativePath());
}
}
return $out;
}
/**
* Set relative path.
*
* @param string $relativePath Relative path.
* @return string
*/
protected function setRelativePath($path)
{
$old = $this->_relativePath;
$this->_relativePath = $path;
return $old;
}
/**
* Get relative path (if given).
*
* @return string
*/
public function getRelativePath()
{
return $this->_relativePath;
}
}
<?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\IteratorSeekable.
*
* Extending the SPL SeekableIterator interface.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
interface Seekable extends \SeekableIterator
{
}
<?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;
/**
* Interface \Hoa\Iterator\Aggregate.
*
* Extending the SPL IteratorAggregate interface.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
interface Aggregate extends \IteratorAggregate
{
}
<?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\Limit.
*
* Extending the SPL LimitIterator class.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Limit extends \LimitIterator
{
}
<?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\Lookahead.
*
* Look ahead iterator.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Lookahead extends \Hoa\Iterator\IteratorIterator implements \Hoa\Iterator\Outer
{
/**
* Current iterator.
*
* @var \Iterator
*/
protected $_iterator = null;
/**
* Current key.
*
* @var mixed
*/
protected $_key = 0;
/**
* Current value.
*
* @var mixed
*/
protected $_current = null;
/**
* Whether the current element is valid or not.
*
* @var bool
*/
protected $_valid = \false;
/**
* Construct.
*
* @param \Iterator $iterator Iterator.
*/
public function __construct(\Iterator $iterator)
{
$this->_iterator = $iterator;
return;
}
/**
* Get inner iterator.
*
* @return \Iterator
*/
public function getInnerIterator() : ?\Iterator
{
return $this->_iterator;
}
/**
* Return the current element.
*
* @return mixed
*/
#[\ReturnTypeWillChange]
public function current()
{
return $this->_current;
}
/**
* Return the key of the current element.
*
* @return mixed
*/
#[\ReturnTypeWillChange]
public function key()
{
return $this->_key;
}
/**
* Move forward to next element.
*
* @return void
*/
#[\ReturnTypeWillChange]
public function next()
{
$innerIterator = $this->getInnerIterator();
$this->_valid = $innerIterator->valid();
if (\false === $this->_valid) {
return;
}
$this->_key = $innerIterator->key();
$this->_current = $innerIterator->current();
return $innerIterator->next();
}
/**
* Rewind the iterator to the first element.
*
* @return void
*/
#[\ReturnTypeWillChange]
public function rewind()
{
$out = $this->getInnerIterator()->rewind();
$this->next();
return $out;
}
/**
* Check if current position is valid.
*
* @return bool
*/
public function valid() : bool
{
return $this->_valid;
}
/**
* Check whether there is a next element.
*
* @return bool
*/
public function hasNext()
{
return $this->getInnerIterator()->valid();
}
/**
* Get next value.
*
* @return mixed
*/
public function getNext()
{
return $this->getInnerIterator()->current();
}
/**
* Get next key.
*
* @return mixed
*/
public function getNextKey()
{
return $this->getInnerIterator()->key();
}
}
<?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\Repeater.
*
* Repeat an iterator n-times.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Repeater implements \Hoa\Iterator\Iterator
{
/**
* Current iterator.
*
* @var \Traversable
*/
protected $_iterator = null;
/**
* Maximum repetition.
*
* @var int
*/
protected $_n = 1;
/**
* Current repetition.
*
* @var int
*/
protected $_i = 1;
/**
* Body (callable to execute each time).
*
* @var callable
*/
protected $_body = null;
/**
* Constructor.
*
* @param \Traversable $iterator Iterator.
* @param int $n Repeat $n-times.
* @param callable $body Body.
* @throws \Hoa\Iterator\Exception
*/
public function __construct(\Traversable $iterator, $n, $body = null)
{
if (0 >= $n) {
throw new \Hoa\Iterator\Exception('n must be greater than 0, given %d.', 0, $n);
}
if ($iterator instanceof \IteratorAggregate) {
$iterator = $iterator->getIterator();
}
$this->_iterator = $iterator;
$this->_n = $n;
$this->_body = $body;
return;
}
/**
* Return the current element.
*
* @return mixed
*/
public function current()
{
return $this->_iterator->current();
}
/**
* Return the key of the current element.
*
* @return mixed
*/
public function key()
{
return $this->_iterator->key();
}
/**
* Move forward to next element.
*
* @return void
*/
public function next()
{
return $this->_iterator->next();
}
/**
* Rewind the iterator to the first element.
*
* @return void
*/
public function rewind()
{
return $this->_iterator->rewind();
}
/**
* Check if current position is valid.
*
* @return bool
*/
public function valid()
{
$valid = $this->_iterator->valid();
if (\true === $valid) {
return \true;
}
if (null !== $this->_body) {
$handle =& $this->_body;
$handle($this->_i);
}
$this->rewind();
if ($this->_n <= $this->_i++) {
$this->_i = 1;
return \false;
}
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;
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\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;
/**
* Interface \Hoa\Iterator\Outer.
*
* Extending the SPL OuterIterator interface.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
interface Outer extends \OuterIterator
{
}
This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches)
Patches applied to this directory:
0
Source: patches/Buffer.patch
1
Source: patches/Lookahead.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\Iterator;
/**
* Class \Hoa\Iterator\Buffer.
*
* Buffer iterator: Can go backward up to a certain limit, and forward.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Buffer extends \Hoa\Iterator\IteratorIterator implements \Hoa\Iterator\Outer
{
/**
* Buffer key index.
*
* @const int
*/
const BUFFER_KEY = 0;
/**
* Buffer value index.
*
* @const int
*/
const BUFFER_VALUE = 1;
/**
* Current iterator.
*
* @var \Iterator
*/
protected $_iterator = null;
/**
* Buffer.
*
* @var \SplDoublyLinkedList
*/
protected $_buffer = null;
/**
* Maximum buffer size.
*
* @var int
*/
protected $_bufferSize = 1;
/**
* Construct.
*
* @param \Iterator $iterator Iterator.
* @param int $bufferSize Buffer size.
*/
public function __construct(\Iterator $iterator, $bufferSize)
{
$this->_iterator = $iterator;
$this->_bufferSize = \max($bufferSize, 1);
$this->_buffer = new \SplDoublyLinkedList();
return;
}
/**
* Get inner iterator.
*
* @return \Iterator
*/
public function getInnerIterator() : ?\Iterator
{
return $this->_iterator;
}
/**
* Get buffer.
*
* @return \SplDoublyLinkedList
*/
protected function getBuffer()
{
return $this->_buffer;
}
/**
* Get buffer size.
*
* @return int
*/
public function getBufferSize()
{
return $this->_bufferSize;
}
/**
* Return the current element.
*
* @return mixed
*/
#[\ReturnTypeWillChange]
public function current()
{
return $this->getBuffer()->current()[self::BUFFER_VALUE];
}
/**
* Return the key of the current element.
*
* @return mixed
*/
#[\ReturnTypeWillChange]
public function key()
{
return $this->getBuffer()->current()[self::BUFFER_KEY];
}
/**
* Move forward to next element.
*
* @return void
*/
public function next() : void
{
$innerIterator = $this->getInnerIterator();
$buffer = $this->getBuffer();
$buffer->next();
// End of the buffer, need a new value.
if (\false === $buffer->valid()) {
for ($bufferSize = \count($buffer), $maximumBufferSize = $this->getBufferSize(); $bufferSize >= $maximumBufferSize; --$bufferSize) {
$buffer->shift();
}
$innerIterator->next();
$buffer->push([self::BUFFER_KEY => $innerIterator->key(), self::BUFFER_VALUE => $innerIterator->current()]);
// Seek to the end of the buffer.
$buffer->setIteratorMode($buffer::IT_MODE_LIFO | $buffer::IT_MODE_KEEP);
$buffer->rewind();
$buffer->setIteratorMode($buffer::IT_MODE_FIFO | $buffer::IT_MODE_KEEP);
}
return;
}
/**
* Move backward to previous element.
*
* @return void
*/
public function previous()
{
$this->getBuffer()->prev();
return;
}
/**
* Rewind the iterator to the first element.
*
* @return void
*/
public function rewind() : void
{
$innerIterator = $this->getInnerIterator();
$buffer = $this->getBuffer();
$innerIterator->rewind();
if (\true === $buffer->isEmpty()) {
$buffer->push([self::BUFFER_KEY => $innerIterator->key(), self::BUFFER_VALUE => $innerIterator->current()]);
}
$buffer->rewind();
return;
}
/**
* Check if current position is valid.
*
* @return bool
*/
public function valid() : bool
{
return $this->getBuffer()->valid() && $this->getInnerIterator()->valid();
}
}
<?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;
/**
* 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\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;
/**
* 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\Map.
*
* Extending the SPL ArrayIterator class.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Map extends \ArrayIterator
{
}
<?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\FileSystem.
*
* Extending the SPL FileSystemIterator class.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class FileSystem extends \FilesystemIterator
{
/**
* SplFileInfo classname.
*
* @var string
*/
protected $_splFileInfoClass = null;
/**
* Constructor.
* Please, see \FileSystemIterator::__construct() method.
* We add the $splFileInfoClass parameter.
*
* @param string $path Path.
* @param int $flags Flags.
* @param string $splFileInfoClass SplFileInfo classname.
*/
public function __construct($path, $flags = null, $splFileInfoClass = null)
{
$this->_splFileInfoClass = $splFileInfoClass;
if (null === $flags) {
parent::__construct($path);
} else {
parent::__construct($path, $flags);
}
return;
}
/**
* Current.
* Please, see \FileSystemIterator::current() method.
*
* @return mixed
*/
public function current()
{
$out = parent::current();
if (null !== $this->_splFileInfoClass && $out instanceof \SplFileInfo) {
$out->setInfoClass($this->_splFileInfoClass);
$out = $out->getFileInfo();
}
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\Append.
*
* Extending the SPL AppendIterator class.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Append extends \AppendIterator
{
}
<?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\Recursive;
/**
* Class \Hoa\Iterator\Recursive\Mock.
*
* Mock a recursive iterator with no children.
* It allows to use regular iterators with a recursive iterator iterator.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Mock implements \Hoa\Iterator\Recursive\Recursive
{
/**
* Current iterator.
*
* @var \Traversable
*/
protected $_iterator = null;
/**
* Constructor.
*
* @param \Traversable $iterator Iterator.
*/
public function __construct(\Traversable $iterator)
{
if ($iterator instanceof \IteratorAggregate) {
$iterator = $iterator->getIterator();
}
$this->_iterator = $iterator;
return;
}
/**
* Return the current element.
*
* @return mixed
*/
public function current()
{
return $this->_iterator->current();
}
/**
* Return the key of the current element.
*
* @return mixed
*/
public function key()
{
return $this->_iterator->key();
}
/**
* Move forward to next element.
*
* @return void
*/
public function next()
{
return $this->_iterator->next();
}
/**
* Rewind the iterator to the first element.
*
* @return void
*/
public function rewind()
{
return $this->_iterator->rewind();
}
/**
* Check if current position is valid.
*
* @return bool
*/
public function valid()
{
return $this->_iterator->valid();
}
/**
* Return an iterator for the current entry.
* It's a fake, we return null.
*
* @return void
*/
public function getChildren()
{
return null;
}
/**
* Return if an iterator can be created for the current entry.
* It's a fake, we return false.
*
* @return bool
*/
public function hasChildren()
{
return \false;
}
}
<?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\Recursive;
/**
* Class \Hoa\Iterator\Recursive\Directory.
*
* Extending the SPL RecursiveDirectoryIterator class.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Directory extends \RecursiveDirectoryIterator
{
/**
* SplFileInfo classname.
*
* @var string
*/
protected $_splFileInfoClass = null;
/**
* Relative path.
*
* @var string
*/
protected $_relativePath = 0;
/**
* Workaround for the bug #65136.
*
* @var string
*/
private static $_handlePath = null;
/**
* Constructor.
* Please, see \RecursiveDirectoryIterator::__construct() method.
* We add the $splFileInfoClass parameter.
*
* @param string $path Path.
* @param int $flags Flags.
* @param string $splFileInfoClass SplFileInfo classname.
*/
public function __construct($path, $flags = null, $splFileInfoClass = null)
{
if (null === $flags) {
parent::__construct($path);
} else {
parent::__construct($path, $flags);
}
if (null !== self::$_handlePath) {
$this->_relativePath = self::$_handlePath;
self::$_handlePath = null;
} else {
$this->_relativePath = $path;
}
$this->setSplFileInfoClass($splFileInfoClass);
return;
}
/**
* Current.
* Please, see \RecursiveDirectoryIterator::current() method.
*
* @return mixed
*/
public function current()
{
$out = parent::current();
if (null !== $this->_splFileInfoClass && $out instanceof \SplFileInfo) {
$out->setInfoClass($this->_splFileInfoClass);
$out = $out->getFileInfo();
if ($out instanceof \Hoa\Iterator\SplFileInfo) {
$out->setRelativePath($this->getRelativePath());
}
}
return $out;
}
/**
* Get children.
* Please, see \RecursiveDirectoryIterator::getChildren() method.
*
* @return mixed
*/
public function getChildren()
{
self::$_handlePath = $this->getRelativePath();
$out = parent::getChildren();
if ($out instanceof \RecursiveDirectoryIterator) {
$out->setSplFileInfoClass($this->_splFileInfoClass);
}
return $out;
}
/**
* Set SplFileInfo classname.
*
* @param string $splFileInfoClass SplFileInfo classname.
* @return void
*/
public function setSplFileInfoClass($splFileInfoClass)
{
$this->_splFileInfoClass = $splFileInfoClass;
return;
}
/**
* Get relative path (if given).
*
* @return string
*/
public function getRelativePath()
{
return $this->_relativePath;
}
}
<?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\Recursive;
/**
* Class \Hoa\Iterator\Recursive\Filter.
*
* Extending the SPL RecursiveFilterIterator class.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
abstract class Filter extends \RecursiveFilterIterator
{
}
<?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\Recursive;
/**
* Class \Hoa\Iterator\Recursive\Iterator.
*
* Extending the SPL RecursiveIteratorIterator class.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Iterator extends \RecursiveIteratorIterator
{
}
<?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\Recursive;
use Hoa\Iterator;
/**
* Class \Hoa\Iterator\Recursive\RegularExpression.
*
* Re-implement the SPL RecursiveRegexIterator 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/RecursiveRegexIterator.php
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class RegularExpression extends Iterator\RegularExpression implements \Hoa\Iterator\Recursive\Recursive
{
/**
* 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(\RecursiveIterator $iterator, $regex, $mode = self::MATCH, $flags = 0, $pregFlags = 0)
{
parent::__construct($iterator, $regex, $mode, $flags, $pregFlags);
return;
}
/**
* Get accept status.
*
* @return bool
*/
public function accept()
{
return \true === $this->hasChildren() || \true === parent::accept();
}
/**
* Get an iterator for the current entry.
*
* @return \Hoa\Iterator\Recursive\RegularExpression
*/
public function getChildren()
{
return new static(\true === $this->hasChildren() ? $this->getInnerIterator()->getChildren() : null, $this->getRegex(), $this->getMode(), $this->getFlags(), $this->getPregFlags());
}
/**
* Check whether an iterator can be obtained for the current entry.
*
* @return bool
*/
public function hasChildren()
{
return $this->getInnerIterator()->hasChildren();
}
}
<?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\Recursive;
/**
* Class \Hoa\Iterator\Recursive\Map.
*
* Extending the SPL RecursiveArrayIterator class.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Map extends \RecursiveArrayIterator
{
}
<?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\Recursive;
use Hoa\Consistency;
/**
* Class \Hoa\Iterator\Recursive.
*
* Extending the SPL RecursiveIterator interface.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
interface Recursive extends \RecursiveIterator
{
}
/**
* Flex entity.
*/
Consistency::flexEntity('Hoa\\Iterator\\Recursive\\Recursive');
<?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\Recursive;
/**
* Class \Hoa\Iterator\Recursive\CallbackFilter.
*
* Extending the SPL RecursiveCallbackFilterIterator class.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class CallbackFilter extends \RecursiveCallbackFilterIterator
{
}
<?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\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;
/**
* 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"
* 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\Counter.
*
* A counter.
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class Counter implements \Hoa\Iterator\Iterator
{
/**
* From (lower bound).
*
* @var int
*/
protected $_from = 0;
/**
* Current key.
*
* @var int
*/
protected $_key = 0;
/**
* Current index.
*
* @var int
*/
protected $_i = 0;
/**
* To (upper bound).
*
* @var int
*/
protected $_to = 0;
/**
* Step.
*
* @var int
*/
protected $_step = 0;
/**
* Constructor.
* Equivalent to:
* for($i = $from; $i < $to; $i += $step)
*
* @param int $from Start value.
* @param int $to Maximum value.
* @param int $step Step.
* @throws \Hoa\Iterator\Exception
*/
public function __construct($from, $to, $step)
{
if ($step <= 0) {
throw new \Hoa\Iterator\Exception('The step must be non-negative; given %d.', 0, $step);
}
$this->_from = $from;
$this->_to = $to;
$this->_step = $step;
return;
}
/**
* Return the current element.
*
* @return int
*/
public function current()
{
return $this->_i;
}
/**
* Return the key of the current element.
*
* @return int
*/
public function key()
{
return $this->_key;
}
/**
* Move forward to next element.
*
* @return void
*/
public function next()
{
++$this->_key;
$this->_i += $this->_step;
return;
}
/**
* Rewind the iterator to the first element.
*
* @return void
*/
public function rewind()
{
$this->_key = 0;
$this->_i = $this->_from;
return;
}
/**
* Check if current position is valid.
*
* @return bool
*/
public function valid()
{
return $this->_i < $this->_to;
}
}
<?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);
}
<?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\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());
}
}
<?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\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\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\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;
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\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\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\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
{
}
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\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\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;
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\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\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\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\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\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;
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\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.
*/
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\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.
*/
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_6dcda722c;
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\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\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;
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;
/**
* 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\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\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);
});
}
}
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\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);
}
}
<?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\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\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;
}
}
//
// 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\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;
/**
* 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;
/**
* 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;
/**
* 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;
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;
/**
* 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\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
/**
* @xglobal $GLOBALS array
* Contains a reference to every variable which is currently available within the global scope of the script.
* The keys of this array are the names of the global variables.
* $GLOBALS has existed since PHP 3.
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$GLOBALS = [];
/**
* @xglobal $_COOKIE array
* Variables provided to the script via HTTP cookies. Analogous to the old $HTTP_COOKIE_VARS array
* (which is still available, but deprecated).
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$_COOKIE = [];
/**
* @xglobal $_ENV array
* @xglobal $HTTP_ENV_VARS array
*
* Variables provided to the script via the environment.
* Analogous to the old $HTTP_ENV_VARS array (which is still available, but deprecated).
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$_ENV = [];
/**
* @deprecated 4.1
* @removed 5.4
*/
$HTTP_ENV_VARS = [];
/**
* @xglobal $_FILES array
* @xglobal $HTTP_POST_FILES array
*
* Variables provided to the script via HTTP post file uploads. Analogous to the old $HTTP_POST_FILES array
* (which is still available, but deprecated).
* See POST method uploads for more information.
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$_FILES = [];
/**
* @deprecated 4.1
* @removed 5.4
*/
$HTTP_POST_FILES = [];
/**
* @xglobal $_GET array
* @xglobal $HTTP_GET_VARS array
*
* Variables provided to the script via URL query string.
* Analogous to the old $HTTP_GET_VARS array (which is still available, but deprecated).
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$_GET = [];
/**
* @deprecated 4.1
* @removed 5.4
*/
$HTTP_GET_VARS = [];
/**
* @xglobal $_POST array
* @xglobal $HTTP_POST_VARS array
*
* Variables provided to the script via HTTP POST. Analogous to the old $HTTP_POST_VARS array
* (which is still available, but deprecated).
* @link https://secure.php.net/manual/en/language.variables.predefined.php
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$_POST = [];
/**
* @deprecated 4.1
* @removed 5.4
*/
$HTTP_POST_VARS = [];
/**
* @xglobal $_REQUEST array
* Variables provided to the script via the GET, POST, and COOKIE input mechanisms,
* and which therefore cannot be trusted.
* The presence and order of variable inclusion in this array is defined according to the
* PHP variables_order configuration directive.
* This array has no direct analogue in versions of PHP prior to 4.1.0.
* See also import_request_variables().
* <p>
* Caution
* <p>Since PHP 4.3.0, FILE information from $_FILES does not exist in $_REQUEST.
* <p>
* Note: When running on the command line , this will not include the argv and argc entries; these are present in the $_SERVER array.
*
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$_REQUEST = [];
/**
* @xglobal $_SERVER array
* @xglobal $HTTP_SERVER_VARS array
*
* Variables set by the web server or otherwise directly related to the execution environment of the current script.
* Analogous to the old $HTTP_SERVER_VARS array (which is still available, but deprecated).
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$_SERVER = [];
/**
* @deprecated 4.1
* @removed 5.4
*/
$HTTP_SERVER_VARS = [];
$_SERVER['PHP_SELF'] = '';
$_SERVER['argv'] = '';
$_SERVER['argc'] = '';
$_SERVER['GATEWAY_INTERFACE'] = 'CGI/1.1';
$_SERVER['SERVER_ADDR'] = '127.0.0.1';
$_SERVER['SERVER_NAME'] = 'localhost';
$_SERVER['SERVER_SOFTWARE'] = '';
$_SERVER['SERVER_PROTOCOL'] = 'HTTP/1.0';
$_SERVER['REQUEST_METHOD'] = 'GET';
$_SERVER['REQUEST_TIME'] = 946713600;
$_SERVER['REQUEST_TIME_FLOAT'] = 946713600.123456;
$_SERVER['QUERY_STRING'] = '';
$_SERVER['DOCUMENT_ROOT'] = '';
$_SERVER['HTTP_ACCEPT'] = '';
$_SERVER['HTTP_ACCEPT_CHARSET'] = 'iso-8859-1,*,utf-8';
$_SERVER['HTTP_ACCEPT_ENCODING'] = 'gzip';
$_SERVER['HTTP_ACCEPT_LANGUAGE'] = 'en';
$_SERVER['HTTP_CONNECTION'] = 'Keep-Alive';
$_SERVER['HTTP_HOST'] = '';
$_SERVER['HTTP_REFERER'] = '';
$_SERVER['HTTP_USER_AGENT'] = 'Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586).';
$_SERVER['HTTPS'] = '';
$_SERVER['REMOTE_ADDR'] = '';
$_SERVER['REMOTE_HOST'] = '';
$_SERVER['REMOTE_PORT'] = '';
$_SERVER['REMOTE_USER'] = '';
$_SERVER['REDIRECT_REMOTE_USER'] = '';
$_SERVER['SCRIPT_FILENAME'] = '';
$_SERVER['SERVER_ADMIN'] = '';
$_SERVER['SERVER_PORT'] = '80';
$_SERVER['SERVER_SIGNATURE'] = '';
$_SERVER['PATH_TRANSLATED'] = '';
$_SERVER['SCRIPT_NAME'] = '';
$_SERVER['REQUEST_URI'] = '/index.html';
$_SERVER['PHP_AUTH_DIGEST'] = '';
$_SERVER['PHP_AUTH_USER'] = '';
$_SERVER['PHP_AUTH_PW'] = '';
$_SERVER['AUTH_TYPE'] = '';
$_SERVER['PATH_INFO'] = '';
$_SERVER['ORIG_PATH_INFO'] = '';
/**
* @xglobal $_SESSION array
* @xglobal $HTTP_SESSION_VARS array
*
* Variables which are currently registered to a script's session.
* Analogous to the old $HTTP_SESSION_VARS array (which is still available, but deprecated).
* See the Session handling functions section for more information.
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$_SESSION = [];
/**
* @deprecated 4.1
* @removed 5.4
*/
$HTTP_SESSION_VARS = [];
/**
* @xglobal $argc int
* @type int<1, max>
*
* The number of arguments passed to script
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$argc = 0;
/**
* @xglobal $argv array
*
* Array of arguments passed to script
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$argv = [1 + 1 => "a" . "b"];
/**
* @xglobal $HTTP_RAW_POST_DATA string
*
* Raw POST data
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*
* @deprecated 5.6 Deprecated as of PHP 5.6.0. Use the php://input stream instead.
* @removed 7.0
*/
$HTTP_RAW_POST_DATA = '';
/**
* @xglobal $http_response_header array
*
* HTTP response headers
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
*/
$http_response_header = [];
/**
* @xglobal $php_errormsg string
* The previous error message
*
* <p><a href="https://secure.php.net/manual/en/reserved.variables.php">
* https://secure.php.net/manual/en/reserved.variables.php</a>
* @deprecated 7.2
*/
$php_errormsg = '';
<?php
/**
* The constants below are defined by this extension, and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime.
* @link https://php.net/manual/en/yaf.constants.php
*/
define('YAF_VERSION', '3.3.5', true);
define('YAF_ENVIRON', 'product', true);
define('YAF_ERR_STARTUP_FAILED', 512, true);
define('YAF_ERR_ROUTE_FAILED', 513, true);
define('YAF_ERR_DISPATCH_FAILED', 514, true);
define('YAF_ERR_NOTFOUND_MODULE', 515, true);
define('YAF_ERR_NOTFOUND_CONTROLLER', 516, true);
define('YAF_ERR_NOTFOUND_ACTION', 517, true);
define('YAF_ERR_NOTFOUND_VIEW', 518, true);
define('YAF_ERR_CALL_FAILED', 519, true);
define('YAF_ERR_AUTOLOAD_FAILED', 520, true);
define('YAF_ERR_TYPE_ERROR', 521, true);
define('YAF_ERR_ACCESS_ERROR', 522);
//================================================
/**
* Yaf_Application provides a bootstrapping facility for applications which provides reusable resources, common- and module-based bootstrap classes and dependency checking.
* <br/>
* <b>Note:</b>
* <p>
* Yaf_Application implements the singleton pattern, and Yaf_Application can not be serialized or un-serialized which will cause problem when you try to use PHPUnit to write some test case for Yaf.<br/>
* You may use @backupGlobals annotation of PHPUnit to control the backup and restore operations for global variables. thus can solve this problem.
* </p>
* @link https://secure.php.net/manual/en/class.yaf-application.php
*/
final class Yaf_Application
{
/**
* @var Yaf_Application
*/
protected static $_app;
/**
* @var Yaf_Config_Abstract
*/
protected $config;
/**
* @var Yaf_Dispatcher
*/
protected $dispatcher;
/**
* @var array
*/
protected $_modules;
/**
* @var string
*/
protected $_running = "";
/**
* @var string
*/
protected $_environ = YAF_ENVIRON;
/**
* @since 2.1.2
* @var int
*/
protected $_err_no = 0;
/**
* @since 2.1.2
* @var string
*/
protected $_err_msg = "";
/**
* @link https://secure.php.net/manual/en/yaf-application.construct.php
*
* <p>
* If is a ini config file, there should be a section named as the one defined by yaf.environ, which is "product" by default.
* </p>
* <br/>
* <b>Note:</b>
* <p>If you use a ini configuration file as your application's config container. you would open the yaf.cache_config to improve performance.</p>
* <p>And the config entry(and there default value) list blow:</p>
*
* <p>
* <b>Example #1 A ini config file example</b><br/>
* [product]<br/>
* ;this one should always be defined, and have no default value<br/>
* application.directory=APPLICATION_PATH<br/><br/>
* </p>
* <p>
* ;following configs have default value, you may no need to define them
* <br/>
* application.library = APPLICATION_PATH . "/library" <br/>
* application.dispatcher.throwException=1 <br/>
* application.dispatcher.catchException=1 <br/><br/>
* </p>
* <p>application.baseUri=""<br/><br/></p>
* <p>
* ;the php script ext name<br/>
* ap.ext=php<br/><br/>
* </p>
* <p>
* ;the view template ext name<br/>
* ap.view.ext=phtml<br/><br/>
* </p>
* <p>
* ap.dispatcher.defaultModule=Index<br/>
* ap.dispatcher.defaultController=Index<br/>
* ap.dispatcher.defaultAction=index<br/><br/>
* </p>
* <p>
* ;defined modules<br/>
* ap.modules=Index
* </p>
*
* @param string|array $config A ini config file path, or a config array
* @param string $environ Which section will be loaded as the final config
*
* @throws Yaf_Exception_TypeError|Yaf_Exception_StartupError
*/
public function __construct($config, $environ = null) {}
/** @return Yaf_Application */
public function getInstance() {}
/**
* Run a Yaf_Application, let the Yaf_Application accept a request, and route the request, dispatch to controller/action, and render response.
* return response to client finally.
*
* @link https://secure.php.net/manual/en/yaf-application.run.php
* @return void
* @throws Yaf_Exception_StartupError
*/
public function run() {}
/**
* This method is typically used to run Yaf_Application in a crontab work.
* Make the crontab work can also use the autoloader and Bootstrap mechanism.
*
* @link https://secure.php.net/manual/en/yaf-application.execute.php
*
* @param callable $entry a valid callback
* @param string ...$_ parameters will pass to the callback
* @return void
*/
public function execute(callable $entry, ...$_) {}
/**
* Retrieve the Yaf_Application instance, alternatively, we also could use Yaf_Dispatcher::getApplication().
*
* @link https://secure.php.net/manual/en/yaf-application.app.php
*
* @return Yaf_Application
*/
public static function app() {}
/**
* Retrieve environ which was defined in yaf.environ which has a default value "product".
*
* @link https://secure.php.net/manual/en/yaf-application.environ.php
*
* @return string
*/
public function environ() {}
/**
* Run a Bootstrap, all the methods defined in the Bootstrap and named with prefix "_init" will be called according to their declaration order, if the parameter bootstrap is not supplied, Yaf will look for a Bootstrap under application.directory.
*
* @link https://secure.php.net/manual/en/yaf-application.bootstrap.php
*
* @param Yaf_Bootstrap_Abstract $bootstrap A Yaf_Bootstrap_Abstract instance
* @return Yaf_Application
*/
public function bootstrap($bootstrap = null) {}
/**
* @return Yaf_Config_Abstract
*/
public function getConfig() {}
/**
* Get the modules list defined in config, if no one defined, there will always be a module named "Index".
*
* @link https://secure.php.net/manual/en/yaf-application.getmodules.php
*
* @return array
*/
public function getModules() {}
/**
* @link https://secure.php.net/manual/en/yaf-application.getdispatcher.php
*
* @return Yaf_Dispatcher
*/
public function getDispatcher() {}
/**
* Change the application directory
*
* @param string $directory
* @return Yaf_Application
* @since 2.1.4
* @link https://secure.php.net/manual/en/yaf-application.setappdirectory.php
*/
public function setAppDirectory($directory) {}
/**
* @return string
* @link https://secure.php.net/manual/en/yaf-application.getappdirectory.php
*
* @since 2.1.4
*/
public function getAppDirectory() {}
/**
* @return int
* @link https://secure.php.net/manual/en/yaf-application.getlasterrorno.php
*
* @since 2.1.2
*/
public function getLastErrorNo() {}
/**
* @return string
* @link https://secure.php.net/manual/en/yaf-application.getlasterrormsg.php
*
* @since 2.1.2
*/
public function getLastErrorMsg() {}
/**
* @return void
* @link https://secure.php.net/manual/en/yaf-application.clearlasterror.php
* @since 2.1.2
*/
public function clearLastError() {}
/**
* @link https://secure.php.net/manual/en/yaf-application.destruct.php
*/
public function __destruct() {}
/**
* @link https://secure.php.net/manual/en/yaf-application.clone.php
*/
private function __clone() {}
/**
* @link https://secure.php.net/manual/en/yaf-application.sleep.php
*/
private function __sleep() {}
/**
* @link https://secure.php.net/manual/en/yaf-application.wakeup.php
*/
private function __wakeup() {}
}
/**
* <p><b>Yaf_Dispatcher</b> purpose is to initialize the request environment, route the incoming request, and then dispatch any discovered actions; it aggregates any responses and returns them when the process is complete.</p><br/>
* <p><b>Yaf_Dispatcher</b> also implements the Singleton pattern, meaning only a single instance of it may be available at any given time. This allows it to also act as a registry on which the other objects in the dispatch process may draw.</p>
*
* @link https://secure.php.net/manual/en/class.yaf-dispatcher.php
*/
final class Yaf_Dispatcher
{
/**
* @var Yaf_Dispatcher
*/
protected static $_instance;
/**
* @var Yaf_Router
*/
protected $_router;
/**
* @var Yaf_View_Interface
*/
protected $_view;
/**
* @var Yaf_Request_Abstract
*/
protected $_request;
/**
* @var Yaf_Plugin_Abstract
*/
protected $_plugins;
/**
* @var bool
*/
protected $_auto_render = true;
/**
* @var string
*/
protected $_return_response = "";
/**
* @var string
*/
protected $_instantly_flush = "";
/**
* @var string
*/
protected $_default_module;
/**
* @var string
*/
protected $_default_controller;
/**
* @var string
*/
protected $_default_action;
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.construct.php
*/
private function __construct() {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.clone.php
*/
private function __clone() {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.sleep.php
*/
private function __sleep() {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.wakeup.php
*/
private function __wakeup() {}
/**
* enable view rendering
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.enableview.php
*
* @return Yaf_Dispatcher
*/
public function enableView() {}
/**
* @return Yaf_Response_Abstract|null
*/
public function getResponse() {}
/**
* @return string|null
*/
public function getDefaultModule() {}
/**
* @return string|null
*/
public function getDefaultController() {}
/**
* @return string|null
*/
public function getDefaultAction() {}
/**
* <p>disable view engine, used in some app that user will output by himself</p><br/>
* <b>Note:</b>
* <p>you can simply return FALSE in a action to prevent the auto-rendering of that action</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.disableview.php
*
* @return bool
*/
public function disableView() {}
/**
* Initialize view and return it
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.initview.php
*
* @param string $templates_dir
* @param array|null $options
* @return Yaf_View_Interface
*/
public function initView($templates_dir, ?array $options = null) {}
/**
* This method provides a solution for that if you want use a custom view engine instead of Yaf_View_Simple
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.setview.php
*
* @param Yaf_View_Interface $view A Yaf_View_Interface instance
* @return Yaf_Dispatcher
*/
public function setView($view) {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.setrequest.php
*
* @param Yaf_Request_Abstract $request
* @return Yaf_Dispatcher
*/
public function setRequest($request) {}
/**
* Retrieve the Yaf_Application instance. same as Yaf_Application::app().
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.getapplication.php
* @return Yaf_Application
*/
public function getApplication() {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.getrouter.php
*
* @return Yaf_Router
*/
public function getRouter() {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.getrequest.php
*
* @return Yaf_Request_Abstract
*/
public function getRequest() {}
/**
* <p>Set error handler for Yaf. when application.dispatcher.throwException is off, Yaf will trigger catch-able error while unexpected errors occurred.</p><br/>
* <p>Thus, this error handler will be called while the error raise.</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.seterrorhandler.php
*
* @param callable $callback a callable callback
* @param int $error_types YAF_ERR_* constants mask
*
* @return Yaf_Dispatcher
*/
public function setErrorHandler($callback, $error_types = YAF_ERR_TYPE_ERROR) {}
/**
* Change default module name
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.setdefaultmodule.php
*
* @param string $module
* @return Yaf_Dispatcher
*/
public function setDefaultModule($module) {}
/**
* Change default controller name
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.setdefaultcontroller.php
*
* @param string $controller
* @return Yaf_Dispatcher
*/
public function setDefaultController($controller) {}
/**
* Change default action name
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.setdefaultaction.php
*
* @param string $action
* @return Yaf_Dispatcher
*/
public function setDefaultAction($action) {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.returnresponse.php
*
* @param bool $flag
* @return Yaf_Dispatcher
*/
public function returnResponse($flag) {}
/**
* <p>Yaf_Dispatcher will render automatically after dispatches an incoming request, you can prevent the rendering by calling this method with $flag TRUE</p><br/>
* <b>Note:</b>
* <p>you can simply return FALSE in a action to prevent the auto-rendering of that action</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.autorender.php
*
* @param bool $flag since 2.2.0, if this parameter is not given, then the current state will be set
* @return Yaf_Dispatcher
*/
public function autoRender($flag = null) {}
/**
* Switch on/off the instant flushing
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.flushinstantly.php
*
* @param bool $flag since 2.2.0, if this parameter is not given, then the current state will be set
* @return Yaf_Dispatcher
*/
public function flushInstantly($flag = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.getinstance.php
*
* @return Yaf_Dispatcher
*/
public static function getInstance() {}
/**
* <p>This method does the heavy work of the Yaf_Dispatcher. It take a request object.</p><br/>
* <p>The dispatch process has three distinct events:</p>
* <ul>
* <li>Routing</li>
* <li>Dispatching</li>
* <li>Response</li>
* </ul>
* <p>Routing takes place exactly once, using the values in the request object when dispatch() is called. Dispatching takes place in a loop; a request may either indicate multiple actions to dispatch, or the controller or a plugin may reset the request object to force additional actions to dispatch(see Yaf_Plugin_Abstract. When all is done, the Yaf_Dispatcher returns a response.</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.dispatch.php
*
* @param Yaf_Request_Abstract $request
*
* @throws Yaf_Exception_TypeError
* @throws Yaf_Exception_RouterFailed
* @throws Yaf_Exception_DispatchFailed
* @throws Yaf_Exception_LoadFailed
* @throws Yaf_Exception_LoadFailed_Action
* @throws Yaf_Exception_LoadFailed_Controller
*
* @return Yaf_Response_Abstract
*/
public function dispatch($request) {}
/**
* <p>Switch on/off exception throwing while unexpected error occurring. When this is on, Yaf will throwing exceptions instead of triggering catchable errors.</p><br/>
* <p>You can also use application.dispatcher.throwException to achieve the same purpose.</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.throwexception.php
*
* @param bool $flag
* @return Yaf_Dispatcher
*/
public function throwException($flag = null) {}
/**
* <p>While the application.dispatcher.throwException is On(you can also calling to <b>Yaf_Dispatcher::throwException(TRUE)</b> to enable it), Yaf will throw Exception whe error occurs instead of trigger error.</p><br/>
* <p>then if you enable <b>Yaf_Dispatcher::catchException()</b>(also can enabled by set application.dispatcher.catchException), all uncaught Exceptions will be caught by ErrorController::error if you have defined one.</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.catchexception.php
*
* @param bool $flag
* @return Yaf_Dispatcher
*/
public function catchException($flag = null) {}
/**
* Register a plugin(see Yaf_Plugin_Abstract). Generally, we register plugins in Bootstrap(see Yaf_Bootstrap_Abstract).
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.registerplugin.php
*
* @param Yaf_Plugin_Abstract $plugin
* @return Yaf_Dispatcher
*/
public function registerPlugin($plugin) {}
/**
* @param Yaf_Response_Abstract $response
* @return Yaf_Dispatcher|null
*/
public function setResponse($response) {}
}
/**
* <p><b>Yaf_Loader</b> introduces a comprehensive autoloading solution for Yaf.</p>
* <br/>
* <p>The first time an instance of Yaf_Application is retrieved, <b>Yaf_Loader</b> will instance a singleton, and registers itself with spl_autoload. You retrieve an instance using the Yaf_Loader::getInstance()</p>
* <br/>
* <p><b>Yaf_Loader</b> attempt to load a class only one shot, if failed, depend on yaf.use_spl_autoload, if this config is On Yaf_Loader::autoload() will return FALSE, thus give the chance to other autoload function. if it is Off (by default), Yaf_Loader::autoload() will return TRUE, and more important is that a very useful warning will be triggered (very useful to find out why a class could not be loaded).</p>
* <br/>
* <b>Note:</b>
* <p>Please keep yaf.use_spl_autoload Off unless there is some library have their own autoload mechanism and impossible to rewrite it.</p>
* <br/>
* <p>If you want <b>Yaf_Loader</b> search some classes(libraries) in the local class directory(which is defined in application.ini, and by default, it is application.directory . "/library"), you should register the class prefix using the Yaf_Loader::registerLocalNameSpace()</p>
* @link https://secure.php.net/manual/en/class.yaf-loader.php
*/
class Yaf_Loader
{
/**
* @var string
*/
protected $_local_ns;
/**
* By default, this value is application.directory . "/library", you can change this either in the application.ini(application.library) or call to Yaf_Loader::setLibraryPath()
* @var string
*/
protected $_library;
/**
* @var string
*/
protected $_global_library;
/**
* @var Yaf_Loader
*/
protected static $_instance;
/**
* @link https://secure.php.net/manual/en/yaf-loader.construct.php
*/
private function __construct() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.clone.php
*/
private function __clone() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.sleep.php
*/
private function __sleep() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.wakeup.php
*/
private function __wakeup() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.autoload.php
*
* @param string $class_name
*
* @return bool
*/
public function autoload($class_name) {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.getinstance.php
*
* @param string $local_library_path
* @param string $global_library_path
*
* @return Yaf_Loader
*/
public static function getInstance($local_library_path = null, $global_library_path = null) {}
/**
* <p>Register local class prefix name, Yaf_Loader search classes in two library directories, the one is configured via application.library.directory(in application.ini) which is called local library directory; the other is configured via yaf.library (in php.ini) which is called global library directory, since it can be shared by many applications in the same server.</p>
* <br/>
* <p>When an autoloading is triggered, Yaf_Loader will determine which library directory should be searched in by examining the prefix name of the missed classname. If the prefix name is registered as a local namespace then look for it in local library directory, otherwise look for it in global library directory.</p>
* <br/>
* <b>Note:</b>
* <p>If yaf.library is not configured, then the global library directory is assumed to be the local library directory. in that case, all autoloading will look for local library directory. But if you want your Yaf application be strong, then always register your own classes as local classes.</p>
* @link https://secure.php.net/manual/en/yaf-loader.registerlocalnamespace.php
*
* @param string|string[] $namespace a string or a array of class name prefix. all class prefix with these prefix will be loaded in local library path.
* @param string $path
*
* @return bool
*/
public function registerLocalNamespace($namespace, $path = '') {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.getlocalnamespace.php
*
* @return string
*/
public function getLocalNamespace() {}
/**
* @return string
*/
public function getNamespaces() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.clearlocalnamespace.php
* @return bool
*/
public function clearLocalNamespace() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.islocalname.php
*
* @param string $class_name
*
* @return bool
*/
public function isLocalName($class_name) {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.import.php
*
* @param string $file
*
* @return bool
*/
public static function import($file) {}
/**
* @param string $library_path
* @param bool $is_global
*
* @return Yaf_Loader
* @link https://secure.php.net/manual/en/yaf-loader.setlibrarypath.php
*
* @since 2.1.4
*/
public function setLibraryPath($library_path, $is_global = false) {}
/**
* @param bool $is_global
*
* @return string
* @since 2.1.4
* @link https://secure.php.net/manual/en/yaf-loader.getlibrarypath.php
*/
public function getLibraryPath($is_global = false) {}
/**
* @param string|array $namespace
* @param string $path
* @return Yaf_Loader|null|false
*/
public function registerNamespace($namespace, $path = '') {}
/**
* @param string $class_name
* @return string
*/
public function getNamespacePath($class_name) {}
}
/**
* <p>All methods of <b>Yaf_Registry</b> declared as static, making it universally accessible. This provides the ability to get or set any custom data from anyway in your code as necessary.</p>
* @link https://secure.php.net/manual/en/class.yaf-registry.php
*/
final class Yaf_Registry
{
/**
* @var Yaf_Registry
*/
protected static $_instance;
/**
* @var array
*/
protected $_entries;
/**
* @link https://secure.php.net/manual/en/yaf-registry.construct.php
*/
private function __construct() {}
/**
* @link https://secure.php.net/manual/en/yaf-registry.clone.php
*/
private function __clone() {}
/**
* Retrieve an item from registry
*
* @link https://secure.php.net/manual/en/yaf-registry.get.php
*
* @param string $name
*
* @return mixed
*/
public static function get($name) {}
/**
* Check whether an item exists
*
* @link https://secure.php.net/manual/en/yaf-registry.has.php
*
* @param string $name
*
* @return bool
*/
public static function has($name) {}
/**
* @link https://secure.php.net/manual/en/yaf-registry.set.php
*
* @param string $name
* @param string $value
*
* @return bool
*/
public static function set($name, $value) {}
/**
* @link https://secure.php.net/manual/en/yaf-registry.del.php
*
* @param string $name
*
* @return void|bool
*/
public static function del($name) {}
}
/**
* @link https://secure.php.net/manual/en/class.yaf-session.php
* @version 2.2.9
*/
final class Yaf_Session implements Iterator, ArrayAccess, Countable
{
/**
* @var Yaf_Session
*/
protected static $_instance;
/**
* @var array
*/
protected $_session;
/**
* @var bool
*/
protected $_started = true;
/**
* @link https://secure.php.net/manual/en/yaf-session.construct.php
*/
private function __construct() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.clone.php
*/
private function __clone() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.sleep.php
*/
private function __sleep() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.wakeup.php
*/
private function __wakeup() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.getinstance.php
*
* @return Yaf_Session
*/
public static function getInstance() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.start.php
*
* @return Yaf_Session
*/
public function start() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.get.php
*
* @param string $name
*
* @return mixed
*/
public function get($name) {}
/**
* @link https://secure.php.net/manual/en/yaf-session.has.php
*
* @param string $name
*
* @return bool
*/
public function has($name) {}
/**
* @link https://secure.php.net/manual/en/yaf-session.set.php
*
* @param string $name
* @param mixed $value
*
* @return Yaf_Session|false return FALSE on failure
*/
public function set($name, $value) {}
/**
* @link https://secure.php.net/manual/en/yaf-session.del.php
*
* @param string $name
*
* @return Yaf_Session|false return FALSE on failure
*/
public function del($name) {}
/**
* @see Countable::count
* @return int
*/
public function count(): int {}
/**
* @see Iterator::rewind
* @return void
*/
public function rewind() {}
/**
* @see Iterator::current
*/
public function current() {}
/**
* @see Iterator::next
* @return void
*/
public function next() {}
/**
* @see Iterator::valid
* @return bool
*/
public function valid() {}
/**
* @see Iterator::key
*/
public function key() {}
/**
* @see ArrayAccess::offsetUnset
* @param mixed $offset
* @return void
*/
public function offsetUnset($offset) {}
/**
* @see ArrayAccess::offsetGet
* @param mixed $offset
* @return mixed
*/
public function offsetGet($offset) {}
/**
* @see ArrayAccess::offsetExists
* @param mixed $offset
* @return bool
*/
public function offsetExists($offset) {}
/**
* @see ArrayAccess::offsetSet
* @param mixed $offset
* @param mixed $value
* @return void
*/
public function offsetSet($offset, $value) {}
/**
* @see Yaf_Session::get()
* @param string $name
* @return mixed
*/
public function __get($name) {}
/**
* @see Yaf_Session::has()
* @param string $name
* @return bool
*/
public function __isset($name) {}
/**
* @see Yaf_Session::set()
* @param string $name
* @param mixed $value
* @return void
*/
public function __set($name, $value) {}
/**
* @see Yaf_Session::del()
* @param string $name
* @return void
*/
public function __unset($name) {}
/**
* @return Yaf_Session|null|false
*/
public function clear() {}
}
/**
* <p><b>Yaf_Router</b> is the standard framework router. Routing is the process of taking a URI endpoint (that part of the URI which comes after the base URI: see Yaf_Request_Abstract::setBaseUri()) and decomposing it into parameters to determine which module, controller, and action of that controller should receive the request. This values of the module, controller, action and other parameters are packaged into a Yaf_Request_Abstract object which is then processed by Yaf_Dispatcher. Routing occurs only once: when the request is initially received and before the first controller is dispatched. Yaf_Router is designed to allow for mod_rewrite-like functionality using pure PHP structures. It is very loosely based on Ruby on Rails routing and does not require any prior knowledge of webserver URL rewriting</p>
* <br/>
* <b>Default Route</b>
* <br/>
* <p><b>Yaf_Router</b> comes pre-configured with a default route Yaf_Route_Static, which will match URIs in the shape of controller/action. Additionally, a module name may be specified as the first path element, allowing URIs of the form module/controller/action. Finally, it will also match any additional parameters appended to the URI by default - controller/action/var1/value1/var2/value2.</p>
* <br/>
* <b>Note:</b>
* <p>Module name must be defined in config, considering application.module="Index,Foo,Bar", in this case, only index, foo and bar can be considered as a module name. if doesn't config, there is only one module named "Index".</p>
* <br/>
* <p>** See examples by opening the external documentation</p>
* @link https://secure.php.net/manual/en/class.yaf-router.php
*/
class Yaf_Router
{
/**
* @var Yaf_Route_Interface[] registered routes stack
*/
protected $_routes;
/**
* @var string after routing phase, this indicated the name of which route is used to route current request. you can get this name by Yaf_Router::getCurrentRoute()
*/
protected $_current;
/**
* @link https://secure.php.net/manual/en/yaf-router.construct.php
*/
public function __construct() {}
/**
* <p>by default, Yaf_Router using a Yaf_Route_Static as its default route. you can add new routes into router's route stack by calling this method.</p>
* <br/>
* <p>the newer route will be called before the older(route stack), and if the newer router return TRUE, the router process will be end. otherwise, the older one will be called.</p>
*
* @link https://secure.php.net/manual/en/yaf-router.addroute.php
*
* @param string $name
* @param Yaf_Route_Interface $route
*
* @return Yaf_Router|false return FALSE on failure
*/
public function addRoute($name, $route) {}
/**
* <p>Add routes defined by configs into Yaf_Router's route stack</p>
*
* @link https://secure.php.net/manual/en/yaf-router.addconfig.php
*
* @param Yaf_Config_Abstract $config
*
* @return Yaf_Router|false return FALSE on failure
*/
public function addConfig($config) {}
/**
* @link https://secure.php.net/manual/en/yaf-router.route.php
*
* @param Yaf_Request_Abstract $request
*
* @return bool
*/
public function route($request) {}
/**
* <p>Retrieve a route by name, see also Yaf_Router::getCurrentRoute()</p>
*
* @link https://secure.php.net/manual/en/yaf-router.getroute.php
*
* @param string $name
*
* @return Yaf_Route_Interface
*/
public function getRoute($name) {}
/**
* @link https://secure.php.net/manual/en/yaf-router.getroutes.php
*
* @return Yaf_Route_Interface[]
*/
public function getRoutes() {}
/**
* <p>Get the name of the route which is effective in the route process.</p>
* <br/>
* <b>Note:</b>
* <p>You should call this method after the route process finished, since before that, this method will always return NULL.</p>
*
* @link https://secure.php.net/manual/en/yaf-router.getcurrentroute.php
*
* @return string the name of the effective route.
*/
public function getCurrentRoute() {}
}
/**
* <p>Bootstrap is a mechanism used to do some initial config before a Application run.<br/><br/></p>
* <p>User may define their own Bootstrap class by inheriting <b>Yaf_Bootstrap_Abstract</b><br/><br/></p>
* <p>Any method declared in Bootstrap class with leading "_init", will be called by Yaf_Application::bootstrap() one by one according to their defined order<br/><br/></p>
*
* @link https://secure.php.net/manual/en/class.yaf-bootstrap-abstract.php
*/
abstract class Yaf_Bootstrap_Abstract {}
/**
* <p><b>Yaf_Controller_Abstract</b> is the heart of Yaf's system. MVC stands for Model-View-Controller and is a design pattern targeted at separating application logic from display logic.</p>
* <br/>
* <p>Every custom controller shall inherit <b>Yaf_Controller_Abstract</b>.</p>
* <br/>
* <p>You will find that you can not define __construct function for your custom controller, thus, <b>Yaf_Controller_Abstract</b> provides a magic method: Yaf_Controller_Abstract::init().</p>
* <br/>
* <p>If you have defined a init() method in your custom controller, it will be called as long as the controller was instantiated.</p>
* <br/>
* <p>Action may have arguments, when a request coming, if there are the same name variable in the request parameters(see Yaf_Request_Abstract::getParam()) after routed, Yaf will pass them to the action method (see Yaf_Action_Abstract::execute()).</p>
* <br/>
* <b>Note:</b>
* <p>These arguments are directly fetched without filtering, it should be carefully processed before use them.</p>
*
* @link https://secure.php.net/manual/en/class.yaf-controller-abstract.php
*/
abstract class Yaf_Controller_Abstract
{
/**
* @see Yaf_Action_Abstract
* @var array You can also define a action method in a separate PHP script by using this property and Yaf_Action_Abstract.
*/
public $actions;
/**
* @var string module name
*/
protected $_module;
/**
* @var string controller name
*/
protected $_name;
/**
* @var Yaf_Request_Abstract current request object
*/
protected $_request;
/**
* @var Yaf_Response_Abstract current response object
*/
protected $_response;
/**
* @var array
*/
protected $_invoke_args;
/**
* @var Yaf_View_Interface view engine object
*/
protected $_view;
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.render.php
*
* @param string $tpl
* @param array|null $parameters
*
* @return string|null|bool
*/
protected function render($tpl, ?array $parameters = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.display.php
*
* @param string $tpl
* @param array|null $parameters
*
* @return bool
*/
protected function display($tpl, ?array $parameters = null) {}
/**
* retrieve current request object
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getrequest.php
*
* @return Yaf_Request_Abstract
*/
public function getRequest() {}
/**
* retrieve current response object
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getresponse.php
*
* @return Yaf_Response_Abstract
*/
public function getResponse() {}
/**
* get the controller's module name
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getmodulename.php
*
* @return string
*/
public function getModuleName() {}
/**
* retrieve view engine
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getview.php
*
* @return Yaf_View_Interface
*/
public function getView() {}
/**
* @return string|null
*/
public function getName() {}
/**
* @param array|null $options
*
* @return Yaf_Response_Abstract
* @deprecated not_implemented
* @link https://secure.php.net/manual/en/yaf-controller-abstract.initview.php
*/
public function initView(?array $options = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.setviewpath.php
*
* @param string $view_directory
*
* @return bool
*/
public function setViewpath($view_directory) {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getviewpath.php
*
* @return string
*/
public function getViewpath() {}
/**
* <p>forward current execution process to other action.</p>
* <br/>
* <b>Note:</b>
* <p>this method doesn't switch to the destination action immediately, it will take place after current flow finish.</p>
* <br/>
* <b>Notice, there are 3 available method signatures:</b>
* <p>Yaf_Controller_Abstract::forward ( string $module , string $controller , string $action [, array $parameters ] )</p>
* <p>Yaf_Controller_Abstract::forward ( string $controller , string $action [, array $parameters ] )</p>
* <p>Yaf_Controller_Abstract::forward ( string $action [, array $parameters ] )</p>
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.forward.php
*
* @param string $module destination module name, if NULL was given, then default module name is assumed
* @param string $controller destination controller name
* @param string $action destination action name
* @param array|null $parameters calling arguments
*
* @return bool return FALSE on failure
*/
public function forward($module, $controller = null, $action = null, ?array $parameters = null) {}
/**
* redirect to a URL by sending a 302 header
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.redirect.php
*
* @param string $url a location URL
*
* @return bool
*/
public function redirect($url) {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getinvokeargs.php
*
* @return array
*/
public function getInvokeArgs() {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getinvokearg.php
* @param string $name
*
* @return mixed
*/
public function getInvokeArg($name) {}
/**
* <p>Yaf_Controller_Abstract::__construct() is final, which means users can not override it. but users can define <b>Yaf_Controller_Abstract::init()</b>, which will be called after controller object is instantiated.</p>
* @return void
* @link https://secure.php.net/manual/en/yaf-controller-abstract.init.php
*/
public function init() {}
/**
* <b>Yaf_Controller_Abstract</b>::__construct() is final, which means it can not be overridden. You may want to see Yaf_Controller_Abstract::init() instead.
*
* @param Yaf_Request_Abstract $request
* @param Yaf_Response_Abstract $response
* @param Yaf_View_Interface $view
* @param array|null $args
* @see Yaf_Controller_Abstract::init()
* @link https://secure.php.net/manual/en/yaf-controller-abstract.construct.php
*/
public function __construct($request, $response, $view, ?array $args = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.clone.php
*/
private function __clone() {}
}
/**
* <p>A action can be defined in a separate file in Yaf(see Yaf_Controller_Abstract). that is a action method can also be a <b>Yaf_Action_Abstract</b> class.</P>
* <br/>
* <p>Since there should be a entry point which can be called by Yaf (as of PHP 5.3, there is a new magic method __invoke, but Yaf is not only works with PHP 5.3+, Yaf choose another magic method execute), you must implement the abstract method Yaf_Action_Abstract::execute() in your custom action class.</p>
*
* @link https://secure.php.net/manual/en/class.yaf-action-abstract.php
*/
abstract class Yaf_Action_Abstract extends Yaf_Controller_Abstract
{
/**
* @var Yaf_Controller_Abstract
*/
protected $_controller;
/**
* <p>user should always define this method for a action, this is the entry point of an action. <b>Yaf_Action_Abstract::execute()</b> may have arguments.</p>
* <br/>
* <b>Note:</b>
* <p>The value retrieved from the request is not safe. you should do some filtering work before you use it.</p>
* @link https://secure.php.net/manual/en/yaf-action-abstract.execute.php
*
* @param mixed ...$args
* @return mixed
*/
abstract public function execute(...$args);
/**
* retrieve current controller object.
*
* @link https://secure.php.net/manual/en/yaf-action-abstract.getcontroller.php
*
* @return Yaf_Controller_Abstract
*/
public function getController() {}
/**
* @return string
*/
public function getControllerName() {}
}
/**
* @link https://secure.php.net/manual/en/class.yaf-config-abstract.php
*/
abstract class Yaf_Config_Abstract implements Iterator, ArrayAccess, Countable
{
/**
* @var array
*/
protected $_config = null;
/**
* @var bool
*/
protected $_readonly = true;
/**
* @link https://secure.php.net/manual/en/yaf-config-abstract.get.php
*
* @param ?string $name
* @return mixed
*/
abstract public function get(?string $name = null);
/**
* @link https://secure.php.net/manual/en/yaf-config-abstract.set.php
*
* @param string $name
* @param mixed $value
*/
abstract public function set(string $name, $value): bool;
/**
* @see Countable::count
* @return int
*/
public function count(): int {}
/**
* @see Iterator::rewind
* @return void
*/
public function rewind(): void {}
/**
* @see Iterator::current
* @return mixed
*/
public function current() {}
/**
* @see Iterator::key
* @return mixed
*/
public function key() {}
/**
* @see Iterator::next
* @return void
*/
public function next(): void {}
/**
* @see Iterator::valid
* @return bool
*/
public function valid(): bool {}
/** @return bool */
abstract public function readonly(): bool;
/** @return array */
abstract public function toArray(): array;
/**
* @see ArrayAccess::offsetSet
* @param mixed $offset
* @param mixed $value
* @return void
*/
public function offsetSet($offset, $value): void {}
/**
* @see ArrayAccess::offsetUnset
* @param mixed $name
* @return void
*/
public function offsetUnset($name): void {}
/**
* @link https://secure.php.net/manual/en/yaf-config-abstract.readonly.php
*
* @see ArrayAccess::offsetExists
* @param mixed $name
* @return bool
*/
public function offsetExists($name): bool {}
/**
* @link https://secure.php.net/manual/en/yaf-config-abstract.toarray.php
*
* @see ArrayAccess::offsetGet
* @param mixed $name
* @return mixed
*/
public function offsetGet($name) {}
/**
* @param string $name
* @return mixed
*/
public function __get(string $name) {}
/**
* @param string $name
* @return bool
*/
public function __isset(string $name): bool {}
}
/**
* @link https://secure.php.net/manual/en/class.yaf-request-abstract.php
*/
abstract class Yaf_Request_Abstract
{
public const SCHEME_HTTP = 'http';
public const SCHEME_HTTPS = 'https';
/**
* @var string
*/
public $module;
/**
* @var string
*/
public $controller;
/**
* @var string
*/
public $action;
/**
* @var string
*/
public $method;
/**
* @var array
*/
protected $params;
/**
* @var string
*/
protected $language;
/**
* @var Yaf_Exception
*/
protected $_exception;
/**
* @var string
*/
protected $_base_uri = "";
/**
* @var string
*/
protected $uri = "";
/**
* @var string
*/
protected $dispatched = "";
/**
* @var string
*/
protected $routed = "";
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isget.php
*
* @return bool
*/
public function isGet() {}
/** @return bool */
public function isDelete() {}
/** @return bool */
public function isPatch() {}
/** @return string|null */
public function getRaw() {}
/**
* @return Yaf_Request_Abstract|null
*/
public function clearParams() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.ispost.php
*
* @return bool
*/
public function isPost() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isput.php
*
* @return bool
*/
public function isPut() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.ishead.php
*
* @return bool
*/
public function isHead() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isoptions.php
*
* @return bool
*/
public function isOptions() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.iscli.php
*
* @return bool
*/
public function isCli() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isdispached.php
*
* @return bool
*/
final public function isDispatched() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isrouted.php
*
* @return bool
*/
final public function isRouted() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isxmlhttprequest.php
*
* @return bool
*/
public function isXmlHttpRequest() {}
/**
* Retrieve $_SERVER variable
*
* @link https://secure.php.net/manual/en/yaf-request-abstract.getserver.php
*
* @param string $name the variable name, if not provided returns all
* @param string $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getServer($name = null, $default = null) {}
/**
* Retrieve $_ENV variable
*
* @link https://secure.php.net/manual/en/yaf-request-abstract.getenv.php
*
* @param string $name the variable name, if not provided returns all
* @param string $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getEnv($name = null, $default = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getparam.php
*
* @param string $name
* @param mixed $default
*
* @return mixed
*/
public function getParam(string $name, $default = '') {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getparams.php
*
* @return array
*/
public function getParams() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getexception.php
*
* @return Yaf_Exception
*/
public function getException() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getmoudlename.php
*
* @return string
*/
public function getModuleName() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getcontrollername.php
*
* @return string
*/
public function getControllerName() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getactionname.php
*
* @return string
*/
public function getActionName() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.setparam.php
*
* @param string|array $name the variable name, or an array of key=>value pairs
* @param string $value
*
* @return Yaf_Request_Abstract|bool|null
*/
public function setParam($name, $value = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.setmodulename.php
*
* @param string $module
* @param bool $format_name
*
* @return Yaf_Request_Abstract|bool
*/
public function setModuleName($module, $format_name = true) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.setcontrollername.php
*
* @param string $controller
* @param bool $format_name
*
* @return Yaf_Request_Abstract|bool
*/
public function setControllerName($controller, $format_name = true) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.setactionname.php
*
* @param string $action
* @param bool $format_name
*
* @return Yaf_Request_Abstract|bool
*/
public function setActionName($action, $format_name = true) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getmethod.php
*
* @return string
*/
public function getMethod() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getlanguage.php
*
* @return string
*/
public function getLanguage() {}
/**
* <p>Set base URI, base URI is used when doing routing, in routing phase request URI is used to route a request, while base URI is used to skip the leading part(base URI) of request URI. That is, if comes a request with request URI a/b/c, then if you set base URI to "a/b", only "/c" will be used in routing phase.</p>
* <br/>
* <b>Note:</b>
* <p>generally, you don't need to set this, Yaf will determine it automatically.</p>
*
* @link https://secure.php.net/manual/en/yaf-request-abstract.setbaseuri.php
*
* @param string $uri base URI
*
* @return bool
*/
public function setBaseUri($uri) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getbaseuri.php
*
* @return string
*/
public function getBaseUri() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getrequesturi.php
*
* @return string
*/
public function getRequestUri() {}
/**
* @param string $uri request URI
* @return Yaf_Request_Abstract|null
* @link https://secure.php.net/manual/en/yaf-request-abstract.setrequesturi.php
*
* @since 2.1.0
*/
public function setRequestUri($uri) {}
/**
* Set request as dispatched
*
* @link https://secure.php.net/manual/en/yaf-request-abstract.setdispatched.php
* @param bool $dispatched
* @return Yaf_Request_Abstract|null
*/
final public function setDispatched($dispatched = null) {}
/**
* Set request as routed
*
* @link https://secure.php.net/manual/en/yaf-request-abstract.setrouted.php
* @param bool $flag
* @return Yaf_Request_Abstract|null
*/
final public function setRouted($flag = null) {}
/**
* @param string $name
* @param mixed $default
* @return mixed
*/
public function get($name = null, $default = null) {}
/**
* @param string $name
* @param mixed $default
* @return mixed
*/
public function getFiles($name = null, $default = null) {}
/**
* @param string $name
* @param mixed $default
* @return mixed
*/
public function getCookie($name = null, $default = null) {}
/**
* @param string $name
* @param mixed $default
* @return mixed
*/
public function getPost(string $name = '', $default = null) {}
/**
* @param string $name
* @param mixed $default
* @return mixed
*/
public function getRequest($name = null, $default = null) {}
/**
* @param string $name
* @param mixed $default
* @return mixed
*/
public function getQuery($name = null, $default = null) {}
}
/**
* <p>Plugins allow for easy extensibility and customization of the framework.</p>
* <br/>
* <p>Plugins are classes. The actual class definition will vary based on the component -- you may need to implement this interface, but the fact remains that the plugin is itself a class.</p>
* <br/>
* <p>A plugin could be loaded into Yaf by using Yaf_Dispatcher::registerPlugin(), after registered, All the methods which the plugin implemented according to this interface, will be called at the proper time.</p>
* @link https://secure.php.net/manual/en/class.yaf-plugin-abstract.php
*/
abstract class Yaf_Plugin_Abstract
{
/**
* This is the earliest hook in Yaf plugin hook system, if a custom plugin implement this method, then it will be called before routing a request.
*
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.routerstartup.php
*
* @param Yaf_Request_Abstract $request
* @param Yaf_Response_Abstract $response
*
* @return bool true
*/
public function routerStartup(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {}
/**
* This hook will be trigged after the route process finished, this hook is usually used for login check.
*
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.routershutdown.php
*
* @param Yaf_Request_Abstract $request
* @param Yaf_Response_Abstract $response
*
* @return bool true
*/
public function routerShutdown(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {}
/**
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.dispatchloopstartup.php
*
* @param Yaf_Request_Abstract $request
* @param Yaf_Response_Abstract $response
*
* @return bool true
*/
public function dispatchLoopStartup(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {}
/**
* This is the latest hook in Yaf plugin hook system, if a custom plugin implement this method, then it will be called after the dispatch loop finished.
*
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.dispatchloopshutdown.php
*
* @param Yaf_Request_Abstract $request
* @param Yaf_Response_Abstract $response
*
* @return bool true
*/
public function dispatchLoopShutdown(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {}
/**
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.predispatch.php
*
* @param Yaf_Request_Abstract $request
* @param Yaf_Response_Abstract $response
*
* @return bool true
*/
public function preDispatch(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {}
/**
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.postdispatch.php
*
* @param Yaf_Request_Abstract $request
* @param Yaf_Response_Abstract $response
*
* @return bool true
*/
public function postDispatch(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {}
/**
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.preresponse.php
*
* @param Yaf_Request_Abstract $request
* @param Yaf_Response_Abstract $response
*
* @return bool true
*/
public function preResponse(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {}
}
/**
* @link https://secure.php.net/manual/en/class.yaf-response-abstract.php
*/
abstract class Yaf_Response_Abstract
{
public const DEFAULT_BODY = "content";
/**
* @var string
*/
protected $_header;
/**
* @var string
*/
protected $_body;
/**
* @var bool
*/
protected $_sendheader;
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.construct.php
*/
public function __construct() {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.destruct.php
*/
public function __destruct() {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.clone.php
*/
private function __clone() {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.tostring.php
*/
public function __toString() {}
/**
* Send response
* @link https://secure.php.net/manual/en/yaf-response-abstract.response.php
*
* @return void
*/
public function response() {}
/**
* Set response header
* @link https://secure.php.net/manual/en/yaf-response-abstract.setheader.php
*
* @param string $name
* @param string $value
* @param bool $rep
*
* @return bool
*/
public function setHeader(string $name, string $value, bool $rep = false) {}
/**
* Set content to response
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.setbody.php
*
* @param string $body content string
* @param string $name <p>the content key, you can set a content with a key, if you don't specific, then Yaf_Response_Abstract::DEFAULT_BODY will be used</p>
* <br/>
* <b>Note:</b>
* <p>this parameter is introduced as of 2.2.0</p>
*
* @return bool
*/
public function setBody($body, $name = self::DEFAULT_BODY) {}
/**
* append a content to a exists content block
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.appendbody.php
*
* @param string $body content string
* @param string $name <p>the content key, you can set a content with a key, if you don't specific, then Yaf_Response_Abstract::DEFAULT_BODY will be used</p>
* <br/>
* <b>Note:</b>
* <p>this parameter is introduced as of 2.2.0</p>
*
* @return bool
*/
public function appendBody($body, $name = self::DEFAULT_BODY) {}
/**
* prepend a content to a exists content block
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.prependbody.php
*
* @param string $body content string
* @param string $name <p>the content key, you can set a content with a key, if you don't specific, then Yaf_Response_Abstract::DEFAULT_BODY will be used</p>
* <br/>
* <b>Note:</b>
* <p>this parameter is introduced as of 2.2.0</p>
*
* @return bool
*/
public function prependBody($body, $name = self::DEFAULT_BODY) {}
/**
* Clear existing content
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.clearbody.php
*
* @param string $name <p>the content key, you can set a content with a key, if you don't specific, then Yaf_Response_Abstract::DEFAULT_BODY will be used</p>
* <br/>
* <b>Note:</b>
* <p>this parameter is introduced as of 2.2.0</p>
*
* @return bool
*/
public function clearBody($name = self::DEFAULT_BODY) {}
/**
* Retrieve an existing content
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.getbody.php
*
* @param string|null $name <p>the content key, if you don't specific, then Yaf_Response_Abstract::DEFAULT_BODY will be used. if you pass in a NULL, then all contents will be returned as a array</p>
* <br/>
* <b>Note:</b>
* <p>this parameter is introduced as of 2.2.0</p>
*
* @return mixed
*/
public function getBody($name = self::DEFAULT_BODY) {}
}
/**
* Yaf provides a ability for developers to use custom view engine instead of build-in engine which is Yaf_View_Simple. There is a example to explain how to do this, please see Yaf_Dispatcher::setView()
*
* @link https://secure.php.net/manual/en/class.yaf-view-interface.php
*/
interface Yaf_View_Interface
{
/**
* Assign values to View engine, then the value can access directly by name in template.
*
* @link https://secure.php.net/manual/en/yaf-view-interface.assign.php
*
* @param string|array $name
* @param mixed $value
* @return Yaf_View_Interface|bool
*/
public function assign($name, $value = '');
/**
* Render a template and output the result immediately.
*
* @link https://secure.php.net/manual/en/yaf-view-interface.display.php
*
* @param string $tpl
* @param array $tpl_vars
* @return bool
*/
public function display($tpl, $tpl_vars = null);
/**
* @link https://secure.php.net/manual/en/yaf-view-interface.getscriptpath.php
*
* @return string
*/
public function getScriptPath();
/**
* Render a template and return the result.
*
* @link https://secure.php.net/manual/en/yaf-view-interface.render.php
*
* @param string $tpl
* @param array $tpl_vars
* @return string|bool
*/
public function render($tpl, $tpl_vars = null);
/**
* Set the templates base directory, this is usually called by Yaf_Dispatcher
*
* @link https://secure.php.net/manual/en/yaf-view-interface.setscriptpath.php
*
* @param string $template_dir An absolute path to the template directory, by default, Yaf_Dispatcher use application.directory . "/views" as this parameter.
* @return bool
*/
public function setScriptPath($template_dir);
}
/**
* <b>Yaf_Route_Interface</b> used for developer defined their custom route.
*
* @link https://secure.php.net/manual/en/class.yaf-route-interface.php
*/
interface Yaf_Route_Interface
{
/**
* <p><b>Yaf_Route_Interface::route()</b> is the only method that a custom route should implement.</p><br/>
* <p>if this method return TRUE, then the route process will be end. otherwise, Yaf_Router will call next route in the route stack to route request.</p><br/>
* <p>This method would set the route result to the parameter request, by calling Yaf_Request_Abstract::setControllerName(), Yaf_Request_Abstract::setActionName() and Yaf_Request_Abstract::setModuleName().</p><br/>
* <p>This method should also call Yaf_Request_Abstract::setRouted() to make the request routed at last.</p>
*
* @link https://secure.php.net/manual/en/yaf-route-interface.route.php
*
* @param Yaf_Request_Abstract $request
* @return bool
*/
public function route($request);
/**
* <p><b>Yaf_Route_Interface::assemble()</b> - assemble a request</p><br/>
* <p>this method returns a url according to the argument info, and append query strings to the url according to the argument query.</p>
* <p>a route should implement this method according to its own route rules, and do a reverse progress.</p>
*
* @link https://secure.php.net/manual/en/yaf-route-interface.assemble.php
*
* @param array $info
* @param array|null $query
* @return bool
*/
public function assemble(array $info, ?array $query = null);
}
/**
* @link https://secure.php.net/manual/en/class.yaf-exception.php
*/
class Yaf_Exception extends Exception
{
/**
* @var string
*/
protected $message;
/**
* @var string
*/
protected $code;
/**
* @var string
*/
protected $previous;
}
class Yaf_Response_Http extends Yaf_Response_Abstract
{
/**
* @var int
*/
protected $_response_code = 0;
private function __clone() {}
/**
* @return string
*/
public function __toString() {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.setheader.php
*
* @param string $name
* @param string $value
* @param bool $rep
* @param int $response_code
*
* @return bool
*/
public function setHeader(string $name = '', string $value = '', bool $rep = false, int $response_code = 0) {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.setallheaders.php
*
* @param array $headers
* @return bool
*/
public function setAllHeaders($headers) {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.getheader.php
*
* @param string $name
*
* @return mixed
*/
public function getHeader($name = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.clearheaders.php
*
*
* @return Yaf_Response_Abstract|false
*/
public function clearHeaders() {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.setredirect.php
*
* @param string $url
*
* @return bool
*/
public function setRedirect($url) {}
/**
* send response
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.response.php
*
* @return bool
*/
public function response() {}
}
class Yaf_Response_Cli extends Yaf_Response_Abstract
{
private function __clone() {}
/**
* @return string
*/
public function __toString() {}
}
/**
* @link https://secure.php.net/manual/en/class.yaf-request-http.php
*/
class Yaf_Request_Http extends Yaf_Request_Abstract
{
/**
* @link https://secure.php.net/manual/en/yaf-request-http.construct.php
*
* @param string $request_uri
* @param string $base_uri
*/
public function __construct($request_uri = '', $base_uri = '') {}
}
/**
* <b>Yaf_Request_Simple</b> is particularly used for test purpose. ie. simulate a spacial request under CLI mode.
* @link https://secure.php.net/manual/en/class.yaf-request-simple.php
*/
class Yaf_Request_Simple extends Yaf_Request_Abstract
{
/**
* Check the request whether it is a Ajax Request
*
* <br/>
* <b>Note:</b>
* <p>
* This method depends on the request header: HTTP_X_REQUESTED_WITH, some Javascript library doesn't set this header while doing Ajax request
* </p>
* @link https://secure.php.net/manual/en/yaf-request-simple.isxmlhttprequest.php
*
* @return bool
*/
public function isXmlHttpRequest() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-simple.construct.php
*
* @param string $method
* @param string $module
* @param string $controller
* @param string $action
* @param array $params
*
* @throws Yaf_Exception_TypeError
*/
public function __construct($method = '', $module = '', $controller = '', $action = '', $params = null) {}
}
/**
* <p>Yaf_Config_Ini enables developers to store configuration data in a familiar INI format and read them in the application by using nested object property syntax. The INI format is specialized to provide both the ability to have a hierarchy of configuration data keys and inheritance between configuration data sections. Configuration data hierarchies are supported by separating the keys with the dot or period character ("."). A section may extend or inherit from another section by following the section name with a colon character (":") and the name of the section from which data are to be inherited.</p><br/>
* <b>Note:</b>
* <p>Yaf_Config_Ini utilizes the » parse_ini_file() PHP function. Please review this documentation to be aware of its specific behaviors, which propagate to Yaf_Config_Ini, such as how the special values of "TRUE", "FALSE", "yes", "no", and "NULL" are handled.</p>
* @link https://secure.php.net/manual/en/class.yaf-config-ini.php
*/
class Yaf_Config_Ini extends Yaf_Config_Abstract implements Iterator, ArrayAccess, Countable
{
/**
* @param array|string $config_file
* @param ?string $section
* @throws Yaf_Exception_TypeError
*/
public function __construct($config_file, ?string $section = null) {}
/**
* @see Yaf_Config_Abstract::__get
* @param string $name
* @return mixed
*/
public function __get($name = null) {}
/**
* @see Yaf_Config_Abstract::__set
* @param mixed $name
* @param mixed $value
*/
public function __set($name, $value) {}
/**
* @see Yaf_Config_Abstract::get
* @param ?string $name
* @return mixed
*/
public function get(?string $name = null) {}
/**
* @see Yaf_Config_Abstract::set
* @param string $name
* @param mixed $value
*/
public function set(string $name, $value): bool {}
/**
* @see Yaf_Config_Abstract::toArray
* @return array
*/
public function toArray(): array {}
/**
* @see Yaf_Config_Abstract::readonly
* @return bool
*/
public function readonly(): bool {}
/**
* @see Yaf_Config_Abstract::__isset
* @param string $name
* @return bool
*/
public function __isset(string $name): bool {}
/**
* @see Yaf_Config_Abstract::count
* @return int
*/
public function count(): int {}
/**
* @see Yaf_Config_Abstract::rewind
* @return void
*/
public function rewind(): void {}
/**
* @see Yaf_Config_Abstract::current
* @return mixed
*/
public function current() {}
/**
* @see Yaf_Config_Abstract::next
* @return void
*/
public function next(): void {}
/**
* @see Yaf_Config_Abstract::valid
* @return bool
*/
public function valid(): bool {}
/**
* @see Yaf_Config_Abstract::key
* @return mixed
*/
public function key() {}
/**
* @see Yaf_Config_Abstract::offsetUnset
* @param mixed $name
* @return void
* @deprecated not_implemented
*/
public function offsetUnset($name): void {}
/**
* @see Yaf_Config_Abstract::offsetGet
* @param mixed $name
* @return mixed
*/
public function offsetGet($name) {}
/**
* @see Yaf_Config_Abstract::offsetExists
* @param mixed $name
* @return bool
*/
public function offsetExists($name): bool {}
/**
* @see Yaf_Config_Abstract::offsetSet
* @param mixed $offset
* @param mixed $value
* @return void
*/
public function offsetSet($offset, $value): void {}
}
/**
* @link https://secure.php.net/manual/en/class.yaf-config-simple.php
*/
class Yaf_Config_Simple extends Yaf_Config_Abstract implements Iterator, ArrayAccess, Countable
{
/**
* @param array|string $config_file
* @param ?string $section
* @throws Yaf_Exception_TypeError
*/
public function __construct($config_file, ?string $section = null) {}
/**
* @see Yaf_Config_Abstract::__get
* @param string $name
* @return mixed
*/
public function __get($name = null) {}
/**
* @see Yaf_Config_Abstract::__set
* @param mixed $name
* @param mixed $value
*/
public function __set($name, $value) {}
/**
* @see Yaf_Config_Abstract::get
* @param ?string $name
* @return mixed
*/
public function get(?string $name = null) {}
/**
* @see Yaf_Config_Abstract::set
* @param string $name
* @param mixed $value
*/
public function set(string $name, $value): bool {}
/**
* @see Yaf_Config_Abstract::toArray
* @return array
*/
public function toArray(): array {}
/**
* @see Yaf_Config_Abstract::readonly
* @return bool
*/
public function readonly(): bool {}
/**
* @see Yaf_Config_Abstract::__isset
* @param string $name
* @return bool
*/
public function __isset($name): bool {}
/**
* @see Yaf_Config_Abstract::count
* @return int
*/
public function count(): int {}
/**
* @see Yaf_Config_Abstract::rewind
* @return void
*/
public function rewind(): void {}
/**
* @see Yaf_Config_Abstract::current
* @return mixed
*/
public function current() {}
/**
* @see Yaf_Config_Abstract::next
* @return void
*/
public function next(): void {}
/**
* @see Yaf_Config_Abstract::valid
* @return bool
*/
public function valid(): bool {}
/**
* @see Yaf_Config_Abstract::key
* @return mixed
*/
public function key() {}
/**
* @see Yaf_Config_Abstract::offsetUnset
* @param mixed $name
* @return void
*/
public function offsetUnset($name): void {}
/**
* @see Yaf_Config_Abstract::offsetGet
* @param mixed $name
* @return mixed
*/
public function offsetGet($name) {}
/**
* @see Yaf_Config_Abstract::offsetExists
* @param mixed $name
* @return bool
*/
public function offsetExists($name): bool {}
/**
* @see Yaf_Config_Abstract::offsetSet
* @param mixed $offset
* @param mixed $value
* @return void
*/
public function offsetSet($offset, $value): void {}
}
/**
* <b>Yaf_View_Simple</b> is the built-in template engine in Yaf, it is a simple but fast template engine, and only support PHP script template.
* @link https://secure.php.net/manual/en/class.yaf-view-simple.php
*/
class Yaf_View_Simple implements Yaf_View_Interface
{
/**
* @var string
*/
protected $_tpl_dir;
/**
* @var array
*/
protected $_tpl_vars;
/**
* @var array
*/
protected $_options;
/**
* @link https://secure.php.net/manual/en/yaf-view-simple.construct.php
*
* @param string $template_dir The base directory of the templates, by default, it is APPLICATION . "/views" for Yaf.
* @param array|null $options <p>Options for the engine, as of Yaf 2.1.13, you can use short tag
* "<?=$var?>" in your template(regardless of "short_open_tag"),
* so comes a option named "short_tag", you can switch this off
* to prevent use short_tag in template.
* </p>
* @throws Yaf_Exception_TypeError
*/
final public function __construct($template_dir, ?array $options = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-view-simple.isset.php
*
* @param string $name
*/
public function __isset($name) {}
/**
* assign variable to view engine
*
* @link https://secure.php.net/manual/en/yaf-view-simple.assign.php
*
* @param string|array $name A string or an array.<br/>if is string, then the next argument $value is required.
* @param mixed $value mixed value
* @return Yaf_View_Interface|bool
*/
public function assign($name, $value = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-view-simple.render.php
*
* @param string $tpl
* @param array $tpl_vars
*
* @throws Yaf_Exception_LoadFailed_View
*
* @return string|bool
*/
public function render($tpl, $tpl_vars = null) {}
/**
* <p>Render a template and display the result instantly.</p>
*
* @link https://secure.php.net/manual/en/yaf-view-simple.display.php
*
* @param string $tpl
* @param array $tpl_vars
*
* @throws Yaf_Exception_LoadFailed_View
*
* @return bool
*/
public function display($tpl, $tpl_vars = null) {}
/**
* <p>unlike Yaf_View_Simple::assign(), this method assign a ref value to engine.</p>
* @link https://secure.php.net/manual/en/yaf-view-simple.assignref.php
*
* @param string $name A string name which will be used to access the value in the template.
* @param mixed &$value mixed value
*
* @return Yaf_View_Simple
*/
public function assignRef($name, &$value) {}
/**
* clear assigned variable
* @link https://secure.php.net/manual/en/yaf-view-simple.clear.php
*
* @param string $name assigned variable name. <br/>if empty, will clear all assigned variables.
*
* @return Yaf_View_Simple
*/
public function clear($name = null) {}
/**
* Set the templates base directory, this is usually called by Yaf_Dispatcher
*
* @link https://secure.php.net/manual/en/yaf-view-simple.setscriptpath.php
*
* @param string $template_dir An absolute path to the template directory, by default, Yaf_Dispatcher use application.directory . "/views" as this parameter.
* @return bool
*/
public function setScriptPath($template_dir) {}
/**
* @link https://secure.php.net/manual/en/yaf-view-simple.getscriptpath.php
*
* @return string
*/
public function getScriptPath() {}
/**
* <p>Retrieve assigned variable</p>
* <br/>
* <b>Note:</b>
* <p>$name parameter can be empty since 2.1.11</p>
* @link https://secure.php.net/manual/en/yaf-view-simple.get.php
*
* @param string $name <p>the assigned variable name</p>
* <br/>
* <p>if this is empty, all assigned variables will be returned</p>
*
* @return mixed
*/
public function __get($name = null) {}
/**
* <p>This is a alternative and easier way to Yaf_View_Simple::assign().</p>
*
* @link https://secure.php.net/manual/en/yaf-view-simple.set.php
*
* @param string $name A string value name.
* @param mixed $value mixed value
*/
public function __set($name, $value = null) {}
/**
* <p>Render a string template and return the result.</p>
* @link https://secure.php.net/manual/en/yaf-view-simple.eval.php
* @param string $tpl_str string template
* @param array $vars
* @return void|false return FALSE on failure
*/
public function eval($tpl_str, $vars = null) {}
/**
* @param string $name
* @return mixed
*/
public function get($name = '') {}
}
/**
* <p>by default, Yaf_Router only have a <b>Yaf_Route_Static</b> as its default route.</p>
* <br/>
* <p><b>Yaf_Route_Static</b> is designed to handle 80% of normal requirements.</p>
* <br/>
* <b>Note:</b>
* <p> it is unnecessary to instance a <b>Yaf_Route_Static</b>, also unnecessary to add it into Yaf_Router's routes stack, since there is always be one in Yaf_Router's routes stack, and always be called at the last time.</p>
*
* @link https://secure.php.net/manual/en/class.yaf-route-static.php
*/
class Yaf_Route_Static implements Yaf_Route_Interface
{
/**
* @param string $uri
*
* @return bool
* @deprecated not_implemented
* @link https://secure.php.net/manual/en/yaf-route-static.match.php
*/
public function match($uri) {}
/**
* @link https://secure.php.net/manual/en/yaf-route-static.route.php
*
* @param Yaf_Request_Abstract $request
*
* @return bool always TRUE
*/
public function route($request) {}
/**
* <p><b>Yaf_Route_Static::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-static.assemble.php
*
* @param array $info
* @param array|null $query
* @return bool
*/
public function assemble(array $info, ?array $query = null) {}
}
/**
* <p><b>Yaf_Route_Simple</b> will match the query string, and find the route info.</p>
* <br/>
* <p>all you need to do is tell <b>Yaf_Route_Simple</b> what key in the $_GET is module, what key is controller, and what key is action.</p>
* <br/>
* <p>Yaf_Route_Simple::route() will always return TRUE, so it is important put <b>Yaf_Route_Simple</b> in the front of the Route stack, otherwise all the other routes will not be called</p>
*
* @link https://secure.php.net/manual/en/class.yaf-route-simple.php
*/
final class Yaf_Route_Simple implements Yaf_Route_Interface
{
/**
* @var string
*/
protected $controller;
/**
* @var string
*/
protected $module;
/**
* @var string
*/
protected $action;
/**
* <p>Yaf_Route_Simple will get route info from query string. and the parameters of this constructor will used as keys while searching for the route info in $_GET.</p>
*
* @link https://secure.php.net/manual/en/yaf-route-simple.construct.php
*
* @param string $module_name
* @param string $controller_name
* @param string $action_name
*
* @throws Yaf_Exception_TypeError
*/
public function __construct($module_name, $controller_name, $action_name) {}
/**
* <p>see Yaf_Route_Simple::__construct()</p>
*
* @link https://secure.php.net/manual/en/yaf-route-simple.route.php
*
* @param Yaf_Request_Abstract $request
*
* @return bool always TRUE
*/
public function route($request) {}
/**
* <p><b>Yaf_Route_Simple::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-simple.assemble.php
*
* @param array $info
* @param array|null $query
* @return bool
*/
public function assemble(array $info, ?array $query = null) {}
}
/**
* @link https://secure.php.net/manual/en/class.yaf-route-supervar.php
*/
final class Yaf_Route_Supervar implements Yaf_Route_Interface
{
/**
* @var string
*/
protected $_var_name;
/**
* <p>Yaf_Route_Supervar is similar to Yaf_Route_Static, the difference is that Yaf_Route_Supervar will look for path info in query string, and the parameter supervar_name is the key.</p>
*
* @link https://secure.php.net/manual/en/yaf-route-supervar.construct.php
*
* @param string $supervar_name The name of key.
*
* @throws Yaf_Exception_TypeError
*/
public function __construct($supervar_name) {}
/**
* @link https://secure.php.net/manual/en/yaf-route-supervar.route.php
*
* @param Yaf_Request_Abstract $request
*
* @return bool If there is a key(which was defined in Yaf_Route_Supervar::__construct()) in $_GET, return TRUE. otherwise return FALSE.
*/
public function route($request) {}
/**
* <p><b>Yaf_Route_Supervar::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-supervar.assemble.php
*
* @param array $info
* @param array|null $query
* @return bool
*/
public function assemble(array $info, ?array $query = null) {}
}
/**
* <p>For usage, please see the example section of Yaf_Route_Rewrite::__construct()</p>
*
* @link https://secure.php.net/manual/en/class.yaf-route-rewrite.php
*/
final class Yaf_Route_Rewrite extends Yaf_Router implements Yaf_Route_Interface
{
/**
* @var string
*/
protected $_route;
/**
* @var array
*/
protected $_default;
/**
* @var array
*/
protected $_verify;
/**
* @link https://secure.php.net/manual/en/yaf-route-rewrite.construct.php
*
* @param string $match A pattern, will be used to match a request uri, if doesn't matched, Yaf_Route_Rewrite will return FALSE.
* @param array $route <p>When the match pattern matches the request uri, Yaf_Route_Rewrite will use this to decide which m/c/a to routed.</p>
* <br/>
* <p>either of m/c/a in this array is optional, if you don't assign a specific value, it will be routed to default.</p>
* @param array|null $verify
* @param string|null $reverse
*
* @throws Yaf_Exception_TypeError
*/
public function __construct($match, array $route, array $verify = null, $reverse = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-route-rewrite.route.php
*
* @param Yaf_Request_Abstract $request
*
* @return bool
*/
public function route($request) {}
/**
* <p><b>Yaf_Route_Rewrite::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-rewrite.assemble.php
*
* @param array $info
* @param array|null $query
* @return bool
*/
public function assemble(array $info, ?array $query = null) {}
/**
* @param string $uri
* @return bool
*/
public function match($uri) {}
}
/**
* <p><b>Yaf_Route_Regex</b> is the most flexible route among the Yaf built-in routes.</p>
*
* @link https://secure.php.net/manual/en/class.yaf-route-regex.php
*/
final class Yaf_Route_Regex extends Yaf_Router implements Yaf_Route_Interface
{
/**
* @var string
*/
protected $_route;
/**
* @var array
*/
protected $_default;
/**
* @var array
*/
protected $_maps;
/**
* @var array
*/
protected $_verify;
/**
* @var string
*/
protected $_reverse;
/**
* @link https://secure.php.net/manual/en/yaf-route-regex.construct.php
*
* @param string $match A complete Regex pattern, will be used to match a request uri, if doesn't matched, Yaf_Route_Regex will return FALSE.
* @param array $route <p>When the match pattern matches the request uri, Yaf_Route_Regex will use this to decide which m/c/a to routed.</p>
* <br/>
* <p>either of m/c/a in this array is optional, if you don't assign a specific value, it will be routed to default.</p>
* @param array|null $map A array to assign name to the captures in the match result.
* @param array|null $verify
* @param string $reverse
*
* @throws Yaf_Exception_TypeError
*/
public function __construct($match, array $route, ?array $map = null, ?array $verify = null, $reverse = null) {}
/**
* Route a incoming request.
*
* @link https://secure.php.net/manual/en/yaf-route-regex.route.php
*
* @param Yaf_Request_Abstract $request
*
* @return bool If the pattern given by the first parameter of Yaf_Route_Regex::_construct() matches the request uri, return TRUE, otherwise return FALSE.
*/
public function route($request) {}
/**
* <p><b>Yaf_Route_Regex::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-regex.assemble.php
*
* @param array $info
* @param array|null $query
* @return bool
*/
public function assemble(array $info, array $query = null) {}
/**
* @param string $uri
* @return bool
*/
public function match($uri) {}
}
/**
* <p><b>Yaf_Route_Map</b> is a built-in route, it simply convert a URI endpoint (that part of the URI which comes after the base URI: see Yaf_Request_Abstract::setBaseUri()) to a controller name or action name(depends on the parameter passed to Yaf_Route_Map::__construct()) in following rule: A => controller A. A/B/C => controller A_B_C. A/B/C/D/E => controller A_B_C_D_E.</p>
* <br/>
* <p>If the second parameter of Yaf_Route_Map::__construct() is specified, then only the part before delimiter of URI will used to routing, the part after it is used to routing request parameters (see the example section of Yaf_Route_Map::__construct()).</p>
*
* @link https://secure.php.net/manual/en/class.yaf-route-map.php
*/
final class Yaf_Route_Map implements Yaf_Route_Interface
{
/**
* @var string
*/
protected $_ctl_router = '';
/**
* @var string
*/
protected $_delimiter;
/**
* @link https://secure.php.net/manual/en/yaf-route-map.construct.php
*
* @param bool $controller_prefer Whether the result should considering as controller or action
* @param string $delimiter
*/
public function __construct($controller_prefer = false, $delimiter = '') {}
/**
* @link https://secure.php.net/manual/en/yaf-route-map.route.php
*
* @param Yaf_Request_Abstract $request
*
* @return bool
*/
public function route($request) {}
/**
* <p><b>Yaf_Route_Map::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-map.assemble.php
*
* @param array $info
* @param array|null $query
* @return bool
*/
public function assemble(array $info, ?array $query = null) {}
}
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-typeerror.php
*/
class Yaf_Exception_TypeError extends Yaf_Exception {}
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-startuperror.php
*/
class Yaf_Exception_StartupError extends Yaf_Exception {}
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-routefaild.php
*/
class Yaf_Exception_RouterFailed extends Yaf_Exception {}
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-dispatchfaild.php
*/
class Yaf_Exception_DispatchFailed extends Yaf_Exception {}
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-loadfaild.php
*/
class Yaf_Exception_LoadFailed extends Yaf_Exception {}
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-loadfaild-module.php
*/
class Yaf_Exception_LoadFailed_Module extends Yaf_Exception_LoadFailed {}
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-loadfaild-controller.php
*/
class Yaf_Exception_LoadFailed_Controller extends Yaf_Exception_LoadFailed {}
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-loadfaild-action.php
*/
class Yaf_Exception_LoadFailed_Action extends Yaf_Exception_LoadFailed {}
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-loadfaild-view.php
*/
class Yaf_Exception_LoadFailed_View extends Yaf_Exception_LoadFailed {}
<?php
namespace {
define('YAF\VERSION', '3.0.8', true);
define('YAF\ENVIRON', 'product', true);
define('YAF\ERR\STARTUP\FAILED', 512, true);
define('YAF\ERR\ROUTE\FAILED', 513, true);
define('YAF\ERR\DISPATCH\FAILED', 514, true);
define('YAF\ERR\NOTFOUND\MODULE', 515, true);
define('YAF\ERR\NOTFOUND\CONTROLLER', 516, true);
define('YAF\ERR\NOTFOUND\ACTION', 517, true);
define('YAF\ERR\NOTFOUND\VIEW', 518, true);
define('YAF\ERR\CALL\FAILED', 519, true);
define('YAF\ERR\AUTOLOAD\FAILED', 520, true);
define('YAF\ERR\TYPE\ERROR', 521, true);
}
namespace Yaf {
use Yaf;
/**
* \Yaf\Application provides a bootstrapping facility for applications which provides reusable resources, common- and module-based bootstrap classes and dependency checking.
* <br/>
* <b>Note:</b>
* <p>
* \Yaf\Application implements the singleton pattern, and \Yaf\Application can not be serialized or un-serialized which will cause problem when you try to use PHPUnit to write some test case for Yaf.<br/>
* You may use @backupGlobals annotation of PHPUnit to control the backup and restore operations for global variables. thus can solve this problem.
* </p>
* @link https://secure.php.net/manual/en/class.yaf-application.php
*/
final class Application
{
/**
* @var \Yaf\Application
*/
protected static $_app;
/**
* @var \Yaf\Config_Abstract
*/
protected $config;
/**
* @var \Yaf\Dispatcher
*/
protected $dispatcher;
/**
* @var array
*/
protected $_modules;
/**
* @var string
*/
protected $_running = "";
/**
* @var string
*/
protected $_environ = YAF_ENVIRON;
/**
* @since 2.1.2
* @var int
*/
protected $_err_no = 0;
/**
* @since 2.1.2
* @var string
*/
protected $_err_msg = "";
/**
* @link https://secure.php.net/manual/en/yaf-application.construct.php
*
* @param string|array $config A ini config file path, or a config array
* <p>
* If is a ini config file, there should be a section named as the one defined by yaf.environ, which is "product" by default.
* </p>
* <br/>
* <b>Note:</b>
* <p>If you use a ini configuration file as your application's config container. you would open the yaf.cache_config to improve performance.</p>
* <p>And the config entry(and there default value) list blow:</p>
*
* <p>
* <b>Example #1 A ini config file example</b><br/>
* [product]<br/>
* ;this one should always be defined, and have no default value<br/>
* application.directory=APPLICATION_PATH<br/><br/>
* </p>
* <p>
* ;following configs have default value, you may no need to define them
* <br/>
* application.library = APPLICATION_PATH . "/library" <br/>
* application.dispatcher.throwException=1 <br/>
* application.dispatcher.catchException=1 <br/><br/>
* </p>
* <p>application.baseUri=""<br/><br/></p>
* <p>
* ;the php script ext name<br/>
* ap.ext=php<br/><br/>
* </p>
* <p>
* ;the view template ext name<br/>
* ap.view.ext=phtml<br/><br/>
* </p>
* <p>
* ap.dispatcher.defaultModule=Index<br/>
* ap.dispatcher.defaultController=Index<br/>
* ap.dispatcher.defaultAction=index<br/><br/>
* </p>
* <p>
* ;defined modules<br/>
* ap.modules=Index
* </p>
* @param string $envrion Which section will be loaded as the final config
*
* @throws \Yaf\Exception\TypeError|\Yaf\Exception\StartupError
*/
public function __construct($config, $envrion = null) {}
/**
* Run a \Yaf\Application, let the \Yaf\Application accept a request, and route the request, dispatch to controller/action, and render response.
* return response to client finally.
*
* @link https://secure.php.net/manual/en/yaf-application.run.php
* @throws \Yaf\Exception\StartupError
*/
public function run() {}
/**
* This method is typically used to run \Yaf\Application in a crontab work.
* Make the crontab work can also use the autoloader and Bootstrap mechanism.
*
* @link https://secure.php.net/manual/en/yaf-application.execute.php
*
* @param callable $entry a valid callback
* @param string ...$_ parameters will pass to the callback
*/
public function execute(callable $entry, ...$_) {}
/**
* Retrieve the \Yaf\Application instance, alternatively, we also could use \Yaf\Dispatcher::getApplication().
*
* @link https://secure.php.net/manual/en/yaf-application.app.php
*
* @return \Yaf\Application|null an \Yaf\Application instance, if no \Yaf\Application initialized before, NULL will be returned.
*/
public static function app() {}
/**
* Retrieve environ which was defined in yaf.environ which has a default value "product".
*
* @link https://secure.php.net/manual/en/yaf-application.environ.php
*
* @return string
*/
public function environ() {}
/**
* Run a Bootstrap, all the methods defined in the Bootstrap and named with prefix "_init" will be called according to their declaration order, if the parameter bootstrap is not supplied, Yaf will look for a Bootstrap under application.directory.
*
* @link https://secure.php.net/manual/en/yaf-application.bootstrap.php
*
* @param \Yaf\Bootstrap_Abstract $bootstrap A \Yaf\Bootstrap_Abstract instance
* @return \Yaf\Application
*/
public function bootstrap(Bootstrap_Abstract $bootstrap = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-application.getconfig.php
*
* @return \Yaf\Config_Abstract
*/
public function getConfig() {}
/**
* Get the modules list defined in config, if no one defined, there will always be a module named "Index".
*
* @link https://secure.php.net/manual/en/yaf-application.getmodules.php
*
* @return array
*/
public function getModules() {}
/**
* @link https://secure.php.net/manual/en/yaf-application.getdispatcher.php
*
* @return \Yaf\Dispatcher
*/
public function getDispatcher() {}
/**
* Change the application directory
*
* @since 2.1.4
* @link https://secure.php.net/manual/en/yaf-application.setappdirectory.php
*
* @param string $directory
* @return \Yaf\Application
*/
public function setAppDirectory($directory) {}
/**
* @since 2.1.4
* @link https://secure.php.net/manual/en/yaf-application.getappdirectory.php
*
* @return string
*/
public function getAppDirectory() {}
/**
* @since 2.1.2
* @link https://secure.php.net/manual/en/yaf-application.getlasterrorno.php
*
* @return int
*/
public function getLastErrorNo() {}
/**
* @since 2.1.2
* @link https://secure.php.net/manual/en/yaf-application.getlasterrormsg.php
*
* @return string
*/
public function getLastErrorMsg() {}
/**
* @since 2.1.2
* @link https://secure.php.net/manual/en/yaf-application.clearlasterror.php
*/
public function clearLastError() {}
/**
* @link https://secure.php.net/manual/en/yaf-application.destruct.php
*/
public function __destruct() {}
/**
* @link https://secure.php.net/manual/en/yaf-application.clone.php
*/
private function __clone() {}
/**
* @link https://secure.php.net/manual/en/yaf-application.sleep.php
*/
private function __sleep() {}
/**
* @link https://secure.php.net/manual/en/yaf-application.wakeup.php
*/
private function __wakeup() {}
}/**
* <p><b>\Yaf\Dispatcher</b> purpose is to initialize the request environment, route the incoming request, and then dispatch any discovered actions; it aggregates any responses and returns them when the process is complete.</p><br/>
* <p><b>\Yaf\Dispatcher</b> also implements the Singleton pattern, meaning only a single instance of it may be available at any given time. This allows it to also act as a registry on which the other objects in the dispatch process may draw.</p>
*
* @link https://secure.php.net/manual/en/class.yaf-dispatcher.php
*/
final class Dispatcher
{
/**
* @var \Yaf\Dispatcher
*/
protected static $_instance;
/**
* @var \Yaf\Router
*/
protected $_router;
/**
* @var \Yaf\View_Interface
*/
protected $_view;
/**
* @var \Yaf\Request_Abstract
*/
protected $_request;
/**
* @var \Yaf\Plugin_Abstract
*/
protected $_plugins;
/**
* @var bool
*/
protected $_auto_render = true;
/**
* @var string
*/
protected $_return_response = "";
/**
* @var string
*/
protected $_instantly_flush = "";
/**
* @var string
*/
protected $_default_module;
/**
* @var string
*/
protected $_default_controller;
/**
* @var string
*/
protected $_default_action;
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.construct.php
*/
private function __construct() {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.clone.php
*/
private function __clone() {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.sleep.php
*/
private function __sleep() {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.wakeup.php
*/
private function __wakeup() {}
/**
* enable view rendering
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.enableview.php
*
* @return \Yaf\Dispatcher
*/
public function enableView() {}
/**
* <p>disable view engine, used in some app that user will output by himself</p><br/>
* <b>Note:</b>
* <p>you can simply return FALSE in a action to prevent the auto-rendering of that action</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.disableview.php
*
* @return bool
*/
public function disableView() {}
/**
* Initialize view and return it
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.initview.php
*
* @param string $templates_dir
* @param array $options
* @return \Yaf\View_Interface
*/
public function initView($templates_dir, array $options = null) {}
/**
* This method provides a solution for that if you want use a custom view engine instead of \Yaf\View\Simple
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.setview.php
*
* @param \Yaf\View_Interface $view A \Yaf\View_Interface instance
* @return \Yaf\Dispatcher
*/
public function setView(View_Interface $view) {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.setrequest.php
*
* @param \Yaf\Request_Abstract $request
* @return \Yaf\Dispatcher
*/
public function setRequest(Request_Abstract $request) {}
/**
* Retrieve the \Yaf\Application instance. same as \Yaf\Application::app().
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.getapplication.php
* @return \Yaf\Application
*/
public function getApplication() {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.getrouter.php
*
* @return \Yaf\Router
*/
public function getRouter() {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.getrequest.php
*
* @return \Yaf\Request_Abstract
*/
public function getRequest() {}
/**
* <p>Set error handler for Yaf. when application.dispatcher.throwException is off, Yaf will trigger catch-able error while unexpected errors occurred.</p><br/>
* <p>Thus, this error handler will be called while the error raise.</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.seterrorhandler.php
*
* @param callable $callback a callable callback
* @param int $error_types YAF_ERR_* constants mask
*
* @return \Yaf\Dispatcher
*/
public function setErrorHandler(callable $callback, $error_types) {}
/**
* Change default module name
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.setdefaultmodule.php
*
* @param string $module
* @return \Yaf\Dispatcher
*/
public function setDefaultModule($module) {}
/**
* Change default controller name
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.setdefaultcontroller.php
*
* @param string $controller
* @return \Yaf\Dispatcher
*/
public function setDefaultController($controller) {}
/**
* Change default action name
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.setdefaultaction.php
*
* @param string $action
* @return \Yaf\Dispatcher
*/
public function setDefaultAction($action) {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.returnresponse.php
*
* @param bool $flag
* @return \Yaf\Dispatcher
*/
public function returnResponse($flag) {}
/**
* <p>\Yaf\Dispatcher will render automatically after dispatches an incoming request, you can prevent the rendering by calling this method with $flag TRUE</p><br/>
* <b>Note:</b>
* <p>you can simply return FALSE in a action to prevent the auto-rendering of that action</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.autorender.php
*
* @param bool $flag since 2.2.0, if this parameter is not given, then the current state will be set
* @return \Yaf\Dispatcher
*/
public function autoRender($flag = null) {}
/**
* Switch on/off the instant flushing
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.flushinstantly.php
*
* @param bool $flag since 2.2.0, if this parameter is not given, then the current state will be set
* @return \Yaf\Dispatcher
*/
public function flushInstantly($flag = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-dispatcher.getinstance.php
*
* @return \Yaf\Dispatcher
*/
public static function getInstance() {}
/**
* <p>This method does the heavy work of the \Yaf\Dispatcher. It take a request object.</p><br/>
* <p>The dispatch process has three distinct events:</p>
* <ul>
* <li>Routing</li>
* <li>Dispatching</li>
* <li>Response</li>
* </ul>
* <p>Routing takes place exactly once, using the values in the request object when dispatch() is called. Dispatching takes place in a loop; a request may either indicate multiple actions to dispatch, or the controller or a plugin may reset the request object to force additional actions to dispatch(see \Yaf\Plugin_Abstract. When all is done, the \Yaf\Dispatcher returns a response.</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.dispatch.php
*
* @param \Yaf\Request_Abstract $request
*
* @throws \Yaf\Exception\TypeError
* @throws \Yaf\Exception\RouterFailed
* @throws \Yaf\Exception\DispatchFailed
* @throws \Yaf\Exception\LoadFailed
* @throws \Yaf\Exception\LoadFailed\Action
* @throws \Yaf\Exception\LoadFailed\Controller
*
* @return \Yaf\Response_Abstract
*/
public function dispatch(Request_Abstract $request) {}
/**
* <p>Switch on/off exception throwing while unexpected error occurring. When this is on, Yaf will throwing exceptions instead of triggering catchable errors.</p><br/>
* <p>You can also use application.dispatcher.throwException to achieve the same purpose.</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.throwexception.php
*
* @param bool $flag
* @return \Yaf\Dispatcher
*/
public function throwException($flag = null) {}
/**
* <p>While the application.dispatcher.throwException is On(you can also calling to <b>\Yaf\Dispatcher::throwException(TRUE)</b> to enable it), Yaf will throw \Exception whe error occurs instead of trigger error.</p><br/>
* <p>then if you enable <b>\Yaf\Dispatcher::catchException()</b>(also can enabled by set application.dispatcher.catchException), all uncaught \Exceptions will be caught by ErrorController::error if you have defined one.</p>
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.catchexception.php
*
* @param bool $flag
* @return \Yaf\Dispatcher
*/
public function catchException($flag = null) {}
/**
* Register a plugin(see \Yaf\Plugin_Abstract). Generally, we register plugins in Bootstrap(see \Yaf\Bootstrap_Abstract).
*
* @link https://secure.php.net/manual/en/yaf-dispatcher.registerplugin.php
*
* @param \Yaf\Plugin_Abstract $plugin
* @return \Yaf\Dispatcher
*/
public function registerPlugin(Plugin_Abstract $plugin) {}
}/**
* <p><b>\Yaf\Loader</b> introduces a comprehensive autoloading solution for Yaf.</p>
* <br/>
* <p>The first time an instance of \Yaf\Application is retrieved, <b>\Yaf\Loader</b> will instance a singleton, and registers itself with spl_autoload. You retrieve an instance using the \Yaf\Loader::getInstance()</p>
* <br/>
* <p><b>\Yaf\Loader</b> attempt to load a class only one shot, if failed, depend on yaf.use_spl_autoload, if this config is On \Yaf\Loader::autoload() will return FALSE, thus give the chance to other autoload function. if it is Off (by default), \Yaf\Loader::autoload() will return TRUE, and more important is that a very useful warning will be triggered (very useful to find out why a class could not be loaded).</p>
* <br/>
* <b>Note:</b>
* <p>Please keep yaf.use_spl_autoload Off unless there is some library have their own autoload mechanism and impossible to rewrite it.</p>
* <br/>
* <p>If you want <b>\Yaf\Loader</b> search some classes(libraries) in the local class directory(which is defined in application.ini, and by default, it is application.directory . "/library"), you should register the class prefix using the \Yaf\Loader::registerLocalNameSpace()</p>
* @link https://secure.php.net/manual/en/class.yaf-loader.php
*/
class Loader
{
/**
* @var string
*/
protected $_local_ns;
/**
* By default, this value is application.directory . "/library", you can change this either in the application.ini(application.library) or call to \Yaf\Loader::setLibraryPath()
* @var string
*/
protected $_library;
/**
* @var string
*/
protected $_global_library;
/**
* @var \Yaf\Loader
*/
protected static $_instance;
/**
* @link https://secure.php.net/manual/en/yaf-loader.construct.php
*/
private function __construct() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.clone.php
*/
private function __clone() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.sleep.php
*/
private function __sleep() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.wakeup.php
*/
private function __wakeup() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.autoload.php
*
* @param string $class_name
*
* @return bool
*/
public function autoload($class_name) {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.getinstance.php
*
* @param string $local_library_path
* @param string $global_library_path
*
* @return \Yaf\Loader
*/
public static function getInstance($local_library_path = null, $global_library_path = null) {}
/**
* <p>Register local class prefix name, \Yaf\Loader search classes in two library directories, the one is configured via application.library.directory(in application.ini) which is called local library directory; the other is configured via yaf.library (in php.ini) which is called global library directory, since it can be shared by many applications in the same server.</p>
* <br/>
* <p>When an autoloading is triggered, \Yaf\Loader will determine which library directory should be searched in by examining the prefix name of the missed classname. If the prefix name is registered as a local namespace then look for it in local library directory, otherwise look for it in global library directory.</p>
* <br/>
* <b>Note:</b>
* <p>If yaf.library is not configured, then the global library directory is assumed to be the local library directory. in that case, all autoloading will look for local library directory. But if you want your Yaf application be strong, then always register your own classes as local classes.</p>
* @link https://secure.php.net/manual/en/yaf-loader.registerlocalnamespace.php
*
* @param string|string[] $name_prefix a string or a array of class name prefix. all class prefix with these prefix will be loaded in local library path.
*
* @return bool
*/
public function registerLocalNamespace($name_prefix) {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.getlocalnamespace.php
*
* @return string
*/
public function getLocalNamespace() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.clearlocalnamespace.php
*/
public function clearLocalNamespace() {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.islocalname.php
*
* @param string $class_name
*
* @return bool
*/
public function isLocalName($class_name) {}
/**
* @link https://secure.php.net/manual/en/yaf-loader.import.php
*
* @param string $file
*
* @return bool
*/
public static function import($file) {}
/**
* @since 2.1.4
* @link https://secure.php.net/manual/en/yaf-loader.setlibrarypath.php
*
* @param string $directory
* @param bool $global
*
* @return \Yaf\Loader
*/
public function setLibraryPath($directory, $global = false) {}
/**
* @since 2.1.4
* @link https://secure.php.net/manual/en/yaf-loader.getlibrarypath.php
*
* @param bool $is_global
*
* @return string
*/
public function getLibraryPath($is_global = false) {}
}/**
* <p>All methods of <b>\Yaf\Registry</b> declared as static, making it universally accessible. This provides the ability to get or set any custom data from anyway in your code as necessary.</p>
* @link https://secure.php.net/manual/en/class.yaf-registry.php
*/
final class Registry
{
/**
* @var \Yaf\Registry
*/
protected static $_instance;
/**
* @var array
*/
protected $_entries;
/**
* @link https://secure.php.net/manual/en/yaf-registry.construct.php
*/
private function __construct() {}
/**
* @link https://secure.php.net/manual/en/yaf-registry.clone.php
*/
private function __clone() {}
/**
* Retrieve an item from registry
*
* @link https://secure.php.net/manual/en/yaf-registry.get.php
*
* @param string $name
*
* @return mixed
*/
public static function get($name) {}
/**
* Check whether an item exists
*
* @link https://secure.php.net/manual/en/yaf-registry.has.php
*
* @param string $name
*
* @return bool
*/
public static function has($name) {}
/**
* @link https://secure.php.net/manual/en/yaf-registry.set.php
*
* @param string $name
* @param mixed $value
*
* @return bool
*/
public static function set($name, $value) {}
/**
* @link https://secure.php.net/manual/en/yaf-registry.del.php
*
* @param string $name
*
* @return void|bool
*/
public static function del($name) {}
}/**
* @link https://secure.php.net/manual/en/class.yaf-session.php
* @version 2.2.9
*/
final class Session implements \Iterator, \Traversable, \ArrayAccess, \Countable
{
/**
* @var \Yaf\Session
*/
protected static $_instance;
/**
* @var array
*/
protected $_session;
/**
* @var bool
*/
protected $_started = true;
/**
* @link https://secure.php.net/manual/en/yaf-session.construct.php
*/
private function __construct() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.clone.php
*/
private function __clone() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.sleep.php
*/
private function __sleep() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.wakeup.php
*/
private function __wakeup() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.getinstance.php
*
* @return \Yaf\Session
*/
public static function getInstance() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.start.php
*
* @return \Yaf\Session
*/
public function start() {}
/**
* @link https://secure.php.net/manual/en/yaf-session.get.php
*
* @param string $name
*
* @return mixed
*/
public function get($name) {}
/**
* @link https://secure.php.net/manual/en/yaf-session.has.php
*
* @param string $name
*
* @return bool
*/
public function has($name) {}
/**
* @link https://secure.php.net/manual/en/yaf-session.set.php
*
* @param string $name
* @param mixed $value
*
* @return \Yaf\Session|false return FALSE on failure
*/
public function set($name, $value) {}
/**
* @link https://secure.php.net/manual/en/yaf-session.del.php
*
* @param string $name
*
* @return \Yaf\Session|false return FALSE on failure
*/
public function del($name) {}
/**
* @see \Countable::count
*/
public function count() {}
/**
* @see \Iterator::rewind
*/
public function rewind() {}
/**
* @see \Iterator::current
*/
public function current() {}
/**
* @see \Iterator::next
*/
public function next() {}
/**
* @see \Iterator::valid
*/
public function valid() {}
/**
* @see \Iterator::key
*/
public function key() {}
/**
* @see \ArrayAccess::offsetUnset
*/
public function offsetUnset($name) {}
/**
* @see \ArrayAccess::offsetGet
*/
public function offsetGet($name) {}
/**
* @see \ArrayAccess::offsetExists
*/
public function offsetExists($name) {}
/**
* @see \ArrayAccess::offsetSet
*/
public function offsetSet($name, $value) {}
/**
* @see \Yaf\Session::get()
*/
public function __get($name) {}
/**
* @see \Yaf\Session::has()
*/
public function __isset($name) {}
/**
* @see \Yaf\Session::set()
*/
public function __set($name, $value) {}
/**
* @see \Yaf\Session::del()
*/
public function __unset($name) {}
}/**
* <p><b>\Yaf\Router</b> is the standard framework router. Routing is the process of taking a URI endpoint (that part of the URI which comes after the base URI: see \Yaf\Request_Abstract::setBaseUri()) and decomposing it into parameters to determine which module, controller, and action of that controller should receive the request. This values of the module, controller, action and other parameters are packaged into a \Yaf\Request_Abstract object which is then processed by \Yaf\Dispatcher. Routing occurs only once: when the request is initially received and before the first controller is dispatched. \Yaf\Router is designed to allow for mod_rewrite-like functionality using pure PHP structures. It is very loosely based on Ruby on Rails routing and does not require any prior knowledge of webserver URL rewriting</p>
* <br/>
* <b>Default Route</b>
* <br/>
* <p><b>\Yaf\Router</b> comes pre-configured with a default route \Yaf\Route_Static, which will match URIs in the shape of controller/action. Additionally, a module name may be specified as the first path element, allowing URIs of the form module/controller/action. Finally, it will also match any additional parameters appended to the URI by default - controller/action/var1/value1/var2/value2.</p>
* <br/>
* <b>Note:</b>
* <p>Module name must be defined in config, considering application.module="Index,Foo,Bar", in this case, only index, foo and bar can be considered as a module name. if doesn't config, there is only one module named "Index".</p>
* <br/>
* <p>** See examples by opening the external documentation</p>
* @link https://secure.php.net/manual/en/class.yaf-router.php
*/
class Router
{
/**
* @var \Yaf\Route_Interface[] registered routes stack
*/
protected $_routes;
/**
* @var string after routing phase, this indicated the name of which route is used to route current request. you can get this name by \Yaf\Router::getCurrentRoute()
*/
protected $_current;
/**
* @link https://secure.php.net/manual/en/yaf-router.construct.php
*/
public function __construct() {}
/**
* <p>by default, \Yaf\Router using a \Yaf\Route_Static as its default route. you can add new routes into router's route stack by calling this method.</p>
* <br/>
* <p>the newer route will be called before the older(route stack), and if the newer router return TRUE, the router process will be end. otherwise, the older one will be called.</p>
*
* @link https://secure.php.net/manual/en/yaf-router.addroute.php
*
* @param string $name
* @param \Yaf\Route_Interface $route
*
* @return \Yaf\Router|false return FALSE on failure
*/
public function addRoute($name, Route_Interface $route) {}
/**
* <p>Add routes defined by configs into \Yaf\Router's route stack</p>
*
* @link https://secure.php.net/manual/en/yaf-router.addconfig.php
*
* @param \Yaf\Config_Abstract $config
*
* @return \Yaf\Router|false return FALSE on failure
*/
public function addConfig(Config_Abstract $config) {}
/**
* @link https://secure.php.net/manual/en/yaf-router.route.php
*
* @param \Yaf\Request_Abstract $request
*
* @return \Yaf\Router|false return FALSE on failure
*/
public function route(Request_Abstract $request) {}
/**
* <p>Retrieve a route by name, see also \Yaf\Router::getCurrentRoute()</p>
*
* @link https://secure.php.net/manual/en/yaf-router.getroute.php
*
* @param string $name
*
* @return \Yaf\Route_Interface
*/
public function getRoute($name) {}
/**
* @link https://secure.php.net/manual/en/yaf-router.getroutes.php
*
* @return \Yaf\Route_Interface[]
*/
public function getRoutes() {}
/**
* <p>Get the name of the route which is effective in the route process.</p>
* <br/>
* <b>Note:</b>
* <p>You should call this method after the route process finished, since before that, this method will always return NULL.</p>
*
* @link https://secure.php.net/manual/en/yaf-router.getcurrentroute.php
*
* @return string the name of the effective route.
*/
public function getCurrentRoute() {}
}/**
* <p>Bootstrap is a mechanism used to do some initial config before a Application run.<br/><br/></p>
* <p>User may define their own Bootstrap class by inheriting <b>\Yaf\Bootstrap_Abstract</b><br/><br/></p>
* <p>Any method declared in Bootstrap class with leading "_init", will be called by \Yaf\Application::bootstrap() one by one according to their defined order<br/><br/></p>
*
* @link https://secure.php.net/manual/en/class.yaf-bootstrap-abstract.php
*/
abstract class Bootstrap_Abstract {}/**
* <p><b>\Yaf\Controller_Abstract</b> is the heart of Yaf's system. MVC stands for Model-View-Controller and is a design pattern targeted at separating application logic from display logic.</p>
* <br/>
* <p>Every custom controller shall inherit <b>\Yaf\Controller_Abstract</b>.</p>
* <br/>
* <p>You will find that you can not define __construct function for your custom controller, thus, <b>\Yaf\Controller_Abstract</b> provides a magic method: \Yaf\Controller_Abstract::init().</p>
* <br/>
* <p>If you have defined a init() method in your custom controller, it will be called as long as the controller was instantiated.</p>
* <br/>
* <p>Action may have arguments, when a request coming, if there are the same name variable in the request parameters(see \Yaf\Request_Abstract::getParam()) after routed, Yaf will pass them to the action method (see \Yaf\Action_Abstract::execute()).</p>
* <br/>
* <b>Note:</b>
* <p>These arguments are directly fetched without filtering, it should be carefully processed before use them.</p>
*
* @link https://secure.php.net/manual/en/class.yaf-controller-abstract.php
*/
abstract class Controller_Abstract
{
/**
* @see \Yaf\Action_Abstract
* @var array You can also define a action method in a separate PHP script by using this property and \Yaf\Action_Abstract.
*/
public $actions;
/**
* @var string module name
*/
protected $_module;
/**
* @var string controller name
*/
protected $_name;
/**
* @var \Yaf\Request_Abstract current request object
*/
protected $_request;
/**
* @var \Yaf\Response_Abstract current response object
*/
protected $_response;
/**
* @var array
*/
protected $_invoke_args;
/**
* @var \Yaf\View_Interface view engine object
*/
protected $_view;
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.render.php
*
* @param string $tpl
* @param array $parameters
*
* @return string
*/
protected function render($tpl, array $parameters = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.display.php
*
* @param string $tpl
* @param array $parameters
*
* @return bool
*/
protected function display($tpl, array $parameters = null) {}
/**
* retrieve current request object
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getrequest.php
*
* @return \Yaf\Request_Abstract
*/
public function getRequest() {}
/**
* retrieve current response object
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getresponse.php
*
* @return \Yaf\Response_Abstract
*/
public function getResponse() {}
/**
* get the controller's module name
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getmodulename.php
*
* @return string
*/
public function getModuleName() {}
/**
* retrieve view engine
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getview.php
*
* @return \Yaf\View_Interface
*/
public function getView() {}
/**
* @deprecated not_implemented
* @link https://secure.php.net/manual/en/yaf-controller-abstract.initview.php
*
* @param array $options
*
* @return \Yaf\Response_Abstract
*/
public function initView(array $options = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.setviewpath.php
*
* @param string $view_directory
*
* @return bool
*/
public function setViewpath($view_directory) {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getviewpath.php
*
* @return string
*/
public function getViewpath() {}
/**
* <p>forward current execution process to other action.</p>
* <br/>
* <b>Note:</b>
* <p>this method doesn't switch to the destination action immediately, it will take place after current flow finish.</p>
* <br/>
* <b>Notice, there are 3 available method signatures:</b>
* <p>\Yaf\Controller_Abstract::forward ( string $module , string $controller , string $action [, array $parameters ] )</p>
* <p>\Yaf\Controller_Abstract::forward ( string $controller , string $action [, array $parameters ] )</p>
* <p>\Yaf\Controller_Abstract::forward ( string $action [, array $parameters ] )</p>
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.forward.php
*
* @param string $module destination module name, if NULL was given, then default module name is assumed
* @param string $controller destination controller name
* @param string $action destination action name
* @param array $parameters calling arguments
*
* @return bool return FALSE on failure
*/
public function forward($module, $controller = null, $action = null, array $parameters = null) {}
/**
* redirect to a URL by sending a 302 header
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.redirect.php
*
* @param string $url a location URL
*
* @return bool
*/
public function redirect($url) {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getinvokeargs.php
*
* @return array
*/
public function getInvokeArgs() {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.getinvokearg.php
* @param string $name
*
* @return mixed|null
*/
public function getInvokeArg($name) {}
/**
* <p>\Yaf\Controller_Abstract::__construct() is final, which means users can not override it. but users can define <b>\Yaf\Controller_Abstract::init()</b>, which will be called after controller object is instantiated.</p>
*
* @link https://secure.php.net/manual/en/yaf-controller-abstract.init.php
*/
public function init() {}
/**
* <b>\Yaf\Controller_Abstract</b>::__construct() is final, which means it can not be overridden. You may want to see \Yaf\Controller_Abstract::init() instead.
*
* @see \Yaf\Controller_Abstract::init()
* @link https://secure.php.net/manual/en/yaf-controller-abstract.construct.php
*
* @param \Yaf\Request_Abstract $request
* @param \Yaf\Response_Abstract $response
* @param \Yaf\View_Interface $view
* @param array $invokeArgs
*/
final public function __construct(Request_Abstract $request, Response_Abstract $response, View_Interface $view, array $invokeArgs = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-controller-abstract.clone.php
*/
final private function __clone() {}
}/**
* <p>A action can be defined in a separate file in Yaf(see \Yaf\Controller_Abstract). that is a action method can also be a <b>\Yaf\Action_Abstract</b> class.</P>
* <br/>
* <p>Since there should be a entry point which can be called by Yaf (as of PHP 5.3, there is a new magic method __invoke, but Yaf is not only works with PHP 5.3+, Yaf choose another magic method execute), you must implement the abstract method \Yaf\Action_Abstract::execute() in your custom action class.</p>
*
* @link https://secure.php.net/manual/en/class.yaf-action-abstract.php
*/
abstract class Action_Abstract extends \Yaf\Controller_Abstract
{
/**
* @var \Yaf\Controller_Abstract
*/
protected $_controller;
/**
* <p>user should always define this method for a action, this is the entry point of an action. <b>\Yaf\Action_Abstract::execute()</b> may have arguments.</p>
* <br/>
* <b>Note:</b>
* <p>The value retrieved from the request is not safe. you should do some filtering work before you use it.</p>
* @link https://secure.php.net/manual/en/yaf-action-abstract.execute.php
*
* @param mixed ... unlimited number of arguments
* @return mixed
*/
abstract public function execute();
/**
* retrieve current controller object.
*
* @link https://secure.php.net/manual/en/yaf-action-abstract.getcontroller.php
*
* @return \Yaf\Controller_Abstract
*/
public function getController() {}
}/**
* @link https://secure.php.net/manual/en/class.yaf-config-abstract.php
*/
abstract class Config_Abstract
{
/**
* @var array
*/
protected $_config = null;
/**
* @var bool
*/
protected $_readonly = true;
/**
* @link https://secure.php.net/manual/en/yaf-config-abstract.get.php
*
* @param string $name
* @return mixed
*/
abstract public function get($name = null);
/**
* @link https://secure.php.net/manual/en/yaf-config-abstract.set.php
*
* @param string $name
* @param mixed $value
* @return \Yaf\Config_Abstract
*/
abstract public function set($name, $value);
/**
* @link https://secure.php.net/manual/en/yaf-config-abstract.readonly.php
*
* @return bool
*/
abstract public function readonly();
/**
* @link https://secure.php.net/manual/en/yaf-config-abstract.toarray.php
*
* @return array
*/
abstract public function toArray();
}/**
* @link https://secure.php.net/manual/en/class.yaf-request-abstract.php
*/
abstract class Request_Abstract
{
public const SCHEME_HTTP = 'http';
public const SCHEME_HTTPS = 'https';
/**
* @var string
*/
public $module;
/**
* @var string
*/
public $controller;
/**
* @var string
*/
public $action;
/**
* @var string
*/
public $method;
/**
* @var array
*/
protected $params;
/**
* @var string
*/
protected $language;
/**
* @var \Yaf\Exception
*/
protected $_exception;
/**
* @var string
*/
protected $_base_uri = "";
/**
* @var string
*/
protected $uri = "";
/**
* @var string
*/
protected $dispatched = "";
/**
* @var string
*/
protected $routed = "";
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isget.php
*
* @return bool
*/
public function isGet() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.ispost.php
*
* @return bool
*/
public function isPost() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isput.php
*
* @return bool
*/
public function isPut() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.ishead.php
*
* @return bool
*/
public function isHead() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isoptions.php
*
* @return bool
*/
public function isOptions() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.iscli.php
*
* @return bool
*/
public function isCli() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isdispached.php
*
* @return bool
*/
public function isDispatched() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isrouted.php
*
* @return bool
*/
public function isRouted() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.isxmlhttprequest.php
*
* @return bool false
*/
public function isXmlHttpRequest() {}
/**
* Retrieve $_SERVER variable
*
* @link https://secure.php.net/manual/en/yaf-request-abstract.getserver.php
*
* @param string $name the variable name, if not provided returns all
* @param mixed $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getServer($name = null, $default = null) {}
/**
* Retrieve $_ENV variable
*
* @link https://secure.php.net/manual/en/yaf-request-abstract.getenv.php
*
* @param string $name the variable name, if not provided returns all
* @param mixed $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getEnv($name = null, $default = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getparam.php
*
* @param string $name
* @param mixed $default
*
* @return mixed
*/
public function getParam($name, $default = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getparams.php
*
* @return array
*/
public function getParams() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getexception.php
*
* @return \Yaf\Exception
*/
public function getException() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getmoudlename.php
*
* @return string
*/
public function getModuleName() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getcontrollername.php
*
* @return string
*/
public function getControllerName() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getactionname.php
*
* @return string
*/
public function getActionName() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.setparam.php
*
* @param string|array $name the variable name, or an array of key=>value pairs
* @param string $value
*
* @return \Yaf\Request_Abstract|bool
*/
public function setParam($name, $value = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.setmodulename.php
*
* @param string $module
*
* @return \Yaf\Request_Abstract|bool
*/
public function setModuleName($module) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.setcontrollername.php
*
* @param string $controller
*
* @return \Yaf\Request_Abstract|bool
*/
public function setControllerName($controller) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.setactionname.php
*
* @param string $action
*
* @return \Yaf\Request_Abstract|bool
*/
public function setActionName($action) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getmethod.php
*
* @return string
*/
public function getMethod() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getlanguage.php
*
* @return string
*/
public function getLanguage() {}
/**
* <p>Set base URI, base URI is used when doing routing, in routing phase request URI is used to route a request, while base URI is used to skip the leading part(base URI) of request URI. That is, if comes a request with request URI a/b/c, then if you set base URI to "a/b", only "/c" will be used in routing phase.</p>
* <br/>
* <b>Note:</b>
* <p>generally, you don't need to set this, Yaf will determine it automatically.</p>
*
* @link https://secure.php.net/manual/en/yaf-request-abstract.setbaseuri.php
*
* @param string $uri base URI
*
* @return bool
*/
public function setBaseUri($uri) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getbaseuri.php
*
* @return string
*/
public function getBaseUri() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-abstract.getrequesturi.php
*
* @return string
*/
public function getRequestUri() {}
/**
* @since 2.1.0
* @link https://secure.php.net/manual/en/yaf-request-abstract.setrequesturi.php
*
* @param string $uri request URI
*/
public function setRequestUri($uri) {}
/**
* Set request as dispatched
*
* @link https://secure.php.net/manual/en/yaf-request-abstract.setdispatched.php
*
* @return bool
*/
public function setDispatched() {}
/**
* Set request as routed
*
* @link https://secure.php.net/manual/en/yaf-request-abstract.setrouted.php
*
* @return \Yaf\Request_Abstract|bool
*/
public function setRouted() {}
}/**
* <p>Plugins allow for easy extensibility and customization of the framework.</p>
* <br/>
* <p>Plugins are classes. The actual class definition will vary based on the component -- you may need to implement this interface, but the fact remains that the plugin is itself a class.</p>
* <br/>
* <p>A plugin could be loaded into Yaf by using \Yaf\Dispatcher::registerPlugin(), after registered, All the methods which the plugin implemented according to this interface, will be called at the proper time.</p>
* @link https://secure.php.net/manual/en/class.yaf-plugin-abstract.php
*/
abstract class Plugin_Abstract
{
/**
* This is the earliest hook in Yaf plugin hook system, if a custom plugin implement this method, then it will be called before routing a request.
*
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.routerstartup.php
*
* @param \Yaf\Request_Abstract $request
* @param \Yaf\Response_Abstract $response
*
* @return bool true
*/
public function routerStartup(Request_Abstract $request, Response_Abstract $response) {}
/**
* This hook will be trigged after the route process finished, this hook is usually used for login check.
*
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.routershutdown.php
*
* @param \Yaf\Request_Abstract $request
* @param \Yaf\Response_Abstract $response
*
* @return bool true
*/
public function routerShutdown(Request_Abstract $request, Response_Abstract $response) {}
/**
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.dispatchloopstartup.php
*
* @param \Yaf\Request_Abstract $request
* @param \Yaf\Response_Abstract $response
*
* @return bool true
*/
public function dispatchLoopStartup(Request_Abstract $request, Response_Abstract $response) {}
/**
* This is the latest hook in Yaf plugin hook system, if a custom plugin implement this method, then it will be called after the dispatch loop finished.
*
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.dispatchloopshutdown.php
*
* @param \Yaf\Request_Abstract $request
* @param \Yaf\Response_Abstract $response
*
* @return bool true
*/
public function dispatchLoopShutdown(Request_Abstract $request, Response_Abstract $response) {}
/**
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.predispatch.php
*
* @param \Yaf\Request_Abstract $request
* @param \Yaf\Response_Abstract $response
*
* @return bool true
*/
public function preDispatch(Request_Abstract $request, Response_Abstract $response) {}
/**
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.postdispatch.php
*
* @param \Yaf\Request_Abstract $request
* @param \Yaf\Response_Abstract $response
*
* @return bool true
*/
public function postDispatch(Request_Abstract $request, Response_Abstract $response) {}
/**
* @link https://secure.php.net/manual/en/yaf-plugin-abstract.preresponse.php
*
* @param \Yaf\Request_Abstract $request
* @param \Yaf\Response_Abstract $response
*
* @return bool true
*/
public function preResponse(Request_Abstract $request, Response_Abstract $response) {}
}/**
* @link https://secure.php.net/manual/en/class.yaf-response-abstract.php
*/
abstract class Response_Abstract
{
public const DEFAULT_BODY = "content";
/**
* @var string
*/
protected $_header;
/**
* @var string
*/
protected $_body;
/**
* @var bool
*/
protected $_sendheader;
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.construct.php
*/
public function __construct() {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.destruct.php
*/
public function __destruct() {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.clone.php
*/
private function __clone() {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.tostring.php
*/
public function __toString() {}
/**
* Set content to response
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.setbody.php
*
* @param string $content content string
* @param string $key <p>the content key, you can set a content with a key, if you don't specific, then \Yaf\Response_Abstract::DEFAULT_BODY will be used</p>
* <br/>
* <b>Note:</b>
* <p>this parameter is introduced as of 2.2.0</p>
*
* @return bool
*/
public function setBody($content, $key = self::DEFAULT_BODY) {}
/**
* append a content to a exists content block
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.appendbody.php
*
* @param string $content content string
* @param string $key <p>the content key, you can set a content with a key, if you don't specific, then \Yaf\Response_Abstract::DEFAULT_BODY will be used</p>
* <br/>
* <b>Note:</b>
* <p>this parameter is introduced as of 2.2.0</p>
*
* @return bool
*/
public function appendBody($content, $key = self::DEFAULT_BODY) {}
/**
* prepend a content to a exists content block
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.prependbody.php
*
* @param string $content content string
* @param string $key <p>the content key, you can set a content with a key, if you don't specific, then \Yaf\Response_Abstract::DEFAULT_BODY will be used</p>
* <br/>
* <b>Note:</b>
* <p>this parameter is introduced as of 2.2.0</p>
*
* @return bool
*/
public function prependBody($content, $key = self::DEFAULT_BODY) {}
/**
* Clear existing content
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.clearbody.php
*
* @param string $key <p>the content key, you can set a content with a key, if you don't specific, then \Yaf\Response_Abstract::DEFAULT_BODY will be used</p>
* <br/>
* <b>Note:</b>
* <p>this parameter is introduced as of 2.2.0</p>
*
* @return bool
*/
public function clearBody($key = self::DEFAULT_BODY) {}
/**
* Retrieve an existing content
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.getbody.php
*
* @param string|null $key <p>the content key, if you don't specific, then \Yaf\Response_Abstract::DEFAULT_BODY will be used. if you pass in a NULL, then all contents will be returned as a array</p>
* <br/>
* <b>Note:</b>
* <p>this parameter is introduced as of 2.2.0</p>
*
* @return mixed
*/
public function getBody($key = self::DEFAULT_BODY) {}
}/**
* Yaf provides a ability for developers to use custom view engine instead of build-in engine which is \Yaf\View\Simple. There is a example to explain how to do this, please see \Yaf\Dispatcher::setView()
*
* @link https://secure.php.net/manual/en/class.yaf-view-interface.php
*/
interface View_Interface
{
/**
* Assign values to View engine, then the value can access directly by name in template.
*
* @link https://secure.php.net/manual/en/yaf-view-interface.assign.php
*
* @param string|array $name
* @param mixed $value
* @return bool
*/
public function assign($name, $value);
/**
* Render a template and output the result immediately.
*
* @link https://secure.php.net/manual/en/yaf-view-interface.display.php
*
* @param string $tpl
* @param array $tpl_vars
* @return bool
*/
public function display($tpl, array $tpl_vars = null);
/**
* @link https://secure.php.net/manual/en/yaf-view-interface.getscriptpath.php
*
* @return string
*/
public function getScriptPath();
/**
* Render a template and return the result.
*
* @link https://secure.php.net/manual/en/yaf-view-interface.render.php
*
* @param string $tpl
* @param array $tpl_vars
* @return string
*/
public function render($tpl, array $tpl_vars = null);
/**
* Set the templates base directory, this is usually called by \Yaf\Dispatcher
*
* @link https://secure.php.net/manual/en/yaf-view-interface.setscriptpath.php
*
* @param string $template_dir An absolute path to the template directory, by default, \Yaf\Dispatcher use application.directory . "/views" as this parameter.
*/
public function setScriptPath($template_dir);
}/**
* <b>\Yaf\Route_Interface</b> used for developer defined their custom route.
*
* @link https://secure.php.net/manual/en/class.yaf-route-interface.php
*/
interface Route_Interface
{
/**
* <p><b>\Yaf\Route_Interface::route()</b> is the only method that a custom route should implement.</p><br/>
* <p>if this method return TRUE, then the route process will be end. otherwise, \Yaf\Router will call next route in the route stack to route request.</p><br/>
* <p>This method would set the route result to the parameter request, by calling \Yaf\Request_Abstract::setControllerName(), \Yaf\Request_Abstract::setActionName() and \Yaf\Request_Abstract::setModuleName().</p><br/>
* <p>This method should also call \Yaf\Request_Abstract::setRouted() to make the request routed at last.</p>
*
* @link https://secure.php.net/manual/en/yaf-route-interface.route.php
*
* @param \Yaf\Request_Abstract $request
* @return bool
*/
public function route(Request_Abstract $request);
/**
* <p><b>\Yaf\Route_Interface::assemble()</b> - assemble a request</p><br/>
* <p>this method returns a url according to the argument info, and append query strings to the url according to the argument query.</p>
* <p>a route should implement this method according to its own route rules, and do a reverse progress.</p>
*
* @link https://secure.php.net/manual/en/yaf-route-interface.assemble.php
*
* @param array $info
* @param array $query
* @return bool
*/
public function assemble(array $info, array $query = null);
}/**
* @link https://secure.php.net/manual/en/class.yaf-exception.php
*/
class Exception extends \Exception {}/**
* <p>by default, \Yaf\Router only have a <b>\Yaf\Route_Static</b> as its default route.</p>
* <br/>
* <p><b>\Yaf\Route_Static</b> is designed to handle 80% of normal requirements.</p>
* <br/>
* <b>Note:</b>
* <p> it is unnecessary to instance a <b>\Yaf\Route_Static</b>, also unnecessary to add it into \Yaf\Router's routes stack, since there is always be one in \Yaf\Router's routes stack, and always be called at the last time.</p>
*
* @link https://secure.php.net/manual/en/class.yaf-route-static.php
*/
class Route_Static implements \Yaf\Route_Interface
{
/**
* @deprecated not_implemented
* @link https://secure.php.net/manual/en/yaf-route-static.match.php
*
* @param string $uri
*
* @return bool
*/
public function match($uri) {}
/**
* @link https://secure.php.net/manual/en/yaf-route-static.route.php
*
* @param \Yaf\Request_Abstract $request
*
* @return bool always TRUE
*/
public function route(Request_Abstract $request) {}
/**
* <p><b>\Yaf\Route_Static::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-static.assemble.php
*
* @param array $info
* @param array $query
* @return bool
*/
public function assemble(array $info, array $query = null) {}
}}
namespace Yaf\Response {
class Http extends \Yaf\Response_Abstract
{
/**
* @var int
*/
protected $_response_code = 0;
private function __clone() {}
/**
* @return string
*/
private function __toString() {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.setheader.php
*
* @param string $name
* @param string $value
* @param bool $replace
* @param int $response_code
*
* @return bool
*/
public function setHeader($name, $value, $replace = false, $response_code = 0) {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.setallheaders.php
*
* @param array $headers
*
* @return bool
*/
public function setAllHeaders(array $headers) {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.getheader.php
*
* @param string $name
*
* @return mixed
*/
public function getHeader($name = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.clearheaders.php
*
*
* @return \Yaf\Response_Abstract|false
*/
public function clearHeaders() {}
/**
* @link https://secure.php.net/manual/en/yaf-response-abstract.setredirect.php
*
* @param string $url
*
* @return bool
*/
public function setRedirect($url) {}
/**
* send response
*
* @link https://secure.php.net/manual/en/yaf-response-abstract.response.php
*
* @return bool
*/
public function response() {}
}
class Cli extends \Yaf\Response_Abstract
{
private function __clone() {}
/**
* @return string
*/
private function __toString() {}
}}
namespace Yaf\Request {
/**
* @link https://secure.php.net/manual/en/class.yaf-request-http.php
*/
class Http extends \Yaf\Request_Abstract
{
/**
* Retrieve $_GET variable
*
* @link https://secure.php.net/manual/en/yaf-request-http.getquery.php
*
* @param string $name the variable name, if not provided returns all
* @param mixed $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getQuery($name = null, $default = null) {}
/**
* Retrieve $_REQUEST variable
*
* @link https://secure.php.net/manual/en/yaf-request-http.getrequest.php
*
* @param string $name the variable name, if not provided returns all
* @param mixed $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getRequest($name = null, $default = null) {}
/**
* Retrieve $_POST variable
*
* @link https://secure.php.net/manual/en/yaf-request-http.getpost.php
*
* @param string $name the variable name, if not provided returns all
* @param mixed $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getPost($name = null, $default = null) {}
/**
* Retrieve $_COOKIE variable
*
* @link https://secure.php.net/manual/en/yaf-request-http.getcookie.php
*
* @param string $name the variable name, if not provided returns all
* @param mixed $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getCookie($name = null, $default = null) {}
/**
* Retrieve $_FILES variable
*
* @link https://secure.php.net/manual/en/yaf-request-http.getfiles.php
*
* @param string $name the variable name, if not provided returns all
* @param mixed $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getFiles($name = null, $default = null) {}
/**
* Retrieve variable from client, this method will search the name in $_REQUEST params, if the name is not found, then will search in $_POST, $_GET, $_COOKIE, $_SERVER
*
* @link https://secure.php.net/manual/en/yaf-request-http.get.php
*
* @param string $name the variable name
* @param string $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function get($name, $default = null) {}
/**
* Check the request whether it is a Ajax Request
*
* <br/>
* <b>Note:</b>
* <p>
* This method depends on the request header: HTTP_X_REQUESTED_WITH, some Javascript library doesn't set this header while doing Ajax request
* </p>
* @link https://secure.php.net/manual/en/yaf-request-http.isxmlhttprequest.php
*
* @return bool
*/
public function isXmlHttpRequest() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-http.construct.php
*
* @param string $request_uri
* @param string $base_uri
*/
public function __construct($request_uri, $base_uri) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-http.clone.php
*/
private function __clone() {}
}/**
* <b>\Yaf\Request\Simple</b> is particularly used for test purpose. ie. simulate a spacial request under CLI mode.
* @link https://secure.php.net/manual/en/class.yaf-request-simple.php
*/
class Simple extends \Yaf\Request_Abstract
{
/**
* Retrieve $_GET variable
*
* @link https://secure.php.net/manual/en/yaf-request-simple.getquery.php
*
* @param string $name the variable name, if not provided returns all
* @param string $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getQuery($name = null, $default = null) {}
/**
* Retrieve $_REQUEST variable
*
* @link https://secure.php.net/manual/en/yaf-request-simple.getrequest.php
*
* @param string $name the variable name, if not provided returns all
* @param string $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getRequest($name = null, $default = null) {}
/**
* Retrieve $_POST variable
*
* @link https://secure.php.net/manual/en/yaf-request-simple.getpost.php
*
* @param string $name the variable name, if not provided returns all
* @param string $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getPost($name = null, $default = null) {}
/**
* Retrieve $_Cookie variable
*
* @link https://secure.php.net/manual/en/yaf-request-simple.getcookie.php
*
* @param string $name the variable name, if not provided returns all
* @param string $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function getCookie($name = null, $default = null) {}
/**
* @param mixed $name
* @param null $default
*
* @return array
*/
public function getFiles($name = null, $default = null) {}
/**
* Retrieve variable from client, this method will search the name in $_REQUEST params, if the name is not found, then will search in $_POST, $_GET, $_COOKIE, $_SERVER
*
* @link https://secure.php.net/manual/en/yaf-request-simple.get.php
*
* @param string $name the variable name
* @param string $default if this parameter is provide, this will be returned if the variable can not be found
*
* @return mixed
*/
public function get($name, $default = null) {}
/**
* Check the request whether it is a Ajax Request
*
* <br/>
* <b>Note:</b>
* <p>
* This method depends on the request header: HTTP_X_REQUESTED_WITH, some Javascript library doesn't set this header while doing Ajax request
* </p>
* @link https://secure.php.net/manual/en/yaf-request-simple.isxmlhttprequest.php
*
* @return bool
*/
public function isXmlHttpRequest() {}
/**
* @link https://secure.php.net/manual/en/yaf-request-simple.construct.php
*
* @param string $method
* @param string $controller
* @param string $action
* @param string $params
*
* @throws \Yaf\Exception\TypeError
*/
public function __construct($method, $controller, $action, $params = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-request-simple.clone.php
*/
private function __clone() {}
}}
namespace Yaf\Config {
/**
* <p>\Yaf\Config\Ini enables developers to store configuration data in a familiar INI format and read them in the application by using nested object property syntax. The INI format is specialized to provide both the ability to have a hierarchy of configuration data keys and inheritance between configuration data sections. Configuration data hierarchies are supported by separating the keys with the dot or period character ("."). A section may extend or inherit from another section by following the section name with a colon character (":") and the name of the section from which data are to be inherited.</p><br/>
* <b>Note:</b>
* <p>\Yaf\Config\Ini utilizes the » parse_ini_file() PHP function. Please review this documentation to be aware of its specific behaviors, which propagate to \Yaf\Config\Ini, such as how the special values of "TRUE", "FALSE", "yes", "no", and "NULL" are handled.</p>
* @link https://secure.php.net/manual/en/class.yaf-config-ini.php
*/
class Ini extends \Yaf\Config_Abstract implements \Iterator, \Traversable, \ArrayAccess, \Countable
{
/**
* @see \Yaf\Config_Abstract::get
*/
public function __get($name = null) {}
/**
* @see \Yaf\Config_Abstract::set
*/
public function __set($name, $value) {}
/**
* @see \Yaf\Config_Abstract::get
*/
public function get($name = null) {}
/**
* @see \Yaf\Config_Abstract::set
* @deprecated not_implemented
*/
public function set($name, $value) {}
/**
* @see \Yaf\Config_Abstract::toArray
*/
public function toArray() {}
/**
* @see \Yaf\Config_Abstract::readonly
*/
public function readonly() {}
/**
* @link https://secure.php.net/manual/en/yaf-config-ini.construct.php
*
* @param string $config_file path to an INI configure file
* @param string $section which section in that INI file you want to be parsed
*
* @throws \Yaf\Exception\TypeError
*/
public function __construct($config_file, $section = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-config-ini.isset.php
* @param string $name
*/
public function __isset($name) {}
/**
* @see \Countable::count
*/
public function count() {}
/**
* @see \Iterator::rewind
*/
public function rewind() {}
/**
* @see \Iterator::current
*/
public function current() {}
/**
* @see \Iterator::next
*/
public function next() {}
/**
* @see \Iterator::valid
*/
public function valid() {}
/**
* @see \Iterator::key
*/
public function key() {}
/**
* @see \ArrayAccess::offsetUnset
* @deprecated not_implemented
*/
public function offsetUnset($name) {}
/**
* @see \ArrayAccess::offsetGet
*/
public function offsetGet($name) {}
/**
* @see \ArrayAccess::offsetExists
*/
public function offsetExists($name) {}
/**
* @see \ArrayAccess::offsetSet
*/
public function offsetSet($name, $value) {}
}/**
* @link https://secure.php.net/manual/en/class.yaf-config-simple.php
*/
class Simple extends \Yaf\Config_Abstract implements \Iterator, \Traversable, \ArrayAccess, \Countable
{
/**
* @see \Yaf\Config_Abstract::get
*/
public function __get($name = null) {}
/**
* @see \Yaf\Config_Abstract::set
*/
public function __set($name, $value) {}
/**
* @see \Yaf\Config_Abstract::get
*/
public function get($name = null) {}
/**
* @see \Yaf\Config_Abstract::set
*/
public function set($name, $value) {}
/**
* @see \Yaf\Config_Abstract::toArray
*/
public function toArray() {}
/**
* @see \Yaf\Config_Abstract::readonly
*/
public function readonly() {}
/**
* @link https://secure.php.net/manual/en/yaf-config-simple.construct.php
*
* @param array $array
* @param string $readonly
*/
public function __construct(array $array, $readonly = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-config-simple.isset.php
* @param string $name
*/
public function __isset($name) {}
/**
* @see \Countable::count
*/
public function count() {}
/**
* @see \Iterator::rewind
*/
public function rewind() {}
/**
* @see \Iterator::current
*/
public function current() {}
/**
* @see \Iterator::next
*/
public function next() {}
/**
* @see \Iterator::valid
*/
public function valid() {}
/**
* @see \Iterator::key
*/
public function key() {}
/**
* @see \ArrayAccess::offsetUnset
*/
public function offsetUnset($name) {}
/**
* @see \ArrayAccess::offsetGet
*/
public function offsetGet($name) {}
/**
* @see \ArrayAccess::offsetExists
*/
public function offsetExists($name) {}
/**
* @see \ArrayAccess::offsetSet
*/
public function offsetSet($name, $value) {}
}}
namespace Yaf\View {
/**
* <b>\Yaf\View\Simple</b> is the built-in template engine in Yaf, it is a simple but fast template engine, and only support PHP script template.
* @link https://secure.php.net/manual/en/class.yaf-view-simple.php
*
* @method void|bool eval(string $tpl_str, array $vars = null) <p>Render a string template and return the result.</p>
*
* @link https://secure.php.net/manual/en/yaf-view-simple.eval.php
*
* @param string $tpl_str string template
* @param array $vars
*
* @return void|false return FALSE on failure
*/
class Simple implements \Yaf\View_Interface
{
/**
* @var string
*/
protected $_tpl_dir;
/**
* @var array
*/
protected $_tpl_vars;
/**
* @var array
*/
protected $_options;
/**
* @link https://secure.php.net/manual/en/yaf-view-simple.construct.php
*
* @param string $template_dir The base directory of the templates, by default, it is APPLICATION . "/views" for Yaf.
* @param array $options <p>Options for the engine, as of Yaf 2.1.13, you can use short tag
* "<?=$var?>" in your template(regardless of "short_open_tag"),
* so comes a option named "short_tag", you can switch this off
* to prevent use short_tag in template.
* </p>
* @throws \Yaf\Exception\TypeError
*/
final public function __construct($template_dir, array $options = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-view-simple.isset.php
*
* @param string $name
*/
public function __isset($name) {}
/**
* assign variable to view engine
*
* @link https://secure.php.net/manual/en/yaf-view-simple.assign.php
*
* @param string|array $name A string or an array.<br/>if is string, then the next argument $value is required.
* @param mixed $value mixed value
* @return \Yaf\View\Simple
*/
public function assign($name, $value = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-view-simple.render.php
*
* @param string $tpl
* @param array $tpl_vars
*
* @throws \Yaf\Exception\LoadFailed\View
*
* @return string|void
*/
public function render($tpl, array $tpl_vars = null) {}
/**
* <p>Render a template and display the result instantly.</p>
*
* @link https://secure.php.net/manual/en/yaf-view-simple.display.php
*
* @param string $tpl
* @param array $tpl_vars
*
* @throws \Yaf\Exception\LoadFailed\View
*
* @return bool
*/
public function display($tpl, array $tpl_vars = null) {}
/**
* <p>unlike \Yaf\View\Simple::assign(), this method assign a ref value to engine.</p>
* @link https://secure.php.net/manual/en/yaf-view-simple.assignref.php
*
* @param string $name A string name which will be used to access the value in the template.
* @param mixed &$value mixed value
*
* @return \Yaf\View\Simple
*/
public function assignRef($name, &$value) {}
/**
* clear assigned variable
* @link https://secure.php.net/manual/en/yaf-view-simple.clear.php
*
* @param string $name assigned variable name. <br/>if empty, will clear all assigned variables.
*
* @return \Yaf\View\Simple
*/
public function clear($name = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-view-simple.setscriptpath.php
*
* @param string $template_dir
*
* @return \Yaf\View\Simple
*/
public function setScriptPath($template_dir) {}
/**
* @link https://secure.php.net/manual/en/yaf-view-simple.getscriptpath.php
*
* @return string
*/
public function getScriptPath() {}
/**
* <p>Retrieve assigned variable</p>
* <br/>
* <b>Note:</b>
* <p>$name parameter can be empty since 2.1.11</p>
* @link https://secure.php.net/manual/en/yaf-view-simple.get.php
*
* @param null $name <p>the assigned variable name</p>
* <br/>
* <p>if this is empty, all assigned variables will be returned</p>
*
* @return mixed
*/
public function __get($name = null) {}
/**
* <p>This is a alternative and easier way to \Yaf\View\Simple::assign().</p>
*
* @link https://secure.php.net/manual/en/yaf-view-simple.set.php
*
* @param string $name A string value name.
* @param mixed $value mixed value
*/
public function __set($name, $value = null) {}
}}
namespace Yaf\Route {
/**
* <p><b>\Yaf\Route\Simple</b> will match the query string, and find the route info.</p>
* <br/>
* <p>all you need to do is tell <b>\Yaf\Route\Simple</b> what key in the $_GET is module, what key is controller, and what key is action.</p>
* <br/>
* <p>\Yaf\Route\Simple::route() will always return TRUE, so it is important put <b>\Yaf\Route\Simple</b> in the front of the Route stack, otherwise all the other routes will not be called</p>
*
* @link https://secure.php.net/manual/en/class.yaf-route-simple.php
*/
final class Simple implements \Yaf\Route_Interface
{
/**
* @var string
*/
protected $controller;
/**
* @var string
*/
protected $module;
/**
* @var string
*/
protected $action;
/**
* <p>\Yaf\Route\Simple will get route info from query string. and the parameters of this constructor will used as keys while searching for the route info in $_GET.</p>
*
* @link https://secure.php.net/manual/en/yaf-route-simple.construct.php
*
* @param string $module_name
* @param string $controller_name
* @param string $action_name
*
* @throws \Yaf\Exception\TypeError
*/
public function __construct($module_name, $controller_name, $action_name) {}
/**
* <p>see \Yaf\Route\Simple::__construct()</p>
*
* @link https://secure.php.net/manual/en/yaf-route-simple.route.php
*
* @param \Yaf\Request_Abstract $request
*
* @return bool always TRUE
*/
public function route(Yaf\Request_Abstract $request) {}
/**
* <p><b>\Yaf\Route\Simple::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-simple.assemble.php
*
* @param array $info
* @param array $query
* @return bool
*/
public function assemble(array $info, array $query = null) {}
}/**
* @link https://secure.php.net/manual/en/class.yaf-route-supervar.php
*/
final class Supervar implements \Yaf\Route_Interface
{
/**
* @var string
*/
protected $_var_name;
/**
* <p>\Yaf\Route\Supervar is similar to \Yaf\Route_Static, the difference is that \Yaf\Route\Supervar will look for path info in query string, and the parameter supervar_name is the key.</p>
*
* @link https://secure.php.net/manual/en/yaf-route-supervar.construct.php
*
* @param string $supervar_name The name of key.
*
* @throws \Yaf\Exception\TypeError
*/
public function __construct($supervar_name) {}
/**
* @link https://secure.php.net/manual/en/yaf-route-supervar.route.php
*
* @param \Yaf\Request_Abstract $request
*
* @return bool If there is a key(which was defined in \Yaf\Route\Supervar::__construct()) in $_GET, return TRUE. otherwise return FALSE.
*/
public function route(Yaf\Request_Abstract $request) {}
/**
* <p><b>\Yaf\Route\Supervar::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-supervar.assemble.php
*
* @param array $info
* @param array $query
* @return bool
*/
public function assemble(array $info, array $query = null) {}
}/**
* <p>For usage, please see the example section of \Yaf\Route\Rewrite::__construct()</p>
*
* @link https://secure.php.net/manual/en/class.yaf-route-rewrite.php
*/
final class Rewrite extends \Yaf\Router implements \Yaf\Route_Interface
{
/**
* @var string
*/
protected $_route;
/**
* @var array
*/
protected $_default;
/**
* @var array
*/
protected $_verify;
/**
* @link https://secure.php.net/manual/en/yaf-route-rewrite.construct.php
*
* @param string $match A pattern, will be used to match a request uri, if doesn't matched, \Yaf\Route\Rewrite will return FALSE.
* @param array $route <p>When the match pattern matches the request uri, \Yaf\Route\Rewrite will use this to decide which m/c/a to routed.</p>
* <br/>
* <p>either of m/c/a in this array is optional, if you don't assign a specific value, it will be routed to default.</p>
* @param array $verify
* @param string $reverse
*
* @throws \Yaf\Exception\TypeError
*/
public function __construct($match, array $route, array $verify = null, $reverse = null) {}
/**
* @link https://secure.php.net/manual/en/yaf-route-rewrite.route.php
*
* @param \Yaf\Request_Abstract $request
*
* @return bool
*/
public function route(Yaf\Request_Abstract $request) {}
/**
* <p><b>\Yaf\Route\Rewrite::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-rewrite.assemble.php
*
* @param array $info
* @param array $query
* @return bool
*/
public function assemble(array $info, array $query = null) {}
}/**
* <p><b>\Yaf\Route\Regex</b> is the most flexible route among the Yaf built-in routes.</p>
*
* @link https://secure.php.net/manual/en/class.yaf-route-regex.php
*/
final class Regex extends \Yaf\Router implements \Yaf\Route_Interface
{
/**
* @var string
*/
protected $_route;
/**
* @var array
*/
protected $_default;
/**
* @var array
*/
protected $_maps;
/**
* @var array
*/
protected $_verify;
/**
* @var string
*/
protected $_reverse;
/**
* @link https://secure.php.net/manual/en/yaf-route-regex.construct.php
*
* @param string $match A complete Regex pattern, will be used to match a request uri, if doesn't matched, \Yaf\Route\Regex will return FALSE.
* @param array $route <p>When the match pattern matches the request uri, \Yaf\Route\Regex will use this to decide which m/c/a to routed.</p>
* <br/>
* <p>either of m/c/a in this array is optional, if you don't assign a specific value, it will be routed to default.</p>
* @param array $map A array to assign name to the captures in the match result.
* @param array $verify
* @param string $reverse
*
* @throws \Yaf\Exception\TypeError
*/
public function __construct($match, array $route, array $map = null, array $verify = null, $reverse = null) {}
/**
* Route a incoming request.
*
* @link https://secure.php.net/manual/en/yaf-route-regex.route.php
*
* @param \Yaf\Request_Abstract $request
*
* @return bool If the pattern given by the first parameter of \Yaf\Route\Regex::_construct() matches the request uri, return TRUE, otherwise return FALSE.
*/
public function route(Yaf\Request_Abstract $request) {}
/**
* <p><b>\Yaf\Route\Regex::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-regex.assemble.php
*
* @param array $info
* @param array $query
* @return bool
*/
public function assemble(array $info, array $query = null) {}
}/**
* <p><b>\Yaf\Route\Map</b> is a built-in route, it simply convert a URI endpoint (that part of the URI which comes after the base URI: see \Yaf\Request_Abstract::setBaseUri()) to a controller name or action name(depends on the parameter passed to \Yaf\Route\Map::__construct()) in following rule: A => controller A. A/B/C => controller A_B_C. A/B/C/D/E => controller A_B_C_D_E.</p>
* <br/>
* <p>If the second parameter of \Yaf\Route\Map::__construct() is specified, then only the part before delimiter of URI will used to routing, the part after it is used to routing request parameters (see the example section of \Yaf\Route\Map::__construct()).</p>
*
* @link https://secure.php.net/manual/en/class.yaf-route-map.php
*/
final class Map implements \Yaf\Route_Interface
{
/**
* @var string
*/
protected $_ctl_router = '';
/**
* @var string
*/
protected $_delimiter;
/**
* @link https://secure.php.net/manual/en/yaf-route-map.construct.php
*
* @param bool $controller_prefer Whether the result should considering as controller or action
* @param string $delimiter
*/
public function __construct($controller_prefer = false, $delimiter = '') {}
/**
* @link https://secure.php.net/manual/en/yaf-route-map.route.php
*
* @param \Yaf\Request_Abstract $request
*
* @return bool
*/
public function route(Yaf\Request_Abstract $request) {}
/**
* <p><b>\Yaf\Route\Map::assemble()</b> - Assemble a url</p>
*
* @link https://secure.php.net/manual/en/yaf-route-map.assemble.php
*
* @param array $info
* @param array $query
* @return bool
*/
public function assemble(array $info, array $query = null) {}
}}
namespace Yaf\Exception {
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-typeerror.php
*/
class TypeError extends \Yaf\Exception {}/**
* @link https://secure.php.net/manual/en/class.yaf-exception-startuperror.php
*/
class StartupError extends \Yaf\Exception {}/**
* @link https://secure.php.net/manual/en/class.yaf-exception-routefaild.php
*/
class RouterFailed extends \Yaf\Exception {}/**
* @link https://secure.php.net/manual/en/class.yaf-exception-dispatchfaild.php
*/
class DispatchFailed extends \Yaf\Exception {}/**
* @link https://secure.php.net/manual/en/class.yaf-exception-loadfaild.php
*/
class LoadFailed extends \Yaf\Exception {}}
namespace Yaf\Exception\LoadFailed {
/**
* @link https://secure.php.net/manual/en/class.yaf-exception-loadfaild-module.php
*/
class Module extends \Yaf\Exception\LoadFailed {}/**
* @link https://secure.php.net/manual/en/class.yaf-exception-loadfaild-controller.php
*/
class Controller extends \Yaf\Exception\LoadFailed {}/**
* @link https://secure.php.net/manual/en/class.yaf-exception-loadfaild-action.php
*/
class Action extends \Yaf\Exception\LoadFailed {}/**
* @link https://secure.php.net/manual/en/class.yaf-exception-loadfaild-view.php
*/
class View extends \Yaf\Exception\LoadFailed {}
}
<?php
// Start of posix v.
use JetBrains\PhpStorm\ArrayShape;
use JetBrains\PhpStorm\Internal\PhpStormStubsElementAvailable;
use JetBrains\PhpStorm\Pure;
/**
* Send a signal to a process
* @link https://php.net/manual/en/function.posix-kill.php
* @param int $process_id <p>
* The process identifier.
* </p>
* @param int $signal <p>
* One of the PCNTL signals constants.
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
function posix_kill(int $process_id, int $signal): bool {}
/**
* Return the current process identifier
* @link https://php.net/manual/en/function.posix-getpid.php
* @return int the identifier, as an integer.
*/
#[Pure]
function posix_getpid(): int {}
/**
* Return the parent process identifier
* @link https://php.net/manual/en/function.posix-getppid.php
* @return int the identifier, as an integer.
*/
#[Pure]
function posix_getppid(): int {}
/**
* Return the real user ID of the current process
* @link https://php.net/manual/en/function.posix-getuid.php
* @return int the user id, as an integer
*/
#[Pure]
function posix_getuid(): int {}
/**
* Set the UID of the current process
* @link https://php.net/manual/en/function.posix-setuid.php
* @param int $user_id <p>
* The user id.
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
function posix_setuid(int $user_id): bool {}
/**
* Return the effective user ID of the current process
* @link https://php.net/manual/en/function.posix-geteuid.php
* @return int the user id, as an integer
*/
#[Pure]
function posix_geteuid(): int {}
/**
* Set the effective UID of the current process
* @link https://php.net/manual/en/function.posix-seteuid.php
* @param int $user_id <p>
* The user id.
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
function posix_seteuid(int $user_id): bool {}
/**
* Set system resource limits
* @link https://php.net/manual/en/function.posix-setrlimit.php
* @param int $resource <p>
* The
* {@link https://php.net/manual/en/posix.constants.setrlimit.php resource limit constant}
* corresponding to the limit that is being set.
* </p>
* @param int $soft_limit The soft limit, in whatever unit the resource limit requires, or POSIX_RLIMIT_INFINITY.
* @param int $hard_limit The hard limit, in whatever unit the resource limit requires, or POSIX_RLIMIT_INFINITY.
* @return bool Returns TRUE on success or FALSE on failure.
* @since 7.0
*/
function posix_setrlimit(int $resource, int $soft_limit, int $hard_limit): bool {}
/**
* Return the real group ID of the current process
* @link https://php.net/manual/en/function.posix-getgid.php
* @return int the real group id, as an integer.
*/
#[Pure]
function posix_getgid(): int {}
/**
* Set the GID of the current process
* @link https://php.net/manual/en/function.posix-setgid.php
* @param int $group_id <p>
* The group id.
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
function posix_setgid(int $group_id): bool {}
/**
* Return the effective group ID of the current process
* @link https://php.net/manual/en/function.posix-getegid.php
* @return int an integer of the effective group ID.
*/
#[Pure]
function posix_getegid(): int {}
/**
* Set the effective GID of the current process
* @link https://php.net/manual/en/function.posix-setegid.php
* @param int $group_id <p>
* The group id.
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
function posix_setegid(int $group_id): bool {}
/**
* Return the group set of the current process
* @link https://php.net/manual/en/function.posix-getgroups.php
* @return array|false an array of integers containing the numeric group ids of the group
* set of the current process.
*/
#[Pure]
function posix_getgroups(): array|false {}
/**
* Return login name
* @link https://php.net/manual/en/function.posix-getlogin.php
* @return string|false the login name of the user, as a string.
*/
#[Pure]
function posix_getlogin(): string|false {}
/**
* Return the current process group identifier
* @link https://php.net/manual/en/function.posix-getpgrp.php
* @return int the identifier, as an integer.
*/
#[Pure]
function posix_getpgrp(): int {}
/**
* Make the current process a session leader
* @link https://php.net/manual/en/function.posix-setsid.php
* @return int the session id, or -1 on errors.
*/
function posix_setsid(): int {}
/**
* Set process group id for job control
* @link https://php.net/manual/en/function.posix-setpgid.php
* @param int $process_id <p>
* The process id.
* </p>
* @param int $process_group_id <p>
* The process group id.
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
function posix_setpgid(int $process_id, int $process_group_id): bool {}
/**
* Get process group id for job control
* @link https://php.net/manual/en/function.posix-getpgid.php
* @param int $process_id <p>
* The process id.
* </p>
* @return int|false the identifier, as an integer.
*/
#[Pure]
function posix_getpgid(int $process_id): int|false {}
/**
* Get the current sid of the process
* @link https://php.net/manual/en/function.posix-getsid.php
* @param int $process_id <p>
* The process identifier. If set to 0, the current process is
* assumed. If an invalid <i>pid</i> is
* specified, then <b>FALSE</b> is returned and an error is set which
* can be checked with <b>posix_get_last_error</b>.
* </p>
* @return int|false the identifier, as an integer.
*/
#[Pure]
function posix_getsid(int $process_id): int|false {}
/**
* Get system name
* @link https://php.net/manual/en/function.posix-uname.php
* @return array|false a hash of strings with information about the
* system. The indices of the hash are
* sysname - operating system name (e.g. Linux)
* nodename - system name (e.g. valiant)
* release - operating system release (e.g. 2.2.10)
* version - operating system version (e.g. #4 Tue Jul 20
* 17:01:36 MEST 1999)
* machine - system architecture (e.g. i586)
* domainname - DNS domainname (e.g. example.com)
* </p>
* <p>
* domainname is a GNU extension and not part of POSIX.1, so this
* field is only available on GNU systems or when using the GNU
* libc.
*/
#[Pure]
#[ArrayShape([
'sysname' => 'string',
'nodename' => 'string',
'release' => 'string',
'version' => 'string',
'machine' => 'string',
'domainname' => 'string',
])]
function posix_uname(): array|false {}
/**
* Get process times
* @link https://php.net/manual/en/function.posix-times.php
* @return array|false a hash of strings with information about the current
* process CPU usage. The indices of the hash are:
* ticks - the number of clock ticks that have elapsed since
* reboot.
* utime - user time used by the current process.
* stime - system time used by the current process.
* cutime - user time used by current process and children.
* cstime - system time used by current process and children.
*/
#[Pure]
#[ArrayShape([
'ticks' => 'int',
'utime' => 'int',
'stime' => 'int',
'cutime' => 'int',
'cstime' => 'int'
])]
function posix_times(): array|false {}
/**
* Get path name of controlling terminal
* @link https://php.net/manual/en/function.posix-ctermid.php
* @return string|false Upon successful completion, returns string of the pathname to
* the current controlling terminal. Otherwise <b>FALSE</b> is returned and errno
* is set, which can be checked with <b>posix_get_last_error</b>.
*/
#[Pure]
function posix_ctermid(): string|false {}
/**
* Determine terminal device name
* @link https://php.net/manual/en/function.posix-ttyname.php
* @param int $file_descriptor <p>
* The file descriptor.
* </p>
* @return string|false On success, returns a string of the absolute path of the
* <i>fd</i>. On failure, returns <b>FALSE</b>
*/
#[Pure]
function posix_ttyname($file_descriptor): string|false {}
/**
* Determine if a file descriptor is an interactive terminal
* @link https://php.net/manual/en/function.posix-isatty.php
* @param mixed $file_descriptor <p>
* The file descriptor, which is expected to be either a file resource or an integer.
* An integer will be assumed to be a file descriptor that can be passed
* directly to the underlying system call.<br />
* In almost all cases, you will want to provide a file resource.
* </p>
* @return bool <b>TRUE</b> if <i>fd</i> is an open descriptor connected
* to a terminal and <b>FALSE</b> otherwise.
*/
#[Pure]
function posix_isatty($file_descriptor): bool {}
/**
* Pathname of current directory
* @link https://php.net/manual/en/function.posix-getcwd.php
* @return string|false a string of the absolute pathname on success.
* On error, returns <b>FALSE</b> and sets errno which can be checked with
* <b>posix_get_last_error</b>.
*/
#[Pure(true)]
function posix_getcwd(): string|false {}
/**
* Create a fifo special file (a named pipe)
* @link https://php.net/manual/en/function.posix-mkfifo.php
* @param string $filename <p>
* Path to the FIFO file.
* </p>
* @param int $permissions <p>
* The second parameter <i>mode</i> has to be given in
* octal notation (e.g. 0644). The permission of the newly created
* FIFO also depends on the setting of the current
* <b>umask</b>. The permissions of the created file are
* (mode & ~umask).
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
function posix_mkfifo(string $filename, int $permissions): bool {}
/**
* Create a special or ordinary file (POSIX.1)
* @link https://php.net/manual/en/function.posix-mknod.php
* @param string $filename <p>
* The file to create
* </p>
* @param int $flags <p>
* This parameter is constructed by a bitwise OR between file type (one of
* the following constants: <b>POSIX_S_IFREG</b>,
* <b>POSIX_S_IFCHR</b>, <b>POSIX_S_IFBLK</b>,
* <b>POSIX_S_IFIFO</b> or
* <b>POSIX_S_IFSOCK</b>) and permissions.
* </p>
* @param int $major [optional] <p>
* The major device kernel identifier (required to pass when using
* <b>S_IFCHR</b> or <b>S_IFBLK</b>).
* </p>
* @param int $minor [optional] <p>
* The minor device kernel identifier.
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
function posix_mknod(string $filename, int $flags, int $major = 0, int $minor = 0): bool {}
/**
* Determine accessibility of a file
* @link https://php.net/manual/en/function.posix-access.php
* @param string $filename <p>
* The name of the file to be tested.
* </p>
* @param int $flags [optional] <p>
* A mask consisting of one or more of <b>POSIX_F_OK</b>,
* <b>POSIX_R_OK</b>, <b>POSIX_W_OK</b> and
* <b>POSIX_X_OK</b>.
* </p>
* <p>
* <b>POSIX_R_OK</b>, <b>POSIX_W_OK</b> and
* <b>POSIX_X_OK</b> request checking whether the file
* exists and has read, write and execute permissions, respectively.
* <b>POSIX_F_OK</b> just requests checking for the
* existence of the file.
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
function posix_access(string $filename, int $flags = POSIX_F_OK): bool {}
/**
* Return info about a group by name
* @link https://php.net/manual/en/function.posix-getgrnam.php
* @param string $name <p>The name of the group</p>
* @return array|false The array elements returned are:
* <table>
* The group information array
* <tr valign="top">
* <td>Element</td>
* <td>Description</td>
* </tr>
* <tr valign="top">
* <td>name</td>
* <td>
* The name element contains the name of the group. This is
* a short, usually less than 16 character "handle" of the
* group, not the real, full name. This should be the same as
* the <i>name</i> parameter used when
* calling the function, and hence redundant.
* </td>
* </tr>
* <tr valign="top">
* <td>passwd</td>
* <td>
* The passwd element contains the group's password in an
* encrypted format. Often, for example on a system employing
* "shadow" passwords, an asterisk is returned instead.
* </td>
* </tr>
* <tr valign="top">
* <td>gid</td>
* <td>
* Group ID of the group in numeric form.
* </td>
* </tr>
* <tr valign="top">
* <td>members</td>
* <td>
* This consists of an array of
* string's for all the members in the group.
* </td>
* </tr>
* </table>
*/
#[Pure]
function posix_getgrnam(string $name): array|false {}
/**
* Return info about a group by group id
* @link https://php.net/manual/en/function.posix-getgrgid.php
* @param int $group_id <p>
* The group id.
* </p>
* @return array|false The array elements returned are:
* <table>
* The group information array
* <tr valign="top">
* <td>Element</td>
* <td>Description</td>
* </tr>
* <tr valign="top">
* <td>name</td>
* <td>
* The name element contains the name of the group. This is
* a short, usually less than 16 character "handle" of the
* group, not the real, full name.
* </td>
* </tr>
* <tr valign="top">
* <td>passwd</td>
* <td>
* The passwd element contains the group's password in an
* encrypted format. Often, for example on a system employing
* "shadow" passwords, an asterisk is returned instead.
* </td>
* </tr>
* <tr valign="top">
* <td>gid</td>
* <td>
* Group ID, should be the same as the
* <i>gid</i> parameter used when calling the
* function, and hence redundant.
* </td>
* </tr>
* <tr valign="top">
* <td>members</td>
* <td>
* This consists of an array of
* string's for all the members in the group.
* </td>
* </tr>
* </table>
*/
#[Pure]
function posix_getgrgid(int $group_id): array|false {}
/**
* Return info about a user by username
* @link https://php.net/manual/en/function.posix-getpwnam.php
* @param string $username <p>
* An alphanumeric username.
* </p>
* @return array|false On success an array with the following elements is returned, else
* <b>FALSE</b> is returned:
* <table>
* The user information array
* <tr valign="top">
* <td>Element</td>
* <td>Description</td>
* </tr>
* <tr valign="top">
* <td>name</td>
* <td>
* The name element contains the username of the user. This is
* a short, usually less than 16 character "handle" of the
* user, not the real, full name. This should be the same as
* the <i>username</i> parameter used when
* calling the function, and hence redundant.
* </td>
* </tr>
* <tr valign="top">
* <td>passwd</td>
* <td>
* The passwd element contains the user's password in an
* encrypted format. Often, for example on a system employing
* "shadow" passwords, an asterisk is returned instead.
* </td>
* </tr>
* <tr valign="top">
* <td>uid</td>
* <td>
* User ID of the user in numeric form.
* </td>
* </tr>
* <tr valign="top">
* <td>gid</td>
* <td>
* The group ID of the user. Use the function
* <b>posix_getgrgid</b> to resolve the group
* name and a list of its members.
* </td>
* </tr>
* <tr valign="top">
* <td>gecos</td>
* <td>
* GECOS is an obsolete term that refers to the finger
* information field on a Honeywell batch processing system.
* The field, however, lives on, and its contents have been
* formalized by POSIX. The field contains a comma separated
* list containing the user's full name, office phone, office
* number, and home phone number. On most systems, only the
* user's full name is available.
* </td>
* </tr>
* <tr valign="top">
* <td>dir</td>
* <td>
* This element contains the absolute path to the home
* directory of the user.
* </td>
* </tr>
* <tr valign="top">
* <td>shell</td>
* <td>
* The shell element contains the absolute path to the
* executable of the user's default shell.
* </td>
* </tr>
* </table>
*/
#[Pure]
#[ArrayShape([
"name" => "string",
"passwd" => "string",
"uid" => "int",
"gid" => "int",
"gecos" => "string",
"dir" => "string",
"shell" => "string",
])]
function posix_getpwnam(string $username): array|false {}
/**
* Return info about a user by user id
* @link https://php.net/manual/en/function.posix-getpwuid.php
* @param int $user_id <p>
* The user identifier.
* </p>
* @return array|false an associative array with the following elements:
* <table>
* The user information array
* <tr valign="top">
* <td>Element</td>
* <td>Description</td>
* </tr>
* <tr valign="top">
* <td>name</td>
* <td>
* The name element contains the username of the user. This is
* a short, usually less than 16 character "handle" of the
* user, not the real, full name.
* </td>
* </tr>
* <tr valign="top">
* <td>passwd</td>
* <td>
* The passwd element contains the user's password in an
* encrypted format. Often, for example on a system employing
* "shadow" passwords, an asterisk is returned instead.
* </td>
* </tr>
* <tr valign="top">
* <td>uid</td>
* <td>
* User ID, should be the same as the
* <i>uid</i> parameter used when calling the
* function, and hence redundant.
* </td>
* </tr>
* <tr valign="top">
* <td>gid</td>
* <td>
* The group ID of the user. Use the function
* <b>posix_getgrgid</b> to resolve the group
* name and a list of its members.
* </td>
* </tr>
* <tr valign="top">
* <td>gecos</td>
* <td>
* GECOS is an obsolete term that refers to the finger
* information field on a Honeywell batch processing system.
* The field, however, lives on, and its contents have been
* formalized by POSIX. The field contains a comma separated
* list containing the user's full name, office phone, office
* number, and home phone number. On most systems, only the
* user's full name is available.
* </td>
* </tr>
* <tr valign="top">
* <td>dir</td>
* <td>
* This element contains the absolute path to the
* home directory of the user.
* </td>
* </tr>
* <tr valign="top">
* <td>shell</td>
* <td>
* The shell element contains the absolute path to the
* executable of the user's default shell.
* </td>
* </tr>
* </table>
*/
#[Pure]
#[ArrayShape([
'name' => 'string',
'passwd' => 'string',
'uid' => 'int',
'gid' => 'int',
'gecos' => 'string',
'dir' => 'string',
'shell' => 'string',
])]
function posix_getpwuid(int $user_id): array|false {}
/**
* Return info about system resource limits
* @link https://php.net/manual/en/function.posix-getrlimit.php
* @return array|false an associative array of elements for each
* limit that is defined. Each limit has a soft and a hard limit.
* <table>
* List of possible limits returned
* <tr valign="top">
* <td>Limit name</td>
* <td>Limit description</td>
* </tr>
* <tr valign="top">
* <td>core</td>
* <td>
* The maximum size of the core file. When 0, not core files are
* created. When core files are larger than this size, they will
* be truncated at this size.
* </td>
* </tr>
* <tr valign="top">
* <td>totalmem</td>
* <td>
* The maximum size of the memory of the process, in bytes.
* </td>
* </tr>
* <tr valign="top">
* <td>virtualmem</td>
* <td>
* The maximum size of the virtual memory for the process, in bytes.
* </td>
* </tr>
* <tr valign="top">
* <td>data</td>
* <td>
* The maximum size of the data segment for the process, in bytes.
* </td>
* </tr>
* <tr valign="top">
* <td>stack</td>
* <td>
* The maximum size of the process stack, in bytes.
* </td>
* </tr>
* <tr valign="top">
* <td>rss</td>
* <td>
* The maximum number of virtual pages resident in RAM
* </td>
* </tr>
* <tr valign="top">
* <td>maxproc</td>
* <td>
* The maximum number of processes that can be created for the
* real user ID of the calling process.
* </td>
* </tr>
* <tr valign="top">
* <td>memlock</td>
* <td>
* The maximum number of bytes of memory that may be locked into RAM.
* </td>
* </tr>
* <tr valign="top">
* <td>cpu</td>
* <td>
* The amount of time the process is allowed to use the CPU.
* </td>
* </tr>
* <tr valign="top">
* <td>filesize</td>
* <td>
* The maximum size of the data segment for the process, in bytes.
* </td>
* </tr>
* <tr valign="top">
* <td>openfiles</td>
* <td>
* One more than the maximum number of open file descriptors.
* </td>
* </tr>
* </table>
*/
#[Pure]
function posix_getrlimit(#[PhpStormStubsElementAvailable(from: '8.3')] ?int $resource = null): array|false {}
/**
* Retrieve the error number set by the last posix function that failed
* @link https://php.net/manual/en/function.posix-get-last-error.php
* @return int the errno (error number) set by the last posix function that
* failed. If no errors exist, 0 is returned.
*/
#[Pure(true)]
function posix_get_last_error(): int {}
/**
* Alias of <b>posix_get_last_error</b>
* @link https://php.net/manual/en/function.posix-errno.php
*/
#[Pure(true)]
function posix_errno(): int {}
/**
* Retrieve the system error message associated with the given errno
* @link https://php.net/manual/en/function.posix-strerror.php
* @param int $error_code <p>
* A POSIX error number, returned by
* <b>posix_get_last_error</b>. If set to 0, then the
* string "Success" is returned.
* </p>
* @return string the error message, as a string.
*/
#[Pure]
function posix_strerror(int $error_code): string {}
/**
* Calculate the group access list
* @link https://php.net/manual/en/function.posix-initgroups.php
* @param string $username <p>
* The user to calculate the list for.
* </p>
* @param int $group_id <p>
* Typically the group number from the password file.
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
#[Pure]
function posix_initgroups(string $username, int $group_id): bool {}
/**
* @since 8.3
*/
function posix_sysconf(int $conf_id): int {}
/**
* @since 8.3
*/
function posix_eaccess(string $filename, int $flags = 0): bool {}
/**
* Check whether the file exists.
* @link https://php.net/manual/en/posix.constants.php
*/
define('POSIX_F_OK', 0);
/**
* Check whether the file exists and has execute permissions.
* @link https://php.net/manual/en/posix.constants.php
*/
define('POSIX_X_OK', 1);
/**
* Check whether the file exists and has write permissions.
* @link https://php.net/manual/en/posix.constants.php
*/
define('POSIX_W_OK', 2);
/**
* Check whether the file exists and has read permissions.
* @link https://php.net/manual/en/posix.constants.php
*/
define('POSIX_R_OK', 4);
/**
* Normal file
* @link https://php.net/manual/en/posix.constants.php
*/
define('POSIX_S_IFREG', 32768);
/**
* Character special file
* @link https://php.net/manual/en/posix.constants.php
*/
define('POSIX_S_IFCHR', 8192);
/**
* Block special file
* @link https://php.net/manual/en/posix.constants.php
*/
define('POSIX_S_IFBLK', 24576);
/**
* FIFO (named pipe) special file
* @link https://php.net/manual/en/posix.constants.php
*/
define('POSIX_S_IFIFO', 4096);
/**
* Socket
* @link https://php.net/manual/en/posix.constants.php
*/
define('POSIX_S_IFSOCK', 49152);
/**
* The maximum size of the process's address space in bytes. See also PHP's memory_limit configuration directive.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_AS', 5);
/**
* The maximum size of a core file. If the limit is set to 0, no core file will be generated.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_CORE', 4);
/**
* The maximum amount of CPU time that the process can use, in seconds.
* When the soft limit is hit, a SIGXCPU signal will be sent, which can be caught with pcntl_signal().
* Depending on the operating system, additional SIGXCPU signals may be sent each second until the hard limit is hit,
* at which point an uncatchable SIGKILL signal is sent. See also set_time_limit().
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_CPU', 0);
/**
* The maximum size of the process's data segment, in bytes.
* It is extremely unlikely that this will have any effect on
* the execution of PHP unless an extension is in use that calls brk() or sbrk().
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_DATA', 2);
/**
* The maximum size of files that the process can create, in bytes.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_FSIZE', 1);
/**
* The maximum number of locks that the process can create.
* This is only supported on extremely old Linux kernels.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_LOCKS', 10);
/**
* The maximum number of bytes that can be allocated for POSIX message queues.
* PHP does not ship with support for POSIX message queues,
* so this limit will not have any effect unless you are using an extension that implements that support.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_MSGQUEUE', 12);
/**
* The maximum value to which the process can be <a href="https://php.net/manual/en/function.pcntl-setpriority.php"> reniced</a> to. The value that will be used will be 20 - limit, as resource limit values cannot be negative.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_NICE', 13);
/**
* The maximum real time priority that can be set via the sched_setscheduler() and sched_setparam() system calls.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_RTPRIO', 14);
/**
* The maximum amount of CPU time, in microseconds,
* that the process can consume without making a blocking system call if it is using real time scheduling.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_RTTIME', 15);
/**
* The maximum number of signals that can be queued for the real user ID of the process.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_SIGPENDING', 11);
/**
* The maximum number of bytes that can be locked into memory.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_MEMLOCK', 6);
/**
* A value one greater than the maximum file descriptor number that can be opened by this process.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_NOFILE', 8);
/**
* The maximum number of processes (and/or threads, on some operating systems)
* that can be created for the real user ID of the process.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_NPROC', 7);
/**
* The maximum size of the process's resident set, in pages.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_RSS', 5);
/**
* The maximum size of the process stack, in bytes.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_STACK', 3);
/**
* Used to indicate an infinite value for a resource limit.
* @link https://php.net/manual/en/posix.constants.setrlimit.php
*/
define('POSIX_RLIMIT_INFINITY', 9223372036854775807);
define('POSIX_SC_ARG_MAX', 0);
define('POSIX_SC_PAGESIZE', 30);
define('POSIX_SC_NPROCESSORS_CONF', 83);
define('POSIX_SC_NPROCESSORS_ONLN', 84);
define('POSIX_PC_LINK_MAX', 0);
define('POSIX_PC_MAX_CANON', 1);
define('POSIX_PC_MAX_INPUT', 2);
define('POSIX_PC_NAME_MAX', 3);
define('POSIX_PC_PATH_MAX', 4);
define('POSIX_PC_PIPE_BUF', 5);
define('POSIX_PC_CHOWN_RESTRICTED', 6);
define('POSIX_PC_NO_TRUNC', 7);
define('POSIX_PC_ALLOC_SIZE_MIN', 18);
define('POSIX_PC_SYMLINK_MAX', 19);
/**
* @since 8.4
*/
define('POSIX_SC_CHILD_MAX', 1);
/**
* @since 8.4
*/
define('POSIX_SC_CLK_TCK', 2);
// End of posix v.
<?php
/** @link https://github.com/krakjoe/pcov/blob/develop/README.md */
namespace {
define('pcov\all', 0);
define('pcov\inclusive', 1);
define('pcov\exclusive', 2);
define('pcov\version', '1.0.6');
}
namespace pcov
{
/**
* (PHP >= 7.0, PECL pcov >= 1.0.0)<br/>
* Shall start recording coverage information
* @return void
*/
function start() {}
/**
* (PHP >= 7.0, PECL pcov >= 1.0.0)<br/>
* Shall stop recording coverage information
* @return void
*/
function stop() {}
/**
* (PHP >= 7.0, PECL pcov >= 1.0.0)<br/>
* Shall collect coverage information
* @param int $type [optional] <p>
* pcov\all shall collect coverage information for all files
* pcov\inclusive shall collect coverage information for the specified files
* pcov\exclusive shall collect coverage information for all but the specified files
* </p>
* @param array $filter <p>
* path of files (realpath) that should be filtered
* </p>
* @return array
*/
function collect(int $type = all, array $filter = []) {}
/**
* (PHP >= 7.0, PECL pcov >= 1.0.0)<br/>
* Shall clear stored information
* @param bool $files [optional] <p>
* set true to clear file tables
* Note: clearing the file tables may have surprising consequences
* </p>
* @return void
*/
function clear(bool $files = false) {}
/**
* (PHP >= 7.0, PECL pcov >= 1.0.0)<br/>
* Shall return list of files waiting to be collected
* @return array
*/
function waiting() {}
/**
* (PHP >= 7.0, PECL pcov >= 1.0.0)<br/>
* Shall return the current size of the trace and cfg arena
* @return int
*/
function memory() {}
}
<?php
// Start of pgsql v.
use JetBrains\PhpStorm\ArrayShape;
use JetBrains\PhpStorm\Internal\LanguageLevelTypeAware;
use JetBrains\PhpStorm\Internal\PhpStormStubsElementAvailable;
/**
* Open a PostgreSQL connection
* @link https://php.net/manual/en/function.pg-connect.php
* @param string $connection_string <p>
* The <i>connection_string</i> can be empty to use all default parameters, or it
* can contain one or more parameter settings separated by whitespace.
* Each parameter setting is in the form keyword = value. Spaces around
* the equal sign are optional. To write an empty value or a value
* containing spaces, surround it with single quotes, e.g., keyword =
* 'a value'. Single quotes and backslashes within the value must be
* escaped with a backslash, i.e., \' and \\.
* </p>
* <p>
* The currently recognized parameter keywords are:
* <i>host</i>, <i>hostaddr</i>, <i>port</i>,
* <i>dbname</i> (defaults to value of <i>user</i>),
* <i>user</i>,
* <i>password</i>, <i>connect_timeout</i>,
* <i>options</i>, <i>tty</i> (ignored), <i>sslmode</i>,
* <i>requiressl</i> (deprecated in favor of <i>sslmode</i>), and
* <i>service</i>. Which of these arguments exist depends
* on your PostgreSQL version.
* </p>
* <p>
* The <i>options</i> parameter can be used to set command line parameters
* to be invoked by the server.
* </p>
* @param int $flags <p>
* If <b>PGSQL_CONNECT_FORCE_NEW</b> is passed, then a new connection
* is created, even if the <i>connection_string</i> is identical to
* an existing connection.
* </p>
* @return resource|false PostgreSQL connection resource on success, <b>FALSE</b> on failure.
*/
#[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection|false'], default: 'resource|false')]
function pg_connect(
string $connection_string,
int $flags = 0,
#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] string $host = '',
#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] string $port = '',
#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] string $options = '',
#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] string $tty = '',
#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] string $dbname = '',
) {}
/**
* Open a persistent PostgreSQL connection
* @link https://php.net/manual/en/function.pg-pconnect.php
* @param string $connection_string <p>
* The <i>connection_string</i> can be empty to use all default parameters, or it
* can contain one or more parameter settings separated by whitespace.
* Each parameter setting is in the form keyword = value. Spaces around
* the equal sign are optional. To write an empty value or a value
* containing spaces, surround it with single quotes, e.g., keyword =
* 'a value'. Single quotes and backslashes within the value must be
* escaped with a backslash, i.e., \' and \\.
* </p>
* <p>
* The currently recognized parameter keywords are:
* <i>host</i>, <i>hostaddr</i>, <i>port</i>,
* <i>dbname</i>, <i>user</i>,
* <i>password</i>, <i>connect_timeout</i>,
* <i>options</i>, <i>tty</i> (ignored), <i>sslmode</i>,
* <i>requiressl</i> (deprecated in favor of <i>sslmode</i>), and
* <i>service</i>. Which of these arguments exist depends
* on your PostgreSQL version.
* </p>
* @param int $flags <p>
* If <b>PGSQL_CONNECT_FORCE_NEW</b> is passed, then a new connection
* is created, even if the <i>connection_string</i> is identical to
* an existing connection.
* </p>
* @return resource|false PostgreSQL connection resource on success, <b>FALSE</b> on failure.
*/
#[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection|false'], default: 'resource|false')]
function pg_pconnect(
string $connection_string,
#[PhpStormStubsElementAvailable(from: '8.0')] int $flags = 0,
#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] string $host = '',
#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] string $port = '',
#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] string $options = '',
#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] string $tty = '',
#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] string $dbname = '',
) {}
/**
* Closes a PostgreSQL connection
* @link https://php.net/manual/en/function.pg-close.php
* @param resource $connection [optional] <p>
* PostgreSQL database connection resource. When
* <i>connection</i> is not present, the default connection
* is used. The default connection is the last connection made by
* <b>pg_connect</b> or <b>pg_pconnect</b>.
* </p>
*/
#[LanguageLevelTypeAware(['8.3' => 'true'], default: 'bool')]
function pg_close(#[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection|null'], default: 'resource')] $connection = null) {}
/**
* Poll the status of an in-progress asynchronous PostgreSQL connection attempt.
* @link https://php.net/manual/en/function.pg-connect-poll.php
* @param resource $connection <p>
* PostgreSQL database connection resource.
* </p>
* @return int <b>PGSQL_POLLING_FAILED</b>, <b>PGSQL_POLLING_READING</b>, <b>PGSQL_POLLING_WRITING</b>,
* <b>PGSQL_POLLING_OK</b>, or <b>PGSQL_POLLING_ACTIVE</b>.
* @since 5.6
*/
function pg_connect_poll(
#[PhpStormStubsElementAvailable(from: '5.6', to: '7.4')] $connection = null,
#[PhpStormStubsElementAvailable(from: '8.0')] #[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection'], default: 'resource')] $connection
): int {}
/**
* Get connection status
* @link https://php.net/manual/en/function.pg-connection-status.php
* @param resource $connection <p>
* PostgreSQL database connection resource.
* </p>
* @return int <b>PGSQL_CONNECTION_OK</b> or
* <b>PGSQL_CONNECTION_BAD</b>.
*/
function pg_connection_status(#[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection'], default: 'resource')] $connection): int {}
/**
* Get connection is busy or not
* @link https://php.net/manual/en/function.pg-connection-busy.php
* @param resource $connection <p>
* PostgreSQL database connection resource.
* </p>
* @return bool <b>TRUE</b> if the connection is busy, <b>FALSE</b> otherwise.
*/
function pg_connection_busy(#[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection'], default: 'resource')] $connection): bool {}
/**
* Reset connection (reconnect)
* @link https://php.net/manual/en/function.pg-connection-reset.php
* @param resource $connection <p>
* PostgreSQL database connection resource.
* </p>
* @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure.
*/
function pg_connection_reset(#[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection'], default: 'resource')] $connection): bool {}
/**
* Get a read only handle to the socket underlying a PostgreSQL connection
* @link https://php.net/manual/en/function.pg-socket.php
* @param resource $connection <p>
* PostgreSQL database connection resource.
* </p>
* @return resource|false A socket resource on success or <b>FALSE</b> on failure.
* @since 5.6
*/
function pg_socket(#[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection'], default: 'resource')] $connection) {}
/**
* Returns the host name associated with the connection
* @link https://php.net/manual/en/function.pg-host.php
* @param resource $connection [optional] <p>
* PostgreSQL database connection resource. When
* <i>connection</i> is not present, the default connection
* is used. The default connection is the last connection made by
* <b>pg_connect</b> or <b>pg_pconnect</b>.
* </p>
* @return string|false A string containing the name of the host the
* <i>connection</i> is to, or <b>FALSE</b> on error.
*/
function pg_host(#[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection|null'], default: 'resource')] $connection = null): string {}
/**
* Get the database name
* @link https://php.net/manual/en/function.pg-dbname.php
* @param resource $connection [optional] <p>
* PostgreSQL database connection resource. When
* <i>connection</i> is not present, the default connection
* is used. The default connection is the last connection made by
* <b>pg_connect</b> or <b>pg_pconnect</b>.
* </p>
* @return string|false A string containing the name of the database the
* <i>connection</i> is to, or <b>FALSE</b> on error.
*/
function pg_dbname(#[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection|null'], default: 'resource')] $connection = null): string {}
/**
* Return the port number associated with the connection
* @link https://php.net/manual/en/function.pg-port.php
* @param resource $connection [optional] <p>
* PostgreSQL database connection resource. When
* <i>connection</i> is not present, the default connection
* is used. The default connection is the last connection made by
* <b>pg_connect</b> or <b>pg_pconnect</b>.
* </p>
* @return string A string containing the port number of the database server the connection is to, or empty string on error.
*/
function pg_port(#[LanguageLevelTypeAware(['8.1' => 'PgSql\Connection|null'], default: 'resource'