FrankenPHP启动报缺扩展，需先确认其实际使用的PHP版本和SAPI，再按Debian 12包命名规则安装对应版本扩展（如php8.3-curl），并确保extension_dir路径一致、配置在frankenphp.yaml或项目php.ini中正确声明，最后用frankenphp run验证加载。
FrankenPHP 启动报错说缺扩展，不是 FrankenPHP 的问题，而是它用的 PHP SAPI（frankenphp）依赖标准 PHP 扩展，必须按 Debian 12 的 PHP 包管理规则补全，不能直接套用旧版 apt 包名或 Windows 配置逻辑。
确认 FrankenPHP 实际用的是哪个 PHP 版本和 SAPI
FrankenPHP 自带 PHP 运行时，但它的 CLI 和 Web 模式可能复用系统 PHP 配置，也可能走独立路径。先查清它调用的是谁：
- 运行
frankenphp version或frankenphp --version，看输出里是否带 PHP 版本号（如PHP 8.3.10） - 若没明确版本，执行
frankenphp run --help 2>&1 | grep -i php，观察是否引用/usr/bin/php或/opt/frankenphp/... - 最关键：在项目根目录下放一个
info.php，内容为<?php phpinfo(); ?>，用 FrankenPHP 启动后访问该页，看顶部 “Loaded Configuration File” 和 “PHP Extension” 列表 —— 这才是它真正加载的配置和模块
Debian 12 下安装缺失扩展必须匹配包命名规则
Debian 12 默认使用 PHP 8.2，但 FrankenPHP 可能用 8.3 或自带嵌入式 PHP。包名必须严格对应版本号，否则 apt install php-curl 会装错目标（它默认指向 php8.2-curl）：
- 查当前系统 PHP 版本：
php -v；查 FrankenPHP 内置 PHP 版本：frankenphp eval 'echo PHP_VERSION;' - 若 FrankenPHP 用的是 8.3：
sudo apt install php8.3-curl php8.3-gd php8.3-mbstring php8.3-xml php8.3-zip - 若用的是 8.2（系统默认）：
sudo apt install php-curl php-gd php-mbstring php-xml php-zip（这些是 meta 包，会自动选 8.2） - 特别注意：
php-opcache和php-sqlite3常被忽略，但 FrankenPHP 的 Session、缓存、SQLite 驱动都依赖它们
extension_dir 和 .so 路径不一致导致“已装却未加载”
FrankenPHP 不读取系统 /etc/php/*/cli/php.ini，它优先用内置配置或项目级 php.ini。即使你 apt install 成功，扩展文件也可能不在它预期的路径里：
立即学习“PHP免费学习笔记（深入）”；
- 查 FrankenPHP 实际 extension_dir：
frankenphp eval 'echo ini_get("extension_dir");' - 常见路径有：
/usr/lib/php/20220829（PHP 8.2）、/usr/lib/php/20230831（PHP 8.3），或/opt/frankenphp/lib/php/extensions - 如果
apt安装的.so在/usr/lib/php/20230831/，但 FrankenPHP 查的是/opt/frankenphp/lib/php/extensions，就得手动软链或复制：sudo cp /usr/lib/php/20230831/curl.so /opt/frankenphp/lib/php/extensions/ - 然后在 FrankenPHP 的
php.ini（通常是项目根目录下的php.ini或frankenphp.yaml中指定路径）里加：extension=curl.so（不是extension=php_curl.dll）
验证扩展是否真被 FrankenPHP 加载
别信 php -m，那是系统 CLI 的结果。必须用 FrankenPHP 自己的上下文验证：
- 写一个测试脚本
check.php：<?php var_dump(extension_loaded('curl'), get_loaded_extensions()); ?> - 用 FrankenPHP 运行：
frankenphp run check.php，看输出是否为bool(true) - 或者启动 HTTP 模式：
frankenphp serve，再 curlhttp://localhost/check.php - 如果仍失败，检查错误日志：
frankenphp serve --log-level debug，重点找Failed loading或undefined symbol—— 后者说明 ABI 不兼容，需重装对应 PHP 主版本的扩展包
最易被忽略的一点：FrankenPHP 的 frankenphp.yaml 可以覆盖 php.ini 设置，包括 extension_dir 和 extension 指令。如果 yaml 里写了 php: { extension_dir: "...", extensions: ["curl"] }，那 php.ini 里的同名配置会被完全忽略 —— 此时改 php.ini 是无效的。
