1. Windows 11 本地开发环境搭建
准备工作与系统要求
在 Windows 11 上搭建本地开发环境的核心是确保可用的 Web 服务器、PHP 以及数据库组件能够稳定协同工作。为获得最佳兼容性，推荐使用官方发行的安装包或主流集成栈，并确保系统开启了必要的虚拟化支持。通过此次搭建，你可以在本机快速创建和调试 PHP 应用、进行前后端联调。
需要关注的先决条件包括：启用 虚拟化技术、确保 BIOS/UEFI 中的 VT-x/AMD-V 已开启、以及保持 Windows 11 的更新版本在一个受支持的通道中。相比传统安装，使用带有图形化控制面板的集成栈可以降低初次配置的复杂度，同时仍然具备足够的灵活性来应对不同版本的 PHP、MySQL/MariaDB 与扩展组件。
选择本地开发栈：XAMPP、WAMP 与原生 PHP+Apache
常见的本地开发栈有三类：XAMPP、WampServer 与手动搭建的 PHP+Apache+MySQL。XAMPP 提供一体化安装包、方便的控制面板与跨平台支持，适合快速起步；WampServer 在 Windows 环境下有良好的集成体验，便于直接切换 PHP 版本；手动搭建则更灵活，适合需要自定义版本、扩展与优化场景。以上三种方式本质上都能实现一个可用的本地服务器环境，关键在于你对版本、扩展和后续维护的偏好。
在选择时，可以将未来开发需求作为参考：若打算频繁切换数据库版本或有特定的 PHP 扩展需求，手动搭建会更具可控性；若希望快速上手并尽量减少维护工作量，XAMPP/Wamp 的集成方案会更合适。无论选择哪种方式，后续都需要关注 虚拟主机 的配置、以及对外部域名的本地解析。
安装步骤与环境变量配置
以一个常见的集成栈为例，安装完成后需要将 PHP 的执行路径加入系统环境变量，以便在命令行中直接使用 PHP、Composer 等工具。将 PHP 目录加入 PATH 后，你可以在任意位置快速运行 php、composer 等命令来验证环境。
REM 将 PHP 可执行文件路径加入系统 PATH
setx PATH "%PATH%;C:\xampp\php"
随后在命令行执行以下命令以验证工具是否就绪：php -v、mysql -V、以及 composer -V，若能正确返回版本信息，说明基础栈已经就位。
C:\> php -v
PHP 8.x.x (cli) (built: ...)
C:\> mysql -V
mysql Ver 8.x.x for Win64 on x86_64 (MySQL Community Server - GPL)
C:\> composer -V
Composer version 2.x.x
安装方式对比与推荐做法
对初学者来说，XAMPP 或 WampServer 可以在极短时间内提供一个可用的 本地环境，适合快速验证 PHP 代码与数据库交互 的基本场景。若你需要对 服务器配置细节、扩展版本、以及多站点环境进行深度自定义，建议采用“手动搭建 + 虚拟主机”的方式，以便精细控制每个组件及其版本。最终的选择应当与您对未来开发需求的预期相匹配。
验证安装是否成功与基本示例页面
创建一个简单的 PHP 信息页面用于快速验证服务器与 PHP 的集成是否正确工作。你可以在 Web 根目录下新建 info.php，内容为 phpinfo()，然后在浏览器中访问相应地址查看详细信息。
<?php
phpinfo();
?>如果页面能正确显示 PHP 信息面板，说明当前本地环境对 PHP 的解析已经就绪。为了进一步测试数据库连接，可以添加一个简单的 PDO 连接测试脚本，并在浏览器中执行。
<?php
try {$pdo = new PDO('mysql:host=127.0.0.1;dbname=testdb', 'root', '');echo '数据库连接成功';
} catch (PDOException $e) {echo '连接失败: ' . $e->getMessage();
}
?>2. PHP 虚拟主机的搭建
虚拟主机概念及 Apache/Nginx 配置
虚拟主机（Virtual Host）允许在同一台机器上为不同域名提供独立的网站实例。在 Windows 11 的本地开发环境中，最常用的 Web 服务器是 Apache，通过配置 httpd-vhosts.conf 与本机域名解析（hosts 文件）实现多站点管理。通过这样的配置，可以实现 site1.local、site2.local 等本地域名指向不同的文档根目录。
正确的虚拟主机配置应包含对每个站点的 DocumentRoot 与 Directory 指定，以确保请求正确映射到站点目录，并启用 AllowOverride All 以便使用 .htaccess 实现重写等功能。
在 Apache 配置中的虚拟主机示例
以下示例展示了两个简单站点的虚拟主机配置片段，通常放在 httpd-vhosts.conf 文件中：
# httpd-vhosts.conf 示例
ServerName site1.localDocumentRoot "C:/xampp/htdocs/site1"Options Indexes FollowSymLinksAllowOverride AllRequire all granted
ServerName site2.localDocumentRoot "C:/xampp/htdocs/site2"Options Indexes FollowSymLinksAllowOverride AllRequire all granted
在 Windows 11 下的具体步骤
实现多站点环境通常需要按以下步骤操作：1) 修改 hosts 文件，将本地域名解析到回环地址；2) 修改 httpd.conf/Include，确保 Apache 读取虚拟主机配置；3) 重启 Apache 服务以使改动生效；4) 在浏览器中访问站点以验证结果。
# C:\Windows\System32\drivers\etc\hosts
127.0.0.1 site1.local
127.0.0.1 site2.local
# httpd.conf
# 确保包含虚拟主机配置
Include conf/extra/httpd-vhosts.conf
REM 重启 Apache 服务以应用配置
net stop Apache2.4
net start Apache2.4
验证多站点配置
在浏览器中访问 http://site1.local 与 http://site2.local，若显示各自站点的内容，且页面资源能够正确加载，说明虚拟主机配置正确生效。若出现默认站点或空白页面，需要按顺序检查：hosts 映射、httpd-vhosts.conf 引用、以及 Apache 的日志输出。
3. 常见问题解答
本地访问 127.0.0.1/localhost 无效的原因与解决办法
常见原因包括 服务未运行、端口被占用、虚拟主机未加载 等。首先检查 Apache 服务状态，并确认监听端口为 80（或自定义端口）。此外，若系统中存在冲突的 Web 服务（如 IIS），需临时禁用或修改端口以排除干扰。
通过命令排错可以获得快速线索：netstat、tasklist/任务管理器以及查看 Apache 的错误日志都能帮助定位问题。
C:\> netstat -ano | findstr :80
C:\> tasklist | findstr httpd
虚拟主机不起作用，回到默认站点的原因与排查
常见原因包括 httpd-vhosts.conf 未被包含、hosts 文件未正确映射、或站点的 ServerName 与实际访问的域名不一致。请确认 httpd.conf 中包含了 Include conf/extra/httpd-vhosts.conf，并检查站点的 ServerName 是否与本地解析的域名一致。
另外，在某些场景下，浏览器缓存可能导致旧的解析结果持续显示，请清空缓存或使用隐私模式再次访问。
PHP 扩展未加载的常见修复步骤
若发现某些 PHP 功能缺失（如 mbstring、curl 等），通常需要在 php.ini 中启用相应扩展：移除前面的分号注释，如 extension=curl、extension=mbstring。修改后记得重启 Web 服务器使扩展生效。
; 在 php.ini 中启用
extension=curl
extension=mbstring
此外，确认扩展文件存在于 ext 目录，并且 extension_dir 指向正确的路径。
WSL2 与 Windows 本地开发环境的集成问题
如果你在 Windows 11 上使用了 WSL2，跨系统访问可能需要额外的网络设置或端口转发。建议在无须跨系统访问的场景中，优先使用本地 Windows 原生环境的 Apache + PHP 组合，以减少网络层的误差与调试成本。
