Debian 环境下使用 Composer 的项目构建与部署
一 环境准备与 Composer 安装
- 安装系统依赖：sudo apt update && sudo apt install -y curl php-cli php-mbstring git unzip。这些组件分别用于下载安装器、执行 PHP、处理多字节字符串、拉取依赖与解压包。完成后可用 php -v 与 composer -V 验证版本。
- 全局安装 Composer（推荐）：
- 下载并校验安装脚本：curl -sS https://getcomposer.org/installer -o composer-setup.php
- 获取并校验 SHA-384（示例为 Debian 11 常用方式）：HASH=$(curl -sS https://composer.github.io/installer.sig)
- 校验并安装：php -r “if (hash_file(‘SHA384’, ‘composer-setup.php’) === ‘$HASH’) { echo ‘Installer verified’; } else { echo ‘Installer corrupt’; unlink(‘composer-setup.php’); } echo PHP_EOL;”
- 全局放置可执行文件：sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
- 国内镜像（可选，提升下载速度）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
二 本地构建流程
- 初始化与添加依赖：
- 初始化项目：composer init（按提示填写或一路回车使用默认）
- 添加依赖：composer require monolog/monolog（示例），或编辑 composer.json 后执行 composer install
- 开发与运行：
- 在入口或引导文件顶部引入自动加载：require DIR.‘/vendor/autoload.php’;
- 运行自定义脚本（如框架命令、构建任务）：composer run-script post-install-cmd（需在 composer.json 的 scripts 中定义）
- 版本锁定与可复现构建：
- 初次安装后生成或更新 composer.lock，应将其纳入版本控制；团队协作与 CI/CD 中，部署端优先使用 composer install 读取锁文件以保证一致性。
三 生产部署与优化
- 标准流程（推荐在 CI 或目标服务器执行）：
- 拉取代码（含 composer.json 与 composer.lock）
- 安装生产依赖：composer install –no-dev --optimize-autoloader --classmap-authoritative
- –no-dev：排除 require-dev 中的开发依赖
- –optimize-autoloader：生成类映射，提升性能
- –classmap-authoritative（可选）：进一步减少文件系统 stat 调用
- 设置文件权限与所有者（示例）：chown -R www-data:www-data /var/www/your-app && chmod -R 755 /var/www/your-app
- 启动服务（按项目类型）：如 php-fpm、Swoole、RoadRunner、或传统 FPM/FastCGI 配合 Nginx/Apache
- 离线打包与传输（可选）：
- 在构建机执行：composer install –no-dev --optimize-autoloader
- 打包：tar -czf deploy.tar.gz . -X .gitignore（确保 .env、敏感文件与缓存不被打包）
- 传输至目标服务器并解压，直接启动应用（无需再运行 composer install）
- 零停机与回滚建议：
- 使用 蓝绿部署/金丝雀发布；先切换反向代理/负载均衡指向新版本，观察日志与健康检查后再下线旧版本
- 保留最近 N 个可回滚版本（按时间戳或 Git 标签），回滚时直接切换符号链接或负载权重
四 常用命令与注意事项
- 依赖管理速查：
- 安装生产依赖：composer install –no-dev
- 更新依赖：composer update（或 composer update vendor/package）
- 移除依赖：composer remove package-name
- 清理无用包：composer prune
- 安全与性能要点：
- 始终提交并部署 composer.lock，避免生产环境产生不可预期的版本漂移
- 生产环境不要运行 composer update；如需升级，先在测试环境验证并更新锁文件后再部署
- 使用 –optimize-autoloader 提升类加载性能；必要时启用 –classmap-authoritative
- 若使用私有包，配置合适的 auth.json 或私有仓库凭据，避免构建失败
- 在 CI/CD 中缓存 Composer 缓存目录（如 ~/.composer/cache）以显著加速安装阶段