PHP网站必须依赖Apache、PHP解释器、MySQL及正确配置协同工作才能运行，缺一不可；典型失败表现为启动失败、空白页、500错误或拒绝连接，主因是端口占用或PHP模块路径配置错误。
PHP网站不能直接双击运行，必须依赖一套协同工作的服务组件才能解析执行。核心就是四件套：Web服务器（如Apache）、PHP解释器、数据库（如MySQL）、以及能串起它们的配置逻辑。缺一不可，顺序也不能乱。
Apache + PHP集成启动失败的典型表现
装完XAMPP或WAMP后点“Start”却提示Apache或PHP模块加载失败，浏览器访问 http://localhost 显示空白页、500错误，或直接拒绝连接。根本原因通常是端口被占用（比如Skype、IIS、其他Web服务占了80端口），或PHP模块路径在Apache配置中写错。
- 检查端口占用：
netstat -ano | findstr :80（Windows）或lsof -i :80（macOS/Linux），杀掉PID对应的进程 - 确认Apache配置文件
httpd.conf中已启用PHP模块：LoadModule php_module modules/libphp.so（Linux/macOS）或LoadModule php_module "php/php8.5.5/php8apache2_4.dll"（Windows，路径需严格匹配你安装的PHP版本） - 确保
AddHandler application/x-httpd-php .php和DirectoryIndex index.php已取消注释
PHP 8.5.5 与 MySQL 连接时 mysqli_connect() 报错
常见报错如 mysqli_connect(): (HY000/1045): Access denied for user 'root'@'localhost' 或 Connection refused，不是密码错了，而是服务没通或权限没开。
- 先验证MySQL是否真在运行：
mysql -u root -p命令行能登录，说明服务正常；若连不上，重启MySQL服务（XAMPP控制面板点“Restart”） - PHP 8.5.5 默认禁用旧式密码认证方式，如果MySQL用户用的是
caching_sha2_password插件，需改用mysql_native_password：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY ''; - 连接代码里别硬编码空密码——哪怕本地开发，也显式写
$password = ''，避免因默认值隐式变化出问题
为什么必须把项目放 htdocs 目录下才能访问
这不是约定俗成，而是Apache配置决定的。它的 DocumentRoot 指向 C:\xampp\htdocs\（Windows）或 /Applications/MAMP/htdocs/（macOS），所有HTTP请求都从这个根目录开始映射路径。
立即学习“PHP免费学习笔记（深入）”；
- 放错位置（比如桌面或D盘某文件夹）→ Apache根本不会读取该PHP文件 → 浏览器下载源码或报404
- 想换目录？改
httpd.conf里的DocumentRoot和对应<directory></directory>块路径，然后重启Apache - 子项目建议建独立文件夹（如
htdocs/blog/），而不是把所有文件堆在htdocs根下，否则路由和权限管理会越来越难
phpinfo() 页面不显示或部分信息缺失
新建 info.php 放入 htdocs，内容只有 <?php phpinfo(); ?>，但访问后空白、报500，或只显示“PHP Version”没其他模块——说明PHP没真正挂载进Apache，或扩展没加载。
- 空白页大概率是PHP语法错误或输出被缓冲截断，打开Apache错误日志（
apache/logs/error.log）看具体报错 - 缺少MySQLi/PDO等模块？检查
php.ini文件中是否启用了对应扩展：extension=mysqli、extension=pdo_mysql（注意去掉前面的分号） - 改完
php.ini必须重启Apache，PHP配置不会热加载
真正的难点不在“怎么装”，而在于四个组件之间的链路是否全通：Apache能否调用PHP解释器、PHP能否连上MySQL、MySQL是否允许该用户从localhost连接、路径配置是否让请求精准落到你的PHP文件上。任一环节断开，整个链就失效——调试时别跳步，按顺序逐层验证。
