corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

Configurando um projeto PHP

Este tutorial mostra como configurar um projeto PHP no NetBeans IDE.

Conteúdo

O conteúdo desta página se aplica ao NetBeans IDE 6.7 e posterior

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
Um servidor Web É recomendado o Apache HTTP Server 2.2.
Um depurador PHP XDebug 2.0 ou posterior

Preparação

Antes de criar um projeto PHP, você precisa baixar e instalar o NetBeans IDE para PHP e preparar o seu ambiente para desenvolvimento de PHP.

Para configurar um projeto PHP:

Para alterar as configurações de um projeto existente, posicione o cursor no nó do projeto e escolha Propriedades do menu pop-up. Prossiga como descrito na seçãoPersonalizando a configuração do projeto.

Especificando o nome do projeto e a localização dos arquivos de código-fonte

  1. Inicie o IDE e alterne para a janela Projetos.
  2. Escolha Arquivo > Novo projeto. O painel Escolher projeto se abre.
  3. Na lista Categorias, escolha PHP.

Dependendo das suas necessidades, você pode criar um projeto PHP totalmente novo sem quaisquer arquivos de código-fonte desenvolvidos anteriormente ou importar um aplicativo PHP local ou remoto existente para um novo projeto.

Projeto sem arquivos de código-fonte desenvolvidos anteriormente

  1. Na área Projetos, escolha Aplicativo PHP e clique em Próximo. O painel Novo projeto PHP > Nome e localização se abre.
  2. No campo de texto Nome do projeto, indique o nome do projeto.
  3. No campo Pasta de códigos-fonte, especifique a subpasta da raiz do documento em que você deseja armazenar os arquivos de código-fonte.

    A raiz do documento é a pasta em que o servidor Web local procura pelos arquivos a serem abertos no navegador. A raiz do documento é especificada no arquivo de configuração do servidor Web. Após a instalação, o Assistente para Novo projeto localiza a raiz do documento e por padrão especifica o seguinte caminho: <Raiz do documento>\<Novo projeto PHP>.

    Uma cópia dos arquivos de código-fonte deve ser mantida em uma subpasta da raiz do documento. Entretanto, você pode ter uma Pasta de códigos-fonte em um local diferente da raiz do documento e copiar os arquivos de código-fonte desse local para a raiz do documento. Consulte Especificando a configuração de execução.

  4. Na lista suspensa Codificação padrão, escolha a codificação padrão do seu projeto.
  5. Se você desejar armazenar metadados do NetBeans em um local diferente dos seus arquivos de código-fonte, selecione "Colocar metadados do NetBeans em um diretório separado". Por exemplo, você pode querer armazenar seus códigos-fonte na raiz do documento mas os metadados do NetBeans no diretório Projetos do NetBeans.
    Painel Novo projeto PHP com os campos preenchidos
  6. Clique em Próximo. O painel Configuração de execução se abre.

Importando arquivos locais de código-fonte existentes para um projeto

  1. Na área Projetos, escolha Aplicativo PHP com Códigos-fonte existentes e clique em Próximo. O painel Novo projeto PHP > Nome e localização se abre.
  2. No campo de texto Nome do projeto, indique o nome do projeto.
  3. No campo Pasta de códigos-fonte, especifique a pasta da qual você deseja importar os arquivos de código-fonte.
    Observação: Se você for executar o projeto em um servidor Web local, não se esqueça de especificar a cópia dos arquivos de código-fonte para ele.
  4. Na lista suspensa Codificação padrão, escolha a codificação padrão do seu projeto.
  5. Se você desejar armazenar metadados do NetBeans em um local diferente dos seus arquivos de código-fonte, selecione "Colocar metadados do NetBeans em um diretório separado". Por exemplo, você pode querer armazenar seus códigos-fonte na raiz do documento mas os metadados do NetBeans no diretório Projetos do NetBeans.
    Painel Novo projeto PHP com os campos de códigos-fonte existentes preenchidos
  6. Clique em Próximo. O painel Configuração de execução se abre.

Importando arquivos remotos de código-fonte existentes para um projeto

  1. Na área Projetos, escolha Aplicativo PHP do servidor remoto e clique em Próximo. O painel Novo projeto PHP > Nome e localização se abre.
  2. No campo de texto Nome do projeto, indique o nome do projeto.
  3. No campo Pasta de códigos-fonte, especifique a subpasta da raiz do documento em que você deseja armazenar os arquivos de código-fonte.

    A raiz do documento é a pasta em que o servidor Web local procura pelos arquivos a serem abertos no navegador. A raiz do documento é especificada no arquivo de configuração do servidor da Web. Após a instalação, o Assistente para Novo projeto localiza a raiz do documento e por padrão especifica o seguinte caminho: <Raiz do documento>\<Novo projeto PHP>. Observe que é útil ter a capacidade de testar o projeto em um servidor local.

  4. Se você desejar armazenar metadados do NetBeans em um local diferente dos seus arquivos de código-fonte, selecione "Colocar metadados do NetBeans em um diretório separado". Por exemplo, você pode querer armazenar seus códigos-fonte na raiz do documento mas os metadados do NetBeans no diretório Projetos do NetBeans.
  5. Clique em Próximo. Abre-se o painel de Conexão remota. O tutorial Implantando de um aplicativo PHP em um servidor Web remoto descreve como configurar conexões remotas.

Especificando a configuração de execução padrão do novo projeto

Uma configuração de execução é uma configuração armazenada para executar um projeto PHP. Você pode definir várias configurações para um projeto e alternar entre elas para frente e para trás. Por exemplo, se um aplicativo tiver sido desenvolvido localmente e precisar ser carregado em um servidor de produção remoto, você só precisará escolher outra configuração de execução. As configurações de execução se aplicam a execução e depuração. As configurações de execução acomodam os seguintes casos de uso mais comuns:

  • Desenvolvimento de páginas da Web do PHP em uma máquina local com um servidor Web local.
  • Execução de scripts de PHP usando um mecanismo PHP local. Essa abordagem é aplicada em arquivos PHP não direcionados a resultados em HTML. Entretanto, tais scripts podem ser executados sem um navegador.
  • Desenvolvimento remoto. O código-fonte do PHP e outros arquivos de aplicativo são carregados para um servidor Web remoto através de FTP. Esse caso de uso é comum quando o desenvolvimento é compartilhado entre várias pessoas.
  • Uma combinação dos casos de uso acima: um aplicativo é desenvolvido localmente e implantado em um servidor de produção remoto após a conclusão. Durante o desenvolvimento, os scripts do PHP são executados, se necessário.

Ao criar um novo projeto PHP, você cria uma configuração de execução padrão do projeto. Para definir a configuração de execução padrão para o projeto, escolha a opção relevante na lista suspensa Executar como no painel Configuração de execução. As seguintes opções estão disponíveis:

O procedimento para a criação de configurações de execução adicionais ou de edição da configuração de execução padrão é descrita em Personalizando a configuração do projeto: configuração de execução. É muito semelhante ao processo da criação de configuração de execução padrão, a não ser pela caixa de diálogo Propriedades do projeto existente que é usada em vez do novo assistente para novo projeto.

Site da Web local

Uma configuração de site da web que envolve uma cópia das suas pastas de código-fonte PHP na pasta da web do servidor da web Apache instalado na máquina. É comum a prática para que um projeto tenha uma configuração do site da web remota e outra local. Observe que o procedimento de definição da configuração de execução do site da web é diferente, dependendo da criação do projeto com ou sem códigos-fonte existentes.

Para configurar um site da Web local:

  1. Na lista suspensa Executar como, escolha Site da Web local.
  2. No campo URL do projeto, verifique o endereço da URL gerada automaticamente. Verifique se o servidor Apache HTTP ouve a porta padrão 80. Caso contrário, especifique explicitamente o número da porta no formato localhost:<número da porta>.
    Configuração de execução do projeto: servidor Web local
  3. Se você estiver criando um projeto de códigos-fonte existentes, é possível selecionar qual arquivo de código-fonte usar como o arquivo de índice.
  4. Para armazenar os arquivos de código-fonte do projeto em um diretório diferente do projeto NetBeans IDE, selecione “Copiar arquivos da pasta de códigos-fonte para outro local”. Se você criar um projeto de códigos-fonte existentes, essa é uma etapa necessária, a não ser que as fontes existentes já estejam na pasta da web do servidor Apache.
    O campo, por padrão, especifica o seguinte caminho: <Raiz do documento>\<Novo projeto PHP>. Se necessário, use o botão Explorar para especificar um caminho diferente.
    A raiz do documento é a pasta em que o servidor Web procura por arquivos a serem abertos no navegador. A raiz do documento é especificada no arquivo de configuração do servidor Web.
    O assistente detecta o tipo de instalação do Apache, um componente ou um pacote, e fornece o caminho para a localização padrão da pasta htdocs do tipo de instalação atual. Portanto, se você aceitou as configurações padrão durante a instalação do servidor Apache ou do pacote AMP, escolha o caminho na lista suspensa.
  5. Clique em Terminar. O IDE cria o projeto PHP.

Site da Web remoto

Veja o tutorial Implantando um aplicativo PHP a um servidor Web remoto.

Script

  1. Na lista suspensa Executar como, escolha Script.
    Caixa de diálogo Propriedades do projeto exibindo propriedades de Configuração de Execução com Script Executar como... selecionado
  2. Para especificar a localização do mecanismo PHP, clique no botão Configurar ao lado da caixa Interpretador do PHP Usar Padrão. A caixa de diálogo de opções do PHP abre na guia Geral.
    Configuração de execução do projeto: Script. Especificando o caminho para o mecanismo PHP e o local de saída
  3. No campo Interpretador do PHP 5, especifique o caminho para o arquivo php.exe. Use o botão Explorar ou pesquisar..., se necessário.
  4. Para especificar como os resultados da execução do script serão mostrados, marque a caixa de verificação relevante na área Abrir resultado em. As seguintes opções estão disponíveis:

    • Janela de saída. Os resultados da execução de um script aparecerão na janela de saída na parte inferior da janela do NetBeans IDE.
    • Navegador da Web. A janela do navegador padrão se abrirá com os resultados da execução de um script no formato de um arquivo HTML.
    • Editor. Os resultados da execução de um script se abrirão como um arquivo HTML na janela do editor do IDE.
  5. Clique em OK. A caixa de diálogo Opções se fecha e o sistema retorna para o painel Configuração de execução.
  6. Adicionar qualquer argumento, como debug=true e qualquer opção de comando de linha PHP.

Personalizando a configuração do projeto

Durante a criação do projeto, as configurações básicas do projeto são definidas: o tipo do projeto, o local dos arquivos de código-fonte do projeto e a configuração de execução padrão. Para expandir a configuração do projeto com novas definições, personalize o projeto. Posicione o cursor no nó do projeto e escolha Propriedades do menu pop-up. O painel Propriedades do projeto é aberto com uma lista de categorias de configurações.

Códigos-fonte


No painel Códigos-fonte:
  1. O campo Raiz da Web mostra a pasta raiz do site do seu aplicativo. Por padrão, o campo mostra a pasta Códigos-fonte. Para alterar a raiz da Web, clique em Explorar e selecione outra pasta.
  2. Selecione Copiar arquivos da pasta de códigos-fonte para outra localização, se necessário, e especifique o caminho para a pasta de armazenamento.
  3. Altere a codificação, se necessário
    Gerenciando a configuração do projeto: caixa de diálogo Propriedades do projeto
  4. Para concluir a personalização do projeto, clique em OK.

Configuração de execução


No painel Configuração de execução, modifique a configuração de execução padrão e/ou defina novas configurações de execução, se necessário.
  1. Para modificar as configurações padrão, atualize os campos como durante a criação do projeto.
  2. Para definir uma nova configuração de execução, clique em Próximo ao lado da lista suspensa Configuração. A caixa de diálogo Criar nova configuração se abre.
  3. No campo Nome da configuração, indique o nome da nova configuração de execução e clique em OK. Você retorna para o painel Configuração de execução.
  4. Defina as definições da configuração de execução da mesma forma que definiu a configuração de execução padrão durante a criação do projeto e clique em OK. A nova configuração é adicionada à lista suspensa Configuração.
  5. Para remover uma configuração, selecione-a na lista suspensa Configuração e clique em Excluir.
    Gerenciando a configuração do projeto: configuração de execução
  6. Para concluir a personalização do projeto, clique em OK.

Caminho de inclusão do PHP


No painel Caminho de inclusão, especifique a localização dos arquivos que você precisa usar no projeto, mas não precisa colocar junto com os arquivos de código-fonte.
  1. Para adicionar uma pasta, clique em Adicionar pasta. A caixa de diálogo Selecionar pasta(s) se abre.
  2. Selecione as pastas relevantes e clique em Abrir. Você retorna para o painel Caminho de inclusão do PHP. A nova pasta é adicionada à lista.
  3. Para navegar pela lista, use os botões Mover para cima e Mover para baixo.
  4. Para remover uma pasta da lista de pastas incluída, selecione a pasta e clique em Remover.
    Gerenciando a configuração do projeto: Caminho de inclusão do PHP
  5. Para concluir a personalização do projeto, clique em OK.

Formatação

No painel Formatação, defina o estilo de formatação que deseja aplicar aos arquivos de código-fonte no editor. É possível definir se a formatação é global ou específica de projeto.

Para definir a formatação global do IDE:

  1. Selecionar opções globais.
  2. Editar opções globais. A caixa de diálogo de opções do IDE abre na guia Editor > Formatação.
    Caixa de diálogo Formatação global
  3. Da lista suspensa Linguagem, selecione a linguagem na qual as configurações devem ser aplicadas.
  4. Da lista suspensa Categorias, selecione os itens de formato nos quais a configuração será aplicada.
  5. Defina sua formatação desejada e clique em OK.
  6. Clique no botão Ajuda para obter informações detalhadas.

Para definir um projeto com formatação específica de projeto:

  1. Selecione “Usar opções específicas de um projeto". A área oculta é exibida. Gerenciando a configuração do projeto: formatação
  2. Da lista suspensa Linguagem, selecione Todas as linguagens ou PHP. Nesse caso, Todas as linguagens é o PHP e todas as outras linguagens do projeto PHP.
  3. Da lista suspensa Categorias, selecione os itens de formato nos quais a configuração será aplicada.
  4. Defina sua formatação desejada e clique em OK.
  5. Clique no botão Ajuda para obter informações detalhadas.

Adicionando Bibliotecas JavaScript

As bibliotecas de JavaScript integradas foram removidas no NetBeans IDE 6.7 porque eram muito grandes e de desempenho lento e porque é fácil adicionar bibliotecas manualmente. A adição manual de bibliotecas JavaScript ao projeto habilita a Completação Automática de Códigos e todas as outras funcionalidades relacionadas ao JavaScript no IDE para o seu projeto.

Para adicionar bibliotecas JavaScript ao seu projeto:

  1. Baixe as bibliotecas de JavaScript necessárias ou localize-as se já as possuir.
  2. Copie as bibliotecas JavaScript para a sua pasta do projeto PHP usando o IDE ou um explorador de arquivo.

Se as propriedades do projeto estão definidas para que os códigos-fonte do projeto sejam copiados para outro local (consulte Códigos-fonte), as bibliotecas de JavaScript também serão copiadas para esse local. Se o seu projeto for implementado em um servidor remoto, as bibliotecas de JavaScript serão carregadas nesse servidor na próxima vez que os códigos-fonte projeto forem carregados no servidor.


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