diff --git a/README.md b/README.md index 0e4cbed..3a56003 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,7 @@ 5. Baixe o arquivo [gde_pacote.zip](https://gde.guaycuru.net/gde_pacote.zip) e descompacte-o; 6. Importe o arquivo `gde_pacote.sql` com o comando `mysql -u USUARIO -p BANCO < gde_pacote.sql` no qual USUARIO é seu usuário no MySQL e BANCO é o nome do banco de dados configurado no passo `4`. Esta importação irá demorar algum tempo, então tenha paciência; 7. Rode o comando `vendor/bin/doctrine orm:schema-tool:update --force` para ter certeza que as tabelas estão atualizadas. + 8. Usuários de linux podem encontrar problemas para rodar o projeto dentro do Apache. Siga [essas instruções](docs/LINUX_CONFIG.md) caso você se encontre perdido. ## Configurando a API do Google ## diff --git a/docs/LINUX_CONFIG.md b/docs/LINUX_CONFIG.md new file mode 100644 index 0000000..61a192a --- /dev/null +++ b/docs/LINUX_CONFIG.md @@ -0,0 +1,87 @@ +# Configuração no Linux + +## Registro do site + +Crie um link virtual do seu diretório com o projeto para o local padrão de acesso do Apache: + +```bash +sudo ln -s /caminho/do/projeto /var/www/html/gde # Exemplo sudo ln -s /home/[seu_usuario]/gde /var/www/html/gde +``` + +Crie o arquivo de registro do domínio dentro do Apache, use o nome que você achar melhor (e.g. `gde.conf`): + +```bash +sudo nano /etc/apache2/sites-available/gde.conf +``` + +Adicione as seguintes linhas no arquivo, substitua o caminho pelo caminho do seu projeto (e.g. `/home/[seu_usuario]/gde/`): + +```bash +ServerName gde +DocumentRoot /var/www/html/gde/ +Alias "/Web/gde/" "/var/www/html/gde/" +``` + +## Permissões do projeto + +Como o projeto tem um arquivo `.htaccess`, nós precisamos habilitar as diretrizes para que as configurações sejam aplicadas: + +```bash +sudo nano /etc/apache2/apache2.conf +``` + +```bash +... + + Options Indexes FollowSymLinks + AllowOverride None + Require all granted + + +# Adicione o bloco abaixo + + Options Indexes FollowSymLinks + AllowOverride All + Require all granted + + +# +# Options Indexes FollowSymLinks +... +``` + +## Habilitar site e módulos + +Com os arquivos de configuração do domínio criados e devidamente registrados, crie um link simbólico para `sites-enabled`: + +```bash +sudo a2ensite gde +``` + +Talvez seja necessário habilitar alguns módulos utilizados no projeto se já não estiverem habilitados: + +```bash +sudo a2enmod rewrite +``` + +```bash +sudo a2enmod php7.x # e.g. php7.4 +``` + +Após isso, reinicie o Apache para atualizar com as novas configurações: + +```bash +sudo systemctl restart apache2 +``` + +## Pós-configuração + +Agora, você deveria ser capaz de rodar o projeto tranquilamente, acessando: [http://localhost/Web/gde/](http://localhost/Web/gde/) + +Caso você veja apenas uma tela branca ou receba uma mensagem de erro vazia ao tentar logar, possa ser que o Apache não tenha permissão para acessar seu projeto. Basta dar essa permissão: + +```bash +sudo chown -R www-data:www-data /var/www/html/gde/proxies +``` + +Se estes passos funcionaram, se divirta mexendo no código e contribuindo! 🎉🎉