FrankenPHP 自带 PHP 运行时和 CLI 工具链,无需系统 Composer 或 PHP;推荐用 php composer.phar 执行命令以确保环境一致,避免使用系统 composer。

不需要额外配置 Composer 运行环境,但需注意 FrankenPHP 自身的 PHP 运行时已内置,不依赖系统全局 Composer 或 PHP 安装。
FrankenPHP 的二进制包(如 frankenphp)是静态链接的完整可执行文件,内含 PHP 解释器、常用扩展及基础 CLI 工具链。它自带的 php-cli 可直接运行 Composer 命令,前提是:
- 项目目录中已存在
composer.phar(推荐方式),或 - 已将
composer.phar放在$PATH中,并确保它调用的是 FrankenPHP 内置的 PHP(而非系统 PHP)
关键操作建议:
-
✅ 推荐使用本地
composer.phar:立即学习“PHP免费学习笔记(深入)”;
php composer.phar install --no-dev --optimize-autoloader
这样能确保 Composer 使用 FrankenPHP 自带的 PHP 版本和扩展,避免兼容性问题。
-
✅ 验证 PHP 环境是否匹配:
frankenphp php-cli -v # 查看内置 PHP 版本 frankenphp php-cli -m # 列出已启用的扩展,确认 `pdo`, `mbstring`, `openssl` 等 Laravel/PHP 项目必需扩展存在
❌ 不要依赖系统
composer命令:
若系统安装了独立 Composer,它默认调用系统 PHP,可能与 FrankenPHP 的扩展集或版本不一致,导致ext-*检查失败或运行时错误。⚠️ 注意
--ignore-platform-reqs的使用场景:
仅当明确知道缺失扩展不影响当前命令(如仅生成 autoload 文件)时才加该参数;生产部署应优先通过install-php-extensions(Docker 场景)或编译时启用对应模块来补齐依赖。
FrankenPHP 的设计目标之一就是“零外部依赖”,所以 Composer 命令本身无需额外环境变量(如 PHP_INI_SCAN_DIR 或 COMPOSER_HOME),但需确保所用 PHP 执行器是它自带的那个。



















