Debian下Composer配置方法

Debian 下 Composer 配置方法

一 环境准备与安装

• 更新索引并安装依赖：sudo apt update && sudo apt install -y curl php-cli php-mbstring git unzip。这些依赖分别用于下载安装器、命令行执行 PHP、处理多字节字符串、拉取依赖包与解压归档。完成后可用 php -v 检查 PHP 是否可用。
• 下载并安装 Composer（推荐全局安装）：
  • 方式 A（官方安装脚本，含 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;”
    • sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
  • 方式 B（快捷方式）：curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer
• 验证：运行 composer --version，应输出版本号。以上步骤适用于 Debian 11/12 等常见版本。

二 全局配置与 PATH

• 全局配置目录与常用项：
  • 全局配置路径通常为 ~/.composer/config.json（项目级为项目根目录的 composer.json）。
  • 常用全局设置示例：
    • 缓存与存储路径：composer global config cache-dir /path/to/composer/cache；composer global config data-dir /path/to/composer/data（或设置 storage-path）。
    • 全局二进制目录：composer global config bin-dir /path/to/composer/bin（确保该目录已加入 PATH，以便全局安装的命令可直接使用）。
    • 运行与内存：composer global config process-timeout 1800；composer global config memory-limit 512M。
• 使全局 bin 生效：将全局 bin 目录加入 PATH。常见路径为 ~/.composer/vendor/bin 或 ~/.config/composer/vendor/bin。可写入 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）：
  • echo ‘export PATH=$PATH:~/.config/composer/vendor/bin’ >> ~/.bashrc && source ~/.bashrc
• 验证：执行 composer global show -p，应能看到全局包安装前缀与 bin 目录。

三 项目初始化与依赖管理

• 初始化项目：在项目目录执行 composer init，按提示填写名称、描述、作者、依赖等；也可直接回车使用默认值生成 composer.json。
• 添加依赖：
  • 生产依赖：composer require vendor/package
  • 开发依赖：composer require vendor/package --dev
• 安装与更新：
  • 有 composer.lock 时安装锁定版本：composer install
  • 按 composer.json 解析并更新：composer update；仅更新某个包：composer update package-name
  • 移除依赖：composer remove package-name
• 自动加载：在代码中引入 vendor/autoload.php，即可使用已安装依赖的自动加载机制。

四 常用维护与排错

• 自我升级：执行 composer self-update 将 Composer 升级到最新稳定版。
• 清理与优化：
  • 清理未使用依赖：composer prune
  • 优化自动加载：composer dump-autoload -o（生产环境常用）
• 运行脚本：在 composer.json 的 scripts 中定义任务，例如：
  • “scripts”: { “post-install-cmd”: [“@php artisan migrate”] }
  • 执行：composer run-script post-install-cmd
• 常见排错要点：
  • 命令未找到：检查 /usr/local/bin 是否在 PATH，或全局 bin 目录是否已加入 PATH。
  • 权限错误：避免使用 root 直接运行 Composer；必要时对 ~/.composer 目录设置合适权限。
  • 下载或校验失败：重新下载安装脚本并核对 SHA-384，或切换稳定网络重试。