Jenkins可实现PHP项目自动化部署。首先准备Linux服务器、Jenkins、Git仓库、SSH免密登录和Composer；接着安装Git、SSH Plugin等必要插件并重启Jenkins；然后创建自由风格任务，配置Git源码管理、Webhook触发器，添加构建前清理；在构建步骤中执行composer install和rsync同步文件；推荐使用Publish Over SSH插件，在系统配置中设置私钥和目标服务器信息，并在构建后操作中定义文件传输与远程命令（如权限调整、缓存优化）；最后通过“立即构建”测试流程，验证部署结果并配置通知告警。整个流程确保代码提交后自动部署，提升效率与稳定性。
Jenkins 是一个强大的持续集成和持续部署（CI/CD）工具，广泛用于 PHP 项目的自动化构建与部署。下面详细介绍如何将 PHP 项目通过 Jenkins 实现自动化部署，包括流程说明、环境准备和配置步骤。
一、环境准备
在开始之前，确保以下环境已正确安装并运行：
- 服务器环境：Linux 系统（如 Ubuntu/CentOS），具备 Web 服务（Apache/Nginx）和 PHP 运行环境（PHP-FPM 或 CLI）
- Jenkins 服务：已安装 Jenkins，并可通过浏览器访问（默认端口 8080）
- Git 仓库：PHP 项目托管在 Git 服务上（如 GitHub、GitLab、Gitee 等）
- SSH 权限：Jenkins 服务器能通过 SSH 免密登录到目标部署服务器
- Composer：PHP 依赖管理工具，需在 Jenkins 执行环境中可用
二、Jenkins 插件安装与配置
登录 Jenkins 后台，进入“插件管理”页面，安装以下必要插件：
- Git plugin：支持从 Git 拉取代码
- SSH Plugin 或 Publish Over SSH：用于远程部署文件
- Build Timeout：防止构建卡死
- Workspace Cleanup Plugin：清理工作空间，避免残留文件影响
安装完成后重启 Jenkins 以确保插件生效。
立即学习“PHP免费学习笔记（深入）”；
三、创建 Jenkins 构建任务
点击“新建任务” → 输入任务名称 → 选择“构建一个自由风格的软件项目” → 点击“确定”。
1. 源码管理配置
在“源码管理”部分选择 Git，填写项目仓库地址，例如：
https://github.com/username/your-php-project.git
配置凭证（用户名 + 密码或 SSH 私钥），并指定分支（如 main 或 develop）。
2. 构建触发器
可根据需要设置触发方式：
- 轮询 SCM：Jenkins 定时检查代码变更（不推荐，有延迟）
- Webhook 触发：在 GitHub/GitLab 中配置 webhook，推送代码时自动触发构建（推荐）
3. 构建环境
勾选“删除工作空间前进行备份”或“构建前删除旧的工作空间”，避免历史文件干扰。
4. 构建步骤
添加“执行 Shell”命令，输入以下脚本完成代码构建与依赖安装：
#!/bin/bash # 安装 Composer 依赖 composer install --no-dev --optimize-autoloader可选：运行 PHPUnit 测试
vendor/bin/phpunit --configuration phpunit.xml
复制代码到部署目录（或使用 rsync）
rsync -avz --exclude=".git" ./ user@your-server:/var/www/html/project/
注意：确保 Jenkins 用户有权限执行 composer 和 rsync 命令。
四、使用 Publish Over SSH 插件远程部署
更安全的方式是使用 Publish Over SSH 插件将文件推送到目标服务器。
1. 配置 SSH 目标服务器进入“系统管理” → “系统配置” → 找到“Publish over SSH”
- Passphrase / Path to private key：填写 Jenkins 使用的私钥路径（如 /var/lib/jenkins/.ssh/id_rsa）
- SSH Servers：添加目标服务器信息（Hostname、Username、Remote Directory）
2. 在构建后操作中添加部署动作
在任务配置页，勾选“构建后操作” → “Send build artifacts over SSH”
- SSH Server: 选择已配置的服务器
- Source files: 如 **/* （表示所有文件）
- Remove prefix: / （可选）
- Remote directory: /var/www/html/project
- Exec command: 可填写部署后执行的命令，如：
chown -R www-data:www-data /var/www/html/project php /var/www/html/project/artisan optimize
五、测试与优化
保存配置后，点击“立即构建”测试流程是否成功。
- 查看构建日志，确认代码拉取、依赖安装、文件传输无报错
- 访问部署服务器上的项目 URL 验证是否正常运行
- 配置邮件通知或企业微信/钉钉机器人，在构建失败时及时告警
基本上就这些。整个流程实现了从代码提交到自动部署的闭环，提升开发效率，减少人为出错。关键是权限配置和脚本健壮性，建议先在测试环境验证再上线生产。
