PHP嵌入失败主因是服务器未解析PHP，需五步排查：一、用phpinfo()确认PHP启用；二、检查.htaccess是否禁用PHP；三、验证RewriteRule是否误拦截.php请求；四、确保AllowOverride允许.htaccess覆盖；五、核对AddHandler/AddType绑定正确。
如果您在网页中嵌入 PHP 链接（例如通过 include、require 或 URL 方式调用 .php 文件）却返回 404、500 错误或直接显示 PHP 源码，很可能是服务器未正确解析 PHP，而 .htaccess 文件配置不当是常见诱因之一。以下是针对性排查步骤：
一、确认 PHP 是否被 Apache 启用并解析
该步骤用于排除底层运行环境问题——若 PHP 模块未启用或未关联到 .php 扩展，.htaccess 中的重写或处理指令将完全失效。
1、在网站根目录新建一个 test.php 文件，内容为 。
2、通过浏览器访问 http://yourdomain.com/test.php。
立即学习“PHP免费学习笔记（深入）”；
3、若页面显示 PHP 版本信息，则 PHP 已启用；若显示源码或 500 错误，则需检查 Apache 的 LoadModule php_module 和 AddHandler application/x-httpd-php .php 是否存在于主配置中。
二、检查 .htaccess 中是否禁用了 PHP 解析
某些安全加固型 .htaccess 配置会显式禁止 PHP 执行，尤其在共享主机或 CMS 安全插件部署后，可能插入了限制指令。
1、打开网站根目录下的 .htaccess 文件。
2、查找是否存在以下任意行：RemoveHandler .php、AddType text/plain .php、php_flag engine off 或
3、若存在，临时注释或删除该行（在行首加 #），保存后刷新嵌入链接页面验证。
三、验证 RewriteRule 是否意外拦截 PHP 请求
URL 重写规则若未设置恰当条件，可能将原本应直通 PHP 解析器的请求错误重定向至静态文件或 404 页面，导致嵌入失败。
1、定位 RewriteRule 指令段，重点关注匹配 .php 结尾的规则，例如：RewriteRule ^(.*)$ index.php [L]。
2、检查其上方是否存在 RewriteCond 条件，如 RewriteCond %{REQUEST_FILENAME} !-f —— 若缺失该条件，真实存在的 .php 文件也会被重写，从而跳过 PHP 解析流程。
3、在对应 RewriteRule 前添加保护性条件：RewriteCond %{REQUEST_FILENAME} !-f 和 RewriteCond %{REQUEST_FILENAME} !-d。
四、检查 AllowOverride 权限是否允许 .htaccess 覆盖 PHP 相关指令
Apache 主配置（如 httpd.conf 或虚拟主机配置）中若对当前目录设置了 AllowOverride None，则 .htaccess 中所有指令（包括 AddHandler、php_flag 等）均被忽略，导致配置形同虚设。
1、通过 FTP 或 SSH 进入服务器，查找 Apache 虚拟主机配置文件（通常位于 /etc/apache2/sites-enabled/ 或 /usr/local/apache/conf/extra/httpd-vhosts.conf）。
2、定位对应站点的
3、确认其中包含 AllowOverride All 或至少包含 AllowOverride Options=ExecCGI,IncludesNOEXEC,FollowSymLinks 及 AllowOverride FileInfo（用于支持 AddHandler、Rewrite 等）。
五、验证 MIME 类型与处理器绑定是否被覆盖
部分 .htaccess 配置会使用 AddType 或 AddHandler 显式修改 .php 扩展的行为，若值错误（如指向不存在的 handler），PHP 将无法执行。
1、在 .htaccess 中搜索 AddType 和 AddHandler 关键字。
2、确认存在且仅存在一行有效的 PHP 处理器声明，典型正确写法为：AddHandler application/x-httpd-php .php 或 AddType application/x-httpd-php .php。
3、若存在多行冲突声明（如同时有 AddHandler application/x-httpd-php74 .php 和 AddHandler application/x-httpd-php81 .php），保留与当前 PHP 版本匹配的一行，其余删除。
