PHP项目Jenkins自动化部署教程

积累知识，胜过积蓄金银！毕竟在文章开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《PHP项目如何实现Jenkins自动化部署》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

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 以确保插件生效。

三、创建 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
<h1>可选：运行 PHPUnit 测试</h1><h1>vendor/bin/phpunit --configuration phpunit.xml</h1><h1>复制代码到部署目录（或使用 rsync）</h1><p>rsync -avz --exclude="<em>.git</em>" ./ user@your-server:/var/www/html/project/</p>

注意：确保 Jenkins 用户有权限执行 composer 和 rsync 命令。

四、使用 Publish Over SSH 插件远程部署

更安全的方式是使用 Publish Over 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 验证是否正常运行
• 配置邮件通知或企业微信/钉钉机器人，在构建失败时及时告警

基本上就这些。整个流程实现了从代码提交到自动部署的闭环，提升开发效率，减少人为出错。关键是权限配置和脚本健壮性，建议先在测试环境验证再上线生产。

到这里，我们也就讲完了《PHP项目Jenkins自动化部署教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于CI/CD,自动化部署,jenkins,PHPproject,PublishOverSSH的知识点！