PHP 开发者该知道的 5 个 Composer 小技巧
Composer是新一代的PHP依赖管理工具。其介绍和基本用法可以看这篇《ComposerPHP依赖管理的新时代》。本文介绍使用Composer的五个小技巧,希望能给你的PHP开发带来方便。
只想更新某个特定的库,不想更新它的所有依赖,很简单:
composerupdatefoo/bar
此外,这个技巧还可以用来解决“警告信息问题”。你一定见过这样的警告信息:
Warning:Thelockfileisnotuptodatewiththelatestchangesincomposer.json,youmaybegettingoutdateddependencies,runupdatetoupdatethem.
擦,哪里出问题了?别惊慌!如果你编辑了composer.json,你应该会看到这样的信息。比如,如果你增加或更新了细节信息,比如库的描述、作者、更多参数,甚至仅仅增加了一个空格,都会改变文件的md5sum。然后Composer就会警告你哈希值和composer.lock中记载的不同。
那么我们该怎么办呢?update命令可以更新lock文件,但是如果仅仅增加了一些描述,应该是不打算更新任何库。这种情况下,只需updatenothing:
$composerupdatenothing Loadingcomposerrepositorieswithpackageinformation Updatingdependencies Nothingtoinstallorupdate Writinglockfile Generatingautoloadfiles
这样一来,Composer不会更新库,但是会更新composer.lock。注意nothing并不是update命令的关键字。只是没有nothing这个包导致的结果。如果你输入foobar,结果也一样。
如果你用的Composer版本足够新,那么你可以直接使用--lock选项:
composerupdate--lock
你可能会觉得每安装一个库都需要修改composer.json太麻烦,那么你可以直接使用require命令。
composerrequire"foo/bar:1.0.0"
这个方法也可以用来快速地新开一个项目。init命令有--require选项,可以自动编写composer.json:(注意我们使用-n,这样就不用回答问题)
$composerinit--require=foo/bar:1.0.0-n $catcomposer.json { "require":{ "foo/bar":"1.0.0" } }
初始化的时候,你试过create-project命令么?
composercreate-projectdoctrine/ormpath2.2.0
这会自动克隆仓库,并检出指定的版本。克隆库的时候用这个命令很方便,不需要搜寻原始的URI了。
最近一年以来的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选项来显示执行时间):
$composerinit--require="twig/twig:1.*"-n--profile Memoryusage:3.94MB(peak:4.08MB),time:0s $composerinstall--profile Loadingcomposerrepositorieswithpackageinformation Installingdependencies -Installingtwig/twig(v1.12.2) Downloading:100% Writinglockfile Generatingautoloadfiles Memoryusage:10.13MB(peak:12.65MB),time:4.71s $rm-rfvendor $composerinstall--profile Loadingcomposerrepositorieswithpackageinformation Installingdependenciesfromlockfile -Installingtwig/twig(v1.12.2) Loadingfromcache Generatingautoloadfiles Memoryusage: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来强制选择克隆源代码。
composerupdatesymfony/yaml--prefer-source
接下来你可以修改文件:
composerstatus-v Youhavechangesinthefollowingdependencies: /path/to/app/vendor/symfony/yaml/Symfony/Component/Yaml: MDumper.php
当你试图更新一个修改过的库的时候,Composer会提醒你,询问是否放弃修改:
$composerupdate Loadingcomposerrepositorieswithpackageinformation Updatingdependencies -Updatingsymfony/symfonyv2.2.0(v2.2.0-=>v2.2.0) Thepackagehasmodifiedfiles: MDumper.php Discardchanges[y,n,v,s,?]?
最后提醒一下,在部署代码到生产环境的时候,别忘了优化一下自动加载:
composerdump-autoload--optimize
安装包的时候可以同样使用--optimize-autoloader。不加这一选项,你可能会发现20%到25%的性能损失。
如果你需要帮助,或者想要了解某个命令的细节,你可以阅读官方文档或者中文文档,也可以查看JoliCode做的这个交互式备忘单。
原文地址:5featurestoknowaboutComposerPHP
译文地址:PHP开发者该知道的5个Composer小技巧
Composer是新一代的PHP依赖管理工具。其介绍和基本用法可以看这篇《ComposerPHP依赖管理的新时代》。本文介绍使用Composer的五个小技巧,希望能给你的PHP开发带来方便。
只想更新某个特定的库,不想更新它的所有依赖,很简单:
composerupdatefoo/bar
此外,这个技巧还可以用来解决“警告信息问题”。你一定见过这样的警告信息:
Warning:Thelockfileisnotuptodatewiththelatestchangesincomposer.json,youmaybegettingoutdateddependencies,runupdatetoupdatethem.
擦,哪里出问题了?别惊慌!如果你编辑了composer.json,你应该会看到这样的信息。比如,如果你增加或更新了细节信息,比如库的描述、作者、更多参数,甚至仅仅增加了一个空格,都会改变文件的md5sum。然后Composer就会警告你哈希值和composer.lock中记载的不同。
那么我们该怎么办呢?update命令可以更新lock文件,但是如果仅仅增加了一些描述,应该是不打算更新任何库。这种情况下,只需updatenothing:
$composerupdatenothing Loadingcomposerrepositorieswithpackageinformation Updatingdependencies Nothingtoinstallorupdate Writinglockfile Generatingautoloadfiles
这样一来,Composer不会更新库,但是会更新composer.lock。注意nothing并不是update命令的关键字。只是没有nothing这个包导致的结果。如果你输入foobar,结果也一样。
如果你用的Composer版本足够新,那么你可以直接使用--lock选项:
composerupdate--lock
你可能会觉得每安装一个库都需要修改composer.json太麻烦,那么你可以直接使用require命令。
composerrequire"foo/bar:1.0.0"
这个方法也可以用来快速地新开一个项目。init命令有--require选项,可以自动编写composer.json:(注意我们使用-n,这样就不用回答问题)
$composerinit--require=foo/bar:1.0.0-n $catcomposer.json { "require":{ "foo/bar":"1.0.0" } }
初始化的时候,你试过create-project命令么?
composercreate-projectdoctrine/ormpath2.2.0
这会自动克隆仓库,并检出指定的版本。克隆库的时候用这个命令很方便,不需要搜寻原始的URI了。
最近一年以来的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选项来显示执行时间):
$composerinit--require="twig/twig:1.*"-n--profile Memoryusage:3.94MB(peak:4.08MB),time:0s $composerinstall--profile Loadingcomposerrepositorieswithpackageinformation Installingdependencies -Installingtwig/twig(v1.12.2) Downloading:100% Writinglockfile Generatingautoloadfiles Memoryusage:10.13MB(peak:12.65MB),time:4.71s $rm-rfvendor $composerinstall--profile Loadingcomposerrepositorieswithpackageinformation Installingdependenciesfromlockfile -Installingtwig/twig(v1.12.2) Loadingfromcache Generatingautoloadfiles Memoryusage: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来强制选择克隆源代码。
composerupdatesymfony/yaml--prefer-source
接下来你可以修改文件:
composerstatus-v Youhavechangesinthefollowingdependencies: /path/to/app/vendor/symfony/yaml/Symfony/Component/Yaml: MDumper.php
当你试图更新一个修改过的库的时候,Composer会提醒你,询问是否放弃修改:
$composerupdate Loadingcomposerrepositorieswithpackageinformation Updatingdependencies -Updatingsymfony/symfonyv2.2.0(v2.2.0-=>v2.2.0) Thepackagehasmodifiedfiles: MDumper.php Discardchanges[y,n,v,s,?]?
最后提醒一下,在部署代码到生产环境的时候,别忘了优化一下自动加载:
composerdump-autoload--optimize
安装包的时候可以同样使用--optimize-autoloader。不加这一选项,你可能会发现20%到25%的性能损失。
如果你需要帮助,或者想要了解某个命令的细节,你可以阅读官方文档或者中文文档,也可以查看JoliCode做的这个交互式备忘单。
原文地址:5featurestoknowaboutComposerPHP
译文地址:PHP开发者该知道的5个Composer小技巧