开发工具:用Composer管理相依性

Posted php中文网最新课程

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了开发工具:用Composer管理相依性相关的知识,希望对你有一定的参考价值。

php中文网最新课程

每日17点准时技术干货分享

开发工具:用Composer管理相依性

composer原本是Symfony这个PHP Framework中,设计来管理套件相依性的工具,因为简单又好用,现在已经成为一个独立的开放原始码计画。许多Framework以及程式库,现在都可以使用composer来安装管理。

其实在PHP上,很早就有这类的套件相依性管理工具,也就是PEAR。不过PEAR的设定过于繁复,也很难针对个别专案设定各自的相依性,所以现在Composer受到大众的喜爱。

这个简介只针对使用者,所以不会对于套件开发者需要知道的部份着墨。

* 安装

如果是Windows的使用者,只需要下载安装档并且执行安装:

https://getcomposer.org/Composer-Setup.exe

如果要手动安装,可以参考官网的指引:

http://getcomposer.org/doc/00-intro.md#installation-windows

如果是UNIX Like系统的使用者,可以透过这样的指令来安装:(需要先安装curl)

curl -sS https://getcomposer.org/installer | php

安装程式会检查PHP的设定,然后下载composer.phar到当前的目录。要执行composer的话,可以执行

php composer.phar

或是干脆把它改成执行档

>mv composer.phar composer>chmod +x composer

然后执行./composer。

不过如果再不同的工作目录中都需要的话,而且执行权限也没问题,也可以直接把档案复制到/usr/local/bin。

* 设定相依性

在专案中使用composer时,首先要产生一个composer.json档,里面指定要使用的套件与版本。例如需要用phpmailer来寄信时,可以这样指定:

{"require": {"phpmailer/phpmailer": "~5.2.7"}}

然后执行安装:

eng-Hsu-Pingteki-MacBook-Air:2-1a fillano$ composer installLoading composer repositories with package informationInstalling dependencies (including require-dev) - Installing phpmailer/phpmailer (v5.2.7) Downloading: 100% Writing lock fileGenerating autoload filesFeng-Hsu-Pingteki-MacBook-Air:2-1a fillano$

这样就安装好了。看一看到底装了什么:

Feng-Hsu-Pingteki-MacBook-Air:2-1a fillano$ ls -ltotal 16-rw-r--r-- 1 fillano staff 66 10 11 18:15 composer.json-rw-r--r-- 1 fillano staff 2330 10 11 18:16 composer.lockdrwxr-xr-x 5 fillano staff 170 10 11 18:16 vendor

根据目录中的档案可以发现,本来只有composer.json档案,安装之后多了一个composer.lock档案以及vendor目录。先看一下composer.lock的内容:

Feng-Hsu-Pingteki-MacBook-Air:2-1a fillano$ cat composer.lock{ "_readme": [ "This file locks the dependencies of your project to a known state", "Read more about it at http://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file" ], "hash": "065c23f92d5ae579cb91beff67f41196", "packages": [ { "name": "phpmailer/phpmailer", "version": "v5.2.7", "source": { "type": "git", "url": "https://github.com/PHPMailer/PHPMailer.git", "reference": "8717a79565b2c0ed67f851d70e1949febdf3b226" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/PHPMailer/PHPMailer/zipball/8717a79565b2c0ed67f851d70e1949febdf3b226", "reference": "8717a79565b2c0ed67f851d70e1949febdf3b226", "shasum": "" }, "require": { "php": ">=5.0.0" }, "require-dev": { "phpdocumentor/phpdocumentor": "*", "phpunit/phpunit": "*" }, "type": "library", "autoload": { "classmap": [ "class.phpmailer.php", "class.pop3.php", "class.smtp.php" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "LGPL-2.1" ], "authors": [....下略

看起来是刚刚安装套件的资讯。

再看一下vendor目录有什么东西:

Feng-Hsu-Pingteki-MacBook-Air:2-1a fillano$ tree vendorvendor├── autoload.php├── composer│ ├── ClassLoader.php│ ├── autoload_classmap.php│ ├── autoload_namespaces.php│ ├── autoload_real.php│ └── installed.json└── phpmailer └── phpmailer ├── LICENSE ├── PHPMailerAutoload.php ├── README.md ├── changelog.md ├── class.phpmailer.php ├── class.pop3.php ├── class.smtp.php ├── composer.json ├── docs │ ├── Callback_function_notes.txt │ ├── DomainKeys_notes.txt │ ├── Note_for_SMTP_debugging.txt │ ├── extending.html │ ├── faq.html │ ├── generatedocs.sh │ └── pop3_article.txt...下略

看起来除了phpmailer目录安装了phpmailer在里面之外,主要还有autoload.php档案以及composer目录。

原来要载入透过composer安装的套件,需要先引用vendor/autoload.php档案,然后就可以使用phpmailer。写一个简单的程式测试一下:

<?phprequire 'vendor/autoload.php';$phpmailer = new PHPMailer;

执行以后没有出错,表示phpmailer可以正常载入...接下来就看一下这几个档案的用途。

* composer.json

对使用者来说,这个档案主要是用来维护相依性。只要在档案中的"require"属性中加入一个物件,属性名称是套件名称,值就是版本。套件名称分成两个部分,第一个部分是vendor,第二个部分才是实际套件名称,使用"\"隔开。版本有几种规则:

  • 直接指定版号,例如2.7.3

  • 指定主版号之后,使用"*"指定次版号,例如2.7.*表示版号大于等于2.7.0,小于2.8.0的版本

  • 使用>、>=、!=、<=、<等在版号前,表示使用这些比较运算子来指定版号规则,可以使用多个规则并用","分开

  • 使用"~"在版号前,表示下一个版号变动之前的版本。例如~2.7,表示版本大于等于2.7,小于3.0

  • 在版号之后,还可以加上不同的stability flag,例如2.7.*@beta。可以使用的flag有:dev、alpha、beta、RC、stable

指定好版本后,执行composer install,就会根据指定的版本规则,安装最新版本的套件。

实际上每个有composer.json档案的目录,也是一个套件的根目录。不过如果是要做成给别人使用的套件,还需要加上许多设定,这些就不在讨论范围内了。

* composer.lock

在首次安装套件完毕后,会产生这个档案,里面记录了所安装套件的资讯。这个档案的真正作用是:如果目录中有这个档案,执行安装时,就不会去搜寻更新的版本,而是依照这个档案中记录的版本来安装。这个设计很重要,因为新版的套件很有可能与目前使用的版本不相容,如果不是使用同样版本,很难保证系统的稳定。过去在使用pear来管理套件时,如果不注意,就有可能发生升级导致的惨剧。

除此之外,只要把这个档案加入版本管理,所有开发者目录中也都会有这个档案,所以大家使用的套件版本也都会是一致的,这样可以减少开发时,使用套件版本不一导致的程式相容问题。

* vendor目录

所有套件都会放置在这个目录,并且依照<vendor name>/<package name>的目录结构来组织。

* vendor/autoload.php

只要引用这个档案,就可以载入套件中所有对外公开的类别。基本上每个套件都会定义自己的autoload规则,在安装时,composer会把这些规则加入,这样透过autoload.php就可以直接使用所有已安装的类别。

从这些地方可以看到,Composer这个套件管理工具,在设计上已经做了很周密的考量,只需要简单指定要使用的套件及版本,一个指令就可以安装完毕,引用一个胆案之后就能使用,这样真的非常方便。所以目前几乎所有的程式库以及Framework,应该都逐渐在套用这个工具了。未来在开发PHP程式,恐怕最基本的工具也就是composer。

请点击下方:“阅读原文”,在线查看!

以上是关于开发工具:用Composer管理相依性的主要内容,如果未能解决你的问题,请参考以下文章

译丨Yarn - Javascript 新一代套件管理

Composer : php依赖管理工具

PHP之依赖管理 composer

GitLab CICD Day 05 - 工作階段以及相依性

没有composer可以安装或者正常使用laravel么

PHP代码-psysh调试代码片段工具