README

此项目模板应提供使用 Composer 管理网站依赖项的启动点。

用法

首先您需要安装 Composer 和 Git。

注意：以下说明针对的是 全局 Composer 安装。对于您的设置，您可能需要将 composer 替换为 php composer.phar（或类似）。

之后，您可以创建项目

composer create-project jfeltkamp/rules-finder-project -s dev <my_project_name>

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

模板做了什么？

在安装给定的 composer.json 时，一些任务会被处理：

• Drupal 将安装在 docroot 目录中。
• 实现了自动加载器，以使用位于 vendor/autoload.php 中的生成的 Composer 自动加载器，而不是 Drupal 提供的自动加载器（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 中使用。

安装 RulesFinder

创建项目将在 RulesFinder 的 docroot 目录中安装 RulesFinder。您现在可以像使用任何 Drupal 9 网站一样安装 RulesFinder。见：Drupal 安装指南。

更新 RulesFinder

要更新 RulesFinder、Drupal 或任何模块到最新版本（由 composer.json 中指定的版本限制），请执行 composer update 命令。此命令将检查每个依赖项的新版本，下载它并相应地更新 composer.lock。之后，您可以在 docroot 文件夹中运行 drush updb 以更新您网站的数据库。

文件更新

此项目将尝试保持所有 RulesFinder 和 drupal 核心文件的最新状态；项目 drupal/core-dev 用于确保在 drupal/core 更新时，您的模板文件也会更新。如果您自定义了任何“模板”文件（通常是 .htaccess），则在 Drupal 核心的新版本发布中更新您修改的文件时，您可能需要解决任何合并冲突。

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

1. 运行 composer update drupal/rules_finder
2. 运行 git diff 以确定是否有任何模板文件已更改。审查文件以确定任何更改，并将任何自定义设置恢复到 .htaccess 或 robots.txt。
3. 将所有内容作为一个单独的提交提交，这样在检出分支或运行 git bisect 时，web 将与 core 保持同步。
4. 如果在步骤2中出现非平凡冲突，您可能希望在分支上执行以下步骤，并使用 git merge 将更新的核心文件与您的自定义文件合并。这有助于使用如 kdiff3 之类的 三路合并工具。如果您的更改很简单，则不需要此设置；将所有修改保持在文件的开始或末尾是一种使合并变得简单的良好策略。