应使用官方脚本安装 composer，因其提供最新稳定版（2.7.x）、支持 self-update、兼容 php 8.2+，而 apt 安装的版本过时且存在 autoloader 兼容性错误。
别用 sudo apt install composer —— 它装的是过时、不升级、PHP 8.2+ 下会报错的“假 Composer”。
为什么官方安装脚本才是唯一靠谱方式
Ubuntu 源里的 composer 包是 Debian 维护的静态快照，composer self-update 会失败或悄悄降级；更关键的是，它硬编码了旧版 autoloader 行为，在 PHP 8.2+ 中触发类似 Deprecated: Required parameter $x follows optional parameter $y 的错误——这不是你代码的问题，是包本身不兼容。
- 官方脚本生成的是独立
composer.phar，不依赖系统 PHP 扩展管理逻辑 - 版本明确（当前稳定版是 2.7.x），升级只需
composer self-update - 路径干净，默认不和
php-composer等旧包冲突
安装前必须确认的三件事
Composer 不是“下完就能跑”，它在安装和运行时都严格检查 PHP CLI 环境。缺一个扩展，composer install 直接报错退出。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
php-cli必须已安装：php -v能输出版本，否则先sudo apt install php-cli - 以下扩展必须启用：
mbstring、xml、zip、curl、json；检查命令：php -m | grep -E "mbstring|zip|curl|xml|json" - 若缺失，例如
zip：先看 PHP 版本php -v，再装对应包，如sudo apt install php8.2-zip（Ubuntu 24.04 默认是 php8.2）
安装命令与 PATH 配置陷阱
很多人装完 composer --version 成功，但 composer global require laravel/installer 后，laravel 命令却提示 command not found —— 问题不在 Composer，而在 shell 找不到全局 bin 目录。
- 推荐安装到用户目录，避免 sudo：
php composer-setup.php --install-dir=$HOME/bin --filename=composer - 然后把
$HOME/bin加进$PATH：在~/.bashrc或~/.zshrc末尾加一行export PATH="$HOME/bin:$PATH"，再source ~/.bashrc - 切记不要
sudo composer global require：它会把二进制装到/root/.composer/vendor/bin/，普通用户根本访问不到
验证是否真装对了
只看 composer --version 不够。得确认它不是 apt 包，且全局命令能真正调用。
- 执行
which composer，正确结果应为/home/yourname/bin/composer或/usr/local/bin/composer；若返回/usr/bin/composer，大概率是 apt 包，先sudo apt remove composer - 运行
composer global require laravel/installer，再执行which laravel，应输出类似/home/yourname/.composer/vendor/bin/laravel - 如果
which laravel为空，说明~/.composer/vendor/bin/没进PATH，补上：export PATH="$HOME/.composer/vendor/bin:$PATH"并写入 shell 配置文件
最常被忽略的点：PHP CLI 和 Web Server 用的可能是不同配置，php --ini 查 CLI 加载的 .ini 文件，确保里面没注释掉 extension=zip.so 这类行——不然 composer install 解压依赖时就直接崩。
