PHP 版本发布流程

PHP 版本发布流程详解

发布前的准备工作

1 版本规划与评审

在正式发布前，团队需要进行充分的版本规划和评审,包括：

• 功能范围确认：明确本次版本包含的新功能和变更范围
• 风险评估：评估代码变更可能带来的风险
• 兼容性检查：确认与现有系统的兼容性
• 性能评估：评估新版本对系统性能的影响

2 代码冻结

• 设定代码冻结日期，之后仅允许合并修复关键bug的Pull Request
• 冻结后进入稳定化阶段，集中处理发现的bug

3 环境准备

• 搭建预发布环境（staging environment），模拟生产环境
• 准备部署脚本和回滚方案
• 确保备份机制完善

版本开发与测试流程

1 持续集成（CI）

建立高效的CI流程是保证代码质量的基础：

# 示例GitHub Actions工作流程
name: PHP CI
on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: Setup PHP
      uses: shivammathur/setup-php@v2
      with:
        php-version: '8.2'
    - name: Install dependencies
      run: composer install --no-progress
    - name: Run test suite
      run: |
        ./vendor/bin/phpunit
        ./vendor/bin/phpcs --standard=PSR12 src/

2 自动化测试

在发布前必须完成以下测试：

• 单元测试：涵盖所有核心业务逻辑
• 集成测试：验证模块间交互
• 功能测试：模拟真实使用场景
• 安全测试：检查常见安全漏洞
• 性能测试：压力测试和负载测试

3 手动测试清单

### 发布前手动测试清单
- [ ] 新功能在主要浏览器（Chrome, Firefox, Safari, Edge）上正常
- [ ] 移动端响应式适配正常
- [ ] 数据库迁移无误
- [ ] 环境配置变量正确
- [ ] 第三方服务集成正常
- [ ] 日志记录正常
- [ ] 监控告警正常

版本号管理

1 语义化版本规范（SemVer）

遵循语义化版本2.0.0规范：

主版本号.次版本号.修订号
示例：v2.5.1
- 主版本号(MAJOR)：不兼容的API变更
- 次版本号(MINOR)：向后兼容的功能性新增
- 修订号(PATCH)：向后兼容的问题修正

2 发布类型

# 日常开发版本（dev）
php artisan version:dev
# 测试版本（beta/RC）
php artisan version:beta 1.2.0
php artisan version:rc 1.2.0
# 稳定版本
git tag -a v1.2.0 -m "Release version 1.2.0"

发布执行流程

1 部署前检查

#!/bin/bash
# 发布前检查脚本示例
echo "Checking environment variables..."
./scripts/check_env.sh
echo "Running database migrations check..."
php artisan migrate:status
echo "Checking file permissions..."
./scripts/check_permissions.sh
echo "Running security checks..."
./scripts/security_check.sh
echo "All checks completed"

2 部署步骤

采用蓝绿部署或滚动部署策略：

# 示例：使用Deployer进行PHP部署
namespace deploy
host production
    user deploy
    hostname example.com
    deploy_path /var/www/html
task deploy
    # 使用Git拉取代码
    - git:update
    # 安装PHP依赖
    - deploy:vendors
    # 迁移数据库
    - artisan:migrate --force
    # 清理缓存
    - artisan:cache:clear
    - artisan:config:cache
    - artisan:route:cache
    # 设置文件权限
    - deploy:permissions
    # 重启PHP-FPM
    - exec: 'sudo systemctl restart php8.2-fpm'

3 数据库迁移策略

// 定义迁移顺序和限制
public function up()
{
    // 先创建新列，避免破坏现有功能
    Schema::table('users', function (Blueprint $table) {
        $table->string('phone')->nullable()->after('email');
    });
    // 然后执行数据迁移脚本
    DB::statement('UPDATE users SET phone = ...');
}

发布后监控与回滚

1 发布后检查

• 应用监控：检查错误日志、异常报告
• 服务器监控：CPU、内存、磁盘使用率
• 业务监控：核心业务指标是否正常
• 用户反馈：监测用户反馈渠道

2 回滚机制

#!/bin/bash
# 一键回滚脚本
# 切换到上一个版本
cd /var/www/html
git checkout v1.1.0
# 恢复数据库
php artisan migrate:rollback --step=1
# 重建缓存
php artisan config:clear
php artisan cache:clear
# 重启服务
sudo systemctl restart php8.2-fpm
nginx -s reload

特别注意事项

1 安全考虑

• 发布前检查依赖包的漏洞（使用Composer Audit）
• 确保敏感配置（数据库密码、API密钥等）不泄露到代码库
• 启用安全头（如CSP、X-Frame-Options等）

2 性能优化

• 使用OPcache缓存PHP脚本
• 配置负载均衡（如Nginx + PHP-FPM）
• 启用CDN缓存静态资源

3 文档更新

发布后同步更新：

• API文档
• 用户手册
• 部署文档
• 版本更新日志（Changelog）

发布检查清单

□ 代码审查通过
□ 所有自动化测试通过
□ 手动测试完成
□ 数据库迁移测试通过
□ 安全扫描无高危漏洞
□ 性能测试通过
□ 预发布环境验证完成
□ 部署脚本测试成功
□ 回滚方案验证可行
□ 监控告警配置完成
□ 文档更新完毕
□ 变更日志更新完成
□ 相关团队成员通知到位

通过严格的发布流程管理，配合自动化工具和完善的监控体系，可以确保PHP应用发布的稳定性和可靠性，降低上线风险，每个团队可根据实际情况调整流程细节，但核心原则必须坚持：充分的准备、严格的验证、可控的实施、快速的回滚。