Використання SSI в Symfony

Для початку, щоб використовувати SSI, не забудьте додати його у конфігурацію вашого додатку:

1
2
3

# config/packages/framework.yaml
framework:
    ssi: { enabled: true }

1
2
3
4
5
6
7
8
9
10
11
12
13
14

<!-- config/packages/framework.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/symfony"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony
        https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:ssi enabled="true"/>
    </framework:config>
</container>

1
2
3
4
5
6
7
8

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->ssi()
        ->enabled(true)
    ;
};

Припустимо, що у вас є сторінка з приватним змістом, на кшталт сторінки Профілю, і ви хочете кешувати статичний блок змісту GDPR. З SSI, ви можете додати закінчення строку дії цьому блоку, щоб сторінка залишалась приватною:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

// src/Controller/ProfileController.php
namespace App\Controller;

use Symfony\Component\HttpKernel\Attribute\Cache;
// ...

class ProfileController extends AbstractController
{
    public function index(): Response
    {
        // by default, responses are private
        return $this->render('profile/index.html.twig');
    }

    #[Cache(smaxage: 600)]
    public function gdpr(): Response
    {
        return $this->render('profile/gdpr.html.twig');
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

// src/Controller/ProfileController.php
namespace App\Controller;

// ...
class ProfileController extends AbstractController
{
    public function index(): Response
    {
        // by default, responses are private
        return $this->render('profile/index.html.twig');
    }

    public function gdpr(): Response
    {
        $response = $this->render('profile/gdpr.html.twig');

        // sets to public and adds some expiration
        $response->setSharedMaxAge(600);

        return $response;
    }
}

Тепер головна сторінка профілю має публічне кешування, але GDPR блок має 10 хвилин строку дії. Давайте включимо цей блок в основний:

1
2
3
4
5
6
7

{# templates/profile/index.html.twig #}

{# ви можете використати посилання контролера #}
{{ render_ssi(controller('App\\Controller\\ProfileController::gdpr')) }}

{# ... або шлях (у конфігурації сервера SSI розвпосюджено використання релятивних шляхів замість абсолютних URL) #}
{{ render_ssi(url('profile_gdpr')) }}

Помічник twig render_ssi згенерує щось типу:

1

<!--#include virtual="/_fragment?_hash=abcdef1234&_path=_controller=App\Controller\ProfileController::gdpr" -->

render_ssi гарантує, що SSI-директиви генеруються лише якщо запит має вимогу заголовку на кшталт Surrogate-Capability: device="SSI/1.0" (зазвичай задається веб-сервером). В інших випадках, він вбудує субвідповідь напряму.