PHP版本需≥8.0且必须启用openssl、zlib、json、mbstring扩展；Composer需正确配置PATH、镜像源及权限，验证以composer --version为准。
PHP 版本和扩展必须匹配，否则 composer 命令直接失败
不是“装上就能跑”，composer 启动第一秒就依赖 PHP CLI 环境。运行 php -v 必须输出 ≥ 8.0 的版本（Composer 2.5+ 强制要求），低于此版本会报 ParseError 或直接退出。
四个扩展缺一不可：openssl、zlib、json、mbstring。Windows 用户常卡在 Could not open input file: composer.phar，其实是 php_openssl.dll 没启用——打开 php.ini，删掉 ;extension=php_openssl.dll 前面的分号，重启终端再试。
-
php -m | grep -i openssl（Linux/macOS）或php -m（Windows）确认模块已加载 - 宝塔用户注意：别用系统自带 PHP，要用
/www/server/php/82/bin/php这类路径下的二进制 - Mac/Linux 上若用 Homebrew 安装 PHP，需额外执行
brew install php@8.2并确保which php指向新版
PATH 配置不到位，composer 命令就永远找不到
装完 composer.phar 不等于能全局运行。Linux/macOS 必须手动移到可执行路径并加权限：sudo mv composer.phar /usr/local/bin/composer，再 sudo chmod +x /usr/local/bin/composer。如果 echo $PATH 里没有 /usr/local/bin，还得在 ~/.zshrc 或 ~/.bash_profile 里补上 export PATH="/usr/local/bin:$PATH"。
Windows 用户别信安装器“Add to PATH”勾选框万无一失——杀毒软件（尤其 360、腾讯电脑管家）会拦截写入；手动进「系统属性 → 高级 → 环境变量」，把 C:\ProgramData\ComposerSetup\bin 加到系统 PATH，改完新开 CMD 验证。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 验证方式只有一种：
composer --version有输出才算成功 - 别在旧终端窗口反复
source，PATH 变更后必须新开终端 - 云服务器上若用
sudo su -切换用户，PATH 可能重置，得用对应用户身份重配
国内网络不配镜像，composer install 就是无限卡在 “Loading composer repositories…”
默认源 https://packagist.org 在国内多数环境不可达，不是你网速慢，是 DNS 污染 + TLS 握手超时 + 中间代理截断响应导致的。卡住时加 -vvv 参数，大概率停在 Downloading https://packagist.org/packages.json。
全局镜像一劳永逸：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。验证是否生效：composer config -g repo.packagist 应返回该 URL。
- 宝塔面板用户注意：
/root/.composer/config.json是 root 用户配置，站点用户执行composer时读不到，得用该用户身份再跑一遍config -g - 项目已有
composer.lock文件时，别删它重来；install是按 lock 精确还原，update才重新解析依赖树 - 临时换源调试可用：
composer install --repository-url=https://mirrors.huaweicloud.com/repository/php/
composer.json 里写错版本格式，composer update 就会报 “Could not parse version constraint”
常见错误是中文标点、空格、非法符号。比如 "monolog/monolog": "^2,8"（中文逗号）、"^2.8.0 "（末尾空格）、"^2.8" 写成 "^2.8.*"（多余通配符）都会触发解析失败。
platform 配置不是摆设："config": {"platform": {"php": "8.2.10"}} 会让 Composer 强制按该版本选包。本地 PHP 实际是 8.1，却写成 8.2，某些包根本装不上。
- 用
composer validate快速检查 JSON 结构和版本语法 - 自定义仓库（
repositories）中type字段必须是vcs或package，不能拼成git - 调试时可临时绕过平台限制：
composer update --ignore-platform-reqs，但上线前必须删掉
composer，可能因全局镜像配置未覆盖、PHP 版本路径不一致、vendor 目录属主权限不对（比如 www-data 写不了）而行为不一致。别假设“装一次，处处可用”。 
