0

0

Apache中PHP扩展怎么安装_添加PHP模块到Apache的操作【教程】

絕刀狂花

絕刀狂花

发布时间:2026-02-11 11:43:02

|

593人浏览过

|

来源于php中文网

原创

Apache需通过PHP模块(如libphp.so)支持PHP解析,而非仅安装PHP扩展;须确认模块存在、正确LoadModule、匹配prefork MPM,并验证配置。

apache中php扩展怎么安装_添加php模块到apache的操作【教程】

Apache 本身不处理 PHP,必须通过模块(如 libphp.sophp_module)让 Apache 能调用 PHP 解释器。直接“安装 PHP 扩展”和“把 PHP 加进 Apache”是两件事——前者是给 PHP 本体加功能(比如 pdo_mysql),后者是让 Apache 能运行 PHP 文件。你真正要做的,是启用 Apache 的 PHP 模块支持。

确认 PHP 是否已以模块方式安装

很多系统(尤其是 Ubuntu/Debian)装的 php 包默认已包含 Apache 模块,并自动启用;而 CentOS/RHEL 的 php-fpm 包则默认不带 Apache 模块,需额外安装 php-commonphp-cli,再手动加载模块。

  • 运行 apache2ctl -M | grep php(Ubuntu/Debian)或 httpd -M | grep php(CentOS/RHEL),看是否已有 php7_modulephp_module
  • 若无输出,说明模块未加载;但别急着编译——先查 php -v 确认 PHP 已安装,再查 find /usr -name "libphp*.so" 2>/dev/null 看模块文件是否存在
  • 常见路径:/usr/lib/apache2/modules/libphp.so(Debian)、/usr/lib64/httpd/modules/libphp7.so(RHEL)

在 httpd.conf 或 mods-enabled 中加载 PHP 模块

Apache 不会自动发现 PHP 模块,必须显式 LoadModule 并配置 AddHandler。路径和模块名必须严格匹配实际文件,否则启动报错 Cannot load modules/libphp.so into server

  • 编辑主配置文件(如 /etc/apache2/apache2.conf/etc/httpd/conf/httpd.conf),添加:
    LoadModule php_module /usr/lib/apache2/modules/libphp.so
    
        SetHandler application/x-httpd-php
    
  • Debian/Ubuntu 用户更推荐用 a2enmod php(对应 php7.4php8.2),它会自动处理符号链接和依赖
  • RHEL/CentOS 8+ 使用 dnf install php-apache,该包会自带正确 LoadModule 行并放入 /etc/httpd/conf.modules.d/15-php.conf

PHP 文件不解析?检查 MPM 和模块冲突

Apache 的 MPM(如 eventprefork)会影响 PHP 模块能否加载。libphp.so 只兼容 prefork MPM,若当前是 eventhttpd 启动会失败并报错 Invalid argument: couldn't create or get scoreboard

AI图像编辑器
AI图像编辑器

使用文本提示编辑、变换和增强照片

下载

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

  • 运行 apache2ctl -V | grep MPMhttpd -V | grep MPM 查当前 MPM
  • Debian:改用 a2dismod mpm_event && a2enmod mpm_prefork;RHEL:编辑 /etc/httpd/conf.modules.d/00-mpm.conf,注释 event 行,取消注释 prefork
  • 重启前务必运行 apache2ctl configtesthttpd -t 验证语法,避免服务起不来
  • 别漏掉 中的 AllowOverride AllRequire all granted,否则即使模块加载成功,也可能 403 或直接下载 .php 文件

最常被忽略的是 MPM 类型与 PHP 模块的硬性绑定关系——哪怕所有配置都对,只要 MPM 不匹配,PHP 就不会工作。另外,libphp.so 是线程不安全的,它只在 prefork 下可靠;如果真需要 event + PHP,得换用 PHP-FPM + proxy_fcgi,那已是另一套架构了。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

243

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

665

2024.03.01

require的用法
require的用法

require的用法有引入模块、导入类或方法、执行特定任务。想了解更多require的相关内容,可以阅读本专题下面的文章。

473

2023.11.27

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

633

2023.08.10

apache是什么意思
apache是什么意思

Apache是Apache HTTP Server的简称,是一个开源的Web服务器软件。是目前全球使用最广泛的Web服务器软件之一,由Apache软件基金会开发和维护,Apache具有稳定、安全和高性能的特点,得益于其成熟的开发和广泛的应用实践,被广泛用于托管网站、搭建Web应用程序、构建Web服务和代理等场景。本专题为大家提供了Apache相关的各种文章、以及下载和课程,希望对各位有所帮助。

413

2023.08.23

apache启动失败
apache启动失败

Apache启动失败可能有多种原因。需要检查日志文件、检查配置文件等等。想了解更多apache启动的相关内容,可以阅读本专题下面的文章。

935

2024.01.16

Java 流式处理与 Apache Kafka 实战
Java 流式处理与 Apache Kafka 实战

本专题专注讲解 Java 在流式数据处理与消息队列系统中的应用,系统讲解 Apache Kafka 的基础概念、生产者与消费者模型、Kafka Streams 与 KSQL 流式处理框架、实时数据分析与监控,结合实际业务场景,帮助开发者构建 高吞吐量、低延迟的实时数据流管道,实现高效的数据流转与处理。

95

2026.02.04

常见的linux系统有哪些
常见的linux系统有哪些

linux系统有Ubuntu、Fedora、CentOS、Debian、openSUSE、Arch Linux、Gentoo、Slackware、Linux Mint、Kali Linux。更多关于linux系统的文章详情请阅读本专题下面的文章。php中文网欢迎大家前来学习。

830

2023.10.27

Rust异步编程与Tokio运行时实战
Rust异步编程与Tokio运行时实战

本专题聚焦 Rust 语言的异步编程模型,深入讲解 async/await 机制与 Tokio 运行时的核心原理。内容包括异步任务调度、Future 执行模型、并发安全、网络 IO 编程以及高并发场景下的性能优化。通过实战示例,帮助开发者使用 Rust 构建高性能、低延迟的后端服务与网络应用。

1

2026.02.11

热门下载

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

精品课程

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

共137课时 | 11.5万人学习

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号