README

Development QA toolchain bundle for my projects.

This package is a Composer metapackage that installs a curated set of development and code-quality tools together with shared coding standards.

Installing this package will pull in:

• phpmd/phpmd – PHP Mess Detector
• squizlabs/php_codesniffer – PHP Code Sniffer
• friendsofphp/php-cs-fixer – PHP CS Fixer
• maarsson/coding-standard – shared coding standards and sync tooling

Requirements

• PHP ^8.4
• Composer

Installation

1. Package installation

Install the package as a development dependency in your project:

composer require --dev maarsson/dev-tools

2. Project configuration (required)

To ensure the coding standards are applied automatically, you must configure Composer scripts in the target project.

2.1. Add a named sync script

In your project’s composer.json add:

{
  "scripts": {
    "coding-standard:sync": [
      "vendor/bin/sync-coding-standards.php"
    ]
  }
}

2.2. Run the sync script on install and update

Extend your project’s composer.json scripts section to include:

{
  "scripts": {
    "coding-standard:sync": [
      "vendor/bin/sync-coding-standards.php"
    ],
    "post-install-cmd": [
      "@coding-standard:sync"
    ],
    "post-update-cmd": [
      "@coding-standard:sync"
    ]
  }
}

With this setup, the coding standards are applied automatically.

Usage

For more info please read the maarsson/coding-standard package's readme.

Design philosophy

• maarsson/dev-tools defines what tools are installed
• maarsson/coding-standard defines how rulesets are applied
• The project decides when commands run

This separation keeps behavior explicit, predictable, and Composer-idiomatic.

License

MIT