Instalação Completa do Yii2 Avançado

Construir aplicações web modernas com arquiteturas separadas para o frontend e o painel de administração requer uma base sólida. O Yii2 Advanced Template é uma solução estruturada que oferece exatamente isso, completa com um sistema abrangente de gerenciamento de usuários. Este guia completo irá conduzi-lo através da instalação, configuração e otimização do seu ambiente de desenvolvimento para este template.

No desenvolvimento de aplicações web de médio a grande porte, a escolha do framework correto é crucial. O Yii2 Advanced Template surge como uma solução mais robusta em comparação com a versão Básica. Este template é projetado especificamente para projetos que exigem uma separação clara da lógica de negócios entre o frontend (aplicação para o usuário final) e o backend (painel do administrador).

A principal razão pela qual os desenvolvedores migram para o Yii2 Advanced Template é a disponibilidade de um sistema de gerenciamento de usuários completo e pronto para uso. Isso inclui funcionalidades de registro, login, logout, verificação de e-mail e redefinição de senha, todas implementadas com bons padrões de segurança. Além disso, sua arquitetura modular permite expansões futuras, como adicionar aplicações separadas para funções de moderador, gerente ou serviços de API isolados.

Leia também: Como ativar o HTTP/2 no Apache XAMPP

Preparativos Obrigatórios Antes da Instalação

Antes de iniciar a instalação do Yii2 Advanced Template, certifique-se de que seu ambiente de desenvolvimento atenda a todos os requisitos técnicos. Uma preparação completa evita erros e economiza tempo.

• Servidor Web: Você precisa de um servidor local como XAMPP (Windows), Laragon (Windows), MAMP (Mac) ou LAMP (Linux). Certifique-se de que o PHP versão 7.4.0 ou superior está instalado. PHP 8.0+ é altamente recomendado para o desempenho e segurança mais recentes. Baixe a versão mais recente do XAMPP no site oficial do Apache Friends.
• Composer: Este é um gerenciador de dependências do PHP que é obrigatório. Certifique-se de que o Composer está instalado globalmente em seu sistema. Verifique executando o comando composer --version no Prompt de Comando ou Terminal. Caso contrário, instale-o a partir de GetComposer.org.
• Extensões PHP: Certifique-se de que as seguintes extensões estejam ativas em seu arquivo php.ini: pdo, pdo_mysql (ou pdo_pgsql para PostgreSQL), mbstring, openssl e intl. Elas geralmente estão ativas por padrão nos pacotes XAMPP.
• Banco de Dados: Prepare um servidor de banco de dados (recomenda-se MySQL/MariaDB) e crie um banco de dados vazio que será usado pela aplicação Yii2.

Passo 1: Instalar o Yii2 Advanced via Composer

O processo de instalação usando o Composer é o método mais recomendado, pois gerenciará todas as dependências de bibliotecas de forma automática e estruturada.

1. Abra o Prompt de Comando (Windows) ou o Terminal (Mac/Linux).
2. Navegue (cd) até o diretório htdocs do seu servidor local (por exemplo, cd C:\xampp\htdocs ou cd /Applications/MAMP/htdocs).

3. Execute o seguinte comando de instalação. Este comando criará uma nova pasta chamada yii2-advanced contendo todo o código do template.

composer create-project --prefer-dist yiisoft/yii2-app-advanced yii2-advanced

4. Aguarde até que o processo seja concluído. O Composer baixará todos os pacotes necessários, incluindo o próprio framework Yii2, SwiftMailer e outras bibliotecas de suporte. Este processo requer uma conexão estável com a internet e pode levar alguns minutos.

Nota Importante para Composer 2.x: Diferente de tutoriais antigos, você não precisa mais executar o comando composer global require "fxp/composer-asset-plugin:~1.1.1". Esse plugin não é mais suportado e foi substituído por métodos nativos no Composer versão 2. Portanto, você pode executar diretamente o comando create-project.

Leia também: Remover o Frontend Web Yii2 com Apache e Nginx

Passo 2: Inicialização e Configuração Básica

Após o download bem-sucedido dos arquivos do template, a próxima etapa é inicializar o ambiente e configurar a aplicação.

1. Execute o Script de Inicialização (Init): Entre no diretório do projeto (cd yii2-advanced). Dentro dele, execute o arquivo init.bat (Windows) ou init (Linux/Mac) no terminal. Selecione a opção [0] Development para o modo de desenvolvimento. Se for solicitada confirmação, digite yes.
2. Configure o Banco de Dados: Abra o arquivo common/config/main-local.php com seu editor de texto preferido. Encontre a seção components['db'] e ajuste os detalhes de conexão do seu banco de dados.

'db' => [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=seu_nome_de_banco_de_dados',
    'username' => 'root', // seu nome de usuário do banco de dados
    'password' => '', // sua senha do banco de dados
    'charset' => 'utf8',
],

3. Execute a Migração do Banco de Dados: No terminal, ainda dentro do diretório do projeto, execute o seguinte comando para criar automaticamente os esquemas das tabelas (incluindo a tabela user).

php yii migrate

Pressione Sim quando solicitado a confirmar a execução da migração. Esse processo criará todas as tabelas necessárias, incluindo as de gerenciamento de usuários, logs e outras.

Passo 3: Configuração do Virtual Host (Recomendado)

Para acessar o frontend e o backend com URLs limpas e separadas (por exemplo, yii2-frontend.test e yii2-backend.test), é altamente recomendável configurar um host virtual no Apache. Isso replica um ambiente de produção e facilita o desenvolvimento.

1. Edite o httpd-vhosts.conf: Abra o arquivo C:\xampp\apache\conf\extra\httpd-vhosts.conf (ajuste o caminho se o seu XAMPP estiver em outro local). Adicione a seguinte configuração no final do arquivo:

<VirtualHost *:80>
    ServerName yii2-frontend.test
    DocumentRoot "C:/xampp/htdocs/yii2-advanced/frontend/web"
    <Directory "C:/xampp/htdocs/yii2-advanced/frontend/web">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
        # Configuração de roteamento para o Yii2 (URL Rewrite)
        RewriteEngine on
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . index.php
    </Directory>
</VirtualHost>

<VirtualHost *:80>
    ServerName yii2-backend.test
    DocumentRoot "C:/xampp/htdocs/yii2-advanced/backend/web"
    <Directory "C:/xampp/htdocs/yii2-advanced/backend/web">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
        # Mesma configuração de roteamento para o backend
        RewriteEngine on
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . index.php
    </Directory>
</VirtualHost>

2. Edite o Arquivo Hosts: Abra o arquivo C:\Windows\System32\drivers\etc\hosts como Administrador (use o Bloco de Notas “Executar como administrador”). Adicione estas duas linhas no final do arquivo:

127.0.0.1   yii2-frontend.test
127.0.0.1   yii2-backend.test

3. Reinicie o Apache pelo painel de controle do XAMPP.

Acesso e Teste da Aplicação Yii2

Após concluir todas as etapas acima, você está pronto para acessar e testar sua instalação do Yii2 Advanced Template.

• Acesse o Frontend: Abra seu navegador e visite http://yii2-frontend.test. Você verá a página inicial da aplicação.
• Acesse o Backend: Abra http://yii2-backend.test. Você será direcionado para a página de login do painel de administração.

Para testar as funcionalidades de gerenciamento de usuários, clique no link “Cadastrar-se” na página do frontend. Preencha o formulário de registro com um e-mail, nome de usuário e senha. Após o registro bem-sucedido, você pode fazer login imediatamente. Teste também a funcionalidade “Redefinir senha” para garantir que seu fluxo de trabalho funcione corretamente.

Leia também: Proteger dados pessoais e economizar internet

Conclusão e Próximos Passos

Seguindo este guia, você instalou e configurou com sucesso o Yii2 Advanced Template em seu ambiente de desenvolvimento local. Este template fornece uma base muito sólida para a construção de aplicações web complexas, escaláveis e seguras.

Os próximos passos lógicos após a instalação são aprender o Controle de Acesso Baseado em Funções (RBAC) integrado ao Yii2 para um gerenciamento mais detalhado de permissões de usuário no backend, configurar o envio de e-mail para funcionalidades de verificação e entender as estruturas de diretórios common, console, frontend e backend para um desenvolvimento ideal de funcionalidades.