概述

系统运行基于 PHP 8.0+。在宝塔面板安装 PHP 8.0 后，需完成必需扩展安装、禁用函数移除以及内存限制调整。

---

步骤一：安装基础 PHP 扩展

进入宝塔面板【软件商店 -> 已安装 -> PHP-8.0 -> 设置 -> 安装扩展】：

依次点击安装以下扩展：

1. fileinfo
2. redis
3. swoole4 (版本需 >= 4.0.10，推荐 4.8.x)

NOTE

pdo_mysql、openssl、bcmath、curl、mbstring、gd 等为宝塔 PHP 8.0 默认内置扩展，无需重复安装。

---

步骤二：安装专属核心加载扩展 (ebaozu_loader)

系统核心组件基于专属高性能 PHP 原生扩展 ebaozu_loader.so 驱动（随商业交付包 loader/ 目录提供）：

1. 查询当前 PHP 8.0 扩展目录： 在宝塔面板【终端】或 SSH 执行以下命令：

   /www/server/php/80/bin/php-config --extension-dir
   # 宝塔面板典型输出示例: /www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/

2. 复制扩展文件并赋予权限： 进入项目解压后的目录，将 loader/ebaozu_loader.so 复制至 PHP 扩展目录并赋予 755 执行权限：

   EXT_DIR=$(/www/server/php/80/bin/php-config --extension-dir)
   cp loader/ebaozu_loader.so "${EXT_DIR}/"
   chmod 755 "${EXT_DIR}/ebaozu_loader.so"

   (亦可在宝塔【文件】管理器中，将 loader/ebaozu_loader.so 直接复制到上述扩展目录，并将其权限设为 755、所有者设为 root 或 www)

3. 在 php.ini 中启用扩展： 进入宝塔面板【PHP-8.0 设置 -> 配置文件】，在文件最末尾添加：

   ; 启用 EBAOZU 商业核心加载器扩展 (注意: 必须为 extension，严禁使用 zend_extension)
   extension=ebaozu_loader.so

   WARNING

   必须使用 extension=ebaozu_loader.so，严禁写成 zend_extension。

---

步骤三：移除禁用函数

进入【PHP-8.0 设置 -> 禁用函数】：

在列表中找到并删除以下函数（解禁）：

• proc_open（消息队列与后台任务派发必需）
• pcntl_signal / pcntl_alarm（多进程调度与信号处理必需）

---

步骤四：调整脚本内存与配置

1. 进入【PHP-8.0 设置 -> 配置修改】：
   • 将 memory_limit 脚本内存限制调整为 512M 或更大；
   • 将 max_execution_time 执行超时时间调整为 300。
2. 进入【PHP-8.0 设置 -> 配置文件】：
   • 确认包含 swoole.use_shortname = off 配置（避免短标签命名冲突）。

---

步骤五：重启 PHP 并验证扩展状态

1. 进入【PHP-8.0 设置 -> 服务】，依次点击【重载配置】和【重启】；
2. 在宝塔【终端】或 SSH 中执行以下命令检测扩展是否生效：

   /www/server/php/80/bin/php --ri ebaozu_loader

   预期终端输出（若正常输出以下信息则表示加载成功）：

   ebaozu_loader
   ebaozu loader extension => enabled
   version => 1.0.0
   product_line => ebaozu_v4
   key_id => <您的客户专属KeyID>

3. 前往宝塔面板【网站】页面上方，将 【PHP 命令行版本】 切换为 PHP-80，确保 CLI 环境一致。