PHP 8.2本身不提供虚拟主机功能，虚拟主机由Apache/Nginx配置，但其版本、模块加载方式、php_admin_value行为和路径映射必须严格匹配，否则会导致.php文件被下载、500错误或配置失效。
PHP 8.2 本身不提供虚拟主机功能，它只是解释器；虚拟主机由 Web 服务器（Apache/Nginx）配置，但 PHP 8.2 的版本、模块加载方式、php_admin_value 行为和路径映射必须与之严格匹配，否则会出现 .php 文件被下载、500 错误或配置不生效。
Apache 加载 php8apache2_4.dll 失败？确认 TS/NTS 和 MPM 匹配
Windows 下 Apache + PHP 8.2 最常见的“PHP 不执行”问题，不是配置写错了，而是二进制不兼容。
- Apache 使用
mpm_winnt（默认线程模型），就必须用 TS（Thread Safe） 版本的 PHP；若你装的是 NTS（Non-Thread-Safe）版（比如 phpEnv 软件商店里没注意勾选 VC16 x64 TS），LoadModule php_module会静默失败，httpd -t也不报错 - 检查
httpd.conf中这行是否启用且路径正确：LoadModule php_module "D:/phpenv/php/php-8.2.20/php8apache2_4.dll"—— 路径末尾必须是php8apache2_4.dll，不是php-cgi.exe或php.dll - 用
httpd -M | findstr php验证模块是否真加载成功；若无输出，说明加载失败，优先换 TS 版本重装
多个站点用 PHP 8.2 但需不同 php.ini 设置？必须用 php_admin_value
php_value 在 Apache 模块模式下常被忽略，尤其在 PHP 8.2+ 启用 opcache 后更不稳定；php_admin_value 才是唯一能强制覆盖全局配置、且不可被 ini_set() 绕过的机制。
- 只能写在
<virtualhost></virtualhost>或<directory></directory>块内，不能放在.htaccess中 - 常见有效配置：
php_admin_value open_basedir "/var/www/site-a:/tmp"、php_admin_flag display_errors on、php_admin_value memory_limit 512M - 注意：像
disable_functions这类编译时锁定的指令，即使写了php_admin_value也无效，会直接被忽略
PHP-FPM 模式下访问 .php 报 “File not found”？检查 SCRIPT_FILENAME 映射
用 ProxyPassMatch 或 SetHandler "proxy:fcgi://..." 时，PHP-FPM 收到的 SCRIPT_FILENAME 必须是绝对路径且与 DocumentRoot 完全对齐，否则它会在错误位置找文件。
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
- 错误写法：
ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/→ 导致 PHP-FPM 尝试执行/index.php，而非/var/www/site-a/index.php - 正确写法（硬编码路径）：
ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/site-a/ - 更健壮写法（推荐）：
SetHandler "proxy:fcgi://127.0.0.1:9000"+ProxyFCGISetEnvIf "true" SCRIPT_FILENAME /var/www/site-a%{reqenv:SCRIPT_URL} - 验证方法：在 PHP 脚本中打印
$_SERVER['SCRIPT_FILENAME']，确认值是你期望的完整物理路径
PhpStorm 调试断点不触发？PHP 解释器路径和映射没对齐
PhpStorm 的 Xdebug 断点依赖两个关键一致性：一是解释器路径指向 PHP 8.2 的真实 CLI 可执行文件，二是本地项目路径与远程/容器内路径严格映射。任何一环错位都会导致“连接成功但无断点”。
- 如果用 WSL/Homestead/Vagrant，
Interpreter path必须填虚拟机内路径，如/usr/bin/php，而不是 Windows 上的C:\php\php.exe -
Mappings中“本地路径”必须精确对应“远程路径”，例如：D:\projects\myapp→/home/vagrant/code/myapp；多一个斜杠或大小写差异都会让断点失效 - 运行
php --ini确认实际加载的php.ini是否启用了xdebug.mode=debug和xdebug.client_host=host.docker.internal（Docker 场景）
最易被忽略的是：PHP 8.2 的 opcache.preload 和 opcache.jit 默认开启，它们可能干扰调试器注入；开发阶段建议在对应站点的 php_admin_value 中临时关闭：php_admin_flag opcache.preload off、php_admin_flag opcache.jit off。
