README

为 Laravel 提供的 RethinkDB 适配器（支持 Eloquent）

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

该项目旨在针对即将发布的 Laravel 5，因此可能无法与 L4 兼容。

安装

要求。

1. Rethinkdb：您需要确保已成功安装 rethinkdb，您可以参考 rethinkdb 文档 了解如何安装 rethinkdb 的完整说明。

2. Laravel 5.2：此软件包是为与 laravel 5.2 一起使用而设计的，因此它不会与 laravel 4.x 一起使用。

安装

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

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

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

服务提供者

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

duxet\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 Users 迁移文件的示例

这是一个 laravel Users 迁移文件如何变化的示例

<?php

use duxet\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 \duxet\Rethinkdb\Eloquent\Model;

class News extends Model
{
    //
}

更新模型类

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

Laravel 用户模型类的示例

这是 Laravel 用户模型类如何成为的示例

use Illuminate\Auth\Authenticatable;
use \duxet\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;
    
    //
}