PHP与Apache手动集成需严格匹配版本、正确配置LoadModule/PHPIniDir/AddHandler，Linux需启用模块并检查php.ini路径，macOS需用proxy_fcgi，验证须测试exec和$_SERVER等真实环境变量。
php 和 apache 的搭配不是“一键安装”就能跑起来的，尤其在 Windows 或 macOS 上手动集成时，路径、模块加载顺序、httpd.conf 配置项稍有偏差，phpinfo() 就直接 500 或空白。Linux 发行版用包管理器（如 apt install apache2 php libapache2-mod-php）虽省事，但版本锁定、扩展缺失、php.ini 位置混乱仍是高频问题。
Windows 下手动集成 Apache + PHP：核心是 LoadModule 和 AddHandler
Apache 不会自动识别 PHP，必须显式加载 php_module 并绑定 .php 后缀。常见错误是只改了 httpd.conf 却漏掉 PHPIniDir，导致 php.ini 加载失败，extension_dir 错误、date.timezone 报错全由此引发。
- 确认 Apache 版本（
httpd -v）与 PHP 线程安全（TS/NTS）版本严格匹配：Apache 2.4 VC15/VC17 对应 PHP 的Thread Safe版本；若用mod_fcgid或php-cgi.exe，则选Non-Thread Safe - 在
httpd.conf中追加三段（位置在LoadModule区块末尾、<ifmodule mime_module></ifmodule>之前）：LoadModule php_module "C:/php/php8apache2_4.dll" PHPIniDir "C:/php" AddHandler application/x-httpd-php .php
-
php8apache2_4.dll名称随 PHP 大版本和 Apache 版本变化，务必核对下载包里的实际文件名（如 PHP 8.2 + Apache 2.4 是php8apache2_4.dll，PHP 7.4 则是php7apache2_4.dll） - 重启 Apache 前先运行
httpd -t检查配置语法，避免因路径错、dll 找不到导致服务无法启动
macOS 使用 Homebrew 安装：别跳过 apxs 和 brew services
Homebrew 默认不启用 Apache 模块编译工具 apxs，而 brew install php 默认走 php-fpm 模式，不是 mod_php。想让 httpd 直接调用 PHP，必须手动编译模块或改用 proxy_fcgi。
- 安装 Apache：
brew install httpd；启动：brew services start httpd - 安装 PHP（带 FPM）：
brew install php；它会自动配置php-fpm，但不会动 Apache 配置 - 编辑
/opt/homebrew/etc/httpd/httpd.conf，取消注释：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；否则请求会卡在 503
Linux（Ubuntu/Debian）常见陷阱：libapache2-mod-php 版本锁死 & /etc/apache2/mods-enabled
执行 apt install php libapache2-mod-php 看似一步到位，但实际装的是系统默认 PHP 版本（如 Ubuntu 22.04 是 PHP 8.1），且模块软链接可能未生效。访问 .php 文件返回源码而非执行结果，基本等于 php.load 没启用。
- 检查模块是否已启用：
ls /etc/apache2/mods-enabled/php*.load；若无输出，运行a2enmod php8.1（根据实际版本调整） - 确认
/etc/apache2/mods-available/php8.1.conf中有AddType application/x-httpd-php .php，否则 Apache 不知道该用哪个处理器解析.php - 修改
php.ini后必须重启 Apache：sudo systemctl restart apache2，仅 reload 不会重读php.ini - 如果用
php-cli能运行但网页 500，大概率是open_basedir或disable_functions在php.ini里限制了 Web 运行环境
验证是否真成功：别只看 phpinfo()，要测 exec() 和 $_SERVER
很多配置看似成功（phpinfo() 显示正常），但实际项目中 exec('git --version') 报错、$_SERVER['DOCUMENT_ROOT'] 为空、getenv('PATH') 缺失系统路径——这些才是线上部署的真实雷区。
立即学习“PHP免费学习笔记（深入）”；
- 写一个
test.php放到 Web 根目录：<?php echo "PHP is running\n"; echo "DocumentRoot: " . $_SERVER['DOCUMENT_ROOT'] . "\n"; echo "PATH: " . getenv('PATH') . "\n"; var_dump(exec('whoami')); ?> - 通过浏览器访问，观察输出是否完整；若
exec返回空或报错，检查disable_functions是否禁用了exec、shell_exec等，或 Apache 用户（www-data/_www）权限不足 - Linux/macOS 下注意 SELinux 或 sandbox 机制（如 macOS 的 Full Disk Access）可能拦截 PHP 的系统调用，这类问题不会报 PHP 错误，只会静默失败
php.ini 实际加载路径（用 php --ini 和 phpinfo() 对照）——这些细节比“怎么安装”重要得多。配好了不等于能用，能跑 phpinfo() 不等于能跑 Laravel 或 WordPress。 
