必须手动安装composer，因apt安装的是过时阉割版（如2.0.14），不支持php 8.3、--interactive等新特性，且存在权限、兼容性及安全风险；应通过官方脚本+sha384校验安装。
必须手动安装，不能用 apt install composer —— 否则装出来的是 2.0.x 或更老的阉割版，不支持 PHP 8.3、composer require --interactive，升级失败率高，还容易和项目级 composer.phar 冲突。
为什么 apt install composer 会出问题
Ubuntu 22.04 官方源里的 composer 包固定为 2.0.14（部分镜像甚至回落到 1.x），而 Composer 官方当前稳定版已是 2.7.x。关键差异包括：
-
composer self-update直接报Cannot update, permission denied，因为包管理器把文件装在/usr/share/php/composer/下，普通用户无写权限 - 缺失 PHP 8.3 兼容层，运行
composer install可能触发Fatal error: Uncaught Error: Call to undefined function mb_str_split() - 依赖解析逻辑不同，同样
composer.json在官方版能装，在 apt 版可能卡在Package operations: 0 installs, 0 updates, 0 removals却不报错 - 不校验插件签名，启用第三方插件时静默跳过验证，存在供应链风险
下载前先确认 PHP 环境是否达标
Composer 2.7+ 要求 PHP ≥ 7.2.5 且开启 allow_url_fopen 和 zlib 扩展。执行以下检查：
- 运行
php -v，确保输出版本 ≥7.2.5（推荐 8.1+） - 运行
php -i | grep -E 'allow_url_fopen|zlib'，确认两行都显示=> On - 若缺
unzip（某些最小化安装 Ubuntu 没预装），补上：sudo apt install unzip
用官方脚本安装并校验 SHA384
这是唯一被 Composer 官网认证的方式，生成可执行的独立 composer.phar，与系统 PHP 解耦：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进入临时目录：
cd /tmp - 下载安装脚本：
curl -sS https://getcomposer.org/installer -o composer-setup.php - 获取最新校验值：
HASH=$(curl -sS https://composer.github.io/installer.sig) - 校验脚本完整性：
php -r "if (hash_file('sha384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" - 安装到全局路径：
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 清理临时文件：
rm composer-setup.php
验证是否成功：composer --version 应输出类似 Composer version 2.7.7。
PATH 和权限常见失效场景
即使 sudo mv 进了 /usr/local/bin，仍可能提示 command not found，原因通常是：
-
which composer返回空，说明 shell 没读到该路径：检查echo $PATH是否含/usr/local/bin；不含就追加：echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc（zsh 用户改~/.zshrc） - 用
sudo安装但没加-E，导致 root 环境的$PATH不含/usr/local/bin：应避免sudo composer，直接用普通用户调用 - 服务器禁用了
exec权限（如某些共享主机）：此时只能局部使用，把composer.phar放进项目根目录，用php composer.phar install替代
真正麻烦的不是安装步骤，而是校验哈希这一步常被跳过——一旦中间人篡改了安装脚本，后续所有依赖下载都可能被注入恶意包。别图快，那三行校验代码值得多敲一次。
