PHP 8.5.5 已内置 Composer 必需扩展，安装前需确保 CLI 模式可用且版本为 8.5.5、openssl 扩展启用、PATH 配置正确，并推荐使用官方脚本安装 composer.phar，再配置国内镜像源与修复 vendor 权限。
PHP 8.5.5 已内置 openssl、json、phar 等 Composer 必需扩展，只要 CLI 模式可用，安装 Composer 就没有版本兼容障碍——直接装，别卡在“PHP 版本够不够”上。
确认 php 命令是否可用且是 8.5.5
Composer 依赖 PHP CLI，不是 Web 服务器里的 PHP。很多人装完 PHP 8.5.5 却在终端跑 php -v 报错，本质是没把 php 加进系统 PATH。
- 打开终端，执行
php -v，必须输出含8.5.5的版本行；如果提示“command not found”，说明 CLI 不在路径中 - Windows 用户常见路径：例如
C:\php或C:\xampp\php，需手动加到系统环境变量PATH并重启终端 - macOS/Linux 用户若用
brew install php@8.5，默认会软链/opt/homebrew/bin/php，但可能未被 shell 自动识别，可运行echo $PATH确认该路径存在 - 别用
which php后发现路径就以为万事大吉——要再执行一次php -m | grep openssl，确保openssl扩展已启用（Composer 安装包校验和下载都依赖它）
用官方脚本安装 composer.phar（推荐）
这是最可控的方式，不依赖系统包管理器，能明确拿到最新稳定版（目前是 v2.7.x），也方便后续升级或卸载。
- 执行下载与安装命令（一行写完，别拆）：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php && php -r "unlink('composer-setup.php');" - 生成的
composer.phar是单文件 PHAR，直接运行php composer.phar --version可验证是否生成成功 - Linux/macOS 移动并设为全局命令：
sudo mv composer.phar /usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer - Windows 用户不要硬套
mv，改用：move composer.phar C:\bin\composer.phar，然后确保C:\bin在PATH中；或者更简单——重命名为composer.exe（PHAR 文件加 .exe 后缀后 Windows CLI 能直接执行）
安装后必须配国内镜像源
默认源 packagist.org 在境外，PHP 8.5.5 下用原生 cURL 下载依赖时大概率超时或卡住，这不是 Composer 问题，是网络现实。
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可全局生效 - 验证是否写入：
composer config -g -l | grep url，应看到"url": "https://mirrors.aliyun.com/composer/" - 阿里云镜像偶尔维护，若报 503，可临时切中科大源：
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/ - 注意：镜像只加速
require和install，不影响composer.json格式校验或自动加载逻辑
ThinkPHP 或 Laravel 项目里 require 包失败？先看 vendor 目录权限
PHP 8.5.5 默认启用 opcache 和更严格的文件权限检查，composer require 写 vendor/ 时可能因目录不可写而静默失败（尤其 macOS 或 WSL2 下）。
立即学习“PHP免费学习笔记（深入）”；
- 进入项目根目录后，先运行
ls -ld vendor（macOS/Linux）或dir vendor（Windows），确认该目录存在且当前用户有写权限 - 若不存在，
composer install会自动创建；若存在但只读，执行chmod -R u+w vendor（Linux/macOS）或右键 → 属性 → 取消“只读”（Windows） - ThinkPHP 项目常见坑：
composer require topthink/think-captcha成功但页面报“Class not found”，往往是因为composer dump-autoload没触发，或config/app.php里漏了服务提供者注册——安装只是第一步，不是终点
composer 本身不挑 PHP 版本，但 PHP 8.5.5 的严格模式会让某些老旧包的 autoloader 报 Notice；真正卡住安装的，90% 是 CLI 环境没通、镜像没配、vendor 权限不对——先查这三项，比反复重装 Composer 有用得多。 
