如何使用Debian的Composer创建项目

在 Debian 上使用 Composer 创建项目的完整步骤

一 准备环境

• 更新索引并安装依赖：sudo apt update && sudo apt install -y curl php-cli php-mbstring git unzip
• 说明：Composer 需要 php-cli 来运行安装脚本与管理依赖，git 用于拉取包，unzip 用于解压，php-mbstring 为常用库提供多字节字符串支持。

二 安装 Composer

• 下载并验证安装脚本：
  • curl -sS https://getcomposer.org/installer -o composer-setup.php
  • 获取并校验 SHA-384：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
• 验证：composer --version（应输出版本号，如 2.x）。

三 创建项目的三种方式

• 方式 A 初始化空项目（推荐）

  • 进入项目目录：mkdir -p ~/myproj && cd ~/myproj
  • 交互初始化：composer init（按提示填写名称、描述、作者、依赖等，生成 composer.json）
  • 按需添加依赖：composer require monolog/monolog
  • 说明：初始化后可使用 require 添加依赖，Composer 会自动生成/更新 composer.json 与 composer.lock，并生成 vendor/autoload.php 用于自动加载。

• 方式 B 直接创建并安装依赖（适合已有模板或示例项目）

  • 一条命令创建并安装：composer create-project vendor/package project-dir（例如创建 Laravel：composer create-project --prefer-dist laravel/laravel my-laravel）
  • 说明：create-project 会拉取指定模板、安装依赖并生成完整目录结构，适合快速启动框架或脚手架项目。

• 方式 C 克隆已有仓库后安装依赖

  • git clone project-dir && cd project-dir
  • 安装锁文件中的精确版本：composer install
  • 说明：install 会优先依据 composer.lock 安装，确保团队成员与部署环境依赖一致。

四 常用命令与项目落地

• 常用命令
  • 安装/更新：composer install（按锁文件），composer update（按约束升级并刷新锁文件）
  • 新增/移除依赖：composer require vendor/package，composer remove vendor/package
  • 执行脚本：composer run-script post-install-cmd（需在 composer.json 的 scripts 中定义）
• 在代码中引入自动加载并测试
  • 在入口或任意 PHP 文件顶部加入：require DIR . ‘/vendor/autoload.php’;
  • 示例（使用上文安装的 monolog）：
    • 新建 index.php：
      • pushHandler(new StreamHandler('php://stderr', Logger::WARNING)); $log->warning('Hello from Composer on Debian');
    • 运行：php index.php（应看到日志输出）
• 版本约束与锁文件
  • 常见约束：^x.y（兼容更新）、~x.y.z（补丁更新）、1.2.*（通配小版本）。示例：composer require monolog/monolog:^2.0
  • composer.lock 用于锁定已安装的确切版本，团队协作与上线部署应以锁文件为准；需要升级时再运行 update。