PHP 管理器
GMSSH PHP 管理器是一款专为 Linux 服务器设计的 PHP 运行环境可视化管理工具。它提供直观的图形化界面，涵盖控制台、配置管理、函数禁用、性能配置、日志管理、phpInfo 及安装扩展七大核心模块，并支持多版本 PHP 的安装与切换，让 PHP 环境的部署、监控与调优变得前所未有的简单。
核心功能说明
PHP 管理器围绕 PHP 运行环境运维的完整工作流，提供七大核心模块：
| 模块 | 定位 | 核心能力 |
|---|---|---|
| 控制台 | 运行监控中心 | 基础运行信息、连接队列、进程状态、异常监控 |
| 配置管理 | 参数配置 | 常用配置、限制配置、Session 配置、配置文件、FPM 配置文件 |
| 函数禁用 | 安全管理 | PHP 危险函数的启用/禁用管理 |
| 性能配置 | 性能调优 | PHP-FPM 进程池与性能参数调优 |
| 日志管理 | 日志查看 | PHP 运行日志与慢日志管理 |
| phpInfo | 环境信息 | PHP 完整运行环境信息展示 |
| 安装扩展 | 扩展管理 | PHP 扩展的安装与管理 |
初始化
智能检测与多版本安装。首次打开 PHP 管理器时，系统会自动检测服务器上的 PHP 安装情况。
- 自动检测：如果未检测到 PHP，页面提示「检测到您未安装 PHP，请选择版本」，引导用户完成安装。
- 版本选择：点击「请安装」按钮或顶部版本下拉菜单，弹出「PHP 管理版本」面板。
版本管理
- 版本列表：以表格展示所有可用 PHP 版本，包含版本号、状态与操作。
- 多版本共存：支持同时安装多个 PHP 版本，通过顶部下拉菜单随时切换当前管理的版本。
- 当前默认：已安装版本中标注「当前默认」的为系统主要运行版本。
控制台
PHP-FPM 运行状态实时监控中心。控制台模块以仪表盘形式集中展示 PHP-FPM 的运行状态与各项性能指标。
- 运行状态：顶部展示当前 PHP 版本（如
PHP-8.3.25）与服务状态（「运行中」），绿色标识服务正常运行。 - 快捷操作：右上角提供三个操作按钮，支持一键暂停、停止与重启 PHP-FPM 服务。
基础运行信息
| 指标 | 说明 | 示例值 |
|---|---|---|
| 应用池 (pool) | 当前 PHP-FPM 进程池名称 | www |
| 进程管理方式 (process manager) | 进程管理模式 | dynamic |
| 启动日期 (start time) | PHP-FPM 服务启动时间 | 2026-03-19 10:09:27 |
连接与队列
| 指标 | 说明 |
|---|---|
| 请求数 (accepted conn) | 已接受的总请求数 |
| 请求队列 (listen queue) | 当前等待处理的请求队列长度 |
| 最大等待队列 (max listen queue) | 历史最高请求队列长度 |
| socket队列长度 (listen queue len) | Socket 监听队列长度 |
进程
以进度条与数值形式直观展示进程分布：
| 指标 | 说明 |
|---|---|
| 空闲进程数量 (idle processes) | 当前处于空闲状态的进程数 |
| 活跃进程数量 (active processes) | 当前正在处理请求的进程数 |
| 总进程数量 (total processes) | 进程池中的总进程数 |
| 最大活跃进程数量 (max active processes) | 历史最高活跃进程数 |
稳定性与异常监控
| 指标 | 说明 |
|---|---|
| 到达进程上限次数 (max children reached) | 进程池达到上限的次数，若频繁触发应增加 max_children |
| 慢请求数量 (slow requests) | 执行时间超过阈值的慢请求数量 |
配置管理
PHP 核心参数可视化配置。配置管理模块提供五个标签页，覆盖 PHP 运行时配置的各个维度。
常用配置
以表单形式展示最常调整的 PHP 核心参数：
| 参数 | 示例值 | 单位 | 说明 |
|---|---|---|---|
short_open_tag | 运行中 | — | 短标签支持（<? 语法） |
max_execution_time | 300 | 秒 | 最大脚本运行时间 |
max_input_time | 60 | 秒 | 最大输入时间 |
memory_limit | 128 | — | 脚本内存限制 |
post_max_size | 50 | M | POST 数据最大尺寸 |
file_uploads | 运行中 | — | 是否允许上传文件 |
upload_max_filesize | 50 | M | 允许上传文件的最大尺寸 |
max_file_uploads | 20 | — | 允许同时上传文件的最大数量 |
default_socket_timeout | 60 | 秒 | Socket 超时时间 |
error_reporting | E_ALL & ~E_NOTICE | — | 错误级别 |
- 保存 / 刷新：修改参数后点击「保存」写入配置，点击「刷新」恢复当前生效值。
限制配置
| 参数 | 示例值 | 单位 | 说明 |
|---|---|---|---|
| 上传限制 | 50 | MB | 文件上传大小限制 |
| 超时限制 | 100 | 秒 | 请求超时时间 |
- 影响范围：上传限制与超时限制均影响 Nginx 配置文件。
- 保存生效：修改后点击「保存」按钮即可生效。
Session配置
- 存储模式：通过下拉菜单选择 Session 存储方式（默认
files），支持切换为 Redis、Memcache 等。 - 性能建议：若站点并发比较高，使用 Redis 或 Memcache 能有效提升 PHP 并发能力。
- 注意事项：
- 若调整 Session 模式后网站访问异常，请切换回原来的模式。
- 切换 Session 模式会使在线的用户会话丢失，请在流量小的时候切换。
配置文件
- 代码编辑器：以带行号与语法高亮的编辑器展示
php.ini主配置文件完整内容，支持直接编辑。 - 快捷操作：支持
Ctrl+F搜索关键字、Ctrl+H查找替换。 - 保存生效：修改后点击「保存」按钮写入配置。
- 注意事项：此处为 PHP 主配置文件，若不了解配置规则，请勿随意修改。默认已开启 Openssl/Curl/Mysql 等扩展，详情可点击 phpInfo 查看。
FPM配置文件
- 代码编辑器：以带行号与语法高亮的编辑器展示 PHP-FPM 配置文件（含
[global]与[www]段），支持直接编辑进程管理、监听、超时等参数。 - 快捷操作：支持
Ctrl+F搜索关键字、Ctrl+H查找替换。 - 保存生效：修改后点击「保存」按钮写入配置。
- 注意事项：此处为 PHP-FPM 配置文件，若不了解配置规则，请勿修改。
函数禁用
PHP 危险函数安全管控。函数禁用模块以卡片网格形式展示所有已禁用的 PHP 函数，支持搜索与灵活管理，增强运行环境安全性。
- 禁用函数列表：以紫色卡片网格展示所有已禁用的函数名称（如
passthru、exec、system、shell_exec、popen、proc_open等）。 - 搜索：顶部提供函数名称搜索框，快速定位目标函数。
- 添加函数：右上角提供「添加函数」按钮，将新的函数加入禁用列表。
- 安全建议：强烈建议禁用如
exec、system等危险函数，以增强环境安全性。
性能配置
PHP-FPM 进程池深度调优。性能配置模块提供 PHP-FPM 核心性能参数的可视化配置，支持通过并发方案预设快速应用优化配置。
| 参数 | 示例值 | 说明 |
|---|---|---|
| 并发方案 | 4GB内存 | 根据服务器内存规格选择预设方案 |
| 连接方式 | Unix套接字 | 推荐使用 Unix 套接字，性能优于 TCP |
| 连接信息 | /tmp/php-cgi-83.sock | 绑定 IP、监听端口或 Unix 套接字地址 |
| IP白名单 | 127.0.0.1 | 允许访问 PHP 的 IP，多个请用逗号隔开 |
| 运行模式 | 静态 | PHP-FPM 运行模式 |
| max_children | 150 | 允许创建的最大子进程数 |
| start_servers | 10 | 起始进程数（服务启动后初始进程数量） |
- 运行模式说明：
- 静态模式：始终维持设置的子进程数量，对内存开销较大，但并发能力较好。
- 动态模式：按设置最大空闲进程数来收回进程，内存开销小，建议小内存机器使用。
- 按需模式：根据访问需求自动创建进程，内存开销极小，但并发能力略差。
- 注意事项：
max_children越大并发能力越强，但最大不要超过 5000。- 每个 PHP 子进程需要约 20MB 内存，过大的
max_children会导致服务器不稳定。 - 若要外网访问，需将连接方式改为 TCP 套接字，并将绑定 IP 改为
0.0.0.0，同时配置 IP 白名单和防火墙放行端口。
日志管理
PHP-FPM 运行日志与慢日志管理。日志管理模块提供「日志」与「慢日志」两个标签页。
日志
- 运行日志：展示 PHP-FPM 运行日志，包含 FPM 启动信息（如
fpm is running, pid 360906）与连接就绪状态（ready to handle connections），每条日志附带精确时间戳。
慢日志
- 慢请求日志：展示执行时间超过阈值的慢请求记录，帮助定位性能瓶颈。
phpInfo
PHP 运行环境全景信息。phpInfo 模块以结构化形式展示当前 PHP 版本的完整运行环境信息。
基本信息
| 项目 | 说明 |
|---|---|
| version | 当前 PHP 版本号（如 8.3.25） |
| 安装位置 | PHP 安装目录（如 /www/server/php/） |
| php.ini | 配置文件路径（如 /www/server/php/83/etc/php.ini） |
| 已加载 | 已加载的 PHP 扩展模块列表 |
- 查看 phpinfo：右上角提供「查看 phpinfo」链接，可打开完整的
phpinfo()页面。
安装扩展
PHP 扩展一键安装与管理。安装扩展模块以列表形式展示所有可用 PHP 扩展，支持一键安装。
- 扩展列表：以表格展示所有可安装的扩展，包含名称、类型、说明、状态与操作列：
| 列 | 说明 |
|---|---|
| 名称 | 扩展名称（如 intl、Swoole5、Swoole6 等） |
| 类型 | 扩展分类（通用扩展 / 缓存器） |
| 说明 | 扩展功能描述 |
| 状态 | ✅ 已安装 / 未安装 |
| 操作 | 安装 / 卸载按钮 |
- 注意事项：
- 部分扩展（如 Redis）仅支持单版本安装，请勿重复安装。
- OPcache、XCache、apcu 等属于缓存扩展互斥，仅可安装其一，避免引发 PHP 异常。
- 若安装失败，请查阅安装日志排查问题。