Yii Framework – primeiros passos: instalação

Neste artigo, iremos baixar e instalar o Yii, criando em seguida nosso primeiro site.

Comece baixando a última versão (no momento em que escrevo este artigo, é a versão 1.1.12), em http://www.yiiframework.com/download/. Lá você encontra a opção de baixar em .tar.gz ou em .zip, além de também baixar pelo SourceForge. Lembrando que é necessário ter a versão 5.1.0 ou maior do PHP.

Após baixar, descompacte em alguma pasta que seu web server (Apache/IIS ou outro) tenha acesso (pode ser por exemplo, dentro de uma subpasta da  pasta “www”, no caso do Apache, mas isso varia de acordo com cada ambiente.

Após descompactar, repare que existem 3 pastas e 4 arquivos.

Pastas:

  • demos -aplicações de exemplo
  • framework – o “cerne” do yii
  • requirements – ao acessar essa pasta pelo navegador você verá se seu ambiente está preparado para rodar o Yii, ou seja, é um script que verifica as configurações do servidor.

Os arquivos referem-se a licença e outras informações.

Baixado e “instalado”, vamos criar nossa primeira aplicação.

Agora, abra um terminal/console e acesse a pasta onde você descompactou o framework. Digite então o seguinte comando:

C:\Yii> framework\yiic webapp primeiraapp

Caso esteja usando Linux, o comando será parecido, mas provavelmente você terá que modificar as permissões do arquivo ./framework/yiic para que ele fique executável. 

Ao pressionar Enter, o script irá perguntar se você deseja criar uma aplicação Web chamada “primeiraapp”. Confirme.

nota:  Caso ocorra algum erro, por exemplo “php não é reconhecido como um comando interno ou externo”, verifique se o php.exe está no PATH.

Um pouco sobre o yiic e seus parâmetros:

  1. framework\yiic  – Nesta parte chamamos a ferramenta yiic
  2. webapp – Este parâmetro indica que queremos criar uma aplicação web. Também é possível criar aplicações para console no Yii, mas não é o foco deste tutorial.
  3. primeiraapp – aqui indicamos o nome da pasta que vai conter nosso site/aplicação. Pode-se digitar somente o nome, como fizemos, e então ele será criado como uma subpasta da pasta em que estamos, ou pode-se digitar o caminho completo, caso a pasta web esteja em um diretório diferente.

Com nossa aplicação criada, vamos acessá-la, navegue até:
http://localhost/yii/primeiraapp/
(lembre-se de trocar pelo endereço que você configurou seu servidor)

Isso mostrará a página inicial da nossa aplicação:

Repare que o yiic criou para nós uma estrutura, com algumas páginas configuradas:

  • Home – página inicial
  • About – página estática (falarei mais sobre páginas estáticas em um próximo artigo)
  • Contact – página com um formulário de contato, é muito fácil criar um com o Yii.
  • Login –  O yiic criou também 2 usuários para a gente: digite demo/demo ou admin/admin e veja o que acontece ao logar-se.

Chegamos ao fim deste artigo. No próximo artigo veremos mais detalhes da estrutura que o yiic criou para nós e começaremos a deixar a aplicação com a “nossa cara”.

Mas enquanto isso, que tal testar as aplicações de exemplo? Acesse as que o framework criou, na pasta demos:

  • http://localhost/yii/demos/helloworld/  – o tradicional “Hello World”
  • http://localhost/yii/demos/blog/ – exemplo de blog
  • http://localhost/yii/demos/hangman/ – jogo da “forca”
  • http://localhost/yii/demos/phonebook/ – exemplo de webservice

Até o próximo artigo!

Thiago Henrique Nunes disse:
3

Parabéns pelo tutorial!

Me ajudou bastante!!

Muito obrigado!!!