讲师中心 微信公众号
AI工具推荐 视频效率加速

Apache中PHP不起作用怎么办_检查PHP配置错误的解决步骤【排查】

千明酱_4080

千明酱_4080

发布时间:2026-02-16 15:07:03

|

663人浏览过

|

来源于php中文网

原创

Apache中PHP不起作用的主因是模块未加载或处理器未配置:先用httpd -M或检查LoadModule确认libphp.so加载,再查AddHandler/SetHandler或ProxyPassMatch是否注册PHP处理器,最后验证phpinfo()输出及错误日志。

apache中php不起作用怎么办_检查php配置错误的解决步骤【排查】

Apache 中 PHP 不起作用,大概率不是 PHP 没装,而是 Apache 没正确加载 libphp.so(或 Windows 下的 php_module)模块,或者没把 .php 文件交给 PHP 处理。先确认这点,再往下排查。

确认 Apache 是否加载了 PHP 模块

Linux/macOS 下运行:
httpd -M | grep php 或 apache2ctl -M | grep php;Windows 下看 httpd.conf 里是否有 LoadModule php_module 行,且路径指向正确的 php7apache2_4.dll(或对应版本)。

  • 没输出、没匹配 → 模块根本没加载,检查 LoadModule 行是否被注释、路径是否拼错、文件是否存在
  • 输出类似 php7_module (shared) → 模块已加载,但可能没配置处理器
  • 出现 Cannot load modules/libphp.so into server → 权限问题或架构不匹配(如 64 位 Apache 加载 32 位 PHP 模块)

检查 PHP 处理器是否注册(AddHandler / SetHandler)

仅加载模块不够,Apache 还得知道「遇到 .php 文件时调用 PHP」。常见错误是漏掉或写错处理器声明。

  • 在 httpd.conf 或站点 <virtualhost></virtualhost> 内,必须有类似:
    AddHandler application/x-httpd-php .php
    或更现代的写法:
    <FilesMatch \.php$><br>  SetHandler application/x-httpd-php<br></FilesMatch>
  • 如果用了 php-fpm,则不能用 AddHandler,而应配 ProxyPassMatch,例如:
    ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/html/
  • 注意:某些发行版(如 Ubuntu)会把处理器配置放在 /etc/apache2/mods-enabled/php*.load 和 php*.conf 中,别只改 httpd.conf

验证 PHP 文件是否被解析(而非直接下载)

创建一个 info.php 放在 Web 根目录,内容仅:
<?php phpinfo(); ?>,然后访问 http://localhost/info.php。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

立即学习“PHP免费学习笔记(深入)”;

  • 浏览器显示下载弹窗或源码 → Apache 完全没识别 PHP,回到前两步检查模块和处理器
  • 显示 500 错误 → 查 ErrorLog(如 /var/log/apache2/error.log),常见报错:
    PHP Parse error(语法错)、Unable to load dynamic library(扩展路径错)、Segmentation fault(PHP 和 Apache 版本冲突)
  • 空白页但无报错 → 可能 display_errors 关了,临时在 php.ini 加:
    display_errors = On
    error_reporting = E_ALL

检查 php.ini 路径与模块是否匹配

Apache 加载的 PHP 模块会读取特定位置的 php.ini,不是你随便改的那个。运行 phpinfo() 页面,看 Loaded Configuration File 的值,确保你编辑的是这个文件。

  • 常见错误:改了 /etc/php/8.1/cli/php.ini,但 Apache 用的是 /etc/php/8.1/apache2/php.ini
  • 如果 Loaded Configuration File 显示 (none) → PHP 没找到 ini 文件,需在 LoadModule 后加:
    PHPIniDir "/etc/php/8.1/apache2"
  • 扩展(如 mysqli)启用后仍报 Call to undefined function,检查该扩展的 .so 文件路径是否在 extension_dir 下,且 extension= 行未被分号注释

最常被忽略的是:修改配置后忘了重启 Apache(systemctl restart apache2 或 apachectl restart),以及错误日志里藏着关键线索——别只盯着浏览器表现。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

989

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3020

2023.10.25

undefined是什么
undefined是什么

undefined是代表一个值或变量不存在或未定义的状态。它可以作为默认值来判断一个变量是否已经被赋值,也可以用于设置默认参数值。尽管在不同的编程语言中,undefined可能具有不同的含义和用法,但理解undefined的概念可以帮助我们更好地理解和编写程序。本专题为大家提供undefined相关的各种文章、以及下载和课程。

11985

2023.07.31

网页undefined是什么意思
网页undefined是什么意思

网页undefined是指页面出现了未知错误的意思,提示undefined一般是在开发网站的时候定义不正确或是转换不正确,或是找不到定义才会提示undefined未定义这个错误。想了解更多的相关内容,可以阅读本专题下面的文章。

5507

2024.08.14

网页undefined啥意思
网页undefined啥意思

本专题整合了undefined相关内容,阅读下面的文章了解更多详细内容。后续继续更新。

2516

2025.12.25

function是什么
function是什么

function是函数的意思,是一段具有特定功能的可重复使用的代码块,是程序的基本组成单元之一,可以接受输入参数,执行特定的操作,并返回结果。本专题为大家提供function是什么的相关的文章、下载、课程内容,供大家免费下载体验。

3180

2023.08.04

js函数function用法
js函数function用法

js函数function用法有:1、声明函数;2、调用函数;3、函数参数;4、函数返回值;5、匿名函数;6、函数作为参数;7、函数作用域;8、递归函数。本专题提供js函数function用法的相关文章内容,大家可以免费阅读。

534

2023.10.07

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3259

2023.07.26

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn