php composer 基础使用

composer 使用

安装

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
mv 
mv composer.phar /usr/local/bin/composer
# 或者
wget https://getcomposer.org/download/1.8.6/composer.phar
mv composer.phar /usr/local/bin/composer

使用

• 更新composer版本

  # 更新版本
  composer self-update
  # 或者
  composer selfupdate
  

• 常用操作

  # 安装依赖
  composer install
  # 使用root用户执行
  compsoer require xxx/xx --no-plugins --no-scripts
  

  innstall 命令将会检查锁文件 composer.lock 是否存在，如果存在，它将下载指定的版本（忽略 composer.json 文件中的定义；如果不存在 composer.lock 文件，Composer 将读取 composer.json 并创建composer.lock文件）
  该命令会做两件事情，一是下载项目依赖包到 vendor 目录，二是创建 composer.lock 文件 (如果不存在)

• 添加依赖时尽量要约束版本，已防止版本升级导致的问题

  	# 添加依赖
      composer require [包名]
  	# composer require安装包的时候也会根据版本约束去更新其它包，版本约束的时候，版本尽量控制粒度小一些
  	
      # 安装指定版本的包
  	composer require xxx/xxx:1.1.1 
  
      # 添加依赖方式二
      # 手动更改添加 composer.json 文件的依赖项 require
      # 执行 composer update [packagistName] 命令进行安装
  
      # 更新依赖
      composer update [packagistName] [packagistName]
  
      # 删除依赖
      composer remove packagistName
  

• 版本约束
  空格与,视为逻辑AND, || 为逻辑 OR

  "require": {
      "vendor/package": "1.3.2", // 恰好是 1.3.2
  	"vendor/package": "1.3.2||1.3.3" // 1.3.2 或者 1.3.3
  	"vendor/package": ">=1.3.2 <=1.3.9" // 高于等于 1.3.2 且 小于等于 1.3.9
  	
      // >, <, >=, <= | 指定上/下边界
      "vendor/package": ">=1.3.2", // 任何高于或等于 to 1.3.2
      "vendor/package": "<1.3.2", // 任何低于 1.3.2
  
      // * | 通配符
      "vendor/package": "1.3.*", // >=1.3.0 <1.4.0
  
      // ~ | 允许指定最后一位数上升
      "vendor/package": "~1.3.2", // >=1.3.2 <1.4.0
      "vendor/package": "~1.3", // >=1.3.0 <2.0.0
  
      // ^ | 不允许破坏变化(主要版本固定- 跟随semver)
      "vendor/package": "^1.3.2", // >=1.3.2 <2.0.0
      "vendor/package": "^0.3.2", // >=0.3.2 <0.4.0 // 除非主要版本是0
  }
  

• 自动加载

  {
      "require": {
          "nesbot/carbon": "^1.39",
          "larapack/dd":"1.*",
  				 "ext-json": "*"
      },
      "autoload": {
          "psr-4": {
              "app\\": "app/"
          },
          "classmap": ["lib/"],
          "files": ["app/common/helpers.php"]
      },
      "config": {
          "sort-packages": true // 开启包名排序
      },
  }
  

  • psr-4 自动加载定义一个从命名空间到目录的映射
  • classmap 是指没有命名空间的类库进行自动加载
  • files 自动加载文件，一般用于公共函数文件
  • 自动加载时需要引入 vendor/autoload.php 文件
  • 当项目添加了没有命名空间的类库文件，要想实现自动加载，需要执行 composer dump-autoload 命令

• 更新classmap

  # 更新autoloader 以空间换实际，将库中的类文件名直接映射到autoloader文件中，在加载的时候可极大减少io操作
  composer dump-autoload -o
  

• 其它操作

  # 初始化创建composer.json
  composer init
  
  # 手动更新composer.json,然后更新
  # 该命令相当于删除comoser.lock 然后执行 composer intsall 不建议使用该命令。可能会对线上环境产生影响。
  composer update
  
  # 创建项目
  composer create-project xx
  
  # 创建指定版本的laravel 项目
  composer create-project laravel/laravel=6.* appName
  
  # 依赖性检测
  composer depends --link-type=require xx/xx
  
  # 查看包详细信息
  composer show xx/xx
  
  # 检测composer.json文件
  composer validate
  
  # 修改包来源(当前项目修改)
  composer config repo.packagist composer https://packagist.phpcomposer.com
  # 或者在当前项目中手动修改composer.json增加如下配置
  "repositories": {
      "packagist": {
          "type": "composer",
          "url": "<https://packagist.phpcomposer.com>"
      }
  }
  

修改为阿里镜像源

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

# 全局安装 自动加速下载包的速度
composer global require hirak/prestissimo

# 卸载
composer global remove hirak/prestissimo

基本使用流程

假设需要使用 overtrue/wechat 包做开发，以下是基本流程

1. 如果是新项目，未包含composer.json文件，则需要初始化composer.json，有两种方式
   • 使用 composer init生成composer.json文件，在require字段中写入需要的包，然后执行composr install

     	{
     	    "name": "xinu/test",
     	    "authors": [
     	        {
     	            "name": "xxx",
     	            "email": "xxxx"
     	        }
     	    ],
     	    "require": {
     		    "overtrue/wechat": "4.2.33"
     	    }
     	}
     

   • 使用composer require overtrue/wechat
2. 如果已经存在了composr.lock文件，安装新包只能通过 composer require xx/xx 实现，更新某个包可通过 composer update xx/xx 一定要携带包名，否则相当于删除composer.lock文件后，执行composer install 该行为可能会导致异常出现
3. 包更新后需要执行 composer dump-autoload -o 将报名映射到autoloader文件中，减少不必要的file_exist判断，可提高加载速度。