Informationen zu den Konfigurationseinstellungen von Composer.json

Das Folgende ist eine Tutorial-Kolumne über Composer.json von composer Konfigurationseinstellungen, ich hoffe, es wird Freunden helfen, die es brauchen!

p>

Der Wert der Konfigurationsdatei ist key:val und muss in doppelte Anführungszeichen gesetzt werden

1 . Konfigurationsdatei

span>

Name
Der Paketname besteht aus dem Benutzernamen und dem Warehouse-Namen
Paketversionseinschränkungen Zum Anfordern von Monolog-Paketen 1.0.*. Dies bedeutet jede Version im 1.0-Entwicklungszweig oder jede Version größer oder gleich 1.0 und kleiner als 1.1 (>=1.0 <1.1)

Beschreibung Beschreibung
Eine kurze Beschreibung des Pakets. Normalerweise ist dieser nur eine Zeile lang.

Version der Paketversion
Optional, wenn das Paket-Repository die Version irgendwoher ableiten kann, beispielsweise aus dem VCS-Tag-Namen im VCS-Repository. In diesem Fall empfiehlt es sich, darauf zu verzichten.

type
Es wird empfohlen, dieses Feld wegzulassen und es standardmäßig auf die Bibliothek zu setzen

SchlüsselwörterSchlüsselwörter
Diese können zum Suchen und Filtern in Array-Form verwendet werden, z. B. Schlüsselwörter: ["xunsearch", "search engine", "yii", "yii2"] p>

Homepage
Die URL der Projektwebsite.

Uhrzeit
Versionsveröffentlichungsdatum, muss im Format JJJJ-MM-TT oder JJJJ-MM-TT HH:MM:SS angegeben werden .

Lizenz
Wenn für ein Paket eine Auswahl zwischen Lizenzen besteht („separate Lizenz“), können Sie mehrere als angeben Array.
Beispiel für separate Lizenzen:

{
    　　"license": [
       　　　　"LGPL-2.1",
       　　　　"GPL-3.0+"
    　　]
}

Alternativ können sie durch „oder“ getrennt und in Klammern eingeschlossen werden;

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

Autoren Autoren

每个作者对象可以具有以下属性：
名称：作者姓名 通常他们的真名。 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"
        　　}
    ]

Supportunterstützung
Verschiedene Informationen, um Projektunterstützung zu erhalten, einschließlich Supportinformationen Folgendes:

E-Mail: E-Mail-Adresse des Supports. E-Mail
Problem: Die URL des Problem-Trackers. Probleme
Forum: URL des Forums. Forum:
wiki: URL des Wikis. Wiki
irc: Unterstützung für IRC-Kanäle, z. B. irc://server/channel. irc:
Quelle: URL zum Durchsuchen oder Herunterladen der Quelle. Quelle
docs: URL des Dokuments. docs
rss: Die URL des RSS-Feeds. rss
Ein Beispiel:

{
    　　"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 archive

this The Der Befehl wird zum Zip/Tar-Archivieren der angegebenen Version des angegebenen Pakets verwendet. Es kann auch zum Archivieren Ihres gesamten Projekts verwendet werden, mit Ausnahme ausgeschlossener/ignorierter Dateien.

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

exclude: Ermöglicht die Konfiguration einer Liste von Mustern zum Ausschließen von Pfaden. Die Mustersyntax entspricht .gitignore-Dateien. Ein vorangestelltes Ausrufezeichen (!) führt dazu, dass alle passenden Dateien eingeschlossen werden, auch wenn
das vorherige Muster sie ausgeschlossen hat. Führende Schrägstriche können nur am Anfang projektbezogener Pfade abgeglichen werden. Sternchen werden nicht zu Verzeichnistrennzeichen erweitert.

Legen Sie beim Erstellen eines Pakets Optionen fest. Mit dem Exclude-Attribut können Sie festlegen, welche Verzeichnisse ausgeschlossen werden sollen, zum Beispiel:

"archive": {
　　"exclude": ["/foo/bar", "baz", "/*.test", "!/foo/bar/baz"]
}

bin file< /span>
Eine Reihe von Dateien, die als Binärdateien behandelt und mit dem Bin-Verzeichnis (aus der Konfiguration) verknüpft werden sollten.
Die Verzeichnisadresse der bin-Datei relativ zum Warehouse-Paket
"bin": [
　"util/xs"
　]

2. Abhängigkeitsverwaltung
Softwarepaket-Link erforderlich
require teilt Composer-Paketen mit, von denen Ihr Projekt abhängt

"require": {
　　"php" : "^5.5 || ^7.0",
　　"monolog/monolog": "1.0.*"
}

require ein Objekt, das Paketnamen (z. B. Monolog/Monolog) Versionsbeschränkungen (z. B. 1.0.*) zuordnet.
Der Composer-Befehl show --platform listet alle auf dem System verfügbaren PHP-Erweiterungen auf.
PHP-Version einschränken [PHP-Versionsanforderungen]

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

Nehmen Sie Swiftmailer als Beispiel, Swiftmailer/Swiftmailer repräsentiert das Paket The Name, 5.3.@dev, ist die Versionsinformation. Zusammengenommen bedeutet dies, dass die
Anwendung, die wir entwickeln werden, von Version 5.3 von Swiftmailer abhängt. Darunter:

5.3.* bedeutet, dass Sie Version 5.3.1 oder Version 5.3.2 verwenden können. Beim Abrufen sucht Composer nach der neuesten Version unter Version 5.3. Die Versionsnummer unterstützt einige umfassendere Einschränkungen, wie z. B. >=1.0, >=1.0, <2.0. Weitere spezifische Informationen finden Sie unter: http://docs.phpcomposer.com/01-basic-usage.md#. Der-
require-Key

@dev gibt an, dass die Entwicklungsversion abgerufen werden kann. Normalerweise bedeutet eine Entwicklungsversion eine instabile Version und enthält wahrscheinlich Fehler. Stabilitäts-Tags können für bestimmte Abhängigkeiten oder global gelten.

作用特定依赖项：默认情况下，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";
    　　}
 }

同时，文件夹的结构也要修改成：应用根目录\lib\SilkLib\OrderManager.php
然后修改composer.json里的autoload部分如下：

"autoload":{
    　　"psr-0":{
        　　　　"SilkLib":"lib/"
    　　}
}

这里需要注意的是，SlikLib是命名空间，lib是目录名，他们的组合告诉composer，文件搜索是在：lib/SilkLib/ 目录下，而不是
在 SilkLib/lib 目录下，这一点要特别注意，有点绕，容易弄错。

如果我们把命名空间改成 Slik\lib, 相应的目录结构要改成：应用根目录\lib\Silk\lib\OrderManager.php，autoload部分的写法
相应的也要改成：

"autoload":{
    　　"psr-0":{
　　　　"Monolog\\": "src/",
        　　　　"Silk\\lib":"lib/"
    　　}
}

如果您需要在多个目录中搜索相同的前缀，则可以将它们指定为数组：

   "autoload": {
        　　"psr-0": { "Monolog\\": ["src/", "lib/"] }
    }

注意Silk\lib是双斜杆。好了，那我们试试再加一个类，然后不用运行composer dump-autoload命令，看看新类是否能加载上。在
lib目录下，新增一个ShipManager.php文件，内容如下：

namespace Silk\lib;
class ShipManager
{
    　　public function test()
    　　{
        　　　　echo 'hello ship class';
    　　}
}

尝试在vendor 同级目录下的index.php文件中调用：

$orderMgr = new Silk\lib\OrderManager();
$orderMgr->test();
$shipMgr = new Silk\lib\ShipManager();
$shipMgr->test();

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

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

{
    　　"autoload": {
        　　　　"psr-0": { "UniqueGlobalClass": "" }
    　　}
}

如果您想要有一个可以使用命名空间的备用目录，则可以使用空的前缀，如：

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

在psr-4关键字下，您可以定义相对于包根的命名空间到路径的映射

下面试试psr-4方式，整理下目录结构，改成：应用根目录\lib\OrderManager.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" }
  }

Das obige ist der detaillierte Inhalt vonInformationen zu den Konfigurationseinstellungen von Composer.json. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!