7. Multisite
The PageBundle
handles multisite out of the box. However due to some
limitation of the Symfony API, the multisite support is done around 4 strategies:
Type |
Description |
---|---|
host |
you can configure a site per host. This strategy works out of the box with no changes. |
host_by_locale |
same than host, but try to retrieve the site by the Accept-Language header of the HTTP request. |
host_with_path |
you can configure site per host and per path. This strategy requires some changes. |
host_with_path_by_locale |
same than host with path, but try to retrieve the site by the Accept-Language header of the HTTP request. |
7.1. Host Strategy
With this strategy it is possible to handle sites like :
Configure the sonata_page
section as:
# config/packages/sonata_page.yaml
sonata_page:
multisite: host
7.2. Host By Locale Strategy
This strategy handles the same sites than previous one.
Configure the sonata_page
section as:
# config/packages/sonata_page.yaml
sonata_page:
multisite: host_by_locale
7.3. Host and Path Strategy
With this strategy it is possible to handle sites like :
This strategy requires a dedicated RequestFactory
object. So you need to alter the
front controller to use the one provided by the PageBundle
.
To do so, open index.php
file and change the following parts:
// public/index.php
use App\Kernel;
use Symfony\Component\ErrorHandler\Debug;
use Sonata\PageBundle\Request\RequestFactory; # before: use Symfony\Component\HttpFoundation\Request;
require dirname(__DIR__).'/config/bootstrap.php';
if ($_SERVER['APP_DEBUG']) {
umask(0000);
Debug::enable();
}
if ($trustedProxies = $_SERVER['TRUSTED_PROXIES'] ?? $_ENV['TRUSTED_PROXIES'] ?? false) {
Request::setTrustedProxies(explode(',', $trustedProxies), Request::HEADER_X_FORWARDED_ALL ^ Request::HEADER_X_FORWARDED_HOST);
}
if ($trustedHosts = $_SERVER['TRUSTED_HOSTS'] ?? $_ENV['TRUSTED_HOSTS'] ?? false) {
Request::setTrustedHosts([$trustedHosts]);
}
$kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
$request = RequestFactory::createFromGlobals('host_with_path'); // before: $request = Request::createFromGlobals();
$response = $kernel->handle($request);
$response->send();
$kernel->terminate($request, $response);
The last action is to configure the sonata_page
section as:
# config/packages/sonata_page.yaml
sonata_page:
multisite: host_with_path
7.4. Host and Path By Locale Strategy
This strategy requires a dedicated RequestFactory
object. So you need to alter the
front controller to use the one provided by the PageBundle
.
To do so, open index.php
file and change the following parts:
// public/index.php
use App\Kernel;
use Symfony\Component\ErrorHandler\Debug;
use Sonata\PageBundle\Request\RequestFactory; # before: use Symfony\Component\HttpFoundation\Request;
require dirname(__DIR__).'/config/bootstrap.php';
if ($_SERVER['APP_DEBUG']) {
umask(0000);
Debug::enable();
}
if ($trustedProxies = $_SERVER['TRUSTED_PROXIES'] ?? $_ENV['TRUSTED_PROXIES'] ?? false) {
Request::setTrustedProxies(explode(',', $trustedProxies), Request::HEADER_X_FORWARDED_ALL ^ Request::HEADER_X_FORWARDED_HOST);
}
if ($trustedHosts = $_SERVER['TRUSTED_HOSTS'] ?? $_ENV['TRUSTED_HOSTS'] ?? false) {
Request::setTrustedHosts([$trustedHosts]);
}
$kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
$request = RequestFactory::createFromGlobals('host_with_path_by_locale'); // before: $request = Request::createFromGlobals();
$response = $kernel->handle($request);
$response->send();
$kernel->terminate($request, $response);
The last action is to configure the sonata_page
section as:
# config/packages/sonata_page.yaml
sonata_page:
multisite: host_with_path_by_locale
Note
If you have a working site with the PageBundle, you just need to create a
Site
and update the page table and the snapshot table with the correct
Site id
value.