首先清理磁盘空间，包括系统缓存、日志文件、Docker资源和Composer缓存；然后通过设置COMPOSER_CACHE_DIR和TMPDIR环境变量将临时目录移至大容量路径；最后优化安装方式，使用--prefer-dist、--no-scripts、--no-dev等参数减少空间占用，确保Composer在有限资源下顺利完成。
当使用 Composer 安装或更新 PHP 包时，如果系统磁盘空间不足，会导致操作中断或失败。这类问题通常出现在服务器、虚拟机或 Docker 容器中。解决该问题需要从释放空间、调整配置和优化流程三方面入手。
清理磁盘空间
Composer 在执行安装时会下载依赖包并解压到临时目录，这些过程都需要足够的可用空间。若磁盘已满，第一步应清理无用文件：
- 清除系统缓存：运行 sudo apt clean（Debian/Ubuntu）或 yum clean all（CentOS/RHEL）来删除包管理器缓存。
- 删除旧日志文件：检查 /var/log 目录，移除过大的日志或使用 journalctl --vacuum-time=7d 清理 systemd 日志。
- 移除无用的 Docker 镜像或容器（如适用）：docker system prune -a 可大幅释放空间。
- 检查 Composer 自身缓存：运行 composer clear-cache 删除本地包缓存。
修改 Composer 临时目录位置
默认情况下，Composer 使用系统临时目录（如 /tmp），而该分区可能空间有限。可以将其指向空间更大的路径：
- 设置环境变量：export COMPOSER_CACHE_DIR="/path/to/larger/disk/composer-cache"
- 同时指定临时目录：export TMPDIR="/path/to/larger/disk/tmp"
- 确保目标目录存在且有写权限：mkdir -p "$TMPDIR" && chmod 777 "$TMPDIR"
这样 Composer 在解压和安装过程中将使用指定的大容量目录，避免因 /tmp 满导致失败。
优化 Composer 安装方式
在资源受限环境中，可通过以下方式减少空间占用：
- 使用 --prefer-dist 而非 --prefer-source：dist 包通常比源码小，且不含 .git 目录。
- 禁用脚本执行：添加 --no-scripts 参数跳过 post-install 等钩子，防止额外文件生成。
- 精简依赖：确认 composer.json 中无冗余包，生产环境使用 --no-dev 参数。
- 分步安装：先 composer install --dry-run 预估空间需求，再决定是否继续。
基本上就这些。关键是先释放空间，再调整路径和参数，让 Composer 在有限资源下顺利完成任务。
