FrankenPHP 在 CentOS 8 上安装缺失 libbpf 是因系统默认无该库且内核 4.18 缺少配套头文件；需启用 PowerTools 安装 libbpf-devel 或手动编译，也可通过 WITHOUT_LIBBPF=1 跳过依赖。
FrankenPHP 在 CentOS 8 上安装时提示缺少 libbpf，是因为其底层依赖 eBPF 功能（尤其是启用 HTTP/3、QUIC 或性能监控等特性时），而 CentOS 8 默认仓库不提供 libbpf 开发包，且系统内核版本（4.18）虽支持基础 eBPF，但缺乏配套的用户态库和头文件。
确认缺失并检查系统状态
运行以下命令验证问题：
-
dnf list installed | grep bpf—— 通常无输出，说明未安装 -
uname -r—— 确认内核为4.18.0-xxx.el8（CentOS 8 标准内核） -
pkg-config --modversion libbpf 2>/dev/null || echo "not found"—— 返回 not found 即确认缺失
安装 libbpf 开发包（推荐方式）
CentOS 8 官方源不含 libbpf，需启用 PowerTools 仓库（原 CodeReady Builder）后安装：
- 启用仓库：
sudo dnf config-manager --set-enabled powertools - 安装开发包：
sudo dnf install libbpf-devel -y - 验证安装：
pkg-config --cflags --libs libbpf应返回有效路径和链接参数
若 PowerTools 不可用或版本过旧
可手动编译安装较新版本 libbpf（适用于 FrankenPHP 需要较新 API 的场景）：
立即学习“PHP免费学习笔记（深入）”；
- 安装构建依赖：
sudo dnf groupinstall "Development Tools" && sudo dnf install cmake elfutils-libelf-devel zlib-devel -y - 下载并编译 libbpf（以 v1.3.0 为例）：
cd /tmp && wget https://github.com/libbpf/libbpf/archive/refs/tags/v1.3.0.tar.gz && tar -xzf v1.3.0.tar.gz && cd libbpf-1.3.0/src && make && sudo make install - 更新动态库缓存：
sudo ldconfig
编译 FrankenPHP 时确保识别到 libbpf
执行 make 前，建议显式指定 pkg-config 路径（尤其手动安装后）：
export PKG_CONFIG_PATH="/usr/local/lib64/pkgconfig:$PKG_CONFIG_PATH"- 再运行
make，过程中应看到类似checking for libbpf... yes的提示 - 若仍失败，可临时加编译标志：
make LDFLAGS="-lbpf" CPPFLAGS="-I/usr/include/bpf"
注意：FrankenPHP 默认不强制依赖 libbpf；仅当启用 --with-quic 或某些实验性功能时才真正需要。如暂不需 QUIC 支持，也可跳过 libbpf，改用 make WITHOUT_LIBBPF=1 编译（具体以项目 Makefile 支持为准）。
