应避免在低权限共享主机上执行 composer dump-autoload；正确做法是本地生成 autoload 文件后整体上传，并优先使用 --classmap-authoritative 方式生成静态 classmap 以绕过写入限制。
dump-autoload 失败：Permission denied 写入 vendor/composer/autoload_*.php
低权限共享主机上执行 composer dump-autoload 通常卡在生成 autoload 文件阶段，报错类似：file_put_contents(./vendor/composer/autoload_static.php): Failed to open stream: Permission denied。根本原因不是 Composer 本身，而是共享主机限制了对 vendor/ 目录的写权限（尤其 vendor/composer/ 子目录常被设为只读）。
实操建议：
- 别在生产环境直接跑
dump-autoload—— 它本就不该是部署时的操作；本地开发完成后再上传完整vendor/和生成好的 autoload 文件 - 若必须临时触发（比如改了
composer.json的autoload配置），先确认vendor/composer/是否可写：ls -ld vendor/composer；不可写则跳过生成静态文件，改用--classmap-authoritative+ 手动补 classmap - 用
composer dump-autoload --no-scripts --optimize可跳过 post-autoload-dump 脚本，减少权限依赖
opcache_reset() 不生效？检查用户级 opcache 配置隔离
共享主机常启用 opcache.enable_user_comments=1 或使用 opcache.validate_permission=1，导致调用 opcache_reset() 仅清空当前 PHP 进程（或当前用户）缓存，而 Web 请求走的是另一个 FPM pool 或 CGI 实例，重置无效。
实操建议：
- 确认 opcache 是否真由当前用户控制：
var_dump(opcache_get_status()['validation_timestamps_enabled']);返回false表示不校验文件时间戳，opcache_invalidate()也大概率被禁用 - 避免在脚本里硬写
opcache_reset()—— 共享主机通常禁用该函数，会报Call to undefined function opcache_reset() - 真正可靠的重载方式是：修改一个无关紧要的 PHP 文件（如
touch index.php），触发 opcache 的默认文件变更检测（前提是opcache.revalidate_freq > 0）
替代方案：用 classmap 替代 PSR-4 自动加载（绕过 autoload_static.php 写入）
PSR-4 加载需动态扫描目录生成映射，而 classmap 是静态数组，生成后无需运行时写入，适合只读 vendor/ 环境。
实操建议：
- 本地开发时就用
composer dump-autoload --classmap-authoritative --no-dev生成紧凑 classmap，并把vendor/composer/autoload_classmap.php一并上传 - 确保
composer.json中"autoload"段包含"classmap": ["src/"]显式路径，否则 classmap 可能漏掉自定义类 - 注意性能差异：classmap 加载更快，但新增类必须重新 dump，不能像 PSR-4 那样“即放即用”
为什么 vendor/ 下的 autoload 文件总被锁死？看 shared hosting 的 umask 和部署流程
很多共享主机用 FTP 或 cPanel 部署，上传后的文件继承服务器默认 umask 022，但 vendor/composer/ 目录常由 Composer 自己创建，其内部逻辑可能用 0755 创建目录、0644 写文件 —— 在某些 suPHP 或 php-fpm 用户隔离模式下，Web 进程用户 ≠ CLI 用户，导致写失败。
实操建议：
- 不要用
composer install --no-dev在线上跑；所有依赖和 autoload 文件应在本地生成完毕再整体上传 - 上传后手动检查权限：
find vendor/composer -type f -exec ls -l {} \;，若看到-rw-r--r--且属主不是当前 Web 用户，说明无法覆盖 - 极简 fallback：删掉
vendor/composer/autoload_static.php，保留autoload_classmap.php和autoload_files.php，Composer 会退化到兼容模式（稍慢但可运行）
真正麻烦的不是命令跑不跑得通，而是你以为 reload 了 autoload，其实 opcache 还在用旧的字节码，而 classmap 文件又没更新 —— 这种组合问题最难排查。
