应使用官方安装脚本而非 apt 安装 composer，卸载旧版后通过 curl 安装至 /usr/local/bin；权限问题主因是用户归属与 php cli 配置不一致，需 chown 目录并确保 path 包含 global vendor/bin。
Ubuntu 上直接用 apt 装的 Composer 版本太旧，别用
Ubuntu 官方源里的 composer 包通常卡在 2.0 甚至 1.x，不支持 PHP 8.2+ 的新特性，也缺少 composer create-project 等常用命令的最新行为。官方安装脚本才是唯一靠谱路径。
- 先卸载系统自带的：
sudo apt remove composer - 确保有
curl和php-cli：sudo apt install curl php-cli - 执行官方安装命令（一行）：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 验证：
composer --version应该输出类似Composer version 2.7.7
PHP 运行权限问题本质是用户组和 CLI 配置不一致
常见报错如 file_put_contents(/var/www/html/vendor/autoload.php): Failed to open stream: Permission denied，不是 Composer 权限不够，而是当前用户没权限写目标目录 —— 尤其当你用 sudo composer install 后，生成的文件属主变成 root，后续普通用户操作就崩了。
- 别用
sudo composer，除非你明确知道要改系统级配置 - 把项目目录归还给当前用户：
sudo chown -R $USER:$USER /var/www/html - 确认 PHP CLI 使用的配置和 Web 服务器一致：
php -i | grep "Loaded Configuration File"，对比phpinfo()里显示的路径 - 如果用 Apache + mod_php，Web 用户通常是
www-data；但 CLI 下你是自己的用户，两者文件权限必须隔离清楚
composer.json 里 config.platform.php 不是权限开关，是兼容性声明
很多人以为加了 "platform": {"php": "8.1.0"} 就能绕过本地 PHP 版本限制，其实它只影响依赖解析阶段 —— Composer 仍用你当前 CLI 的 PHP 执行安装，版本不匹配照样报错。
- 真实用途：告诉 Composer “假装”当前环境是 PHP 8.1，以便选到兼容的包版本（比如跳过要求 8.2+ 的 dev-main 分支）
- 它不会让 PHP 7.4 突然支持
match表达式 - 检查实际运行环境：
php -v和composer diagnose比任何配置都准 - 若开发机 PHP 版本低于项目要求，老老实实升级 PHP，别靠 platform 硬撑
全局 composer global 命令需要手动加进 PATH
composer global require laravel/installer 装的命令默认在 ~/.composer/vendor/bin/，不加进 $PATH 就提示 command not found —— 这不是权限问题，是 Shell 找不到可执行文件。
立即学习“PHP免费学习笔记（深入）”；
- 临时生效：
export PATH="$HOME/.composer/vendor/bin:$PATH" - 永久生效：把上面那行加进
~/.bashrc或~/.zshrc - 重载配置：
source ~/.bashrc - 验证：
which laravel应该返回/home/yourname/.composer/vendor/bin/laravel
Composer 的“权限”问题，90% 是路径归属和用户上下文混淆导致的，不是 chmod 能解决的。真正要盯住的是：谁在跑 PHP、谁拥有目录、PATH 有没有包含 vendor/bin。其他都是表象。
