如何在Windows10上快速配置PHP开发环境-精创网络云防护

帮助文档
如何在Windows10上快速配置PHP开发环境
来源：www.jcwlyf.com浏览：21更新：2025-11-16
在当今的互联网开发领域，PHP 是一种广泛使用的服务器端脚本语言，它能够帮助开发者快速搭建动态网站和 Web 应用程序。而 Windows 10 作为全球使用最广泛的操作系统之一，为开发者提供了便捷的开发环境。本文将详细介绍如何在 Windows 10 上快速配置 PHP 开发环境，让你能够迅速开始 PHP 开发工作。
一、准备工作
在开始配置 PHP 开发环境之前，我们需要准备一些必要的软件和工具。主要包括 PHP 解释器、Web 服务器（如 Apache 或 Nginx）以及数据库管理系统（如 MySQL）。此外，还可以准备一款代码编辑器，如 Visual Studio Code 或 Sublime Text，用于编写和编辑 PHP 代码。
1. 下载 PHP：访问 PHP 官方网站（https://windows.php.net/download/），根据自己的需求选择合适的 PHP 版本进行下载。建议选择最新的稳定版本，以获得更好的性能和安全性。下载完成后，将压缩包解压到一个指定的目录，例如 C:\php。
2. 下载 Apache：访问 Apache 官方网站（https://httpd.apache.org/download.cgi），选择适合 Windows 10 的 Apache 版本进行下载。下载完成后，将压缩包解压到一个指定的目录，例如 C:\Apache24。
3. 下载 MySQL：访问 MySQL 官方网站（https://dev.mysql.com/downloads/installer/），下载 MySQL Installer。运行安装程序，按照提示进行安装。在安装过程中，需要设置 MySQL 的 root 用户密码，务必记住该密码，后续会用到。
二、配置 PHP
1. 配置 PHP 环境变量：为了让系统能够找到 PHP 解释器，需要将 PHP 所在的目录添加到系统的环境变量中。具体步骤如下：
- 右键点击“此电脑”，选择“属性”。
- 在左侧导航栏中，点击“高级系统设置”。
- 在弹出的“系统属性”窗口中，点击“环境变量”按钮。
- 在“系统变量”列表中，找到“Path”变量，双击打开。
- 点击“新建”按钮，添加 PHP 所在的目录，例如 C:\php。
- 点击“确定”保存设置。
2. 配置 PHP.ini 文件：PHP.ini 是 PHP 的配置文件，需要对其进行一些必要的配置。打开 PHP 目录下的 php.ini-development 文件，将其复制一份并改名为 php.ini。然后使用文本编辑器打开 php.ini 文件，进行以下配置：
- 找到“;extension_dir = "ext"”这一行，去掉前面的分号，并确保路径正确。
- 找到“;date.timezone =”这一行，去掉前面的分号，并设置为合适的时区，例如“Asia/Shanghai”。
- 根据需要启用一些扩展，例如 mysqli、pdo_mysql 等，去掉相应扩展前面的分号。
保存修改后的 php.ini 文件。
三、配置 Apache
1. 配置 Apache 主配置文件：打开 Apache 目录下的 conf 文件夹，找到 httpd.conf 文件，使用文本编辑器打开。进行以下配置：
- 找到“ServerRoot "C:/Apache24"”这一行，确保路径正确。
- 找到“Listen 80”这一行，如果需要修改端口号，可以进行相应的修改。
- 找到“ServerName localhost:80”这一行，如果修改了端口号，需要相应地修改。
- 找到“DocumentRoot "C:/Apache24/htdocs"”这一行，这是网站的根目录，可以根据需要进行修改。
- 在文件末尾添加以下内容，以支持 PHP：
```
LoadModule php_module "C:/php/php8apache2_4.dll"
AddHandler application/x-httpd-php .php
PHPIniDir "C:/php"
```
注意：需要根据实际情况修改 PHP 模块的路径。
2. 启动 Apache 服务：打开命令提示符，切换到 Apache 的 bin 目录，例如 C:\Apache24\bin。然后运行以下命令启动 Apache 服务：
```
httpd.exe -k start
```
如果一切配置正确，Apache 服务将成功启动。可以在浏览器中输入“http://localhost”，如果看到 Apache 的测试页面，说明 Apache 配置成功。
四、配置 MySQL
1. 启动 MySQL 服务：在开始菜单中找到“MySQL 8.0 Command Line Client”并打开，输入之前设置的 root 用户密码，登录 MySQL。
2. 创建数据库：登录 MySQL 后，可以使用以下命令创建一个新的数据库：
```
CREATE DATABASE mydb;
```
这里的“mydb”是数据库的名称，可以根据需要进行修改。
3. 创建用户并授权：为了安全起见，不建议直接使用 root 用户进行开发。可以创建一个新的用户，并为其授予相应的权限。以下是创建用户并授权的示例：
```
CREATE USER 'myuser'@'localhost' IDENTIFIED BY 'mypassword';
GRANT ALL PRIVILEGES ON mydb.* TO 'myuser'@'localhost';
FLUSH PRIVILEGES;
```
这里的“myuser”是用户名，“mypassword”是密码，可以根据需要进行修改。
五、测试 PHP 开发环境
1. 创建测试文件：在 Apache 的网站根目录（例如 C:\Apache24\htdocs）下创建一个名为 test.php 的文件，使用文本编辑器打开并添加以下内容：
```
<?php
phpinfo();
?>
```
2. 访问测试文件：在浏览器中输入“http://localhost/test.php”，如果看到 PHP 的信息页面，说明 PHP 开发环境配置成功。
六、常见问题及解决方法
1. Apache 无法启动：可能是端口被占用或配置文件有误。可以使用命令“netstat -ano | findstr :80”查看端口占用情况，然后关闭占用端口的程序或修改 Apache 的监听端口。同时，检查 httpd.conf 文件是否有语法错误。
2. PHP 无法正常工作：检查 PHP.ini 文件的配置是否正确，确保扩展已正确启用。同时，检查 Apache 的配置文件中是否正确加载了 PHP 模块。
3. MySQL 连接失败：检查 MySQL 服务是否正常启动，以及用户名、密码和数据库名称是否正确。可以使用以下代码测试 MySQL 连接：
```
<?php
$servername = "localhost";
$username = "myuser";
$password = "mypassword";
$dbname = "mydb";

// 创建连接
$conn = new mysqli($servername, $username, $password, $dbname);

// 检查连接
if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}
echo "连接成功";
?>
```
通过以上步骤，你可以在 Windows 10 上快速配置一个完整的 PHP 开发环境。配置完成后，你就可以开始使用 PHP 进行 Web 开发了。希望本文对你有所帮助。