druidfi/omen

Drupal ENV detector. Detects env related configuration and sets them for you. Helps with moving sites from environment to another. Aims also to generalize your env configuration.

Also sets configuration per environment type. e.g. for development or production. Everything can still be overridden in your project.

You should just focus on your project specific configuration.

How to use

Require omen in your composer.json:

composer require druidfi/omen

And then use this as your sites/default/settings.php:

<?php

// Use druidfi/omen
extract(Druidfi\Omen\Reader::get(get_defined_vars()));

Or print out all configuration (aka debug):

<?php

// Print out detected configuration by druidfi/omen
Druidfi\Omen\Reader::show(get_defined_vars());

See the whole example here.

Known environments

• Amazee.io Lagoon
• DDEV Local
• Lando
• Pantheon - Work in Progress
• Tugboat
• Wodby

What is detected?

• Loading of setting files and service configurations
• Database connection
• Trusted host pattern(s)
• File paths (public, private, temp)
• Hash salt
• Contrib module settings (which are affected by env)
  • Simple Environment Indicator

APP_ENV

With APP_ENV you can force a running configuration. E.g. you can run with test configuration on dev environment. This means that e.g. the database credentials do not change but caching settings do change.

Values: dev, test or prod (default: prod)

Drupal configuration mapping

Drupal configuration can be overridden using ENV variables.

Variable	ENV override	Default value
$databases['default']['default']['database']	DRUPAL_DB_NAME	✖️
$databases['default']['default']['driver']	DRUPAL_DB_DRIVER	'mysql'
$databases['default']['default']['host']	DRUPAL_DB_HOST	✖️
$databases['default']['default']['password']	DRUPAL_DB_PASS	✖️
$databases['default']['default']['port']	DRUPAL_DB_PORT	3306
$databases['default']['default']['username']	DRUPAL_DB_USER	✖️
$settings['config_sync_directory']	DRUPAL_CONFIG_SYNC_DIRECTORY	'conf/cmi'
$settings['file_public_path']	DRUPAL_FILE_PUBLIC_PATH	'sites/default/files'
$settings['file_private_path']	DRUPAL_FILE_PRIVATE_PATH	FALSE
$settings['file_temp_path']	DRUPAL_FILE_TEMP_PATH	'/tmp'
$settings['hash_salt']	DRUPAL_HASH_SALT	'0000000000000000'

✖️ Detected or required

Defaults for environment types

See src/Defaults.php for values.

See current default values by environment:

Variable	Development	Testing	Production
$config['system.logging']['error_level']	'all'	'hide'	'hide'
$config['system.performance']['cache']['page']['max_age']	0	900	900
$config['system.performance']['css']['preprocess']	0	1	1
$config['system.performance']['js']['preprocess']	0	1	1
$settings['skip_permissions_hardening']	TRUE	FALSE	FALSE

Same for all environments:

• $settings['config_exclude_modules'] = ['devel','stage_file_proxy','upgrade_status']
• $settings['config_sync_directory'] = 'conf/cmi'

TODO

Add support for:

• Detect e.g. Solr, Redis and Varnish configuration where available
• Other dev tools and hosting environments
• Default values for some contrib modules

Where the name "Omen" comes from?

Druids interpreted the waves of the ocean or read clouds for mundane or important omens. So reading clouds is basically what druidfi/omen is doing. Your local clouds too.

Other information

This project can be found from the Packagist: https://packagist.org/packages/druidfi/omen