Iniciando uma aplicação básica no Yii2

No artigo anterior (Entendendo o Yii2) fiz uma apresentação básica sobre o Yii2 e sobre suas duas opções de projeto. Nesse artigo vou mostrar como inicializar uma aplicação do template basic no Yii2.

Só para relembrar. “O basic template, como nome sugere, fornece uma estrutura simplificada que é recomendada para sites pequenos e cuja a manutenção seja algo bem simples ou queria só criar uma API simples.”

Antes de tudo precisamos ter o composer instalado na máquina. Não sabe o que é o composer nem como instalar, clique aqui.

Com o composer devidamente instalado, vamos por a mão na massa e criar nossa primeira aplicação com Yii2. É muito importante que instale e sempre mantenha atualizado o composer-asset-plugin. Pois ele é primordial para que possamos criar uma aplicação nova e atualizar as aplicações já existentes.

Nota: A partir da versão ~2.0.13 do Yii 2, não é mais necessário a instalação do pacote composer-asset-plugin. O item abaixo não é mais necessário em instalações novas.

Instalando o composer-asset-plugin

composer global require “fxp/composer-asset-plugin:^1.2.0”

Deve-se verificar no guia de instalação se esse plugin tem uma nova versão em http://www.yiiframework.com/doc-2.0/guide-start-installation.html

Nota: A partir da versão ~2.0.13 do Yii 2, não é mais necessário a instalação do pacote composer-asset-plugin. O item acima não é mais necessário em instalações novas.

Criando o projeto com o composer

composer create-project --prefer-dist yiisoft/yii2-app-basic nome-da-app

Instala de fato o framework, e com esse simples comando já teremos o primeiro projeto criado. Vamos criar um projeto chamado vitrine.

Abra seu terminal (sim nossos exemplos serão em GNU/Linux, rWindu$ é para os fracos) e rode o comando abaixo.

composer create-project --prefer-dist yiisoft/yii2-app-basic vitrine

Repare que o composer começa a trabalhar e baixar tudo que precisa para iniciar sua aplicação.

Download dos pacotes do Yii2

No final verá a seguinte mensagem:

Writing lock file
Generating autoload files
> yii\composer\Installer::postCreateProject
chmod(‘runtime’, 0777)…done
chmod(‘web/assets’, 0777)…done
chmod(‘yii’, 0755)…done

Isso quer dizer que sua aplicação já está pronta e é só chamar no seu browser. http://localhost/vitrine/web/

Com isso verá um site já criado com um layout padrão (que pode ser modificado). Navegue pelos links e veja que já tem conteúdo pelo menos para começar alguma coisa.

Uma dica é abrir a página de requerimentos que o framework cria para garantir que os requerimentos básicos foram atendidos. Acesse: http://localhost/vitrine/requirements.php

Criando o projeto por download

O basic template permite também que seja feito o download do Yii2, porém da um pouco mais de trabalho para configurar. Para fazer o download do Yii2 clique aqui.

Estrutura da aplicação

Os mais importantes diretórios e arquivos da sua aplicação (no nosso caso a raiz da nossa aplicação é vitrine)

vitrine/ raiz da aplicação composer.json usado pelo composer

config/             contém as configurações básicas da aplicação
        console.php     configuração do console (uso pela linha de comando)
		 db.php          configurações do banco de dados da aplicação
        web.php         configurações gerais da aplicação
    commands/           contém as classe de console de comandos
    controllers/        contém as classes dos controllers
    models/             contém as classes dos models
    runtime/            contém os arquivos gerados pelo yii em tempo de execução, assim como os logs e cache
    vendor/             contém os pacotes instalados incluindo o próprio Yii
    views/              contém as views
    web/                raiz da aplicação, contém os arquivos acessíveis Web
        assets/         contém os arquivos assets gerados (javascript e css) pelo Yii
        index.php       script de inicialização (bootstrap) para a aplicação
    yii                 o console de comando de execução do Yii

Para não ficar um artigo muito longo, vou para por aqui. No próximo artigo mostrarei as configurações básicas.

Até a próxima.