PHP 线上环境 Composer 依赖包更新部署指南-简易版 - 教程

假设线上环境已经部署了代码，并且使用版本控制（如Git）和Composer。 (前提条件)

目标：安全地添加新的Composer依赖包并更新到线上环境。

步骤：

1. 在开发环境中添加依赖

2. 测试

3. 提交代码和Composer文件

4. 在线上环境拉取代码并更新依赖

5. 可能的重启服务步骤

详细步骤：

1. 开发环境：

   • 在项目根目录下，通过Composer添加依赖包，例如：

     composer require vendor/package

   • 这将更新composer.json和composer.lock文件。

2. 测试：

   • 在开发环境中进行测试，确保新依赖包不会引起问题。

3. 提交代码：

   • 将composer.json和composer.lock文件提交到版本控制系统（如Git）。

4. 线上环境更新：

   • 登录到线上服务器。

   • 进入项目目录。

   • 从版本控制拉取最新代码（包括composer.json和composer.lock）：

     git pull origin master

   • 确保拉取的代码包含最新的composer.json和composer.lock。

5. 安装依赖：

   • 在线上环境运行Composer安装，确保与lock文件一致：

     composer install --no-dev --optimize-autoloader

     参数说明：

     --no-dev: 不安装开发依赖，适用于生产环境。

     --optimize-autoloader: 优化自动加载器，提高性能。

6. 处理可能的问题：

   • 如果线上环境与开发环境的PHP版本或扩展有差异，Composer可能会报错。需要确保环境一致。

7. 重启服务：

   • 如果更新了依赖，可能需要重启PHP-FPM或Web服务器，以确保新的类被加载。

     sudo systemctl restart php-fpm

     或者，如果使用了OPCache，可能需要清除缓存或重启Web服务器。

8. 回滚计划：

   • 如果更新后出现问题，应能够快速回滚到之前的版本。可以使用Git的回滚：

     git reset --hard HEAD~1
     git pull origin master  # 或者回滚到特定标签

     然后再次运行composer install以回滚依赖。

9. 自动化部署：

   • 如果使用自动化部署工具（如Jenkins、GitLab CI/CD、Deployer等），上述步骤可以编写成脚本自动执行。

注意：在生产环境中操作前，最好先在预生产环境（staging）进行测试。

示例脚本（手动部署）：

假设项目目录为 /var/www/my-project

# 切换到项目目录
cd /var/www/my-project
# 拉取最新代码
git pull origin master
# 安装依赖
composer install --no-dev --optimize-autoloader
# 检查是否有数据库迁移等额外步骤（如果有）
# php artisan migrate --force   # 例如Laravel项目
# 重启PHP-FPM
sudo systemctl restart php-fpm
# 清除缓存（如有需要）
# php artisan cache:clear       # 例如Laravel项目
# php artisan view:clear

重要：确保在维护窗口或低流量时段进行更新，并备份数据库和重要文件。

如果项目使用了Docker或其他容器技术，步骤会有所不同，需要重新构建镜像并部署容器。

以上是传统服务器部署的步骤。