配置Composer缓存可显著提升TeamCity中PHP项目的构建速度。1. 理解Composer缓存机制：Composer默认将下载的包存储在用户主目录下的缓存路径中，如Linux/macOS为~/.composer/cache，Windows为%APPDATA%\Composer\cache，避免重复下载。2. 确保构建代理运行用户一致、缓存路径未被清理且不同构建能访问相同缓存目录。3. 在TeamCity中实现持久化缓存：使用固定构建代理确保在同一机器运行；通过设置全局缓存路径如composer config --global cache-dir "%TEAMCITY_AGENT_DIR%/.composer/cache"固定位置；避免使用--no-cache选项。4. 优化构建脚本：采用composer install --prefer-dist --no-interaction优先使用压缩包安装，加快依赖获取。5. 定期维护缓存：运行composer clear-cache或手动清理旧缓存，防止磁盘占用过高，建议结合定时任务在非高峰时段执行。合理配置后，依赖安装时间可减少50%以上，尤其适用于大型PHP项目，关键在于保持环境稳定以最大化缓存复用效果。
在使用TeamCity进行PHP项目的持续集成时，Composer作为依赖管理工具会频繁下载包，导致构建变慢。通过配置Composer缓存，可以显著提升构建速度，减少网络请求和服务器负载。以下是为PHP项目在TeamCity中配置Composer缓存的实用指南。
理解Composer缓存机制
Composer本身支持本地缓存，用于存储已下载的包（如zip文件、dist文件等），避免重复从远程仓库拉取。默认情况下，这些缓存位于用户主目录下的~/.composer/cache（Linux/macOS）或%APPDATA%\Composer\cache（Windows）。TeamCity运行构建代理时通常以特定用户身份执行，因此只要路径一致，缓存可被复用。
关键点是确保：
- 构建代理的运行用户保持一致
- Composer的缓存路径未被清理
- 不同构建之间能访问相同的缓存目录
在TeamCity中启用持久化缓存
TeamCity本身不提供内置的“缓存”功能像GitHub Actions或GitLab CI那样直接，但可以通过以下方式实现Composer缓存的持久化：
立即学习“PHP免费学习笔记（深入）”；
- 使用固定的构建代理：将项目绑定到特定的构建代理（静态Agent），确保每次构建都在同一台机器上运行，从而自然复用Composer缓存。
- 保留缓存目录：在构建脚本前后，不清理Composer的缓存路径。可在构建步骤中显式查看缓存状态：
composer config --global cache-dir "/opt/teamcity-agent/.composer/cache"
echo "Using Composer cache: $(composer config --global --list | grep cache-dir)"
- 避免使用--no-cache：不要在composer install命令中添加--no-cache选项。
优化构建脚本以利用缓存
在TeamCity的构建步骤中，推荐使用如下脚本结构：
确保全局缓存路径固定
composer config --global cache-dir "%TEAMCITY_AGENT_DIR%/.composer/cache"
显示当前缓存使用情况（可选，便于调试）
composer show -v | grep "Cache" || true
安装依赖，自动使用缓存
composer install --prefer-dist --no-interaction
其中：
- --prefer-dist 优先使用压缩包（更高效，适合CI）
- 固定cache-dir 避免因用户环境差异导致缓存失效
- %TEAMCITY_AGENT_DIR% 是TeamCity预定义变量，指向代理工作目录
定期维护缓存
虽然缓存提升性能，但长期积累可能导致磁盘占用过高。建议：
- 定期在构建代理上运行composer clear-cache 或手动清理旧缓存
- 设置磁盘监控，防止缓存膨胀影响其他项目
- 可在非高峰时段添加定时维护任务
基本上就这些。合理配置后，后续构建的依赖安装时间通常能减少50%以上，尤其对大型PHP项目效果明显。关键是保持构建环境稳定，让Composer有机会复用已有资源。
