chkm8/laravel-rethinkdb

Laravel 的 RethinkDB 驱动器

dev-master 2024-08-07 14:12 UTC

This package is auto-updated.

Last update: 2024-09-07 14:17:08 UTC


README

Total Downloads MIT License Build Status Coverage Status Scrutinizer Quality Score

Laravel 的 RethinkDB 驱动器(支持 Eloquent)

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

安装

需求。

  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 并未完全实现。例如,使用 increments 的 ID 列将不会是自动递增的无符号整数,而是 UUID,除非显式设置。最简单的解决方案是在 RethinkDB 内维护 UUID,在 Laravel 中关闭增量 ID,并最终在 Laravel 中实现 UUID 的使用。

运行迁移

这里不会发生变化,您将保持使用与您习惯执行的相同的 Laravel 命令来运行迁移。

Laravel 用户迁移文件示例

这是 Laravel 用户迁移文件如何成为的示例

<?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在初始安装过程中生成的任何模型都需要手动更新,才能正常工作。例如,用户模型扩展了Illuminate\Foundation\Auth\User,它进一步扩展了Illuminate\Database\Eloquent\Model,而不是\duxet\Rethinkdb\Eloquent\Model;。需要从用户模型中移除对Illuminate\Foundation\Auth\User的导入,并替换为\duxet\Rethinkdb\Eloquent\Model;,以及任何在Illuminate\Foundation\Auth\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;
    
    //
}