小皮面板怎么开启 Redis 扩展并测试连接？

学完这篇你能得到：在小皮面板中成功开启 PHP 的 Redis 扩展，并通过命令行确认扩展已加载、Redis 服务可正常连接。

第一步：确认小皮面板中 Redis 服务已启动

这一步要启动小皮面板内置的 Redis 服务，做完后你将得到一个正在运行的本地 Redis 实例，默认监听地址为 127.0.0.1，端口为 6379。

以小皮面板 Windows 版 v1.1.0 / v1.2.0 为例，打开面板后，在左侧菜单或顶部导航中找到【软件】或【服务】入口。进入后查看【Redis】卡片，确认状态显示为“已启动”。如果状态为“未启动”，点击【启动】按钮。启动完成后，可以打开面板右上角的【终端】，输入：

redis-cli -h 127.0.0.1 -p 6379 ping

如果返回：

PONG

说明 Redis 服务已经正常运行。

注意：如果提示 Could not connect to Redis at 127.0.0.1:6379，先回到面板【Redis】页面检查服务状态，并确认端口没有被其他 Redis 程序占用。

第二步：找到当前网站的 PHP 版本

这一步要确认你正在使用的 PHP 版本，因为 Redis 扩展必须开启在对应版本的 PHP 中，做完后你将知道后续要修改哪一个 PHP 配置文件。

在小皮面板左侧菜单点击【网站】，找到你准备测试的网站，点击右侧【管理】或【设置】按钮。进入网站设置后，选择【PHP版本】选项卡，记下当前版本，例如 PHP 8.0.2 NTS、PHP 7.4.3 NTS、PHP 8.1.10 NTS 等。

如果你只是做扩展测试，也可以新建一个测试网站，例如：

• 域名：redis.test
• 根目录：D:\phpstudy_pro\WWW\redis.test
• PHP 版本：选择当前已安装的版本

注意：不要只改 php.ini，却仍然使用另一个 PHP 版本运行网站。不同 PHP 版本的扩展是分开加载的，版本选错会导致 php -m 看不到 redis。

第三步：开启 PHP 的 Redis 扩展

这一步要在小皮面板中打开 PHP 扩展开关，做完后你将获得一个已加载 redis 扩展的 PHP 环境。

以 PHP 8.0.2 NTS 为例，进入小皮面板【软件】页面，找到【PHP】卡片，点击右侧【设置】或【管理】按钮。进入 PHP 设置页后，切换到【扩展】选项卡。

在扩展列表中找到【redis】，确认其状态为“未开启”或“已开启”。如果未开启，点击右侧【开启】按钮。面板通常会重新加载对应 PHP 服务。

你也可以直接修改 php.ini，路径一般为：

D:\phpstudy_pro\Extensions\php\php8.0.2nts\php.ini

用记事本或 VS Code 打开后，找到下面这一行：

;extension=redis

去掉前面的分号，改成：

extension=redis

保存文件后，回到小皮面板，在【网站】或【软件】页面点击【重启】，重启当前 PHP 版本。

注意：extension=redis 和 extension=php_redis.dll 都可能出现，优先使用面板开关。手动修改时不要同时保留多行重复配置，否则可能导致 PHP 启动失败。

第四步：验证 Redis 扩展是否加载成功

这一步要检查 PHP 是否已经识别到 Redis 扩展，做完后你将确认扩展安装成功，可以进入连接测试。

打开小皮面板右上角【终端】，进入当前 PHP 目录，例如：

cd D:\phpstudy_pro\Extensions\php\php8.0.2nts

然后执行：

php -m | findstr redis

如果输出：

redis

说明 Redis 扩展已经加载。

继续执行：

php -r "echo class_exists('Redis') ? 'Redis class OK' : 'Redis class missing';"

如果输出：

Redis class OK

说明 PHP 中已经可以使用 Redis 类。

注意：如果 php -m 没有 redis，先确认终端执行的是同一个 PHP 版本。可以用下面命令查看 PHP 路径和版本：

php -v
where php

第五步：测试 PHP 连接本地 Redis

这一步要用一段最小 PHP 代码连接 Redis，做完后你将验证“PHP 扩展 + Redis 服务”整条链路是否可用。

在你的网站根目录创建文件：

D:\phpstudy_pro\WWW\redis.test\redis-test.php

写入以下代码：

<?php
$redis = new Redis();

try {
    $redis->connect('127.0.0.1', 6379);
    $redis->set('xp_test', 'hello');
    $value = $redis->get('xp_test');

    echo 'Redis 连接成功，读取值：' . $value;
} catch (Exception $e) {
    echo 'Redis 连接失败：' . $e->getMessage();
}

然后在浏览器访问：

http://redis.test/redis-test.php

如果页面显示：

Redis 连接成功，读取值：hello

说明 Redis 扩展和 Redis 服务都已经正常工作。

如果你没有配置本地域名，也可以直接在终端运行：

D:\phpstudy_pro\Extensions\php\php8.0.2nts\php.exe D:\phpstudy_pro\WWW\redis.test\redis-test.php

注意：如果提示 Class "Redis" not found，说明扩展没有加载；如果提示 Connection refused，说明 Redis 服务未启动；如果提示 NOAUTH Authentication required，说明 Redis 设置了密码，需要调用 $redis->auth('你的密码');。

小结

1. 先确认小皮面板中的 Redis 服务已启动，并通过 redis-cli ping 返回 PONG。
2. 确认网站使用的 PHP 版本，避免扩展开错版本。
3. 在 PHP 设置页的【扩展】中开启【redis】，或手动修改 php.ini 为 extension=redis。
4. 用 php -m | findstr redis 和 class_exists('Redis') 验证扩展是否加载。
5. 用最小 PHP 脚本连接 127.0.0.1:6379，能读写键值即说明环境可用。