openfed / openfed8-project
Openfed发行版构建的Drupal 8站点的项目模板。
Requires
README
这是一个使用Openfed发行版构建的Drupal 8站点的项目模板。
文件结构
有2个json文件
composer.json
这将是你项目的主体json文件,你可以用它来添加额外的仓库。你可以随意覆盖它,但请确保在以下提到的json文件中使用时,composer-merge-plugin设置和包保持有序。
有关关于 composer-merge-plugin 设置和选项的更多信息,请参阅 https://github.com/wikimedia/composer-merge-plugin
composer.openfed.json
这将包含所有与Openfed相关的设置,一旦创建项目后不应更改。但是,你应该根据这个仓库中最新的版本定期更新此文件。
用法
安装
该项目需要安装composer。
注意:下面的说明参照了全局composer安装。您可能需要将
composer
替换为php composer.phar
(或类似)以适应您的配置。
之后,您可以创建项目
composer create-project openfed/openfed8-project:^10.0 MYPROJECT
更新
最好的方法是下载最新版本,并用文件替换您的项目。如果您在composer.json中定义了自定义模块,则需要将其复制到新的composer.json文件中。您可以删除现有的composer.libraries.json,因为它已经从本项目移除。
从Openfed 8.x-10.0开始,有一个实验性的composer脚本来部分更新本地项目。要更新您的项目,您可以
- 备份您的网站
- 运行
composer run-script openfed-update
- 手动更新composer.json(建议使用此仓库中的composer.json并调整它以使用您的项目/补丁)
- 运行
composer update
现在,您的项目应该已更新。
需要新模块
使用composer require ...
,您可以下载新的依赖项到您的安装。
cd MYPROJECT
composer require drupal/devel:~1.0
composer create-project
命令会将所有文件的拥有权传递给创建的项目。您应该创建一个新的git仓库,并将所有由.gitignore文件排除的文件提交。
故障排除
内存限制错误
在运行"composer install"时,您可能会遇到一些内存限制问题。这是由于composer依赖解析器,因为我们有一个很大的依赖列表。为了绕过这个问题,您有三个选择
选项1
暂时增加内存限制,如https://getcomposer.org.cn/doc/articles/troubleshooting.md#memory-limit-errors中所述
选项2
如果您是第一次创建项目,请使用推荐安装程序,使用"composer create-project"命令。
选项3
运行"composer update"两次。第一次会抛出相同的错误,但在第二次尝试时将成功运行。