leymannx / wp-cli-launcher
为您的全局PATH提供WP-CLI可执行文件
Requires
- leymannx/wordpress-finder: ^0.0.14
- padraic/phar-updater: ^1.0
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
-
通过以下 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
-
使下载的文件可执行
chmod +x wp-cli.phar
-
将 wp-cli.phar 移动到您的
$PATH
中列出的位置,重命名为wp
sudo mv wp-cli.phar /usr/local/bin/wp
-
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(任何版本):
- 导出环境变量:
export WP_CLI_LAUNCHER_FALLBACK=/path/to/wp
- 指定选项:
--fallback=/path/to/wp
Xdebug 兼容性
WP-CLI Launcher,像 Composer 一样,默认禁用 Xdebug。这极大地提高了性能。您可以通过设置环境变量来覆盖此功能。 WP_CLI_ALLOW_XDEBUG=1 wp [command]
许可证
GPL-2.0+