Instalação para Apache 2.x em sistemas Windows
Esta seção contém notas e dicas específicas para instalações do Apache 2.x
do PHP em sistemas Microsoft Windows.
Nota:
Por favor, leia o manual
das etapas de instalação primeiro!.
É altamente recomendável consultar a
» Documentação Apache
para obter uma compreensão básica do servidor Apache 2.x
Considere, também, a leitura das
» notas específicas do Windows
para Apache 2.x antes de continuar.
Baixa a versão mais recente do
» Apache 2.x
e uma versão adequada do PHP. Siga os
passos do manual de instalação
e volte para prosseguir com a integração do PHP com o Apache.
Existem três maneiras de configurar o PHP para funcionar com o Apache 2.x no Windows.
O PHP pode ser executado como um controlador, como um CGI ou em FastCGI.
Nota: Lembre-se que ao adicionar
caminhos nos arquivos de configuração do Apache no Windows, todas as barras invertidas
como em c:\diretorio\arquivo.ext devem ser convertidas para
barras: c:/diretorio/arquivo.ext. Uma barra
final também pode ser necessária para diretórios.
Instalando como um controlador Apache
Nota:
Ao usar o SAPI apache2handler SAPI, a versão segura para Threads (TS) do
PHP precisa ser usada.
Para carregar o módulo PHP para Apache 2.x, as seguintes linhas no
arquivo de configuração Apache httpd.conf precisam ser inseridas:
Exemplo #1 PHP e Apache 2.x como controlador
# antes do PHP 8.0.0 o nome do módulo era php7_module
LoadModule php_module "c:/php/php8apache2_4.dll"
<FilesMatch \.php$>
SetHandler application/x-httpd-php
</FilesMatch>
# configure caminho para php.ini
PHPIniDir "C:/php"
Nota:
O caminho correto do PHP precisa ser substituído em vez de
C:/php/ nos exemplos acima.
Certifique-se de que o arquivo referenciado na diretiva LoadModule está no
local especificado. Use php7apache2_4.dll
para PHP 7, ou php8apache2_4.dll para PHP 8.
Executando PHP como CGI
É altamente recomendável consultar a
» documentação Apache CGI
para uma compreensão mais completa da execução de CGI no Apache.
Para executar o PHP como CGI, os arquivos php-cgi precisarão ser colocados em um
diretório designado como um diretório CGI usando a diretiva ScriptAlias.
Uma linha iniciada com #! precisará ser colocada nos arquivos PHP
que apontam para a localização do binário do PHP:
Exemplo #2 PHP e Apache 2.x como CGI
#!C:/php/php.exe
<?php
phpinfo();
?>
AvisoUm servidor instalado em modo CGI está aberto
a várias vulnerabilidades possíveis. Leia nossa
seção de segurança CGI para aprender como
se defender de tais ataques.
Executando PHP sobre FastCGI
Executar o PHP no FastCGI tem uma série de vantagens sobre executá-lo como um
CGI. Configurá-lo dessa forma é bastante simples:
Baixe mod_fcgid de
» https://www.apachelounge.com.
Os binários do Win32 estão disponíveis para download neste site.
Instale o módulo de acordo com as instruções que o acompanham.
Configure o servidor web conforme mostrado abaixo, tendo o cuidado de ajustar quaisquer caminhos
para refletir ele está instalado no sistema:
Exemplo #3 Configurando o Apache para executar o PHP como FastCGI
LoadModule fcgid_module modules/mod_fcgid.so
# Onde está o arquivo php.ini?
FcgidInitialEnv PHPRC "c:/php"
<FilesMatch \.php$>
SetHandler fcgid-script
</FilesMatch>
FcgidWrapper "c:/php/php-cgi.exe" .php
Arquivos com extensão
.php agora serão executados pelo empacotador PHP
FastCGI.
