必须手动编译适配PHP 8.3的Redis、Swoole、GD等扩展：Linux下用pecl install redis或源码编译（phpize需匹配8.3），Swoole须用5.1.x并装oniguruma-devel等依赖，GD需显式安装libwebp-devel且configure中--with-freetype必须置于--with-gd之后；Windows下须下载VC17+TS/NTS匹配的DLL并正确命名启用。
要在生产环境启用 PHP 8.3 的 Redis、Swoole、GD 等关键扩展，必须绕过包管理器的版本滞后限制，手动编译适配——否则 php -m 不显示模块、composer require 报 extension not found、Web 请求直接 500。
编译安装 Redis 扩展（Linux）
方法一：用 pecl 安装（推荐新手）
执行 pecl install redis，过程中按回车接受默认选项即可；安装完成后，CLI 模式会自动写入 /etc/php/*/cli/conf.d/redis.ini，但 FPM 模式不会同步生效。
方法二：源码编译（可控性强）
下载与 PHP 8.3 匹配的 redis 扩展源码：wget https://github.com/phpredis/phpredis/archive/refs/tags/6.0.3.tar.gz；解压后进入目录，运行 phpize && ./configure && make && sudo make install；这一步依赖 【phpize 必须来自 PHP 8.3 安装路径】，否则编译出的 .so 文件在运行时会报 undefined symbol 错误。
配置启用：
编辑 /usr/local/php/etc/php-fpm.d/www.conf，在末尾添加 php_admin_value[extension] = redis.so；重启 php-fpm 服务后执行 php-fpm -t 验证配置语法无误。
立即学习“PHP免费学习笔记（深入）”；
安装 Swoole 5.1.x 协程扩展
第一步：确认版本兼容性
运行 php -v 和 php-config --version，两个输出必须都是 8.3；若不一致，说明当前 pecl 调用的是旧版 PHP 的工具链，需先用 export PATH="/usr/local/php/bin:$PATH" 修正路径。
第二步：安装开发依赖
Ubuntu/Debian 执行 sudo apt install php-dev；Rocky Linux 9 执行 sudo dnf install php-devel oniguruma-devel libzip-devel；缺少 oniguruma-devel 会导致 configure 阶段报错 “Package 'oniguruma' not found”，且无法跳过。
第三步：pecl 安装并验证
执行 pecl install swoole，安装成功后检查 /etc/php/*/fpm/conf.d/20-swoole.ini 是否存在；若不存在，手动创建该文件并写入 extension=swoole.so；最后在 PHP 脚本中调用 Swoole\Runtime::enableCoroutine() 启用协程 Hook，否则异步 I/O 不生效。
启用 GD 图形扩展
GD 编译失败常因图像库头文件缺失，不是加个 --enable-gd 就能跑通。
先确保系统已安装：libpng-devel、libjpeg-devel、freetype-devel、libwebp-devel（Rocky 9 必须显式装 libwebp-devel，否则 configure 会静默禁用 webp 支持）。
重新编译 PHP 主体时，在 configure 参数中加入：--with-gd --with-jpeg --with-webp --with-freetype；注意顺序不能颠倒——【--with-freetype 必须放在 --with-gd 后面】，否则 configure 会忽略 freetype 支持，导致 imagettftext() 函数不可用。
编译完成后，运行 php -i | grep -A5 gd，确认输出中包含 gd.jpeg_ignore_warning => 1 => 1 和 gd.webp support => enabled，才算真正启用成功。
Windows 下安装 redis.dll 和 swoole.dll
PHP 8.3 的 Windows 扩展不能混用：TS（线程安全）版本必须搭配 Apache + mod_php，NTS（非线程安全）版本只能用于 CLI 或 Nginx + php-fpm。
去 https://www.php.cn/link/afcf99a084ec63c94f1cf5094ba2b133 下载对应版本：redis-6.0.3-8.3-ts-vc17-x64.zip 和 swoole-5.1.1-8.3-nts-vc17-x64.zip。
解压后将 php_redis.dll 和 php_swoole.dll 复制到 PHP 安装目录的 ext/ 子目录；打开 php.ini，在 ;extension=mbstring 后追加两行：extension=php_redis.dllextension=php_swoole.dll；保存后重启 Web 服务，访问 phpinfo() 页面搜索 “redis” 和 “swoole” 即可确认加载状态。
