README

Laravel 的 RethinkDB 适配器（支持 Eloquent）

感谢 @jenssegers 他优秀的 laravel-mongodb 项目。我使用了他的测试和一些其他代码，因为这是一个支持其他 NoSQL 数据库的出色的代码库。我希望他不会因此生气；)

该项目旨在 Laravel 5，该版本即将发布，因此可能不与 L4 兼容。

安装

要求。

Rethinkdb：您需要确保已成功安装 rethinkdb，您可以参考 rethinkdb 文档了解如何安装 rethinkdb 的完整说明。
Laravel 5.2：此包旨在与 laravel 5.2 一起使用，因此它不会与 laravel 4.x 兼容。

安装

要完全安装此包，您需要手动将其添加到您的 composer.json 文件中，或者您可以执行以下命令

composer require "dkuzmenchuk/laravel-rethinkdb:dev-master"

这将安装包及其所有必需的包。

服务提供者

安装库后，您需要将 Service Provider 文件添加到您的 app.php 文件中，如下所示

dkuzmenchuk\Rethinkdb\RethinkdbServiceProvider::class,

在您的 providers 数组中。

数据库配置

现在您已经设置了服务提供者，您需要在数据库连接数组的末尾添加以下配置数组

    'rethinkdb' => [
        'name'      => 'rethinkdb',
        'driver'    => 'rethinkdb',
        'host'      => env('DB_HOST', 'localhost'),
        'port'      => env('DB_PORT', 28015),
        'database'  => env('DB_DATABASE', 'homestead'),            
    ]

添加后，您可以配置您的环境文件，如下所示

DB_HOST=localhost
DB_DATABASE=homestead
DB_CONNECTION=rethinkdb

但您始终可以将 DB_HOST 更新为指向您安装 rethinkdb 的 IP 地址。

迁移

创建迁移文件

您可以使用以下命令轻松创建迁移文件，该命令将为您创建一个迁移文件，用于创建用户表并使用包模式而不是 Laravel 模式

php artisan make:rethink-migration Users --create

请注意，您可以使用与 make:migration 相同的选项，因为 make:rethink-migration 基于 Laravel 的 make:migration

请注意，Laravel Schema API 并未完全实现。例如，使用自增的 ID 列将不是自动增加的无符号整数，而是 UUID，除非明确设置。最简单的解决方案是在 RethinkDB 中维护 UUID，在 Laravel 中关闭增量 ID，最后在 Laravel 中实现 UUID 的使用。

运行迁移

这里不会发生变化，您将继续使用您熟悉的 Laravel 命令来运行迁移。

Laravel 用户迁移文件的示例

这是 Laravel 用户迁移文件如何变化的示例

<?php

use dkuzmenchuk\Rethinkdb\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateUsersTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('users', function (Blueprint $table) {
            $table->increments('id');
            $table->string('name');
            $table->string('email')->unique();
            $table->string('password', 60);
            $table->rememberToken();
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::drop('users');
    }
}

模型

创建模型类

您可以使用以下命令轻松创建模型类，该命令将为您创建一个并使用包模型而不是 Laravel 模型

php artisan make:rethink-model News

请注意，您可以在 make:model 中使用相同的选项来使用 make:rethink-model，因为它是基于 laravel 的 make:model

Laravel 新闻模型类的示例

这是 laravel 模型类如何变成的示例

<?php

namespace App;

use \dkuzmenchuk\Rethinkdb\Eloquent\Model;

class News extends Model
{
    //
}

更新模型类

请注意，Laravel 在其初始安装过程中生成的任何模型都需要手动更新才能正常工作。例如，用户模型扩展了 Illuminate\Foundation\Auth\User，它进一步扩展了 Illuminate\Database\Eloquent\Model 而不是 \dkuzmenchuk\Rethinkdb\Eloquent\Model;。需要从用户模型中移除对 Illuminate\Foundation\Auth\User 的导入，并替换为 \dkuzmenchuk\Rethinkdb\Eloquent\Model;，并且需要将 Illuminate\Foundation\Auth\User 中实现的所有所需接口和关联特质移植到用户模型中。

Laravel 用户模型类的示例

这是 laravel 用户模型类如何变成的示例

use Illuminate\Auth\Authenticatable;
use \dkuzmenchuk\Rethinkdb\Eloquent\Model;
use Illuminate\Auth\Passwords\CanResetPassword;
use Illuminate\Foundation\Auth\Access\Authorizable;
use Illuminate\Contracts\Auth\Authenticatable as AuthenticatableContract;
use Illuminate\Contracts\Auth\Access\Authorizable as AuthorizableContract;
use Illuminate\Contracts\Auth\CanResetPassword as CanResetPasswordContract;

class User extends Model implements
    AuthenticatableContract,
    AuthorizableContract,
    CanResetPasswordContract
{
    use Authenticatable, Authorizable, CanResetPassword;
    
    //
}

dkuzmenchuk / laravel-rethinkdb

维护者

详细信息