As we have seen in the earlier article to setup the Local environment with Lando and Drupal, Now let's see how we set up the multisite with the lando.
And hope you are already aware of Drupal Multisite. If not, It is a feature of Drupal that allows you to run multiple Drupal installs off of a common codebase. This allows you to share themes and modules between a collection of many websites. At a high level we can say Same Code with Different databases and Different Sites.
We already know Lando is a development tool (as discussed in an earlier article), which makes drupal development much quicker and easier. Lando provides an option to configure this from the .lando.yml file.
Let’s see in-details to set up a multisite. To setup Drupal multisite on lando you need to do below things:
In your .lando.yml you need to add proxies for each multisite in the appserver.
Have settings.lando.php file within your sub-directory (example: docroot/sites/drupal9_site_1/) which would need settings to connect to the respective database.
1. Changes in .lando.yml file
You need to add proxies for each multisite in the appserver.
proxy:appserver:- drupal9.site-1.local- drupal9.site-2.localservices: drupal9_site_1: type: mysql drupal9_site_2: type: mysql
2. Configure each settings.lando.php file
You need to have settings.lando.php file within your sub-directory and should add database connection settings on each file.
$databases['default'] = array ( 'default' => array ( 'driver' => 'mysql', 'database' => 'database', 'username' => 'mysql', 'password' => 'password', 'host' => 'password', 'prefix' => 'drupal9_site_1', // make sure host is matching with defined services above 'port' => 3306, ));
In case, if you have huge number of multisites, You can have below code in the settings.php of default site.
if (@$_ENV['LANDO'] == 'ON' && file_exists(dirname(__FILE__) . '/settings.lando.php')){ require(dirname(__FILE__) . '/settings.lando.php');} And include the below code in settings.lando.php
$sites['drupal9.site-1.local'] = 'drupal9_site_1';$sites['drupal9.site-2.local'] = 'drupal9_site_2';
And in each subsite’s settings.lando.php, have below code added.
$base_url = 'https://drupal9.site-1.local';
So, you will have both the base path and database creds in each of the subsite’s settings.lando.php file
$databases['default'] = array ( 'default' => array ( 'driver' => 'mysql', 'database' => 'database', 'username' => 'mysql', 'password' => 'password', 'host' => 'password', 'prefix' => 'drupal9_site_1', // make sure host is matching with defined service above 'port' => 3306, ));$base_url = 'https://drupal9.site-1.local';
This way by configuring lando you can run drupal 9 Multisite on your local environment. And on the configuration front you can do many other things like adding a few more sites, having different configuration of each subsite as same as in default drupal etc.
