独立搭建PHP环境需明确各组件职责与路径，确保CLI与Web服务器加载同一PHP实例；Apache须显式配置LoadModule及PHPIniDir，php.ini中extension_dir和扩展启用须精准匹配实际路径，VSCode调试要求五处路径完全对齐。
独立搭建 PHP 环境 ≠ 装个 XAMPP 就完事。真正“独立”，意味着你清楚每个组件的职责、路径、配置生效范围，且能定位 php -v 和网页中 phpinfo() 版本不一致这类问题的根因——它几乎总是出在 CLI 与 Web 服务器加载了不同 PHP 实例。
Apache + PHP 手动绑定时，LoadModule 路径必须精确到 .dll 文件
Windows 下 Apache 不会自动找 PHP，必须显式声明模块路径。很多人复制网上的配置，把 LoadModule php_module "c:/php/php8apache2_4.dll" 写成 "c:/php/" 或漏掉 .dll 后缀，结果 Apache 启动失败但无明确报错。
- 确认你下载的是 Non-Thread-Safe（NTS）版本 PHP，且架构匹配（x64 对 x64，VS16 对 VS16）
-
php8apache2_4.dll必须存在于你解压的 PHP 目录下；若不存在，说明你下了 Thread-Safe 版，得重下 - Apache 的
httpd.conf中，PHPIniDir指向的是php.ini所在目录（如"C:/php"），不是ext/目录 - 改完配置后必须执行
httpd -t验证语法，再httpd -k restart，不能只靠控制面板点“重启”
php.ini 开启扩展前，先确认 extension_dir 指向真实路径
常见错误是直接取消注释 extension=mysqli，却没改 extension_dir。默认值可能是 "./" 或 "ext"，而实际扩展文件在 C:\php\ext\ —— 路径错，扩展就永远加载失败。
- 打开
php.ini，搜索extension_dir，设为绝对路径：extension_dir = "C:/php/ext"（Windows 用正斜杠或双反斜杠均可） - 启用扩展时去掉分号，但别写全路径：
extension=mysqli，不是extension=C:/php/ext/php_mysqli.dll - 关键扩展至少包括：
mysqli、pdo_mysql、curl、mbstring、openssl - 改完
php.ini后，CLI 和 Apache 都要重启：终端执行php -m | findstr mysqli，网页访问phpinfo()查 “Loaded Extensions”
浏览器访问空白页或 500 错误，优先检查 DocumentRoot 与 index.php 权限
Apache 能启动、phpinfo() 能显示，但放进去的 index.php 打不开——大概率是文档根目录权限或路径映射错了。
立即学习“PHP免费学习笔记（深入）”；
- 确认
DocumentRoot和对应<directory></directory>块里的路径完全一致，且末尾**不要加斜杠**：DocumentRoot "C:/htdocs"，不是"C:/htdocs/" - Windows 下 Apache 默认以
SYSTEM身份运行，不需要像 Linux 那样chown，但目录需允许“读取与执行”权限（右键 → 属性 → 安全 → 编辑 → SYSTEM 用户勾选“读取和执行”） - 确保
index.php文件本身没被杀毒软件锁定，临时禁用 Windows Defender 实时保护可快速验证 - 如果用了
.htaccess重写，先把它重命名暂时禁用，排除 rewrite 规则干扰
调试时断点不命中？pathMappings 和 php.executablePath 必须同时对齐
VSCode 调试 PHP，不是配好 Xdebug 就行。它需要五处路径完全对齐：本地代码路径、Web 服务器看到的路径、Xdebug 连接端口、VSCode 的 PHP 可执行路径、以及 launch.json 中的映射关系。
-
php.executablePath必须填绝对路径，且指向 NTS 版本的php.exe（如"C:/php/php.exe"），不能是 TS 版，也不能含空格或中文 -
launch.json中pathMappings是关键：若 Apache 的DocumentRoot是C:/htdocs，项目在C:/htdocs/myapp，那就写"C:/htdocs": "${workspaceFolder}/.."，而不是只映射子目录 - Xdebug 3 必须有
xdebug.mode=debug，且xdebug.client_port和launch.json的port字段值严格一致（默认 9003，不是旧版的 9000） - 哪怕你只调试 CLI 脚本（如
php test.php），也要配pathMappings，否则框架可能因找不到$_SERVER['DOCUMENT_ROOT']报错
最易被忽略的其实是“一致性”：CLI 的 php -v、Apache 的 phpinfo()、VSCode 的 php.executablePath、Xdebug 日志里显示的 PHP 版本——这四者必须指向同一套二进制和配置。差一个，环境就算没搭稳。
