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 [email protected]: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.
- é necessário que as pastas
assets/eprotected/runtime/tenham permissão de leitura pelo Apache. Normalmente umchmod -R 777 assets protected/runtimeresolve isso - há a necessidade de um arquivo de configuração da extensão de email usada dentro do site. Esse arquivo não fica no repositório para manter a segurança dos dados. Ele deve ficar em
protected/config/_email.php. O Igor Santos ou o Raphael Almeida tem esse arquivo. - também precisamos do banco de dados. É necessário um usuário
phpnriono MySQL, com acesso preferencialmente aos bancosphpnrio%, 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.