0

0

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

看不見的法師

看不見的法師

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

|

643人浏览过

|

来源于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 phpapache2ctl -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*.loadphp*.conf 中,别只改 httpd.conf

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

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

Pixlr Remove BG
Pixlr Remove BG

几秒钟删除图片背景

下载

立即学习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 apache2apachectl restart),以及错误日志里藏着关键线索——别只盯着浏览器表现。

相关文章

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

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

下载

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

351

2023.10.18

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

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

339

2023.10.25

undefined是什么
undefined是什么

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

5621

2023.07.31

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

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

3205

2024.08.14

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

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

1164

2025.12.25

function是什么
function是什么

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

493

2023.08.04

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

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

166

2023.10.07

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

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

1112

2023.07.26

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

145

2026.02.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 11.9万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号