chkm8 / laravel-rethinkdb
Laravel 的 RethinkDB 驱动器
Requires
- php: >=7.0.0
- danielmewes/php-rql: ~2.3.0
- illuminate/container: >=5.0.0
- illuminate/contracts: >=5.0.0
- illuminate/database: >=5.0.0
- illuminate/support: >=5.0.0
Requires (Dev)
- codeclimate/php-test-reporter: 0.1.*@dev
- mockery/mockery: 0.9.*@dev
- orchestra/testbench: 3.7.*
- phpunit/phpunit: ~4.0
- psr/log: 1.0.0
This package is auto-updated.
Last update: 2024-09-07 14:17:08 UTC
README
Laravel 的 RethinkDB 驱动器(支持 Eloquent)
感谢 @jenssegers 的伟大 laravel-mongodb 项目。我使用了他的测试和一些其他代码,因为这是一个支持其他 NoSQL 数据库的出色代码库。我希望他不会为此生气;)
安装
需求。
-
RethinkDB:您需要确保已成功安装 RethinkDB,您可以通过查看 RethinkDB 的 文档 来获取如何安装 RethinkDB 的完整说明。
-
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; // }