Win11 安装 WP-CLI 完整教程：PHP 8.4 + WP-CLI 2.12.0 + WordPress 本地开发实战

WP-CLI 是 WordPress 官方提供的命令行工具。通过 WP-CLI，可以直接在 Windows 终端中管理 WordPress，而不需要频繁登录 WordPress 后台。

对于 WordPress 主题和插件开发者来说，WP-CLI 尤其适合用于插件管理、数据库操作、缓存清理、版本检查以及自动化测试。

本文以 Windows 11 + PHP 8.4.16 + WP-CLI 2.12.0 + LocalWP 为实际环境，完整记录从安装 WP-CLI 到验证 WordPress 和数据库的过程。

一、本文实际测试环境

项目	环境
操作系统	Windows 11
PHP	8.4.16
PHP 类型	NTS
WP-CLI	2.12.0
本地 WordPress 环境	LocalWP
WordPress	7.1
PHP 路径	D:\php\php-8.4.16-nts\php.exe
WordPress 项目目录	D:\local_www\forms\app\public

本文中的命令和输出均以实际本地开发环境为基础。

二、什么是 WP-CLI？

WP-CLI 全称为 WordPress Command Line Interface，是 WordPress 的命令行管理工具。

例如查看 WordPress 版本：

wp core version

查看插件：

wp plugin list

查看主题：

wp theme list

检查数据库：

wp db check

相比通过 WordPress 后台操作，WP-CLI 更适合开发、调试、批量操作和自动化测试。

三、Win11 安装 WP-CLI 前需要准备什么？

WP-CLI 本身依赖 PHP，因此首先需要确保 Windows 可以正常执行 PHP CLI。

打开 PowerShell：

php -v

如果能够正常显示 PHP 版本，例如：

PHP 8.4.16 (cli)

说明 PHP CLI 环境已经准备完成。

如果提示找不到 php 命令，需要先将 PHP 所在目录加入 Windows PATH。

例如本文使用：

D:\php\php-8.4.16-nts\

配置 PATH 后重新打开 PowerShell，再执行：

php -v

确认 PHP 正常。

四、下载 WP-CLI

WP-CLI 可以使用官方提供的 wp-cli.phar 文件。

建议单独创建目录：

D:\WP-CLI

使用 PowerShell 下载：

Invoke-WebRequest `
    -Uri https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar `
    -OutFile D:\WP-CLI\wp-cli.phar

最终目录可以是：

D:\WP-CLI\
├── wp-cli.phar
└── wp.bat

进入目录：

cd D:\WP-CLI

然后测试：

php wp-cli.phar --info

五、如何确认 WP-CLI 安装成功？

正常情况下可以看到类似：

OS:                 Windows NT 10.0 build 26200 (Windows 11) AMD64
Shell:              C:\Windows\system32\cmd.exe
PHP binary:         D:\php\php-8.4.16-nts\php.exe
PHP version:        8.4.16
php.ini used:       D:\php\php-8.4.16-nts\php.ini
WP-CLI version:     2.12.0

其中重点关注：

PHP binary:         D:\php\php-8.4.16-nts\php.exe
PHP version:        8.4.16
WP-CLI version:     2.12.0

这说明 PHP CLI 和 WP-CLI 均可以正常工作。

MySQL binary 和 MySQL version 为空正常吗？

执行：

php wp-cli.phar --info

时，如果看到：

MySQL binary:
MySQL version:

不需要因此判断数据库连接存在问题。

是否能够正常连接 WordPress 数据库，应当进入具体 WordPress 项目目录后使用：

wp db check

进行验证。

六、让 WP-CLI 支持直接使用 wp 命令

如果每次都需要输入：

php wp-cli.phar --info

使用起来比较麻烦。

可以通过 Windows 批处理文件将它简化成：

wp --info

在：

D:\WP-CLI

创建：

wp.bat

内容：

@ECHO OFF
php "%~dp0wp-cli.phar" %*

这里的 %~dp0 表示当前 wp.bat 所在目录，因此不需要把 PHP 文件路径硬编码到批处理文件中。

七、将 D:\WP-CLI 加入 Windows PATH

PowerShell 执行：

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", "User") + ";D:\WP-CLI",
    "User"
)

执行完成后，关闭当前 PowerShell，重新打开一个新的 PowerShell 窗口。

然后：

wp --info

如果能够正常显示：

WP-CLI version: 2.12.0
PHP version:    8.4.16

说明 WP-CLI 已经配置为 Windows 全局命令。

八、进入 WordPress 项目测试 WP-CLI

WP-CLI 真正的价值是在 WordPress 项目目录中使用。

例如本文的 WordPress 项目目录：

D:\local_www\forms\app\public

进入目录：

cd D:\local_www\forms\app\public

执行：

wp core version

实际测试结果：

7.1

这说明 WP-CLI 已经成功识别当前 WordPress。

需要注意：

wp --info

主要用于确认 WP-CLI 自身运行正常。

而：

wp core version

则进一步验证 WP-CLI 能够识别当前 WordPress 项目。

九、使用 WP-CLI 检查 WordPress 数据库

继续执行：

wp db check

实际测试能够返回各数据库表的：

OK

并最终显示：

Success: Database checked.

这说明数据库连接正常，WordPress 数据库表也可以正常检查。

因此整个链路已经打通：

Windows 11
    ↓
PHP CLI
    ↓
WP-CLI
    ↓
WordPress
    ↓
MySQL / MariaDB

十、常用 WP-CLI 命令

查看 WordPress 版本

wp core version

查看插件

wp plugin list

激活插件

wp plugin activate plugin-name

停用插件

wp plugin deactivate plugin-name

查看主题

wp theme list

清理 WordPress Object Cache

wp cache flush

查看网站地址

wp option get siteurl

查看首页地址

wp option get home

检查数据库

wp db check

导出数据库

wp db export backup.sql

导入数据库

wp db import backup.sql

十一、WP-CLI 对 WordPress 插件开发有什么帮助？

对于主题和插件开发者来说，WP-CLI 的价值不仅仅是查看 WordPress 版本。

例如开发插件时，可以直接：

wp plugin list

检查插件状态。

激活插件：

wp plugin activate haozhuti-forms

停用插件：

wp plugin deactivate haozhuti-forms

配合：

wp db check

可以快速检查数据库状态。

如果插件涉及自定义数据库表，也可以进一步使用 WP-CLI 和数据库命令进行开发测试。

对于需要反复执行“激活插件 → 修改代码 → 清理缓存 → 测试数据库 → 检查状态”的开发流程，命令行操作通常比反复进入 WordPress 后台更加高效。

十二、WP-CLI 安装后的检查清单

安装完成后，可以按照以下顺序检查。

1. 检查 PHP

php -v

2. 检查 WP-CLI

wp --info

3. 进入 WordPress 项目

cd D:\local_www\forms\app\public

4. 检查 WordPress

wp core version

5. 检查数据库

wp db check

如果以上命令全部正常：

PHP CLI       ✅
WP-CLI        ✅
WordPress     ✅
数据库         ✅

说明 Windows 11 上的 WordPress CLI 开发环境已经配置完成。

十三、常见问题

1. Windows 提示找不到 php 命令怎么办？

检查 PHP 是否已经加入 PATH。

可以执行：

where.exe php

确认 Windows 当前使用的是哪个 PHP。

如果没有任何结果，需要配置 PHP PATH。

2. wp –info 找不到怎么办？

检查：

D:\WP-CLI\wp.bat
D:\WP-CLI\wp-cli.phar

是否存在。

然后确认：

D:\WP-CLI

已经加入 Windows PATH。

配置 PATH 后，需要重新打开终端。

3. wp core version 无法执行怎么办？

首先确认当前目录就是 WordPress 根目录：

wp-admin
wp-content
wp-includes
wp-config.php

然后执行：

wp core version

如果当前目录不是 WordPress 项目目录，可以使用 --path 指定：

wp --path=D:\local_www\forms\app\public core version

4. wp db check 失败怎么办？

重点检查：

• wp-config.php
• 数据库名称
• 数据库用户名
• 数据库密码
• 数据库主机
• MySQL/MariaDB 是否正在运行
• 当前 PHP CLI 是否能够加载数据库相关扩展

可以先检查 PHP 扩展：

php -m

再根据具体错误信息进行排查。

十四、总结

在 Windows 11 上安装 WP-CLI，核心流程非常简单：

安装 PHP
   ↓
确认 PHP CLI
   ↓
下载 wp-cli.phar
   ↓
php wp-cli.phar --info
   ↓
创建 wp.bat
   ↓
加入 Windows PATH
   ↓
wp --info
   ↓
进入 WordPress 项目
   ↓
wp core version
   ↓
wp db check

本文实际环境最终验证结果为：

Windows 11
PHP 8.4.16
WP-CLI 2.12.0
WordPress 7.1
Database: Success

对于 WordPress 开发者而言，建议把 WP-CLI 作为本地开发环境中的基础工具之一。

特别是在插件开发、主题开发、数据库维护和自动化测试过程中，WP-CLI 可以减少大量重复的后台操作，并为后续自动化脚本和 CI/CD 流程打下基础。