Presets

Standard Preset

The comprehensive preset for PHP 8.4+ projects. Includes all other presets plus extensive formatting and code quality rules.

Target PHP Version: 8.4+

Usage

<?php

use Cline\CodingStandard\PhpCsFixer\ConfigurationFactory;
use Cline\CodingStandard\PhpCsFixer\Preset\Standard;

return ConfigurationFactory::createFromPreset(new Standard());

What’s Included

The Standard preset combines:

• PHPDoc preset - All PHPDoc formatting rules
• PHPUnit preset - PHPUnit test formatting rules
• Ordered preset - Import and class element ordering rules
• 200+ formatting rules - Comprehensive code style enforcement
• Custom fixers - All architectural and naming convention fixers

Key Rules

Code Style

• strict_comparison - Enforces strict comparison operators (===, !==)
• strict_param - Enforces strict type checking in built-in functions
• declare_strict_types - Requires declare(strict_types=1)
• final_class - Makes all classes final by default
• global_namespace_import - Auto-imports classes, functions, and constants

Type Safety

• native_function_invocation - Optimizes native function calls with namespaced scope
• nullable_type_declaration_for_default_null_value - Adds nullable types for null defaults
• modernize_types_casting - Uses modern type casting syntax

Import Management

• global_namespace_import - Auto-imports from global namespace
  • import_classes: true
  • import_constants: true
  • import_functions: true

Header Comment

Automatically adds copyright header:

/**
 * Copyright (C) Brian Faust
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

Notable Disabled Rules

Some rules are disabled for practical reasons:

'date_time_immutable' => false,
// Disabled: Causes issues with Laravel's DateTime/CarbonInterface conversions

'no_unused_imports' => false,
// Disabled: PCRE2 pattern issues in PHP 8.4/PCRE2 10.44

'simplified_if_return' => false,
'simplified_null_return' => false,
// Disabled: Can reduce code clarity

PHPDoc Preset

Enforces consistent PHPDoc formatting, tag ordering, and alignment.

Target PHP Version: 8.2+

Usage

<?php

use Cline\CodingStandard\PhpCsFixer\ConfigurationFactory;
use Cline\CodingStandard\PhpCsFixer\Preset\PHPDoc;

return ConfigurationFactory::createFromPreset(new PHPDoc());

Key Rules

Alignment

'phpdoc_align' => [
    'align' => 'vertical',
    'tags' => ['method', 'param', 'property', 'return', 'throws', 'type', 'var'],
]

Aligns PHPDoc tags vertically:

/**
 * @param  string $name  The user name
 * @param  int    $age   The user age
 * @return User           The created user
 */

Tag Ordering

'phpdoc_order' => [
    'order' => [
        'deprecated',
        'internal',
        'covers',
        'uses',
        'dataProvider',
        'param',
        'throws',
        'return',
    ],
]

Tag Separation

'phpdoc_separation' => [
    'groups' => [
        ['deprecated', 'link', 'see', 'since'],
        ['author', 'copyright', 'license'],
        ['category', 'package', 'subpackage'],
        ['property', 'property-read', 'property-write'],
        ['param', 'return'],
    ],
]

Groups are separated by blank lines:

/**
 * @deprecated Will be removed in v2.0
 * @see UserRepository
 *
 * @author Brian Faust <brian@cline.sh>
 *
 * @param string $id
 * @return User|null
 */

Line Span

'phpdoc_line_span' => [
    'const' => 'multi',
    'method' => 'multi',
    'property' => 'multi',
]

Forces multi-line PHPDoc for constants, methods, and properties.

Custom PHPDoc Fixers

Includes additional fixers from kubawerlos/php-cs-fixer-custom-fixers:

• PhpdocNoSuperfluousParamFixer - Removes unnecessary @param tags
• PhpdocParamTypeFixer - Ensures correct param type format
• PhpdocSelfAccessorFixer - Standardizes @return self usage
• PhpdocSingleLineVarFixer - Formats single-line @var tags
• PhpdocTypesCommaSpacesFixer - Formats comma spacing in union types
• PhpdocTypesTrimFixer - Trims extra whitespace from types

PHPUnit Preset

Enforces modern PHPUnit testing standards and naming conventions.

Target PHP Version: 8.2+

Usage

<?php

use Cline\CodingStandard\PhpCsFixer\ConfigurationFactory;
use Cline\CodingStandard\PhpCsFixer\Preset\PHPUnit;

return ConfigurationFactory::createFromPreset(new PHPUnit());

Key Rules

Test Method Naming

'php_unit_method_casing' => [
    'case' => 'snake_case',
]

Enforces snake_case for test methods:

// ❌ Before
public function testUserCanLogin() {}

// ✅ After
public function test_user_can_login() {}

Data Providers

'php_unit_data_provider_name' => true,
'php_unit_data_provider_return_type' => true,
'php_unit_data_provider_static' => true,

Enforces data provider conventions:

public static function userDataProvider(): array
{
    return [
        'valid user' => ['John', 25],
        'young user' => ['Jane', 18],
    ];
}

Assertion Style

'php_unit_test_case_static_method_calls' => [
    'call_type' => 'self',
    'methods' => [],
]

Uses self:: for static assertions:

// ❌ Before
$this->assertTrue($value);
static::assertTrue($value);

// ✅ After
self::assertTrue($value);

Test Annotation

'php_unit_test_annotation' => [
    'style' => 'prefix',
]

Prefers test prefix over @test annotation:

// ❌ Before
/**
 * @test
 */
public function user_can_login() {}

// ✅ After
public function test_user_can_login() {}

Custom PHPUnit Fixers

• PhpUnitAssertArgumentsOrderFixer - Enforces correct assertion argument order
• PhpUnitDedicatedAssertFixer - Uses dedicated assertion methods
• PhpUnitNoUselessReturnFixer - Removes unnecessary returns in tests

Ordered Preset

Enforces consistent ordering of imports, class elements, attributes, interfaces, and traits.

Target PHP Version: 8.4+

Usage

<?php

use Cline\CodingStandard\PhpCsFixer\ConfigurationFactory;
use Cline\CodingStandard\PhpCsFixer\Preset\Ordered;

return ConfigurationFactory::createFromPreset(new Ordered());

Key Rules

Import Ordering

'ordered_imports' => [
    'imports_order' => ['class', 'const', 'function'],
    'sort_algorithm' => 'alpha',
]

Orders imports alphabetically by type:

// Classes first
use App\Models\User;
use App\Services\AuthService;

// Constants second
use const PHP_VERSION_ID;

// Functions last
use function array_merge;
use function sprintf;

Class Element Ordering

'ordered_class_elements' => [
    'order' => [
        'use_trait',
        'case',
        'constant_public',
        'constant_protected',
        'constant_private',
        'property_public_static',
        'property_public',
        'property_public_readonly',
        // ... (complete ordering)
        'construct',
        'destruct',
        'magic',
        'phpunit',
        'method_public_static',
        'method_public',
        // ...
    ],
]

Enforces strict class member ordering:

final class User
{
    use HasFactory;                           // Traits first

    public const STATUS_ACTIVE = 'active';    // Public constants
    private const MAX_ATTEMPTS = 3;           // Private constants

    public static int $count = 0;             // Public static properties
    public string $name;                      // Public properties
    private string $password;                 // Private properties

    public function __construct(string $name) // Constructor
    {
        $this->name = $name;
    }

    public static function create(): self    // Public static methods
    {
        return new self('');
    }

    public function getName(): string        // Public methods
    {
        return $this->name;
    }

    private function hash(): string          // Private methods
    {
        return password_hash($this->password, PASSWORD_DEFAULT);
    }
}

Attribute Ordering (Laravel Data)

Orders Spatie Laravel Data attributes consistently:

'ordered_attributes' => [
    'order' => [
        // Availability attributes
        Nullable::class,
        Required::class,
        // Complementary validation
        Accepted::class,
        Email::class,
        Max::class,
        // Behavior attributes
        Computed::class,
        Hidden::class,
        // ...
    ],
]

Example:

final readonly class UserData extends Data
{
    public function __construct(
        #[Required]
        #[Email]
        #[Max(255)]
        public string $email,
    ) {}
}

Interface Ordering

'ordered_interfaces' => [
    'direction' => 'ascend',
    'order' => 'alpha',
]

Orders implemented interfaces alphabetically:

// ✅ After
final class User implements Authenticatable, Authorizable, JsonSerializable
{
}

Combining Presets

Use Standard for Everything

The Standard preset already includes all other presets:

<?php

use Cline\CodingStandard\PhpCsFixer\ConfigurationFactory;
use Cline\CodingStandard\PhpCsFixer\Preset\Standard;

return ConfigurationFactory::createFromPreset(new Standard());

Manual Combination (Advanced)

For custom combinations, merge preset rules manually:

<?php

use Cline\CodingStandard\PhpCsFixer\ConfigurationFactory;
use Cline\CodingStandard\PhpCsFixer\Preset\PHPDoc;
use Cline\CodingStandard\PhpCsFixer\Preset\Ordered;

$rules = [
    ...new PHPDoc()->rules(),
    ...new Ordered()->rules(),
    // Add custom overrides
    'single_line_throw' => true,
];

return ConfigurationFactory::createFromRules($rules);

Preset Comparison

Feature	Standard	PHPDoc	PHPUnit	Ordered
PHP Version	8.4+	8.2+	8.2+	8.4+
PHPDoc Rules	✅	✅	❌	❌
PHPUnit Rules	✅	❌	✅	❌
Ordering Rules	✅	❌	❌	✅
Custom Fixers	✅	❌	❌	❌
Style Rules	✅	❌	❌	❌
Import Optimization	✅	❌	❌	✅

Overriding Preset Rules

All presets support rule overrides:

<?php

use Cline\CodingStandard\PhpCsFixer\ConfigurationFactory;
use Cline\CodingStandard\PhpCsFixer\Preset\Standard;

return ConfigurationFactory::createFromPreset(
    new Standard(),
    [
        'final_class' => false,              // Disable final class enforcement
        'phpdoc_align' => false,             // Disable PHPDoc alignment
        'php_unit_method_casing' => [
            'case' => 'camel_case',          // Override test method casing
        ],
    ]
);