Modern PHP Tooling

README.md

Modern PHP Tooling

This is my personal collection of modern PHP Tooling that I setup for all of my Laravel projects.

Linting

1. Pint - Formatting

• Install Laravel Pint
• Setup strict config pint.json
• Setup PHPStorm File Watcher for Pint

2. PeckPHP - Fix Typos

• Install PeckPHP

3. RectorPHP - Use modern php syntax

• Install RectorPHP

Types

1. PHPStan - PHP Type Checker

• Install PHPStan

2. Larastan - Laravel Code Analysis

• Install LaraStan

3. Pinkary TypeGuard - Cleaner typed Variables

• Install TypeGuard

4. Setup phpstan.neon config

Testing

1. PestPHP - Testing Framework

• Install PestPHP
• In phpunit.xml comment in DB_CONNECTION & DB_DATABASE variables

2. Pest Type Coverage - Measure Type Coverage in the Code

• Install Type Coverage Plugin

Development Tools

1. Clockwork - Identify Performance Issues

• Install Clockwork
• Clockwork Browser Extension

2. Solo - Merge all running Terminals into one

• Install Solo
• Setup commands in solo.php config

3. Composer Scripts

composer.json

"scripts": {
    "lint": "pint",
      "refactor": "rector",
      "test:lint": "pint --test",
      "test:refactor": "rector --dry-run",
      "test:types": "phpstan analyse",
      "test:arch": "pest --filter=arch",
      "test:type-coverage": "pest --type-coverage --min=100",
      "test:unit": "pest --parallel --coverage --exactly=99.4",
      "test": [
          "@test:lint",
          "@test:refactor",
          "@test:types",
          "@test:type-coverage",
          "@test:unit"
    ]
}

phpstan.neon

includes:
    - vendor/larastan/larastan/extension.neon
    - vendor/phpstan/phpstan/conf/bleedingEdge.neon

parameters:
    level: max

    paths:
        - app
        - config
        - bootstrap
        - database/factories
        - routes

pint.json

{
    "preset": "laravel",
    "rules": {
        "array_push": true,
        "backtick_to_shell_exec": true,
        "declare_strict_types": true,
        "final_class": true,
        "fully_qualified_strict_types": true,
        "global_namespace_import": {
            "import_classes": true,
            "import_constants": true,
            "import_functions": true
        },
        "ordered_class_elements": {
            "order": [
                "use_trait",
                "case",
                "constant",
                "constant_public",
                "constant_protected",
                "constant_private",
                "property_public",
                "property_protected",
                "property_private",
                "construct",
                "destruct",
                "magic",
                "phpunit",
                "method_abstract",
                "method_public_static",
                "method_public",
                "method_protected_static",
                "method_protected",
                "method_private_static",
                "method_private"
            ],
            "sort_algorithm": "none"
        },
        "ordered_interfaces": true,
        "ordered_traits": true,
        "protected_to_private": true,
        "strict_comparison": true
    }
}

solo.php

'commands' => [
        'Vite' => 'bun dev',
        'Logs' => EnhancedTailCommand::file(storage_path('logs/laravel.log')),
        'Tests' => Command::from('php artisan test --colors=always --parallel')->lazy(),
        'Pint' => Command::from('./vendor/bin/pint')->lazy(),
        'Peck' => Command::from('./vendor/bin/peck')->lazy(),
        'Reverb' => Command::from('php artisan reverb')->lazy(),
        'Queue' => Command::from('php artisan queue:work')->lazy(),
        'Stripe' => Command::from('stripe listen --forward-to orysuite-app.test/stripe/webhook')->lazy(),
    ],