front/university-project

此包已被废弃且不再维护。未建议替代包。

基于composer的Drupal大学项目模板

v1.0.0-alpha1 2018-03-09 09:00 UTC

This package is not auto-updated.

Last update: 2024-06-20 10:48:19 UTC


README

基于 drupal-composer/drupal-project 的 Drupal大学项目composer模板

此项目模板应该可以为使用 Composer 管理您的网站依赖提供一个起点。

如果您想了解如何将其用作 Drush Make 的替代品,请访问 drupal.org 上的文档

使用方法

首先您需要安装 ComposerGit

注意:以下说明参考了 全局Composer安装。您可能需要根据您的设置将 composer 替换为 php composer.phar(或类似)。

之后,您就可以创建项目了

composer create-project --stability dev front/university-project university

使用 composer require ... 您可以将新的依赖项下载到您的安装中。

cd university
composer require drupal/devel:1.*

composer create-project 命令会将所有文件的所有权传递给创建的项目。您应该创建一个新的git仓库,并提交所有未被 .gitignore 文件排除的文件。

模板做了什么?

安装给定的 composer.json 时,会处理一些任务

  • Drupal 将安装在 docroot 目录中。
  • 实现了Autoloader,以使用在 vendor/autoload.php 中生成的 composer autoloader,而不是 Drupal 提供的 autoloader(docroot/vendor/autoload.php)。
  • 模块(类型为 drupal-module 的包)将放置在 docroot/modules/contrib/
  • 主题(类型为 drupal-theme 的包)将放置在 docroot/themes/contrib/
  • 配置文件(类型为 drupal-profile 的包)将放置在 docroot/profiles/contrib/
  • 下载Drupal脚手架文件,如 index.php.htaccess
  • 创建 sites/default/files 目录。
  • 将最新版本的drush安装到本地,以便在 bin/drush 下使用。
  • 将最新版本的 DrupalConsole 安装到本地,以便在 bin/drupal 下使用。

安装University

创建项目将安装 University 到 docroot 目录中的 university 目录内。现在您可以像使用任何 Drupal 8 站点一样安装 University。请参阅:Drupal 安装指南

更新University

此项目将尝试保持您所有 University 和 Drupal Core 文件的最新状态;项目 drupal-composer/drupal-scaffold 用于确保在 drupal/core 更新时您的脚手架文件也得到更新。如果您自定义了任何“脚手架”文件(通常为 .htaccess),则在 Drupal 核心的新版本中更新您修改的文件时,您可能需要解决合并冲突。

按照以下步骤更新您的 University 文件。

  1. 运行 composer update front/university
  2. 运行 git diff 以确定是否有任何脚手架文件已更改。审查文件以查看任何更改,并将对 .htaccessrobots.txt 的任何自定义更改恢复。
  3. 将所有内容一起提交到一个单独的提交中,这样在检出分支或运行 git bisect 时,docroot 将与 core 保持同步。
  4. 如果在第二步中存在非平凡的冲突,您可能需要在分支上执行以下步骤,并使用 git merge 将更新的核心文件与您的自定义文件合并。这有助于使用kdiff3 这样的三路合并工具。如果您所做的更改很简单,则不需要此设置;将所有修改保留在文件的开始或结束处是一种使合并变得容易的好策略。

常见问题解答 (FAQ)

我应该提交我下载的 contrib 模块吗

Composer 建议 不要。他们提供了反对的论点,但也提供了一些工作区段,如果项目决定这样做的话

我该如何应用下载的模块的补丁?

如果您需要应用补丁(根据正在修改的项目,拉取请求通常是更好的解决方案),可以使用 composer-patches 插件

要将补丁添加到 drupal 模块 foobar,在 composer.json 的 extra 部分插入 patches 部分

"extra": {
    "patches": {
        "drupal/foobar": {
            "Patch description": "URL to patch"
        }
    }
}

我该如何防止下载我不需要的 University 模块?

要防止下载 University 提供但您不需要的模块,请向您的 composer.json 中添加一个 replace 块

"replace": {
    "drupal/features": "*"
}

此示例防止下载任何版本的 feature 模块。