在日常 WordPress 开发和维护过程中,经常需要通过命令行完成一些操作,例如:

  • 查看 WordPress 版本。
  • 查看已安装的插件和主题。
  • 更新插件和主题。
  • 启用或停用插件。
  • 检查 WordPress 数据库。
  • 执行 WordPress 数据维护操作。

这些操作都可以通过 WP-CLI 实现。

WP-CLI 是 WordPress 官方提供的命令行管理工具,可以直接通过终端管理 WordPress,不需要每次进入 WordPress 后台进行操作。

本文主要介绍如何在 Windows 电脑上独立安装 PHP 和 WP-CLI,实现以下目标:

  1. 在 Windows 上下载并安装 PHP。
  2. 配置 PHP 环境变量,使任何目录都可以执行 php 命令。
  3. 下载并安装 wp-cli.phar。
  4. 配置 WP-CLI 环境变量,使任何目录都可以执行 wp 命令。
  5. 配置 PHP 的 php.ini 文件,启用常用扩展。
  6. 不重启电脑,通过重启 Windows 资源管理器使环境变量生效。
  7. 理解 LocalWP 的环境隔离机制。
  8. 使用 LocalWP 自带的 Shell 管理 WordPress 网站。
  9. 利用 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
2
3
4
5
6
7
8
9
10
D:\Environment\PHP
│
├── dev
├── ext
├── extras
├── php.exe
├── php.ini-development
├── php.ini-production
├── php8ts.dll
└── ...

具体文件会根据 PHP 版本有所不同。

这里建议使用固定目录,不要放在下载目录或临时目录中,避免后续移动文件导致环境变量失效。

2.3 创建php.ini配置文件

PHP 解压后,默认不会直接生成正式使用的 php.ini 配置文件。

需要手动复制一份开发环境配置文件。

找到:

1
php.ini-development

复制一份,并将复制后的文件重命名为:

1
php.ini

最终目录结构:

1
2
3
4
5
6
7
D:\Environment\PHP
│
├── php.exe
├── php.ini
├── php.ini-development
├── php.ini-production
└── ext

这样 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
2
3
4
5
6
7
8
9
10
11
12
13
extension=curl
extension=exif
extension=fileinfo
extension=gd
extension=intl
extension=mbstring
extension=mysqli
extension=openssl
extension=pdo_mysql
extension=soap
extension=sockets
extension=xml
extension=zip

注意:不同 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
2
display_errors = On
display_startup_errors = On

修改为:

1
2
3
4
display_errors = Off
display_startup_errors = Off
log_errors = On
error_reporting = E_ALL

这里需要注意:

  • 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

操作步骤:

  1. 打开 Windows 设置。
  2. 搜索环境变量。
  3. 点击编辑系统环境变量。
  4. 点击环境变量。
  5. 找到系统变量中的 Path。
  6. 点击编辑。
  7. 新增 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
2
3
4
5
6
7
8
9
curl
fileinfo
gd
mbstring
mysqli
openssl
pdo_mysql
xml
zip

说明对应扩展已经成功加载。

三、下载和安装WP-CLI

3.1 下载wp-cli.phar

WP-CLI 是 WordPress 的命令行管理工具。

官方项目地址:

https://wp-cli.org/

官方安装说明:

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
2
3
D:\Environment\WP-CLI
│
└── wp-cli.phar

3.2 创建wp.bat启动文件

Windows 不能直接像 Linux 一样通过 wp 命令自动运行 PHAR 文件,因此需要创建一个批处理启动文件。

在:

1
D:\Environment\WP-CLI

目录下,新建:

1
wp.bat

编辑文件,写入:

1
2
@ECHO OFF
php "D:\Environment\WP-CLI\wp-cli.phar" %*

也可以像如下这样写(使用这个变量,这样就是相当于这个bat文件在wp-cli.phar的相同目录):

1
2
@echo off
php "%~dp0wp-cli.phar" %*

保存即可。

这段代码的作用:

  • @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 方法一重新打开终端

最简单的方法是:

  1. 关闭当前 CMD 或 PowerShell。
  2. 重新打开 CMD 或 PowerShell。
  3. 执行:
1
php -v

再执行:

1
wp --info

如果能正常显示信息,说明环境变量已经生效。

4.2 方法二重启Windows资源管理器

如果希望不重启电脑,让桌面环境也重新加载环境变量,可以重启 Windows 资源管理器。

按下:

1
Ctrl + Shift + Esc

打开任务管理器。

找到:

1
Windows 资源管理器

右键选择:

1
重新启动

也可以使用 PowerShell 执行:

1
2
Stop-Process -Name explorer -Force
Start-Process explorer.exe

资源管理器重新启动后,从桌面或开始菜单新启动的程序通常就可以继承更新后的环境变量。

注意:重启资源管理器不会自动刷新已经打开的 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 环境。

操作步骤:

  1. 打开 LocalWP。
  2. 找到需要操作的 WordPress 网站。
  3. 确保网站处于 Running 状态。
  4. 点击 Open Site Shell。
  5. 在打开的终端中执行 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
2
3
4
5
wp-admin
wp-content
wp-includes
wp-config.php
index.php

其中最重要的是:

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' 不是内部或外部命令

检查以下内容:

  1. 是否已经下载 wp-cli.phar。
  2. 是否已经创建 wp.bat。
  3. wp.bat 中的 PHAR 路径是否正确。
  4. 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
2
php -v
wp --info

场景二:需要查询或管理 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 本地开发工作流。

额外建议

文章发布前,我建议保留三个关键知识点,尤其是这三个地方比较容易被读者误解:

  1. PHP版本选择:WP-CLI 和 WordPress 对 PHP 版本有最低要求,下载时应结合当前项目的兼容性选择,不要盲目追求最新版本。
  2. LocalWP环境隔离:LocalWP Shell 的 PHP 和数据库配置不等于 Windows 全局配置,这是本文最重要的实践经验之一。
  3. 输入D:的原理:这是 Windows CMD 的磁盘当前目录记忆机制,而不是 LocalWP 自动识别 WordPress 项目。这样解释更准确,也更有技术参考价值。