frankenphp自带嵌入式php解释器，不依赖系统php安装；提示“缺少扩展”时，需确认该扩展是否已内置、启用或需用frankenphp特有方式加载，如编辑项目根目录php.ini添加extension=curl等，或用pie install redis安装第三方扩展，修改后必须重启服务生效。
FrankenPHP 本身不是传统 PHP 运行环境，它不依赖系统级 PHP 安装，而是自带嵌入式 PHP 解释器。所以当它提示“缺少扩展”，通常不是让你去系统里装 php-curl 这类包，而是要确认：该扩展是否已内置、是否被启用、或是否需用 FrankenPHP 特有的方式加载。
先确认缺失的是哪个扩展
运行 FrankenPHP 时出现的错误（如 Call to undefined function curl_init() 或 ext/redis not found），直接指出函数名或扩展名。记下这个名称，比如 curl、mbstring、json、pdo_mysql 等。FrankenPHP 默认已启用多数核心扩展（如 json、xml、zlib），但像 curl、gd、redis 等需额外确认。
你可以临时起一个服务，访问 http://localhost:8080/phpinfo（FrankenPHP 默认提供该路由），搜索关键词看对应模块是否显示 enabled；或在 CLI 模式下执行：frankenphp run --php-info | grep -i "curl\|mbstring\|redis"
FrankenPHP 内置扩展的启用方法
FrankenPHP 使用自己的 php.ini 配置（非系统 php.ini）。它会读取项目根目录下的 php.ini，或通过 --php-config 指定路径。
- 新建或编辑项目根目录下的
php.ini - 确保
extension_dir指向正确位置（FrankenPHP 通常自动设置，一般无需改动） - 取消注释或添加扩展行，例如：
extension=curlextension=mbstringextension=pdo_mysql - 注意：FrankenPHP 支持直接写扩展名（如
curl），不用写curl.so或php_curl.dll—— 这是它与传统 PHP 的关键区别之一
需要手动安装的扩展（如 redis、swoole、yac）
FrankenPHP 不预装第三方 PECL 扩展。若提示缺少 redis、swoole 等，需按以下步骤操作：
- 确认你的 FrankenPHP 是从 官方 Release 下载 的二进制文件（推荐），而非源码编译版；只有官方二进制才保证 ABI 兼容性
- 使用
pecl安装（需系统已装php-dev和build-essential）：pecl install redis
安装完成后，它会输出类似extension=redis.so的提示，把这行加到你的项目php.ini中 - 或改用
pie（PHP Installer for Extensions），对 FrankenPHP 更友好：pie install redis
它会自动适配 FrankenPHP 的扩展目录和加载方式 - Windows 用户：FrankenPHP 目前暂不支持 DLL 加载，建议在 WSL2 或 Linux 环境中运行
重启并验证是否生效
FrankenPHP 是进程模型，修改 php.ini 后必须重启服务才能生效。
- 如果是
frankenphp run开发模式，Ctrl+C 停止后重新运行 - 如果是 systemd 或 Docker，执行重启命令（如
sudo systemctl restart frankenphp） - 验证方式：
frankenphp run --php-info | grep "curl support"（查 curl）
或写个简单脚本：frankenphp run -d "echo 'OK: ' . (function_exists('curl_init') ? 'curl' : 'no curl');"
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
