laravel 原生不支持将 firebase 作为默认 sql 类型数据库（如 mysql），因其底层为 nosql 实时数据库或 firestore，无法通过 db_connection=firebase 配置；正确方式是借助官方推荐的 firebase-php sdk，通过服务账号凭证实现安全、灵活的集成。
laravel 原生不支持将 firebase 作为默认 sql 类型数据库（如 mysql），因其底层为 nosql 实时数据库或 firestore，无法通过 db_connection=firebase 配置；正确方式是借助官方推荐的 firebase-php sdk，通过服务账号凭证实现安全、灵活的集成。
Firebase 并非传统的关系型数据库（RDBMS），它不提供 host、port、username、password 等 SQL 连接参数，也不兼容 Laravel 的 Eloquent ORM 或 DB 门面。因此，你不能也不应在 .env 中设置 DB_CONNECTION=firebase，或尝试修改 config/database.php 中的默认连接配置——这会导致连接失败或运行时异常。
✅ 正确集成路径如下：
1. 安装 Firebase PHP SDK
使用 Composer 引入官方维护的 kreait/firebase-php 库：
composer require kreait/firebase-php
2. 获取并配置服务账号凭证
在 Firebase 控制台 → 项目设置 → 服务账号 → 生成新的私钥（JSON 文件），保存为 storage/app/firebase/service-account.json（确保该路径受保护，不公开于 Web 目录）。
3. 创建 Firebase Service Provider（推荐）
运行命令生成自定义服务提供者：
php artisan make:provider FirebaseServiceProvider
在 app/Providers/FirebaseServiceProvider.php 中注册客户端：
<?php namespace App\Providers;
use Illuminate\Support\ServiceProvider;
use Kreait\Firebase\Factory;
class FirebaseServiceProvider extends ServiceProvider
{
public function register()
{
$this->app->singleton('firebase', function ($app) {
$factory = (new Factory)
->withServiceAccount(storage_path('app/firebase/service-account.json'))
->withDatabaseUri('https://your-project-id-default-rtdb.firebaseio.com/'); // 实时数据库 URI
// 若使用 Firestore，可调用 ->withFirestoreDatabase();
return $factory->createDatabase();
});
}
}
然后在 config/app.php 的 providers 数组中添加：
App\Providers\FirebaseServiceProvider::class,
4. 在控制器中使用
例如在 UserController.php 中读取实时数据库数据：
<?php namespace App\Http\Controllers;
use Illuminate\Http\Request;
class UserController extends Controller
{
public function index()
{
$database = app('firebase');
$usersRef = $database->getReference('users');
$snapshot = $usersRef->getSnapshot();
$users = [];
foreach ($snapshot->getChildren() as $child) {
$users[] = $child->getValue();
}
return response()->json($users);
}
}
⚠️ 注意事项：
- 绝不硬编码私钥：服务账号 JSON 必须通过 storage/ 或环境变量（如 FIREBASE_CREDENTIALS_PATH）加载，禁止提交至 Git。
- 区分数据库类型：实时数据库（Realtime Database）与 Firestore API 不同，SDK 调用方式有差异，请按需选择 createDatabase() 或 createFirestore()。
- 权限控制：Firebase 规则（Security Rules）必须严格配置，避免未授权读写；服务账号拥有项目级权限，务必限制其使用场景。
- Eloquent 替代方案：如需类 Eloquent 操作，可封装 Repository 模式或使用社区包（如 laravel-firebase），但不建议强行适配 ActiveRecord 模式。
总结：Firebase 与 Laravel 的集成本质是「HTTP 客户端通信」，而非「数据库驱动连接」。摒弃 DB_CONNECTION 思维，拥抱 SDK 原生能力，才能发挥 Firebase 实时同步、离线支持与细粒度鉴权的优势。
