Configurando o PHP manualmente

A configuração do PHP envolve a edição do arquivo php.ini, na pasta onde o PHP for instalado, e a inclusão de referências a ele nos arquivos do Apache. Se você aceitar a configuração automática, não precisará alterar nada (a menos que ocorram erros). Mas se preferir configurar manualmente, arregace as mangas e vamos à obra!

Para começar, instale o PHP usando somente os componentes padrões. Eu marquei todos os itens na instalação, e ele dava um erro no final, além do que eu não conseguia mais iniciar o Apache. Então desinstalei e instalei novamente, sem selecionar todos os componentes, até por desconhecer a função de vários deles. É melhor você fazer uma instalação enxuta, as possibilidades de erros são menores. Com mais componentes, fica mais difícil localizar o ponto do erro.

Pense na montagem de um computador, vá colocando os recursos aos poucos, e testando. Se funcionar, avance, caso contrário, pare e veja a última coisa até onde funcionava. Se você simplesmente instalar tudo, ficará muito mais complicado encontrar as causas dos erros, especialmente se você não tiver prática com todos os recursos oferecidos no instalador do PHP (ou do que for).

Para configurar manualmente o PHP, ou se a configuração automática falhar, são basicamente três passos. Vamos começar pela configuração do Apache. Abra o arquivo “httpd.conf“, da pasta “conf“, que está dentro da pasta do Apache. No final do arquivo, depois de tudo o que tiver nele, deverão existir estas linhas:

PHPIniDir "C:\php5\"
LoadModule php5_module "C:\php5\php5apache2_2.dll

Veja num editor de textos, para ter uma idéia melhor:

Neste screenshot a configuração destacada foi adicionada pelo instalador do PHP 5. Observe os comentários, pedindo para remover estas linhas apenas na desinstalação do PHP.

A linha PHPIniDir define a pasta do PHP, onde ele foi instalado (onde esta o php.ini original).

A linha LoadModule… Carrega o módulo do PHP no Apache, que se chama “php5_module“, e está no arquivo “C:\php5\php5\apache2_2.dll“.

É recomendável instalar o PHP em uma pasta onde o nome do caminho dela não contenha espaços, mas isso não é obrigatório. Eu instalei em “C:\php5“, seguindo a idéia das versões mais antigas, mas o instalador sugeria por padrão uma subpasta da “Arquivos de programas“. Seguindo o exemplo, prefira usar duas barras invertidas (\) em vez de uma só nos caminhos, e não se esqueça de colocar entre aspas se tiver espaços.

Agora vamos configurar o “mime.types“. Abra-o num editor de textos puro e adicione, também no final de tudo (tecnicamente, pode ser onde você quiser, mas não se confunda depois :), as linhas:

application/x-httpd-php php
application/x-httpd-php-source phps

Elas identificam os tipos de arquivo .php e .phps, para que o Apache saiba lidar com eles e então enviá-los corretamente aos browsers.

Agora falta configurar o arquivo “php.ini“. Ele deve ficar numa pasta que esteja cadastrada na variável de ambiente “path“, do Windows. Isso permite que qualquer programa chame este arquivo apenas pelo nome, sem precisar indicar o caminho completo.

Antigamente se editava o php.ini, e depois ele era copiado para a pasta do Windows (ou system32). Nada impede que você faça isso, mas na instalação do PHP5, com a configuração automatizada, ele adiciona à variável PATH o caminho da pasta do PHP. Para isso é preciso que a instalação seja feita por um administrador. Você pode confirmar se a pasta do PHP está ou não na variável de ambiente PATH indo nas propriedades do “Meu computador“, guia “Avançado“, botão “Variáveis de ambiente“:

Veja que a pasta do PHP foi adicionada automaticamente à variável PATH

Estando com o php.ini em uma pasta definida na variável de ambiente PATH (se não estiver, copie-o para a pasta do Windows), vamos editá-lo. Abra-o num editor de textos puro (por padrão ele fica na pasta do PHP).

Uma configuração útil é ativar o uso dos delimitadores <? ... ?>, muito usados, por serem mais simples. No php.ini localize a linha que começa com “short_open_tag“, e troque o Off por On (cuidado com as letras maiúsculas e minúsculas!). Ela deverá ficar:

short_open_tag = On

Sem fazer isso (se deixar Off), os scripts iniciados com <? não serão identificados como scripts PHP, mas apenas os que iniciarem com <?php ou <script language="php">. Aproveitando, você pode definir “On” para a linha mais abaixo, “asp_tags“, para permitir que os scripts que usem os delimitadores <% e %> sejam executados, caso esteja acostumado com ASP e prefira utilizar esta forma.

O php.ini vem bem comentado (em inglês), role a tela e leia-o com calma, para ver o que você pode alterar. É ideal ter conhecimentos avançados de PHP para alterá-lo por conta, e não se esqueça de manter um backup a cada alteração. No final da segunda parte deste tutorial comentarei sobre outras configurações necessárias a serem feitas no php.ini, para que os scripts PHP funcionem corretamente com os recursos mais usados.