# Psalm > Psalm is a static analysis tool for PHP that finds type-related bugs, checks docblock types and generics, detects security vulnerabilities with taint analysis, and can fix and refactor code automatically. Every documentation page is also available as Markdown: append `.md` to the page path (https://psalm.dev/docs/running_psalm/installation.md for https://psalm.dev/docs/running_psalm/installation/), or request the page URL with `Accept: text/markdown`. ## Docs - [About Psalm](https://psalm.dev/docs/README.md): Psalm is a static analysis tool that attempts to dig into your program and find as many type-related bugs as possible. ## Running Psalm - [Checking non-PHP files](https://psalm.dev/docs/running_psalm/checking_non_php_files.md): Psalm supports the ability to check various PHPish files by extending the `FileChecker` class. - [Running Psalm](https://psalm.dev/docs/running_psalm/command_line_usage.md): Once you've set up your config file, you can run Psalm from your project's root directory with - [Common questions](https://psalm.dev/docs/running_psalm/common_issues.md): Before opening an issue, check whether one of these is the explanation. - [Configuration](https://psalm.dev/docs/running_psalm/configuration.md): Psalm uses an XML config file (by default, `psalm.xml`). - [Dealing with code issues](https://psalm.dev/docs/running_psalm/dealing_with_code_issues.md): Psalm has a large number of code issues. - [Error levels](https://psalm.dev/docs/running_psalm/error_levels.md): Psalm can run at error levels 1 (strictest) through 8 (most lenient). - [Installation](https://psalm.dev/docs/running_psalm/installation.md): The latest version of Psalm requires PHP >= 8.2 and Composer. - [Using Psalm’s Language Server](https://psalm.dev/docs/running_psalm/language_server.md): Psalm now has built-in Language Server Compatibility support so you can run it in your favourite IDE. - [Authoring Plugins](https://psalm.dev/docs/running_psalm/plugins/authoring_plugins.md): Maintaining a library rather than a standalone plugin? - [Plugins: type system internals](https://psalm.dev/docs/running_psalm/plugins/plugins_type_system.md): Psalm's type system represents the types of variables within a program using different classes. - [Using Plugins](https://psalm.dev/docs/running_psalm/plugins/using_plugins.md): Psalm can be extended through plugins to find and fix domain-specific issues. - [Using Shepherd](https://psalm.dev/docs/running_psalm/shepherd.md): Shepherd stores the results of Psalm runs from CI for public GitHub projects. - [Upgrading to Psalm 7](https://psalm.dev/docs/running_psalm/upgrading_to_psalm_7.md): For most projects, upgrading is as simple as updating the Composer dependency ## Annotating code - [Adding assertions](https://psalm.dev/docs/annotating_code/adding_assertions.md): Psalm has five docblock annotations that allow you to specify that a function verifies facts about variables and properties - [Assertion syntax](https://psalm.dev/docs/annotating_code/assertion_syntax.md): Psalm’s assertion annotation supports a number of different assertions. - [Helping Psalm understand your library](https://psalm.dev/docs/annotating_code/library_authors.md): If you maintain a library, the people using it get better results from Psalm the more Psalm knows about your types. - [The Purity Model](https://psalm.dev/docs/annotating_code/purity_model.md): Psalm describes what a function, method or closure may do as a set of **capabilities**: permissions to perform particular side effects, such as writing a property or printing. - [Supported docblock annotations](https://psalm.dev/docs/annotating_code/supported_annotations.md): Psalm supports a wide range of docblock annotations. - [Templating](https://psalm.dev/docs/annotating_code/templated_annotations.md): Docblocks allow you to tell Psalm some simple information about how your code works. - [Array types](https://psalm.dev/docs/annotating_code/type_syntax/array_types.md): In PHP, the `array` type is commonly used to represent three different data structures - [Atomic types](https://psalm.dev/docs/annotating_code/type_syntax/atomic_types.md): Atomic types are the basic building block of all type information used in Psalm. - [Callable types](https://psalm.dev/docs/annotating_code/type_syntax/callable_types.md): Psalm supports a special format for `callable`s of the form. - [Conditional types](https://psalm.dev/docs/annotating_code/type_syntax/conditional_types.md): Psalm supports the equivalent of TypeScript’s conditional types. - [Intersection types](https://psalm.dev/docs/annotating_code/type_syntax/intersection_types.md): An annotation of the form `Type1&Type2&Type3` is an _Intersection Type_. - [Object types](https://psalm.dev/docs/annotating_code/type_syntax/object_types.md): Psalm supports specifying the properties of an object and their expected types, e.g. - [Other types](https://psalm.dev/docs/annotating_code/type_syntax/other_types.md) - [Scalar types](https://psalm.dev/docs/annotating_code/type_syntax/scalar_types.md): Integer ranges indicate an integer within a range, specified using generic syntax: `int`. - [Top types, bottom types](https://psalm.dev/docs/annotating_code/type_syntax/top_bottom_types.md): This is the _top type_ in PHP's type system, and represents a lack of type information. - [Union Types](https://psalm.dev/docs/annotating_code/type_syntax/union_types.md): An annotation of the form `Type1|Type2|Type3` is a _Union Type_. - [Utility types](https://psalm.dev/docs/annotating_code/type_syntax/utility_types.md): Psalm supports some _magical_ utility types that brings superpower to the PHP type system. - [Value types](https://psalm.dev/docs/annotating_code/type_syntax/value_types.md): Psalm also allows you to specify values in types. - [Type Variables](https://psalm.dev/docs/annotating_code/type_variables.md): A type variable is a placeholder type — rendered internally as `` `_0 ``, `` `_1 ``, … — that stands in for a class template parameter whose concrete type is not yet known. - [Typing in Psalm](https://psalm.dev/docs/annotating_code/typing_in_psalm.md): Psalm is able to interpret all PHPDoc type annotations, and use them to further understand the codebase. ## Security analysis (taint analysis) - [Security analysis annotations](https://psalm.dev/docs/security_analysis/annotations.md): See Custom taint sources. - [Custom Taint Sinks](https://psalm.dev/docs/security_analysis/custom_taint_sinks.md): The `@psalm-taint-sink ` annotation allows you to define a taint sink. - [Custom Taint Sources](https://psalm.dev/docs/security_analysis/custom_taint_sources.md): You can define your own taint sources with an annotation or a plugin. - [Security Analysis](https://psalm.dev/docs/security_analysis/index.md): Psalm tracks untrusted input as it moves through your code — through assignments, function calls, arrays, and properties — and reports whenever it reaches a dangerous operation. - [Taint Flow](https://psalm.dev/docs/security_analysis/taint_flow.md): Psalm builds a directed graph while it analyses the code: a *node* stands for a value in a place (a variable, an argument, the result of a call), an *edge* says that the value of one node flows int... ## Manipulating code - [Fixing Code](https://psalm.dev/docs/manipulating_code/fixing.md): Psalm is good at finding potential issues in large codebases, but once found, it can be something of a gargantuan task to fix all the issues. - [Refactoring Code](https://psalm.dev/docs/manipulating_code/refactoring.md): Sometimes you want to make big changes to your codebase like moving methods or classes. ## Issues - [Issue types](https://psalm.dev/docs/running_psalm/issues.md) - [AbstractInstantiation](https://psalm.dev/docs/running_psalm/issues/AbstractInstantiation.md) - [AbstractMethodCall](https://psalm.dev/docs/running_psalm/issues/AbstractMethodCall.md) - [AmbiguousConstantInheritance](https://psalm.dev/docs/running_psalm/issues/AmbiguousConstantInheritance.md) - [ArgumentTypeCoercion](https://psalm.dev/docs/running_psalm/issues/ArgumentTypeCoercion.md) - [AssignmentToVoid](https://psalm.dev/docs/running_psalm/issues/AssignmentToVoid.md) - [CallableByReferenceMismatch](https://psalm.dev/docs/running_psalm/issues/CallableByReferenceMismatch.md) - [CheckType](https://psalm.dev/docs/running_psalm/issues/CheckType.md) - [CircularReference](https://psalm.dev/docs/running_psalm/issues/CircularReference.md) - [ClassMustBeFinal](https://psalm.dev/docs/running_psalm/issues/ClassMustBeFinal.md) - [CliOnlyCall](https://psalm.dev/docs/running_psalm/issues/CliOnlyCall.md) - [CliOnlyInstancesUnguarded](https://psalm.dev/docs/running_psalm/issues/CliOnlyInstancesUnguarded.md) - [ComplexFunction](https://psalm.dev/docs/running_psalm/issues/ComplexFunction.md) - [ComplexMethod](https://psalm.dev/docs/running_psalm/issues/ComplexMethod.md) - [ConfigIssue](https://psalm.dev/docs/running_psalm/issues/ConfigIssue.md) - [ConflictingReferenceConstraint](https://psalm.dev/docs/running_psalm/issues/ConflictingReferenceConstraint.md) - [ConstantDeclarationInTrait](https://psalm.dev/docs/running_psalm/issues/ConstantDeclarationInTrait.md) - [ConstructorSignatureMismatch](https://psalm.dev/docs/running_psalm/issues/ConstructorSignatureMismatch.md) - [ContinueOutsideLoop](https://psalm.dev/docs/running_psalm/issues/ContinueOutsideLoop.md) - [DeprecatedClass](https://psalm.dev/docs/running_psalm/issues/DeprecatedClass.md) - [DeprecatedConstant](https://psalm.dev/docs/running_psalm/issues/DeprecatedConstant.md) - [DeprecatedFunction](https://psalm.dev/docs/running_psalm/issues/DeprecatedFunction.md) - [DeprecatedInterface](https://psalm.dev/docs/running_psalm/issues/DeprecatedInterface.md) - [DeprecatedMethod](https://psalm.dev/docs/running_psalm/issues/DeprecatedMethod.md) - [DeprecatedProperty](https://psalm.dev/docs/running_psalm/issues/DeprecatedProperty.md) - [DeprecatedSyntax](https://psalm.dev/docs/running_psalm/issues/DeprecatedSyntax.md) - [DeprecatedTrait](https://psalm.dev/docs/running_psalm/issues/DeprecatedTrait.md) - [DirectConstructorCall](https://psalm.dev/docs/running_psalm/issues/DirectConstructorCall.md) - [DocblockTypeContradiction](https://psalm.dev/docs/running_psalm/issues/DocblockTypeContradiction.md) - [DuplicateArrayKey](https://psalm.dev/docs/running_psalm/issues/DuplicateArrayKey.md) - [DuplicateClass](https://psalm.dev/docs/running_psalm/issues/DuplicateClass.md) - [DuplicateConstant](https://psalm.dev/docs/running_psalm/issues/DuplicateConstant.md) - [DuplicateEnumCase](https://psalm.dev/docs/running_psalm/issues/DuplicateEnumCase.md) - [DuplicateEnumCaseValue](https://psalm.dev/docs/running_psalm/issues/DuplicateEnumCaseValue.md) - [DuplicateFunction](https://psalm.dev/docs/running_psalm/issues/DuplicateFunction.md) - [DuplicateMethod](https://psalm.dev/docs/running_psalm/issues/DuplicateMethod.md) - [DuplicateParam](https://psalm.dev/docs/running_psalm/issues/DuplicateParam.md) - [DuplicateProperty](https://psalm.dev/docs/running_psalm/issues/DuplicateProperty.md) - [EmptyArrayAccess](https://psalm.dev/docs/running_psalm/issues/EmptyArrayAccess.md) - [ExtensionRequirementViolation](https://psalm.dev/docs/running_psalm/issues/ExtensionRequirementViolation.md) - [FalsableReturnStatement](https://psalm.dev/docs/running_psalm/issues/FalsableReturnStatement.md) - [FalseOperand](https://psalm.dev/docs/running_psalm/issues/FalseOperand.md) - [ForbiddenCode](https://psalm.dev/docs/running_psalm/issues/ForbiddenCode.md) - [HiddenGeneratorReturn](https://psalm.dev/docs/running_psalm/issues/HiddenGeneratorReturn.md) - [IfThisIsMismatch](https://psalm.dev/docs/running_psalm/issues/IfThisIsMismatch.md) - [ImmutableDependency](https://psalm.dev/docs/running_psalm/issues/ImmutableDependency.md) - [ImplementationRequirementViolation](https://psalm.dev/docs/running_psalm/issues/ImplementationRequirementViolation.md) - [ImplementedParamTypeMismatch](https://psalm.dev/docs/running_psalm/issues/ImplementedParamTypeMismatch.md) - [ImplementedReturnTypeMismatch](https://psalm.dev/docs/running_psalm/issues/ImplementedReturnTypeMismatch.md) - [ImplicitFloatToIntCast](https://psalm.dev/docs/running_psalm/issues/ImplicitFloatToIntCast.md) - [ImplicitToStringCast](https://psalm.dev/docs/running_psalm/issues/ImplicitToStringCast.md) - [ImpureByReferenceAssignment](https://psalm.dev/docs/running_psalm/issues/ImpureByReferenceAssignment.md) - [ImpureFunctionCall](https://psalm.dev/docs/running_psalm/issues/ImpureFunctionCall.md) - [ImpureGlobalVariable](https://psalm.dev/docs/running_psalm/issues/ImpureGlobalVariable.md) - [ImpureMethodCall](https://psalm.dev/docs/running_psalm/issues/ImpureMethodCall.md) - [ImpurePropertyAssignment](https://psalm.dev/docs/running_psalm/issues/ImpurePropertyAssignment.md) - [ImpurePropertyFetch](https://psalm.dev/docs/running_psalm/issues/ImpurePropertyFetch.md) - [ImpureStaticProperty](https://psalm.dev/docs/running_psalm/issues/ImpureStaticProperty.md) - [ImpureStaticVariable](https://psalm.dev/docs/running_psalm/issues/ImpureStaticVariable.md) - [ImpureVariable](https://psalm.dev/docs/running_psalm/issues/ImpureVariable.md) - [InaccessibleClassConstant](https://psalm.dev/docs/running_psalm/issues/InaccessibleClassConstant.md) - [InaccessibleMethod](https://psalm.dev/docs/running_psalm/issues/InaccessibleMethod.md) - [InaccessibleProperty](https://psalm.dev/docs/running_psalm/issues/InaccessibleProperty.md) - [IncompatibleTypeParameters](https://psalm.dev/docs/running_psalm/issues/IncompatibleTypeParameters.md) - [InheritorViolation](https://psalm.dev/docs/running_psalm/issues/InheritorViolation.md) - [InsecureCookie](https://psalm.dev/docs/running_psalm/issues/InsecureCookie.md) - [IntMaskComparison](https://psalm.dev/docs/running_psalm/issues/IntMaskComparison.md) - [InterfaceInstantiation](https://psalm.dev/docs/running_psalm/issues/InterfaceInstantiation.md) - [InternalClass](https://psalm.dev/docs/running_psalm/issues/InternalClass.md) - [InternalMethod](https://psalm.dev/docs/running_psalm/issues/InternalMethod.md) - [InternalProperty](https://psalm.dev/docs/running_psalm/issues/InternalProperty.md) - [InvalidArgument](https://psalm.dev/docs/running_psalm/issues/InvalidArgument.md) - [InvalidArrayAccess](https://psalm.dev/docs/running_psalm/issues/InvalidArrayAccess.md) - [InvalidArrayAssignment](https://psalm.dev/docs/running_psalm/issues/InvalidArrayAssignment.md) - [InvalidArrayOffset](https://psalm.dev/docs/running_psalm/issues/InvalidArrayOffset.md) - [InvalidAttribute](https://psalm.dev/docs/running_psalm/issues/InvalidAttribute.md) - [InvalidCast](https://psalm.dev/docs/running_psalm/issues/InvalidCast.md) - [InvalidCatch](https://psalm.dev/docs/running_psalm/issues/InvalidCatch.md) - [InvalidClass](https://psalm.dev/docs/running_psalm/issues/InvalidClass.md) - [InvalidClassConstantType](https://psalm.dev/docs/running_psalm/issues/InvalidClassConstantType.md) - [InvalidClone](https://psalm.dev/docs/running_psalm/issues/InvalidClone.md) - [InvalidConstantAssignmentValue](https://psalm.dev/docs/running_psalm/issues/InvalidConstantAssignmentValue.md) - [InvalidDocblock](https://psalm.dev/docs/running_psalm/issues/InvalidDocblock.md) - [InvalidDocblockParamName](https://psalm.dev/docs/running_psalm/issues/InvalidDocblockParamName.md) - [InvalidEnumBackingType](https://psalm.dev/docs/running_psalm/issues/InvalidEnumBackingType.md) - [InvalidEnumCaseValue](https://psalm.dev/docs/running_psalm/issues/InvalidEnumCaseValue.md) - [InvalidEnumMethod](https://psalm.dev/docs/running_psalm/issues/InvalidEnumMethod.md) - [InvalidExtendClass](https://psalm.dev/docs/running_psalm/issues/InvalidExtendClass.md) - [InvalidFalsableReturnType](https://psalm.dev/docs/running_psalm/issues/InvalidFalsableReturnType.md) - [InvalidFunctionCall](https://psalm.dev/docs/running_psalm/issues/InvalidFunctionCall.md) - [InvalidGlobal](https://psalm.dev/docs/running_psalm/issues/InvalidGlobal.md) - [InvalidInterfaceImplementation](https://psalm.dev/docs/running_psalm/issues/InvalidInterfaceImplementation.md) - [InvalidIterator](https://psalm.dev/docs/running_psalm/issues/InvalidIterator.md) - [InvalidLiteralArgument](https://psalm.dev/docs/running_psalm/issues/InvalidLiteralArgument.md) - [InvalidMethodCall](https://psalm.dev/docs/running_psalm/issues/InvalidMethodCall.md) - [InvalidNamedArgument](https://psalm.dev/docs/running_psalm/issues/InvalidNamedArgument.md) - [InvalidNullableReturnType](https://psalm.dev/docs/running_psalm/issues/InvalidNullableReturnType.md) - [InvalidOperand](https://psalm.dev/docs/running_psalm/issues/InvalidOperand.md) - [InvalidOverride](https://psalm.dev/docs/running_psalm/issues/InvalidOverride.md) - [InvalidParamDefault](https://psalm.dev/docs/running_psalm/issues/InvalidParamDefault.md) - [InvalidParent](https://psalm.dev/docs/running_psalm/issues/InvalidParent.md) - [InvalidPassByReference](https://psalm.dev/docs/running_psalm/issues/InvalidPassByReference.md) - [InvalidPropertyAssignment](https://psalm.dev/docs/running_psalm/issues/InvalidPropertyAssignment.md) - [InvalidPropertyAssignmentValue](https://psalm.dev/docs/running_psalm/issues/InvalidPropertyAssignmentValue.md) - [InvalidPropertyFetch](https://psalm.dev/docs/running_psalm/issues/InvalidPropertyFetch.md) - [InvalidReturnStatement](https://psalm.dev/docs/running_psalm/issues/InvalidReturnStatement.md) - [InvalidReturnType](https://psalm.dev/docs/running_psalm/issues/InvalidReturnType.md) - [InvalidScalarArgument](https://psalm.dev/docs/running_psalm/issues/InvalidScalarArgument.md) - [InvalidScope](https://psalm.dev/docs/running_psalm/issues/InvalidScope.md) - [InvalidStaticInvocation](https://psalm.dev/docs/running_psalm/issues/InvalidStaticInvocation.md) - [InvalidStringClass](https://psalm.dev/docs/running_psalm/issues/InvalidStringClass.md) - [InvalidTemplateParam](https://psalm.dev/docs/running_psalm/issues/InvalidTemplateParam.md) - [InvalidThrow](https://psalm.dev/docs/running_psalm/issues/InvalidThrow.md) - [InvalidToString](https://psalm.dev/docs/running_psalm/issues/InvalidToString.md) - [InvalidTraversableImplementation](https://psalm.dev/docs/running_psalm/issues/InvalidTraversableImplementation.md) - [InvalidTypeImport](https://psalm.dev/docs/running_psalm/issues/InvalidTypeImport.md) - [LessSpecificClassConstantType](https://psalm.dev/docs/running_psalm/issues/LessSpecificClassConstantType.md) - [LessSpecificImplementedReturnType](https://psalm.dev/docs/running_psalm/issues/LessSpecificImplementedReturnType.md) - [LessSpecificReturnStatement](https://psalm.dev/docs/running_psalm/issues/LessSpecificReturnStatement.md) - [LessSpecificReturnType](https://psalm.dev/docs/running_psalm/issues/LessSpecificReturnType.md) - [LiteralKeyUnshapedArray](https://psalm.dev/docs/running_psalm/issues/LiteralKeyUnshapedArray.md) - [LoopInvalidation](https://psalm.dev/docs/running_psalm/issues/LoopInvalidation.md) - [MethodSignatureMismatch](https://psalm.dev/docs/running_psalm/issues/MethodSignatureMismatch.md) - [MethodSignatureMustOmitReturnType](https://psalm.dev/docs/running_psalm/issues/MethodSignatureMustOmitReturnType.md) - [MethodSignatureMustProvideReturnType](https://psalm.dev/docs/running_psalm/issues/MethodSignatureMustProvideReturnType.md) - [MismatchingDocblockParamType](https://psalm.dev/docs/running_psalm/issues/MismatchingDocblockParamType.md) - [MismatchingDocblockPropertyType](https://psalm.dev/docs/running_psalm/issues/MismatchingDocblockPropertyType.md) - [MismatchingDocblockReturnType](https://psalm.dev/docs/running_psalm/issues/MismatchingDocblockReturnType.md) - [MissingAbstractPureAnnotation](https://psalm.dev/docs/running_psalm/issues/MissingAbstractPureAnnotation.md) - [MissingClassConstType](https://psalm.dev/docs/running_psalm/issues/MissingClassConstType.md) - [MissingClosureParamType](https://psalm.dev/docs/running_psalm/issues/MissingClosureParamType.md) - [MissingClosureReturnType](https://psalm.dev/docs/running_psalm/issues/MissingClosureReturnType.md) - [MissingConstructor](https://psalm.dev/docs/running_psalm/issues/MissingConstructor.md) - [MissingDependency](https://psalm.dev/docs/running_psalm/issues/MissingDependency.md) - [MissingDocblockType](https://psalm.dev/docs/running_psalm/issues/MissingDocblockType.md) - [MissingFile](https://psalm.dev/docs/running_psalm/issues/MissingFile.md) - [MissingImmutableAnnotation](https://psalm.dev/docs/running_psalm/issues/MissingImmutableAnnotation.md) - [MissingInterfaceImmutableAnnotation](https://psalm.dev/docs/running_psalm/issues/MissingInterfaceImmutableAnnotation.md) - [MissingOverrideAttribute](https://psalm.dev/docs/running_psalm/issues/MissingOverrideAttribute.md) - [MissingParamType](https://psalm.dev/docs/running_psalm/issues/MissingParamType.md) - [MissingPropertyType](https://psalm.dev/docs/running_psalm/issues/MissingPropertyType.md) - [MissingPureAnnotation](https://psalm.dev/docs/running_psalm/issues/MissingPureAnnotation.md) - [MissingReturnType](https://psalm.dev/docs/running_psalm/issues/MissingReturnType.md) - [MissingTemplateParam](https://psalm.dev/docs/running_psalm/issues/MissingTemplateParam.md) - [MissingThrowsDocblock](https://psalm.dev/docs/running_psalm/issues/MissingThrowsDocblock.md) - [MixedArgument](https://psalm.dev/docs/running_psalm/issues/MixedArgument.md) - [MixedArgumentTypeCoercion](https://psalm.dev/docs/running_psalm/issues/MixedArgumentTypeCoercion.md) - [MixedArrayAccess](https://psalm.dev/docs/running_psalm/issues/MixedArrayAccess.md) - [MixedArrayAssignment](https://psalm.dev/docs/running_psalm/issues/MixedArrayAssignment.md) - [MixedArrayOffset](https://psalm.dev/docs/running_psalm/issues/MixedArrayOffset.md) - [MixedArrayTypeCoercion](https://psalm.dev/docs/running_psalm/issues/MixedArrayTypeCoercion.md) - [MixedAssignment](https://psalm.dev/docs/running_psalm/issues/MixedAssignment.md) - [MixedClone](https://psalm.dev/docs/running_psalm/issues/MixedClone.md) - [MixedFunctionCall](https://psalm.dev/docs/running_psalm/issues/MixedFunctionCall.md) - [MixedMethodCall](https://psalm.dev/docs/running_psalm/issues/MixedMethodCall.md) - [MixedOperand](https://psalm.dev/docs/running_psalm/issues/MixedOperand.md) - [MixedPropertyAssignment](https://psalm.dev/docs/running_psalm/issues/MixedPropertyAssignment.md) - [MixedPropertyFetch](https://psalm.dev/docs/running_psalm/issues/MixedPropertyFetch.md) - [MixedPropertyTypeCoercion](https://psalm.dev/docs/running_psalm/issues/MixedPropertyTypeCoercion.md) - [MixedReturnStatement](https://psalm.dev/docs/running_psalm/issues/MixedReturnStatement.md) - [MixedReturnTypeCoercion](https://psalm.dev/docs/running_psalm/issues/MixedReturnTypeCoercion.md) - [MixedStringOffsetAssignment](https://psalm.dev/docs/running_psalm/issues/MixedStringOffsetAssignment.md) - [MoreSpecificImplementedParamType](https://psalm.dev/docs/running_psalm/issues/MoreSpecificImplementedParamType.md) - [MoreSpecificReturnType](https://psalm.dev/docs/running_psalm/issues/MoreSpecificReturnType.md) - [MutableDependency](https://psalm.dev/docs/running_psalm/issues/MutableDependency.md) - [NamedArgumentNotAllowed](https://psalm.dev/docs/running_psalm/issues/NamedArgumentNotAllowed.md) - [NoEnumProperties](https://psalm.dev/docs/running_psalm/issues/NoEnumProperties.md) - [NoInterfaceProperties](https://psalm.dev/docs/running_psalm/issues/NoInterfaceProperties.md) - [NoValue](https://psalm.dev/docs/running_psalm/issues/NoValue.md) - [NonInvariantDocblockPropertyType](https://psalm.dev/docs/running_psalm/issues/NonInvariantDocblockPropertyType.md) - [NonInvariantPropertyType](https://psalm.dev/docs/running_psalm/issues/NonInvariantPropertyType.md) - [NonStaticSelfCall](https://psalm.dev/docs/running_psalm/issues/NonStaticSelfCall.md) - [NonVariableReferenceReturn](https://psalm.dev/docs/running_psalm/issues/NonVariableReferenceReturn.md) - [NullArgument](https://psalm.dev/docs/running_psalm/issues/NullArgument.md) - [NullArrayAccess](https://psalm.dev/docs/running_psalm/issues/NullArrayAccess.md) - [NullArrayOffset](https://psalm.dev/docs/running_psalm/issues/NullArrayOffset.md) - [NullFunctionCall](https://psalm.dev/docs/running_psalm/issues/NullFunctionCall.md) - [NullIterator](https://psalm.dev/docs/running_psalm/issues/NullIterator.md) - [NullOperand](https://psalm.dev/docs/running_psalm/issues/NullOperand.md) - [NullPropertyAssignment](https://psalm.dev/docs/running_psalm/issues/NullPropertyAssignment.md) - [NullPropertyFetch](https://psalm.dev/docs/running_psalm/issues/NullPropertyFetch.md) - [NullReference](https://psalm.dev/docs/running_psalm/issues/NullReference.md) - [NullableReturnStatement](https://psalm.dev/docs/running_psalm/issues/NullableReturnStatement.md) - [OverriddenFinalConstant](https://psalm.dev/docs/running_psalm/issues/OverriddenFinalConstant.md) - [OverriddenFinalProperty](https://psalm.dev/docs/running_psalm/issues/OverriddenFinalProperty.md) - [OverriddenInterfaceConstant](https://psalm.dev/docs/running_psalm/issues/OverriddenInterfaceConstant.md) - [OverriddenMethodAccess](https://psalm.dev/docs/running_psalm/issues/OverriddenMethodAccess.md) - [OverriddenPropertyAccess](https://psalm.dev/docs/running_psalm/issues/OverriddenPropertyAccess.md) - [ParadoxicalCondition](https://psalm.dev/docs/running_psalm/issues/ParadoxicalCondition.md) - [ParamNameMismatch](https://psalm.dev/docs/running_psalm/issues/ParamNameMismatch.md) - [ParentNotFound](https://psalm.dev/docs/running_psalm/issues/ParentNotFound.md) - [ParseError](https://psalm.dev/docs/running_psalm/issues/ParseError.md) - [PluginIssue](https://psalm.dev/docs/running_psalm/issues/PluginIssue.md) - [PositionalArgumentNotAllowed](https://psalm.dev/docs/running_psalm/issues/PositionalArgumentNotAllowed.md) - [PossibleRawObjectIteration](https://psalm.dev/docs/running_psalm/issues/PossibleRawObjectIteration.md) - [PossiblyFalseArgument](https://psalm.dev/docs/running_psalm/issues/PossiblyFalseArgument.md) - [PossiblyFalseIterator](https://psalm.dev/docs/running_psalm/issues/PossiblyFalseIterator.md) - [PossiblyFalseOperand](https://psalm.dev/docs/running_psalm/issues/PossiblyFalseOperand.md) - [PossiblyFalsePropertyAssignmentValue](https://psalm.dev/docs/running_psalm/issues/PossiblyFalsePropertyAssignmentValue.md) - [PossiblyFalseReference](https://psalm.dev/docs/running_psalm/issues/PossiblyFalseReference.md) - [PossiblyInvalidArgument](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidArgument.md) - [PossiblyInvalidArrayAccess](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidArrayAccess.md) - [PossiblyInvalidArrayAssignment](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidArrayAssignment.md) - [PossiblyInvalidArrayOffset](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidArrayOffset.md) - [PossiblyInvalidCast](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidCast.md) - [PossiblyInvalidClone](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidClone.md) - [PossiblyInvalidDocblockTag](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidDocblockTag.md) - [PossiblyInvalidFunctionCall](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidFunctionCall.md) - [PossiblyInvalidIterator](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidIterator.md) - [PossiblyInvalidMethodCall](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidMethodCall.md) - [PossiblyInvalidOperand](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidOperand.md) - [PossiblyInvalidPropertyAssignment](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidPropertyAssignment.md) - [PossiblyInvalidPropertyAssignmentValue](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidPropertyAssignmentValue.md) - [PossiblyInvalidPropertyFetch](https://psalm.dev/docs/running_psalm/issues/PossiblyInvalidPropertyFetch.md) - [PossiblyNullArgument](https://psalm.dev/docs/running_psalm/issues/PossiblyNullArgument.md) - [PossiblyNullArrayAccess](https://psalm.dev/docs/running_psalm/issues/PossiblyNullArrayAccess.md) - [PossiblyNullArrayAssignment](https://psalm.dev/docs/running_psalm/issues/PossiblyNullArrayAssignment.md) - [PossiblyNullArrayOffset](https://psalm.dev/docs/running_psalm/issues/PossiblyNullArrayOffset.md) - [PossiblyNullFunctionCall](https://psalm.dev/docs/running_psalm/issues/PossiblyNullFunctionCall.md) - [PossiblyNullIterator](https://psalm.dev/docs/running_psalm/issues/PossiblyNullIterator.md) - [PossiblyNullOperand](https://psalm.dev/docs/running_psalm/issues/PossiblyNullOperand.md) - [PossiblyNullPropertyAssignment](https://psalm.dev/docs/running_psalm/issues/PossiblyNullPropertyAssignment.md) - [PossiblyNullPropertyAssignmentValue](https://psalm.dev/docs/running_psalm/issues/PossiblyNullPropertyAssignmentValue.md) - [PossiblyNullPropertyFetch](https://psalm.dev/docs/running_psalm/issues/PossiblyNullPropertyFetch.md) - [PossiblyNullReference](https://psalm.dev/docs/running_psalm/issues/PossiblyNullReference.md) - [PossiblyUndefinedArrayOffset](https://psalm.dev/docs/running_psalm/issues/PossiblyUndefinedArrayOffset.md) - [PossiblyUndefinedGlobalVariable](https://psalm.dev/docs/running_psalm/issues/PossiblyUndefinedGlobalVariable.md) - [PossiblyUndefinedIntArrayOffset](https://psalm.dev/docs/running_psalm/issues/PossiblyUndefinedIntArrayOffset.md) - [PossiblyUndefinedMethod](https://psalm.dev/docs/running_psalm/issues/PossiblyUndefinedMethod.md) - [PossiblyUndefinedStringArrayOffset](https://psalm.dev/docs/running_psalm/issues/PossiblyUndefinedStringArrayOffset.md) - [PossiblyUndefinedVariable](https://psalm.dev/docs/running_psalm/issues/PossiblyUndefinedVariable.md) - [PossiblyUnusedMethod](https://psalm.dev/docs/running_psalm/issues/PossiblyUnusedMethod.md) - [PossiblyUnusedParam](https://psalm.dev/docs/running_psalm/issues/PossiblyUnusedParam.md) - [PossiblyUnusedProperty](https://psalm.dev/docs/running_psalm/issues/PossiblyUnusedProperty.md) - [PossiblyUnusedReturnValue](https://psalm.dev/docs/running_psalm/issues/PossiblyUnusedReturnValue.md) - [PrivateFinalMethod](https://psalm.dev/docs/running_psalm/issues/PrivateFinalMethod.md) - [PropertyNotSetInConstructor](https://psalm.dev/docs/running_psalm/issues/PropertyNotSetInConstructor.md) - [PropertyTypeCoercion](https://psalm.dev/docs/running_psalm/issues/PropertyTypeCoercion.md) - [RawObjectIteration](https://psalm.dev/docs/running_psalm/issues/RawObjectIteration.md) - [RedundantCast](https://psalm.dev/docs/running_psalm/issues/RedundantCast.md) - [RedundantCastGivenDocblockType](https://psalm.dev/docs/running_psalm/issues/RedundantCastGivenDocblockType.md) - [RedundantCondition](https://psalm.dev/docs/running_psalm/issues/RedundantCondition.md) - [RedundantConditionGivenDocblockType](https://psalm.dev/docs/running_psalm/issues/RedundantConditionGivenDocblockType.md) - [RedundantFlag](https://psalm.dev/docs/running_psalm/issues/RedundantFlag.md) - [RedundantFunctionCall](https://psalm.dev/docs/running_psalm/issues/RedundantFunctionCall.md) - [RedundantFunctionCallGivenDocblockType](https://psalm.dev/docs/running_psalm/issues/RedundantFunctionCallGivenDocblockType.md) - [RedundantIdentityWithTrue](https://psalm.dev/docs/running_psalm/issues/RedundantIdentityWithTrue.md) - [RedundantPropertyInitializationCheck](https://psalm.dev/docs/running_psalm/issues/RedundantPropertyInitializationCheck.md) - [ReferenceConstraintViolation](https://psalm.dev/docs/running_psalm/issues/ReferenceConstraintViolation.md) - [ReferenceReusedFromConfusingScope](https://psalm.dev/docs/running_psalm/issues/ReferenceReusedFromConfusingScope.md) - [ReservedWord](https://psalm.dev/docs/running_psalm/issues/ReservedWord.md) - [RiskyCast](https://psalm.dev/docs/running_psalm/issues/RiskyCast.md) - [RiskyTruthyFalsyComparison](https://psalm.dev/docs/running_psalm/issues/RiskyTruthyFalsyComparison.md) - [StringIncrement](https://psalm.dev/docs/running_psalm/issues/StringIncrement.md) - [TaintedCallable](https://psalm.dev/docs/running_psalm/issues/TaintedCallable.md) - [TaintedCookie](https://psalm.dev/docs/running_psalm/issues/TaintedCookie.md) - [TaintedCustom](https://psalm.dev/docs/running_psalm/issues/TaintedCustom.md) - [TaintedEval](https://psalm.dev/docs/running_psalm/issues/TaintedEval.md) - [TaintedExtract](https://psalm.dev/docs/running_psalm/issues/TaintedExtract.md) - [TaintedFile](https://psalm.dev/docs/running_psalm/issues/TaintedFile.md) - [TaintedHeader](https://psalm.dev/docs/running_psalm/issues/TaintedHeader.md) - [TaintedHtml](https://psalm.dev/docs/running_psalm/issues/TaintedHtml.md) - [TaintedHtmlAttribute](https://psalm.dev/docs/running_psalm/issues/TaintedHtmlAttribute.md) - [TaintedInclude](https://psalm.dev/docs/running_psalm/issues/TaintedInclude.md) - [TaintedInput](https://psalm.dev/docs/running_psalm/issues/TaintedInput.md) - [TaintedLdap](https://psalm.dev/docs/running_psalm/issues/TaintedLdap.md) - [TaintedLlmPrompt](https://psalm.dev/docs/running_psalm/issues/TaintedLlmPrompt.md) - [TaintedNosql](https://psalm.dev/docs/running_psalm/issues/TaintedNosql.md) - [TaintedRedirect](https://psalm.dev/docs/running_psalm/issues/TaintedRedirect.md) - [TaintedSSRF](https://psalm.dev/docs/running_psalm/issues/TaintedSSRF.md) - [TaintedShell](https://psalm.dev/docs/running_psalm/issues/TaintedShell.md) - [TaintedSleep](https://psalm.dev/docs/running_psalm/issues/TaintedSleep.md) - [TaintedSql](https://psalm.dev/docs/running_psalm/issues/TaintedSql.md) - [TaintedSystemSecret](https://psalm.dev/docs/running_psalm/issues/TaintedSystemSecret.md) - [TaintedTextWithQuotes](https://psalm.dev/docs/running_psalm/issues/TaintedTextWithQuotes.md) - [TaintedUnserialize](https://psalm.dev/docs/running_psalm/issues/TaintedUnserialize.md) - [TaintedUrlComponent](https://psalm.dev/docs/running_psalm/issues/TaintedUrlComponent.md) - [TaintedUrlPath](https://psalm.dev/docs/running_psalm/issues/TaintedUrlPath.md) - [TaintedUrlScheme](https://psalm.dev/docs/running_psalm/issues/TaintedUrlScheme.md) - [TaintedUserSecret](https://psalm.dev/docs/running_psalm/issues/TaintedUserSecret.md) - [TaintedXpath](https://psalm.dev/docs/running_psalm/issues/TaintedXpath.md) - [TooFewArguments](https://psalm.dev/docs/running_psalm/issues/TooFewArguments.md) - [TooManyArguments](https://psalm.dev/docs/running_psalm/issues/TooManyArguments.md) - [TooManyTemplateParams](https://psalm.dev/docs/running_psalm/issues/TooManyTemplateParams.md) - [Trace](https://psalm.dev/docs/running_psalm/issues/Trace.md) - [TraitMethodSignatureMismatch](https://psalm.dev/docs/running_psalm/issues/TraitMethodSignatureMismatch.md) - [TypeDoesNotContainNull](https://psalm.dev/docs/running_psalm/issues/TypeDoesNotContainNull.md) - [TypeDoesNotContainType](https://psalm.dev/docs/running_psalm/issues/TypeDoesNotContainType.md) - [UncaughtThrowInGlobalScope](https://psalm.dev/docs/running_psalm/issues/UncaughtThrowInGlobalScope.md) - [UndefinedAttributeClass](https://psalm.dev/docs/running_psalm/issues/UndefinedAttributeClass.md) - [UndefinedClass](https://psalm.dev/docs/running_psalm/issues/UndefinedClass.md) - [UndefinedConstant](https://psalm.dev/docs/running_psalm/issues/UndefinedConstant.md) - [UndefinedDocblockClass](https://psalm.dev/docs/running_psalm/issues/UndefinedDocblockClass.md) - [UndefinedFunction](https://psalm.dev/docs/running_psalm/issues/UndefinedFunction.md) - [UndefinedGlobalVariable](https://psalm.dev/docs/running_psalm/issues/UndefinedGlobalVariable.md) - [UndefinedInterface](https://psalm.dev/docs/running_psalm/issues/UndefinedInterface.md) - [UndefinedInterfaceMethod](https://psalm.dev/docs/running_psalm/issues/UndefinedInterfaceMethod.md) - [UndefinedMagicMethod](https://psalm.dev/docs/running_psalm/issues/UndefinedMagicMethod.md) - [UndefinedMagicPropertyAssignment](https://psalm.dev/docs/running_psalm/issues/UndefinedMagicPropertyAssignment.md) - [UndefinedMagicPropertyFetch](https://psalm.dev/docs/running_psalm/issues/UndefinedMagicPropertyFetch.md) - [UndefinedMethod](https://psalm.dev/docs/running_psalm/issues/UndefinedMethod.md) - [UndefinedPropertyAssignment](https://psalm.dev/docs/running_psalm/issues/UndefinedPropertyAssignment.md) - [UndefinedPropertyFetch](https://psalm.dev/docs/running_psalm/issues/UndefinedPropertyFetch.md) - [UndefinedThisPropertyAssignment](https://psalm.dev/docs/running_psalm/issues/UndefinedThisPropertyAssignment.md) - [UndefinedThisPropertyFetch](https://psalm.dev/docs/running_psalm/issues/UndefinedThisPropertyFetch.md) - [UndefinedTrace](https://psalm.dev/docs/running_psalm/issues/UndefinedTrace.md) - [UndefinedTrait](https://psalm.dev/docs/running_psalm/issues/UndefinedTrait.md) - [UndefinedVariable](https://psalm.dev/docs/running_psalm/issues/UndefinedVariable.md) - [UnevaluatedCode](https://psalm.dev/docs/running_psalm/issues/UnevaluatedCode.md) - [UnhandledMatchCondition](https://psalm.dev/docs/running_psalm/issues/UnhandledMatchCondition.md) - [UnimplementedAbstractMethod](https://psalm.dev/docs/running_psalm/issues/UnimplementedAbstractMethod.md) - [UnimplementedInterfaceMethod](https://psalm.dev/docs/running_psalm/issues/UnimplementedInterfaceMethod.md) - [UninitializedProperty](https://psalm.dev/docs/running_psalm/issues/UninitializedProperty.md) - [UnnecessaryVarAnnotation](https://psalm.dev/docs/running_psalm/issues/UnnecessaryVarAnnotation.md) - [UnrecognizedExpression](https://psalm.dev/docs/running_psalm/issues/UnrecognizedExpression.md) - [UnrecognizedStatement](https://psalm.dev/docs/running_psalm/issues/UnrecognizedStatement.md) - [UnresolvableConstant](https://psalm.dev/docs/running_psalm/issues/UnresolvableConstant.md) - [UnresolvableInclude](https://psalm.dev/docs/running_psalm/issues/UnresolvableInclude.md) - [UnsafeGenericInstantiation](https://psalm.dev/docs/running_psalm/issues/UnsafeGenericInstantiation.md) - [UnsafeInstantiation](https://psalm.dev/docs/running_psalm/issues/UnsafeInstantiation.md) - [UnsupportedPropertyReferenceUsage](https://psalm.dev/docs/running_psalm/issues/UnsupportedPropertyReferenceUsage.md) - [UnsupportedReferenceUsage](https://psalm.dev/docs/running_psalm/issues/UnsupportedReferenceUsage.md) - [UnusedBaselineEntry](https://psalm.dev/docs/running_psalm/issues/UnusedBaselineEntry.md) - [UnusedClass](https://psalm.dev/docs/running_psalm/issues/UnusedClass.md) - [UnusedClosureParam](https://psalm.dev/docs/running_psalm/issues/UnusedClosureParam.md) - [UnusedConstructor](https://psalm.dev/docs/running_psalm/issues/UnusedConstructor.md) - [UnusedDocblockParam](https://psalm.dev/docs/running_psalm/issues/UnusedDocblockParam.md) - [UnusedForeachValue](https://psalm.dev/docs/running_psalm/issues/UnusedForeachValue.md) - [UnusedFunctionCall](https://psalm.dev/docs/running_psalm/issues/UnusedFunctionCall.md) - [UnusedIssueHandlerSuppression](https://psalm.dev/docs/running_psalm/issues/UnusedIssueHandlerSuppression.md) - [UnusedMethod](https://psalm.dev/docs/running_psalm/issues/UnusedMethod.md) - [UnusedMethodCall](https://psalm.dev/docs/running_psalm/issues/UnusedMethodCall.md) - [UnusedParam](https://psalm.dev/docs/running_psalm/issues/UnusedParam.md) - [UnusedProperty](https://psalm.dev/docs/running_psalm/issues/UnusedProperty.md) - [UnusedPsalmSuppress](https://psalm.dev/docs/running_psalm/issues/UnusedPsalmSuppress.md) - [UnusedReturnValue](https://psalm.dev/docs/running_psalm/issues/UnusedReturnValue.md) - [UnusedVariable](https://psalm.dev/docs/running_psalm/issues/UnusedVariable.md) - [WeakCipher](https://psalm.dev/docs/running_psalm/issues/WeakCipher.md) - [WeakHash](https://psalm.dev/docs/running_psalm/issues/WeakHash.md) - [WeakRandom](https://psalm.dev/docs/running_psalm/issues/WeakRandom.md) - [WrongCaseFunction](https://psalm.dev/docs/running_psalm/issues/WrongCaseFunction.md) - [XmlExternalEntity](https://psalm.dev/docs/running_psalm/issues/XmlExternalEntity.md) ## Playground - [Psalm playground](https://psalm.dev/): run Psalm on a PHP snippet in the browser. Saved snippets live at `https://psalm.dev/r/`; `https://psalm.dev/r/.json` returns the code and settings as JSON, `https://psalm.dev/r//raw` the code as plain text, and `https://psalm.dev/r//results` the analysis results as JSON ## Optional - [Adding a new issue type](https://psalm.dev/docs/contributing/adding_issues.md): To add a new issue type there are a number of required steps, listed below. - [Altering callmaps](https://psalm.dev/docs/contributing/editing_callmaps.md): One of the first things most contributors start with is proposing changes to callmaps. - [How Psalm works](https://psalm.dev/docs/contributing/how_psalm_works.md): The entry point for all analysis is `ProjectAnalyzer` - [Contributing to Psalm](https://psalm.dev/docs/contributing/index.md): Psalm is made possible through the contributions of hundreds of developers. - [Packaging Psalm](https://psalm.dev/docs/contributing/packaging.md): The official ways to install Psalm are the Composer package, the `psalm.phar` download, and the phar installed through Composer (see Installation). - [Philosophy](https://psalm.dev/docs/contributing/philosophy.md): This is about why Psalm is the way it is. - [Things that make developing Psalm complicated](https://psalm.dev/docs/contributing/what_makes_psalm_complicated.md): This is a somewhat informal list that might aid others. - [Plugins](https://psalm.dev/plugins): Psalm plugins published on Packagist - [Articles](https://psalm.dev/articles): articles about Psalm features and releases - [Configuration schema](https://psalm.dev/schema/config): XSD schema of psalm.xml - [Source code](https://github.com/vimeo/psalm): Psalm on GitHub