PHP 环境配置：XAMPP 安装与配置

XAMPP 是一款集成了 Apache 服务器、MySQL 数据库、PHP 解释器以及 Perl 的免费开发环境安装包。它允许开发者在本地计算机上模拟真实的 Web 服务器环境，而无需手动配置每一个组件。本文将详细介绍如何在 Windows 系统上下载、安装、配置 XAMPP 并运行第一个 PHP 程序。

1. 下载 XAMPP 安装包

1. 访问 Apache Friends 官方网站。
2. 导航 至下载区域，根据你的操作系统位数（通常 Windows 10/11 为 64 位）选择 对应的 XAMPP 版本。
3. 点击 下载按钮，将安装包保存至本地磁盘（建议保存至桌面或下载文件夹以便查找）。

2. 执行安装程序

1. 找到 下载完成的 .exe 安装文件，通常文件名包含版本号，如 xampp-windows-x64-8.2.12-0-VS16-installer.exe。
2. 双击 该文件启动安装向导。
3. 如果系统弹出 User Account Control（用户账户控制）对话框，点击 “是” 以允许程序运行。
4. 在欢迎界面，点击 “Next” 按钮。
5. 在组件选择界面，保持 默认勾选状态（至少需勾选 Apache, MySQL, PHP, phpMyAdmin 以及 Perl），点击 “Next”。
6. 在安装路径选择界面，选择 安装位置。
   • 注意：安装路径中禁止包含空格或中文字符，建议使用默认路径 C:\xampp。
7. 点击 “Next” 进入下一步。
8. 在“Bitnami for XAMPP”界面，取消勾选 “Learn more about Bitnami for XAMPP” 的复选框（如果不需要学习相关内容），点击 “Next”。
9. 点击 “Next” 准备安装。
10. 点击 “Next” 开始复制文件，进度条显示安装进度，等待 直至完成。
11. 安装完成后，勾选 “Do you want to start the Control Panel now?”（您想现在启动控制面板吗？），点击 “Finish” 按钮退出安装向导并启动控制面板。

3. 启动与配置服务

安装完成后，需要通过 XAMPP 控制面板启动核心服务。

3.1 启动 Apache 和 MySQL

1. 打开 XAMPP Control Panel（XAMPP 控制面板）。
2. 在 "Module" 列表中找到 Apache 和 MySQL 行。
3. 点击 Apache 行右侧的 “Start” 按钮。
4. 点击 MySQL 行右侧的 “Start” 按钮。
5. 观察 按钮背景是否变为绿色，且 PID（进程 ID）和 Port（端口）栏显示具体的数字（Apache 默认端口为 80，MySQL 默认端口为 3306），表示服务启动成功。

以下是各核心服务对应的默认端口对照表：

3.2 服务启动故障排查

如果 Apache 启动失败（按钮背景为红色或显示 "Busy"），通常是端口被占用。

1. 点击 Apache 行右侧的 “Netstat” 按钮，查看 80 端口被哪个程序占用。
2. 如果是 IIS（Internet Information Services）或 Skype 等程序占用，关闭 对应程序。
3. 修改 Apache 端口：
   • 点击 Apache 行右侧的 “Config” 按钮。
   • 选择 “Apache (httpd.conf)”。
   • 按 Ctrl + F 搜索 关键字 Listen 80。
   • 将 Listen 80 修改 为 Listen 8080。
   • 搜索 关键字 ServerName localhost:80。
   • 将其 修改 为 ServerName localhost:8080。
   • 按 Ctrl + S 保存 文件。
4. 点击 Apache 行的 “Stop” 按钮，随后 点击 “Start” 按钮重启服务。

4. 测试 PHP 环境

验证 PHP 是否安装成功且正常工作。

1. 打开 浏览器（Chrome, Edge, Firefox 等）。
2. 在地址栏 输入 http://localhost/dashboard/ 或 http://127.0.0.1/dashboard/。
3. 按下 回车键。
4. 查看 页面内容。如果成功显示 XAMPP 的欢迎页面，说明 Web 服务器运行正常。
5. 点击 导航栏上方的 "phpinfo()" 链接。
6. 确认 是否显示 PHP 配置信息页面（包含 PHP 版本、配置文件路径等详细信息）。

5. 编写并运行第一个 PHP 脚本

创建一个简单的 PHP 文件以测试代码执行能力。

1. 打开 XAMPP 安装目录（默认为 C:\xampp）。
2. 进入 htdocs 文件夹。这是 Web 服务器的根目录，所有网站文件需放置于此。
3. 在 htdocs 文件夹内 右键，选择 “新建” -> “文件夹”。
4. 命名 文件夹为 test（避免使用中文和空格）。
5. 进入 test 文件夹。
6. 右键，选择 “新建” -> “文本文档”。
7. 重命名 文件为 index.php。
   • 注意：如果文件扩展名未显示，需先在文件夹选项中开启“显示文件扩展名”。
8. 右键点击 index.php，选择 “打开方式” -> “记事本”或你常用的代码编辑器（如 VS Code）。
9. 输入 以下 PHP 代码：

<?php
echo "Hello, XAMPP!";
phpinfo();
?>

10. 按 Ctrl + S 保存 文件并关闭编辑器。
11. 打开 浏览器，在地址栏 输入 http://localhost/test/。
12. 按下 回车键。
13. 检查 页面是否输出 "Hello, XAMPP!" 并下方跟随 PHP 配置信息表。

6. 配置 php.ini（可选）

根据开发需求调整 PHP 配置，例如修改上传文件大小限制或显示错误信息。

1. 在 XAMPP 控制面板中，点击 Apache 行的 “Config” 按钮。
2. 选择 “PHP (php.ini)”。
3. 按 Ctrl + F 搜索 upload_max_filesize。
4. 将其值 修改 为所需大小，例如 upload_max_filesize = 100M。
5. 搜索 post_max_size。
6. 将其值 修改 为至少等于或大于 upload_max_filesize，例如 post_max_size = 110M。
7. 搜索 display_errors。
8. 将其值 修改 为 On 以在页面上直接显示 PHP 错误（开发环境推荐开启）。
9. 按 Ctrl + S 保存 文件。
10. 点击 XAMPP 控制面板中 Apache 服务的 “Stop” 按钮。
11. 点击 “Start” 按钮重启服务，使配置生效。

环境配置至此已完成。本地开发服务器已就绪，可以开始进行 PHP Web 应用程序的开发。