目标
使用Composer下载或更新核心软件或附加模块和主题中的文件和依赖项。如果您不使用Composer,请跳过此主题。
必备知识
网站先决条件
如果要使用Composer,则必须将其安装在本地开发服务器或实际站点上。请参见第3.2节“概念:其他工具”。
脚步
如果您无法在实时服务器上安装Composer工具,则可以按照本地服务器上的以下任何部分中的步骤操作,然后将任何更新或添加的文件传输到实时服务器。建议的过程是创建新目录和已更改目录的存档或zip文件,将存档传输到实时服务器,删除已更改的目录,然后解压缩存档。确保在安装的根目录中检查以下文件的更新和添加内容:
- 供应商目录
- autoload.php
- composer.json
- composer.lock
使用Composer下载核心软件
如果您尚未下载或安装核心软件,并且希望使用Composer下载核心软件及其外部依赖项,请执行以下步骤:
- 在命令行中,更改为您希望软件驻留的目录上方的一个级别。
-
输入此命令,其中mydir是您要创建的目录:
composer create-project drupal-composer / drupal-project:8.x-dev mydir --no-interaction
- 最新版本的核心软件将下载到mydir / web 子目录; 你还可以在mydir / vendor目录中获得一些额外的工具,如Drush和Drupal Console 。
转换以前下载的站点以使用Composer
如果您之前未使用Composer下载了核心软件,则稍后可能会发现您希望或需要使用Composer来管理和更新依赖项。要将现有站点转换为使用Composer,请在站点的根目录中输入以下命令:
作曲家全球需要grasmash / composerize-drupal 作曲家composerize-drupal --composer-root =。--drupal根=。
请注意,如果这些模块,主题和配置文件放在modules / contrib,themes / contrib和profiles / contrib目录中,它们也会使您以前下载的模块,主题和配置文件不使用Composer 。如果将它们放在其他位置,您可以考虑删除以前下载的模块和主题,然后按照以下说明使用Composer重新下载它们。
使用Composer下载模块或主题
如果您已经在使用Composer来管理核心软件,并且希望使用Composer添加带有依赖项的贡献模块或主题,请执行以下步骤。
- 每次要添加贡献的模块或主题时,请确定项目的短名称。这是项目页面URL的最后一部分; 例如,Geofield模块,在https://www.drupal.org/project/geofield,有简称
geofield
。 -
要下载提供的模块或主题及其外部依赖项,请在站点的根目录中输入以下命令(替换模块或主题的短名称
geofield
):作曲家需要drupal / geofield
使用Composer更新以前下载的文件
在开始使用Composer管理依赖关系后,请按照以下步骤更新核心软件或贡献模块或主题的文件:
- 确定要更新的项目的简称。对于核心软件,它是核心。对于贡献的模块和主题,它是项目页面URL的最后一部分; 例如,Geofield模块,在https://www.drupal.org/project/geofield,有简称
geofield
。 -
如果要更新到最新的稳定版本,请使用以下命令,替换要更新的项目的短名称
geofield
:作曲家更新drupal / geofield --with-dependencies
-
如果您需要特定版本,请确定如何输入要更新的版本号。例如,对于贡献模块的版本8.x-1.7,您只需输入1.7,对于核心软件版本8.3.1,您将输入8.3.1。然后在站点的根目录中输入以下命令(替换项目的短名称
geofield
和正确的版本号):作曲家需要drupal / geofield:1.7
扩大您的理解
您可以使用Composer的内置帮助系统了解有关Composer命令的更多信息。例如,要了解有关该create-project
命令的更多信息,请composer help create-project
在命令窗口中输入 。
影片
其他资源
归因
由Jennifer Hodgdon, Hans Fredrik Nordhaug和 Joe Shindelar 改编自Drupalize.Me, 来自 “使用Composer来管理Drupal站点依赖”,版权所有2000-2017由Drupal社区文档的个人贡献者完成 。
评论