换源后临时文件仍在旧目录,因TMPDIR与cache-dir独立;需手动清理旧cache-dir、按URL机械映射规则删除对应repo缓存,并确保TMPDIR不落在性能黑洞路径。

换源后临时文件还在旧目录?先确认 TMPDIR 是否被覆盖
Composer 解压 ZIP、生成 autoloader、执行脚本时重度依赖系统临时目录(sys_get_temp_dir()),它和 cache-dir 是两套路径,换源或改缓存路径完全不影响 TMPDIR。很多用户改了 cache-dir 却发现 C:\Users\xxx\AppData\Local\Temp 或 /tmp 里仍堆满几百 MB 的 composer_archive_*.zip 和解压残骸,就是这个原因。
验证方式:运行 php -r "echo sys_get_temp_dir();",再 ls -lSh $(php -r "echo sys_get_temp_dir();") | head -10(Linux/macOS)或资源管理器打开对应路径查看。
- Linux/macOS/WSL2:建议导出
TMPDIR=/dev/shm(内存盘),避免磁盘 I/O 拖慢安装;Docker 中加ENV TMPDIR=/dev/shm - Windows CMD:用
set TMPDIR=C:\temp(需提前建好目录) - PowerShell:用
$env:TMPDIR="C:\temp",注意该变量只对当前会话生效,要持久化得写入 profile - 别让
TMPDIR落在 WSL2 的/mnt/c/下——这是性能黑洞,解压一个 50MB ZIP 可能卡 20 秒以上
cache-dir 改了,但旧缓存没迁移?clear-cache 不自动搬数据
composer config --global cache-dir 只是告诉 Composer “以后存哪儿”,不会把老缓存拷过去,也不会删旧的。你看到的“临时文件还在旧目录”,往往是因为 clear-cache 后 Composer 立即在新路径重建缓存,但旧 ~/.composer/cache 或 %APPDATA%\Composer\Cache 目录还静静躺着,占着空间、干扰判断。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 必须手动删旧缓存目录:
rm -rf ~/.composer/cache(Linux/macOS)或rd /s /q "%APPDATA%\Composer\Cache"(Windows CMD) - 删之前先确认旧路径:
composer config --global cache-dir输出的是“当前配置”,不是“当前实际路径”;用composer diag看 Cache directory: 行才是真正在用的位置 - 删完立刻跑一次
composer clear-cache,观察日志是否清理的是你设的新路径下的repo/、files/、vcs/子目录 - 如果项目刚换私有源,记得同步清
cache-vcs-dir(若已设置)和cache/repo/下对应源子目录,否则元数据还是旧的
私有源 URL 变了,但 repo 缓存路径没更新?URL 到缓存路径的转换规则很死板
Composer 把私有源 URL 映射成缓存子目录时,不解析域名、不归一化路径,而是机械替换:https:// → https---,/ → -,末尾不加斜杠。比如从 https://gitlab.example.com/api/v4/groups/my-group/-/packages/composer 换成 https://gitlab.example.com/api/v4/groups/our-group/-/packages/composer,缓存路径就从 https---gitlab.example.com-api-v4-groups-my-group---packages-composer 变成 https---gitlab.example.com-api-v4-groups-our-group---packages-composer——两个目录并存,旧的不会自动失效。
- 换源后务必查
composer config --list | grep repositories,确认repositories.0.url是新地址 - 手动算出旧 URL 对应的缓存子目录名,进
$(composer config --global cache-dir)/repo/删除它 - Windows PowerShell 用户注意:
$(composer config --global cache-dir)返回带换行符的字符串,要用(composer config --global cache-dir).Trim()再拼接 - 别指望
composer update --no-cache能绕过这个——它跳过 dist 缓存,但 repo 元数据仍优先读本地缓存目录,除非你删了它
为什么 vendor 还是旧代码?三个缓存层必须全清
私有包更新后 vendor/ 没变,90% 是因为只清了一层缓存。Composer 在拉取私有包时走三道缓存:repo 元数据(决定有哪些版本)、dist ZIP 包(决定下载哪个压缩包)、VCS 克隆副本(决定从 Git 拉哪次 commit)。漏掉任何一层,都可能复用旧内容。
- repo 层:删
$(composer config --global cache-dir)/repo/https---your-private-repo.com - dist 层:删
$(composer config --global cache-dir)/files/{vendor}/{package}/{hash}/(hash 来自composer.lock里对应包的shasum字段) - VCS 层:删
$(composer config --global cache-vcs-dir)/vcs/下对应 Git 仓库(如果用了cache-vcs-dir)或默认$(composer config --global cache-dir)/vcs/ - 最后补一刀:
composer update --no-cache --prefer-dist -vvv,看日志里是否出现Downloading https://...和Extracting archive,而不是Using cached version
最常被忽略的是 repo 缓存路径的机械映射规则和 TMPDIR 的独立性——这两处不动手删,换再多源、配再细的 cache-dir,临时文件和旧代码都会阴魂不散。

















