Version

Documentation » Page

7. Error Pages »

« 5. Shared Blocks

6. 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.

6.1. Host Strategy

With this strategy it is possible to handle sites like :

Configure the sonata_page section as:

  • YAML
    # config/packages/sonata_page.yaml
    
    sonata_page:
        multisite: host
    

6.2. Host By Locale Strategy

This strategy handles the same sites than previous one.

Configure the sonata_page section as:

  • YAML
    # config/packages/sonata_page.yaml
    
    sonata_page:
        multisite: host_by_locale
    

6.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\Debug\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:

  • YAML
    # config/packages/sonata_page.yaml
    
    sonata_page:
        multisite: host_with_path
    

6.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\Debug\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:

  • YAML
    # 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.

Found a typo? Something is wrong in this documentation? Just fork and edit it!