corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

NetBeans IDE para o Editor do PHP: Breve visão geral

Este documento é uma breve visão geral dos principais recursos do NetBeans IDE para o Editor do PHP.

Conteúdo

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

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

Para desenvolver e fazer deployment de aplicativos PHP no NetBeans IDE para PHP, você precisa ter todo o software necessário instalado e configurado para desenvolvimento de PHP.

Layout do NetBeans IDE para o Editor do PHP

O editor contém as seguintes janelas:

  • A janela Projetos mostra uma lista dos projetos existentes no momento
  • A janela Arquivos mostra os arquivos de cada projeto
  • A janela Serviços mostra listas de serviços externos disponíveis atualmente como bancos de dados.

Você também pode abrir uma janela Navegador no painel esquerdo pressionando Ctrl + 7.

Realce de sintaxe

O editor fornece realce de sintaxe para blocos de código PHP, HTML, JavaScript e CSS.

Os seguintes elementos de sintaxe são realçados na versão atual:

  • Palavras-chave do PHP
  • Variáveis do PHP
  • Constantes do PHP
  • Marcas HTML
  • Atributos de formulário de entrada de HTML
  • A linha atual é exibida com um segundo plano azul claro.
  • Quando você clica duas vezes em uma variável, função ou classe do PHP, todas as ocorrências da variável são realçadas em verde oliva.
  • As linhas onde tenham sido detectados erros são sublinhadas em vermelho.
A janela do NetBeans para editor do PHP mostra um fragmento de código com os elementos de código PHP e HTML realçados.
Para alterar as configurações de realce, escolha Ferramentas > Opções e alterne para a aba Fontes e cores. Especifique as configurações que desejar.

Ir para declaração

Com a função Ir para declaração o usuário navega de uma ocorrência de uma variável para a linha onde a variável é declarada ou inicializada. Para usar essa funcionalidade, posicione o cursor na ocorrência de variável relevante e escolha Navegar > Ir para declaração no menu de contexto ou pressione CTRL + B.

Navegador

O Navegador ajuda o usuário a se familiarizar com o código exibindo estruturas de código como elementos de uma lista que mostra as estruturas do PHP do arquivo atualmente ativo. Se o arquivo contiver quaisquer outras fontes de texto (por exemplo, HTML), a lista também exibe suas estruturas. Ao clicar duas vezes em uma classe, função ou uma variável na lista, o cursor aponta para a declaração do elemento clicado.

A lista do Navegador não contém normalmente quaisquer listas incorporadas, mas para comandos complexos ela pode conter estruturas incorporadas. Por exemplo, um comando de declaração de classe PHP pode ser apresentado como uma árvore de membros de classe declarada.

A lista é atualizada dinamicamente enquanto o usuário digita o código.

A janela Navegador é mostrada na parte inferior do painel esquerdo.

  1. Para abrir a janela Navegador, pressione CTRL + 7.
  2. Da lista suspensa do Navegador, escolha Navegador. A árvore que exibe a hierarquia das estruturas de HTML e PHP é exibida.
  3. Para mover para o elemento desejado, clique duas vezes no nó relevante na lista.
    A figura mostra um exemplo do uso da ferramenta de navegação. A figura também mostra funções e classes dobradas e desdobradas.

Dobramento de código

O editor permite que o usuário oculte e exiba de forma seletiva módulos, classes ou funções do arquivo editado atualmente com o código-fonte do PHP. Para dobrar ou exibir uma parte de código, clique no ícone - ou + à esquerda do código.

Recuo inteligente

O editor formata automaticamente o código enquanto o usuário está digitando.

Formatação

Para formatar uma parte de código para que fique mais compreensível, realize as seguintes etapas:

  1. Selecione a passagem de código relevante.
  2. Do menu de contexto exibido ao clicar com o botão direito do mouse, escolha Formatar ou pressione Alt + Shift + F

Conclusão de colchetes

O editor automaticamente adiciona e remove aspas e colchetes correspondentes enquanto o usuário digita o código.

  • Pares de aspas simples ' ' e aspas duplas "" "", parênteses () e colchetes [] são adicionados quando o usuário tiver digitado o primeiro símbolo.
  • No final de uma linha, um ponto-e-vírgula é adicionado além das aspas simples ou duplas de encerramento.
  • A chave de encerramento é adicionada depois que o usuário pressiona Enter, o que também ativa a função Recuo inteligente.
  • A exclusão das aspas simples ou duplas, do parêntese ou do colchete de abertura causa a remoção automática do símbolo de encerramento correspondente mas não afeta o ponto-e-vírgula do fim da linha.
  • Quando o cursor aponta para um parêntese de encerramento ), uma chave de encerramento } ou um colchete de encerramento ], o símbolo de abertura correspondente é realçado em amarelo.
    Quando o cursor aponta para um parêntese ou colchete de encerramento, o elemento de abertura correspondente é realçado.

Renomeação instantânea

Você pode renomear uma variável, função, etc. dentro de um arquivo php. Coloque o cursor sobre o nome que deseja alterar e pressione Ctrl-R. Todas as instâncias de tal nome de variável ou função são destacadas.

Editor de código-fonte PHP após Ctrl-R ser pressionado

Altere uma instância do nome e todas as outras instâncias são alteradas simultaneamente

Editor código-fonte PHP mostrando um nome de variável refatorado

Auto-completar de código

Auto-completar de código é um nome comum de um conjunto de recursos que facilitam e aceleram o processo de codificação. O recurso Auto-completar de código ainda está em desenvolvimento e uma ampla gama de possibilidades estará disponível em futuras versões do NetBeans.

Os seguintes tipos de auto-completar de código estão disponíveis:

Trechos

Os trechos permitem que o usuário gere código para vários elementos automaticamente.

  1. Escolha Ferramentas > Paleta > Fragmentos de código HTML/JSP. Uma paleta contendo vários elementos de interface do usuário aparece no painel direito.
  2. Arraste o ícone necessário na paleta para a posição relevante no código. Uma caixa de diálogo para especificar os parâmetros dos elementos correspondentes aparece. Preencha os dados.
  3. O código que exibe o elemento escolhido é gerado e inserido no local escolhido.

Propostas sensíveis a contexto

O editor fornece propostas sensíveis a contexto para completar qualquer número de símbolos iniciais de:

  • Uma palavra-chave de PHP (por exemplo, if, else, elseif, while, switch, function e assim por diante)
  • Uma função incorporada de PHP (por exemplo, substr, count, e assim por diante)
  • Uma variável predefinida ou definida pelo usuário

O editor sugere expansões mas também fornece dicas de parâmetros. Para aplicar o Auto-completar de código:

  1. Digite os símbolos iniciais da cadeia de caracteres necessária.
  2. Pressione CTRL + espaço. Uma lista suspensa mostra as propostas sensíveis a contexto. Cada proposta é fornecida com uma descrição e dicas de parâmetro. O conteúdo da lista é alterado à medida que você continua digitando.
  3. Para obter uma lista das palavras-chave de PHP disponíveis no contexto atual, pressione CTRL + espaço sem nenhuma digitação anterior.
    Uma lista de propostas sensíveis a contexto. Cada proposta é fornecida com uma descrição e dicas de parâmetro.
  4. Para obter uma dica sobre uma variável, digite o símbolo "$". Uma lista de todas as variáveis locais e globais disponíveis atualmente é exibida.
    Uma lista de variáveis é aberta depois que o usuário digita $. A lista contém variáveis globais do PHP e variáveis definidas pelo usuário.

Abreviações

No contexto atual, o termo "abreviações" refere-se a um conjunto de cadeias de caracteres predefinidas que correspondem às palavras-chave usadas em uma linguagem de programação. Cada abreviação está associada a um texto expandido que contém a palavra-chave completa e um modelo de código para a palavra-chave com dicas de parâmetro. Para aplicar esta funcionalidade, digite uma abreviação e pressione Tab.
A abreviação "cls" para a palavra-chave "class" é digitada
A abreviação é substituída pela palavra-chave correspondente e o modelo de código da palavra-chave é fornecido.
O texto completo da abreviação é exibido com um modelo de código para definição de classe
Para exibir a lista de abreviações definidas com modelos de código:
  1. Escolha Ferramentas > Opções > Editor > Modelos de código.
  2. Da lista suspensa Linguagem, selecione PHP. A lista de abreviações do PHP e o modelo de código definido para elas são exibidos.
  3. Para adicionar ou remover uma definição da lista, use os botões Novo ou Remover respectivamente.
  4. Para editar uma definição, selecione a linha relevante e edite o texto no campo de edição abaixo da lista.
    A lista de abreviações e os modelos de código definidos para elas

Auto-completar código em construtores

Depois da nova palavra-chave, a janela de auto-completar código é exibida com construtores e parâmetros de todas as classes disponíveis no projeto.

Dicas do auto-completar código para um construtor

Auto-completar código SQL

O auto-completar código SQL é exibido quando uma string começa com a palavra-chave do SQL "select". O primeiro passo é selecionar a conexão do banco de dados.

Auto-completar código oferecendo conexão do banco de dados

São exibidas todas as conexões do banco de dados registradas com o IDE.

Todas as conexões do banco de dados registradas com o IDE

Após selecionar a conexão, o auto-completar código SQL oferece todas as tabelas de tal conexão do banco de dados.

Todas as tabelas da conexão do banco de dados wishlist

Se a tabela tiver colunas, tais colunas também são exibidas.

Colunas exibidas da tabela

o auto-completar código SQL também funciona com aliases de tabela.

Auto-completar código SQL mostrando tabelas no alias hotel

Namespaces PHP 5.3

O auto-completar código oferece suporte a nomes namespace totalmente, parcialmente e não qualificados de PHP 5.3. Para obter mais informações, consulte nosso screencast.

Dicas de parâmetro

O editor solicita ao usuário os parâmetros formais de uma função ou um método no contexto onde a função ou o método é chamado.

  1. Digite os caracteres iniciais da função que deseja chamar.
  2. Pressione CTRL + espaço. Uma lista suspensa mostra as propostas sensíveis a contexto com os parâmetros formais de cada proposta.
    Lista de dicas sensíveis a contexto
  3. Escolha a proposta relevante e pressione Enter. O nome da função escolhida é inserido no código e um modelo para inserir os parâmetros é mostrado entre colchetes.
    Dicas de parâmetro para a proposta sensível a contexto escolhida.

Definindo o tipo de variável em comentários

Você pode definir uma variável e o seu tipo em um comentário. O comentário deve ser no formato /* @var $variable type */ . Se o comentário estiver escrito corretamente, a marcação var estará em negrito.

Variáveis declaradas em comentários

Você pode usar o modelo de código vdoc, seguido de Tabulação, para gerar um comentário que define uma variável. O nome da variável é selecionado e pode ser alterado. Pressione Tab novamente e o tipo é selecionado.

Variável declarando comentário gerado pelo modelo vdoc

O modelo de código define o nome e o tipo da variável automaticamente. Se a variável for usada após o lugar no qual você inseriu o modelo, o nome seguinte de tal variável será sugerido por padrão. Se nenhuma variável for usada após o lugar no qual você inseriu o modelo, mas for usada uma variável acima do modelo, o nome seguinte de tal variável será sugerido por padrão. Se o NetBeans IDE não for capaz de localizar nenhuma variável perto de onde você usar o modelo, o nome padrão é variável.  O tipo de variável é definido automaticamente de acordo com as mesmas regras.

Variável declarando comentário gerado pelo modelo vdoc, com nomes e tipos de variável padrão

Mensagens de erro

O editor analisa a sintaxe do código enquanto você digita e marca os erros de sintaxe sublinhando as linhas com erro e colocando um marcador vermelho ao lado delas. Para obter uma explicação do erro, passe o ponteiro do mouse sobre a linha com erro ou clique no marcador vermelho. Uma dica de ferramenta aparece com uma breve explicação do erro.
Mensagem de erro: uma dica de ferramenta sobre a linha com erro.

Testes PHPUnit e Selenium

O NetBeans IDE para o PHP oferece suporte aos testes automatizados PHPUnit. Graças ao PHPUnit, o NetBeans IDE fornece a cobertura de código para o PHP, similar a cobertura de código que o IDE fornece ao Python e Ruby. A saída do teste aparece na mesma janela de saída rica em recursos que os executores de teste JUnit, Ruby e Python do IDE usam.

O NetBeans IDE também suporta o framework de teste portável Selenium em combinação com o PHPUnit. Um plug-in Selenium está disponível no Centro de Atualizações. A instalação deste plug-in adiciona um servidor Selenium nos servidores registrados do IDE e adiciona opções de teste Selenium aos menus PHP.

Consulte Testando com PHPUnit e Selenium para obter mais informações.

Suporte do framework Symfony

O suporte do framework Symfony está incorporado ao editor PHP. Ele reconhece os frameworks Symfony existentes e é possível adicionar o framework a novos projetos no último painel do assistente para novo projeto PHP.

Em um projeto PHP com suporte ao Symfony, você pode executar os comandos do Symfony a partir do menu de contexto do projeto.

Menu de contexto mostrando os comandos do Symfony

Use a IU dos comandos para:

  • Filtrar os comandos do Symfony (1)
  • Especificar os parâmetros do comando (2)
  • Selecionar um comando (3)
  • Ver a ajuda de contexto do comando (4)
  • Visualizar todo o comando que será executado (5)
Caixa de diálogo do comando do Symfony anotado

A lista de comandos é específica do projeto. Isso significa que, por exemplo, se for utilizado Doctrine em vez de Propel, nenhum comando do Propel será listado, serão listados apenas os comandos do Doctrine. Também, todos os comandos dos plug-ins Symfony do projeto estão disponíveis.

O auto-completar código inclui as variáveis do Symfony nas suas visualizações.

Variáveis do Symfony no auto-completar código

O IDE também oferece atalhos de navegação entre as visualizações e as ações do Symfony.

Para saber mais sobre o suporte do framework Symfony, assista o screencast do Symfony.



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