Sistema de ticket utilizando Laravel 5 (parte 1)

16-04-2015
laravel

Parte 02

Nosso sistema de ticket será chamado Laraticket e como foi dito no primeiro post da série de tutoriais, será um sistema pequeno de ticket onde vou abordar todas as novas featues do Laravel 5. Lembro também que disse que não iria explicar como fazer a instalação pelo fato de que está muito claro na documentação do framework, porém, percebi que a instalação ainda é algo que muita gente se complica.

Vamos para um passo a passo da instalação.

Meu ambiente de desenvolvimento suporta a instalação?

Para conseguir realizar a instalação do Laravel 5, você precisa dos seguintes requerimentos:

  • PHP >= 5.4
  • Extensão Mcrypt (PHP Extension)
  • Extensão OpenSSL (PHP Extension)
  • Extensão Mbstring (PHP Extension)
  • Extensão Tokenizer (PHP Extension)

Obs: caso você tenha o PHP 5 instalado, algumas distribuições de SO podem exigir que você instale manualmente a extensão Json do PHP. Se você utilizar o ubuntu, execute o seguinte comando para instalar:

1
$ sudo apt-get install php5-json

Conhece o composer? Vamos precisar dele!

O composer é o gerenciador de dependências do PHP, onde com ele você informa quais são as bibliotecas que o seu framework depende para funcionar (por isso o nome gerenciador de dependências). O Laravel utiliza o composer para gerenciar suas dependências, então, vamos instalá-lo.

Acesse o site https://getcomposer.org/download/ e verifique como é feito a instalação. Para usuários linux/OSX, basta executar o seguinte comando:

1
$ sudo curl -sS https://getcomposer.org/installer | php

Lembrando que dessa forma você estará instalando o composer de forma local, onde você irá conseguir executá-lo apenas no diretório onde foi instalado. Caso queira executar o composer de forma global, execute o comando após a instalação:

1
$ mv composer.phar /usr/local/bin/composer

Para usuários windows é só baixar o .exe que tem no link e instalar.

Após a instalação rode o comando:

1
$ composer

E você deve visualizar isso:

composer installed

Agora estamos preparados para instalar o Laravel 5!

Com o composer instalado, o resto é tranquilo! Existem 3 formas de instalar o Laravel:

  • Git
  • Via Laravel installer
  • Via Composer create-project
    A forma que eu costumo utilizar é o git, mas você pode escolher a de sua preferência.

Utilizando o git, basta clonar o repositório:

1
$ sudo git clone https://github.com/laravel/laravel /var/www/html/laraticket

Utilizando o Laravel installer:

1
2
$ sudo composer global require "laravel/installer=~1.1"
$ laravel new /var/www/html/laraticket

Utilizando o Composer create-project:

1
2
$ cd /var/www/html
$ composer create-project laravel/laravel --prefer-dist

Após instalar o framework utilizando a forma que desejar, você deve acessar o diretório do framework e executar o seguinte comando:

1
$ sudo composer install

Dessa forma você vai instalar todas as dependências do projeto. Por padrão, as dependências instaladas vão para a pasta vendor/.

Vamos testar!

Agora que o framework foi instalado e já possui todas as suas dependências instaladas, podemos testar. Acesse http://localhost/laraticket/public e se você visualizar está tela é porque a instalação deu certo!

installation success

Podemos criar um vhost para não ter que ficar acessando a url do projeto através da pasta public.

Utilizando o ubuntu 12.04 com apache 2.4 execute os seguintes comandos:

1
2
$ cd /etc/apache/sites-available
$ sudo nano laraticket.conf

Insira o seguinte conteúdo dentro do arquivo criado:

1
2
3
4
5
6
7
8
9
10
11
<VirtualHost *:80>
ServerName laraticket.dev
DocumentRoot /var/www/html/laraticket/public

<Directory /var/www/html/laraticket/public>
Options Indexes FollowSymlinks
AllowOverride All
Order allow,deny
Allow from all
</Directory>
</VirtualHost>

Salve o arquivo, execute o comando para habilitar o vhost criado:

1
$ sudo a2ensite laraticket

Por fim vamos atualizar o arquivo hosts, que é o arquivo que relaciona um domínio com um ip na sua máquina:

1
2
3
4
5
127.0.0.1	localhost
127.0.1.1 dorianneto

# Local
127.0.0.1 laraticket.dev

Salve o arquivo e reinicie o apache:

1
$ sudo service apache2 restart

Agora acesse http://laraticket.dev e você deve visualizar a mesma tela de sucesso.

_Obs: não esqueça de verificar se o modrewrite do seu apache está ativado.

Ainda não acabou?!

Calma, falta apenas configurar o framework :P

Primeira coisa a se fazer após a finalização da instalação é definir uma key randômica para sua aplicação utilizando o comando:

1
$ php artisan key:generate

É indicado que você gere essa key, pois caso não seja gerado, as sessões de usuários e alguns dados criptografados podem não tão seguros.

Obs: procure pela chave key do array no arquivo config/app.php e verifique se a key foi inserida, caso não, insira manualmente.

Obs2: se você instalou o framework utilizando Composer create-project você não precisa se preocupar em gerar a key, pois isso é feito no momento da instalação.

E a segunda é inserir permissão de leitura e escrita nas pastas storage/ e vendor/

1
$ sudo chmod -R 644

Feito isso, você já pode começar a desenvolver!

E agora?

Agora sugiro que você brinque um pouco com o framework. Conheça a estrutura do framework (mudou bastante de versão 4.2 para a 5), abra e leia os arquivos (estão muito bem documentados) e entenda o processo de requisição do framework.

Caso tenha alguma dúvida em algum passo na instalação do framework, utilize os comentários abaixo. Terei o maior prazer em responder.

Um abraço e até a 2ª parte do tutorial!


Comentários: