Debian如何使用Composer进行包管理

在 Debian 上使用 Composer 进行 PHP 包管理

一 安装与准备

• 更新索引并安装依赖：需要 php-cli（命令行 PHP）、php-mbstring（多字节字符串支持）、git（拉取依赖）、unzip（解压包）、curl（下载安装器）。
  • 命令：sudo apt update && sudo apt install -y curl php-cli php-mbstring git unzip
• 下载并验证安装器（SHA-384），然后安装为全局命令：
  • 下载：curl -sS https://getcomposer.org/installer -o composer-setup.php
  • 取签名：HASH=$(curl -sS https://composer.github.io/installer.sig)
  • 校验：php -r "if (hash_file('SHA384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
  • 安装：php composer-setup.php
  • 全局可用：sudo mv composer.phar /usr/local/bin/composer
  • 验证：composer --version
• 说明：也可使用便捷写法 curl -sS https://getcomposer.org/installer | php 直接生成 composer.phar，再移动到 /usr/local/bin/composer；如需更新 Composer 本体可执行 composer self-update。

二 项目初始化与依赖管理

• 初始化项目并生成 composer.json：composer init（按交互填写项目信息与依赖）。
• 添加依赖（会自动更新或创建 composer.json 与 composer.lock）：
  • 添加生产依赖：composer require guzzlehttp/guzzle
  • 添加开发依赖：composer require --dev phpunit/phpunit
• 安装已有项目的依赖（依据 composer.lock 保证一致性）：composer install
• 更新依赖（遵循版本约束，更新 composer.lock）：
  • 全部：composer update
  • 指定包：composer update monolog/monolog
• 常用命令一览：
  • 搜索包：composer search monolog
  • 查看包依赖：composer depends monolog/monolog
  • 查看包提供者：composer providers monolog/monolog
  • 查看配置：composer config --list
  • 清理缓存：composer clear-cache
  • 生成/优化自动加载：composer dump-autoload 或生产环境 composer install --optimize-autoloader

三 自动加载与快速示例

• 在项目中引入 Composer 自动加载，然后使用依赖：
  • 创建测试文件：nano test.php
  • 示例代码：

    <?php
    require __DIR__ . '/vendor/autoload.php';
    use Cocur\Slugify\Slugify;
    $slugify = new Slugify();
    echo $slugify->slugify('Hello World, this is a long sentence!') . "\n";
    

  • 运行：php test.php（预期输出：hello-world-this-is-a-long-sentence）
• 说明：首次执行 composer require 后会生成 vendor/autoload.php 与 vendor/ 目录，后续直接 require 即可使用依赖。

四 全局工具与最佳实践

• 全局安装命令行工具（如 Laravel 安装器）：composer global require laravel/installer
  • 将全局二进制目录加入 PATH：通常为 ~/.composer/vendor/bin 或 ~/.config/composer/vendor/bin（写入 shell 配置文件如 ~/.bashrc 或 ~/.zshrc：export PATH="$HOME/.config/composer/vendor/bin:$PATH"）
• 生产与协作建议：
  • 提交并共享 composer.json 与 composer.lock，确保团队成员与部署环境安装完全一致版本。
  • 生产部署使用：composer install --no-dev --optimize-autoloader，跳过开发依赖并优化自动加载以提升性能。