Configuration reference

Mago's analyzer is highly configurable, allowing you to tailor the analysis to your project's specific needs. All settings go under the [analyzer] table in your mago.toml file.

[analyzer]
# Disable a specific issue category
redundancy-issues = false

# Ignore a specific error code across the whole project
ignore = ["mixed-argument"]

# Use a baseline file to ignore existing issues
baseline = "analyzer-baseline.toml"

General options

Option	Type	Default	Description
excludes	string[]	[]	A list of paths or glob patterns to exclude from analysis.
ignore	string[]	[]	A list of specific issue codes to ignore globally.
baseline	string	null	Path to a baseline file to ignore listed issues. When specified, the analyzer will use this file as the default baseline, eliminating the need to pass --baseline on every run. Command-line --baseline arguments will override this setting.
baseline-variant	string	"loose"	The baseline format variant to use when generating new baselines. Options: "loose" (count-based, resilient to line changes) or "strict" (exact line matching). See Baseline Variants for details.

Tool-Specific Excludes

The excludes option here is additive to the global source.excludes defined in the [source] section of your configuration. Files excluded globally will always be excluded from analysis, and this option allows you to exclude additional files from the analyzer specifically.

For example:

[source]
excludes = ["cache/**"]  # Excluded from ALL tools

[analyzer]
excludes = ["tests/**/*.php"]  # Additionally excluded from analyzer only

Feature flags

These flags control specific, powerful analysis capabilities.

Option	Default	Description
find-unused-expressions	true	Find and report expressions whose results are not used (e.g., $a + $b;).
find-unused-definitions	true	Find and report unused definitions (e.g., private methods that are never called).
analyze-dead-code	true	Analyze code that appears to be unreachable.
memoize-properties	false	Track the literal values of class properties. Improves type inference but may increase memory usage.
allow-possibly-undefined-array-keys	true	Allow accessing array keys that may not be defined without reporting an issue.
check-throws	true	Check for unhandled thrown exceptions that are not caught or documented with @throws.
perform-heuristic-checks	true	Perform extra heuristic checks for potential issues that are not strict typing errors.
strict-list-index-checks	false	When true, requires any integer used as a list index to be provably non-negative.
no-boolean-literal-comparison	false	When true, disallows direct comparison to boolean literals (e.g., $a === true).
check-missing-type-hints	false	When true, reports missing type hints on parameters, properties, and return types.
check-closure-missing-type-hints	false	When true, checks closures for missing type hints when check-missing-type-hints is enabled.
check-arrow-function-missing-type-hints	false	When true, checks arrow functions for missing type hints when check-missing-type-hints is enabled.
register-super-globals	true	Automatically register PHP superglobals (e.g., $_GET, $_POST) for analysis.