O Yii 3 é a nova geração do framework Yii para PHP, oficialmente lançada após anos de desenvolvimento e refinamento. O foco do projeto permanece nos mesmos princípios que tornaram o Yii conhecido: desempenho, flexibilidade com bons padrões, pragmatismo, simplicidade, explicitude e consistência.
O lançamento do Yii 3 também representa uma reestruturação profunda em relação ao Yii 1.1 e ao Yii 2.0, visando resolver limitações históricas. Entre elas estão um ecossistema mais fechado no Yii 2.0, comportamentos implícitos que dificultavam previsibilidade, menor aderência a padrões modernos por restrições de compatibilidade e a presença de anti‑padrões que afetavam testabilidade e manutenção no longo prazo.
Lançamento oficial e posicionamento do Yii 3
O Yii 3 foi lançado como uma evolução planejada para modernizar a experiência de desenvolvimento em PHP. A proposta central é oferecer uma base mais alinhada com padrões da comunidade, sem dependência de APIs proprietárias. O resultado é um framework mais interoperável, que funciona bem com bibliotecas amplamente usadas no ecossistema PHP. O site oficial do lançamento e visão geral pode ser acessado em https://yii3.yiiframework.com/.
Ao contrário de versões anteriores, o Yii 3 foi concebido para reduzir “mágica”, isto é, comportamentos automáticos difíceis de rastrear. A previsibilidade passa a ser um requisito de arquitetura, com configuração executável e depurável em tempo de execução. A compatibilidade com PHP moderno e com padrões PSR (recomendações do PHP-FIG) passa a ser uma base, não um complemento. Isso favorece portabilidade, manutenção e evolução de projetos por muitos anos.
Arquitetura por pacotes independentes
O Yii 3 deixa de ser um framework monolítico e se torna um ecossistema de pacotes. Em vez de depender de um “núcleo” único que traz tudo junto, o projeto oferece mais de 130 pacotes oficiais que podem ser combinados conforme a necessidade. Essa abordagem reduz acoplamento e permite instalar somente o que um projeto realmente usa. Além disso, os pacotes podem ser utilizados fora de uma aplicação Yii completa, em qualquer código PHP.
Essa modularidade também facilita atualizações e evolução controlada, porque cada pacote pode ter versionamento próprio. Isso cria um cenário em que um projeto pode evoluir componentes específicos sem exigir mudanças amplas em toda a base. A arquitetura por pacotes também incentiva boas práticas de design, com contratos explícitos e dependências claras. O efeito prático é mais liberdade para montar a aplicação com o nível de complexidade adequado ao contexto.
Modelos de aplicação (templates) disponíveis
O Yii 3 oferece modelos de aplicação prontos para iniciar projetos com estrutura mínima, porém funcional. Esses modelos conectam os elementos essenciais, como roteamento, configuração, container de injeção de dependências e ambiente. Ao mesmo tempo, evitam adicionar componentes “por padrão” que poderiam virar peso morto, como integração com banco de dados sem necessidade imediata. Essa filosofia reduz inchaço e melhora clareza arquitetural desde o início.
Os modelos oficiais do Yii 3 são três e cobrem os tipos de aplicação mais comuns. Eles podem ser consultados diretamente nos repositórios oficiais, que mostram a estrutura recomendada e a composição inicial do projeto. A lista a seguir apresenta os modelos disponíveis e seus endereços oficiais.
- Web (aplicações renderizadas no servidor): https://github.com/yiisoft/app
- API (serviços e endpoints): https://github.com/yiisoft/app-api
- Console (CLI, workers e ferramentas): https://github.com/yiisoft/app-console
Uso de qualquer pacote do ecossistema PHP
Uma mudança importante do Yii 3 é a abertura total ao ecossistema PHP via Composer e Packagist. Em vez de concentrar soluções em extensões específicas do Yii, o framework é desenhado para trabalhar bem com bibliotecas genéricas, componentes do Symfony e qualquer pacote compatível com padrões PSR. Isso diminui “aprisionamento” tecnológico, pois não existe uma obrigação de usar soluções exclusivas do framework. A consequência é maior capacidade de composição e substituição de componentes quando necessário.
Essa interoperabilidade é sustentada por contratos padronizados, como PSR-3 para logs, PSR-16 para cache, PSR-7 para HTTP e PSR-15 para middleware. Quando a aplicação se baseia em interfaces, trocar uma implementação por outra torna-se uma tarefa controlada e previsível. Esse modelo também facilita integração com ferramentas corporativas já adotadas. O resultado é um Yii 3 mais próximo do “PHP moderno”, com menos reinvenção e mais integração.
Container de injeção de dependências como peça central
O container de injeção de dependências (DI container) é o núcleo integrador do Yii 3. Injeção de dependências significa fornecer a uma classe aquilo que ela precisa para funcionar, normalmente via construtor, em vez de buscar dependências por conta própria. Isso reduz acoplamento, melhora testabilidade e torna as responsabilidades mais claras. No Yii 3, o container resolve dependências automaticamente a partir de type hints, mantendo o código explícito.
A configuração do container é executável e depurável, o que evita comportamento oculto. Ela permite mapear interfaces para classes, configurar construções detalhadas e definir fábricas (closures) para criação dinâmica. O exemplo a seguir ilustra os estilos principais de configuração e como a injeção ocorre por assinatura de construtor. O conteúdo foi mantido fiel ao padrão apresentado na base do Yii 3, adaptando apenas a formatação para código PHP completo.
<?php
declare(strict_types=1);
use Psr\SimpleCache\CacheInterface;
return [
// Mapeamento de interface para implementação
EngineInterface::class => EngineMarkOne::class,
// Configuração detalhada com construtor e método de ajuste
MyServiceInterface::class => [
'class' => MyService::class,
'__construct()' => [42],
'setDiscount()' => [10],
],
// Fábrica (closure) para criação sob demanda
'api' => static fn(ApiConfig $config) => new ApiClient($config),
];
// Dependências injetadas automaticamente com base nos type hints
final readonly class MyController
{
public function __construct(
private CacheInterface $cache
) {}
}Configuração por ambientes e separação por contexto
A configuração no Yii 3 segue uma abordagem poderosa e flexível, inspirada no que era tradicional no Yii 2.0, porém mais organizada e adaptável. Em geral, a estrutura separa configurações de contexto, como web (ou API) e console, com partes compartilhadas entre ambientes. Essa divisão ajuda a manter o projeto coerente quando há múltiplas entradas, como HTTP e CLI. Também facilita variações por ambiente, como desenvolvimento, teste e produção.
Na prática, a configuração tende a se dividir em duas partes: configuração do container (mapas e definições de classes) e parâmetros (valores que alimentam essas classes). Essa separação torna explícito o que é “componente” e o que é “dado de configuração”. O trecho abaixo exemplifica como pacotes podem receber parâmetros e referências a serviços do container. Referências são ponteiros para serviços, evitando criação manual e mantendo consistência.
<?php
declare(strict_types=1);
use Yiisoft\Aliases\Aliases;
use Yiisoft\Assets\AssetManager;
use Yiisoft\Router\CurrentRoute;
use Yiisoft\Router\UrlGeneratorInterface;
use Yiisoft\Yii\View\CsrfViewInjection;
use Yiisoft\Yii\View\Renderer\YiisoftYiiViewRenderer;
use Yiisoft\Yii\Web\ApplicationParams;
use Yiisoft\Di\Reference;
return [
'yiisoft/view' => [
'basePath' => null,
'parameters' => [
'assetManager' => Reference::to(AssetManager::class),
'applicationParams' => Reference::to(ApplicationParams::class),
'aliases' => Reference::to(Aliases::class),
'urlGenerator' => Reference::to(UrlGeneratorInterface::class),
'currentRoute' => Reference::to(CurrentRoute::class),
],
],
'yiisoft/yii-view-renderer' => [
'viewPath' => null,
'layout' => '@src/Web/Shared/Layout/Main/layout.php',
'injections' => [
Reference::to(CsrfViewInjection::class),
],
],
];Segurança como recurso de primeira linha
O Yii 3 mantém a tradição do Yii em tratar segurança como parte do desenho dos componentes. Em frameworks web, segurança envolve reduzir riscos de falhas comuns, como XSS (injeção de script no navegador), CSRF (falsificação de requisição) e SQL Injection (injeção de comandos no banco). No Yii 3, diversos pacotes e abstrações foram implementados considerando esses riscos desde o início. Isso inclui camadas de apresentação, acesso a dados e fluxo HTTP.
Entre as funcionalidades citadas estão abstração de controle de acesso, RBAC (controle baseado em papéis), autenticação com JWT, abstração de usuário, middlewares para lidar com proxies e cabeçalhos, cliente de autenticação de terceiros e pacotes auxiliares como proteção CSRF. Esses recursos tendem a ser combinados conforme o contexto do projeto, especialmente em aplicações API. A documentação oficial do conjunto e guias pode ser consultada no portal de docs. O endereço fornecido é https://yiisoft.github.io/docs/.
Banco de dados: DBAL, schema e query builder
O Yii 3 evolui a camada de banco de dados do Yii 2.0 para um pacote reimaginado: yiisoft/db. DBAL (Database Abstraction Layer) significa “camada de abstração de banco”, isto é, um conjunto de APIs que padroniza acesso, consultas, schema e utilitários. O Yii 3 oferece um construtor de consultas fluente (query builder) e recursos adicionais construídos em cima da base, como migrações e cache relacionado a banco. Também existe uma implementação de Active Record mais explícita, mantendo rapidez sem esconder demais o que acontece.
O exemplo a seguir mostra uma consulta típica com seleção de colunas, filtros, ordenação e limite. O estilo fluente melhora legibilidade e reduz concatenação manual de SQL. Ainda assim, o objetivo é continuar previsível, mantendo o controle sobre a consulta gerada. Quando houver preferência por outras abordagens, também é possível usar PDO, drivers nativos, Cycle ORM ou Doctrine, sem que o Yii 3 imponha uma única escolha.
<?php
declare(strict_types=1);
// Exemplo de consulta com query builder
$posts = $connection
->select(['id', 'title', 'created_at'])
->from('{{%posts}}')
->where(['status' => 'published'])
->andWhere(['>', 'views', 1000])
->orderBy(['created_at' => SORT_DESC])
->limit(10)
->all();Abstração de dados e componentes para listas e painéis
O Yii 3 inclui uma abstração de dados focada em padronizar formatação, paginação e ordenação, conhecida como yiisoft/data. Abstração de dados, nesse contexto, significa separar “fonte de dados” de “forma de apresentar”, permitindo reuso em diferentes camadas. Isso é especialmente útil para telas administrativas e listagens complexas, onde a mesma fonte pode alimentar diferentes apresentações. Também facilita trocar a origem dos dados sem reescrever a camada de interface.
Essa abordagem favorece componentes como grids e widgets de listagem que funcionam com múltiplos backends. O efeito é um design mais universal para páginas administrativas, evitando lógica duplicada. A paginação e a ordenação tornam-se serviços reutilizáveis, em vez de soluções pontuais. Em projetos grandes, isso contribui para consistência e redução de erros.
Cache com proteção contra “stampede” e compatibilidade PSR-16
O cache no Yii 3 evolui com recursos como proteção contra cache stampede, um problema que ocorre quando muitas requisições tentam recomputar o mesmo valor ao mesmo tempo após expiração. A ideia é reduzir sobrecarga e manter estabilidade sob pico de acesso. Além disso, os drivers seguem PSR-16, um padrão para cache simples em PHP, permitindo troca de implementação com baixo impacto. Isso viabiliza adaptar armazenamento conforme necessidade de infraestrutura.
Entre os backends implementados pelo time estão APCu, banco de dados, arquivos, Memcached e Redis. Em aplicações menores, cache em arquivo pode ser suficiente, enquanto sistemas distribuídos tendem a preferir Redis ou Memcached. A compatibilidade com PSR-16 também amplia opções de terceiros. Dessa forma, a aplicação não precisa ficar presa a uma única solução de cache.
Padrões PSR como base: HTTP, middleware, logs e DI
O Yii 3 adota uma arquitetura “standards-first”, baseada em interfaces PSR. Isso inclui PSR-7 para mensagens HTTP (requisição e resposta), PSR-15 para middleware, PSR-3 para logs, PSR-11 para containers e PSR-16 para cache. O benefício principal é interoperabilidade: bibliotecas do ecossistema podem ser integradas sem adaptação complexa. Também se torna viável substituir componentes internos por alternativas consagradas, mantendo contratos estáveis.
Um exemplo simples de ação HTTP com PSR-7 mostra como a resposta pode ser criada e escrita de forma direta. Em vez de depender de uma API proprietária, o código trabalha com interfaces amplamente adotadas. Isso melhora testabilidade, pois objetos de request e response podem ser simulados em testes. Também favorece evolução tecnológica, já que a aplicação fica menos acoplada a detalhes internos do framework.
<?php
declare(strict_types=1);
namespace App\Web\Post;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Message\ResponseFactoryInterface;
final readonly class PostAction
{
public function __construct(
private ResponseFactoryInterface $responseFactory,
) {}
public function view(ServerRequestInterface $request): ResponseInterface
{
$response = $this->responseFactory->createResponse(200);
$response->getBody()->write('Hello!');
return $response;
}
}Worker mode e servidores de longa duração
Em PHP tradicional, cada requisição reinicializa o framework e frequentemente reconecta ao banco, o que aumenta custo de CPU e latência. O Yii 3 suporta worker mode, um modo em que a aplicação inicializa uma vez e processa muitos ciclos de requisição-resposta. Isso pode ser usado com RoadRunner, Swoole ou FrankenPHP, reduzindo tempos de resposta e melhorando eficiência sob carga. É uma abordagem especialmente relevante para serviços com alto volume de tráfego.
Esse modo exige cuidado com estado compartilhado e vazamento de memória, já que o processo não encerra a cada requisição. O Yii 3 busca minimizar esse risco ao desenhar pacotes que não guardam estado ou que reinicializam corretamente por ciclo. Isso favorece previsibilidade e segurança operacional. Quando bem aplicado, o ganho de performance pode ser expressivo sem alterar o modelo mental do desenvolvimento.
Ferramentas para aplicações web clássicas e para APIs
O Yii 3 mantém recursos para aplicações renderizadas no servidor, como views, widgets, formulários, gerenciamento de assets e helpers de HTML. Também há suporte a motores de template, incluindo Twig, além de widgets prontos para Bootstrap 5 e Bulma. Isso preserva a capacidade do Yii de construir interfaces tradicionais com produtividade. A abordagem por pacotes permite adicionar apenas o que for necessário no projeto.
Para APIs, o Yii 3 oferece ferramentas como resposta de dados (para padronizar apresentação), suporte a Swagger e um conjunto voltado à construção de serviços HTTP consistentes. A adoção de PSR-7 e PSR-15 torna natural integrar middlewares de CORS, autenticação e observabilidade. Isso facilita manter uma arquitetura coerente em serviços REST ou similares. O objetivo é reduzir fricção ao montar pipelines HTTP modernos.
Validação com atributos e preenchimento de entrada
O Yii 3 inclui um validador poderoso baseado em attributes (atributos do PHP), que são metadados declarados diretamente no código. Essa abordagem torna regras de validação mais próximas do modelo de dados, reduzindo necessidade de configuração dispersa. Também existem ferramentas para preencher modelos a partir de entrada HTTP ou outras fontes, apoiando formulários e validação. O resultado tende a ser uma camada de entrada mais consistente e menos sujeita a divergências.
O exemplo abaixo mostra um FormModel com um campo e regras declaradas por atributos. A regra de comprimento mínimo evita mensagens vazias ou curtas demais, enquanto o rótulo define um nome humano para exibição. Esse estilo melhora legibilidade e centraliza as regras no ponto em que o dado é definido. Em aplicações maiores, esse padrão reduz repetição e facilita manutenção.
<?php
declare(strict_types=1);
namespace App\Web\Echo;
use Yiisoft\FormModel\FormModel;
use Yiisoft\Validator\Label;
use Yiisoft\Validator\Rule\Length;
final class Form extends FormModel
{
#[Label('The message to be echoed')]
#[Length(min: 2)]
public string $message = '';
}Internacionalização e utilitários (helpers)
O Yii 3 trata internacionalização como parte do framework, com tradução de mensagens e formatação ICU baseada na extensão intl. Internacionalização significa preparar a aplicação para múltiplos idiomas e formatos regionais, como datas, números e pluralização. Há suporte nativo também na camada de views e no roteamento, permitindo URLs e interfaces adaptadas. Isso é importante para produtos globais e também para aplicações locais com requisitos regionais específicos.
Além disso, existem diversos helpers para tarefas comuns, como manipulação de arrays, arquivos, JSON, strings e inspeção de variáveis. Helpers reduzem código repetitivo e centralizam comportamentos bem testados. Em projetos reais, essas pequenas bibliotecas diminuem erros em rotinas utilitárias. O efeito agregado é produtividade com consistência.
Testabilidade e qualidade do código
O Yii 3 foi desenhado para favorecer testabilidade, isto é, a capacidade de testar componentes em isolamento. A inversão de dependência, com interfaces e DI explícito, facilita criar substitutos (mocks e stubs) em testes unitários. A aderência a PSR para HTTP torna possível testar fluxos de API sem subir um servidor real. Além disso, existe um conjunto de implementações PSR voltadas a testes no pacote yiisoft/test-support.
O projeto também enfatiza qualidade com cobertura de testes muito alta, tipagem estrita e ferramentas de análise estática como Psalm e PhpStan. Há ainda testes de mutação, que verificam se os testes detectam alterações sutis no comportamento. Esse conjunto de práticas reduz regressões e aumenta previsibilidade em atualizações. O resultado é uma base mais estável para aplicações de longo prazo.
Tratamento de erros e “friendly exceptions”
O Yii 3 investe em mensagens de erro informativas e em páginas de erro úteis durante o desenvolvimento. “Friendly exceptions” são exceções que trazem contexto, apontando por que o erro ocorreu e indicando caminhos prováveis de correção. Isso reduz tempo gasto interpretando falhas genéricas e acelera diagnóstico. Em modo de desenvolvimento, a exibição de stack trace tende a ser mais rica e focada.
O pacote de tratamento de erros, yiisoft/error-handler, também considera cenários difíceis como falta de memória e erros fatais. Há suporte a mapear tipos de exceção para exceções personalizadas e a responder em formatos distintos, útil em APIs. Também existe integração com Sentry para coleta de erros, quando adotado no projeto. Esse cuidado melhora robustez operacional e manutenção contínua.
Política de versões e previsibilidade (SemVer)
O Yii 3 adota SemVer (Versionamento Semântico) por pacote, garantindo previsibilidade de atualizações. Em SemVer, versões de correção (patch) corrigem bugs sem quebrar compatibilidade, versões menores (minor) adicionam melhorias compatíveis e versões maiores (major) podem introduzir quebras e exigir ajustes. Como os pacotes são independentes, a evolução pode ocorrer de forma granular. Isso reduz risco em atualizações e facilita planejar manutenção.
Essa previsibilidade é importante em ambientes corporativos, onde atualizações precisam ser controladas. Também melhora a experiência em projetos com muitos serviços, pois dependências podem ser gerenciadas com mais precisão. O modelo reforça a ideia de ecossistema modular, em que cada componente segue um ciclo saudável de releases. No longo prazo, isso contribui para estabilidade e confiança na base tecnológica.
Exemplos oficiais e documentação
Além dos templates, o Yii 3 disponibiliza aplicações de exemplo que demonstram estilos arquiteturais distintos. Esses projetos ajudam a visualizar como pacotes se combinam em cenários mais realistas, incluindo organização por camadas e abordagens de estruturação por funcionalidades. Também servem como referência de integração entre roteamento, validação, persistência e camada de apresentação. A documentação oficial centraliza guias, conceitos e referências técnicas.
Os endereços fornecidos a seguir reúnem a documentação e exemplos oficiais mencionados. Eles organizam práticas comuns e demonstram como usar o ecossistema do Yii 3 em aplicações completas. A lista inclui o portal de documentação e dois projetos de demonstração com estilos diferentes. Esses materiais complementam a visão geral do release e reforçam o caráter modular do framework.
- Documentação: https://yiisoft.github.io/docs/
- Demo Blog (DDD em camadas): https://github.com/yiisoft/demo-blog
- Demo Diary (fatiados verticais, Active Record): https://github.com/yiisoft/demo-diary
Vantagens práticas do Yii 3 em projetos
O Yii 3 combina desempenho e arquitetura moderna com um conjunto de decisões que favorecem manutenção e evolução. A modularidade por pacotes reduz dependências desnecessárias e facilita compor soluções sob medida. A adoção de padrões PSR diminui atrito ao integrar bibliotecas e permite substituir componentes de forma segura. O container DI explícito reduz dependências ocultas, melhora testabilidade e elimina o uso de anti‑padrões como service locator “por padrão”.
No aspecto de performance, o worker mode oferece um caminho claro para ganhos relevantes em ambientes de alta carga. Em segurança, há um conjunto consistente de abstrações e pacotes voltados a autenticação, autorização e proteções comuns no contexto web. Para aplicações tradicionais, permanecem recursos maduros de views, widgets e assets, enquanto APIs se beneficiam de uma camada HTTP mais padronizada e testável. Em conjunto, essas escolhas formam uma base moderna, interoperável e preparada para aplicações pequenas e grandes.
Conclusão
O lançamento do Yii 3 marca uma mudança estrutural importante no ecossistema Yii: de um framework monolítico para uma plataforma modular, baseada em pacotes e padrões modernos. Essa transição endereça limitações observadas no Yii 2.0, como maior dificuldade de integração com pacotes genéricos, presença de comportamentos implícitos e restrições por compatibilidade retroativa. Ao priorizar PSR, DI explícito, qualidade rigorosa e configuração depurável, o Yii 3 fortalece previsibilidade e manutenção.
Com templates minimalistas, capacidade de usar qualquer biblioteca do ecossistema PHP, uma camada de dados reimaginada, cache avançado e suporte a worker mode, o Yii 3 amplia opções arquiteturais sem impor escolhas fechadas. O resultado é um framework que preserva a identidade do Yii em produtividade e pragmatismo, mas com uma base mais moderna e interoperável. O ponto central passa a ser liberdade com consistência, permitindo construir aplicações sustentáveis para ciclos longos de evolução.