cPanel/WHM通过EasyApache自定义脚本安装PHP 5.2.17的完整流程

准备自定义安装模块

cPanel提供了标准的自定义模块接口，允许管理员通过wget命令拉取官方维护的旧版PHP安装包。首先需要通过SSH登录服务器终端，进入EasyApache的自定义模块目录：

1. 进入工作目录：切换至 /var/cpanel/easy/apache/custom_opt_mods。
2. 下载模块包：使用wget命令获取官方提供的打包文件。

# cd /var/cpanel/easy/apache/custom_opt_mods
# wget http://docs.cpanel.net/twiki/pub/EasyApache/EasyApacheCustomModules/custom_opt_mod-PHP5217.tar.gz
# tar -xzvf custom_opt_mod-PHP5217.tar.gz

解压完成后，系统中将存在识别PHP 5.2.17所需的配置文件与补丁信息。需要注意的是，该链接为cPanel历史文档资源，若当前环境无法直接访问外网，可能需要先在具备网络权限的环境中下载后上传至该路径。

通过EasyApache执行重编译安装

完成上述准备工作后，即可在Web管理界面触发安装进程。此过程会调用编译器重新生成PHP二进制文件，请确保服务器拥有足够的磁盘空间与编译资源。

第1步：进入EasyApache配置向导

登录 cPanel / WHM 控制面板，搜索并点击 “EasyApache (Apache Update)”。

第2步：选择预置方案（Profile）

开始构建过程中，进入 Step 2 (Select Profile)。此时不要使用默认的快捷方案，而是选择 “Start customizing based on current profile”。这将保留您服务器当前正在运行的其他服务配置（如MySQL版本、HTTP服务等），仅针对PHP版本进行替换。

第3步：添加新PHP版本选项

当进度条滑至 Step 4 (Choose PHP Version) 时，在下拉菜单或列表中寻找已安装的 PHP-5.2.17（即上一步骤中tar.gz包对应的条目）。勾选该版本作为当前服务器唯一或共存版本。

第4步：等待后台自动处理

确认版本选择无误后，一路保持默认设置点击“Next”或“Save”，直到 EasyApache 开始正式运行（Build Process）。

系统将显示日志滚动窗口。请耐心等待编译直至结束。如果中途报错中断，可尝试重启 WHM 服务后再次从断点继续。

扩展功能参数配置（可选）

由于这是非原生的手动编译行为，默认生成的 PHP 可能未包含常用的 GD 图像库或 FTP 支持。若您的项目依赖这些功能，需要在编译前手动注入编译参数。

挂载配置指令的方法

创建一个名为 PHP-5.2.17 的文件，填入所需的 --with-xxx 或 --enable-xxx 参数。每行一个，EasyApache 会在编译整合时将它们拼接在一起。

# 文件路径
/var/cpanel/easy/apache/rawopts/PHP-5.2.17

示例内容：

--with-gd
--enable-ftp
--with-mysql=shared,/usr

写入保存后，再次按照上文步骤触发一次 EasyApache 更新即可生效。