如何使用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。

最新问答