PHPackages ramsey/devtools - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. ramsey/devtools ActiveComposer-plugin[Utility & Helpers](/categories/utility) ramsey/devtools =============== A Composer plugin to aid PHP library and application development. 2.1.0(1y ago)7134.7k↑200%320MITPHP ^8.1 Since Aug 28Pushed 1y ago3 watchersCompare [ Source](https://github.com/ramsey/devtools)[ Packagist](https://packagist.org/packages/ramsey/devtools)[ RSS](/packages/ramsey-devtools/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (22)Versions (16)Used By (20) ramsey/devtools =============== [](#ramseydevtools) **A Composer plugin to aid PHP library and application development.** [![Source Code](https://camo.githubusercontent.com/c571b6df43d3e6a4ae6b8ff56127011ded5d0b3bc922060e59e3ba1fc5e365bb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f736f757263652d72616d7365792f646576746f6f6c732d626c75652e7376673f7374796c653d666c61742d737175617265)](https://github.com/ramsey/devtools) [![Download Package](https://camo.githubusercontent.com/547c95c3b739528860ef9136c46517fbacc128f4c1a3f55e5e891474f2db7165/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f72616d7365792f646576746f6f6c732e7376673f7374796c653d666c61742d737175617265266c6162656c3d72656c65617365)](https://packagist.org/packages/ramsey/devtools) [![PHP Programming Language](https://camo.githubusercontent.com/4002731259cfcedaf0c41c073d575964220ec8e90f726c170acdf420b55e3404/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f72616d7365792f646576746f6f6c732e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d253233383839324246)](https://php.net) [![Read License](https://camo.githubusercontent.com/fca2333b7ea82a5eb09b7c9ed7fcf57680f0a5ea5d3aa1fe4b0889423f8670df/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f72616d7365792f646576746f6f6c732e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d6461726b6379616e)](https://github.com/ramsey/devtools/blob/main/LICENSE) [![Build Status](https://camo.githubusercontent.com/fa5b4a15b87c3d3bbe8c445daba9930bb376daa00db703174eb8e16a10622ec1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f72616d7365792f646576746f6f6c732d6c69622f636f6e74696e756f75732d696e746567726174696f6e2e796d6c3f6272616e63683d322e78267374796c653d666c61742d737175617265266c6f676f3d676974687562)](https://github.com/ramsey/devtools-lib/actions/workflows/continuous-integration.yml) [![Codecov Code Coverage](https://camo.githubusercontent.com/1c61b6b676dea3d7238fd81ab6734e2cb12beefa8f7b5cf3dc36086ed8d1ada0/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f67682f72616d7365792f646576746f6f6c732d6c69623f6c6162656c3d636f6465636f76266c6f676f3d636f6465636f76267374796c653d666c61742d737175617265)](https://codecov.io/gh/ramsey/devtools-lib) [![Psalm Type Coverage](https://camo.githubusercontent.com/ae699ed2bec5b98a93daa5dcb12a5604a2c15465063acf9a147b9ab6ee5fb685/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f7374796c653d666c61742d7371756172652675726c3d687474707325334125324625324673686570686572642e64657625324667697468756225324672616d736579253246646576746f6f6c732d6c6962253246636f766572616765)](https://shepherd.dev/github/ramsey/devtools-lib) About ----- [](#about) I created this [Composer](https://getcomposer.org) plugin because I got tired of making changes to development tools and scripts in my repositories, only to find I liked the change so much, I now needed to apply it to all my repositories. This is an effort to consolidate and simplify. These tools might not be for you, and that's okay. Maybe these tools help a lot, but you have different needs. That's also okay. You may create your own devtools, requiring [ramsey/devtools-lib](https://github.com/ramsey/devtools-lib) (the library code behind this plugin), to extend and add to these tools, creating your own Composer plugin. Of course, if you want to help improve these tools, I welcome your contributions. Feel free to open issues, ask about or request features, and submit PRs. I can't wait to see what you come up with. This project adheres to a [code of conduct](CODE_OF_CONDUCT.md). By participating in this project and its community, you are expected to uphold this code. Installation ------------ [](#installation) Install this package as a development dependency using [Composer](https://getcomposer.org). ``` composer require --dev ramsey/devtools ``` Usage ----- [](#usage) This package is a Composer plugin. This means Composer recognizes that it provides custom functionality to your `composer` command. After installation, type `composer list`, and you'll see a lot of new commands that this plugin provides. ``` composer list ``` ### Add a Command Prefix [](#add-a-command-prefix) The commands this plugin provides are all intermingled with the rest of the Composer commands, so it may be hard to find them all. We have a way to group them by command namespace, though. Open `composer.json` and add a `ramsey/devtools.command-prefix` property to the `extra` section. You may use any prefix you wish. ``` { "extra": { "ramsey/devtools": { "command-prefix": "my-prefix" } } } ``` Now, when you type `composer list` (or just `composer`), you'll see a section of commands that looks like this: ``` my-prefix my-prefix:analyze:all Runs all static analysis checks. my-prefix:analyze:phpstan Runs the PHPStan static analyzer. my-prefix:analyze:psalm Runs the Psalm static analyzer. my-prefix:build:clean Cleans the build/ directory. my-prefix:build:clean:all Cleans the build/ directory. my-prefix:build:clean:cache Cleans the build/cache/ directory. my-prefix:build:clean:coverage Cleans the build/coverage/ directory. my-prefix:changelog Support for working with Keep A Changelog. my-prefix:license Checks dependency licenses. my-prefix:lint:all Runs all linting checks. my-prefix:lint:fix Auto-fixes coding standards issues, if possible. my-prefix:lint:pds Validates project compliance with pds/skeleton. my-prefix:lint:style Checks for coding standards issues. my-prefix:lint:syntax Checks for syntax errors. my-prefix:test:all Runs linting, static analysis, and unit tests. my-prefix:test:coverage:ci Runs unit tests and generates CI coverage reports. my-prefix:test:coverage:html Runs unit tests and generates HTML coverage report. my-prefix:test:unit Runs unit tests. ``` You can also list commands by command prefix with `composer list my-prefix`. ### Extending or Overriding ramsey/devtools Commands [](#extending-or-overriding-ramseydevtools-commands) Maybe the commands ramsey/devtools provides don't do everything you need, or maybe you want to replace them entirely. The configuration allows you to do this! Using the `ramsey/devtools.commands` property in the `extra` section of `composer.json`, you may specify any command (*without* your custom prefix, if you've configured one) as having other scripts to run, in addition to the command's default behavior, or you may override the default behavior entirely. Specifying additional scripts works exactly like [writing custom commands](https://getcomposer.org/doc/articles/scripts.md#writing-custom-commands)in `composer.json`, but the location is different. Everything you can do with a custom Composer command, you can do here because they're the same thing. ``` { "extra": { "ramsey/devtools": { "command-prefix": "my-prefix", "commands": { "lint:all": { "script": "@mylint" }, "test:all": { "script": [ "@mylint", "@phpbench" ] } } } }, "scripts": { "mylint": "parallel-lint src tests", "phpbench": "phpbench run" } } ``` In this way, when you run `composer my-prefix:lint:all` or `composer my-prefix:test:all`, it will execute the default behavior first and then run your additional commands. To override the default behavior so that it doesn't run at all and only your scripts run, specify the `override` property and set it to `true`. ``` { "extra": { "ramsey/devtools": { "commands": { "lint:all": { "override": true, "script": "parallel-lint src tests" } } } } } ``` Contributing ------------ [](#contributing) Contributions are welcome! To contribute, please familiarize yourself with [CONTRIBUTING.md](CONTRIBUTING.md). Coordinated Disclosure ---------------------- [](#coordinated-disclosure) Keeping user information safe and secure is a top priority, and we welcome the contribution of external security researchers. If you believe you've found a security issue in software that is maintained in this repository, please read [SECURITY.md](SECURITY.md) for instructions on submitting a vulnerability report. Copyright and License --------------------- [](#copyright-and-license) The ramsey/devtools library is copyright © [Ben Ramsey](https://benramsey.com)and licensed for use under the terms of the MIT License (MIT). Please see [LICENSE](LICENSE) for more information. ### Health Score 48 — FairBetter than 95% of packages Maintenance44 Moderate activity, may be stable Popularity40 Moderate usage in the ecosystem Community25 Small or concentrated contributor base Maturity71 Established project with proven stability Bus Factor1 Top contributor holds 87% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~118 days Recently: every ~361 days Total 15 Last Release 439d ago Major Versions 1.7.1 → 2.0.02023-04-24 PHP version history (2 changes)1.0.0PHP ^7.4 || ^8 2.0.0PHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/f514481fa9cfdfd5dbcaccb3e5b480f18ea05ebf331cddf9b1c5a2a96a78fef5?d=identicon)[ramsey](/maintainers/ramsey) --- Top Contributors [![ramsey](https://avatars.githubusercontent.com/u/42941?v=4)](https://github.com/ramsey "ramsey (60 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![wldgrlc](https://avatars.githubusercontent.com/u/70677517?v=4)](https://github.com/wldgrlc "wldgrlc (3 commits)") --- Tags composer-plugindeveloper-toolsdevelopmentdevelopment-toolsdevtoolstoolsplugindevelopmenttools ### Embed Badge ![Health badge](/badges/ramsey-devtools/health.svg) ``` [![Health](https://phpackages.com/badges/ramsey-devtools/health.svg)](https://phpackages.com/packages/ramsey-devtools) ``` ### Alternatives [codeigniter4/devkit Development toolkit for CodeIgniter libraries and projects 68187.1k82](/packages/codeigniter4-devkit)[vaimo/composer-patches Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches. 2994.3M16](/packages/vaimo-composer-patches)[wp-cli/wp-cli-tests WP-CLI testing framework 422.7M87](/packages/wp-cli-wp-cli-tests)[dereuromark/cakephp-tools A CakePHP plugin containing lots of useful and reusable tools 338920.1k32](/packages/dereuromark-cakephp-tools)[drupal/core-dev require-dev dependencies from drupal/drupal; use in addition to drupal/core-recommended to run tests from drupal/core. 2021.0M277](/packages/drupal-core-dev) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)