PHPackages                             acquia/drupal-recommended-settings - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. acquia/drupal-recommended-settings

ActiveComposer-plugin[Utility &amp; Helpers](/categories/utility)

acquia/drupal-recommended-settings
==================================

The composer plugin for adding drupal-recommended-settings for Acquia Cloud.

1.2.0(2mo ago)111.3M↓43.9%12[6 issues](https://github.com/acquia/drupal-recommended-settings/issues)4GPL-2.0-onlyPHPPHP &gt;=8.1CI failing

Since Jun 26Pushed 2mo ago8 watchersCompare

[ Source](https://github.com/acquia/drupal-recommended-settings)[ Packagist](https://packagist.org/packages/acquia/drupal-recommended-settings)[ RSS](/packages/acquia-drupal-recommended-settings/feed)WikiDiscussions 1.x Synced yesterday

READMEChangelog (9)Dependencies (24)Versions (25)Used By (4)

Acquia Drupal Recommended Settings
==================================

[](#acquia-drupal-recommended-settings)

The Acquia Drupal Recommended Settings plugin adds the recommended settings to the Drupal project, so developers won't have to edit settings.php manually.

The recommended settings includes:

- The required database credentials.
- Configuration sync directory path.
- File directory path i.e public/private etc.
- Acquia site studio sync directory path.

It allows your websites to be easily installed in both Acquia Cloud IDE &amp; local and deployable on Acquia Cloud.

Installation
------------

[](#installation)

### Install using Composer

[](#install-using-composer)

```
composer require acquia/drupal-recommended-settings

```

### Multi-site features with Acquia DRS

[](#multi-site-features-with-acquia-drs)

The Drupal Recommended Settings offer the multi-site feature out of the box. To configure a multi-site, run the following command, and the plugin will automatically generate the settings.php in the backend.

```
drush site:install --uri site1

```

The plugin offers various events that allow you to implement custom logic based on when these events are triggered. You can find the examples of such implementations from [here](examples).

Quick examples
==============

[](#quick-examples)

### Generate settings with default credentials for the default site:

[](#generate-settings-with-default-credentials-for-the-default-site)

```
./vendor/bin/drush init:settings

```

### Set up a new site with custom credentials for the local environment:

[](#set-up-a-new-site-with-custom-credentials-for-the-local-environment)

```
./vendor/bin/drush init:settings --database=site1 --username=myuser --password=mypass --host=127.0.0.1 --port=1234 --uri=site1

```

---

Customizing File Operations
---------------------------

[](#customizing-file-operations)

By default, DRS copies a set of opinionated settings files into your project. You can now take full control of which files get copied, what content gets added to them, and even skip files you do not want.

> **To learn more about customizing operations, including advanced usage, schema details, and more examples, see [docs/how-to-use-operations.md](docs/how-to-use-operations.md).**

License
=======

[](#license)

Copyright (C) 2023 Acquia, Inc.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance74

Regular maintenance activity

Popularity49

Moderate usage in the ecosystem

Community29

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 59.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~103 days

Recently: every ~121 days

Total

11

Last Release

72d ago

PHP version history (2 changes)1.0.0-alpha1PHP &gt;=7.4

1.0.0-beta1PHP &gt;=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/102990804d65af5890df86ee8f6b8178bc5abcb2cd9855dacbb3ba3b8bd4bd2d?d=identicon)[vishalkhode1](/maintainers/vishalkhode1)

---

Top Contributors

[![vishalkhode1](https://avatars.githubusercontent.com/u/81069167?v=4)](https://github.com/vishalkhode1 "vishalkhode1 (111 commits)")[![rajeshreeputra](https://avatars.githubusercontent.com/u/19570710?v=4)](https://github.com/rajeshreeputra "rajeshreeputra (23 commits)")[![apathak18](https://avatars.githubusercontent.com/u/106175376?v=4)](https://github.com/apathak18 "apathak18 (21 commits)")[![chandan-singh7929](https://avatars.githubusercontent.com/u/63041696?v=4)](https://github.com/chandan-singh7929 "chandan-singh7929 (17 commits)")[![deepakmishra2](https://avatars.githubusercontent.com/u/108808209?v=4)](https://github.com/deepakmishra2 "deepakmishra2 (7 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![pookmish](https://avatars.githubusercontent.com/u/7185045?v=4)](https://github.com/pookmish "pookmish (1 commits)")[![acquia-github-bot](https://avatars.githubusercontent.com/u/7584922?v=4)](https://github.com/acquia-github-bot "acquia-github-bot (1 commits)")[![vipin-mittal-acquia](https://avatars.githubusercontent.com/u/109503136?v=4)](https://github.com/vipin-mittal-acquia "vipin-mittal-acquia (1 commits)")[![danepowell](https://avatars.githubusercontent.com/u/1984514?v=4)](https://github.com/danepowell "danepowell (1 commits)")

---

Tags

drupalacquiadrupal-recommended-settings

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/acquia-drupal-recommended-settings/health.svg)

```
[![Health](https://phpackages.com/badges/acquia-drupal-recommended-settings/health.svg)](https://phpackages.com/packages/acquia-drupal-recommended-settings)
```

###  Alternatives

[symfony/runtime

Enables decoupling PHP applications from global state

74798.8M1.0k](/packages/symfony-runtime)[vaimo/composer-patches

Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches.

3014.6M26](/packages/vaimo-composer-patches)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5344.1M564](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2124.7M203](/packages/drupal-core-project-message)[lullabot/drainpipe

An automated build tool to allow projects to have a set standardized operations scripts.

43785.5k4](/packages/lullabot-drainpipe)[mnsami/composer-custom-directory-installer

A composer plugin, to help install packages of different types in custom paths.

1465.4M62](/packages/mnsami-composer-custom-directory-installer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
