| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> | |
| <!-- | |
| Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. | |
| --> | |
| <html> | |
| <head> | |
| <title>NetBeans IDE para o Editor do PHP</title> | |
| <meta name="KEYWORDS" content="NETBEANS, PHP, editor"> | |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> | |
| <meta name="DESCRIPTION" content="NetBeans, PHP editor" > | |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css" media="screen"></head> | |
| <body> | |
| <h1>NetBeans IDE para o Editor do PHP: Breve visão geral</h1> | |
| <p>Este documento é uma breve visão geral dos principais recursos do NetBeans IDE para o Editor do PHP.</p> | |
| <p><strong>Conteúdo</strong></p><img src="../../../images_www/articles/71/netbeans-stamp.png" class="stamp" width="114" height="114" alt="O conteúdo desta página se aplica ao NetBeans IDE 7.1" title="O conteúdo desta página se aplica ao NetBeans IDE 7.1"> | |
| <ul> | |
| <li><a href="#gettingReady">Preparação</a></li> | |
| <li><a href="#editorLayout">Layout do NetBeans IDE para o Editor do PHP</a></li> | |
| <li><a href="#SyntaxHighlighting">Realce de sintaxe</a></li> | |
| <li><a href="#goToDeclaration">Ir para declaração</a></li> | |
| <li><a href="#Navigator">Navegador</a></li> | |
| <li><a href="#CodeFolding">Dobramento de código</a></li> | |
| <li><a href="#SmartIndent">Recuo inteligente</a></li> | |
| <li><a href="#Formatting">Formatação</a></li> | |
| <li><a href="#BracketCompletion">Conclusão de colchete</a></li> | |
| <li><a href="#instant-rename">Renomear refatoração e Renomear instantâneo</a></li> | |
| <li><a href="#CodeCompletion">Auto-completar de código</a> | |
| <ul> | |
| <li><a href="#snippets">Trechos</a></li> | |
| <li><a href="#contextSensitiveProposals">Propostas sensíveis a contexto</a></li> | |
| <li><a href="#abbreviations">Modelos de código e abreviaturas</a></li> | |
| <li><a href="#cc-constructors">Auto-completar código em construtores</a></li> | |
| <li><a href="#cc-sql">Auto-completar código SQL</a></li> | |
| <li><a href="#cc-namespaces">Namespaces PHP 5.3</a></li> | |
| <li><a href="#cc-overridden-methods">Métodos substituídos e implementados</a></li> | |
| <li><a href="#clever-catch-cc">Preenchimento de código inteligente tentar/obter</a></li> | |
| </ul> | |
| </li> | |
| <li><a href="#rectangular">Seleção retangular</a></li> | |
| <li><a href="#phpdoc">Suporte ao PHPDocumentor</a></li> | |
| <li><a href="#code-generators">Geradores de código</a> | |
| <ul> | |
| <li><a href="#generate-constructors">Construtores</a></li> | |
| <li><a href="#generate-getters-setters">Getters e setters</a></li> | |
| <li><a href="#generate-overriden-methods">Métodos substituídos e implementados</a></li> | |
| </ul></li> | |
| <li><a href="#vartyp-cmnt">Definindo o tipo de variável em comentários</a></li> | |
| <li><a href="#ParameterHints">Dicas de parâmetro</a></li> | |
| <li><a href="#errorMessages">Mensagens de erro</a></li> | |
| <li><a href="#phpunit">Testes PHPUnit e Selenium</a></li> | |
| <li><a href="#spellchecker">Corretor ortográfico</a></li> | |
| <li><a href="#symfony">Suporte ao Symfony e ao Zend a estrutura</a></li> | |
| <li><a href="#smarty">Suporte ao Smarty</a></li> | |
| </ul> | |
| <p><b>Para seguir este tutorial, você precisa dos seguintes recursos e softwares.</b></p> | |
| <table> | |
| <tbody> | |
| <tr> | |
| <th class="tblheader" scope="col">Software ou recurso</th> | |
| <th class="tblheader" scope="col">Versão necessária</th> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><a target="_blank" href="https://netbeans.org/downloads/index.html">NetBeans IDE</a></td> | |
| <td class="tbltd1">Pacote de download do PHP</td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1">Um mecanismo PHP</td> | |
| <td class="tbltd1">Versão 5 | |
| </tr> | |
| <tr> | |
| <td class="tbltd1">Um servidor Web</td> | |
| <td>É recomendado o <a target="_blank" href="http://httpd.apache.org/download.cgi">Apache HTTP Server 2.2</a>.<br></td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1">Um depurador PHP</td> | |
| <td><a target="_blank" href="http://www.xdebug.org">XDebug 2.0 ou posterior</a></td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| <h2><a name="gettingReady"></a>Preparando</h2> | |
| <p>Para desenvolver e fazer deployment de aplicativos PHP no NetBeans IDE para PHP, você precisa ter todo o <a href="../../trails/php.html#configuration">software necessário instalado e configurado para desenvolvimento de PHP</a>. </p> | |
| <h2><a name="editorLayout"></a>Layout do NetBeans IDE para o Editor do PHP</h2> | |
| <p>O editor contém as seguintes janelas:</p> | |
| <ul> | |
| <li>A janela Editor mostra o arquivo quando você está editando. O Editor tem uma aba para cada arquivo aberto.</li> | |
| <li>A janela Projetos mostra uma lista dos projetos existentes no momento</li> | |
| <li>A janela Arquivos mostra os arquivos de cada projeto</li> | |
| <li>A janela Serviços mostra listas de serviços externos disponíveis atualmente como bancos de dados.</li> | |
| </ul> | |
| <p>Você também pode abrir uma janela Navegador no painel esquerdo pressionando Ctrl + 7. O Navegador mostra a estrutura de uma classe PHP se ela estiver aberta no Editor. Os arquivos que não sejam de classe PHP não são mostrados na janela Navegador.</p> | |
| <p>Para abrir a ajuda para uma desssas janelas, selecione qualquer elemento na janela e pressione F1.</p> | |
| <h2><a name="SyntaxHighlighting"></a>Realce de sintaxe </h2> | |
| <p>O editor fornece realce de sintaxe para blocos de código PHP, HTML, JavaScript e CSS. </p> | |
| <p>Os seguintes elementos de sintaxe são realçados na versão atual:</p> | |
| <ul> | |
| <li>Palavras-chave do PHP </li> | |
| <li>Variáveis do PHP </li> | |
| <li>Constantes do PHP </li> | |
| <li>Marcas HTML</li> | |
| <li>Atributos de formulário de entrada de HTML</li> | |
| <li>A linha atual é exibida com um segundo plano azul claro.</li> | |
| <li>Ao colocar o cursor dentro de uma variável PHP, uma função ou uma classe, todas as ocorrências da variável serão realçadas. </li> | |
| <li>As linhas onde tenham sido detectados erros são sublinhadas em vermelho. </li> | |
| </ul> | |
| <img src="../../../images_www/articles/71/php/editorguide/syntaxhighlighting.png" alt="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." class="margin-around"><br> | |
| <p>Para alterar as configurações de realce, escolha <tt>Ferramentas > Opções</tt> e alterne para a aba Fontes e cores. Especifique as configurações que desejar.</p> | |
| <h2><a name="goToDeclaration"></a>Ir para declaração</h2> | |
| Com a função Ir para declaração, o usuário navega de uma ocorrência de uma variável ou função para a linha onde a variável ou função é declarada ou inicializada. Para usar essa funcionalidade, posicione o cursor na variável ou função relevante e escolha Navegar > Ir para a declaração a partir do menu de contexto, pressione Ctrl-B/⌘-B ou use Ctrl-click. | |
| <h2><a name="Navigator"></a>Janela do Navegador</h2> | |
| <p>A janela do Navegador exibe as estruturas do código como elementos de uma lista que mostra as estruturas PHP do arquivo ativo atual. 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 função ou uma variável na lista, o cursor aponta para a declaração do elemento clicado. </p> | |
| <p class="alert"><b>Cuidado:</b> a janela do Navegador somente mostra o código PHP para as classes PHP. Ela não pode mostrar código PHP fora de uma classe.</p> | |
| <p>A lista Navegador normalmente não contém 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. </p> | |
| <p>A lista é atualizada dinamicamente enquanto o usuário digita o código. </p> | |
| <p>A janela Navegador é mostrada na parte inferior do painel esquerdo.</p> | |
| <ol> | |
| <li>Para abrir a janela Navegador, pressione Ctrl + 7 ou vá para Janela > Navegação > Navegador. A árvore que exibe a hierarquia das estruturas de HTML e PHP é exibida.</li> | |
| <li>Para mover para o elemento desejado, clique duas vezes no nó relevante na lista. | |
| <br> <img src="../../../images_www/articles/71/php/editorguide/navigation.png" alt="A figura mostra um exemplo da utilização da ferramenta de navegação. A figura também mostra funções e classes dobradas e desdobradas." class="margin-around"> </li></ol> | |
| <h2><a name="CodeFolding"></a>Dobramento de código</h2> | |
| <p>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 PHP. Para recolher ou exibir uma parte de código, clique no ícone - ou + à esquerda do código ou pressione Ctrl+ ou Ctrl-. </p> | |
| <h2><a name="SmartIndent"></a>Recuo inteligente</h2> | |
| <p>O editor formata automaticamente o código enquanto o usuário está digitando. </p> | |
| <h2><a name="Formatting"></a>Formatação</h2> | |
| <p>Para formatar uma parte de código para que fique mais compreensível, realize as seguintes etapas:</p> | |
| <ol> | |
| <li>Selecione a passagem de código relevante.</li> | |
| <li>Do menu de contexto exibido ao clicar com o botão direito do mouse, escolha Formatar ou pressione Alt + Shift + F</li> | |
| </ol> | |
| <h2><a name="BracketCompletion"></a>Conclusão de colchetes</h2> | |
| <p>O editor automaticamente adiciona e remove aspas e colchetes correspondentes enquanto o usuário digita o código. </p> | |
| <ul> | |
| <li>Pares de aspas simples ' ' e aspas duplas "" "", parênteses () e colchetes [] são adicionados quando o usuário tiver digitado o primeiro símbolo.</li> | |
| <li>No final de uma linha, um ponto-e-vírgula é adicionado além das aspas simples ou duplas de encerramento.</li> | |
| <li>A chave de encerramento é adicionada depois que o usuário pressiona Enter, o que também ativa a função Recuo inteligente.</li> | |
| <li>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. | |
| <li>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. | |
| <br><img src="../../../images_www/articles/71/php/editorguide/paired-brackets-highlighting.png" alt="Quando o cursor aponta para um parêntese ou colchete de encerramento, o elemento de abertura correspondente é realçado." class="margin-around"></li> | |
| </ul> | |
| <h2><a name="instant-rename">Renomear refatoração e Renomear instantâneo</a></h2> | |
| <p>Você pode renomear um elemento, como um nome de classe, em todos os arquivos em um projeto. O recurso força você a visualizar suas alterações antes de poder fazê-las. A janela de visualização mostra cada localização do elemento e permite excluir ocorrências individuais do elemento sendo renomeado.</p> | |
| <p>Renomear refatoração é contrastada com o recurso mais antigo, Renomear instantâneo. Renomear instantâneo ainda está disponível, mas somente funciona em contextos "não públicos", como renomear uma variável dentro de um método ou renomear variáveis e pastas privadas. Renomear instantâneo somente permite renomear um elemento dentro de um arquivo e não fornece uma janela de visualização.</p> | |
| <p>Para usar Renomear instantâneo, coloque o cursor em um nome que deseja alterar e pressione Ctrl+R. Se Renomear instantâneo se aplicar a tal variável, todas as instâncias daquela variável ou função serão realçadas.</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/refactor-ctrlr.png" width="551" height="361" alt="Editor de código-fonte PHP após Ctrl-R ser pressionado"> | |
| <p> Altere uma instância do nome e todas as outras instâncias serão alteradas simultaneamente</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/refactor-afterchange.png" width="551" height="359" alt="Editor código-fonte PHP mostrando um nome de variável refatorado"> | |
| <p>Para usar Renomear refatoração, selecione o elemento que deseja renomear e pressione Ctrl+R, ou clique com o botão direito do mouse e selecione Refatorar > Renomear. Uma caixa de diálogo é aberta para que você renomeie o elemento.</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/rename-confirm.png" alt="Caixa de diálogo para renomear uma variável" class="margin-around" > | |
| <p>Renomeie o elemento e pressione Visualizar. A janela Refatoração é aberta. Nessa janela, você pode encontrar cada instância do elemento em seu projeto e pode decidir renomeá-lo ou não.</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/refactoring.png" alt="Janela Refatoração" class="margin-around" > | |
| <p>Para obter mais informações sobre Renomear refatoração, consulte o screencast <a href="../../docs/php/screencast-rename-refactoring.html">Renomear refatoração e outros aprimoramentos no editor no NetBeans IDE 7.0 para PHP</a>.</p> | |
| <h2><a name="CodeCompletion"></a>Auto-completar de código</h2> | |
| <p>O preenchimento de código é um nome comum para um conjunto de recursos que aceleram o processo de codificação.</p> | |
| <p>Os seguintes tipos de auto-completar de código estão disponíveis: </p> | |
| <ul> | |
| <li><a href="#snippets">Trechos</a></li> | |
| <li><a href="#contextSensitiveProposals">Propostas sensíveis a contexto</a></li> | |
| <li><a href="#abbreviations">Abreviações</a></li> | |
| <li><a href="#cc-constructors">Auto-completar código em construtores</a></li> | |
| <li><a href="#cc-sql">Auto-completar código SQL</a></li> | |
| <li><a href="#cc-namespaces">Namespaces PHP 5.3</a></li> | |
| <li><a href="#cc-overridden-methods">Métodos substituídos e implementados</a></li> | |
| </ul> | |
| <div class="indent"><h3><a name="snippets"></a>Trechos </h3> | |
| <p>Os trechos permitem que o usuário gere código para vários elementos automaticamente.</p> | |
| <ol> | |
| <li>Escolha Ferramentas > Paleta > Fragmentos de código. Uma paleta contendo vários elementos de interface do usuário aparece no painel direito.</li> | |
| <li>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.</li> | |
| <li>O código que exibe o elemento escolhido é gerado e inserido no local escolhido.</li> | |
| </ol> | |
| <h3><a name="contextSensitiveProposals"></a>Propostas sensíveis a contexto </h3> | |
| <p>O editor fornece propostas sensíveis a contexto para completar qualquer número de símbolos iniciais de: </p> | |
| <ul> | |
| <li>Uma palavra-chave de PHP (por exemplo, if, else, elseif, while, switch, function e assim por diante) </li> | |
| <li>Uma função incorporada de PHP (por exemplo, substr, count, e assim por diante)</li> | |
| <li>Uma variável predefinida ou definida pelo usuário</li> | |
| </ul> | |
| <p>O editor sugere expansões mas também fornece <a href="#ParameterHints">dicas de parâmetros</a>. Para aplicar o Auto-completar de código: </p> | |
| <ol> | |
| <li>Digite os símbolos iniciais da cadeia de caracteres necessária. </li> | |
| <li>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. </li> | |
| <li>Para obter uma lista das palavras-chave de PHP disponíveis no contexto atual, pressione CTRL + espaço sem nenhuma digitação anterior. | |
| <br> <img src="../../../images_www/articles/71/php/editorguide/codecompletionabbreviations.png" alt="Uma lista de propostas sensíveis a contexto. Cada proposta é fornecida com uma descrição e dicas de parâmetro." class="margin-around"> | |
| </li> | |
| <li>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. | |
| <br><img src="../../../images_www/articles/71/php/editorguide/code-completion-variables.png" alt="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." class="margin-around"> </li> | |
| </ol> | |
| <h3><a name="abbreviations"></a>Modelos de código e abreviaturas</h3> | |
| <p>No contexto atual, o termo "abreviações" refere-se a um conjunto de cadeias de caracteres predefinidas que correspondem às palavras-chave utilizadas 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. </p> | |
| <img src="../../../images_www/articles/71/php/editorguide/abbreviations-type-abbr.png" alt="A abreviação "cls" para a palavra-chave "class" é digitada " class="margin-around"><br> | |
| <p>A abreviação é substituída pela palavra-chave correspondente e o modelo de código da palavra-chave é fornecido.</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/abbreviation-unfolded.png" alt="O texto completo da abreviação é exibido com um modelo de código para definição de classe" class="margin-around"><br> | |
| <p>Para exibir a lista de abreviações definidas com modelos de código:</p> | |
| <ol> | |
| <li>Escolha <tt>Ferramentas > Opções > Editor > Modelos de código</tt>. </li> | |
| <li>A partir da lista suspensa Linguagem, selecione PHP. A lista de abreviações PHP e o modelo de código definido para elas são exibidos.</li> | |
| <li>Para adicionar ou remover uma definição da lista, utilize os botões Novo ou Remover respectivamente.</li> | |
| <li>Para editar uma definição, selecione a linha relevante e edite o texto no campo de edição abaixo da lista. <br> | |
| <img src="../../../images_www/articles/71/php/editorguide/code-template-definitions-list.png" alt="A lista de abreviações e os modelos de código definidos para elas" width="536" height="513" class="margin-around"></li></ol> | |
| <p>Para obter mais informações, consulte <a href="../../docs/php/code-templates.html">Modelos de código no NetBeans IDE para PHP</a>.</p> | |
| <h3><a name="cc-constructors"></a>Preenchimento de código para construtores</h3> | |
| <p>Depois da <tt>nova</tt> palavra-chave, a janela de auto-completar código é exibida com construtores e parâmetros de todas as classes disponíveis no projeto.</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/cc-constructor.png" width="600" height="408" alt="Dicas do auto-completar código para um construtor" class="margin-around" border="1"> | |
| <h3><a name="cc-sql"></a>Preenchimento de código SQL</h3> | |
| <p>O autocompletar 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.</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/cc-sql.png" height="384" width="475" alt="Auto-completar código oferecendo conexão do banco de dados" border="1" class="margin-around"> | |
| <p>São exibidas todas as conexões do banco de dados registradas com o IDE.</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/cc-sql-dbconnections.png" alt="Todas as conexões do banco de dados registradas com o IDE" width="554" height="185" class="margin-around"> | |
| <p>Após selecionar a conexão, o auto-completar código SQL oferece todas as tabelas de tal conexão do banco de dados. </p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/cc-sql-tables.png" height="384" width="494" alt="Todas as tabelas da conexão do banco de dados wishlist" class="margin-around" border="1"></p> | |
| <p>Se a tabela tiver colunas, tais colunas também são exibidas.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/cc-sql-columns.png" height="358" width="530" class="margin-around" alt="Colunas exibidas da tabela" border="1"></p> | |
| <p>o auto-completar código SQL também funciona com aliases de tabela.</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/cc-sql-aliases.png" alt="Auto-completar código SQL mostrando tabelas no alias hotel" height="352" width="537" border="1" class="margin-around"> | |
| <h3><a name="cc-namespaces"></a>Espaços de nome do PHP 5.3</h3> | |
| <p>O autocompletar de código suporta nomes namespace não qualificados, parcialmente qualificados e totalmente qualificados a partir do PHP 5.3. Para mais informações, consulte nosso <a href="../../docs/php/namespace-code-completion-screencast.html">screencast</a>.</p> | |
| <h3><a name="cc-overridden-methods"></a>Métodos substituídos e implementados</h3> | |
| <p>Autocompletar de código entre membros de classe oferece substituir ou implementar métodos.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/cc_overriden_methods.png" alt="Autocompletar código oferecendo substituir o método" width="600" height="478" class="margin-around"></p> | |
| <h3><a name="clever-catch-cc"></a>Preenchimento de código inteligente tentar/obter</h3> | |
| <p>A partir do NetBeans IDE 7.1, o preenchimento de código para declarações <tt>catch</tt> inclui somente as classes que herdam de <tt>Exceção</tt>.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/clever-catch-cc.png" alt="Editor mostrando o preenchimento inteligente do código em parâmetros catch" width="491" height="166" class="margin-around b-all"></p> | |
| </div> | |
| <h2><a name="rectangular"></a>Seleção retangular</h2> | |
| <p>O NetBeans IDE 7.1 para PHP introduz a ação Seleção retangular. Essa função de edição é útil em casos como a exclusão de números de linhas em código colado.</p> | |
| <p>Para ativar a seleção retangular, pressione o botão Seleção retangular ou Ctrl+Shift+R para alternar.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/rec-selec-togglebutton.png" alt="Editor mostrando o botão Seleção retangular para alternar" width="600" height="321" class="margin-around b-all"></p> | |
| <p>Quando a Seleção retangular está ativada, você pode fazer a seleção com o mouse ou com o teclado. Quando você usa o teclado, coloque o cursor em um canto, mantenha Shift pressionado e selecione o que deseja com as teclas de seta. </p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/rec-selec-made.png" alt="Editor mostrando uma seleção retangular de números de linhas colados" width="600" height="289" class="margin-around b-all"></p> | |
| <p>Se você escrever um texto enquanto a área estiver selecionada, o texto será colocado em cada linha na área selecionada. Isso pode ser útil, por exemplo, para alterar simultaneamente os modificadores de acesso de vários campos em uma classe. </p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/rec-selec-addtext.png" alt="Editor com um modificador de acesso adicionado em todas as linhas em uma seleção retangular" width="435" height="342" class="margin-around b-top b-right"></p> | |
| <h2><a name="phpdoc"></a>Suporte ao PHPDocumentor</h2> | |
| <p>O suporte incorporado ao PHPDocumentor foi incluído no NetBeans IDE 7.0. Para obter mais informações, consulte o screencast <a href="screencast-phpdoc.html">Gerando documentação PHP com o NetBeans IDE</a>.</p> | |
| <p class="alert"><b>Aviso:</b> o PHPDocumentor não suporta completamente o PHP 5.3. Espaços de nome e alguns outros recursos do 5.3 não são documentados pelo PHP Documentor.</p> | |
| <h2><a name="code-generators"></a>Geradores de código</h2> | |
| <p>Ao pressionar a combinação Alt-Insert (Ctrl-I no Mac), um menu abre com todas os possíveis geradores de código. A lista de geradores é sensível ao contexto. Isso depende da posição do cursor no código quando a chave de combinação é pressionada. Dependendo da sua posição no código, é possível gerar uma conexão de banco de dados, tabelas de banco de dados, texto lorum ipsum e vários outros. Esta seção descreve apenas os geradores de código a seguir:</p> | |
| <ul> | |
| <li><a href="#generate-constructors">Construtores</a></li> | |
| <li><a href="#generate-getters-setters">Getters e setters</a></li> | |
| <li><a href="#generate-overriden-methods">Métodos substituídos e implementados</a></li> | |
| </ul> | |
| <div class="indent"> | |
| <h3><a name="generate-constructors"></a>Construtores</h3> | |
| <p>É possível gerar construtores ao pressionar Alt-Insert (Ctrl-I no Mac) quando o cursor estiver dentro de um corpo de classe, mas não dentro de nenhuma função contida neste corpo. Ao selecionar Gerar... Construtor, uma caixa de diálogo abre listando os campos que podem ser inicializados pelo construtor. Os nomes de campo são utilizados como parâmetros do construtor.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/generate-constructor-fields.png" alt="Caixa de diálogo dos campos pra inicializar com o construtor" width="352" height="299" class="margin-around"></p> | |
| <p>Você pode selecionar nenhum campo. Nesse caso, o IDE gera um construtor vazio, sem parâmetros. Se o campo for uma classe com propriedades, é possível selecionar propriedades individuais ou é possível selecionar a classe, já que todas as propriedades de classe estão selecionadas automaticamente.</p> | |
| <p>Para mais informações, consulte a <a target="_blank" href="http://blogs.sun.com/netbeansphp/entry/generate_constructor_getters_and_setters">publicação no blog NetBeans PHP</a>.</p> | |
| <h3><a name="generate-getters-setters"></a>Getters e setters</h3> | |
| <p>É possível gerar getters e setters ao pressionar Alt-Insert (Ctrl-I no Mac) quando o cursor estiver dentro de um corpo de classe e selecionar Getter, Setter ou Getters e setters. Apenas as funções possíveis são exibidas. Por exemplo, se já possuir setters disponíveis para as propriedades, apenas a opção getter aparece.</p> | |
| <p>Ao selecionar Gerar... Getter/Setter/Getter e setter, uma caixa de diálogo aparece com as propriedades para que seja possível gerar um getter ou setter. As propriedades são exibidas em uma árvore. Se você selecionar uma classe principal, são selecionadas automaticamente todas as propriedades da classe.</p> | |
| <p>É possível nomear um getter ou setter de acordo com a convenção getName ou a convenção get_name.</p> | |
| <p>Para mais informações, consulte a <a target="_blank" href="http://blogs.sun.com/netbeansphp/entry/generate_constructor_getters_and_setters">publicação no blog NetBeans PHP</a> original e a publicação <a target="_blank" href="http://blogs.sun.com/netbeansphp/entry/generating_getters_and_setters_improved">geração de getter e setter aprimorada</a>.</p> | |
| <h3><a name="generate-overriden-methods"></a>Métodos substituídos e implementados</h3> | |
| <p>É possível gerar métodos substituídos ou implementados ao pressionar Alt-Insert (Ctrl-I no Mac) quando o cursor estiver dentro de uma declaração de classe e existirem vários membros de classe. Uma caixa de diálogo abre mostrando os métodos que podem ser inseridos e indicando se eles estão substituídos ou implementados.</p> | |
| <p><img class="margin-around" src="../../../images_www/articles/71/php/editorguide/generate_overriden_methods.png" alt="Caixa de diálogo para a geração de métodos substituídos" width="523" height="520"></p> | |
| <p>Esse recurso conclui a dica "Implemente todos os métodos abstratos" e <a href="#cc-overridden-methods">autocompletar de código para métodos substituídos e implementados</a>.</p> | |
| <p>Para mais informações, consulte a <a target="_blank" href="http://blogs.sun.com/netbeansphp/entry/generate_overriden_implemented_methods">publicação no blog NetBeans PHP</a>.</p> | |
| </div> | |
| <h2><a name="ParameterHints"></a>Dicas de parâmetro </h2> | |
| <p>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.</p> | |
| <ol> | |
| <li>Digite os caracteres iniciais da função que deseja chamar. </li> | |
| <li>Pressione CTRL + espaço. Uma lista suspensa mostra as propostas sensíveis a contexto com os parâmetros formais de cada proposta.<br> | |
| <img src="../../../images_www/articles/71/php/editorguide/parametr-hint-one.png" alt="Lista de dicas sensíveis a contexto" class="margin-around"> | |
| </li> | |
| <li>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. <br> | |
| <img src="../../../images_www/articles/71/php/editorguide/parametr-hint-two.png" alt="Dicas de parâmetro para a proposta sensível a contexto escolhida." class="margin-around"> | |
| </li> | |
| </ol> | |
| <h2><a name="vartyp-cmnt"></a>Definindo o tipo de variável em comentários</h2> | |
| <p>É possível definir uma variável e o seu tipo em um comentário. O comentário deve estar no formato <em>/* @<strong>var</strong> $variable type */ </em>. Se o comentário estiver escrito corretamente, a marcação <em><strong>var</strong></em> estará em negrito.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/vardoc-basic.png" height="319" width="600" alt="Variáveis declaradas em comentários" class="margin-around" border="1"> </p> | |
| <p>É possível utilizar o modelo de código <tt>vdoc</tt>, 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.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/vardoc-template.png" height="269" width="600" alt="Variável declarando comentário gerado pelo modelo vdoc" class="margin-around" border="1"> </p> | |
| <p>O modelo de código define o nome e o tipo da variável automaticamente. Se a variável for utilizada 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 utilizada após o lugar no qual você inseriu o modelo, mas houver uma variável utilizada acima do modelo, o nome 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ê utilizar o modelo, o nome padrão é <em>variável</em>. O tipo de variável é definido automaticamente de acordo com as mesmas regras.</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/vardoc-template-names.png" alt="Variável declarando comentário gerado pelo modelo vdoc, com nomes e tipos de variável padrão" class="margin-around" border="1" height="385" width="600"> | |
| <h2><a name="errorMessages"></a>Mensagens de erro</h2> | |
| <p>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 cursor do mouse sobre a linha com erro ou clique no marcador vermelho. Uma dica de ferramenta aparece com uma breve explicação do erro. <br> | |
| <img src="../../../images_www/articles/71/php/editorguide/error-messaging-m1.png" alt="Mensagem de erro: uma dica de ferramenta sobre a linha com erro." class="margin-around"> | |
| </p> | |
| <h2><a name="phpunit"></a>Testes PHPUnit e Selenium</h2> | |
| <p>O NetBeans IDE para PHP suporta os testes automatizados <a target="_blank" href="http://www.phpunit.de">PHPUnit</a>, incluindo a cobertura de código. A partir do NetBeans IDE 7.1, você pode usar grupos de teste em seu código.</p> | |
| <p>O NetBeans IDE também suporta a estrutura de teste portátil 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.</p> | |
| <p>Consulte <a href="./phpunit.html">Testando com PHPUnit e Selenium</a> para obter mais informações.</p> | |
| <h2 id="spellchecker">Corretor ortográfico</h2> | |
| <p>Um corretor ortográfico está disponível. Na caixa de diálogo Opções, você pode alternar entre ativar e desativar o corretor ortográfico para diferentes idiomas.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/spellchecker-options.png" class="margin-around" alt="Caixa de diálogo Opções para o corretor ortográfico" width="600" height="448"></p> | |
| <p>Na caixa de diálogo Opções, você pode adicionar e remover novos dicionários e definir a localidade. Quando desejar adicionar um novo dicionário, você terá que ter um arquivo com as palavras. O formato do arquivo do dicionário é uma lista de palavras com cada palavra em uma nova linha. Você terá que informar ao NetBeans a codificação do arquivo do dicionário e para qual localidade o arquivo deverá ser usado. </p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/spellchecker-newdictionary.png" class="margin-around" alt="Adicionando um novo dicionário para o corretor ortográfico" width="600" height="180"></p> | |
| <p>Quando o corretor ortográfico encontra uma palavra que não está em seu dicionário, ele sublinha a palavra em vermelho. O corretor ortográfico também adiciona uma dica de ferramenta àquela palavra que diz "Erro de ortografia". Observe que o texto HTML é verificado em arquivos PHP.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/spellchecker-html.png" alt="Erros encontrados no texto HTML em um arquivo PHP" width="600" height="68" class="margin-around"></p> | |
| <h2><a name="symfony"></a>Suporte à estrutura Symfony e Zend</h2> | |
| <p>Suporte à estrutura Symfony e Zend são embutidos no editor PHP. Ele reconhece as estruturas Symfony existentes e é possível adicionar a estrutura a novos projetos no último painel do assistente para novo projeto PHP.</p> | |
| <p>Em um projeto PHP com suporte ao Symfony ou Zend, é possível executar os comandos do Symfony ou do Zend a partir do menu de contexto do projeto.</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/symfony-contextmenu-commands.png" alt="Menu de contexto mostrando os comandos do Symfony" class="margin-around"> | |
| <p>Use a IU dos comandos para:</p> | |
| <ul> | |
| <li>Filtrar os comandos do Symfony/Zend (1)</li> | |
| <li>Especificar os parâmetros do comando (2)</li> | |
| <li>Selecionar um comando (3)</li> | |
| <li> Ver a ajuda de contexto do comando (4) </li> | |
| <li>Visualizar todo o comando que será executado (5)</li> | |
| </ul> | |
| <img src="../../../images_www/articles/72/php/editorguide/symfony-command-dialog.png" class="margin-around" alt="Caixa de diálogo do comando do Symfony anotado"> | |
| <p>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, apenas os comandos do Doctrine serão listados. Também, todos os comandos dos plug-ins Symfony do projeto estão disponíveis.</p> | |
| <p>Autocompletar de código inclui variáveis Symfony nas visualizações Symfony e variáveis Zend nas visualizações Zend. </p> | |
| <img src="../../../images_www/articles/72/php/editorguide/symfony-variables.png" alt="Variáveis do Symfony no auto-completar código" class="margin-around" border="1"> | |
| <p>O IDE também oferece atalhos de navegação entre as visualizações e as ações do Symfony e do Zend. Esses atalhos foram aprimorados no NetBeans 6.9. Além disso, o autocompletar de código em <em>visualizar</em> modelos/arquivos inclui variáveis que são declarados nos arquivos <em>controlador/ação</em>. Consulte a <a target="_blank" href="http://blogs.sun.com/netbeansphp/entry/framework_support_improvements">publicação no blog do NetBeans PHP</a> para detalhes.</p> | |
| <p>Para saber mais sobre o suporte da estrutura Zend, assista o <a href="../../docs/php/zend-framework-screencast.html">screencast</a> do Symfony.</p> | |
| <h2><a name="smarty"></a>Suporte ao Smarty</h2> | |
| <p>O NetBeans IDE 7.1 inclui um plug-in para o suporte à estrutura Smarty. Esse suporte inclui os recursos básicos do Smarty 3, ou seja, preenchimento de código e delimitadores do Smarty 3.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/smarty3.png" alt="Editor mostrando o suporte básico ao Smarty 3" width="364" height="136" class="margin-around b-all"></p> | |
| <p>Alterne entre o comportamento de Smarty 3 e Smarty 2 na janela Opções. Vá para Ferramentas > Opções (Preferências do NetBeans no MacOS), selecione PHP e, a seguir, abra a aba Smarty. O plug-in da estrutura Smarty deve estar instalado.</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/smarty-options.png" alt="Opções do Smarty" width="586" height="480" class="margin-around"></p> | |
| <h2><a href="/about/contact_form.html?to=3&subject=Feedback:%20PHP%20Editor%20Guide">Envie-nos seus comentários</a></h2> | |
| <br style="clear:both;" > | |
| <p>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, <a href="../../../community/lists/top.html">junte-se à lista de usuários users@php.netbeans.org</a>.</p> | |
| <p><a href="../../trails/php.html">Voltar à trilha do aprendizado PHP</a></p> | |
| </body> | |
| </html> |