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

PHP如何让CLI与FPM共享库_CLI与FPM共享库做法【共用】

陌伟大大_9029

陌伟大大_9029

发布时间:2026-01-16 19:54:41

|

973人浏览过

|

来源于php中文网

原创

CLI 和 FPM 能共享扩展和配置的前提是二者加载相同的 php.ini 文件或完全一致的 extension_dir 与 extension= 配置项,且扩展文件存在、可读、ABI 兼容;需避免 php_admin_value 等运行时覆盖,并验证运行时功能而非仅模块列表。

php如何让cli与fpm共享库_cli与fpm共享库做法【共用】

PHP CLI 和 FPM 共享同一套扩展和配置的前提是什么

CLI 和 FPM 能共享库,本质是因为它们用的是同一个 php.ini 文件(或加载了相同路径下的配置),且扩展是通过 extension=xxx.so(Linux/macOS)或 extension=xxx.dll(Windows)动态加载的——只要扩展文件存在、权限可读、ABI 兼容,CLI 和 FPM 都能加载它。

但默认情况下,很多系统会为 CLI 和 FPM 分别配置不同的 php.ini:比如 Ubuntu 的 /etc/php/*/cli/php.ini 和 /etc/php/*/fpm/php.ini。这时候看似“同一 PHP 版本”,实际加载的扩展可能完全不同。

  • 检查当前 CLI 加载的配置:php --ini
  • 检查 FPM 加载的配置:在 FPM 的 www.conf 中确认 php_admin_value[php_ini] 是否被覆盖;否则看 php-fpm -t 或 php-fpm -i | grep "Loaded Configuration File"
  • 关键判断依据:两个 SAPI 加载的 php.ini 必须指向同一个文件,或至少确保 extension_dir 相同、extension= 行完全一致

如何让 CLI 和 FPM 真正共用 extension_dir 和扩展列表

最稳妥的做法是统一配置入口,避免双份维护。不推荐“复制粘贴 ini 文件”,而应让两者指向同一主配置。

  • 把所有自定义扩展配置(如 extension=redis.so、extension=grpc.so)集中写到一个独立文件,比如 /etc/php/conf.d/99-common.ini
  • 确保 CLI 和 FPM 的主 php.ini 都启用了 scan_dir(默认开启),即包含类似 include_path = ".:/usr/share/php" 且支持 conf.d/ 扫描
  • 验证是否生效:php -m | grep redis 和 php-fpm -m | grep redis 输出应一致
  • 注意:某些扩展(如 opcache)在 CLI 下默认禁用(opcache.enable_cli=0),即使加载了也不起作用——这不是“没共享”,而是运行时策略不同

常见踩坑点:扩展加载成功但行为不一致

扩展 .so 文件被加载 ≠ 功能表现一致。以下情况会导致“看似共享,实则失效”:

Zynq Linux Hardware Debug
Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq(Cortex‑A9/A53 + FPGA)Linux 环境,调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查,支持 PetaLinux 开发。

下载

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

  • extension_dir 路径不同:CLI 可能用 /usr/lib/php/20220829/,FPM 却指向 /usr/lib/php/20210902/(对应不同 PHP 主版本 ABI)——此时即使文件名一样,也会报 undefined symbol 或直接跳过加载
  • 扩展依赖的底层库版本冲突:例如 CLI 用系统 OpenSSL 3.0,FPM 被编译链接了 LibreSSL,导致 curl 或 openssl 扩展在某一边初始化失败(错误日志里可能只显示 Failed to load module,无细节)
  • 环境变量干扰:FPM 进程常以 www-data 用户运行,而 CLI 是当前用户;若扩展依赖 /dev/shm、/tmp 下的 socket 或锁文件,权限/路径隔离会导致运行时失败(例如 apcu 的共享内存段不可见)
  • PHP-FPM 的 php_admin_flag / php_admin_value 会强制覆盖 php.ini 设置,包括 extension= ——这种覆盖是单向的,CLI 完全不受影响,极易造成“两边看到的 phpinfo() 不一样”

验证共享是否真正生效的最小检查清单

不要只看 php -m,要穿透到运行时能力:

php -r "echo extension_loaded('redis') ? 'OK' : 'MISSING';"
php-fpm -t && sudo systemctl restart php*-fpm
curl -s http://localhost/test.php | grep redis

其中 test.php 内容为:

<?php
var_dump([
    'loaded' => extension_loaded('redis'),
    'version' => phpversion('redis'),
    'class_exists' => class_exists('Redis'),
]);

如果 CLI 返回 true 而 FPM 返回 false,说明不是“没装”,而是加载路径、权限、或 php_admin_value 拦截了扩展启用。这时优先查 FPM 错误日志(tail -f /var/log/php*-fpm.log),比反复改 ini 更快定位真实原因。

热门AI工具

更多
UP简历
UP简历 Hot

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

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

DeepSeek

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

二狗PPT
二狗PPT Hot

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

Laper
Laper Hot

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

WorkBuddy

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

豆包大模型

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

3543

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

795

2023.10.30

undefined是什么
undefined是什么

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

11705

2023.07.31

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

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

5507

2024.08.14

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

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

2516

2025.12.25

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

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

3179

2023.07.26

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

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2758

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

1468

2023.08.01

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

80

2026.10.10

热门下载

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

精品课程

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

共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