Windows安装PHP和wp-cli配置全局命令高效管理wordpress站点及LocalWP实战指南
在日常 WordPress 开发和维护过程中,经常需要通过命令行完成一些操作,例如:
- 查看 WordPress 版本。
- 查看已安装的插件和主题。
- 更新插件和主题。
- 启用或停用插件。
- 检查 WordPress 数据库。
- 执行 WordPress 数据维护操作。
这些操作都可以通过 WP-CLI 实现。
WP-CLI 是 WordPress 官方提供的命令行管理工具,可以直接通过终端管理 WordPress,不需要每次进入 WordPress 后台进行操作。
本文主要介绍如何在 Windows 电脑上独立安装 PHP 和 WP-CLI,实现以下目标:
- 在 Windows 上下载并安装 PHP。
- 配置 PHP 环境变量,使任何目录都可以执行
php命令。 - 下载并安装
wp-cli.phar。 - 配置 WP-CLI 环境变量,使任何目录都可以执行
wp命令。 - 配置 PHP 的
php.ini文件,启用常用扩展。 - 不重启电脑,通过重启 Windows 资源管理器使环境变量生效。
- 理解 LocalWP 的环境隔离机制。
- 使用 LocalWP 自带的 Shell 管理 WordPress 网站。
- 利用 Windows CMD 的磁盘目录记忆功能,快速切换到 WordPress 网站根目录。
最终实现 Windows 全局 PHP 和 WP-CLI 环境,同时保留 LocalWP 自带的独立运行环境。
二、下载和安装PHP
2.1 下载PHP
首先进入 PHP 官方 Windows 下载页面:
https://www.php.net/downloads.php
Windows 推荐下载 PHP 8.x 的 x64 版本,笔者下载的是PHP8.5。
这里需要注意 PHP 的版本类型:
- VS16、VS17 等表示对应的 Visual Studio 编译版本。
- x64 表示 64 位系统。
- Thread Safe 表示线程安全版本。
- Non Thread Safe 表示非线程安全版本。
如果只是为了在 Windows 命令行中运行 PHP 和 WP-CLI,通常选择 x64 Non Thread Safe 即可。
建议下载 ZIP 压缩包,不需要下载安装程序。
2.2 解压PHP
下载完成后,将 PHP 压缩包解压到一个固定目录。
例如:
1 | D:\Environment\PHP |
解压完成后,目录结构大致如下:
1 | D:\Environment\PHP |
具体文件会根据 PHP 版本有所不同。
这里建议使用固定目录,不要放在下载目录或临时目录中,避免后续移动文件导致环境变量失效。
2.3 创建php.ini配置文件
PHP 解压后,默认不会直接生成正式使用的 php.ini 配置文件。
需要手动复制一份开发环境配置文件。
找到:
1 | php.ini-development |
复制一份,并将复制后的文件重命名为:
1 | php.ini |
最终目录结构:
1 | D:\Environment\PHP |
这样 PHP 就有了自己的配置文件。
2.4 配置php.ini
使用记事本或 VS Code 打开:
1 | D:\Environment\PHP\php.ini |
首先找到:
1 | ;extension_dir = "ext" |
修改为:
1 | extension_dir = "D:/Environment/PHP/ext" |
这样可以明确告诉 PHP,扩展文件存放在哪个目录。
接下来启用常用 PHP 扩展。
找到对应的扩展配置,将前面的分号 ; 删除。
例如:
1 | extension=curl |
注意:不同 PHP 版本的扩展名称和可用情况可能有所不同,以实际安装包为准。
对于 WordPress 和 WP-CLI,比较常用的扩展包括:
| 扩展 | 主要用途 |
|---|---|
| curl | HTTP 请求和网络通信 |
| fileinfo | 文件类型识别 |
| gd | 图片处理 |
| intl | 国际化和字符处理 |
| mbstring | 多字节字符串处理 |
| mysqli | MySQL 数据库连接 |
| openssl | 加密和 HTTPS 通信 |
| pdo_mysql | PDO 方式连接 MySQL |
| xml | XML 数据处理 |
| zip | ZIP 压缩包处理 |
这些扩展可以满足大多数 WordPress 开发和维护场景。
如果以后运行其他 PHP 项目,可以根据实际需求继续启用扩展。
2.5 关闭不必要的错误显示
PHP 开发环境默认可能会显示较多警告和错误信息。
如果主要使用 PHP 运行命令行工具,可以适当调整错误显示设置。
在 php.ini 中找到以下配置:
1 | display_errors = On |
修改为:
1 | display_errors = Off |
这里需要注意:
display_errors = Off:不直接显示 PHP 运行错误。display_startup_errors = Off:不显示 PHP 启动阶段的错误。log_errors = On:允许记录错误日志。error_reporting = E_ALL:仍然保留完整的错误检测级别。
这种方式可以减少不必要的错误信息输出,同时保留错误记录能力。
注意,关闭错误显示不代表错误已经解决。如果出现 PHP 扩展缺失或程序运行异常,仍然需要检查日志和实际错误信息。
2.6 配置PHP环境变量
PHP 安装完成后,需要配置 Windows 环境变量。
这样才能在任何目录下直接使用:
1 | php -v |
操作步骤:
- 打开 Windows 设置。
- 搜索环境变量。
- 点击编辑系统环境变量。
- 点击环境变量。
- 找到系统变量中的
Path。 - 点击编辑。
- 新增 PHP 安装目录。
添加:
1 | D:\Environment\PHP |
保存所有设置。
这里不需要单独添加 php.exe,只需要添加 PHP 所在目录即可。
2.7 验证PHP是否安装成功
打开一个新的 CMD 窗口,执行:
1 | php -v |
如果配置成功,会显示 PHP 版本信息。
例如:
1 | PHP 8.x.x (cli) |
继续检查 PHP 当前加载的配置文件:
1 | php --ini |
重点关注:
1 | Loaded Configuration File |
应该指向:
1 | D:\Environment\PHP\php.ini |
再检查已经启用的扩展:
1 | php -m |
如果可以看到:
1 | curl |
说明对应扩展已经成功加载。
三、下载和安装WP-CLI
3.1 下载wp-cli.phar
WP-CLI 是 WordPress 的命令行管理工具。
官方项目地址:
官方安装说明:
https://make.wordpress.org/cli/handbook/guides/installing/
Windows 环境可以直接下载官方提供的 PHAR 文件:
https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
下载完成后,将文件放到一个固定目录。
例如:
1 | D:\Environment\WP-CLI |
目录结构:
1 | D:\Environment\WP-CLI |
3.2 创建wp.bat启动文件
Windows 不能直接像 Linux 一样通过 wp 命令自动运行 PHAR 文件,因此需要创建一个批处理启动文件。
在:
1 | D:\Environment\WP-CLI |
目录下,新建:
1 | wp.bat |
编辑文件,写入:
1 | @ECHO OFF |
也可以像如下这样写(使用这个变量,这样就是相当于这个bat文件在wp-cli.phar的相同目录):
1 | @echo off |
保存即可。
这段代码的作用:
@ECHO OFF:关闭命令回显。php:调用系统全局 PHP。wp-cli.phar:运行 WP-CLI 程序。%*:将用户输入的全部参数传递给 WP-CLI。
例如执行:
1 | wp plugin list |
实际运行的就是:
1 | php D:\Environment\WP-CLI\wp-cli.phar plugin list |
通过批处理文件,我们就可以直接使用熟悉的 wp 命令。
3.3 配置WP-CLI环境变量
现在需要将 WP-CLI 所在目录添加到 Windows 环境变量。
打开:
1 | 系统设置 → 高级系统设置 → 环境变量 |
找到系统变量中的 Path,点击编辑。
新增:
1 | D:\Environment\WP-CLI |
保存即可。
现在 Windows 已经知道:
- PHP 命令在哪里。
- WP 命令在哪里。
3.4 验证WP-CLI是否安装成功
打开 CMD,执行:
1 | wp --info |
如果安装成功,会显示 WP-CLI 的运行信息,包括:
- OS
- Shell
- PHP binary
- PHP version
- php.ini used
- WP-CLI version
再执行:
1 | wp cli version |
可以查看 WP-CLI 版本。
至此,Windows 全局 PHP 和 WP-CLI 环境已经安装完成。
四、不重启电脑使环境变量立即生效
修改 Windows 环境变量后,很多教程会建议重启电脑。
实际上,大多数情况下没有必要。
Windows 中运行的程序会继承启动时的环境变量。因此,已经打开的 CMD、PowerShell 等程序不会自动获取最新的环境变量。
只需要让新的进程重新读取环境变量即可。
4.1 方法一重新打开终端
最简单的方法是:
- 关闭当前 CMD 或 PowerShell。
- 重新打开 CMD 或 PowerShell。
- 执行:
1 | php -v |
再执行:
1 | wp --info |
如果能正常显示信息,说明环境变量已经生效。
4.2 方法二重启Windows资源管理器
如果希望不重启电脑,让桌面环境也重新加载环境变量,可以重启 Windows 资源管理器。
按下:
1 | Ctrl + Shift + Esc |
打开任务管理器。
找到:
1 | Windows 资源管理器 |
右键选择:
1 | 重新启动 |
也可以使用 PowerShell 执行:
1 | Stop-Process -Name explorer -Force |
资源管理器重新启动后,从桌面或开始菜单新启动的程序通常就可以继承更新后的环境变量。
注意:重启资源管理器不会自动刷新已经打开的 CMD、PowerShell 或其他程序。它们仍然需要重新打开。
另外,如果是通过 PowerShell 修改了当前用户环境变量,还可以在当前 PowerShell 会话中重新读取用户和系统 Path:
1 | $env:Path = [Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [Environment]::GetEnvironmentVariable("Path", "User") |
这样不需要关闭当前 PowerShell,就可以刷新当前会话的 Path。
五、理解LocalWP的环境隔离机制
完成 Windows 全局 PHP 和 WP-CLI 安装后,还需要了解 LocalWP 的运行机制。
LocalWP 是一个本地 WordPress 开发环境工具,它会为本地网站提供独立的运行环境。
通常包括:
- PHP 运行环境。
- MySQL 数据库。
- Web 服务器。
- 网站运行配置。
- 对应的开发工具。
这些环境由 LocalWP 自己管理,不一定使用 Windows 系统中安装的 PHP 和 MySQL。
5.1 Windows全局环境和LocalWP环境的区别
两套环境可以理解为:
| 对比项目 | Windows全局环境 | LocalWP环境 |
|---|---|---|
| PHP | 自己下载和配置 | LocalWP 自己管理 |
| MySQL | 自己安装和配置 | LocalWP 自己管理 |
| WP-CLI | 自己下载配置 | LocalWP 提供运行环境 |
| 使用范围 | Windows 全局终端 | LocalWP 对应站点 |
| 环境配置 | 自己维护 | LocalWP 管理 |
例如,在 Windows CMD 中执行:
1 | php -v |
使用的是 Windows 环境变量中配置的 PHP。
而在 LocalWP 自带的 Shell 中执行:
1 | php -v |
通常使用的是 LocalWP 为站点提供的 PHP 环境。
两者可能存在不同的 PHP 版本、扩展和数据库连接配置。
因此,即使 Windows 全局 PHP 已经安装成功,也不代表它能够直接连接 LocalWP 的 MySQL 数据库。
5.2 为什么建议使用LocalWP自带的Shell
如果需要查询某个 WordPress 网站的信息,例如:
- 查看插件列表。
- 查看主题列表。
- 查看 WordPress 版本。
- 检查数据库。
- 更新插件。
- 执行数据库操作。
建议优先进入 LocalWP 对应网站的 Shell 环境。
操作步骤:
- 打开 LocalWP。
- 找到需要操作的 WordPress 网站。
- 确保网站处于 Running 状态。
- 点击 Open Site Shell。
- 在打开的终端中执行 WP-CLI 命令。
例如:
1 | wp plugin list |
如果正常显示插件列表,就说明 WP-CLI 已经成功连接当前网站。
这种方式最大的好处是:
不需要手动配置数据库地址、数据库端口、用户名和密码,也不需要担心 Windows 全局 PHP 与 LocalWP 内部 PHP 之间的环境差异。
六、使用LocalWP Shell快速进入WordPress根目录
在实际使用过程中,我还发现了一个比较方便的方法。
LocalWP 自带的 Shell 打开后,默认可能位于 Windows 用户目录,例如:
1 | C:\Users\Zhangsan> |
如果直接执行:
1 | wp plugin list |
可能会出现:
1 | Error: This does not seem to be a WordPress installation. |
这是因为当前目录并不是 WordPress 网站根目录。
WP-CLI 默认会从当前目录向上查找 WordPress 安装文件。
因此,需要先进入正确的网站目录。
6.1 通过磁盘盘符快速切换
我的 WordPress 项目位于:
1 | D:\project\keelear.com\app\public |
在 LocalWP Shell 中,我发现直接输入:
1 | D: |
就可以进入:
1 | D:\project\keelear.com\app\public> |
这看起来非常方便。
这里其实涉及 Windows CMD 的一个特性:
Windows CMD 会分别记住不同磁盘上最近使用的工作目录。
例如:
1 | D: |
表示切换到 D 盘,并恢复之前在 D 盘使用的工作目录。
如果之前已经在 D 盘进入过 WordPress 网站根目录,那么再次输入 D: 就会直接回到该目录。
需要注意,这并不是 D: 自动识别 WordPress 根目录,而是 CMD 记住了 D 盘上次使用的目录。
如果 D 盘尚未设置过对应目录,也可以手动执行:
1 | cd /d D:\project\keelear.com\app\public |
其中:
cd表示切换目录。/d表示同时切换磁盘和目录。
6.2 验证当前目录
进入网站根目录后,可以执行:
1 | dir |
查看当前目录文件。
正常情况下,应该能够看到类似以下内容:
1 | wp-admin |
其中最重要的是:
1 | wp-config.php |
只要当前目录下存在这个文件,基本就可以确认已经进入 WordPress 网站根目录。
6.3 为什么ls命令不能使用
在使用 LocalWP Shell 时,我还遇到过一个小问题:
1 | ls |
执行后提示:
1 | 'ls' 不是内部或外部命令,也不是可运行的程序 |
这是因为当前 Shell 实际使用的是 Windows CMD,而不是 Linux Bash 或 PowerShell。
在 CMD 中,查看目录应该使用:
1 | dir |
常见命令对照:
| 功能 | Windows CMD | Linux Bash |
|---|---|---|
| 查看文件 | dir | ls |
| 切换目录 | cd | cd |
| 返回上级目录 | cd .. | cd .. |
| 清屏 | cls | clear |
| 切换磁盘 | D: | 不需要 |
| 查看当前目录 | cd | pwd |
了解这一点后,就不会再把 Linux 命令和 Windows CMD 命令混淆。
七、WordPress常用WP-CLI命令实战
进入 WordPress 网站根目录后,就可以直接执行 WP-CLI 命令。
下面整理一些日常开发和维护中比较常用的操作。
7.1 查看WordPress版本
1 | wp core version |
7.2 查看所有插件
1 | wp plugin list |
只查看已经启用的插件:
1 | wp plugin list --status=active |
只查看未启用的插件:
1 | wp plugin list --status=inactive |
查看插件名称、状态和版本:
1 | wp plugin list --fields=name,status,version |
以 JSON 格式输出:
1 | wp plugin list --format=json |
7.3 更新插件
更新指定插件:
1 | wp plugin update updraftplus |
更新所有插件:
1 | wp plugin update --all |
查看可以更新的插件:
1 | wp plugin list --update=available |
7.4 启用和停用插件
启用插件:
1 | wp plugin activate plugin-name |
停用插件:
1 | wp plugin deactivate plugin-name |
例如:
1 | wp plugin deactivate woocommerce |
注意,插件名称通常对应 wp-content/plugins 目录中的插件文件夹名称,而不是后台显示的插件标题。
7.5 查看主题
1 | wp theme list |
查看主题详细信息:
1 | wp theme list --fields=name,status,version |
7.6 检查数据库
1 | wp db check |
如果数据库连接正常,会显示数据库检查结果。
7.7 查看网站基本信息
1 | wp option get siteurl |
查看网站首页地址:
1 | wp option get home |
查看网站名称:
1 | wp option get blogname |
这些命令可以快速获取 WordPress 网站的一些基本信息。
执行 wp option get 等数据库相关命令时,需要确保当前目录对应的 WordPress 网站能够正常连接数据库。
八、常见问题及解决方法
8.1 php不是内部或外部命令
错误信息:
1 | 'php' 不是内部或外部命令 |
通常说明 PHP 环境变量没有配置正确。
检查系统 Path 是否包含:
1 | D:\Environment\PHP |
然后重新打开 CMD,再执行:
1 | php -v |
还可以使用:
1 | where php |
查看 Windows 实际调用的是哪个 PHP。
8.2 wp不是内部或外部命令
错误信息:
1 | 'wp' 不是内部或外部命令 |
检查以下内容:
- 是否已经下载
wp-cli.phar。 - 是否已经创建
wp.bat。 wp.bat中的 PHAR 路径是否正确。- WP-CLI 目录是否已经加入 Path。
执行:
1 | where wp |
如果配置成功,应该能够找到:
1 | D:\Environment\WP-CLI\wp.bat |
8.3 Error establishing a database connection
错误信息:
1 | Error: Error establishing a database connection. |
这通常表示 WP-CLI 已经找到了 WordPress,但无法连接数据库。
可能原因:
- 数据库服务没有启动。
- 数据库地址或端口不正确。
- 数据库用户名或密码不正确。
- 当前使用的 PHP 环境与数据库运行环境不匹配。
如果操作的是 LocalWP 网站,建议优先使用 LocalWP 自带的 Open Site Shell。
不要直接假设 Windows 全局 PHP 可以使用 LocalWP 的数据库配置。
8.4 This does not seem to be a WordPress installation
错误信息:
1 | Error: This does not seem to be a WordPress installation. |
这通常是因为当前工作目录不是 WordPress 网站根目录。
可以使用:
1 | cd /d D:\project\keelear.com\app\public |
或者直接使用 WP-CLI 的 --path 参数:
1 | wp --path="D:/project/keelear.com/app/public" plugin list |
如果使用 LocalWP Shell,也可以通过切换到对应的磁盘和目录来解决。
九、最终效果和日常使用建议
完成以上配置后,Windows 电脑就具备了独立的 PHP 和 WP-CLI 命令行环境。
最终可以实现:
| 操作目标 | 命令 |
|---|---|
| 查看 PHP 版本 | php -v |
| 查看 PHP 配置 | php --ini |
| 查看 PHP 扩展 | php -m |
| 查看 WP-CLI 信息 | wp --info |
| 查看 WP-CLI 版本 | wp cli version |
| 查看插件列表 | wp plugin list |
| 查看主题列表 | wp theme list |
| 查看 WordPress 版本 | wp core version |
| 检查数据库 | wp db check |
日常使用时,可以根据实际场景选择不同的运行环境。
场景一:需要在 Windows 任意目录使用 PHP 或 WP-CLI
使用自己安装的 PHP 和 WP-CLI。
例如:
1 | php -v |
场景二:需要查询或管理 LocalWP 中的 WordPress 网站
建议使用 LocalWP 自带的 Open Site Shell。
进入对应网站根目录后:
1 | wp plugin list |
即可直接查看插件信息。
场景三:需要快速进入 WordPress 根目录
利用 CMD 的磁盘工作目录记忆功能:
1 | D: |
如果 D 盘上次使用的目录就是 WordPress 根目录,就可以直接回到该位置。
这样可以减少每次手动输入完整路径的操作。
十、总结
通过本文的配置,我们完成了 Windows 环境下 PHP 和 WP-CLI 的独立安装,并实现了全局命令调用。
整个方案最重要的是理解两套环境的区别:
- Windows 全局 PHP 和 WP-CLI 是自己安装和维护的。
- LocalWP 自带独立的 PHP、MySQL 和网站运行环境。
- Windows 全局环境适合执行通用 PHP 和 WP-CLI 命令。
- LocalWP Shell 更适合管理 LocalWP 中实际运行的 WordPress 网站。
另外,通过 CMD 的磁盘目录记忆功能,还可以快速返回之前使用过的 WordPress 网站根目录。
这样既保留了 Windows 全局命令行工具的便利性,也避免了 LocalWP 内部环境和 Windows 全局环境之间的冲突。
对于经常使用 WordPress 进行开发、插件维护和网站管理的开发者来说,这是一套比较实用的 Windows 本地开发工作流。
额外建议
文章发布前,我建议保留三个关键知识点,尤其是这三个地方比较容易被读者误解:
- PHP版本选择:WP-CLI 和 WordPress 对 PHP 版本有最低要求,下载时应结合当前项目的兼容性选择,不要盲目追求最新版本。
- LocalWP环境隔离:LocalWP Shell 的 PHP 和数据库配置不等于 Windows 全局配置,这是本文最重要的实践经验之一。
- 输入D:的原理:这是 Windows CMD 的磁盘当前目录记忆机制,而不是 LocalWP 自动识别 WordPress 项目。这样解释更准确,也更有技术参考价值。