| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <!-- |
| Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. |
| --> |
| <html> |
| <head> |
| <title>适用于 PHP 的 NetBeans IDE:项目设置 </title> |
| <meta name="KEYWORDS" content="NETBEANS, start, PHP development, create project"> |
| <meta name="DESCRIPTION" content="Start PHP development in NetBeans IDE, create project" > |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css" media="screen"></head> |
| <body> |
| <h1>设置 PHP 项目</h1> |
| <p>本教程介绍了如何在 NetBeans IDE 中设置 PHP 项目。 </p> |
| <p><b>目录</b></p> |
| <img alt="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0" class="stamp" src="../../../images_www/articles/73/netbeans-stamp-80-74-73.png" title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"> |
| <ul class="toc"> |
| <li><a href="#gettingReady">准备工作</a></li> |
| <li><a href="#location">指定新项目的名称和位置</a> |
| <ul> |
| <li><a href="#projectNoExistingSources">不包含以前开发的源文件的项目</a></li> |
| <li><a href="#importSources">将现有的本地源文件导入到项目中</a></li> |
| <li><a href="#remote-sources">将现有的远程源文件导入到项目中</a></li> |
| </ul> |
| </li> |
| <li><a href="#runConfiguration">指定新项目的运行配置</a> |
| <ul> |
| <li><a href="#localServer">本地 Web 站点</a></li> |
| <li><a href="#remiteWebSite">远程 Web 站点</a></li> |
| <li><a href="#scriptCommandLine">脚本</a></li> |
| </ul> |
| </li> |
| <li><a href="#managingProjectSetup">定制项目设置</a> |
| <ul> |
| <li><a href="#sources">源</a></li> |
| <li><a href="#run-configuration-panel">运行配置</a></li> |
| <li><a href="#phpIncludePath">PHP 包含路径</a></li> |
| <li><a href="#formatting">格式设置</a></li> |
| <li><a href="#add-js-libraries">添加 JavaScript 库</a></li> |
| </ul> |
| </li> |
| |
| </ul> |
| <p><b>要学习本教程,您需要具备以下软件和资源。</b></p> |
| <table> |
| <tbody> |
| <tr> |
| <th class="tblheader" scope="col">软件或资源</th> |
| <th class="tblheader" scope="col">要求的版本</th> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="https://netbeans.org/downloads/index.html" target="_blank">NetBeans IDE</a></td> |
| <td class="tbltd1">PHP 下载包</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">PHP 引擎</td> |
| <td class="tbltd1">版本 5 |
| </tr> |
| <tr> |
| <td class="tbltd1">Web 服务器</td> |
| <td>推荐使用 <a href="http://httpd.apache.org/download.cgi" target="_blank">Apache HTTP Server 2.2</a>。<br></td> |
| </tr> |
| <tr> |
| <td class="tbltd1">PHP 调试器</td> |
| <td><a href="http://www.xdebug.org" target="_blank">XDebug 2.0 或更高版本</a></td> |
| </tr> |
| </tbody> |
| </table> |
| <h2><a name="gettingReady"></a>准备工作</h2> |
| <p>在创建 PHP 项目之前,您需要下载并安装<a href="https://netbeans.org/downloads/index.html" target="_blank">适用于 PHP 的 NetBeans IDE</a>,并且<a href="../../trails/php.html#configuration">准备好环境</a>以便进行 PHP 开发。 |
| </p> |
| |
| <p>要设置 PHP 项目,请执行以下操作: </p> |
| <ul> |
| <li><a href="#location">指定项目名称和项目源文件的位置</a></li> |
| <li><a href="#runConfiguration">指定部署项目的方式</a></li> |
| </ul> |
| 要更改现有项目的设置,请将光标置于该项目节点上,然后从弹出式菜单中选择 "Properties"(属性)。按照<a href="#managingProjectSetup">定制项目设置</a>部分中的所述继续操作。 |
| <h2><a name="location"></a>指定项目名称和源文件的位置 </h2> |
| <ol> |
| <li>启动 IDE,然后切换至 "Projects"(项目)窗口。 </li> |
| <li>选择 "File"(文件)> "New Project"(新建项目)。"Choose Project"(选择项目)面板打开。 </li> |
| <li>在 "Categories"(类别)列表中,选择 "PHP"。 </li></ol> |
| <p>您可以创建<a href="#projectNoExistingSources">不包含以前开发的任何源文件</a>的全新 PHP 项目,也可以<a href="#importSources">将现有的本地 PHP 应用程序导入</a>或将远程 PHP 应用程序导入到新项目中,具体取决于您的需要。 </p> |
| <div class="indent"> |
| <h3><a name="projectNoExistingSources"></a>不包含以前开发的源文件的项目</h3> |
| <ol> |
| <li>在 "Projects"(项目)区域中,选择 "PHP Application"(PHP 应用程序),然后单击 "Next"(下一步)。"New PHP Project"(新建 PHP 项目)的 "Name and Location"(名称和位置)面板打开。 </li> |
| <li>在 "Project Name"(项目名称)文本字段中,输入项目的名称。 </li> |
| <li><a name="sources-folder"></a>在 "Sources Folder"(源文件夹)字段中,指定您要在其中存储源文件的文档根目录的子文件夹。 |
| <p>本地 Web 服务器会从文档根目录文件夹中查找要在浏览器中打开的文件。文档根目录是在 Web 服务器<a href="../../trails/php.html#configuration">配置文件</a>中指定的。安装完成后,新建项目向导将会找到文档根目录,并在默认情况下指定以下路径:<tt><文档根目录>\<新 PHP 项目></tt>。</p> |
| <p class="notes">源文件的副本必须保存在文档根目录的子文件夹中。不过,您也可以选择文档根目录以外的其他位置作为源文件夹,然后将该位置中的源文件复制到文档根目录。请参见<a href="#copy-sources">指定运行配置</a>。</p> |
| </li> |
| <li>从 "Default Encoding"(默认编码)下拉列表中,选择项目的默认编码。 </li> |
| <li>如果要在不同于源文件的位置存储 NetBeans 元数据,请选择 "Put NetBeans metadata into a separate directory."(将 NetBeans 元数据放入单独的目录)。例如,您可能希望将源文件存储在文档根目录,而将 NetBeans 元数据存储在 NetBeansProjects 目录。 <br> <img alt="字段已填写的 "New PHP Project"(新建 PHP 项目)面板" class="margin-around" src="../../../images_www/articles/72/php/project-setup/new-php-project-m1.png"></li> |
| <li> 单击 "Next"(下一步)。"Run Configuration"(运行配置)面板打开。 </li> |
| </ol> |
| <h3><a name="importSources"></a>将现有的本地源文件导入到项目中</h3> |
| <ol> |
| <li>在 "Projects"(项目)区域中,选择 "PHP Application with Existing Sources"(基于现有源代码的 PHP 应用程序),然后单击 "Next"(下一步)。"New PHP Project"(新建 PHP 项目)的 "Name and Location"(名称和位置)面板打开。 </li> |
| <li>在 "Project Name"(项目名称)文本字段中,输入项目的名称。 </li> |
| <li>在 "Sources Folder"(源文件夹)字段中,指定要从中导入源文件的文件夹。<br> <strong>注:</strong>如果要<a href="#localServer">在本地 Web 服务器上运行项目</a>,请不要忘记指定<a href="#copyFilesFromSourcesFolder">将源文件复制</a>到该服务器上。</li> |
| <li>从 "Default Encoding"(默认编码)下拉列表中,选择项目的默认编码。 </li> |
| <li>如果要在不同于源文件的位置存储 NetBeans 元数据,请选择 "Put NetBeans metadata into a separate directory."(将 NetBeans 元数据放入单独的目录)。例如,您可能希望将源文件存储在文档根目录,而将 NetBeans 元数据存储在 NetBeansProjects 目录。 <br> <img alt="使用现有源且已填写字段的 "New PHP Project"(新建 PHP 项目)面板" class="margin-around" src="../../../images_www/articles/72/php/project-setup/new-php-project-with-ssources.png"></li> |
| <li> 单击 "Next"(下一步)。"Run Configuration"(运行配置)面板打开。 </li> |
| </ol> |
| |
| <h3><a name="remote-sources"></a>将现有的远程源文件导入到项目中</h3> |
| <ol> |
| <li>在 "Projects"(项目)区域中,选择 "PHP Application from Remote Server"(来自远程服务器的 PHP 应用程序),然后单击 "Next"(下一步)。"New PHP Project"(新建 PHP 项目)的 "Name and Location"(名称和位置)面板打开。 </li> |
| <li>在 "Project Name"(项目名称)文本字段中,输入项目的名称。 </li> |
| <li>在 "Sources Folder"(源文件夹)字段中,指定您要在其中存储源文件的<em>本地</em>文档根目录的子文件夹。 |
| <p>本地 Web 服务器会从文档根目录文件夹中查找要在浏览器中打开的文件。文档根目录是在 Web 服务器<a href="../../trails/php.html#configuration">配置文件</a>中指定的。安装完成后,新建项目向导将会找到文档根目录,并在默认情况下指定以下路径:<tt><文档根目录>\<新 PHP 项目></tt>。请注意,必须能够在本地服务器上测试项目,这一点很有用。</p> |
| </li> |
| <li>如果要在不同于源文件的位置存储 NetBeans 元数据,请选择 "Put NetBeans metadata into a separate directory."(将 NetBeans 元数据放入单独的目录)。例如,您可能希望将源文件存储在文档根目录,而将 NetBeans 元数据存储在 NetBeansProjects 目录。 </li> |
| <li> 单击 "Next"(下一步)。"Remote Connection"(远程连接)面板打开。<a href="remote-hosting-and-ftp-account.html" target="_blank">将 PHP 应用程序部署到远程 Web 服务器</a>教程介绍了如何设置远程连接。</li> |
| </ol> |
| </div> |
| <h2><a id="runConfiguration" name="runConfiguration"></a>指定新项目的默认运行配置 </h2> |
| <p>运行配置是用于运行 PHP 项目的存储设置。您可以为一个项目定义若干个配置,并在这些配置之间来回切换。例如,如果已在本地开发某个应用程序,但需要将其上载到远程生产服务器上,则只需选择其他运行配置即可。运行配置既适用运行操作,又适用调试操作。运行配置可满足以下常见用例的需要: </p> |
| <ul> |
| <li>在装有本地 Web 服务器的本地计算机上开发 PHP Web 页。 </li> |
| <li>使用本地 PHP 引擎执行 PHP 脚本。此方法适用不输出 HTML 的 PHP 文件。因此,可以在没有浏览器的情况下运行此类脚本。</li> |
| <li>远程开发。PHP 源代码和其他应用程序文件通过 FTP 上载到远程 Web 服务器。此用例常见于多人共同开发的情况。</li> |
| <li>以上用例的组合:应用程序在本地开发,开发完成后部署到远程生产服务器上。在开发过程中,将根据需要执行 PHP 脚本。</li> |
| </ul> |
| <p>创建新的 PHP 项目时,将创建该项目的默认运行配置。要设置项目的默认运行配置,请从 "Run Configuration"(运行配置)面板上的 "Run As"(运行方式)下拉列表中选择相关的选项。可以使用以下选项:<ul> |
| <li><a href="#localServer">本地 Web 站点</a>。要使用此运行配置,您需要<a href="../../trails/php.html#configuration">安装 Apache HTTP 服务器</a>并使其处于运行状态。 </li> |
| <li><a href="remote-hosting-and-ftp-account.html" target="_blank">远程 Web 站点 (FTP/SFTP)(单独的教程)</a>。要使用此配置,您需要在远程服务器上具有一个<a href="remote-hosting-and-ftp-account.html#registerHostingAccount">托管帐户</a>和一个 <a href="remote-hosting-and-ftp-account.html#createFTPAccount">FTP 帐户</a>。 </li> |
| <li><a href="#scriptCommandLine">脚本</a>。此运行配置不需要安装和运行 Web 服务器。您只需要一个 <a href="../../trails/php.html#configuration">PHP 引擎</a>。</li> |
| </ul> |
| <p>创建其他运行配置或编辑默认运行配置的过程在<a href="#runConfiguration">定制项目设置:运行配置</a>中进行了介绍。该过程与创建默认运行配置的过程几乎相同,除非您使用的是现有项目的 "Properties"(属性)对话框而非新建项目向导。</p> |
| <div class="indent"> |
| <h3><a name="localServer"></a>本地 Web 站点</h3> |
| <p>本地的 Web 站点配置中包含 PHP 源文件夹的副本,该文件夹位于计算机上安装的 Apache Web 服务器的 Web 文件夹中。使项目中既包含本地 Web 站点配置又包含远程 Web 站点配置,是一种常见的做法。请注意,设置本地 Web 站点运行配置的过程略有不同,这取决于项目是否基于现有源创建。</p> |
| <p><strong>设置本地 Web 站点配置:</strong></p> |
| <ol> |
| <li>从 "Run As"(运行方式)下拉列表中,选择 "Local Web Site"(本地 Web 站点)。</li> |
| <li>在 "Project URL"(项目 URL)字段中,检查自动生成的 URL 地址。确保 Apache HTTP 服务器监听默认端口 80。如果不是这样,请采用 <tt>localhost:<port number></tt> 格式明确指定端口号。<br> <img alt="项目运行配置:本地 Web 服务器" class="margin-around" src="../../../images_www/articles/72/php/project-setup/run-configuration-local-server-project-with-existing-sources.png"></li> |
| |
| <li>如果项目是基于现有源创建的,则可以选择将哪个源文件用作索引文件。</li> |
| <li>要将项目的源文件存储在不同于 NetBeans IDE 项目的目录中,请选择 "Copy files from Sources Folder to another location"(将源文件夹中的文件复制到其他位置)。<em>如果项目是基于现有源创建的,则这是必需的步骤,除非现有源已位于 Apache 服务器的 Web 文件夹中。</em><br> 默认情况下,该字段将指定以下路径:<tt><文档根目录>\<新 PHP 项目></tt>。使用 "Browse"(浏览)按钮指定其他路径(如若需要)。<br> Web 服务器会从文档根目录文件夹中查找要在浏览器中打开的文件。文档根目录是在 Web 服务器<a href="../../trails/php.html#configuration">配置文件</a>中指定的。<br> 该向导将检测 Apache 安装类型(组件或在包内),并提供当前安装类型的 <tt>htdocs</tt> 文件夹默认位置的路径。因此,如果在安装 Apache 服务器或 AMP 包的过程中接受了默认设置,请从下拉列表中选择路径。 </li> |
| <li>单击 "Finish"(完成)。IDE 将创建 PHP 项目。</li> |
| </ol> |
| |
| <h3><a name="remiteWebSite"></a>远程 Web 站点</h3> |
| <p>请参见<a href="remote-hosting-and-ftp-account.html">将 PHP 应用程序部署到远程 Web 服务器</a>教程。</p> |
| <h3><a name="scriptCommandLine"></a>脚本</h3> |
| <ol> |
| <li>从 "Run As"(运行方式)下拉列表中,选择 "Script"(脚本)。<br> <img alt="显示选中 "Run As...Script"(运行方式...脚本)的 "Run Configuration"(运行配置)属性的 "Project Properties"(项目属性)对话框" class="margin-around" height="467" src="../../../images_www/articles/72/php/project-setup/project-properties-script.png" width="600"></li> |
| <li>要指定 PHP 引擎的位置,请单击 "Use Default PHP Interpreter"(使用默认 PHP 解释器)复选框旁边的 "Configure"(配置)按钮。此时将打开 PHP 的 "Options"(选项)对话框中的 "General"(常规)标签。<br><img alt="项目运行配置:脚本。指定 PHP 引擎的路径和输出位置" class="margin-around" height="199" src="../../../images_www/articles/72/php/project-setup/run-config-script-options-m1.png" width="565"> </li> |
| <li>在 "PHP 5 Interpreter"(PHP 5 解释器)字段中,指定 <tt>php.exe</tt> 文件的路径。根据需要使用 "Browse..."(浏览...)或 "Search..."(搜索...)按钮。 |
| </li> |
| <li>要指定脚本执行结果的显示方式,请在 "Open Result In"(显示结果的位置)区域中选中相关的复选框。可以使用以下选项:<br> <br> |
| <ul> |
| <li>"Output"(输出)窗口。将在 NetBeans IDE 窗口底部的输出窗口中显示执行脚本的结果。 </li> |
| <li>Web 浏览器。将在默认的浏览器窗口中以 HTML 文件的形式显示执行脚本的结果。 </li> |
| <li>编辑器。将在 IDE 编辑器窗口中以 HTML 文件的形式显示执行脚本的结果。 </li> |
| </ul> |
| </li> |
| <li>单击 "OK"(确定)。将关闭 "Options"(选项)对话框,并且系统返回到 "Run Configuration"(运行配置)面板。 <br> |
| </li> |
| <li>添加任意参数,如 <tt>debug=true</tt>,以及任意 <a href="http://www.php.net/manual/en/features.commandline.options.php" target="_blank">PHP 命令行选项</a>。</li> |
| </ol> |
| </div> |
| <h2><a name="managingProjectSetup"></a>定制项目设置</h2> |
| <p>在项目创建过程中,将定义基本的项目设置:项目类型、项目源文件的位置以及默认运行配置。要使用新设置扩展项目设置,请定制项目。将光标置于项目节点上,然后从弹出式菜单中选择 "Properties"(属性)。"Project Properties"(项目属性)面板打开,其中显示了设置类别的列表。 |
| <div class="indent"> |
| <h3><a name="sources"></a>源</h3> |
| <br>在 "Sources"(源)面板上: |
| <ol> |
| <li>"Web Root"(Web 根目录)字段显示应用程序站点的根文件夹。默认情况下,该字段显示源文件夹。要更改 Web 根目录,请单击 "Browse"(浏览),然后选择其他文件夹。 </li> |
| <li>如有必要,选中 "<a href="#location">Copy files from Sources Folder</a> to another location"(将源文件夹中的文件复制到其他位置),然后指定存储文件夹的路径。 </li> |
| <li>如有必要,更改编码。 <br> <img alt="管理项目设置:"Project Properties"(项目属性)对话框" class="margin-around" src="../../../images_www/articles/72/php/project-setup/pprop-sources.png"></li> |
| <li>要完成项目定制,请单击 "OK"(确定)。</li> |
| </ol> |
| <h3><a name="run-configuration-panel"></a>运行配置</h3> |
| <br> 在 "Run Configuration"(运行配置)面板上,修改默认运行配置和/或定义新运行配置(如有必要)。 <br> |
| <ol> |
| <li>要修改默认设置,请<a href="#runConfiguration">更新在项目创建过程中指定的字段</a>。 </li> |
| <li>要定义新运行配置,请单击 "Configuration"(配置)下拉列表旁边的 "New"(新建)。"Create New Configuration"(创建新的配置)对话框打开。</li> |
| <li>在 "Configuration Name"(配置名称)字段中,输入新运行配置的名称,然后单击 "OK"(确定)。返回到 "Run Configuration"(运行配置)面板。</li> |
| <li>按照在项目创建过程中定义<a href="#runConfiguration">默认运行配置</a>的相同方式定义运行配置设置,然后单击 "OK"(确定)。"Configuration"(配置)下拉列表中将添加新配置。</li> |
| <li>要删除某个配置,请从 "Configuration"(配置)下拉列表中选择该配置,然后单击“删除”。 <br> <img alt="管理项目设置:运行配置" class="margin-around" src="../../../images_www/articles/72/php/project-setup/pprop-runconfig.png"> </li> |
| <li>要完成项目定制,请单击 "OK"(确定)。</li> |
| </ol> |
| <h3><a name="phpIncludePath"></a>PHP 包含路径</h3> |
| <br> 在包含路径面板上,为需要在项目中使用但无需与源文件放置在一起的文件指定位置。 |
| <ol> |
| <li>要添加文件夹,请单击 "Add Folder"(添加文件夹)。"Select Folder(s)"(选择文件夹)对话框打开。</li> |
| <li>选择相关的文件夹,然后单击 "Open"(打开)。将返回到 "PHP Include Path"(PHP 包含路径)面板。此时列表中会添加新文件夹。 </li> |
| <li>要在列表中导航,请使用 "Move Up"(上移)和 "Move Down"(下移)按钮。 </li> |
| <li>要从包含的文件夹列表中删除某个文件夹,请选择该文件夹,然后单击 "Remove"(删除)。<br> <img alt="管理项目设置:PHP 包含路径" class="margin-around" src="../../../images_www/articles/72/php/project-setup/pprop-include-path.png"> </li> |
| <li>要完成项目定制,请单击 "OK"(确定)。</li> |
| </ol> |
| |
| <h3><a name="formatting"></a>格式设置</h3> |
| <p>在 "Formatting"(格式设置)面板上,定义您要对编辑器中的源文件应用的格式样式。您可以定义全局格式设置,也可以定义特定于项目的格式设置。</p> |
| <p><b>定义全局 IDE 格式设置:</b></p> |
| <ol> |
| <li>选择 "Use global options"(使用全局选项)。</li> |
| <li>单击 "Edit Global Options"(编辑全局选项)。此时将打开 IDE 的 "Options"(选项)对话框中的 "Editor"(编辑器)> "Formatting"(格式设置)标签。 <br> <img alt=""Global formatting"(全局格式设置)对话框" class="margin-around" src="../../../images_www/articles/72/php/project-setup/global-formatting.png"></li> |
| <li>从 "Language"(语言)下拉列表中,选择将应用该设置的语言。</li> |
| <li>从 "Categories"(类别)下拉列表中,选择将应用该设置的格式项。</li> |
| <li>设置所需的格式,然后单击 "OK"(确定)。</li> |
| <li class="tips"> 单击 "Help"(帮助)按钮,以获得详细信息。</li> |
| </ol> |
| <p><b>定义特定于项目的格式设置:</b></p> |
| <ol> |
| <li>选择 "Use project-specific options"(使用特定于项目的选项)。此时将显示隐藏区域。<img alt="管理项目设置:格式设置" class="margin-around" src="../../../images_www/articles/72/php/project-setup/pprop-formatting.png"></li> |
| <li>从 "Language"(语言)下拉列表中,选择 "All Languages"(所有语言)或 "PHP"。在这种情况下,"All Languages"(所有语言)代表 PHP 以及 PHP 项目中包含的其他所有语言。</li> |
| <li>从 "Categories"(类别)下拉列表中,选择将应用该设置的格式项。</li> |
| <li>设置所需的格式,然后单击 "OK"(确定)。</li> |
| <li class="tips"> 单击 "Help"(帮助)按钮,以获得详细信息。</li> |
| |
| </ol> |
| <h3><a name="add-js-libraries"></a>添加 JavaScript 库</h3> |
| <p>NetBeans IDE 6.7 中移除了内置的 JavaScript 库,因为这些库不但非常大,而且还会导致性能下降。不过,手动添加它们很简单。如果将 JavaScript 库手动添加到项目中,则可以在 IDE 中对项目启用代码完成和其他所有与 JavaScript 相关的功能。</p> |
| <p><strong>将 JavaScript 库添加到项目中:</strong></p> |
| <ol> |
| <li>下载所需的 JavaScript 库或找到这些库(若已拥有)。</li> |
| <li>使用 IDE 或文件资源管理器将 JavaScript 库复制到 PHP 项目文件夹中。</li> |
| </ol> |
| <p>如果要对项目属性进行设置,以便将项目源复制到其他位置(请参见<a href="#sources">源</a>),则也可以将 JavaScript 库复制到此位置。如果在远程服务器上部署项目,则下次将项目源上载到该服务器时,也会将 JavaScript 库上载到该服务器。</p> |
| </div> |
| <div class="feedback-box" ><a href="/about/contact_form.html?to=3&subject=Feedback:%20PHP%20Project%20Setup">发送有关此教程的反馈意见</a></div> |
| <br style="clear:both;"> |
| <p>要发送意见和建议、获得支持以及随时了解 NetBeans IDE PHP 开发功能的最新开发情况,请<a href="../../../community/lists/top.html">加入 users@php.netbeans.org 邮件列表</a>。</p> |
| <p><a href="../../trails/php.html">返回至 PHP 学习资源</a></p> |
| </body> |
| </html> |