jfeltkamp / argue-project
使用Composer的Argue项目模板
2.0.x-dev
2022-07-08 18:35 UTC
Requires
- composer/installers: ^1.12
- cweagans/composer-patches: ^1.7
- drupal/core-composer-scaffold: ^9.4
- drupal/core-project-message: ^9.4
- drupal/core-recommended: ^9.4
- drush/drush: ^9.0||^10.0
- jfeltkamp/argue: ^2.0
- league/commonmark: ^0.11
- oomphinc/composer-installers-extender: ^2.0
- vlucas/phpdotenv: ^2.4
Requires (Dev)
- drupal/core-dev: ^9.0
Conflicts
This package is auto-updated.
Last update: 2024-09-08 23:24:34 UTC
README
此项目模板应该为使用Composer管理您的站点依赖项提供一个启动点。
用法
注意:以下说明适用于全局Composer安装。您可能需要根据您的设置将
composer
替换为php composer.phar
(或类似)。
之后,您就可以创建项目了
composer create-project jfeltkamp/argue-project -s dev argue
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
目录。 - 在
bin/drush
处安装最新版本的drush用于本地使用。 - 在
bin/drupal
处安装最新版本的DrupalConsole用于本地使用。
安装Argue
创建项目将在Argue内部docroot目录中安装Argue。现在您可以将Argue像任何Drupal 9站点一样安装。请参阅:Drupal安装指南。
更新Argue
要更新Argue、Drupal或任何模块到最新版本(受composer.json
中指定的版本约束),请执行composer update
。此命令将检查每个依赖项的新版本,下载它并相应地更新composer.lock
。之后,您可以在docroot文件夹中运行drush updb
以更新您站点的数据库。
文件更新
此项目将尝试保持所有Argue和Drupal核心文件的最新状态;项目drupal/core-dev用于确保在更新drupal/core时,您的脚手架文件也会更新。如果您自定义了任何“脚手架”文件(通常是 .htaccess),那么在Drupal核心的新版本中更新您修改的文件时,您可能需要合并冲突。
按照以下步骤更新您的Argue文件。
- 运行
composer update drupal/argue
- 运行
git diff
以确定是否有任何脚手架文件已更改。审查文件以确定更改,并将任何自定义修改恢复到.htaccess
或robots.txt
。 - 将所有更改合并为单一提交,这样在检出分支或运行
git bisect
时,web
将与core
保持同步。 - 如果在第2步中存在非平凡冲突,您可能希望在这些步骤上使用分支,并使用
git merge
将更新后的核心文件与您的自定义文件合并。这有助于使用kdiff3这样的三路合并工具。如果您的更改很简单,则不需要此设置;将所有修改保持在文件的开头或结尾是一个保持合并容易的好策略。