README

什么是Blueberry Distrib D8

Blueberry Distrib D8提供了一个预安装的Drupal 8网站，包括基本模块和配置好的管理主题。

要求

• Composer

安装

首先声明一个PROJECT_CODE变量，它将被用作项目文件夹和数据库名称

• sh/bash/zsh: export PROJECT_CODE="blueberry"

• fish: set PROJECT_CODE "blueberry"

然后，获取Blueberry配置的代码源，你可以运行以下命令

composer create-project margauxdupuy/blueberry-project --stability=dev $PROJECT_CODE

然后，你可以在Drupal安装表单中添加你想要激活的模块包（命令行中尚未准备好）。

最后，完成配置的安装，假设你可以通过root:root访问localhost上的数据库

cd $PROJECT_CODE
drush site-install blueberry site-default-country=CH date-default-timezone="Europe/Zurich" --db-url=mysql://root:root@localhost/$PROJECT_CODE --account-mail="admin@example.com" --account-name=admin --account-pass=admin --site-mail="admin@example.com" --site-name="$PROJECT_CODE"
drush cex -y

主题安装

更新

• 要更新Drupal核心及其依赖项，请运行

composer update drupal/core webflo/drupal-core-require-dev "symfony/*" --with-dependencies

• 要更新Blueberry配置，请运行

composer update druids/blueberry --with-dependencies

启用开发者模式/禁用缓存

来源: https://www.liip.ch/en/blog/lets-debug-drupal-8

在settings.php中取消以下行的注释

if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) {
  include $app_root . '/' . $site_path . '/settings.local.php';
}

在web/sites/default中创建settings.local.php文件（你可以复制示例.settings.local.php）。

在settings.local.php中取消注释/更新一些值

• 取消此行注释以启用“null缓存服务”

$settings['container_yamls'][] = DRUPAL_ROOT . '/sites/development.services.yml';

• 取消以下行注释以禁用CSS/JS聚合

$config['system.performance']['css']['preprocess'] = FALSE;
$config['system.performance']['js']['preprocess'] = FALSE;

• 取消以下行注释以禁用渲染缓存和动态页面缓存

$settings['cache']['bins']['render'] = 'cache.backend.null';
$settings['cache']['bins']['dynamic_page_cache'] = 'cache.backend.null';

• 如果需要，你可以使用以下命令允许测试模块和主题安装

$settings['extension_discovery_scan_tests'] = TRUE;

在development.services.yml中禁用Twig缓存并添加以下设置

parameters:
    twig.config:
        debug: true
        auto_reload: true
        cache: false