Varbase project template for Platform.sh
Starting a new project
To start a new Varbase 8.6.x project on Platform.sh, you have 2 options:
Create a new project through the Platform.sh user interface and select "start new project from a template". Then select Varbase 8.6.x as the template. That will create a new project using this repository as a starting point.
Take an existing project, add the necessary Platform.sh files, and push it to a Platform.sh Git repository. This template includes examples of how to set up a Varbase 8.6.x site. (See the "differences" section below.)
Using as a reference
settings.php- The customized
settings.phpfile works for both Platform.sh and local development, setting only those values that are needed in both. You can add additional values as documented in
settings.platformsh.php- This 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.
scripts/platformsh- This directory contains our update script to keep this repository in sync with the Drupal Composer project. It may be safely ignored or removed.
Managing a Drupal site built with Composer
Once the site is installed, there is no difference between a site hosted on Platform.sh and a site hosted anywhere else. It's just Composer. See the Drupal documentation for tips on how best to leverage Composer with Drupal 8.
How does this starter kit differ from vanilla Drupal from Drupal.org?
vendordirectory (where non-Drupal code lives) and the
configdirectory (used for syncing configuration from development to production) are outside the web root. This is a bit more secure as those files are now not web-accessible.
settings.platformsh.phpfiles are provided by default. The
settings.platformsh.phpfile automatically sets up the database connection on Platform.sh, and allows controlling Drupal configuration from environment variables.
We include recommended
.platformfiles that should suffice for most use cases. You are free to tweak them as needed for your particular site.