在 Ubuntu 上使用 Composer 创建新项目
一 准备环境
- 更新索引并安装依赖:sudo apt update && sudo apt install -y php-cli php-mbstring git unzip curl
- 验证 PHP:php -v(建议 PHP ≥ 7.2)
- 安装 Composer(官方脚本,全局可用):
- curl -sS https://getcomposer.org/installer | php
- sudo mv composer.phar /usr/local/bin/composer
- composer --version
- 可选:使用系统包管理器安装 sudo apt install -y composer(版本可能较旧)
二 创建项目的三种常用方式
- 方式一 初始化空项目(交互生成 composer.json)
- mkdir my-project && cd my-project
- composer init(按提示填写项目信息)
- 添加依赖:composer require monolog/monolog
- 安装全部依赖:composer install
- 方式二 直接创建并安装依赖(一步到位)
- 示例:composer require nesbot/carbon(会自动创建 composer.json 并安装依赖)
- 方式三 使用框架/脚手架模板(以 Laravel 为例)
- 全局安装 Laravel 安装器:composer global require laravel/installer
- 创建项目:laravel new my-laravel(或:composer create-project laravel/laravel my-laravel)
- 小提示
- 初次安装依赖后会生成 vendor/、composer.json、composer.lock
- 提交代码时建议纳入 composer.json 与 composer.lock,确保环境一致
三 入口文件与自动加载
- 在入口文件(如 index.php)顶部引入自动加载:
- require DIR . ‘/vendor/autoload.php’;
- 示例(使用 Carbon 打印当前时间):
四 常用命令与优化
- 依赖管理
- 安装全部:composer install
- 更新全部:composer update
- 更新指定包:composer update vendor/package
- 移除包:composer remove vendor/package
- 查看已安装:composer show
- 配置与维护
- 中国镜像加速:composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
- 升级 Composer:composer self-update
- 协作规范
- 将 composer.lock 纳入版本控制,锁定依赖版本,避免“在我机器上能跑”