Skip to main content
Drupal is a registered trademark of Dries Buytaert
Release: OpenID Connect / OAuth client 3.0.0-alpha9 New alpha version released for module openid_connect (3.0.0-alpha9). Release: Timelinr 1.0.1 Minor update available for module timelinr (1.0.1). Usage Milestone: Simplify Module simplify crossed 10,000 active installs. Usage Milestone: Views Reference Filter Module entityreference_filter crossed 10,000 active installs. Usage Milestone: Dropdown Language Module dropdown_language crossed 10,000 active installs. Usage Milestone: Paragraphs Browser Module paragraphs_browser crossed 10,000 active installs. Usage Milestone: OpenAPI Module openapi crossed 10,000 active installs. Usage Milestone: Decoupled Router Module decoupled_router crossed 10,000 active installs. Usage Milestone: Time Field for Drupal 8+ Module time_field crossed 10,000 active installs. Module Revived: Entityqueue Buttons 1.1.2 Module entityqueue_buttons updated after 8 months of inactivity (1.1.2).

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.

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
12
Tracked since
Nov 2024
Latest release
4 days ago
Releases (12 mo)
3 ▼ from 9
Maintenance
Active

Release Timeline

Releases

Version Type Core Release date
2.2.1 Stable Aug 27, 2026
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
2.0.x-dev Dev Jan 1, 2025
2.x-dev Dev Jan 1, 2025
8.x-1.0 Stable Nov 10, 2024
7.x-1.0 Stable Nov 10, 2024