leymannx/wp-cli-launcher

为您的全局PATH提供WP-CLI可执行文件

0.0.20 2018-09-20 11:58 UTC

This package is auto-updated.

Last update: 2024-09-25 11:48:00 UTC


README

一个针对您的全局 $PATH 的 WP-CLI 包装器。

为什么?

为了避免依赖性问题,最好通过 Composer(composer require wp-cli/wp-cli)在每个项目中单独要求 WP-CLI。这样,通过将 WP-CLI 放置在 vendor/bin/wp,它就可以在您的项目中可用。

但是,每次要执行 WP-CLI 命令时输入 vendor/bin/wp 都很不方便。通过在本地机器上全局安装 WP-CLI Launcher,您可以在命令行中简单地输入 wp,然后启动器将在您的项目的 vendor 目录中找到并执行特定于项目的 WP-CLI 版本。

安装 - Phar

  1. 通过以下 CLI 下载最新稳定版本或浏览到 https://github.com/leymannx/wp-cli-launcher/releases/latest

    OSX

    curl -OL https://github.com/leymannx/wp-cli-launcher/releases/download/0.0.20/wp-cli.phar

    Linux

    wget -O wp-cli.phar https://github.com/leymannx/wp-cli-launcher/releases/download/0.0.20/wp-cli.phar
  2. 使下载的文件可执行

    chmod +x wp-cli.phar
  3. 将 wp-cli.phar 移动到您的 $PATH 中列出的位置,重命名为 wp

    sudo mv wp-cli.phar /usr/local/bin/wp
  4. Windows 用户:在 wp-cli.phar 相同的文件夹中创建一个 wp-cli.bat 文件,包含以下行。这解决了 Windows 不知道 .phar 文件与 php 相关的问题

    @echo off
    php "%~dp0\wp-cli.phar" %*

更新

WP-CLI Launcher Phar 能够自动更新到最新版本。

wp self-update

替代方案

如果您系统上只有一个代码库(VM、Docker 等典型),您应该将 /path/to/vendor/bin 添加到您的 $PATH。

回退

当找不到站点本地的 WP-CLI 时,此启动器通常会抛出一个有用的错误。您可以通过执行以下操作之一来避免错误,并将执行权转交给全局 WP-CLI(任何版本):

  1. 导出环境变量: export WP_CLI_LAUNCHER_FALLBACK=/path/to/wp
  2. 指定选项: --fallback=/path/to/wp

Xdebug 兼容性

WP-CLI Launcher,像 Composer 一样,默认禁用 Xdebug。这极大地提高了性能。您可以通过设置环境变量来覆盖此功能。 WP_CLI_ALLOW_XDEBUG=1 wp [command]

许可证

GPL-2.0+