Documentação

27 Preparando o ambiente

Neste capítulo vamos preparar o ambiente para rodar aplicações desenvolvidas pelo Adianti Framework. Para tal, vamos abordar a instalação do PHP e dos drivers necessários.

Antes de instalar pacotes é necessário atualizar os repositórios através do comando:

sudo apt-get update

27.1 Ambiente Linux

Nesta seção, será abordada a instalação dos pré-requisitos para rodar o projeto em Linux Ubuntu 16.04. Dessa forma, é necessário instalar o Apache, o PHP, banco de dados, bem como suporte aos bancos de dados SQLite, PostgreSQL e Mysql.

Leia também o artigo Preparando um cloud server gabarito para o Adianti Framework para mais conhecimentos na configuração de servidores.

27.1.1 Banco de dados

É obrigatório a instalação de um banco de dados, abaixo alguns exemplos:

PostgreSql:

sudo apt-get install postgresql

MySQL:

sudo apt-get install mysql-server

SQLite3:

sudo apt-get install sqlite3

27.1.2 Ambiente web

A instalação do ambiente Web é simples e rápida, segue:

sudo apt-get install apache2 libapache2-mod-php php php-sqlite3 php-pgsql php-mysql php-xml

Certifique-se de que o Apache tenha habilitada a interpretação dos arquivos .htaccess, uma vez que o framework utiliza este arquivo para proteger o acesso a determinadas pastas com arquivos de configuração, como app/config. A seguir, temos um trecho de código que deve estar presente no apache2.conf ou httpd.conf dentro da cláusula Directory, para habilitar esta configuração.

AllowOverride All

Ou executar essa linha de comando no terminal:

sed -i.bak "s/AllowOverride None/AllowOverride All/g" /etc/apache2/apache2.conf

27.1.2 Exibição dos erros

Durante o período de desenvolvimento, certifique-se que a exibição de erros (display_errors = On) esteja habilitada no php.ini e todos os tipos de erro sejam exibidos. Para isso duas instruções precisam ser alteradas:

Display errors deve ser definida como "On"

display_errors = On

Error reporting deve exibir todos os tipos:

error_reporting = E_ALL

Ou ao invés de editar o arquivo é possível executar estes dois comandos:

Display errors:

echo "error_reporting = E_ALL" >> /etc/php/<versão php>/apache2/php.ini

Error reporting:

echo "display_errors = On" >> /etc/php/<versão php>/apache2/php.ini

ATENÇÃO

  1. Substituir corretamente a versão do PHP ao utilizar os comandos que ligam os erros.

  2. Os comandos irão adicionar essas instruções no final do arquivo.

27.2 Ambiente windows

Para preparar o ambiente web no Windows, utilize um instalador como o Wamp (http://www.wampserver.com), que já instala os pré-requisitos como Apache e PHP. Certifique-se de que o Apache tenha habilitada a interpretação dos arquivos .htaccess, uma vez que o framework utiliza este arquivo para proteger o acesso a determinadas pastas com arquivos de configuração, como app/config. A seguir, temos um trecho de código que deve estar presente no apache2.conf ou httpd.conf dentro da cláusula Directory, para habilitar esta configuração.

AllowOverride All

Obs: Durante o período de desenvolvimento, certifique-se que a exibição de erros (display_errors = On) esteja habilitada no php.ini

Display errors deve ser definida como "On"

display_errors = On

Error reporting deve exibir todos os tipos:

error_reporting = E_ALL

Atenção o diretório que o projeto deve ser colocado é:

C:/wamp64/www/meu-projeto

O exemplo acima é de uma instalação 64 bits.