Ist die Entwicklung von Composer-Paketen so einfach?

Die folgende Kolumne stellt Ihnen die Composer-Generierungsumgebung aus der Kolumne Composer-Tutorial vor. Ich hoffe, dass sie für Freunde hilfreich ist, die sie benötigen!

Wofür wird Composer verwendet?

Studenten, die den Komponisten nicht kennen, werden auf jeden Fall diese Frage haben.

Dieses Wort wird häufig online gesehen, insbesondere auf GitHub. Wie wäre es mit der Verwendung von <span class="typ" style="font-size:14px;">Laravel</span>、 <span class="typ" style="font-size:14px;">Yii</span> 时也经常看到这个词，在安装的时候推荐使用 composer 安装？难道只是安装的时候使用吗？我也使用过其他框架，为什么 <span class="typ" style="font-size:14px;">Thinkphp</span>、 <span class="typ" style="font-size:14px;">Codeigniter</span> ohne Composer-Installation?

Mit diesen Fragen lernen wir.

Offizielle Website von Composer: https://www.phpcomposer.com

Composer ist ein Tool, das von PHP (5.3+) zum Verwalten von Abhängigkeiten verwendet wird.

Die Open-Source-Methode von PHP war lange Zeit auf Projektebene, was bedeutet, dass es sich, sobald es Open Source ist, um ein Projekt handelt, beispielsweise um einen vollständigen CMS-Satz (Dede, WordPress, Discuz) und einen kompletten Satz von Frameworks (Thinkphp, Codeigniter). Warum? Einer der sehr wichtigen Gründe ist, dass es schwierig ist, es zu zerlegen. Wenn Sie es zerlegen, gibt es kein wirksames Verwaltungstool, um es zu kombinieren, was dazu führt, dass sich niemand um die zerlegten kleinen Module kümmert.

Dann erschien Composer ein effektives Management-Tool. Es ist dafür verantwortlich, die kleinen Module, die jeder auseinander genommen hat, zu verwalten und sie dann effektiv in ein vollständiges Projekt zu integrieren.

Verwenden Sie beispielsweise monolog/monolog für die Protokollierung, verwenden Sie guzzlehttp/guzzle für den HTTP-Client usw.

Composer-Paketplattform: https://packagist.org, die eine große Anzahl hervorragender Installationspakete enthält. Mit nur einem Composer-Befehl können wir problemlos hervorragende Codes in unsere Projekte integrieren.

Als stolzer PHPer können wir nicht immer nur die Entwicklungspakete anderer Leute verwenden. Wir müssen selbst ein Paket entwickeln, damit andere es nutzen können.

Da wir nun wissen, dass es so viele Vorteile hat, lassen Sie uns mehr darüber erfahren, beginnend mit der Installation von Composer.

Wie installiere ich Composer?

Offizielles Einführungsdokument: https://docs.phpcomposer.com/00-intro.html

Mit der oben genannten Methode kann die Installation abgeschlossen werden.

Als nächstes verwenden wir GitHub in Kombination mit dem Composer-Tool, um ein Beispiel für die Entwicklung eines Composer-Pakets zu geben.

Wie wird das Composer-Paket entwickelt?

Entwickeln Sie beispielsweise ein Composer-Paket zur Verarbeitung von Zahlen.

Erstellen Sie ein Projekt auf GitHub

1. Melden Sie sich bei GitHub an (wenn Sie noch kein Konto haben, erstellen Sie bitte eines), klicken Sie auf das „+“ in der oberen rechten Ecke und wählen Sie „Neues Repository“.

2. Geben Sie in der Erstellungsoberfläche „numberFormat“ für den Repository-Namen ein, die Beschreibung ist optional, lassen Sie es vorerst leer und geben Sie dann „Öffentlich“ (von GitHub empfohlen, kostenlos, für jedermann zugänglich) und „Privat“ ein ( Bezahlt, nur bestimmte Personen haben Zugriff, kostenlos für einzelne Entwickler nach dem 09.01.2019) Wählen Sie „Öffentlich“, aktivieren Sie dann „Dieses Repository mit einer README-Datei initialisieren“, klicken Sie auf die Schaltfläche „Repository erstellen“ und die Erstellung ist erfolgreich.

Zu diesem Zeitpunkt bedeutet dies, dass auf GitHub ein leeres Projekt mit dem Namen „numberFormat“ erstellt wurde.

Als nächstes müssen Sie das Remote-Projekt zum Codieren auf die lokale (Git-Befehlszeile, Git-Client) klonen.

Lernen Sie, Composer.json zu erstellen

composer.json Was sind die Parameter und wie wird es geschrieben? Bitte lesen Sie das Dokument: https://docs.phpcomposer.com/04-schema.html#composer.json

Ein Projekt muss das Entwicklungspaket aufrufen. Sie können über Composer.json erfahren, wie die Datei geladen wird.

composer.json 可以使用两个方式创建，一种是 <span class="pln" style="font-size:14px;">composer init</span>，另一种是手工创建。

咱们一起先执行下 <span class="pln" style="font-size:14px;">composer init</span> 看看效果。

在本地创建numberFormat目录，然后 git clone 刚才创建的项目。

//进入到本地numberFormat目录	
composer init	
Welcome to the Composer config generator	
This command will guide you through creating your composer.json config.	
Package name (<vendor>/<name>) [root/number-format]:number-format/number-format	
Description []:一个处理数字的包	
Author [XinLiang <109760455@qq.com>, n to skip]:  //回车	
Minimum Stability []: //回车	
Package Type (e.g. library, project, metapackage, composer-plugin) []: //回车	
License []: //回车	
Define your dependencies.	
Would you like to define your dependencies (require) interactively [yes]?no	
Would you like to define your dev dependencies (require-dev) interactively [yes]?no	
{	
    "name": "number-format/number-format",	
    "description": "一个处理数字的包",	
    "authors": [	
        {	
            "name": "XinLiang",	
            "email": "109760455@qq.com"	
        }	
    ],	
    "require": {}	
}	
Do you confirm generation [yes]?  //回车

至此，本地numberFormat目录就看到 composer.json 文件了，当然可以直接在目录下按照这个格式进行手工创建，后期直接编辑该文件即可。

创建项目编码内容

开发包结构如下：

--src 源码目录（必须）

--tests 单元测试目录（非必须）

我们按照既定的目录结构去创建目录和文件，然后再到composer.json里面修改一下即可。

接下来，在src目录中创建一个类（NumberFormat.php）：

/**	
 * 数字格式化类	
 * @author XinLiang	
 */	
namespace numberFormat;	
class NumberFormat	
{	
    /**	
     * 格式化字节	
     * @param int $num       数字	
     * @param int $precision 精准度	
     * @return string	
     */	
    public static function byte_format($num = 0, $precision = 1)	
    {	
        if ($num >= 1000000000000)	
        {	
            $num = round($num / 1099511627776, $precision);	
            $unit = 'TB';	
        }	
        elseif ($num >= 1000000000)	
        {	
            $num = round($num / 1073741824, $precision);	
            $unit = 'GB';	
        }	
        elseif ($num >= 1000000)	
        {	
            $num = round($num / 1048576, $precision);	
            $unit = 'MB';	
        }	
        elseif ($num >= 1000)	
        {	
            $num = round($num / 1024, $precision);	
            $unit = 'KB';	
        }	
        else	
        {	
            return number_format($num).' Bytes';	
        }	
        return number_format($num, $precision).' '.$unit;	
    }	
}

修改 composer.json

{	
    "name": "number-format/number-format",	
    "description": "一个处理数字的包",	
    "authors": [	
        {	
            "name": "XinLiang",	
            "email": "109760455@qq.com"	
        }	
    ],	
    "minimum-stability": "dev",	
    "require": {	
        "php": ">=5.3.0"	
    },	
    "autoload": {	
        "psr-4": {	
            "numberFormat\\": "src/"	
        }	
    },	
    "license": "MIT"	
}

至此，我们的开发包已经完成，接下来我们来测试下这个包是否可用。

测试开发包

在本地numberFormat目录下，通过 <span class="pln" style="font-size:14px;">composer install</span> 安装

composer install	
Loading composer repositories with package information	
Updating dependencies (including require-dev)	
Nothing to install or update	
Writing lock file	
Generating autoload files	
//表示安装成功

惊奇的发现，在本地numberFormat目录多一个 <span class="pln" style="font-size:14px;">vendor</span>目录。

在tests目录创建 NumberFormatTest.php

/**	
 * 数字格式化测试类	
 * @author XinLiang	
 */	
require '../vendor/autoload.php';	
use \numberFormat;	
$number = '102400010';	
echo numberFormat\NumberFormat::byte_format($number);	
//输出：97.7 MB

至此，测试成功，接下来就是要发布到packagist平台，给广大开发者见面了。

发布到 packagist 平台

packagist.org 为 composer 安装包的平台（可用GitHub账号登录）。

1. 现将本地代码提交到GitHub。

2. 发布到 packagist 平台，登录后在首页的右上角有一个"Submit"按钮，点击即可进入开发包提交的界面。在“Repository URL (Git/Svn/Hg)”输入框中，输入GitHub项目的地址，点击“Check”按钮，稍微等待几秒钟，会显示验证成功，并显示出“Submit”按钮，点击即完成了开发包的提交了。

恭喜你，这个开发包可以在任何支持 composer 的PHP框架中使用了。

那么问题来了，刚才我们的包写的有的简陋，后期我们维护代码，新增代码还需要按照原来的方式操作一遍吗？

不！因为我们可以在GitHub平台设置代码更新，同时能让 packagist.org 自动更新，是不是很酷！

在GitHub中找到代码仓库，然后选择"settings" -> “Webhooks” ，默认是绑定自动更新的。

如果未绑定，可以这样设置："settings" -> “Webhooks” -> "Add webhook" ->

1. Payload URL填写：“https://packagist.org/api/github”

2. Content type填写：“application/json”

3. Secret填写：“packagist提供的token”

4. 其他的默认即可

5. 点击“Add webhook” 完成。

至此，后期我们更新代码后会自动同步到 packagist.org 上。

//其他开发者可以这样获取包	
composer require number-format/number-format:dev-master

为什么会有:dev-master，为什么引用其他的包不用这样设置？

因为我们引用的其他包都是稳定包，默认为：-stable。

是因为我们 composer.json 中设置了 minimum-stability 属性，这个可以了解下“版本约束”，在这就不多说了。

当我们在发布包后，如果获取不到报错怎么办，有可能是镜像的问题。

composer 设置镜像地址

//查看全局设置	
composer config -gl	
//第一种：设置国内镜像	
composer config -g repo.packagist composer https://packagist.phpcomposer.com	
//第二种：设置国内镜像	
composer config -g repo.packagist composer https://packagist.laravel-china.org	
//第三种：设置国内镜像	
composer config -g repos.packagist composer https://php.cnpkg.org

小结

通过这篇文章，解决了上述提到的三个问题：

1. composer 是用来干嘛的？

2. composer 是如何安装的？

3. composer 包是如何开发的？

看完后，是不是觉得 Composer 包开发原来这么简单，作为骄傲的程序员，去开发属于自己的 Composer 包吧！

Das obige ist der detaillierte Inhalt vonIst die Entwicklung von Composer-Paketen so einfach?. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!