PHP代码未执行可能因入口未集成、权限未生效或Web服务器未重载；可通过Webhook调用PHP接口（需令牌校验）或部署后直接CLI执行脚本触发。
如果您在完成自动化部署后，发现 PHP 代码未按预期执行，则可能是由于部署流程未正确集成执行入口、权限未生效或 Web 服务器未重载配置。以下是触发 PHP 代码执行的多种方法：
一、通过 Webhook 调用 PHP 脚本接口
Webhook 可在代码推送到仓库或 CI/CD 流水线成功后，向预设的 PHP 接口发起 HTTP 请求，从而触发脚本运行。该方式无需额外权限配置，依赖 Web 服务器已启用的 PHP 解析能力。
1、在目标服务器上创建一个可公开访问的 PHP 文件，例如 /var/www/html/deploy-trigger.php，内容包含需执行的逻辑及访问令牌校验。
2、在 CI/CD 配置（如 GitHub Actions 或 GitLab CI）的 job 后续步骤中添加 curl 命令：curl -X POST "https://your-domain.com/deploy-trigger.php?token=abc123"。
立即学习“PHP免费学习笔记（深入）”；
3、确保该 PHP 文件具有最小化权限，且 token 参数必须严格校验，防止未授权调用。
二、部署后直接执行 CLI 模式 PHP 脚本
在自动化部署脚本末尾调用系统命令执行 PHP，绕过 Web 服务层，适用于定时任务、数据迁移或初始化操作等非响应式场景。
1、编写独立 PHP 脚本，例如 /opt/app/scripts/post-deploy.php，以
2、在部署脚本（如 deploy.sh）中追加命令：php /opt/app/scripts/post-deploy.php >> /var/log/deploy-exec.log 2>&1。
3、确认执行用户对脚本有读取和执行权限，并检查 PHP CLI 版本与脚本语法兼容：php -v。
三、利用 systemd 服务监听部署完成事件
通过自定义 systemd 服务监听部署目录变更或特定标记文件生成，实现事件驱动式 PHP 执行，适合长期运行且需高可靠性的环境。
1、创建 inotifywait 监听脚本 /usr/local/bin/watch-deploy.sh，监控 /var/www/html/.deploy-finished 文件创建事件。
2、配置 systemd service 单元文件 /etc/systemd/system/deploy-watcher.service，设置 Type=simple 并指向该监听脚本。
3、在监听脚本检测到事件后，执行：php /var/www/html/trigger.php &，并确保其不阻塞主进程。
四、修改 Nginx/Apache 配置自动加载 PHP 处理器
部署过程中若更新了 PHP 配置或扩展，需重启或重载 Web 服务器以使新设置生效，否则 PHP 代码可能被当作静态文件返回或报 502 错误。
1、在部署脚本中加入重载命令：sudo nginx -t && sudo systemctl reload nginx（Nginx 场景）。
2、对于 Apache，使用：sudo apachectl configtest && sudo systemctl reload apache2。
3、确保执行用户已加入 www-data 或 nginx 组，且具备执行 systemctl reload 的 sudo 权限（通过 visudo 配置免密指令）。
五、通过 Composer 自动加载 post-autoload-dump 钩子
当部署包含 composer.json 的 PHP 项目时，composer install 或 update 完成后会自动触发 autoload 钩子，可在其中嵌入执行逻辑。
1、在 composer.json 的 "scripts" 字段中添加："post-autoload-dump": "php scripts/after-load.php"。
2、确保 scripts/after-load.php 文件存在且具有可执行权限，且路径相对于 composer.json。
3、部署流程中必须执行 composer install --no-dev --optimize-autoloader，否则钩子不会触发。
