Випуск Symfony 7.4 в листопаді 2025 року ознаменує значний еталон в історії рамки.В якості останньої версії довгострокової підтримки (LTS) вона зміцнює перехід до більш виразної, заснованої на атрибутах архітектури, яка розвивалася з тих пір, як PHP 8 запровадив надійні атрибути. Для старших розробників і архітекторів Symfony 7.4 – це не просто «нові іграшки» – це про усунення тертя.Дні безглуздої конфігурації YAML і складного аналізу анотацій ефективно закінчилися.Це випущення подвоює досвід розробника (DX), роблячи стандартні атрибути PHP розумнішими, більш гнучкими і здатними справлятися зі сценаріями, які раніше вимагали коду котла. У цій статті ми зануримося глибоко в ключові поліпшення атрибутів в Symfony 7.4, впроваджуючи їх у реальному контексті. Розумний маршрутизатор з підтримкою мультимедіа Однією з найбільш тривалих незручностей в маршрутизації Symfony було обмеження маршруту до декількох конкретних середовищ без дублювання коду або повернення до YAML. Вибір в Призначення приймає тільки один ряд. env #[Route] У Симфонії 7.4 Тепер він приймає Це особливо корисно для дебютування інструментів, випробувань диму або маршрутів "задніх дверей", які повинні існувати в та Але ніколи в . env array dev test prod **The Old Way (Symfony 7.3 and older)
\ You often had to define the route twice or use a regex requirement on a custom parameter, which was messy. **The Symfony 7.4 Way
\ You can now pass a clean array to the env parameter. // src/Controller/DebugController.php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class DebugController extends AbstractController
{
    #[Route(
        path: '/_debug/system-health', 
        name: 'debug_system_health', 
        env: ['dev', 'test'] // New in 7.4: Array support
    )]
    public function healthCheck(): Response
    {
        return $this->json([
            'status' => 'ok', 
            'environment' => $this->getParameter('kernel.environment')
        ]);
    }
}
 Перевірка : 
 
 
 Запустити APP_ENV=dev php bin/console debug:router — з'явиться маршрут. Запустити APP_ENV=prod php bin/console debug:router — маршрут відсутній. Гнучка безпека з типами союзу в #[CurrentUser] У сучасних додатках поширеним є наявність декількох користувачів (наприклад, Вс ) які поділяють брандмауер, але впроваджують іншу логіку. атрибут, який вимагає, щоб ви вводили натяк на певний клас або , змушуючи вас додавати інстанції перевірок всередині контролера. AdminUser Customer #[CurrentUser] UserInterface Symfony 7.4 оновлюється вирішити Це дозволяє вводити всі прийнятні класи користувачів безпосередньо в підпис методу контролера. MapCurrentUser to support Union Types // src/Controller/DashboardController.php
namespace App\Controller;

use App\Entity\AdminUser;
use App\Entity\Customer;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;
use Symfony\Component\Security\Http\Attribute\CurrentUser;

class DashboardController extends AbstractController
{
    #[Route('/dashboard', name: 'app_dashboard')]
    public function index(
        #[CurrentUser] AdminUser|Customer $user
    ): Response {
        // Symfony automatically resolves the user and ensures it matches one of these types.
        // If the user is logged in but is NOT an AdminUser or Customer, 404/Access Denied logic applies.

        $template = match (true) {
            $user instanceof AdminUser => 'admin/dashboard.html.twig',
            $user instanceof Customer => 'customer/dashboard.html.twig',
        };

        return $this->render($template, ['user' => $user]);
    }
}
 Ця зміна значно зменшує код перевірки типу котла на початку дій контролера. Гранулярний контроль доступу за допомогою методів #[IsGranted] ТІ атрибут є основним атрибутом декларативної безпеки, однак раніше він застосовувався до всього виконання методу незалежно від Верб: Якщо ви хотіли дозволити два Ресурс, але тільки два Ви повинні були розділити логіку на різні методи або використовувати Перевірка всередині методу. #[IsGranted] HTTP ROLE_USER GET ROLE_ADMIN DELETE is_granted() Symfony 7.4 додає варіант методів для . #[IsGranted] // src/Controller/ProductController.php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;
use Symfony\Component\Security\Http\Attribute\IsGranted;

#[Route('/products/{id}')]
class ProductController extends AbstractController
{
    #[Route('', name: 'product_action', methods: ['GET', 'DELETE'])]
    #[IsGranted('ROLE_USER', methods: ['GET'])]   // Checked only for GET requests
    #[IsGranted('ROLE_ADMIN', methods: ['DELETE'])] // Checked only for DELETE requests
    public function action(int $id): Response
    {
        // ... logic
        return new Response('Action completed');
    }
}
 Ця функція дозволяє зберігати пов'язану логіку (наприклад, перегляд та видалення конкретного ресурсу) в одній дії контролера, при цьому застосовуючи суворі, специфічні для методу політики безпеки. Ускладнені слухачі подій з типами союзу ТІ атрибут революціонував те, як ми реєструємо слухачів подій. у Symfony 7.4, цей атрибут Це неймовірно потужно для слухачів або робочих процесів, де кілька різних подій повинні викликати одну і ту ж логіку обробки (наприклад, OrderCreated і OrderUpdated). #[AsEventListener] now supports Union Types // src/EventListener/OrderActivityListener.php
namespace App\EventListener;

use App\Event\OrderCreatedEvent;
use App\Event\OrderUpdatedEvent;
use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
use Psr\Log\LoggerInterface;

final class OrderActivityListener
{
    public function __construct(
        private LoggerInterface $logger
    ) {}

    #[AsEventListener]
    public function onOrderActivity(OrderCreatedEvent|OrderUpdatedEvent $event): void
    {
        // Symfony automatically registers this listener for BOTH events.
        // The $event variable is type-safe.
        
        $orderId = $event->getOrder()->getId();
        $type = $event instanceof OrderCreatedEvent ? 'created' : 'updated';
        
        $this->logger->info("Order #{$orderId} was {$type}.");
    }
}
 Раніше вам доведеться пропустити натяк на тип (втрата переваг статичного аналізу) або зареєструвати два окремі методи. Валідація підпису Native URI Валідація підписаних URL-адресів (наприклад, «Клікніть тут, щоб перевірити вашу електронну пошту») зазвичай включає в себе введення сервіс і ручний виклик перевірка(). Symfony 7.4 вводить Атрибути автоматично обробляються в HttpKernel. UriSigner #[IsSignatureValid] Якщо підпис є недійсним або закінчився, Symfony викидає до того, як ваш контролер навіть запустить код. AccessDeniedHttpException // src/Controller/InvitationController.php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;
use Symfony\Component\HttpKernel\Attribute\IsSignatureValid;

class InvitationController extends AbstractController
{
    #[Route('/invite/accept/{id}', name: 'app_invite_accept')]
    #[IsSignatureValid]
    public function accept(int $id): Response
    {
        // If we reach here, the URL signature is cryptographically valid.
        return new Response("Invitation $id accepted!");
    }
}
 Щоб перевірити це, генеруйте підписаний URL-адрес у окремій команді або контролері: // In a command or another controller
public function generateLink(UrlGeneratorInterface $urlGenerator, UriSigner $signer)
{
    $url = $urlGenerator->generate('app_invite_accept', ['id' => 123], UrlGeneratorInterface::ABSOLUTE_URL);
    $signedUrl = $signer->sign($url);
    // Use this $signedUrl to test access.
}
 Розширення валідації для класів третіх сторін Мабуть, найбільш вражаючою функцією «Senior» в Symfony 7.4 є можливість прикріплення обмежень з валідацією (і метаданих серіалізації) до класів, які ви не володієте (наприклад, DTO з бібліотеки постачальника) за допомогою атрибутів PHP. Раніше це вимагало мапірування XML або YAML. тепер ви можете використовувати Визначення класу «проксі». #[ExtendsValidationFor] Уявіть, що ви використовуєте бібліотеку, яка надає класу, але він не має обмежень щодо перевірки. Ви хочете переконатися, що сума є позитивною. PaymentDTO The Vendor Class (You cannot edit this): // vendor/some-lib/src/PaymentDTO.php
namespace Vendor\Lib;

class PaymentDTO {
    public float $amount;
    public string $currency;
}
 Your Extension Class: // src/Validation/PaymentDTOValidation.php
namespace App\Validation;

use Symfony\Component\Validator\Attribute\ExtendsValidationFor;
use Symfony\Component\Validator\Constraints as Assert;
use Vendor\Lib\PaymentDTO;

#[ExtendsValidationFor(PaymentDTO::class)]
class PaymentDTOValidation
{
    #[Assert\Positive]
    #[Assert\NotBlank]
    public float $amount;

    #[Assert\Currency]
    public string $currency;
}
 Коли ви оцінюєте а об'єкт, Симфонія буде тепер визначити та застосувати обмеження, визначені в . PaymentDTO automatically PaymentDTOValidation Висновок Прийнявши ці поліпшення атрибутів, ви можете видалити рядки коду котла, покращити безпеку типу за допомогою Union Types і зберегти вашу конфігурацію ближче до вашої бізнес-логіки. Як а Міграція існуючої анотації або логіки на основі YAML до цих нових атрибутів дуже рекомендується для підготовки до Symfony 8.0. LTS release, Symfony 7.4 will be the standard for the next three years Оновлення фреймворку для навігації на складі або модернізація старих кодових баз до суворих типів і атрибутів можуть бути складними. Якщо ви шукаєте архітектурні поради щодо прийняття Symfony 7.4, або якщо вам потрібна досвідчена рука для керівництва вашою стратегією міграції, зв'яжіться з нами. Давайте обговоримо, як ми можемо скористатися цими новими функціями, щоб зробити вашу програму більш міцною, підтримуваною та готовою до майбутнього.

Read My Stories

Це аудіо створено мовою оригіналу історії!

Symfony 7.4 LTS: оновлення першого атрибуту, яке, нарешті, дозволяє видалити YAML

About Author

КОМЕНТАРІ

ПОВІСИТИ БИРКИ

ЦЯ СТАТТЯ БУЛА ПРЕДСТАВЛЕНА В

Related Stories

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps