Configurando o ambiente de desenvolvimento de PHP no Windows
Este tutorial mostra duas formas de configurar o ambiente de desenvolvimento de PHP no sistema operacional Windows. A primeira e mais conveniente é instalar e configurar um pacote AMP (Apache, MySQL, PHP). Este tutorial mostra como instalar o pacote XAMPP. A segunda maneira, é instalar e configurar cada componente separadamente.
Geralmente, o desenvolvimento e a depuração são realizados em um servidor Web local, enquanto o ambiente de produção está localizado em um servidor Web remoto. A configuração de um servidor Web remoto está descrita em Implantado um aplicativo PHP em um servidor Web remoto utilizando o NetBeans IDE. Este tutorial ensina como configurar um servidor Web local. O suporte PHP pode ser adicionado a vários servidores Web locais (IIS, Xitami e assim por diante), mas, em geral, é utilizado o servidor HTTP Apache. O servidor HTTP Apache está incluído no pacote AMP do XAMPP utilizado neste tutorial. Para obter informações sobre como instalar e configurar o servidor HTTP Apache independente, clique aqui.
Software necessário
Para criar, executar e depurar os projetos PHP, você precisa do seguinte software:
NetBeans IDE para PHP. Os downloads estão disponíveis aqui.
Um servidor Web. Geralmente, o desenvolvimento e a depuração são realizados em um servidor Web local, enquanto o ambiente de produção está localizado em um servidor Web remoto. A versão atual permite a utilização de um servidor local. A utilização de um servidor remoto com acesso a FTP terá suporte em versões futuras. O suporte a PHP pode ser adicionado a vários servidores Web (IIS, Xitami e assim por diante), mas, em geral, o servidor HTTP Apache é utilizado. Clique aqui para obter informações sobre como instalar e configurar o Apache 2.2.
O mecanismo PHP. A versão com suporte é o PHP5. Os downloads estão disponíveis aqui.
O depurador do PHP. O NetBeans IDE para PHP permite que você utilize o XDebug, mas a utilização de um depurador é opcional. A versão recomendada é XDebug 2.0 ou superior, pois é compatível com PHP5.
Um servidor de banco de dados. É possível utilizar vários servidores de bancos de dados, embora um dos mais populares seja o MySQL. Os downloads estão disponíveis aqui. Nota: a versão recomendada do produto é a MySQL Server 5.0. Os documentos fornecidos descrevem o trabalho dessa versão.
Após a instalação, você precisa configurar o ambiente de forma que todos os componentes de software funcionem adequadamente entre si.
Para que todas as definições de configuração do mecanismo PHP, do servidor HTTP Apache e do servidor de banco de dados MySQL sejam especificadas automaticamente, utilize o pacote AMP. Este tutorial fornece instruções somente para o pacote XAMPP-Windows. Para obter ajuda com o pacote WAMP, consulte a wiki do XDebug do NetBeans.
Instalando e configurando o pacote XAMPP
A seção descreve como baixar, instalar e configurar o pacote XAMPP
Aviso: NÃO utilize o XAMPP 1.7.0. Há significativos problemas com o XDebug nessa versão. Use a versão 1.7.1 ou posterior, onde estes problemas foram corrigidos.
Nota: a partir do XAMPP 1.7.2, o XAMPP vem com PHP 5.3, não PHP 5.2.x. O NetBeans IDE para PHP, versão 6.7.x, não oferece suporte às novas funções do PHP 5.3. O NetBeans IDE para PHP 6.8, disponível atualmente como uma construção de desenvolvimento, oferece suporte completo ao PHP 5.3. Observe também que a instalação do Xdebug é diferente no PHP 5.2.x e PHP 5.3.
Baixe o pacote de instalação do XAMPP. (O XAMPP Lite não inclui o XDebug.)
Quando o download for concluído, execute o arquivo .exe .
No Microsoft Vista, o recurso Controle de acesso do usuário impede que o instalador do PHP atualize a configuração do HTTP Apache. Desabilite o UAC ao instalar o XAMPP. Consulte o suporte da Microsoft para obter mais informações.
Você tem a opção de instalar o servidor Apache e o servidor do banco de dados MySQL como serviços. Se instalar o servidor Apache e MySQL como serviços, não terá que iniciar manualmente os mesmos através do Painel de controle do XAMPP. Observe que você tem a opção de instalar e desinstalar estes serviços no Painel de controle do XAMPP.
Se estiver utilizando o arquivo autoextraível, após o arquivo ser extraído, execute o arquivo setup-xampp.bat para configurar os componentes do pacote. (O instalador do XAMPP executa automaticamente o arquivo).
Após configurar, abra o Painel de controle do XAMP. (É possível abri-lo manualmente ao executar o arquivo XAMPP_HOME/xampp-control.exe ou a partir do ícone Painel de controle do Xampp, que é automaticamente colocado em sua área de trabalho.) Ao abrir o Painel de controle do XAMPP, observe que os módulos instalados como serviços já estão em execução.
Aviso: algumas vezes, no Windows Vista, o xampp-control.exe não será executado. No lugar dele, você pode executar o xampp-start.exe.
Aviso: o arquivo winmysqladmin.exe, que é iniciado pelo botão Admin para o MySQL, não funciona. Aparece uma sequência de mensagens de erro, que pode ser parada somente de forma manual terminando o processo winmysqladmin. Você também não pode iniciar o winmysqladmin.exe a partir da linha de comando. Consulte http://bugs.xampp.org/view.php?id=71.
As caixas de verificação Svc indicam que um módulo está instalado como um serviço do Windows e será automaticamente iniciado na inicialização do sistema. É possível instalar ou desinstalar os serviços do Windows ao marcar ou desmarcar a caixa de verificação Svc. A desinstalação de um serviço do Windows não desinstala o módulo, mas requer a inicialização manual do módulo. O Painel de controle do XAMPP inclui botões para parar e iniciar módulos e para abrir seus consoles de administração.
Verificando a instalação do XAMPP
Execute o navegador e insira a seguinte URL: http://localhost. A página de boas-vindas do XAMPP é aberta:
Para garantir que os servidores Apache e MySQL foram instalados como serviços do sistema, reinicie o sistema operacional, execute o navegador e insira a URL http://localhost novamente. A página de boas-vindas do XAMPP é aberta. Observe se a página de boas-vindas do XAMPP inclui um menu na margem esquerda através do qual você pode verificar o status dos componentes do XAMPP e executar o phpinfo(), entre outros recursos úteis. phpinfo() retorna uma tela com informações de configuração sobre os componentes do XAMPP.
Instalando e habilitando o depurador XDebug
É necessário configurar a pilha PHP para utilizar o XDebug. Se você estiver utilizando o XAMPP 1.7.1, com PHP 5.2.6, ou o XAMPP 1.7.2, com PHP 5.3 o processo apresenta diferenças.
É necessário baixar o XDebug, colocar o arquivo .dll no diretório das extensões php e configurar php.ini para que localize e utilize esse arquivo.
Baixe thread-safeXDebug mais recente compatível com sua versão do PHP. Os links para download são listados em Versões. Copie o arquivo .dll em seu diretório XAMP_HOME/php/ext. (XAMPP_HOME se refere ao seu diretório de instalação do XAMPP ou do XAMPP Lite, como C:\Arquivos de programas\xampp ou C:\xampplite.)
Localize e abra o arquivo php.ini ativo para seu XAMPP. Ele está localizado por padrão no diretório XAMPP_HOME/apache/bin. Confirme qual arquivo php.ini está ativo executando phpinfo() e pesquisando pelo Arquivo de configuração carregado.
Como o otimizador Zend bloqueia o XDebug, é necessário desabilitar o otimizador Zend. No arquivo php.ini ativo, localize as linhas e as exclua ou as marque como comentários (para estar seguro, procure e marque como comentário todas as propriedades relativas ao Zend):
Para anexar XDebug ao mecanismo PHP, remova o comentário das linhas a seguir nos arquivos php.ini (diretamente abaixo da seção [Zend], adicione-os caso não estejam presentes). Algumas notas adicionais foram acrescentadas.
[XDebug] ; Only Zend OR (!) XDebug
zend_extension_ts = "./php/ext/php_xdebug<-version-number>.dll"
; XAMPP and XAMPP Lite 1.7.0 and later come with a bundled xdebug at <XAMPP_HOME>/php/ext/php_xdebug.dll, without a version number. xdebug.remote_enable=1 xdebug.remote_host=127.0.0.1 xdebug.remote_port=9000
; Port number must match debugger port number in NetBeans IDE Tools > Options > PHP xdebug.remote_handler=dbgp xdebug.profiler_enable=1 xdebug.profiler_output_dir="<XAMPP_HOME>\tmp"
Defina a propriedade xdebug.remote_enable como 1, não "true" ou qualquer outro valor.
Nota: certifique-se de que os caminhos especificados coincidam com o local dos arquivos correspondentes conforme determinado durante a instalação
O XAMPP 1.7.2 vem embutido com o arquivo .dll apropriado do Xdebug. É somente necessário configurar o php.ini para utilizar esse arquivo. Observe que todas as configurações do Xdebug apresenta um texto explicativo.
Localize e abra o XAMPP_HOME\php\php.ini para edição. Trata-se do único arquivo php.ini no XAMPP 1.7.2.
Localize e elimine o comentário da linha zend_extension = "XAMPP_HOME\php\ext\php_xdebug.dll".
Localize e elimine o comentário da linha xdebug.remote_host=localhost. Altere o valor da configuração de localhost para 127.0.0.1.
Localize e elimine o comentário da linha xdebug.remote_enable=0. Altere de 0 a 1.
Localize e elimine o comentário da linha xdebug.remote_handler="dbgp".
Localize e elimine o comentário da linha xdebug.remote_port= 9000.
Execute o arquivo de instalação .msi. O assistente de instalação é iniciado. Siga as instruções.
No Microsoft Vista, não instale o servidor Apache na localização padrão, que é Arquivo de programas. Todos os arquivos em Arquivos de programas estão protegidos contra gravação.
Quando a instalação estiver concluída, reinicie o servidor Apache.
Para verificar se a instalação foi bem-sucedida, execute o navegador e insira a seguinte URL:
http://localhost/
A página de teste de boas-vindas do Apache é aberta:
Solução de problemas
Como padrão, o servidor Apache ouve a porta 80. Essa porta pode já estar sendo utilizada por outros serviços, por exemplo, o Skype. Para solucionar o problema, altere a porta que o servidor escuta:
Abra o arquivo de configuração do servidor Web Apache httpd.conf. Por padrão, o arquivo está localizado em C:\Arquivos de Programas\Apache Software Foundation\Apache<versão>\conf\
Localize a linha Listen 80 e altere o número da porta, por exemplo, 8080. Salve o arquivo.
Reinicie o servidor Web Apache.
Para verificar se o servidor Web está funcionando, execute o navegador, insira a URL e especifique o número da porta de forma explícita: http://localhost:8080
Também é possível interromper os processos que possivelmente ouvem a porta 80. No Gerenciador de tarefas, selecione o nome de arquivo relevante e clique em Encerrar processo.
Encontre mais informações sobre como instalar e configurar o servidor aqui.
Quando o download estiver concluído, execute o arquivo de instalação .msi. O assistente de instalação é iniciado.
No painel Diretório de configuração Apache, especifique o diretório onde o arquivo httpd.conf está localizado, a configuração padrão é C:\Arquivos de Programas\Apache Software Foundation\Apache<versão>\conf\. O processamento do PHP será habilitado automaticamente.
Se você desejar utilizar o servidor de banco de dados MySQL, escolha a opção de instalação Completa ou selecione os itens MySQL e MySQLi na lista Extensões.
Depois que a instalação estiver concluída, reinicie o servidor Apache.
Para verificar se o mecanismo PHP foi instalado com êxito e o processamento do PHP foi habilitado na configuração do Apache:
No Bloco de notas, crie um arquivo e digite o seguinte texto:
<?php
echo "O PHP foi instalado com êxito!";
?>
Salve o arquivo na pasta htdocs: C:\Arquivos de programas\Apache Software Foundation\Apache<versão>\htdocs\test.php
Execute o navegador e insira a seguinte URL: http://localhost:<porta>/test.php. A seguinte página é aberta:
Solução de problemas
Se a página não abrir:
Reinicie o servidor Apache.
Verifique se o arquivo de configuração do servidor Apache httpd.conf contém as seguintes linhas:
Instale o XDebug na pasta php/. Você precisará do caminho para a mesma para configurar o ambiente.
Configurando o ambiente
Se a sua instalação seguir as configurações padrão, o processamento do PHP será habilitado automaticamente.
Para anexar o XDebug ao mecanismo PHP, localize o arquivo php.ini e adicione as seguintes linhas ao mesmo:
Para um mecanismo PHP 5.2 thread-safe:
zend_extension_ts="<path to the php folder>/php_xdebug-<version-number>.dll"
xdebug.remote_enable=1
Para um mecanismo PHP 5.2 non-thread-safe:
zend_extension_nts="<path to the php folder>/php_xdebug-<version-number>.dll"
xdebug.remote_enable=1
Para qualquer mecanismo PHP 5.3:
zend_extension="<path to the php folder>/php_xdebug-<version-number>.dll"
xdebug.remote_enable=1
Alguns usuários observam que podem precisar incluir as seguintes linhas, embora outros usuários não:
xdebug.remote_host=127.0.0.1 xdebug.remote_port=9000
; Port number must match debugger port number in NetBeans IDE Tools > Options > PHP xdebug.remote_handler=dbgp
Clique aqui para obter mais informações sobre como configurar o XDebug.
Nota: certifique-se de que os caminhos especificados coincidam os nomes e os locais dos arquivos correspondentes como determinado durante a instalação.
Certifique-se de que o mecanismo PHP instalado anteriormente suporta a utilização do servidor de banco de dados MySQL:
Clique em Iniciar > Painel de controle.
No Painel de controle, escolha Adicionar ou remover programas.
No painel Adicionar ou remover programas, selecione a área PHP <número de versão> e clique em Alterar. O assistente Configuração do PHP é iniciado. Clique em Próximo.
No painel Alterar, reparar ou remover instalação, escolha Alterar e clique em Próximo.
No painel Configuração do servidor Web, escolha a versão do servidor Apache: no nosso exemplo é o módulo Apache 2.2.x. Clique em Próximo.
No painel Diretório de configuração do Apache, especifique o diretório onde o arquivo de configuração do Apache httpd.conf está localizado. Clique em Próximo.
No painel Escolher itens para instalar, expanda o nó Extensões e escolha os itens MySQL e MySQLi. Clique em Próximo.
No painel Pronto para alterar PHP <número de versão>, clique em Alterar.
No painel Assistente de configuração do PHP <número de versão> concluído, clique em Terminar.
Para enviar comentários e sugestões, obter suporte e manter-se informado sobre os desenvolvimentos mais recentes dos recursos de desenvolvimento em PHP no NetBeans IDE, junte-se à lista de usuários .