Drupal is a registered trademark of Dries Buytaert
Protected Pages 3.0.0 Major update available for module protected_pages (3.0.0). Commerce Core 3.3.8 Minor update available for module commerce (3.3.8). Search API HTML Element Filter 1.0.7 Minor update available for module search_api_html_element_filter (1.0.7). Layout Builder Reorder 2.0.1 Minor update available for module layout_builder_reorder (2.0.1). Ban 1.1.0 Minor update available for module ban (1.1.0). Field Formatter Range 2.0.0 Major update available for module field_formatter_range (2.0.0). Field Formatter Range 8.x-1.8 Minor update available for module field_formatter_range (8.x-1.8). UI Patterns (SDC in Drupal UI) 2.0.18 Minor update available for module ui_patterns (2.0.18). Search API Solr 4.3.11 Module search_api_solr updated after 14 months of inactivity (4.3.11). Provus Mega Menu Module provus_mega_menu crossed 1,000 active installs.

This is a Composer plugin that standardizes how `settings.php` is managed by keeping the main file clean and using included files for additional configuration. It allows for management through environment variables, provides sensible defaults, and includes opinionated best practices, while still allowing for extensions and overrides.

settingsphp is a composer plugin that provides a layout of settings.*.php files,
managed as scaffold files.

The aim of this plugin is to propose an standardisation around the management of settings.php.
It has been designed to accomplish the following principles:

1. Keep main settings.php files clean.

In our vision it should be a copy of default.settings.php with minimal additions at the end.

This project adds a single include line to settings.php.

2. Allow configuration via environment variables.

Allowing configuration via environment variables enhances security, flexibility,
and portability by separating configuration from code, simplifying deployment,
and supporting dynamic customization.

3. Provide sane defaults.

By providing sane defaults we aim to reduce configuration overhead by ensuring
Drupal works out-of-the-box with minimal setup.

4. Provide (opinionated) best practices from sbitio.

File settings.recommended.php provides sbitio specific Drupal settings.

Those are some of the tricks and best practices we've learned in managing a variety of sites across the years.

5. Allow to extend and override everything.

Extension points to tweak and suit your needs are provided.

See README for installation and usage instructions.

Activity

Total releases
7
First release
Feb 2025
Latest release
2 weeks ago
Releases (12 mo)
5 ▲ from 2
Maintenance
Active

Release Timeline

Releases

Version Type Release date
2.2.0 Stable Jun 30, 2026
2.1.2 Stable Oct 9, 2025
2.1.1 Stable Aug 5, 2025
2.1.x-dev Dev Jul 31, 2025
2.1.0 Stable Jul 31, 2025
2.0.1 Stable Jun 2, 2025
2.0.0 Stable Feb 16, 2025