Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Settingsphp

Security covered

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.

Drupal 9–11

Ask your assistant about Settingsphp

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

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
14
Tracked since
Nov 2024
Latest release
2 weeks ago
Releases (12 mo)
4 ▼ from 10
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
2.2.2 Stable 9–11 Sep 29, 2026
2.2.x-dev Dev 9–11 Sep 28, 2026
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