corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

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.

Conteúdo

O conteúdo desta página se aplica ao IDE NetBeans 6.5

Para seguir este tutorial, você precisa dos seguintes recursos e softwares.

Software ou recurso Versão necessária
NetBeans IDE Pacote de download do PHP
Um mecanismo PHP Versão 5. Incluído no XAMPP-Windows.
Um servidor Web É recomendado o Apache HTTP Server 2.2.
Incluído no XAMPP do Windows.
Um servidor de banco de dados MySQL Server 5.0 é o recomendável.
Incluído no XAMPP do Windows.
Um depurador do PHP (opcional) XDebug 2.0 ou posterior.

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.

É possível utilizar um pacote que contenha o software necessário ou instalar cada componente separadamente.

Utilizando um pacote AMP

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.

  1. Baixe o pacote de instalação do XAMPP. (O XAMPP Lite não inclui o XDebug.)
  2. 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.

  3. 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.
  4. 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).
  5. 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.

    Painel de controle do XAMPP
  6. 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

  1. Execute o navegador e insira a seguinte URL: http://localhost. A página de boas-vindas do XAMPP é aberta:
    A página de boas-vindas do XAMPP indica que o Apache está sendo executado
  2. 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.
    Tabela de informações de configuração retornada por phpinfo()

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.

Muitos usuários têm tido dificuldades para fazer com que o XDebug funcione em seus sistemas. Consulte a nossa wiki e o Fórum de usuários do Editor PHP do NetBeans para obter ajuda.

XDebug no XAMPP 1.7.1 (PHP 5.2)

É 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.

  1. Baixe thread-safe XDebug 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.)
  2. 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.
  3. 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):
    [Zend]
    ;zend_extension_ts = "C:\Program Files\xampp\php\zendOptimizer\lib\ZendExtensionManager.dll"
    ;zend_extension_manager.optimizer_ts = "C:\Program Files\xampplite\php\zendOptimizer\lib\Optimizer"
    ;zend_optimizer.enable_loader = 0
    ;zend_optimizer.optimization_level=15
    ;zend_optimizer.license_path =
    
  4. 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

  5. Salve o php.ini.
  6. Execute o Aplicativo painel de controle do XAMPP e reinicie o servidor Apache.
Consulte nosso wiki e a documentação do XDebug para obter mais informações sobre como configurar o XDebug.

Xdebug no XAMPP 1.7.2 (PHP 5.3)

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.

  1. Localize e abra o XAMPP_HOME\php\php.ini para edição. Trata-se do único arquivo php.ini no XAMPP 1.7.2.
  2. Localize e elimine o comentário da linha zend_extension = "XAMPP_HOME\php\ext\php_xdebug.dll".
  3. 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.
  4. Localize e elimine o comentário da linha xdebug.remote_enable=0. Altere de 0 a 1.
  5. Localize e elimine o comentário da linha xdebug.remote_handler="dbgp".
  6. Localize e elimine o comentário da linha xdebug.remote_port= 9000.
  7. Salve o php.ini.
  8. Execute o Aplicativo painel de controle do XAMPP e reinicie o servidor Apache.

Consulte nosso wiki e a documentação do XDebug para obter mais informações sobre como configurar o XDebug.

Instalando os componentes separadamente

Servidor HTTP Apache

  1. Baixe o servidor HTTP Apache2.
  2. 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.

  3. Quando a instalação estiver concluída, reinicie o servidor Apache.
  4. 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:
    A página de teste do servidor Web Apache indica que o Apache está sendo executado

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:
  1. 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\
  2. Localize a linha Listen 80 e altere o número da porta, por exemplo, 8080. Salve o arquivo.
  3. Reinicie o servidor Web Apache.
  4. 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.

Mecanismo PHP

  1. Baixe o Mecanismo PHP5.
  2. Quando o download estiver concluído, execute o arquivo de instalação .msi. O assistente de instalação é iniciado.
  3. 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.
  4. 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.
  5. Depois que a instalação estiver concluída, reinicie o servidor Apache.
  6. 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:
      A página de teste do PHP indica que o mecanismo PHP está habilitado

Solução de problemas

Se a página não abrir:
  1. Reinicie o servidor Apache.
  2. Verifique se o arquivo de configuração do servidor Apache httpd.conf contém as seguintes linhas:
      AddType Application/x-httpd-php .php 
      LoadModule php5_module "c:/php/sapi/php5apache2_2.dll"
  3. Se as linhas estiverem ausentes, adicione-as, salve o httpd.conf e reinicie o Apache.
  4. Atualize a página http://localhost:<porta>/test.php.

Servidor de banco de dados MySQL

Encontre informações detalhadas sobre como instalar e configurar o servidor de banco de dados MySQL.

XDebug

  1. Baixe o XDebug.
  2. Instale o XDebug na pasta php/. Você precisará do caminho para a mesma para configurar o ambiente.

Configurando o ambiente

  1. Se a sua instalação seguir as configurações padrão, o processamento do PHP será habilitado automaticamente.
  2. 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:

  3. 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.

  4. Certifique-se de que o mecanismo PHP instalado anteriormente suporta a utilização do servidor de banco de dados MySQL:
    1. Clique em Iniciar > Painel de controle.
    2. No Painel de controle, escolha Adicionar ou remover programas.
    3. 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.
    4. No painel Alterar, reparar ou remover instalação, escolha Alterar e clique em Próximo.
    5. 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.
    6. 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.
    7. No painel Escolher itens para instalar, expanda o nó Extensões e escolha os itens MySQL e MySQLi. Clique em Próximo.
    8. No painel Pronto para alterar PHP <número de versão>, clique em Alterar.
    9. 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 .

Voltar à trilha do aprendizado PHP