Composer 使用笔记

一、安装与配置

下载安装

Linux/macOS：

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Windows：
下载 Composer-Setup.exe 并运行，确保勾选 "Add to PATH" 选项。

验证安装

composer --version # 应输出版本号（如 Composer 2.7.6）

若失败，检查 PHP 环境（需启用 openssl 扩展）及系统 PATH 配置。

配置镜像源（国内用户）

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

或临时配置项目级镜像：

composer config repo.packagist composer https://mirrors.ustc.edu.cn/composer/

二、核心命令与场景

依赖管理

安装依赖：

composer install # 根据 composer.json 安装

更新依赖：

composer update # 更新到最新版本（遵守约束）

添加新依赖：

composer require monolog/monolog # 添加到 require 字段

移除依赖：

composer remove monolog/monolog

版本控制

锁定版本：

composer update --lock # 强制更新依赖关系

兼容性验证：

composer require --prefer-lowest # 测试最低版本兼容性

项目初始化

composer create-project laravel/laravel myproject # 创建新项目

或交互式初始化：

composer init # 回答问题生成 composer.json

三、高级技巧

自动加载（Autoloading）

生成自动加载文件：

composer dump-autoload # 生成 vendor/autoload.php

在 PHP 文件中引入：

require DIR . '/vendor/autoload.php';

脚本执行

composer run-script post-install-cmd # 执行自定义脚本

脚本路径需在 composer.json 中定义。

全局配置

查看全局配置路径：

composer config --global home # 输出全局 vendor 目录

添加全局依赖：

composer global require laravel/installer

需手动将 vendor/bin 加入系统 PATH。

四、常见问题

权限问题

Linux/macOS：确保 PHP 和 Composer 路径正确，避免 sudo 冲突。

Windows：以管理员身份运行安装器。

依赖冲突

使用 composer update --lock 强制更新依赖树。

镜像配置失败

检查网络代理或手动替换镜像地址（如阿里云、中科大源）。

五、资源推荐

官方文档：Composer 中文文档

常用镜像：

阿里云：https://mirrors.aliyun.com/composer/

中科大：https://mirrors.ustc.edu.cn/composer/

提示：Composer 是 PHP 项目的依赖管理工具，通过 composer.json 声明依赖，自动下载并处理版本冲突，提升开发效率。 （AI生成）