Cherokee需通过PHP-FPM或CGI模式集成PHP：一、确认PHP≥7.4并启用php-fpm服务；二、在Cherokee管理界面添加PHP-FPM源并绑定.php扩展；三、部署info.php测试解析；四、PHP-FPM异常时可改用CGI模式。
如果您希望在 Cherokee Web 服务器中运行 PHP 应用程序，则需要将 Cherokee 与 PHP 解释器正确集成。Cherokee 本身不内置 PHP 执行能力，必须通过外部处理器（如 PHP-FPM 或 CGI 模式）进行配置。以下是完成该集成的具体步骤：
一、确认 PHP 安装状态并启用 PHP-FPM
Cherokee 推荐使用 PHP-FPM（FastCGI Process Manager）作为后端处理器，因其稳定性与性能优于传统 CGI 模式。需确保系统已安装 PHP 及其 FPM 组件，并处于运行状态。
1、执行 php -v 验证 PHP 是否已安装且版本不低于 7.4。
2、执行 systemctl list-units | grep php-fpm 检查 php-fpm 服务是否存在。
立即学习“PHP免费学习笔记（深入）”；
3、若未安装，使用包管理器安装：Ubuntu/Debian 系统运行 sudo apt install php-fpm；CentOS/RHEL 系统运行 sudo yum install php-fpm 或 sudo dnf install php-fpm。
4、启动并启用服务：sudo systemctl start php-fpm && sudo systemctl enable php-fpm。
二、配置 Cherokee 使用 PHP-FPM 后端
Cherokee 需通过“Information Sources”功能添加 PHP-FPM 作为外部应用源，并在虚拟服务器中绑定 PHP 处理规则。此步骤建立 FastCGI 连接通道。
1、打开 Cherokee 管理界面（通常为 http://127.0.0.1:9090），登录后进入 Sources 标签页。
2、点击 + Add，选择 PHP-FPM 类型，命名如 php_fpm_local。
3、在配置中设置监听地址：若 php-fpm 配置为 Unix socket（推荐），填入 unix:///var/run/php/php-fpm.sock；若为 TCP，填入 127.0.0.1:9000（需与 /etc/php/*/fpm/pool.d/www.conf 中 listen 值一致）。
4、保存后返回 Virtual Servers → 选择目标站点 → 进入 Behavior 标签页。
5、点击 + Rule → 选择 Extensions → 输入 php → 点击 Handler 下拉框，选择 FastCGI → 在弹出窗口中指定刚创建的 php_fpm_local 源。
三、验证 PHP 文件解析能力
配置完成后，Cherokee 将把所有 .php 扩展请求转发至 PHP-FPM 进程处理。需部署测试脚本并检查响应是否为 PHP 解析结果，而非原始代码输出。
1、在网站根目录（如 /var/www/cherokee/）下新建文件 info.php，内容为 。
2、确保该文件权限允许 Cherokee 用户读取：sudo chown www-data:www-data /var/www/cherokee/info.php（Ubuntu/Debian）或 sudo chown nginx:nginx /var/www/cherokee/info.php（CentOS/RHEL，依 Cherokee 运行用户而定）。
3、重启 Cherokee 服务：sudo systemctl restart cherokee。
4、浏览器访问 http://your-server-ip/info.php，页面应完整显示 PHP 配置信息表；若看到原始代码或 502 错误，则表明 FastCGI 连接失败或权限异常。
四、备用方案：配置 Cherokee 使用 CGI 模式运行 PHP
当 PHP-FPM 不可用或调试需要时，可临时启用 CGI 模式。该方式为每个请求启动独立 PHP 进程，性能较低但兼容性更广，适合低流量环境或故障排查。
1、确认系统存在 php-cgi 可执行文件：运行 which php-cgi，输出应为类似 /usr/bin/php-cgi 的路径。
2、在 Cherokee 管理界面进入 Sources → + Add → 选择 Local interpreter，命名为 php_cgi_bin。
3、在解释器路径栏填写 /usr/bin/php-cgi（以实际路径为准），其他字段保持默认。
4、进入对应虚拟服务器的 Behavior 标签页，新增扩展规则 php，Handler 选择 CGI，并指定刚创建的 php_cgi_bin 源。
5、保存配置并重启 Cherokee，再次访问 info.php 验证输出。
