如何解决 composer create-project 时遇到的权限问题？ (目录所有权)

直接改目录所有权就能解决，因为composer create-project需对目标目录有写和执行权限，若目录由root等其他用户创建，当前用户无权写入，导致file_put_contents、mkdir等操作失败。

直接改目录所有权就能解决，composer create-project 报权限错误，90% 是因为目标目录由 root 或其他用户创建，当前用户没写入权限。

为什么 composer create-project 会因所有权失败？

Composer 在解压和写入 vendor、autoload.php 等文件时，需要对目标目录有 write 和 execute 权限。如果该目录是 sudo composer create-project 创建的，或由 root / www-data 用户生成（比如在 docker 容器里），当前普通用户就无法覆盖或新建文件。

典型报错包括：

• file_put_contents(./composer.json): failed to open stream: Permission denied
• Could not delete /path/to/project/vendor/composer/...
• mkdir(): Permission denied（出现在安装依赖阶段）

快速修复：用 chown 改回当前用户

确认当前用户名（通常用 whoami），然后递归修改目录归属：

chown -R $USER:$USER /path/to/your/project

如果项目已半途失败，先删掉不完整的目录再重试：

rm -rf /path/to/your/project composer create-project laravel/laravel /path/to/your/project

注意：不要用 sudo composer create-project——这会让所有生成文件属主变成 root，后续每次 composer install 或 php artisan 都可能卡住。

预防措施：避免权限问题从源头发生

以下操作能一劳永逸减少这类问题：

• 始终在你有完全控制权的家目录下运行 composer create-project，例如 ~/projects/myapp
• 如果必须放在 /var/www 等系统路径，提前建好空目录并授权：

  sudo mkdir -p /var/www/myapp sudo chown $USER:www-data /var/www/myapp sudo chmod 775 /var/www/myapp

• Docker 环境中，在 Dockerfile 或 docker-compose.yml 里指定非 root 用户运行 Composer，例如：

  user: "${UID:-1001}:${GID:-1001}"

最常被忽略的一点：有些 ide（如 phpstorm）默认以 root 启动终端，或通过 sudo snap run phpstorm 打开，导致所有命令实际以 root 身份执行。检查终端里的 id 输出，确认 UID 是你预期的那个数字。