zoukankan      html  css  js  c++  java
  • composer.json 配置设置

    配置文件的值为 key:val 必须双引号包裹


    一、配置文件

    名字 name
    包名称由用户名名称和仓库名称组成
    包版本限制来请求Monolog软件包 1.0.*。这意味着1.0开发分支中的任何版本,或大于或等于1.0且小于1.1(>=1.0 <1.1)的任何版
    本。

    描述 description
    简短描述包装。通常这只是一行长。

    包的版本 version
    如果软件包存储库可以从某处推断版本,例如VCS存储库中的VCS标记名称,则可选。在这种情况下,建议省略它。

    类型 type
    建议省略此字段,并将其默认为library

    关键字 keywords
    这些可用于搜索和过滤,数组形式例如keywords: ["xunsearch", "search engine", "yii", "yii2"]

    主页 homepage
    项目网站的网址。

    时间 time
    版本发布日期,必须在YYYY-MM-DD或YYYY-MM-DD HH:MM:SS格式。

    许可证 license
    对于一个包,当许可证之间有一个选择(“分离许可”)时,可以将多个指定为数组。
    分离许可证示例:

    {
      "license": [
        "LGPL-2.1",
        "GPL-3.0+"
      ]
    }
    或者,它们可以用“或”分隔并括在括号中;

    {
      "license": "(LGPL-2.1 or GPL-3.0+)"
    }

    作者 authors
    每个作者对象可以具有以下属性:
    名称:作者姓名 通常他们的真名。 name 
    电子邮件:作者的电子邮件地址。 email
    主页:作者网站的网址。      homepage
    作用:作者在项目中的作用(如开发者或翻译者) role
    "authors": [
      {
        "name": "Nils Adermann",
        "email": "naderman@naderman.de",
        "homepage": "http://www.naderman.de",
        "role": "Developer"
      },
      {
        "name": "Jordi Boggiano",
        "email": "j.boggiano@seld.be",
        "homepage": "http://seld.be",
        "role": "Developer"
      }
    ]

    支持 support
    各种信息获得项目支持,支持信息包括以下内容:

    电子邮件:电子邮件地址支持。email
    问题:问题跟踪器的URL。 issues
    论坛:论坛的 URL。  forum:
    wiki:维基的 URL。 wiki
    irc: IRC通道支持,如irc:// server / channel。 irc:
    来源:浏览或下载源的 URL。 source
    docs:文档的 URL。  docs
    rss: RSS提要的URL。 rss
    一个例子:

    {
      "support": {
        "email": "support@example.org",
        "irc": "irc://irc.freenode.org/composer"
      }
    }

    建议 suggest
    "suggest": {
      "monolog/monolog": "Allows more advanced logging of the application flow",
      "ext-xml": "Needed to support XML format in class Foo"
    }

    archive 归档

    此命令用来对指定包的指定版本进行 zip/tar 归档。它也可以用来归档你的整个项目,不包括 excluded/ignored(排除/忽略)的文件。

    composer 命令:php composer.phar archive vendor/package 2.0.21 --format=zip

    exclude:允许配置排除路径的模式列表。模式语法匹配.gitignore文件。领先的感叹号(!)将导致任何匹配的文件被包括,即使 
    以前的模式排除它们。领先的斜杠只能在项目相对路径的开始处匹配。星号不会扩展到目录分隔符。

    设置创建包时的选项,exclude 属性可以设置排除哪些目录,例如:
    "archive": {
      "exclude": ["/foo/bar", "baz", "/*.test", "!/foo/bar/baz"]
    }

    bin文件
    一组应该被视为二进制文件并符号链接到bin-dir (从config)的文件。
    bin 文件相对于仓库包的目录地址
    "bin": [
        "util/xs"
      ]

    二、依赖管理
    软件包链接 require
    require告诉composer你的项目所依赖的包
    "require": {

      "php" : "^5.5 || ^7.0",

      "monolog/monolog": "1.0.*"

    }

    require需要将包名称(例如monolog/monolog)映射 到版本约束(例如 1.0.*)的对象。
    composer show --platform命令列出了系统上可用的所有PHP扩展
    限制PHP版本[ php 版本要求 ]

    "require": {
      "swiftmailer/swiftmailer": 5.3.*@dev,
      "phpoffice/phpexcel": "dev-master"
    }

    以swiftmailer为例,swiftmailer/swiftmailer 代表的是包名称,5.3.@dev , 是版本信息。合起来的意思就是说,我们将要开发的
    应用,依赖于swiftmailer的5.3.版本。其中:

    5.3.*表示,可以使用5.3.1版本,也可以使用5.3.2版本,composer在获取的时候,将寻找5.3版本下最新的版本。版本号支持一些更
    加宽泛的约束,比如>=1.0, >=1.0, <2.0,更加具体的信息可以查看:http://docs.phpcomposer.com/01-basic-usage.md#The-
    require-Key

    @dev表示可以获取开发版本。通常,开发版本意味非稳定版本,很可能存在bug。稳定性标签可以作用于特定的依赖项,也可以作用
    于全局。

    作用特定依赖项:默认情况下,composer只会获取稳定版本,如果这个例子我们不加@dev约束,而5.3.*版本都是开发版本,那么在
    获取的时候composer就会报错,指出改版本不符合要求。如果确定这个开发版本没有问题,那么就可以通过加@dev ,让Composer获
    取这个开发版本。

    全局稳定性设置:通过设置minimum-stability的值,来告诉Composer当前开发的项目的依赖要求的包的全局稳定性级别,它的值包
    括:dev、alpha、beta、RC、stable,stable是默认值。例如:"minimum-stability": "stable"

    require-dev

    有时候,我们会发现,有些包依赖只会在开发过程中使用,正式发布的程序不需要这些包,这个时候,就需要用到另外一个键,即
    require-dev。例如,我们想用codeception进行单元测试,那么就可以通过require-dev引入这个开发环境下的依赖包:

    "require-dev": {
      "codeception/codeception": "2.0.0 "
    }

    加了这个依赖后,再运行下命令看看效果。
    composer install

    三、自动加载
    自动加载lib目录下的OrderManager.php文件
    1.使用Files方式(ps:通常作为函数库的载入方式(而非类库))

    "autoload":{
      "files":["lib/OrderManager.php"]
    }

    files键对应的值是一个数组,数组元素是文件的路径,路径是相对于应用的根目录。加上上述内容后,运行命令:

    composer dump-autoload

    让composer重建自动加载的信息,完成之后,就可以在index.php里调用OrderManager类啦。

    2.Classmap方式自动加载

    通过文件引入的方法虽然直观,但是很费劲,每个文件都得引入一次,实在不是好的解决办法。有没有更好的办法呢?尝试将
    autoload的值改成:

    "autoload": {
      "classmap": ["src/", "lib/", "Something.php"]
    }
    再此运行composer dump-autoload,尝试调用,依然能够成功创建OrderManager类。其实,classmap通过建立类到文件的对应关系,
    当程序需要OrderManager类时,compoer的自动加载类通过查找OrderManager类所在的文件,然后再将改文件include进来。因此,这
    又导致了一个问题,那就是每加一个新类,就需要运行一次composer dump-autoload来创建类到文件到对应关系。

    从classmap中排除文件
    如果要从类映射中排除某些文件或文件夹,可以使用“from-classmap”属性,这些类将从类映射中跳过
    "autoload": {
      "exclude-from-classmap": ["/Tests/", "/test/", "/tests/"]
    }


    3. PSR0/4加载方式
    PSR-0,PSR-4,类文件都要求有个命名空间

    PSR-0则规定类名中的下划线_会被转化成目录分隔符
    namespace SilkLib;
    class OrderManager
    {
      public function test()
      {
        echo "hello";
      }
    }

    同时,文件夹的结构也要修改成:应用根目录libSilkLibOrderManager.php
    然后修改composer.json里的autoload部分如下:
    "autoload":{
      "psr-0":{
        "SilkLib":"lib/"
      }
    }
    这里需要注意的是,SlikLib是命名空间,lib是目录名,他们的组合告诉composer,文件搜索是在:lib/SilkLib/ 目录下,而不是
    在 SilkLib/lib 目录下,这一点要特别注意,有点绕,容易弄错。

    如果我们把命名空间改成 Sliklib, 相应的目录结构要改成:应用根目录libSilklibOrderManager.php,autoload部分的写法
    相应的也要改成:
    "autoload":{
      "psr-0":{
        "Monolog\": "src/",
        "Silk\lib":"lib/"
      }
    }

    如果您需要在多个目录中搜索相同的前缀,则可以将它们指定为数组:
    "autoload": {
      "psr-0": { "Monolog\": ["src/", "lib/"] }
    }

    注意Silklib是双斜杆。好了,那我们试试再加一个类,然后不用运行composer dump-autoload命令,看看新类是否能加载上。在
    lib目录下,新增一个ShipManager.php文件,内容如下:
    namespace Silklib;
    class ShipManager
    {
      public function test()
      {
        echo 'hello ship class';
      }
    }

    尝试在vendor 同级目录下的index.php文件中调用:
    $orderMgr = new SilklibOrderManager();
    $orderMgr->test();
    $shipMgr = new SilklibShipManager();
    $shipMgr->test();

    运行成功,说明使用psr-0规范进行自动加载,比classmap更加方便。

    可以直接指定到类级别。这对于在全局命名空间中只有一个类的库很有用,
    php源文件也位于包的根目录中,则可以如下声明:

    {
      "autoload": {
        "psr-0": { "UniqueGlobalClass": "" }
      }
    }
    如果您想要有一个可以使用命名空间的备用目录,则可以使用空的前缀,如:

    {
    "autoload": {
      "psr-0": { "": "src/" }
      }
    }

    在psr-4关键字下,您可以定义相对于包根的命名空间到路径的映射
    下面试试psr-4方式,整理下目录结构,改成:应用根目录libOrderManager.php,类文件修改命名空间为Silk[包根目录文件夹名/
    包里文件夹名称],
    修改autoload

    "autoload":{
      "psr-4":

      {
        "Silk\":"lib", // Silk 代表着--->项目类文件中的命令空间,将Silk 命名空间绑定到  /用户名/仓库名/lib 目录下
        // 文件夹路径:  

          vedor/

            用户名/

              仓库名称/

                composer.json

                lib/  

                  Classname.php  lib这文件夹下的类文件 ----> 类名要和类文件同名, 类文件的命名空间统一为  Silk

        "Monolog\": "src/",
      }
    }
    //调用是 先引入vendor/autoload.php
    使用命名空间:
    use Silk类名---->等同于  使用包里的 lib类文件---->类名

    再次运行composer dump-autoload

    如果您需要在多个目录中搜索相同的前缀,则可以将它们指定为数组:
    "autoload": {
      "psr-4": { "Monolog\": ["src/", "lib/"] }
     }
    如果您想要有一个可以在任何命名空间中查找的备用目录,您可以使用一个空的前缀,如:
    "autoload": {
      "psr-4": { ""exclude" }
    }

    ------------------------------------------------------------------------------------------------

    自己总结一些常用的,暂时总结这些……

    参考文档 https://docs.phpcomposer.com/04-schema.html  

        深入学习 Composer 自动加载(autoload)机制

        composer.json 中的各个属性字段详解

        composer 基本用法

     

  • 相关阅读:
    1-29反射
    1-28Map简介
    1-27TreeSet简介
    1-26HashSet简介
    1-25泛型
    1-24List三个子类的特点
    1-23集合概述
    Java接口
    1-22日期类型
    简易计算器的实现
  • 原文地址:https://www.cnblogs.com/xuey/p/7479529.html
Copyright © 2011-2022 走看看