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(4mo ago)111.4M↓40.4%12[6 issues](https://github.com/acquia/drupal-recommended-settings/issues)4GPL-2.0-onlyPHPPHP &gt;=8.1CI failing

Since Jun 26Pushed 3mo 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 2w ago

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

55

—

FairBetter than 97% of packages

Maintenance66

Regular maintenance activity

Popularity50

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

117d 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

[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5346.5M600](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2125.4M213](/packages/drupal-core-project-message)[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.

3044.7M30](/packages/vaimo-composer-patches)[lullabot/drainpipe

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

43811.0k4](/packages/lullabot-drainpipe)[farmos/farmos

A web-based farm record keeping application.

1.3k7.3k1](/packages/farmos-farmos)[phpro/grumphp-shim

GrumPHP Phar distribution

284.9M348](/packages/phpro-grumphp-shim)

PHPackages © 2026

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