如何在Ubuntu上搭建PHP开发环境-精创网络云防护

帮助文档
如何在Ubuntu上搭建PHP开发环境
来源：www.jcwlyf.com更新时间：2025-02-22
在开发PHP项目时，选择合适的开发环境非常重要。在Linux系统中，Ubuntu是最受欢迎的发行版之一，其稳定性和开源特性使其成为PHP开发者的首选平台。如果你是一个想要在Ubuntu上进行PHP开发的新手，或者希望更新你的开发环境，那么这篇文章将详细介绍如何在Ubuntu系统上搭建PHP开发环境，包括安装PHP、数据库、Web服务器、调试工具等内容。
1. 安装PHP
首先，最重要的一步是安装PHP。Ubuntu的包管理器APT提供了方便的安装方法，安装过程非常简单。
打开终端，首先更新APT的包索引：
```
sudo apt update
```
然后，安装PHP的基本版本。可以使用以下命令来安装PHP 7.4或更新版本（例如PHP 8.0或8.1）：
```
sudo apt install php libapache2-mod-php php-mysql php-cli php-common php-json php-xml php-mbstring php-curl php-zip php-intl
```
这条命令会安装PHP以及一些常用的PHP扩展。"libapache2-mod-php"是Apache Web服务器所需的PHP模块，"php-mysql"是PHP与MySQL数据库的连接模块，其他模块如"php-cli"（命令行工具），"php-xml"（XML扩展），"php-mbstring"（字符编码扩展）等，也都是PHP开发中常用的扩展。
安装完成后，可以用以下命令检查PHP版本，确认安装成功：
```
php -v
```
如果显示PHP版本信息，则表示安装成功。
2. 安装并配置Web服务器：Apache或Nginx
为了运行PHP应用程序，我们还需要配置一个Web服务器。最常用的Web服务器有Apache和Nginx。在本教程中，我们将以Apache为例进行说明。
使用APT安装Apache Web服务器：
```
sudo apt install apache2
```
安装完成后，Apache会自动启动。可以通过浏览器访问服务器的IP地址或"localhost"，如果安装成功，你应该能看到Apache的默认欢迎页面。
接下来，确保Apache能够正确处理PHP文件。由于我们已经安装了"libapache2-mod-php"，Apache默认已经支持PHP。但为了确保一切正常运行，我们可以在Apache中启用PHP模块并重启Apache服务：
```
sudo a2enmod php
```
```
sudo systemctl restart apache2
```
此时，Apache已经配置好，能够支持PHP页面了。
3. 安装并配置数据库：MySQL或MariaDB
对于大多数PHP应用，数据库是必不可少的。PHP常常与MySQL数据库一起使用，但MariaDB是MySQL的一个分支，也具有类似的功能和更好的性能。我们将安装MariaDB，它是一个开源的MySQL替代品，许多PHP开发环境推荐使用它。
首先，使用以下命令安装MariaDB：
```
sudo apt install mariadb-server mariadb-client
```
安装完成后，启动MariaDB服务并使其开机自启：
```
sudo systemctl start mariadb
```
```
sudo systemctl enable mariadb
```
为了提高数据库的安全性，接下来运行MariaDB的安全配置脚本：
```
sudo mysql_secure_installation
```
脚本会提示你设置MariaDB的root密码，选择是否删除匿名用户，是否禁用远程root登录等，建议选择默认的安全选项。
至此，MariaDB已经安装并配置完成，可以用以下命令登录MariaDB：
```
sudo mysql -u root -p
```
在MariaDB的命令行界面，你可以创建新的数据库和用户，进行开发所需的各种操作。
4. 配置PHP与MySQL的连接
在PHP开发过程中，我们通常需要使用PHP连接MySQL（或MariaDB）数据库。为了让PHP能够与数据库进行交互，我们需要安装PHP的MySQL扩展。
可以使用以下命令来安装PHP与MySQL的连接库：
```
sudo apt install php-mysqli
```
安装完成后，重启Apache服务，以确保PHP能够加载新的扩展：
```
sudo systemctl restart apache2
```
现在，PHP已经能够与MariaDB数据库进行交互了。你可以编写PHP代码来连接和操作数据库。
5. 测试PHP开发环境
为了确认PHP开发环境已经搭建完成，我们可以创建一个简单的PHP测试文件。
首先，进入Apache的Web根目录，默认情况下是"/var/www/html"：
```
cd /var/www/html
```
然后，创建一个"info.php"文件，内容如下：
```
<?php
phpinfo();
?>
```
该文件会输出PHP的配置信息，帮助你确认PHP是否运行正常。保存文件后，在浏览器中访问"http://localhost/info.php"，如果能够看到PHP配置信息页面，则说明PHP环境已搭建成功。
6. 配置开发工具与调试环境
在PHP开发过程中，调试工具的使用可以大大提高开发效率。最常用的PHP调试工具是Xdebug，它能够为开发者提供详细的调试信息和堆栈跟踪。
安装Xdebug：
```
sudo apt install php-xdebug
```
安装完成后，配置Xdebug。编辑PHP的配置文件"/etc/php/7.x/apache2/php.ini"（根据你的PHP版本选择相应的目录），在文件末尾添加以下配置：
```
zend_extension=xdebug.so
xdebug.remote_enable=1
xdebug.remote_autostart=1
xdebug.remote_host=localhost
xdebug.remote_port=9000
```
保存文件后，重启Apache服务：
```
sudo systemctl restart apache2
```
此时，Xdebug就已经配置完成，你可以通过IDE（如PHPStorm）进行调试。
7. 配置虚拟主机（可选）
如果你有多个PHP项目，需要分别为每个项目配置不同的域名或路径，可以使用虚拟主机来管理。
首先，创建一个新的虚拟主机配置文件：
```
sudo nano /etc/apache2/sites-available/myproject.local.conf
```
在文件中添加以下内容：
```
&lt.VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/myproject
    ServerName myproject.local
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
```
保存并退出编辑器后，启用新的虚拟主机并重启Apache：
```
sudo a2ensite myproject.local.conf
```
```
sudo systemctl restart apache2
```
现在，你可以在"/etc/hosts"文件中添加如下内容，使得"myproject.local"指向本地服务器：
```
127.0.0.1 myproject.local
```
至此，你的虚拟主机就配置完成了。
总结
本文详细介绍了如何在Ubuntu上搭建PHP开发环境，包括安装PHP、配置Web服务器、设置数据库、调试工具的使用以及如何配置虚拟主机等内容。通过这些步骤，你可以在Ubuntu上创建一个功能完善的PHP开发环境，并且能够有效地进行开发、调试和部署工作。如果你有任何问题，可以参考相关文档或者与其他开发者进行交流。