openfed/openfed8-project

Openfed发行版构建的Drupal 8站点的项目模板。

10.5 2022-02-09 16:21 UTC

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"两次。第一次会抛出相同的错误,但在第二次尝试时将成功运行。