title: Formatter configuration reference

Configuration reference

While Mago's formatter is opinionated and works great out-of-the-box with its PER-CS compliant defaults, you can customize its behavior in your mago.toml file.

All settings go under the [formatter] table.

[formatter]
print-width = 100
use-tabs = true

Presets

Instead of configuring individual settings, you can use a preset that provides a complete set of formatter options optimized for specific coding standards.

[formatter]
preset = "laravel"

Available presets:

• "default" — PER-CS compliant settings (same as the default configuration)
• "psr-12" — Optimized for PSR-12 coding standard
• "laravel-pint" — Laravel Pint's 'laravel' preset
• "drupal" — Drupal's coding standard

Preset Versions

Presets support versioning to allow applications to pin to specific versions of coding standards:

[formatter]
preset = "psr-12@latest"  # Use the latest PSR-12 rules
preset = "psr-12"         # Same as above (latest is default)

Currently, only latest is supported for all presets. Future versions will allow pinning to specific standard versions (e.g., psr-12@1.0).

Combining presets with individual settings

You can combine a preset with individual settings. When you specify both, the preset provides the base configuration, and any individual settings you specify will override the preset values:

[formatter]
preset = "laravel"
print-width = 140  # Overrides the preset's print-width

This allows you to start with a preset that matches your project's coding standard and then fine-tune specific options as needed.

Configuration options

:::tip 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 formatting, and this option allows you to exclude additional files from the formatter specifically.

For example:

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

[formatter]
excludes = ["src/**/AutoGenerated/**/*.php"]  # Additionally excluded from formatter only

:::

:::tip Brace Style Options The brace style options accept three values:

• same-line: Opening brace always on the same line as the declaration
• next-line: Opening brace on the next line for single-line signatures; on the same line when the signature breaks across multiple lines
• always-next-line: Opening brace always on the next line, regardless of whether the signature breaks

For example, with method-brace-style = "next-line":

// Single-line signature - brace on next line
public function foo(): string
{
}

// Multi-line signature - brace on same line as return type
public function bar(
    string $veryLongParam,
): string {
}

With method-brace-style = "always-next-line":

// Multi-line signature - brace still on next line
public function bar(
    string $veryLongParam,
): string
{
}

:::