acquia/drupal-recommended-project

Acquia-compatible Drupal application based on the Drupal Recommended Project

2.1.56 2024-07-24 14:03 UTC

Requires

• php: >=8.1
• acquia/acquia-cms-starterkit: ^1
• acquia/drupal-environment-detector: ^1
• acquia/drupal-recommended-settings: ^1.0
• acquia/memcache-settings: ^1
• composer/installers: ^2.1
• cweagans/composer-patches: ^1.6
• drupal/config_sync_without_site_uuid: ^1.0@beta
• drupal/core-composer-scaffold: ^10
• drupal/core-recommended: ^10
• drush/drush: ^12
• oomphinc/composer-installers-extender: ^2

Requires (Dev)

• acquia/coding-standards: ^3.0.0
• mglaman/phpstan-drupal: ^1.1
• phpstan/extension-installer: ^1.1
• phpstan/phpstan: ^1.6
• phpstan/phpstan-deprecation-rules: ^1.0
• phpunit/phpunit: ^9.5
• squizlabs/php_codesniffer: ^3.6

GPL-2.0-or-later

• Acquia Engineering

README

This is a project template providing a great out-of-the-box experience for new Drupal 10 projects hosted on Acquia. It is based on the Drupal Recommended Project, with the principal difference being the addition of several modules and packages that provide the best possible out-of-the-box experience for Acquia customers.

This project includes the following packages and configurations:

• Drupal core
• Drupal core scaffold
• Acquia CMS (Starter kit)
• Drupal Recommended Settings
• Drush (Drupal CLI and development tool)
• Asset Packagist repository, package, and configuration
• Acquia environment detection
• Acquia platform memcache settings
• Best practices for Drupal development, testing and project architecture

The Acquia CMS Starterkit allows you to install Drupal for a given style of CMS:

For more information on selecting the Acquia CMS Starterkit that best fits your use case follow instructions.

Installation

Create a new project using Composer:

composer create-project --no-interaction acquia/drupal-recommended-project

Once you create the project, you can and should customize composer.json and the rest of the project to suit your needs. You will receive updates from any dependent packages, but not from the project template itself. It's yours to keep!

For instance, you can remove a provided package by running the following command and committing the changed composer.json and composer.lock to Git:

composer remove acquia/mysql56

You should only commit changes to composer.json and composer.lock. Do not commit files in the vendor, docroot/core, and similar directories (these are ignored by the provided .gitignore file). In order to run your application in another environment, you’ll need to run composer install to reinstall these assets. Acquia Code Studio’s Auto DevOps feature can do this automatically when deploying to Acquia Cloud.

Usage (Install Acquia CMS)

Install Acquia CMS using starterkit follow instructions.

Other Drupal versions

Drupal 10 is installed by default. To install Drupal 9, use the below command:

composer create-project acquia/drupal-recommended-project:^1

Next steps

After creating your project, if you'd also like to use Acquia BLT, do the following:

• Add BLT via Composer with composer require acquia/blt
• Install the BLT Launcher and follow the rest of the BLT setup guide.
• Set up automated testing using BLT recipes and plugins such as BLT Behat and the Acquia Drupal Spec Tool.

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.