PHP 8.3 与 Apache 配置需严格匹配环境：Windows 必选 Thread Safe 版并加载 php8apache2_4.dll；Linux（apt）自动启用 libapache2-mod-php8.3；macOS Homebrew 默认不支持 mod_php，须用 proxy_fcgi + php-fpm。
PHP 8.3 和 Apache 能配，但不能直接用 mod_php 模块硬塞——尤其在 macOS 或新版 Linux 上，php8apache2_4.dll 已基本弃用，Homebrew 默认走 FPM，apt 安装也默认用 libapache2-mod-php 包封装好的 FastCGI 链路。
Windows 下配 Apache 2.4 + PHP 8.3 必须选 Thread Safe 版本
PHP 官网下载页明确标出 “Thread Safe” ZIP 包才带 php8apache2_4.dll；Non-Thread-Safe（NTS）版没有这个文件，也无法被 LoadModule 加载。常见错误是下了 NTS 版却照着 TS 教程配，结果 httpd -t 报错：Cannot load C:/php/php8apache2_4.dll into server: The specified module could not be found.
- 下载地址必须选 windows.php.net/download#php-8.3 页面中带 “VC17 x64 Thread Safe” 字样的 ZIP
- 解压后确认目录下存在
php8apache2_4.dll（文件名随大版本变，PHP 8.3 是php8apache2_4.dll，不是php7apache2_4.dll） -
httpd.conf中三行必须紧挨着写、顺序不能乱：LoadModule php_module "C:/php/php8apache2_4.dll" AddHandler application/x-httpd-php .php PHPIniDir "C:/php"
- 漏掉
PHPIniDir会导致extension_dir读错、date.timezone不生效、所有扩展加载失败
Linux（Ubuntu/Debian）用 apt 装 PHP 8.3 就别碰手动编译模块
执行 sudo apt install php8.3 libapache2-mod-php8.3 后，Apache 模块已自动启用，a2enmod php8.3 是冗余操作；真正要检查的是 /etc/apache2/mods-enabled/php8.3.load 是否存在，以及 apache2ctl -M | grep php 输出是否含 php8_module (shared)。
- 不要手动改
/etc/apache2/mods-available/php8.3.load里的LoadModule路径——它由包管理器维护，路径形如/usr/lib/apache2/modules/libphp8.3.so - PHP 配置文件在
/etc/php/8.3/apache2/php.ini，不是/etc/php/8.3/cli/php.ini；CLI 和 Apache 使用的 ini 文件完全独立 - 若
phpinfo()显示Server API是Apache 2.0 Handler，说明 mod_php 生效；若是FPM/FastCGI，说明你误启了php8.3-fpm服务，得停掉并禁用：sudo systemctl disable --now php8.3-fpm
macOS 上 Homebrew 安装的 httpd 默认不支持 mod_php，必须走 proxy_fcgi
Homebrew 的 brew install httpd 和 brew install php 是解耦设计：前者装 Apache，后者装 PHP-FPM 服务，libphp.so 模块根本没编译。强行在 httpd.conf 里加 LoadModule php_module 会报错：Cannot load /opt/homebrew/lib/httpd/modules/libphp.so into server: dlopen(...): image not found。
立即学习“PHP免费学习笔记（深入）”；
- 正确做法是启用
mod_proxy和mod_proxy_fcgi：LoadModule proxy_module lib/httpd/modules/mod_proxy.so LoadModule proxy_fcgi_module lib/httpd/modules/mod_proxy_fcgi.so
- 在
<virtualhost></virtualhost>块内加代理规则：ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/opt/homebrew/var/www
（路径需与你的DocumentRoot对齐） - 确保
php-fpm正在运行：brew services start php；检查端口监听：lsof -i :9000 - 别跳过
apxs—— Homebrew 的httpd默认不带apxs工具，无法手动编译libphp.so，这不是 bug，是设计取舍
验证时最容易忽略的三个真实环境变量
phpinfo() 页面能打开 ≠ PHP 真正在 Apache 下运行。关键看 $_SERVER 数组里有没有这些字段：
-
SERVER_SOFTWARE值含Apache（不是PHP Server） -
SCRIPT_FILENAME是绝对路径，且指向.php文件（不是空或 CLI 路径） -
PHP_SELF和REQUEST_URI能正常反映 URL 路由（否则$_GET可能全空） - 如果
exec('whoami')返回www-data（Linux）或_www（macOS），说明权限和上下文正确；返回root或当前用户则说明没走 Apache worker 进程
很多配置看似成功，但 mysqli_connect() 报 Connection refused、file_put_contents() 权限拒绝、$_POST 为空——根源都在这些底层环境变量没对齐，而不是“PHP 装好了就行”。
