装fileinfo失败主因是系统缺失libmagic开发包，需按系统安装对应包（如Ubuntu装libmagic-dev、CentOS装file-devel），再重新编译PHP或安装php*-fileinfo扩展。
装 fileinfo 拓展失败，大概率是系统缺 libmagic 库，不是 PHP 本身的问题。
为什么装 fileinfo 会失败
fileinfo 是 PHP 内置拓展，但编译时依赖系统级的 libmagic（提供文件类型识别能力）。如果系统没装这个库，或者开发包（-dev 或 -devel）缺失，./configure 就会跳过它，make 阶段也可能报错。
- 常见错误提示：
configure: WARNING: fileinfo support requires libmagic >= 5.11或直接不生成fileinfo.so - CentOS/RHEL 系统里叫
file-devel，Ubuntu/Debian 叫libmagic-dev - 只装
file命令（如apt install file）不够——它不含头文件和静态库，编译阶段仍会失败
不同系统安装 libmagic 开发包
先装对的系统依赖，再重新编译或启用拓展：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- Ubuntu/Debian：
sudo apt update && sudo apt install libmagic-dev - CentOS 7 / RHEL 7：
sudo yum install file-devel - CentOS 8+ / Rocky/AlmaLinux：
sudo dnf install file-devel - macOS（Homebrew）：
brew install libmagic（注意：PHP 官方源码编译需确认pkg-config能找到它；M1/M2 可能还需加export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig"）
重装 fileinfo 的实操路径
装完 libmagic 开发包后，不能只执行 pecl install fileinfo（它已内置，PECL 不适用），得走 PHP 源码编译流程：
立即学习“PHP免费学习笔记（深入）”；
- 如果你是源码编译 PHP：
cd /path/to/php-src && ./configure --with-fileinfo [其他参数] && make && sudo make install - 如果你用
phpbrew：phpbrew ext install fileinfo（它会自动检查依赖） - 如果你用
apt安装的 PHP（如 Ubuntu 的php7.4-cli）：sudo apt install php7.4-fileinfo（对应版本号要一致） - 验证是否生效：
php -m | grep fileinfo或php -r "var_dump(function_exists('finfo_open'));"
最容易被忽略的是：有些 Docker 镜像（比如 php:alpine）默认不带 libmagic，且 Alpine 的包名是 libmagic（不是 -dev），但编译 PHP 时仍需 libmagic-dev —— Alpine 用户得额外 apk add libmagic-dev，否则 configure 仍静默跳过。
