operations/drupal-settings

2.1.0 2024-01-25 15:32 UTC

README

此PHP包是Drupal settings.php的智能包含。

将其添加到您的项目中,通过使用每个托管供应商和环境类型的常用默认值来简化settings.php文件。

它只是使事情变得更容易。例如,当使用Lando时,您不需要设置数据库设置或DRUSH_OPTIONS_URI,并且它自动启用开发模式。

用法

  1. 使用composer安装

    composer require operations/drupal-settings`
    
  2. 将代码片段添加到sites/default/settings.php

    if (file_exists(DRUPAL_ROOT . "/../vendor/operations/drupal-settings/Settings/settings.include.php")) {
        require DRUPAL_ROOT . "/../vendor/operations/drupal-settings/Settings/settings.include.php";
    }
    
  3. 盈利。

要覆盖由settings.include.php提供的任何默认值,只需将其添加到您的settings.php文件中即可。

组件

  1. Drupal设置包含文件 - settings.include.php

    从settings.php中包含此文件并删除所有额外的设置。有关其功能的完整文档,请参阅文件./Settings/settings.include.php

  2. 特定供应商的设置文件 - 当检测到其环境变量时自动包含。

  3. Composer自动加载文件 - autoload.php

    此文件尽可能早地包含在您的站点的Autoloader中。

    它用于自动设置环境变量,如DRUSH_OPTIONS_URI。

功能

此工具试图为多个主机提供商尽可能自动化配置。

主要功能包括

  1. 自动检测主机供应商环境并包含settings.VENDOR.php文件。
  2. 从主机供应商信息设置$databases凭据,或使用MYSQL_USER风格的变量。
  3. 全局设置DRUSH_OPTIONS_URI,以便任何对drush的调用都具有正确的URL。
  4. 当检测到生产环境时,将DRUPAL_ENV环境变量设置为prod。(默认为dev)。
  5. 包含来自此项目的环境特定settings.DRUPAL_ENV.php文件和来自您的站点的源代码中的sites/default/settings.DRUPAL_ENV.php(如果存在)。
  6. DRUPAL_ENV==dev时,通过包含Drupal的example.settings.local.php自动启用开发功能。

支持的提供商

  1. Lando
  2. DDEV
  3. Platform.sh
  4. Acquia
  5. OpenDevShop

我们邀请所有其他系统在此处提交合并请求:[https://git.drupalcode.org/project/ox/-/tree/1.x/src/composer/Plugin/DrupalSettings/Settings/Vendors](https://git.drupalcode.org/project/ox/-/tree/1.x/src/composer/Plugin/DrupalSettings/Settings/Vendors)

开发

此工具是Drupal Operations / OX项目的一部分。代码维护在“ox”单代码仓库中。

有关更多信息,请参阅https://git.drupalcode.org/project/ox