PHPackages drush/drush-launcher - 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. [CLI & Console](/categories/cli) 4. / 5. drush/drush-launcher AbandonedArchivedLibrary[CLI & Console](/categories/cli) drush/drush-launcher ==================== Provides a drush executable for your global PATH 0.10.2(3y ago)24022.9k↓87.5%49[22 issues](https://github.com/drush-ops/drush-launcher/issues)GPL-2.0-or-laterPHP Since Oct 7Pushed 2y ago2 watchersCompare [ Source](https://github.com/drush-ops/drush-launcher)[ Packagist](https://packagist.org/packages/drush/drush-launcher)[ RSS](/packages/drush-drush-launcher/feed)WikiDiscussions master Synced today READMEChangelog (10)Dependencies (4)Versions (37)Used By (0) Alternatives now that this project is archived. ----------------------------------------------- [](#alternatives-now-that-this-project-is-archived) Add `./vendor/bin` to the front of your `$PATH`. This relative path works for any Drupal codebase on your system if you run commands from the project root. And it is harmless otherwise. Other options include [direnv](https://direnv.net/), [fd](https://github.com/g1a/fd), or the scripts [in this issue](https://github.com/drush-ops/drush-launcher/issues/105). Description ----------- [](#description) In order to avoid dependency issues, it is best to require Drush on a per-project basis via Composer (`composer require drush/drush`). This makes Drush available to your project by placing it at `vendor/bin/drush`. However, it is inconvenient to type `vendor/bin/drush` in order to execute Drush commands. By installing the drush launcher globally on your local machine, you can simply type `drush` on the command line, and the launcher will find and execute the project specific version of drush located in your project's `vendor` directory. Installation - Phar ------------------- [](#installation---phar) 1. Download latest stable release via CLI (code below) or browse to . OSX: ``` curl -OL https://github.com/drush-ops/drush-launcher/releases/latest/download/drush.phar ``` Linux: ``` wget -O drush.phar https://github.com/drush-ops/drush-launcher/releases/latest/download/drush.phar ``` 2. Make downloaded file executable: `chmod +x drush.phar` 3. Move drush.phar to a location listed in your `$PATH`, rename to `drush`: ``` sudo mv drush.phar /usr/local/bin/drush ``` 4. Windows users: create a drush.bat file in the same folder as drush.phar with the following lines. This gets around the problem where Windows does not know that the `drush` file is associated with `php`: ``` @echo off php "%~dp0\drush" %* ``` Update ------ [](#update) The Drush Launcher Phar is able to self update to the latest release. ``` drush self-update ``` Fallback -------- [](#fallback) When a site-local Drush is not found, this launcher usually throws a helpful error. You may avoid the error and instead hand off execution to a global Drush (any version) by exporting an environment variable. `export DRUSH_LAUNCHER_FALLBACK=/path/to/drush` Xdebug compatibility -------------------- [](#xdebug-compatibility) Drush Launcher, like Composer automatically disables Xdebug by default. This improves performance substantially. You may override this feature by setting an environment variable. `DRUSH_ALLOW_XDEBUG=1 drush [command]` License ------- [](#license) GPL-2.0+ ### Health Score 40 — FairBetter than 86% of packages Maintenance18 Infrequent updates — may be unmaintained Popularity42 Moderate usage in the ecosystem Community22 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 60.2% 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 ~66 days Recently: every ~169 days Total 36 Last Release 1246d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/7740?v=4)[Moshe Weitzman](/maintainers/weitzman)[@weitzman](https://github.com/weitzman) --- Top Contributors [![webflo](https://avatars.githubusercontent.com/u/123946?v=4)](https://github.com/webflo "webflo (56 commits)")[![weitzman](https://avatars.githubusercontent.com/u/7740?v=4)](https://github.com/weitzman "weitzman (28 commits)")[![grasmash](https://avatars.githubusercontent.com/u/539205?v=4)](https://github.com/grasmash "grasmash (2 commits)")[![juampynr](https://avatars.githubusercontent.com/u/108130?v=4)](https://github.com/juampynr "juampynr (1 commits)")[![RobinDeHerdt](https://avatars.githubusercontent.com/u/12544981?v=4)](https://github.com/RobinDeHerdt "RobinDeHerdt (1 commits)")[![TechnologyClassroom](https://avatars.githubusercontent.com/u/14501791?v=4)](https://github.com/TechnologyClassroom "TechnologyClassroom (1 commits)")[![danepowell](https://avatars.githubusercontent.com/u/1984514?v=4)](https://github.com/danepowell "danepowell (1 commits)")[![YahyaAhmad](https://avatars.githubusercontent.com/u/36857365?v=4)](https://github.com/YahyaAhmad "YahyaAhmad (1 commits)")[![gapple](https://avatars.githubusercontent.com/u/458809?v=4)](https://github.com/gapple "gapple (1 commits)")[![hussainweb](https://avatars.githubusercontent.com/u/1040271?v=4)](https://github.com/hussainweb "hussainweb (1 commits)") ### Embed Badge ![Health badge](/badges/drush-drush-launcher/health.svg) ``` [![Health](https://phpackages.com/badges/drush-drush-launcher/health.svg)](https://phpackages.com/packages/drush-drush-launcher) ``` ### Alternatives [composer/composer Composer helps you declare, manage and install dependencies of PHP projects. It ensures you have the right stack everywhere. 29.5k196.2M3.1k](/packages/composer-composer)[friendsofphp/php-cs-fixer A tool to automatically fix PHP code style 13.5k251.2M25.3k](/packages/friendsofphp-php-cs-fixer)[behat/behat Scenario-oriented BDD framework for PHP 4.0k101.8M2.2k](/packages/behat-behat)[phan/phan A static analyzer for PHP 5.6k11.9M1.2k](/packages/phan-phan)[infection/infection Infection is a Mutation Testing framework for PHP. The mutation adequacy score can be used to measure the effectiveness of a test set in terms of its ability to detect faults. 2.2k28.9M2.4k](/packages/infection-infection)[humbug/box Fast, zero config application bundler with PHARs. 1.3k894.7k87](/packages/humbug-box) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)