12. Conclusão
Este documento descreveu o desenvolvimento de uma aplicação web MVC usando o framework [Symfony]: uma aplicação cujas páginas HTML são geradas pelo servidor, por meio de views [Twig], sem um framework [JavaScript] no navegador. Ele seguiu o curso passo a passo de [Laravel], que por sua vez se baseia nos cursos [Flask], [Spring MVC], [ASP.NET Core MVC] e [NestJS]: ações e roteamento para views, formulários, internacionalização, segurança e acesso a dados, seguidos de um estudo de caso completo.
Os mesmos 28 exemplos e a mesma aplicação foram, assim, escritos com seis frameworks: em [TypeScript], em [C#], em [Java], em [Python] e duas vezes em [PHP]. Os conceitos são os mesmos; só os nomes e os mecanismos diferem. As correspondências entre o [Laravel] e o [Symfony], os dois grandes frameworks do mundo [PHP]:
[Laravel] | [Symfony] |
[bootstrap/app.php], service providers, | ([src/Kernel.php]), bundles, container compilado ([config/services.yaml], [#[Autowire]]) |
[composer.json], pasta [vendor], [php artisan] | [composer.json], pasta [vendor], [php bin/console] |
arquivo [.env], pasta [config] (arquivos [PHP]), funções [env] e [config] | arquivo [.env], pasta [config/packages] (arquivos YAML), [%env(...)%], parâmetros do container |
[routes/web.php], rotas nomeadas, grupos de rotas | atributos de controller [#[Route]], na ação e na classe |
[view], [redirect], [route] | [render], [redirectToRoute], [generateUrl] ([AbstractController]); [path] nas views |
objeto [Request], restrições ([whereNumber]), vinculação de modelo | objeto [Request], [requirements] ([{id<\d+>}]), argument resolvers, [#[MapQueryString]], [#[MapRequestPayload]] |
[Validator], form requests ([FormRequest]), regras, [$errors], [old()] | Componente Validator (restrições por atributos), componente Form (tipos, [handleRequest], [isValid]) |
views [Blade], [{{ }}], [@foreach], [@if] | views [Twig], [{{ }}], [{% for %}], [{% if %}] |
[@extends] e seções, [@include], componentes ([<x-...>]) | [{% extends %}] e blocos, [{% include %}], macros |
view composer ([View::composer]) | variáveis globais do [Twig], extensões [Twig] (funções, filtros) |
dados flash da sessão ([session()->flash], [with]) | mensagens flash ([addFlash], [app.flashes]), sessão em arquivos |
(global, grupo, rota), método [terminate] | listeners de eventos do kernel ([kernel.request], [kernel.controller], [kernel.response], [kernel.terminate]...) |
[withExceptions], [render], [abort] | Listeners: [kernel.exception], [HttpException], [createNotFoundException] |
guards ([Auth::viaRequest]), middleware [auth], [Gate], facade [Hash] | firewall, authenticators, [access_control], [#[IsGranted]], voters, hashing ([security.yaml]) |
[PreventRequestForgery] middleware, diretiva [@csrf] (resposta 419) | Token do componente Form, [csrf_token()] e [isCsrfTokenValid] (resposta 403, ou 419 em nossa aplicação) |
[RateLimiter] (facade) | Componente [RateLimiter] (limitadores declarados em [framework.yaml]) |
pasta [lang], função [__()], [App::setLocale] | pasta [translations] (YAML, ICU), filtro [trans], [TranslatorInterface], linguagem de consulta |
[Carbon] ([isoFormat]), [Number] | Extensão [intl]: [IntlDateFormatter], [NumberFormatter] |
Cache ([Cache], [Cache::lock]) | Componente Cache (PSR-6 e contracts), componente Lock |
[Eloquent]: models Active Record, relacionamentos ([belongsTo], [with]) | [Doctrine]: entidades Data Mapper, entity manager, DQL e QueryBuilder, relacionamentos ([ManyToOne], [OneToOne]) |
[DB::transaction(...)] | [wrapInTransaction(...)], [flush] |
[WHERE version = ?] e [version + 1], escritos na camada DAO | [#[ORM\Version]], gerenciado pelo [Doctrine] ([OptimisticLockException]) |
[php artisan serve] | [php -S localhost:8000 -t public], ou [symfony server:start] |
Quanto ao [Laravel], os pontos principais a observar são:
- [Symfony] é um conjunto de componentes independentes, reunidos em bundles. Cada componente é autônomo, e o [Laravel] usa vários deles ([HttpFoundation], [HttpKernel], [Routing], [Console]...): os leitores da lição anterior reconhecerão aqui os mesmos objetos: [Request] e [Response]. Uma aplicação [Symfony] instala apenas os componentes de que precisa: os exemplos começaram apenas com o [framework-bundle] e depois acrescentaram, um a um, o [Twig], a validação, os formulários, a segurança e o [Doctrine];
- Tudo passa pelo container de serviços e pela injeção de dependência: sem facades nem funções globais, mas com serviços passados ao construtor e declarados por tipo (autowiring). As dependências de uma classe são sempre visíveis em seu construtor. O container é compilado em código [PHP] e armazenado em cache: isso compensa o custo de reconstruir a aplicação a cada requisição (Exemplo 01);
- O processamento de uma requisição consiste em uma sequência de eventos do kernel aos quais listeners respondem: é aí que se tratam o idioma, a segurança, os controles da aplicação (o passe) e as páginas de erro. O mecanismo é mais explícito que o middleware do [Laravel]: cada listener escolhe seu evento e sua prioridade, e o comando [debug:event-dispatcher] exibe a ordem de todos os listeners;
- a configuração é explícita, em arquivos YAML (ou [PHP]) que descrevem cada bundle: o firewall, as regras de acesso, os limitadores, a sessão e o [Doctrine]. Os comandos [debug:router], [debug:container] e [debug:config] exibem o que o [Symfony] interpretou;
- Os atributos [PHP] descrevem o código: rotas ([#[Route]]), restrições ([#[Assert\NotBlank]]), entidades ([#[ORM\Column]]), listeners ([#[AsEventListener]]), permissões ([#[IsGranted]]) e injeção ([#[Autowire]]). Chegamos até a escrever alguns ([#[Timed]], [#[RegistrationPassRequired]]);
- os formulários são objetos, descritos por classes, com: campos, restrições, conversão de valores, reexibição da entrada, mensagens de erro e tokens anti-CSRF. Isso dá mais código do que os form requests do [Laravel] para um formulário pequeno, e muito menos para um grande: um tema ([Bootstrap] 5) estiliza todos os campos da mesma forma;
- security é um componente completo: um firewall, autenticadores que verificam o usuário, regras de acesso, uma hierarquia de papéis e voters. Nós o adaptamos às nossas necessidades (um token JWT em um cookie) com um autenticador de algumas dezenas de linhas, sem perder nenhum dos outros recursos: [access_control], [#[IsGranted]], [is_granted] nas views;
- [Doctrine] segue o padrão Data Mapper : as entidades são objetos [PHP] comuns que desconhecem o banco de dados; é o entity manager que as lê, rastreia suas alterações e as grava todas juntas, em uma única transação, no momento do [flush]. Mais abstrato que o Active Record do [Eloquent], ele separa claramente os objetos de seus registros e oferece suporte a mecanismos como o bloqueio otimista. O log das instruções SQL permite, como com o [Eloquent], verificar o que é enviado ao banco de dados;
- as views [Twig] têm sua própria linguagem, mais limitada que o [PHP] usado nas views [Blade]: uma view só pode exibir os dados que lhe são fornecidos. É ao mesmo tempo uma restrição e uma garantia: a lógica permanece nas classes. Elas são compiladas em [PHP], armazenadas em cache e escapam automaticamente o conteúdo que exibem.
O estudo de caso mostra que uma aplicação HTML clássica, sem [JavaScript] essencial, continua sendo uma solução simples e robusta: cada página é uma URL, o botão “Voltar” do navegador funciona e o servidor controla tudo. O uso limitado de [JavaScript] (janelas de confirmação) melhora a experiência do usuário sem ser necessário ao funcionamento. [Symfony] também pode oferecer suporte a aplicações mais interativas sem sair do [Twig] ([Symfony UX]: [Turbo], [Stimulus], Live Components) ou com um framework [JavaScript] no lado do navegador, ao qual fornece uma API JSON ([API Platform]): isso será tratado em outros documentos.
Para mais informações, consulte a documentação do [Symfony] (symfony.com/doc), em particular as páginas dedicadas ao contêiner de serviços, aos eventos do kernel, aos formulários, à segurança e ao [Doctrine], bem como a documentação do [Twig] (twig.symfony.com), a documentação do [Doctrine] (doctrine-project.org), a documentação do [PHP] (php.net/manual/en), e compare esta aplicação com suas equivalentes [Laravel], [Flask], [Spring MVC], [ASP.NET Core MVC], e [NestJS].