Як змусити маршрути завжди використовувати HTTPS або HTTP

Іноді вам хочеться убезпечити деякі маршрути і бути впевненими, що вони завжди доступні через HTTPS-протокол. Компонент Routing дозволяє вам посилити схему URI за допомогою схем:

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

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

use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;

class MainController extends Controller
{
    /**
     * @Route("/secure", name="secure", schemes={"https"})
     */
    public function secure()
    {
        // ...
    }
}

1
2
3
4
5

# config/routes.yaml
secure:
    path:       /secure
    controller: App\Controller\MainController::secure
    schemes:    [https]

1
2
3
4
5
6
7
8
9
10
11

<!-- config/routes.xml -->
<?xml version="1.0" encoding="UTF-8" ?>

<routes xmlns="http://symfony.com/schema/routing"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">

    <route id="secure" path="/secure" schemes="https">
        <default key="_controller">App\Controller\MainController::secure</default>
    </route>
</routes>

1
2
3
4
5
6
7
8

// config/routes.php
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;

$collection = new RouteCollection();
$collection->add('secure', new Route('/secure', array(
    '_controller' => 'App\Controller\MainController::secure',
), array(), array(), '', array('https')));

Конфігурація вище змушує маршрут secure завжди використовувати HTTPS.

При генеруванні URL secure, і якщо поточна схема - HTTP, Symfony автоматично згенерує абсолютний URL c HTTPS як за схемою, навіть при використанні функції path():

1
2
3
4
5
6
7

{# Если текущая схема HTTPS #}
{{ path('secure') }}
{# генерує відносний URL: /secure #}

{# Если текущая схема HTTP #}
{{ path('secure') }}
{# генерує абсолютний URL: https://example.com/secure #}

Ця вимога також обов'язкова для вхідних запитів. Якщо ви спробуєте отримати доступ до шляху /secure з HTTP, ви автоматично будете перенаправлені на той самий URL, але зі схемою HTTPS.

Приклад вище використовує для схеми https, але ви також можете змусити URL завжди використовувати http.