Composer安装失败因PHP未启用HTTPS支持，需检查php.ini中openssl扩展、DLL文件或macOS的OpenSSL链接；require不生效多因不在项目根目录或composer.json损坏；autoload失效需确保PSR-4路径与命名空间严格匹配并执行composer dump-autoload。
Composer 安装失败：curl 或 openssl 报错怎么办
Windows 或 macOS 上执行 php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" 后，运行 php composer-setup.php 报 cURL error 60 或 SSL certificate problem，本质是 PHP 没启用或配置好 HTTPS 支持。
- 先确认
extension=openssl在php.ini中已取消注释（不是php --ini显示的 CLI 配置路径？用php -i | grep "Loaded Configuration File"确认） - Windows 用户常见问题是 OpenSSL DLL 缺失，需确保
php_openssl.dll存在且extension_dir路径正确；macOS 用 Homebrew 安装的 PHP，常需手动链接：brew link openssl@3并在php.ini中加openssl.cafile=/opt/homebrew/etc/openssl@3/cert.pem - 临时绕过（仅开发环境）：改用 HTTP 安装脚本（不推荐长期用），或下载官方 PHAR 手动校验：
php -r "echo hash_file('sha384', 'composer-setup.php');"对比官网提供的哈希值
require 命令不生效：vendor 目录空或 autoload.php 找不到
执行 composer require monolog/monolog 后，vendor/ 下没生成包，或 require 'vendor/autoload.php'; 报错，多数是当前目录不是 Composer 项目根目录，或 composer.json 损坏。
- 检查是否在项目根目录下操作 —— 运行
composer status，若提示No composer.json in current directory，说明不在正确位置 - 别手动创建
composer.json，用composer init交互生成，它会自动写入autoload字段和基础结构 - 如果已有
composer.json但vendor/为空，先删掉vendor/和composer.lock，再跑composer install（不是require）——require是“添加新依赖并更新 lock”，install是“按 lock 文件重建 vendor”
autoload 自定义命名空间不生效：new MyClass() 提示 Class not found
你在 composer.json 里写了 "autoload": { "psr-4": { "App": "src/" } }，但 src/Http/Request.php 中的 class Request 仍无法通过 new AppHttpRequest 实例化，问题出在 PSR-4 规则与文件结构不匹配。
- PSR-4 要求命名空间前缀（如
App\）必须严格对应目录名（src/），且子命名空间HttpRequest必须落在src/Http/Request.php，且该文件内必须声明namespace AppHttp; - 改完
composer.json后，必须运行composer dump-autoload（简称composer du）刷新自动加载映射，否则修改不生效 - 调试技巧：用
composer show --platform看 PHP 扩展状态，用composer dump-autoload -v查看实际生成了哪些映射路径
生产环境部署时 vendor/autoload.php 被忽略或报错
本地跑得好好的，上线后 require 'vendor/autoload.php'; 报 failed to open stream，或者类能加载但某些扩展功能异常（比如 cURL 超时、JSON 不支持大整数），根本原因是生产环境 PHP 版本、扩展或 ini 设置和本地不一致。
立即学习“PHP免费学习笔记（深入）”；
- 别直接 rsync 整个
vendor/上线 —— 用composer install --no-dev --optimize-autoloader在服务器上重建，确保只装 production 依赖，且 autoloader 更快 - 检查
composer.json的"config": { "platform": { "php": "8.1.2" } }是否锁定了与服务器匹配的 PHP 版本，避免因版本差异导致某些包降级或跳过安装 - 关键陷阱：某些共享主机禁用
proc_open，会导致composer install卡住或失败；此时加--no-scripts跳过 post-install-cmd，并手动处理资源发布逻辑
Composer 不是黑盒，它的行为高度依赖 PHP 环境、文件权限、网络策略和 JSON 结构准确性。任何一步跳过验证（比如不确认 php.ini 路径、不核对 composer.json 缩进格式、不检查 vendor/ 目录所有权），都可能让后续所有操作失效。
