netbeans.apache.org/src/content/kb/docs/php/project-setup_pt_BR.asciidoc - netbeans-website - Git at Google

 //
 //     Licensed to the Apache Software Foundation (ASF) under one
 //     or more contributor license agreements.  See the NOTICE file
 //     distributed with this work for additional information
 //     regarding copyright ownership.  The ASF licenses this file
 //     to you under the Apache License, Version 2.0 (the
 //     "License"); you may not use this file except in compliance
 //     with the License.  You may obtain a copy of the License at
 //
 //       http://www.apache.org/licenses/LICENSE-2.0
 //
 //     Unless required by applicable law or agreed to in writing,
 //     software distributed under the License is distributed on an
 //     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 //     KIND, either express or implied.  See the License for the
 //     specific language governing permissions and limitations
 //     under the License.
 //

 = Configurando um Projeto PHP
 :jbake-type: tutorial
 :jbake-tags: tutorials
 :jbake-status: published
 :icons: font
 :syntax: true
 :source-highlighter: pygments
 :toc: left
 :toc-title:
 :description: Configurando um Projeto PHP - Apache NetBeans
 :keywords: Apache NetBeans, Tutorials, Configurando um Projeto PHP

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


 *Para seguir este tutorial, são necessários os recursos e o software a seguir.*

 |===
 |Software ou Recurso |Versão Necessária

 |link:https://netbeans.org/downloads/index.html[+NetBeans IDE+] |Pacote de download do PHP

 |Um mecanismo PHP |Versão 5

 |Um servidor web |É recomendado o link:http://httpd.apache.org/download.cgi[+Apache HTTP Server 2.2+].


 |Um depurador PHP |link:http://www.xdebug.org[+XDebug 2.0 ou superior+]
 |===


 == Preparando-se

 Antes de criar um projeto PHP, você precisa fazer download e instalar o link:https://netbeans.org/downloads/index.html[+NetBeans IDE para PHP+] e link:../../trails/php.html#configuration[+preparar o seu ambiente+] para desenvolvimento de PHP.

 Para configurar um projeto PHP:

 * <<location,Especifique o nome do projeto e a localização dos arquivos de código-fonte do projeto>>
 * <<runConfiguration,Especifique como o projeto será implantado>>

 Para alterar as definições de um projeto existente, posicione o cursor no nó do projeto e selecione Propriedades no menu pop-up. Prossiga como descrito na seção<<managingProjectSetup,Personalizando 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 será aberto
 3. Na lista Categorias, selecione PHP.

 Dependendo das suas necessidades, você pode criar um projeto PHP totalmente novo <<projectNoExistingSources,sem nenhum arquivo de código-fonte desenvolvido anteriormente>> ou <<importSources,importar uma splicação PHP local ou remota existente>> para um novo projeto.


 === Projeto sem Arquivos de Código-Fonte Desenvolvidos Anteriormente

 1. Na área Projetos, selecione Aplicação PHP e clique em Próximo. O painel Novo Projeto PHP > Nome e Localização será aberto.
 2. No campo de texto Nome do Projeto, digite 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 browser. A raiz do documento é especificada no link:../../trails/php.html#configuration[+arquivo de configuração+] do servidor Web. Depois da instalação, o assistente Novo Projeto localiza a raiz do documento e por default 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 <<copy-sources,Especificando a Configuração de Execução>>.


 . Na lista drop-down Codificação Default, selecione a codificação default do seu projeto.


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

 image::images/new-php-project-m1.png[]


 . Clique em Próximo. O painel Configuração de Execução será aberto.


 === Importando Arquivos Locais de Código-Fonte Existentes para um Projeto

 1. Na área Projetos, selecione Aplicação PHP com Códigos-Fonte Existentes e clique em Próximo. O painel Novo Projeto PHP > Nome e Localização será aberto.
 2. No campo de texto Nome do Projeto, digite 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.

 NOTE: <<localServer, se você for executar o projeto em um servidor Web local, não se esqueça de especificar a >><<copyFilesFromSourcesFolder,cópia dos arquivos de código-fonte>> para ele.


 . Na lista drop-down Codificação Default, selecione a codificação default do seu projeto.


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

 image::images/new-php-project-with-ssources.png[]


 . Clique em Próximo. O painel Configuração de Execução será aberto.


 === Importando Arquivos Remotos de Código-Fonte Existentes para um Projeto

 1. Na área Projetos, selecione Aplicação PHP do Servidor Remoto e clique em Próximo. O painel Novo Projeto PHP > Nome e Localização será aberto.
 2. No campo de texto Nome do Projeto, digite o nome do projeto.
 3. No campo Pasta de Códigos-Fonte, especifique a subpasta raiz _local_ de documentos na qual 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 browser. A raiz do documento é especificada no link:../../trails/php.html#configuration[+arquivo de configuração+] do servidor Web. Depois da instalação, o assistente Novo Projeto localiza a raiz do documento e por default especifica o seguinte caminho:  ``<Raiz do Documento>\<Novo Projeto PHP>`` . Observe que é útil poder testar o projeto em um servidor local.


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


 . Clique em Próximo. O painel Conexão Remota será aberto. O tutorial link:remote-hosting-and-ftp-account.html[+Implantando uma Aplicação PHP em um Servidor Web Remoto+] descreve como configurar conexões remotas.


 == Especificando a Configuração de Execução Default do Novo Projeto

 Uma configuração de execução é uma definiçã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 uma aplicação tiver sido desenvolvida localmente e for necessário fazer upload 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 Web do PHP em uma máquina local com um servidor Web local.
 * Execução de scripts PHP usando um mecanismo PHP local. Essa abordagem é aplicada a arquivos PHP não direcionados a saída em HTML. Portanto, esses scripts podem ser executados sem um browser.
 * Desenvolvimento Remoto. O código-fonte do PHP e outros arquivos da aplicação têm upload em um servidor Web remoto por meio de FTP. Esse caso de uso é comum quando o desenvolvimento é compartilhado entre várias pessoas.
 * Uma combinação dos casos de uso acima: uma aplicação é desenvolvida localmente e implantada em um servidor de produção remoto após a conclusão. Durante o desenvolvimento, os scripts do PHP serão executados, se necessário.

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

 * <<localServer,Web Site Local>>. Para usar essa configuração de execução, você precisa ter link:../../trails/php.html#configuration[+o servidor http Apache instalado+] e em execução.
 * link:remote-hosting-and-ftp-account.html[+Web Site Remoto (FTP/SFTP) (Tutorial separado)+]. Para usar esta configuração, você precisa de uma link:remote-hosting-and-ftp-account.html#registerHostingAccount[+conta de hospedagem+] em um servidor remoto e uma link:remote-hosting-and-ftp-account.html#createFTPAccount[+conta FTP+] nesse servidor.
 * <<scriptCommandLine,Script>>. Essa configuração de execução não requer que um servidor Web esteja instalado e em execução. Você precisa somente de um link:../../trails/php.html#configuration[+mecanismo PHP+].

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


 === Web Site Local

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

 *Para configurar um Web site local:*

 1. Na lista drop-down Executar Como, selecione Web Site Local.
 2. No campo URL do Projeto, verifique o endereço do URL gerado automaticamente. Verifique se o servidor HTTP do Apache ouve a porta default 80. Caso contrário, especifique explicitamente o número da porta no formato  ``localhost:<número da porta>`` .

 image::images/run-configuration-local-server-project-with-existing-sources.png[]


 . Se você estiver criando um projeto a partir de códigos-fonte existentes, poderá selecionar qual arquivo de código-fonte usar como o arquivo de índice.


 . Para armazenar os arquivos de código-fonte do projeto em um diretório diferente do diretório do projeto NetBeans IDE, selecione “Copiar arquivos da Pasta de Códigos-Fonte para outro local”. _Se você estiver criando um projeto a partir de códigos-fonte existentes, essa é uma etapa necessária, a não ser que os códigos-fonte existentes já estejam na pasta Web do servidor Apache._
 O campo, por default, especifica o seguinte caminho:  ``<Raiz do Documento>\<Novo Projeto PHP>`` . Se necessário, use o botão Procurar para especificar um caminho diferente.
 A raiz do documento é a pasta em que o servidor Web procura por arquivos a serem abertos no browser. A raiz do documento é especificada no link:../../trails/php.html#configuration[+arquivo de configuração+] do servidor Web.
 O assistente detecta o tipo de instalação do Apache, um componente ou dentro de um pacote, e fornece o caminho para a localização default da pasta  ``htdocs``  do tipo de instalação atual. Portanto, se você tiver aceitado as definições default durante a instalação do servidor Apache ou do pacote AMP, selecione o caminho na lista drop-down.


 . Clique em Finalizar. O IDE criará o projeto PHP.


 === Web Site Remoto

 Cosulte o tutorial link:remote-hosting-and-ftp-account.html[+Implantando uma Aplicação PHP a um Servidor Web Remoto+].


 === Script

 1. Na lista drop-down Executar Como, selecione Script.

 image::images/project-properties-script.png[]


 . Para especificar a localização do mecanismo PHP, clique no botão Configurar ao lado da caixa Usar Interpretador PHP Default. A caixa de diálogo Opções do PHP será aberta na guia Geral.

 image::images/run-config-script-options-m1.png[]


 . No campo Interpretador do PHP 5, especifique o caminho para o arquivo  ``php.exe`` . Use o botão Procurar ou Pesquisar..., se necessário.


 . Para especificar como os resultados da execução do script serão mostrados, marque a caixa de seleçã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.
 * Web Browser. A janela do browser default 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.


 . Clique em OK. A caixa de diálogo Opções se fechará e o sistema retornará para o painel Configuração de Execução.


 . Adicionar qualquer argumento, como  ``debug=true``  e qualquer link:http://www.php.net/manual/en/features.commandline.options.php[+opção de linha de comandos PHP+].


 == Personalizando a Configuração do Projeto

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


 === Códigos-fonte


 No painel Códigos-fonte:

 1. O campo Raiz da Web mostra a pasta raiz do site da sua aplicação. Por default, o campo mostra a pasta Códigos-fonte. Para alterar a raiz da Web, clique em Procurar e selecione outra pasta.
 2. Selecione <<location,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

 image::images/pprop-sources.png[]


 . 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 default e/ou defina novas configurações de execução, se necessário.

 1. Para modificar as definições default, <<runConfiguration,atualize os campos como durante a criação do projeto>>.
 2. Para definir uma nova configuração de execução, clique em Novo, ao lado da lista drop-down Configuração. A caixa de diálogo Criar Nova Configuração será aberta.
 3. No campo Nome da Configuração, digite o nome da nova configuração de execução e clique em OK. Você retornará para o painel Configuração de Execução.
 4. Especifique as definições da configuração de execução da mesma forma que a <<runConfiguration,configuração de execução default>> foi definida durante a criação do projeto e clique em OK. A nova configuração será adicionada à lista drop-down Configuração.
 5. Para remover uma configuração, selecione-a na lista drop-down Configuração e clique em Deletar.

 image::images/pprop-runconfig.png[]


 . Para concluir a personalização do projeto, clique em OK.


 === Incluir Caminho do PHP


 No painel Incluir Caminho, 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 será aberta.
 2. Selecione as pastas relevantes e clique em Abrir. Você retornará para o painel Incluir Caminho do PHP. A nova pasta será 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.

 image::images/pprop-include-path.png[]


 . Para concluir a personalização do projeto, clique em OK.


 === Formatando

 No painel Formatação, defina o estilo de formatação que deseja aplicar aos arquivos de código-fonte no editor. Você poderá definir se a formatação será global ou específica de projeto.

 *Para definir a formatação global do IDE:*

 1. Selecione "Usar opções globais".
 2. Clique em Editar Opções Globais. A caixa de diálogo de opções do IDE abre na guia Editor > Formatação.

 image::images/global-formatting.png[]


 . Da lista drop-down Linguagem, selecione a linguagem na qual as definições deverão ser aplicadas.


 . Na lista drop-down Categorias, selecione os itens de formato nos quais a definição será aplicada.


 . Defina sua formatação desejada e clique em OK.


 . Clique no botão Ajuda para obter informações detalhadas.

 *Para definir a formatação específica do projeto:*

 1. Selecione “Usar opções específicas do projeto". A área oculta será exibida. image:images/pprop-formatting.png[]
 2. Na lista drop-down Linguagem, selecione Todas as Linguagens ou PHP. Nesse caso, Todas as Linguagens é o PHP e todas as outras linguagens você tem no seu projeto PHP.
 3. Na lista drop-down Categorias, selecione os itens de formato nos quais a definiçã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 incorporadas 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 ativa Autocompletar Código e todas as outras funcionalidades relacionadas ao JavaScript no IDE para o seu projeto.

 *Para adicionar Bibliotecas JavaScript ao seu projeto:*

 1. Faça download das bibliotecas de JavaScript necessárias ou localize-as se já as tiver.
 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 estiverem definidas para que os códigos-fonte do projeto sejam copiados para outro local (consulte <<sources,Códigos-Fonte>>), as bibliotecas JavaScript também serão copiadas para esse local. Se o seu projeto for implantado em um servidor remoto, as bibliotecas JavaScript terão upload nesse servidor na próxima vez que o upload dos códigos-fonte do projeto for feito no servidor.

 link:/about/contact_form.html?to=3&subject=Feedback:%20PHP%20Project%20Setup[+Enviar Feedback neste Tutorial+]


 Para enviar comentários e sugestões, obter suporte e manter-se informado sobre os desenvolvimentos mais recentes das funcionalidades de desenvolvimento PHP do NetBeans IDE, link:../../../community/lists/top.html[+junte-se à lista de correspondência users@php.netbeans.org+].

 link:../../trails/php.html[+Voltar à Trilha do Aprendizado PHP+]
	//
	// Licensed to the Apache Software Foundation (ASF) under one
	// or more contributor license agreements. See the NOTICE file
	// distributed with this work for additional information
	// regarding copyright ownership. The ASF licenses this file
	// to you under the Apache License, Version 2.0 (the
	// "License"); you may not use this file except in compliance
	// with the License. You may obtain a copy of the License at
	//
	// http://www.apache.org/licenses/LICENSE-2.0
	//
	// Unless required by applicable law or agreed to in writing,
	// software distributed under the License is distributed on an
	// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	// KIND, either express or implied. See the License for the
	// specific language governing permissions and limitations
	// under the License.
	//

	= Configurando um Projeto PHP
	:jbake-type: tutorial
	:jbake-tags: tutorials
	:jbake-status: published
	:icons: font
	:syntax: true
	:source-highlighter: pygments
	:toc: left
	:toc-title:
	:description: Configurando um Projeto PHP - Apache NetBeans
	:keywords: Apache NetBeans, Tutorials, Configurando um Projeto PHP

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


	Para seguir este tutorial, são necessários os recursos e o software a seguir.

	\|===
	\|Software ou Recurso \|Versão Necessária

	\|link:https://netbeans.org/downloads/index.html[+NetBeans IDE+] \|Pacote de download do PHP

	\|Um mecanismo PHP \|Versão 5

	\|Um servidor web \|É recomendado o link:http://httpd.apache.org/download.cgi[+Apache HTTP Server 2.2+].


	\|Um depurador PHP \|link:http://www.xdebug.org[+XDebug 2.0 ou superior+]
	\|===


	== Preparando-se

	Antes de criar um projeto PHP, você precisa fazer download e instalar o link:https://netbeans.org/downloads/index.html[+NetBeans IDE para PHP+] e link:../../trails/php.html#configuration[+preparar o seu ambiente+] para desenvolvimento de PHP.

	Para configurar um projeto PHP:

	* <<location,Especifique o nome do projeto e a localização dos arquivos de código-fonte do projeto>>
	* <<runConfiguration,Especifique como o projeto será implantado>>

	Para alterar as definições de um projeto existente, posicione o cursor no nó do projeto e selecione Propriedades no menu pop-up. Prossiga como descrito na seção<<managingProjectSetup,Personalizando 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 será aberto
	3. Na lista Categorias, selecione PHP.

	Dependendo das suas necessidades, você pode criar um projeto PHP totalmente novo <<projectNoExistingSources,sem nenhum arquivo de código-fonte desenvolvido anteriormente>> ou <<importSources,importar uma splicação PHP local ou remota existente>> para um novo projeto.


	=== Projeto sem Arquivos de Código-Fonte Desenvolvidos Anteriormente

	1. Na área Projetos, selecione Aplicação PHP e clique em Próximo. O painel Novo Projeto PHP > Nome e Localização será aberto.
	2. No campo de texto Nome do Projeto, digite 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 browser. A raiz do documento é especificada no link:../../trails/php.html#configuration[+arquivo de configuração+] do servidor Web. Depois da instalação, o assistente Novo Projeto localiza a raiz do documento e por default 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 <<copy-sources,Especificando a Configuração de Execução>>.



	. Na lista drop-down Codificação Default, selecione a codificação default do seu projeto.


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

	image::images/new-php-project-m1.png[]



	. Clique em Próximo. O painel Configuração de Execução será aberto.


	=== Importando Arquivos Locais de Código-Fonte Existentes para um Projeto

	1. Na área Projetos, selecione Aplicação PHP com Códigos-Fonte Existentes e clique em Próximo. O painel Novo Projeto PHP > Nome e Localização será aberto.
	2. No campo de texto Nome do Projeto, digite 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.

	NOTE: <<localServer, se você for executar o projeto em um servidor Web local, não se esqueça de especificar a >><<copyFilesFromSourcesFolder,cópia dos arquivos de código-fonte>> para ele.



	. Na lista drop-down Codificação Default, selecione a codificação default do seu projeto.


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

	image::images/new-php-project-with-ssources.png[]



	. Clique em Próximo. O painel Configuração de Execução será aberto.


	=== Importando Arquivos Remotos de Código-Fonte Existentes para um Projeto

	1. Na área Projetos, selecione Aplicação PHP do Servidor Remoto e clique em Próximo. O painel Novo Projeto PHP > Nome e Localização será aberto.
	2. No campo de texto Nome do Projeto, digite o nome do projeto.
	3. No campo Pasta de Códigos-Fonte, especifique a subpasta raiz _local_ de documentos na qual 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 browser. A raiz do documento é especificada no link:../../trails/php.html#configuration[+arquivo de configuração+] do servidor Web. Depois da instalação, o assistente Novo Projeto localiza a raiz do documento e por default especifica o seguinte caminho: ``<Raiz do Documento>\<Novo Projeto PHP>`` . Observe que é útil poder testar o projeto em um servidor local.



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


	. Clique em Próximo. O painel Conexão Remota será aberto. O tutorial link:remote-hosting-and-ftp-account.html[+Implantando uma Aplicação PHP em um Servidor Web Remoto+] descreve como configurar conexões remotas.


	== Especificando a Configuração de Execução Default do Novo Projeto

	Uma configuração de execução é uma definiçã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 uma aplicação tiver sido desenvolvida localmente e for necessário fazer upload 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 Web do PHP em uma máquina local com um servidor Web local.
	* Execução de scripts PHP usando um mecanismo PHP local. Essa abordagem é aplicada a arquivos PHP não direcionados a saída em HTML. Portanto, esses scripts podem ser executados sem um browser.
	* Desenvolvimento Remoto. O código-fonte do PHP e outros arquivos da aplicação têm upload em um servidor Web remoto por meio de FTP. Esse caso de uso é comum quando o desenvolvimento é compartilhado entre várias pessoas.
	* Uma combinação dos casos de uso acima: uma aplicação é desenvolvida localmente e implantada em um servidor de produção remoto após a conclusão. Durante o desenvolvimento, os scripts do PHP serão executados, se necessário.

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

	* <<localServer,Web Site Local>>. Para usar essa configuração de execução, você precisa ter link:../../trails/php.html#configuration[+o servidor http Apache instalado+] e em execução.
	* link:remote-hosting-and-ftp-account.html[+Web Site Remoto (FTP/SFTP) (Tutorial separado)+]. Para usar esta configuração, você precisa de uma link:remote-hosting-and-ftp-account.html#registerHostingAccount[+conta de hospedagem+] em um servidor remoto e uma link:remote-hosting-and-ftp-account.html#createFTPAccount[+conta FTP+] nesse servidor.
	* <<scriptCommandLine,Script>>. Essa configuração de execução não requer que um servidor Web esteja instalado e em execução. Você precisa somente de um link:../../trails/php.html#configuration[+mecanismo PHP+].

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


	=== Web Site Local

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

	Para configurar um Web site local:

	1. Na lista drop-down Executar Como, selecione Web Site Local.
	2. No campo URL do Projeto, verifique o endereço do URL gerado automaticamente. Verifique se o servidor HTTP do Apache ouve a porta default 80. Caso contrário, especifique explicitamente o número da porta no formato ``localhost:<número da porta>`` .

	image::images/run-configuration-local-server-project-with-existing-sources.png[]



	. Se você estiver criando um projeto a partir de códigos-fonte existentes, poderá selecionar qual arquivo de código-fonte usar como o arquivo de índice.


	. Para armazenar os arquivos de código-fonte do projeto em um diretório diferente do diretório do projeto NetBeans IDE, selecione “Copiar arquivos da Pasta de Códigos-Fonte para outro local”. _Se você estiver criando um projeto a partir de códigos-fonte existentes, essa é uma etapa necessária, a não ser que os códigos-fonte existentes já estejam na pasta Web do servidor Apache._
	O campo, por default, especifica o seguinte caminho: ``<Raiz do Documento>\<Novo Projeto PHP>`` . Se necessário, use o botão Procurar para especificar um caminho diferente.
	A raiz do documento é a pasta em que o servidor Web procura por arquivos a serem abertos no browser. A raiz do documento é especificada no link:../../trails/php.html#configuration[+arquivo de configuração+] do servidor Web.
	O assistente detecta o tipo de instalação do Apache, um componente ou dentro de um pacote, e fornece o caminho para a localização default da pasta ``htdocs`` do tipo de instalação atual. Portanto, se você tiver aceitado as definições default durante a instalação do servidor Apache ou do pacote AMP, selecione o caminho na lista drop-down.


	. Clique em Finalizar. O IDE criará o projeto PHP.


	=== Web Site Remoto

	Cosulte o tutorial link:remote-hosting-and-ftp-account.html[+Implantando uma Aplicação PHP a um Servidor Web Remoto+].


	=== Script

	1. Na lista drop-down Executar Como, selecione Script.

	image::images/project-properties-script.png[]



	. Para especificar a localização do mecanismo PHP, clique no botão Configurar ao lado da caixa Usar Interpretador PHP Default. A caixa de diálogo Opções do PHP será aberta na guia Geral.

	image::images/run-config-script-options-m1.png[]



	. No campo Interpretador do PHP 5, especifique o caminho para o arquivo ``php.exe`` . Use o botão Procurar ou Pesquisar..., se necessário.


	. Para especificar como os resultados da execução do script serão mostrados, marque a caixa de seleçã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.
	* Web Browser. A janela do browser default 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.


	. Clique em OK. A caixa de diálogo Opções se fechará e o sistema retornará para o painel Configuração de Execução.


	. Adicionar qualquer argumento, como ``debug=true`` e qualquer link:http://www.php.net/manual/en/features.commandline.options.php[+opção de linha de comandos PHP+].


	== Personalizando a Configuração do Projeto

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


	=== Códigos-fonte


	No painel Códigos-fonte:

	1. O campo Raiz da Web mostra a pasta raiz do site da sua aplicação. Por default, o campo mostra a pasta Códigos-fonte. Para alterar a raiz da Web, clique em Procurar e selecione outra pasta.
	2. Selecione <<location,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

	image::images/pprop-sources.png[]



	. 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 default e/ou defina novas configurações de execução, se necessário.

	1. Para modificar as definições default, <<runConfiguration,atualize os campos como durante a criação do projeto>>.
	2. Para definir uma nova configuração de execução, clique em Novo, ao lado da lista drop-down Configuração. A caixa de diálogo Criar Nova Configuração será aberta.
	3. No campo Nome da Configuração, digite o nome da nova configuração de execução e clique em OK. Você retornará para o painel Configuração de Execução.
	4. Especifique as definições da configuração de execução da mesma forma que a <<runConfiguration,configuração de execução default>> foi definida durante a criação do projeto e clique em OK. A nova configuração será adicionada à lista drop-down Configuração.
	5. Para remover uma configuração, selecione-a na lista drop-down Configuração e clique em Deletar.

	image::images/pprop-runconfig.png[]



	. Para concluir a personalização do projeto, clique em OK.


	=== Incluir Caminho do PHP


	No painel Incluir Caminho, 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 será aberta.
	2. Selecione as pastas relevantes e clique em Abrir. Você retornará para o painel Incluir Caminho do PHP. A nova pasta será 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.

	image::images/pprop-include-path.png[]



	. Para concluir a personalização do projeto, clique em OK.


	=== Formatando

	No painel Formatação, defina o estilo de formatação que deseja aplicar aos arquivos de código-fonte no editor. Você poderá definir se a formatação será global ou específica de projeto.

	Para definir a formatação global do IDE:

	1. Selecione "Usar opções globais".
	2. Clique em Editar Opções Globais. A caixa de diálogo de opções do IDE abre na guia Editor > Formatação.

	image::images/global-formatting.png[]



	. Da lista drop-down Linguagem, selecione a linguagem na qual as definições deverão ser aplicadas.


	. Na lista drop-down Categorias, selecione os itens de formato nos quais a definição será aplicada.


	. Defina sua formatação desejada e clique em OK.


	. Clique no botão Ajuda para obter informações detalhadas.

	Para definir a formatação específica do projeto:

	1. Selecione “Usar opções específicas do projeto". A área oculta será exibida. image:images/pprop-formatting.png[]
	2. Na lista drop-down Linguagem, selecione Todas as Linguagens ou PHP. Nesse caso, Todas as Linguagens é o PHP e todas as outras linguagens você tem no seu projeto PHP.
	3. Na lista drop-down Categorias, selecione os itens de formato nos quais a definiçã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 incorporadas 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 ativa Autocompletar Código e todas as outras funcionalidades relacionadas ao JavaScript no IDE para o seu projeto.

	Para adicionar Bibliotecas JavaScript ao seu projeto:

	1. Faça download das bibliotecas de JavaScript necessárias ou localize-as se já as tiver.
	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 estiverem definidas para que os códigos-fonte do projeto sejam copiados para outro local (consulte <<sources,Códigos-Fonte>>), as bibliotecas JavaScript também serão copiadas para esse local. Se o seu projeto for implantado em um servidor remoto, as bibliotecas JavaScript terão upload nesse servidor na próxima vez que o upload dos códigos-fonte do projeto for feito no servidor.

	link:/about/contact_form.html?to=3&subject=Feedback:%20PHP%20Project%20Setup[+Enviar Feedback neste Tutorial+]


	Para enviar comentários e sugestões, obter suporte e manter-se informado sobre os desenvolvimentos mais recentes das funcionalidades de desenvolvimento PHP do NetBeans IDE, link:../../../community/lists/top.html[+junte-se à lista de correspondência users@php.netbeans.org+].

	link:../../trails/php.html[+Voltar à Trilha do Aprendizado PHP+]