This template builds Drupal 8 using the Drupal Composer project for better flexibility. It also includes configuration to use Redis for caching, although that must be enabled post-install in .platform.app.yaml
.
Drupal is a flexible and extensible PHP-based CMS framework.
- PHP 7.2
- MariaDB 10.2
- Redis 5
-
Run through the Drupal installer as normal. You will not be asked for database credentials as those are already provided.
-
Once Drupal is fully installed, edit your
.platform.app.yaml
file and uncomment the line under therelationships
block that readsredis: 'rediscache:redis'
. Commit and push the changes. That will enable Drupal's Redis cache integration. (The Redis cache integration cannot be active during the installer.)
The following changes have been made relative to Drupal 8 as it is downloaded from Drupal.org. If using this project as a reference for your own existing project, replicate the changes below to your project.
- It uses the Drupal Composer project, which allow the site to be managed entirely with Composer. That also causes the
vendor
andconfig
directories to be placed outside of the web root for added security. See the Drupal documentation for tips on how best to leverage Composer with Drupal 8. - The
.platform.app.yaml
,.platform/services.yaml
, and.platform/routes.yaml
files have been added. These provide Platform.sh-specific configuration and are present in all projects on Platform.sh. You may customize them as you see fit. - The
.platform.template.yaml
file contains information needed by Platform.sh's project setup process for templates. It may be safely ignored or removed. - An additional Composer library,
platformsh/config-reader
, has been added. It provides convenience wrappers for accessing the Platform.sh environment variables. - The
settings.platformsh.php
file contains Platform.sh-specific code to map environment variables into Drupal configuration. You can add to it as needed. See the documentation for more examples of common snippets to include here. It uses the Config Reader library. - The
settings.php
file has been heavily customized to only define those values needed for both Platform.sh and local development. It calls out tosettings.platformsh.php
if available. You can add additional values as documented indefault.settings.php
as desired. It is also setup such that when you install Drupal on Platform.sh the installer will not ask for database credentials as they will already be defined.