PHPackages                             webflo/drush-shim - 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 &amp; Console](/categories/cli)
4. /
5. webflo/drush-shim

Abandoned → [drush/drush-launcher](/?search=drush%2Fdrush-launcher)ArchivedLibrary[CLI &amp; Console](/categories/cli)

webflo/drush-shim
=================

Provides a drush executable for your global PATH

0.10.0(4y ago)2113.5k49[22 issues](https://github.com/webflo/drush-shim/issues)GPL-2.0-or-laterPHP

Since Oct 7Pushed 2y ago2 watchersCompare

[ Source](https://github.com/webflo/drush-shim)[ Packagist](https://packagist.org/packages/webflo/drush-shim)[ RSS](/packages/webflo-drush-shim/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (4)Versions (35)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

38

—

LowBetter than 83% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity37

Limited adoption so far

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 ~58 days

Recently: every ~109 days

Total

34

Last Release

1676d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c711eb409734c42befd3bb9d507be67da46d0db9bd03c5172c8fe2da1705c239?d=identicon)[webflo](/maintainers/webflo)

---

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/webflo-drush-shim/health.svg)

```
[![Health](https://phpackages.com/badges/webflo-drush-shim/health.svg)](https://phpackages.com/packages/webflo-drush-shim)
```

###  Alternatives

[composer/composer

Composer helps you declare, manage and install dependencies of PHP projects. It ensures you have the right stack everywhere.

29.5k199.6M3.4k](/packages/composer-composer)[friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

13.5k257.0M27.9k](/packages/friendsofphp-php-cs-fixer)[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.2k30.0M2.8k](/packages/infection-infection)[humbug/box

Fast, zero config application bundler with PHARs.

1.3k924.2k96](/packages/humbug-box)[mglaman/drupal-check

CLI tool for running checks on a Drupal code base

3426.9M57](/packages/mglaman-drupal-check)[drupal/drupal-extension

Drupal extension for Behat

22115.8M179](/packages/drupal-drupal-extension)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
