Esse é um README bem básico e seco feito pelo Igor Santos. O objetivo é ajudar no handout do projeto pra quem for mexer nele na minha ausência.
O projeto roda em cima do Yii, que no presente momento está na versão 1.1.11 aqui dentro. O framework está inserido no projeto a partir de um submódulo do Git - o código do framework também é hospedado no Github.
O primeiro passo é clonar o código e inicializar os submódulos no seu /var/www
(ou onde for que você guarde os arquivos que rodam no Apache):
$ git clone git@github.com:PHPRio/PHPnRio.git phpnrio
$ cd phpnrio
$ git submodule init
$ git submodule update
Isso vai trazer quase todo o código necessário para que o site rode.
Também é necessário configurar o VHost no Apache: na raiz do sistema tem um arquivo example.vhost
que você pode jogar na pasta /etc/apache2/sites-available
, renomear e configurar como ficar melhor pra você... Não pode esquecer também de adicionar o domínio novo no /etc/hosts
, para que ele aponte para 127.0.0.1
.
Vale lembrar também que o sistema depende da Rewrite Engine. Se você não tem certeza se ela esta habilitada, vale a pena rodar sudo a2enmod rewrite
para confirmar isso.
Nota: é necessário dois domínios no VHost, um com www e outro sem, pois o .htaccess
dentro do projeto faz o redirect de um domínio sem www para o com.
assets/
e protected/runtime/
tenham permissão de leitura pelo Apache. Normalmente um chmod -R 777 assets protected/runtime
resolve issoprotected/config/_email.php
. O Igor Santos ou o Raphael Almeida tem esse arquivo.phpnrio
no MySQL, com acesso preferencialmente aos bancos phpnrio%
, pois cada ano tem um banco diferente (como "phpnrio2011" e "phpnrio2012"). Depois disso, crie o banco do ano em que você vai trabalhar - por exemplo, phpnrio2012
.O sistema se baseia em migrations para manter o histórico das alterações do banco. Portanto, para criar a estrutura inicial, é só fazer o seguinte:
$ cd protected
$ ENVIRONMENT=dev ./yiic migrate
É necessário especificar a variável indicando o ambiente em que estamos pois a mesma é configurada, para o site, dentro do VHost. Você pode criá-la no seu ambiente, se desejar.
Se os acessos ao banco estiverem corretos, ele vai criar a tabela de histórico de migrações e depois rodar cada uma delas.