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

= 在 Linux Ubuntu 中配置 PHP 开发环境
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: 在 Linux Ubuntu 中配置 PHP 开发环境 - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, 在 Linux Ubuntu 中配置 PHP 开发环境

本教程将介绍如何在 Ubuntu 操作系统（7.10 及更高版本）中配置 PHP 开发环境。其中包括安装和配置 PHP 引擎、MySQL 数据库、Apache Web 服务器和 XDebug 调试器。


*要学习本教程，您需要具备以下软件和资源。*

|===
|软件或资源 |要求的版本 

|link:https://netbeans.org/downloads/index.html[+NetBeans IDE+] |PHP 下载包 

|PHP 引擎 |版本 5。 

|Web 服务器 |推荐使用 Apache HTTP Server 2.2。
 

|数据库服务器 |推荐使用 MySQL Server 5.0。
 

|PHP 调试器（可选） |XDebug 2.0 或更高版本 
|===

通常，开发和调试都是在本地 Web 服务器上执行，而生产环境位于远程 Web 服务器上。link:./remote-hosting-and-ftp-account.html[+使用 NetBeans IDE 在远程 Web 服务器上部署 PHP 应用程序+]中介绍了如何设置远程 Web 服务器。本教程会引导您设置本地 Web 服务器。PHP 支持可以添加到许多本地 Web 服务器（IIS、Xitami 等）上，但最常用的是 link:http://httpd.apache.org/download.cgi[+Apache HTTP 服务器+]。


== 安装软件

本教程将介绍如何在 Ubuntu 7.04 及更高版本中配置 PHP 开发环境。您需要执行以下操作：

1. 安装 Apache2 HTTP 服务器、PHP5 引擎、MySQL 5.0 数据库服务器和 PHP5-MySQL 模块。这些软件包可以<<lamp,作为 LAMP 堆栈一起安装>>，也可以<<separate-packages,单独安装>>。
2. <<specifyDocumentRoot,指定 Apache2 HTTP 服务器的文档根目录>>
3. <<configureMySQL,配置 MySQL 数据库服务器>>
4. <<installXDebug,安装和启用 XDebug 2.0 调试器>>

有关安装 Apache、MySQL 和 PHP 的详细信息，请参见 link:https://help.ubuntu.com/community/ApacheMySQLPHP[+Ubuntu 社区+]。


[[lamp]]
=== 将软件包一起安装

Ubuntu 提供了一个 Linux AMP (LAMP) 包，其中包含 PHP 环境所需的全部软件包。可通过在“终端”窗口的命令提示符下执行以下命令安装此软件：


[source,bash]
----

sudo tasksel install lamp-server
----

 ``lamp-server``  包中包含最适合的 PHP、Apache 2、MySQL 和 PHP5-MySQL 版本。


[[separate-packages]]
=== 单独安装软件包

除了安装整个 LAMP 软件包集合以外，您还可以逐个安装这些软件包。如果您已经安装了其中的某个组件（如 Apache 服务器或 MySQL 数据库服务器），则此方法非常有用。您可以使用命令行工具或 Synaptic 包管理器 GUI。

要逐个安装的软件包如下所示：

* apache2
* php5
* mysql-server
* php5-mysql


===  


=== 检查安装

在设置 PHP Web 堆栈之后，应检查其安装是否正确，以及 Apache 服务器是否可以识别 PHP 引擎。

要检查 Apache 和 PHP 是否已安装并正在运行，请打开 NetBeans IDE 并link:./project-setup.html[+创建 PHP 项目+]。在  ``index.php``  文件中，输入 PHP 方法  ``phpinfo()`` 。运行该文件。此时应显示标准 PHP 信息页。 

image::images/ubuntu-phpinfo.png[]


[[troubleshooting]]
=== 疑难解答

以下是检查 Ubuntu 中的 PHP 堆栈安装时经常遇到的一些问题：

* *浏览器窗口显示无法找到  ``~USER/PROJECT/index.php``  错误*。从 URL 中删除  ``~USER``  字符串。例如，如果 URL  ``~ubuntu/test1/index.php``  出现此错误，请将该 URL 更改为  ``test1/index.php`` 。请注意，您既可以在 NetBeans IDE 中创建 PHP 项目时为该项目设置 URL，也可以通过右键单击该项目节点，然后转至“属性”>“运行配置”进行设置。
* *浏览器显示一个弹出式窗口，要求您打开文件，就像 PHP 引擎无法识别一样。* ``php5-common``  软件包出现问题。请用  ``php5``  和  ``phpmyadmin``  替换此软件包。要替换  ``php5-common`` ，请运行下面的两个命令：

[source,bash]
----

apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
----


== 指定 Apache2 HTTP 服务器的文档根目录

文档根目录是 Apache HTTP 服务器存放用于在浏览器中显示的文件的目录。文档根目录是在定义虚拟主机的文件中指定的。默认虚拟主机配置文件为


[source,bash]
----

/etc/apache2/sites-available/default
----

其中指定的文档根目录为


[source,bash]
----

/var/www/
----

我们建议您创建自己的虚拟主机并启用它，而不是编辑默认的虚拟主机。

* <<createDocumentRootLocation,创建文档根目录位置>>
* <<createNewVirtualHost,在新虚拟主机中指定新文档根目录>>
* <<activateNewVirtualHost,激活新虚拟主机>>


=== 创建文档根目录位置

1. 选择“位置”>“主文件夹”。
2. 从上下文菜单中，选择“创建文件夹”。
3. 输入文件夹的名称，例如，public_html。


=== 创建新虚拟主机

1. 要
启动终端，请选择“应用程序”>“附件”>“终端”。此时将打开“终端”窗口。
2. 要将默认虚拟主机的配置文件复制到新文件 ( ``mysite`` )，请在命令提示符下键入以下命令：

[source,bash]
----

sudo cp /etc/apache2/sites-available/default /etc/apache2/sites-available/mysite
----

[start=3]
. 运行  ``
gedit``  应用程序并在其中编辑新配置文件 ( ``mysite`` )：

[source,bash]
----

gksudo gedit /etc/apache2/sites-available/mysite 
----
如果系统询问，请输入操作系统安装过程中为超级用户指定的口令。

[start=4]
. 更改文档根目录以指向新位置：

[source,bash]
----

/home/<user>/public_html/
----

[start=5]
. 更改目录指令，将

[source,bash]
----

<Directory /var/www/>
----
替换为

[source,bash]
----

<Directory /home/user/public_html/>
----

image::images/ubuntu-change-directory-root.png[]


[start=6]
. 保存文件  ``mysite`` 


=== 激活新虚拟主机

1. 要取消激活默认主机并激活新主机，<<launchTerminal,请启动终端>>并在“终端”窗口运行以下两个实用程序：

[source,bash]
----

sudo a2dissite default &amp;&amp; sudo a2ensite mysite
----

[start=2]
. 重新启动 Apache HTTP 服务器：

[source,bash]
----

sudo /etc/init.d/apache2 reload
----


== 配置 MySQL 数据库服务器

在 MySQL 数据库服务器的安装过程中，会创建一个超级用户。安装期间，将会打开一个设置超级用户口令的对话框。如果未打开此对话框，或者您未在此对话框中设置口令，则您需要立即创建 MySQL 超级用户口令。您将需要此口令来创建其他 MySQL 服务器用户。

1. 要连接到 MySQL 服务器，<<launchTerminal,请启动终端>>，然后在“终端”窗口中输入以下命令：

[source,bash]
----

mysql -u root -p
----
此时将显示 MySQL 命令提示符。

[start=2]
. 在命令提示符下输入以下命令并按 Enter 键：

[source,sql]
----
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('<yourpassword>');
----
如果命令执行成功，则会显示以下消息：

[source,bash]
----

Query OK, 0 rows affected (0.00 sec)
----


== 安装和启用 XDebug 调试器

仅当要使用 XDebug（对于 PHP 开发是可选的）时才需要执行下列步骤。XDebug 是 PHP 的一个扩展。当为 PHP Web 堆栈正确配置了 XDebug 时，NetBeans IDE 会自动使用它。有关 XDebug 和 NetBeans IDE 的详细信息，请参见link:./debugging.html[+在 NetBeans IDE 中调试 PHP 源代码+]。此外，还可参见link:http://wiki.netbeans.org/HowToConfigureXDebug[+有关 XDebug 的 NetBeans wiki 页+]。


[[xdebug-package]]
=== 安装 XDebug 软件包（Ubuntu 8.05 及更高版本）

从 Ubuntu 8.05 开始，提供了名为  ``php5-xdebug``  的 XDebug 软件包。受支持的 XDebug 版本为 2.0.3-1。您可以使用命令行工具或通过 Synaptic 包管理器 UI 对其进行安装。安装 XDebug 之后，您必须按照<<enableXDebug,启用 XDebug>> 中的所述修改  ``php.ini`` 。


=== [[从源构建 XDebug (Ubuntu 7.10)]] 

要从源构建 XDebug，您还需要两个模块：PHP5 开发和 PEAR。

1. 启动 <<startSynapticPackageManager,Synaptic 包管理器>>。
2. 切换到“Installed”面板查看 make 模块是否已安装。
3. 切换到“All”标签，并单击以下软件包旁边的复选框：
* php5-dev
* php-pear
对于每一项，从上下文菜单中选择“Mark for installation”。

[start=4]
. 打开“Mark additional required changes”对话框打开，其中具有相关包的列表，这些包也应该进行安装，以使软件能够正常工作。单击“Mark”。

[start=5]
. 系统将返回到“Synaptic Package Manager”面板，其中所选的软件包已标记为要安装。

[start=6]
. 选择工具栏上的“Apply”。此时将打开“Apply the following changes”概要面板，其中具有选择安装的包列表。单击“Apply”。

[start=7]
. 成功完成下载和安装之后，“Changes applied”面板将会打开。单击 "Close"（关闭）。

NOTE: 您也可以通过在“终端”窗口中运行以下命令来安装这些模块： ``aptitude install php5-dev php-pear`` 


[start=8]
. 现在，您可以下载并安装 XDebug。在“终端”窗口中输入以下命令：

[source,bash]
----

sudo pecl install xdebug
----


=== 启用 XDebug

要启用 XDebug，您需要在 <<gedit, ``gedit`` >> 文本处理器中编辑 php.ini 文件。

1. 要启动  ``gedit``  文本处理器，请先启动<<launchTerminal,终端>>，然后在命令提示符下键入以下命令：

[source,bash]
----

gksudo gedit
----
如果系统询问，请输入操作系统安装过程中为超级用户指定的口令。

[start=2]
. 打开文件  ``/etc/php5/apache2/php.ini`` 。

[start=3]
. 将以下行添加到此文件中：

[source,bash]
----

zend_extension=/usr/lib/php5/<DATE+lfs>/xdebug.so
xdebug.remote_enable=on

----

查看link:http://2bits.com/articles/setting-up-xdebug-dbgp-for-php-on-debian-ubuntu.html[+此处+]了解有关配置 XDebug 的详细信息。


要发送意见和建议、获得支持以及随时了解 NetBeans IDE PHP 开发功能的最新开发情况，请link:../../../community/lists/top.html[+加入 users@php.netbeans.org 邮件列表+]。

link:../../trails/php.html[+返回至 PHP 学习资源+]