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

如何在 macOS M1 上为 Apache 启用 PHP(解决模块签名错误)

千辰君_8573

千辰君_8573

发布时间:2026-01-30 19:34:01

|

366人浏览过

|

来源于php中文网

原创

如何在 macOS M1 上为 Apache 启用 PHP(解决模块签名错误)

本文详解 macos m1 环境下通过 homebrew 安装 php 后,如何正确配置 apache 加载 php 模块——核心在于绕过 macos 强制的代码签名验证限制,而非简单修改 loadmodule 路径。

在 macOS Monterey 及更高版本(尤其是搭载 Apple Silicon M1/M2/M3 芯片的设备)上,系统内置的 Apache(/usr/sbin/httpd)默认启用严格的模块代码签名验证(code signing enforcement)。当你使用 brew install php 安装 PHP 后,Homebrew 生成的 libphp.so 动态库未经过 Apple 签名,因此即使路径正确、语法无误,Apache 在启动时也会因 Code signing absent 错误拒绝加载该模块,并静默失败(仅在 error_log 中记录 AH00169: caught SIGTERM 这类误导性信息)。

✅ 正确解决方案:禁用 Apache 模块签名检查

关键步骤不是改路径,而是关闭签名强制策略。

  1. 确认当前 Apache 配置语法错误
    运行以下命令验证真实报错:

    sudo apachectl configtest

    你将看到类似输出:

    httpd: Syntax error on line 190 of /private/etc/apache2/httpd.conf: 
    Code signing absent - not loading module at: /opt/homebrew/opt/php/lib/httpd/modules/libphp.so
  2. 修改 Apache 启动参数,禁用模块签名验证
    编辑 Apache 的 launch daemon 配置文件:

    sudo nano /System/Library/LaunchDaemons/org.apache.httpd.plist
    ⚠️ 注意:此为系统级 plist,切勿直接修改 /Library/LaunchDaemons/ 下的自定义 plist(若存在),因为系统 Apache 默认使用 /System/... 路径。

    找到 标签下已有的 httpd 行,在其后新增一行:

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

    Apple Health → OpenClaw
    Apple Health → OpenClaw

    将 iPhone 的 Apple Health 数据同步到 OpenClaw。只需扫描一次二维码,无需手动配置。支持 Mac、Linux 和 VPS。

    下载
    <string>-D</string>
    <string>NO_MODULE_SIGNATURE_CHECK</string>

    修改后片段应类似:

    <array>
        <string>httpd</string>
        <string>-D</string>
        <string>NO_MODULE_SIGNATURE_CHECK</string>
        <string>-f</string>
        <string>/private/etc/apache2/httpd.conf</string>
        <string>-D</string>
        <string>FOREGROUND</string>
    </array>
  3. 更新 Apache 配置:正确加载 PHP 模块
    编辑 /etc/apache2/httpd.conf,确保启用 PHP 模块(取消注释或添加):

    # 启用 PHP 模块(路径以 brew info php 输出为准)
    LoadModule php_module /opt/homebrew/opt/php/lib/httpd/modules/libphp.so
    
    # 添加 PHP 文件类型处理
    <FilesMatch \.php$>
        SetHandler application/x-httpd-php
    </FilesMatch>
    
    # 可选:设置默认首页支持 .php
    DirectoryIndex index.php index.html

    ✅ 获取准确路径(推荐):

    brew --prefix php  # 通常输出 /opt/homebrew/opt/php
    ls /opt/homebrew/opt/php/lib/httpd/modules/libphp.so  # 确认文件存在
  4. 重启 Apache 生效

    sudo apachectl stop
    sudo launchctl unload /System/Library/LaunchDaemons/org.apache.httpd.plist
    sudo launchctl load /System/Library/LaunchDaemons/org.apache.httpd.plist
    # 或更可靠方式(重载整个服务):
    sudo killall httpd && sudo apachectl start
  5. 验证 PHP 是否生效
    创建测试文件 /Library/WebServer/Documents/info.php:

    <?php phpinfo(); ?>

    访问 http://localhost/info.php —— 若显示 PHP 信息页,则配置成功。

⚠️ 重要注意事项

  • 安全性权衡:NO_MODULE_SIGNATURE_CHECK 会降低模块加载安全性,但仅影响本地开发环境,切勿在生产服务器启用。
  • PHP 版本兼容性:Homebrew PHP 默认编译为通用架构(universal2),完全兼容 M1;无需手动编译。
  • 避免混用 Apache:macOS 自带 Apache 与 Homebrew 安装的 httpd(如 brew install httpd)互斥,本文方案基于系统 Apache + Homebrew PHP 组合。
  • 权限问题:确保 /etc/apache2/ 下配置文件可读,且 libphp.so 具有执行权限(chmod +x 通常非必需,但可检查)。

通过以上步骤,你将彻底解决 M1 Mac 上 Apache 无法加载 Homebrew PHP 模块的核心障碍——这不是路径错误,而是 macOS 安全机制与开源模块生态之间的典型适配问题。

热门AI工具

更多
DeepSeek

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

豆包大模型

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

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

Laper
Laper Hot

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

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6739

2023.08.02

macOS怎么切换用户账户
macOS怎么切换用户账户

在 macOS 系统中,可通过多种方式切换用户账户。如点击苹果图标选择 “系统偏好设置”,打开 “用户与群组” 进行切换;或启用快速用户切换功能,通过菜单栏或控制中心的账户名称切换;还能使用快捷键 “Control+Command+Q” 锁定屏幕后切换。

4984

2025.05.09

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3683

2023.11.09

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

934

2023.11.14

HTTP 503错误解决方法
HTTP 503错误解决方法

HTTP 503错误表示服务器暂时无法处理请求。想了解更多http错误代码的相关内容,可以阅读本专题下面的文章。

6626

2024.03.12

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5470

2024.08.16

Go 语言 HTTP 编程与中间件开发教程合集
Go 语言 HTTP 编程与中间件开发教程合集

全面讲解 Go 语言 HTTP 编程的核心知识,涵盖 net/http 标准库的 Server/Handler/HandlerFunc 体系、DefaultServeMux 路由注册与自定义路由器、Request / ResponseWriter 请求响应处理、中间件(Middleware)链式设计模式与常见中间件(日志/CORS/认证/限流)开发、http.Client 的超时配置与连接池管理、Cookie / Session 处理、

541

2026.05.08

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

0

2026.10.28

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

0

2026.10.28

热门下载

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

精品课程

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

共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