Composer は、新世代の PHP 依存関係管理ツールです。その概要と基本的な使用法については、この記事「Composer PHP 依存関係管理の新時代」を参照してください。この記事では、PHP 開発の利便性を高めるために、Composer を使用するための 5 つのヒントを紹介します。
特定のライブラリのみを更新し、そのすべての依存関係を更新したくない場合は、非常に簡単です:
リーリーさらに、このトリックは「警告メッセージの問題」を解決するためにも使用できます。次のような警告メッセージを見たことがあるはずです:
リーリーくそー、何がいけなかったの?慌てないで! composer.json
,你应该会看到这样的信息。比如,如果你增加或更新了细节信息,比如库的描述、作者、更多参数,甚至仅仅增加了一个空格,都会改变文件的md5sum。然后Composer就会警告你哈希值和composer.lock
に記載されているものと異なる方法で編集した場合。
それではどうすればいいでしょうか? update
命令可以更新lock文件,但是如果仅仅增加了一些描述,应该是不打算更新任何库。这种情况下,只需update nothing
:
この方法では、Composer はライブラリを更新しませんが、更新されます composer.lock
。注意nothing
并不是update
命令的关键字。只是没有nothing
这个包导致的结果。如果你输入foobar
結果は同じになります。
使用している Composer のバージョンが新しい場合は、--lock
オプションを直接使用できます:
composer.json
。その場合は、require
コマンドを直接使用できます。 composer.json
太麻烦,那么你可以直接使用require
リーリー
init
コマンドには、自動的に記述できる --require
オプションがあります: (-n
を使用していることに注意してください。質問に答える必要はありません)init
命令有--require
选项,可以自动编写composer.json
:(注意我们使用-n
リーリー
コマンドを試しましたか? create-project
リーリー
4. キャッシュ、
dist
過去 1 年間の パッケージを自動的にアーカイブします。デフォルトでは、dist
包。默认设置下,dist
包用于加了tag的版本,例如"symfony/symfony": "v2.1.4"
,或者是通配符或版本区间,"2.1.*"
或">=2.2,<2.3-dev"
(如果你使用stable
作为你的minimum-stability
パッケージは "symfony/symfony": "v2.1.4"
などのタグ付きバージョン、またはワイルドカードまたはバージョン範囲 "2.1.*"
に使用されます。 > または ">=2.2, (<code>stable
を minimum-stability
として使用する場合)。
dist パッケージは dev-master
之类的分支,Github允许你下载某个git引用的压缩包。为了强制使用压缩包,而不是克隆源代码,你可以使用install
和update
的--prefer-dist
などのオプションにも使用できます。
これが例です (実行時間を表示するために --profile
オプションを使用しました):
こちら、twig/twig:1.12.2
的压缩包被保存在~/.composer/cache/files/twig/twig/1.12.2.0-v1.12.2.zip
。パッケージを再インストールするときに直接使用します。
ライブラリを変更する必要がある場合は、パッケージをダウンロードするよりもソース コードを複製する方が便利です。 --prefer-source
を使用して、複製されたソース コードを強制的に選択できます。
次に、ファイルを変更できます:
リーリー変更されたライブラリを更新しようとすると、Composer は変更を中止するかどうかを尋ねるメッセージを表示します:
リーリー最後に、コードを実稼働環境にデプロイするときは、自動読み込みを最適化することを忘れないでください:
リーリーパッケージをインストールするときにも使用できます--optimize-autoloader
。このオプションを使用しない場合、20% ~ 25% のパフォーマンスの低下が見られる可能性があります。
ヘルプが必要な場合、または特定のコマンドの詳細を知りたい場合は、公式ドキュメントまたは中国語のドキュメントを読むか、JoliCode によって作成されたこのインタラクティブなチートシートをチェックしてください。
元のアドレス: Composer PHP について知っておくべき 5 つの機能
翻訳アドレス: PHP 開発者が知っておくべき 5 つの Composer のヒント
Composer は、新世代の PHP 依存関係管理ツールです。その概要と基本的な使用法については、この記事「Composer PHP 依存関係管理の新時代」を参照してください。この記事では、PHP 開発の利便性を高めるために、Composer を使用するための 5 つのヒントを紹介します。
特定のライブラリのみを更新し、そのすべての依存関係を更新したくない場合は、非常に簡単です:
リーリーさらに、このトリックは「警告メッセージの問題」を解決するためにも使用できます。次のような警告メッセージを見たことがあるはずです:
<code>Warning: The lock file is not up to date with the latest changes in composer.json, you may be getting outdated dependencies, run update to update them. </code>
擦,哪里出问题了?别惊慌!如果你编辑了composer.json
,你应该会看到这样的信息。比如,如果你增加或更新了细节信息,比如库的描述、作者、更多参数,甚至仅仅增加了一个空格,都会改变文件的md5sum。然后Composer就会警告你哈希值和composer.lock
中记载的不同。
那么我们该怎么办呢?update
命令可以更新lock文件,但是如果仅仅增加了一些描述,应该是不打算更新任何库。这种情况下,只需update nothing
:
$ composer update nothing Loading composer repositories with package information Updating dependencies Nothing to install or update Writing lock file Generating autoload files
这样一来,Composer不会更新库,但是会更新composer.lock
。注意nothing
并不是update
命令的关键字。只是没有nothing
这个包导致的结果。如果你输入foobar
,结果也一样。
如果你用的Composer版本足够新,那么你可以直接使用--lock
选项:
composer update --lock
composer.json
的情况下安装库你可能会觉得每安装一个库都需要修改composer.json
太麻烦,那么你可以直接使用require
命令。
composer require "foo/bar:1.0.0"
这个方法也可以用来快速地新开一个项目。init
命令有--require
选项,可以自动编写composer.json
:(注意我们使用-n
,这样就不用回答问题)
$ composer init --require=foo/bar:1.0.0 -n $ cat composer.json { "require": { "foo/bar": "1.0.0" } }
初始化的时候,你试过create-project
命令么?
composer create-project doctrine/orm path 2.2.0
这会自动克隆仓库,并检出指定的版本。克隆库的时候用这个命令很方便,不需要搜寻原始的URI了。
dist
包优先最近一年以来的Composer会自动存档你下载的dist
包。默认设置下,dist
包用于加了tag的版本,例如"symfony/symfony": "v2.1.4"
,或者是通配符或版本区间,"2.1.*"
或">=2.2,<2.3-dev"
(如果你使用stable
作为你的minimum-stability
)。
dist包也可以用于诸如dev-master
之类的分支,Github允许你下载某个git引用的压缩包。为了强制使用压缩包,而不是克隆源代码,你可以使用install
和update
的--prefer-dist
选项。
下面是一个例子(我使用了--profile
选项来显示执行时间):
$ composer init --require="twig/twig:1.*" -n --profile Memory usage: 3.94MB (peak: 4.08MB), time: 0s $ composer install --profile Loading composer repositories with package information Installing dependencies - Installing twig/twig (v1.12.2) Downloading: 100% Writing lock file Generating autoload files Memory usage: 10.13MB (peak: 12.65MB), time: 4.71s $ rm -rf vendor $ composer install --profile Loading composer repositories with package information Installing dependencies from lock file - Installing twig/twig (v1.12.2) Loading from cache Generating autoload files Memory usage: 4.96MB (peak: 5.57MB), time: 0.45s
这里,twig/twig:1.12.2
的压缩包被保存在~/.composer/cache/files/twig/twig/1.12.2.0-v1.12.2.zip
。重新安装包时直接使用。
当你需要修改库的时候,克隆源代码就比下载包方便了。你可以使用--prefer-source
来强制选择克隆源代码。
composer update symfony/yaml --prefer-source
接下来你可以修改文件:
composer status -v You have changes in the following dependencies: /path/to/app/vendor/symfony/yaml/Symfony/Component/Yaml: M Dumper.php
当你试图更新一个修改过的库的时候,Composer会提醒你,询问是否放弃修改:
$ composer update Loading composer repositories with package information Updating dependencies - Updating symfony/symfony v2.2.0 (v2.2.0- => v2.2.0) The package has modified files: M Dumper.php Discard changes [y,n,v,s,?]?
最后提醒一下,在部署代码到生产环境的时候,别忘了优化一下自动加载:
composer dump-autoload --optimize
安装包的时候可以同样使用--optimize-autoloader
。不加这一选项,你可能会发现20%到25%的性能损失。
如果你需要帮助,或者想要了解某个命令的细节,你可以阅读官方文档或者中文文档,也可以查看JoliCode做的这个交互式备忘单。
原文地址:5 features to know about Composer PHP
译文地址:PHP 开发者该知道的 5 个 Composer 小技巧