djade007 / neoeloquent
Laravel 对 Neo4j 图形数据库 REST 接口的包装
Requires
- php: >=5.4.0
- heydavid713/neo4jphp: 0.1.*
- illuminate/database: 5.3.*
- illuminate/pagination: 5.3.*
- illuminate/support: 5.3.*
- nesbot/carbon: ~1.0
Requires (Dev)
- mockery/mockery: 0.9.*
- phpunit/phpunit: 4.2.*
- 1.4.x-dev
- v1.4.2
- v1.4.1
- v1.4.0
- 1.3.x-dev
- v1.3.2
- 1.3.1
- v1.3.0
- 1.2.x-dev
- v1.2.12
- v1.2.11
- v1.2.10
- v1.2.9
- v1.2.8
- v1.2.7
- v1.2.6
- v1.2.5
- v1.2.4
- v1.2.3
- v1.2.2
- v1.2.1
- v1.2.0
- v1.1.1
- v1.1.0
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0.0
- v1.0.0-rc.3
- v1.0.0-rc.2
- v1.0.0-rc.1
- v0.4.0
- v0.3.0
- 0.2.0
- 0.1.1
- 0.1.0
- dev-1.5-dev
- dev-2.0.0-alpha-plus
- dev-2.0.0-alpha
- dev-master
This package is auto-updated.
Last update: 2024-09-08 00:34:46 UTC
README
NeoEloquent
Neo4j 图形 Eloquent 驱动程序 for Laravel
聊天 & 支持
加入 官方 Neo4j Slack Group 并使用 #neo4j-php 频道。
快速参考
安装
将包添加到您的 composer.json
并运行 composer update
。
Laravel 5
5.4
{ "require": { "djade007/neoeloquent": "1.4.x-dev" } }
5.3
{ "require": { "vinelab/neoeloquent": "1.4.*" } }
5.2
{ "require": { "vinelab/neoeloquent": "1.3.*" } }
5.1
{ "require": { "vinelab/neoeloquent": "1.2.*" } }
5.0
{ "require": { "vinelab/neoeloquent": "1.2.5" } }
Laravel 4
{ "require": { "vinelab/neoeloquent": "1.1.*" } }
在 app/config/app.php
中添加服务提供者
'Vinelab\NeoEloquent\NeoEloquentServiceProvider',
服务提供者将注册此包所需的所有类,并将 Model
类别别名为 NeoEloquent
,这样您就可以在模型中简单地 扩展 NeoEloquent
。
配置
连接
在 app/config/database.php
中或根据基于环境的配置 app/config/[env]/database.php
将 neo4j
设置为默认连接
'default' => 'neo4j',
添加连接默认值
'connections' => [ 'neo4j' => [ 'driver' => 'neo4j', 'host' => 'localhost', 'port' => '7474', 'username' => null, 'password' => null ] ]
Lumen
对于 Lumen,您需要在应用程序根目录中创建一个名为 config
的新文件夹,并在其中添加一个名为 database.php
的文件。在那里,您将添加以下代码。
<?php return ['connections' => [ 'neo4j' => [ 'driver' => 'neo4j', 'host' => 'localhost', 'port' => '7474', 'username' => null, 'password' => null ] ] ];
并在 bootstrap/app.php
中添加以下行
$app->configure('database');
这是为了使 Lumen 能够读取提供的默认配置以外的其他配置。
在添加服务提供者时。您必须在 bootstrap/app.php
的 Register Providers 部分中添加它。您可以像这样添加
$app->register('Vinelab\NeoEloquent\NeoEloquentServiceProvider');
迁移设置
如果您愿意有迁移
- 创建
app/database/labels
文件夹 - 修改
composer.json
并将app/database/labels
添加到classmap
数组中 - 运行
composer dump-autoload
文档
模型
class User extends NeoEloquent {}
正如其名,NeoEloquent 将从类名生成默认节点标签,在这种情况下将是 :User
。关于节点标签的更多信息,请参阅 这里
命名空间模型
当您使用模型命名空间时,标签将考虑完整的命名空间。
namespace Vinelab\Cms; class Admin extends NeoEloquent { }
从该关系生成的标签将是 VinelabCmsAdmin
,这是必要的,以确保在引入另一个类似 Vinelab\Blog\Admin
的 Admin
实例时标签不会冲突,从而使数据库中的 :Admin
变得混乱。
自定义节点标签
您可以指定您希望使用的标签(而不是默认生成的),它们也是大小写敏感的,因此将按此处存储的方式存储。
class User extends NeoEloquent { protected $label = 'User'; // or array('User', 'Fan') protected $fillable = ['name', 'email']; } $user = User::create(['name' => 'Some Name', 'email' => 'some@email.com']);
NeoEloquent 对 $table
变量的回退支持,如果找到且在模型上没有定义 $label
,则将使用它。
class User extends NeoEloquent { protected $table = 'User'; }
请不用担心标签格式,您可以指定它们为 array('Label1', 'Label2')
或通过冒号分隔它们,并在前面添加冒号是可选的。
软删除
Laravel 5
要启用软删除,您需要使用 use Vinelab\NeoEloquent\Eloquent\SoftDeletes
而不是 Illuminate\Database\Eloquent\SoftDeletes
,并且就像 Eloquent 一样,您需要在模型中添加 $dates
,如下所示
use Vinelab\NeoEloquent\Eloquent\SoftDeletes; class User extends NeoEloquent { use SoftDeletes; protected $dates = ['deleted_at']; }
Laravel 4
要启用软删除,您需要使用 use Vinelab\NeoEloquent\Eloquent\SoftDeletingTrait
而不是 Illuminate\Database\Eloquent\SoftDeletingTrait
,并且就像 Eloquent 一样,您需要在模型中添加 $dates
,如下所示
use Vinelab\NeoEloquent\Eloquent\SoftDeletingTrait; class User extends NeoEloquent { use SoftDeletingTrait; protected $dates = ['deleted_at']; }
关系
让我们通过一些节点之间关系示例来了解一下。
一对一
class User extends NeoEloquent { public function phone() { return $this->hasOne('Phone'); }
这表示从 :User
节点到 :Phone
的 OUTGOING
关联方向。
保存
$phone = new Phone(['code' => 961, 'number' => '98765432']) $relation = $user->phone()->save($phone);
此语句执行的 Cypher 语句如下
MATCH (user:`User`)
WHERE id(user) = 1
CREATE (user)-[:PHONE]->(phone:`Phone` {code: 961, number: '98765432', created_at: 7543788, updated_at: 7543788})
RETURN phone;
定义此关系的逆关系
class Phone extends NeoEloquent { public function user() { return $this->belongsTo('User'); } }
这表示从 :User
节点到该 :Phone
节点的 INCOMING
关联方向。
关联模型
由于我们不处理 外键,在我们的例子中,它不仅仅是设置父模型的属性。在 Neo4j(以及图数据库)中,关系本身就是一个实体,也可以有自己的属性,因此引入了 边
注意: 关联模型在调用
associate()
时不会自动持久化关系。
$account = Account::find(1986); // $relation will be Vinelab\NeoEloquent\Eloquent\Edges\EdgeIn $relation = $user->account()->associate($account); // Save the relation $relation->save();
此语句执行的 Cypher 语句如下
MATCH (account:`Account`), (user:`User`)
WHERE id(account) = 1986 AND id(user) = 9862
MERGE (account)<-[rel_user_account:ACCOUNT]-(user)
RETURN rel_user_account;
一对多
class User extends NeoEloquent { public function posts() { return $this->hasMany('Post', 'POSTED'); } }
这表示从 :User
节点到 :Post
节点的 OUTGOING
关联方向。
$user = User::find(1); $post = new Post(['title' => 'The Title', 'body' => 'Hot Body']); $user->posts()->save($post);
类似于 一对一
关系,save()
语句返回的值是 Edge[In|Out]
此语句执行的 Cypher 语句如下
MATCH (user:`User`)
WHERE id(user) = 1
CREATE (user)-[rel_user_post:POSTED]->(post:`Post` {title: 'The Title', body: 'Hot Body', created_at: '15-05-2014', updated_at: '15-05-2014'})
RETURN rel_user_post;
定义此关系的逆关系
class Post extends NeoEloquent { public function author() { return $this->belongsTo('User', 'POSTED'); } }
这表示从 :User
节点到该 :Post
节点的 INCOMING
关联方向。
多对多
class User extends NeoEloquent { public function followers() { return $this->belongsToMany('User', 'FOLLOWS'); } }
这表示一个 :User
节点与另一个 :User
节点之间的 INCOMING
关联。
$jd = User::find(1012); $mc = User::find(1013);
$jd
关注 $mc
$jd->followers()->save($mc);
或使用 attach()
方法
$jd->followers()->attach($mc); // Or.. $jd->followers()->attach(1013); // 1013 being the id of $mc ($mc->getKey())
此语句执行的 Cypher 语句如下
MATCH (user:`User`), (followers:`User`)
WHERE id(user) = 1012 AND id(followers) = 1013
CREATE (followers)-[:FOLLOWS]->(user)
RETURN rel_follows;
$mc
也关注 $jd
$mc->followers()->save($jd);
此语句执行的 Cypher 语句如下
MATCH (user:`User`), (followers:`User`)
WHERE id(user) = 1013 AND id(followers) = 1012
CREATE (user)-[rel_user_followers:FOLLOWS]->(followers)
RETURN rel_follows;
获取 $jd
的关注者
$followers = $jd->followers;
此语句执行的 Cypher 语句如下
MATCH (user:`User`), (followers:`User`), (user)-[rel_user_followers:FOLLOWS]-(followers)
WHERE id(user) = 1012
RETURN rel_follows;
动态属性
class Phone extends NeoEloquent { public function user() { return $this->belongsTo('User'); } } $phone = Phone::find(1006); $user = $phone->user; // or getting an attribute out of the related model $name = $phone->user->name;
多态
多态关系的概念与骨骼纯粹相关,但当涉及到图时,我们将其表示为 超边。
超边涉及三个模型,即 父 模型、超 模型和 相关 模型,如下图所示
同样,在代码中,这将通过以下三个模型表示:User
、Comment
和 Post
,其中 id 为 1 的 User
发布了一条 Post
,而 id 为 6 的 User
在那条 Post
上 COMMENTED
一条 Comment
如下
class User extends NeoEloquent { public function comments($morph = null) { return $this->hyperMorph($morph, 'Comment', 'COMMENTED', 'ON'); } }
为了保持简单但仍然涉及三个模型,我们必须传递 $morph
,它可以是任何 commentable
模型,在我们的例子中,它可以是 Video
或 Post
模型。
注意: 确保它默认为
null
,这样我们就可以稍后使用$user->comments
动态或预加载。
使用 create()
方法创建一个 Comment
。
$user = User::find(6); $post = Post::find(2); $user->comments($post)->create(['text' => 'Totally agree!', 'likes' => 0, 'abuse' => 0]);
与往常一样,我们将返回一个边,但这次它不是有向的,而是一个 HyperEdge
实例,更多信息请参阅 HyperEdges。
或者你可以保存一个 Comment 实例
$comment = new Comment(['text' => 'Magnificent', 'likes' => 0, 'abuse' => 0]); $user->comments($post)->save($comment);
同时,也支持在 BelongsToMany
关系中找到的所有功能,例如通过 Ids 添加模型
$user->comments($post)->attach([$id, $otherId]);
或者分离模型
$user->comments($post)->detach($comment); // or $comment->id
同步
$user->comments($post)->sync([$id, $otherId, $someId]);
检索多态关系
从我们之前的例子中,我们将使用 Video
模型来检索它们的评论
class Video extends NeoEloquent { public function comments() { return $this->morphMany('Comment', 'ON'); } }
动态加载多态模型
$video = Video::find(3); $comments = $video->comments;
预加载多态模型
$video = Video::with('comments')->find(3); foreach ($video->comments as $comment) { // }
检索多态关系的逆关系
class Comment extends NeoEloquent { public function commentable() { return $this->morphTo(); } }
$postComment = Comment::find(7); $post = $comment->commentable; $videoComment = Comment::find(5); $video = $comment->commentable; // You can also eager load them Comment::with('commentable')->get();
您也可以指定您希望返回的 morph 类型
class Comment extends NeoEloquent { public function post() { return $this->morphTo('Post', 'ON'); } public function video() { return $this->morphTo('Video', 'ON'); } }
多态关系概述
为了深入了解,以下是涉及多态关系的三个模型如何连接
class User extends NeoEloquent { public function comments($morph = null) { return $this->hyperMorph($morph, 'Comment', 'COMMENTED', 'ON'); } }
class Post extends NeoEloquent { // Video is the same as this one public function comments() { return $this->morphMany('Comment', 'ON'); } }
class Comment extends NeoEloquent { public function commentable() { return $this->morphTo(); } }
预加载
class Book extends NeoEloquent { public function author() { return $this->belongsTo('Author'); } }
以尽可能少的性能开销加载作者及其书籍。
foreach (Book::with('author')->get() as $book) { echo $book->author->name; }
循环中仅运行两个 Cypher 查询
MATCH (book:`Book`) RETURN *;
MATCH (book:`Book`), (book)<-[:WROTE]-(author:`Author`) WHERE id(book) IN [1, 2, 3, 4, 5, ...] RETURN book, author;
边
介绍
由于图数据库中的关系与其他数据库类型有很大不同,因此我们必须相应地处理它们。关系有方向,可以是 In 或 Out,分别指向父节点。
EdgeIn
表示从相关模型到父模型的 INCOMING
方向关系。
class Location extends NeoEloquent { public function user() { return $this->belongsTo('User', 'LOCATED_AT'); } }
将一个 用户
与一个 位置
关联
$location = Location::find(1922); $user = User::find(3876); $relation = $location->associate($user);
在Cypher中,这会映射为 (:Location)<-[:LOCATED_AT]-(:User)
,其中 $relation
是一个表示指向父节点的进入关系的 EdgeIn
实例。
您仍然可以访问边上的模型
$relation = $location->associate($user); $location = $relation->parent(); $user = $relation->related();
EdgeOut
表示从父模型到相关模型的 OUTGOING
方向关系。
class User extends NeoEloquent { public function posts() { return $this->hasMany('Post', 'POSTED'); } }
要保存从 :User
到 :Post
的出边,它看起来是这样的
$post = new Post(['...']); $posted = $user->posts()->save($post);
在Cypher中将是 (:User)-[:POSTED]->(:Post)
,其中 $posted
是 EdgeOut
实例。
并获取相关模型
$edge = $user->posts()->save($post); $user = $edge->parent(); $post = $edge->related();
HyperEdge
此边是作为一个 多态关系 出现的结果,表示涉及两个其他边(左 和 右)的边,可以通过 left()
和 right()
方法访问。
由于这不是两个模型之间的直接关系,所以与其他边略有不同,这意味着它没有特定的方向。
$edge = $user->comments($post)->attach($comment); // Access the left and right edges $left = $edge->left(); $user = $left->parent(); $comment = $left->related(); $right = $edge->right(); $comment = $right->parent(); $post = $right->related();
处理边
如前所述,与SQL中的外键不同,边是图中的实体,在文档中它们要么是嵌入的内容,要么是id作为引用。因此,我们开发了它们作为 轻模型,这意味着您可以像处理 Eloquent
实例一样处理它们——在某种程度上,除了 超边 之外。
// Create a new relationship $relation = $location->associate($user); // Vinelab\NeoEloquent\Eloquent\Edges\EdgeIn // Save the relationship to the database $relation->save(); // true
在 HyperEdge
的情况下,您可以如下访问所有三个模型
$edge = $user->comments($post)->save($comment); $user = $edge->parent(); $comment = $edge->hyper(); $post = $edge->related();
边属性
默认情况下,边将具有 created_at
和 updated_at
时间戳,并且仅当在父模型上设置 $timestamps
为 true
时才会自动设置和更新。
$located_at = $location->associate($user); $located_at->since = 1966; $located_at->present = true; $located_at->save(); // $created_at and $updated_at are Carbon\Carbon instances $created_at = $located_at->created_at; $updated_at = $located_at->updated_at;
从关系检索边
与创建关联会创建一个 EdgeIn
关系一样,我们可以通过在 belongsTo
关系上调用 edge($model)
方法来检索两个模型之间的边。
$location = Location::find(1892); $edge = $location->user()->edge();
您也可以指定边的另一边的模型。
注意:默认情况下,NeoEloquent 将尝试内部执行
$location->user
,以根据关系函数名确定边的相关侧,在这种情况下是user()
。
$location = Location::find(1892); $edge = $location->user()->edge($location->user);
仅在 Neo 中
在这里,您可以找到NeoEloquent特有的方法和实现,这些方法和Eloquent方法相结合,使处理图和Neo4j变得非常愉快!
创建With
此方法将在关系数据库和文档数据库之间“填补”差距,它允许在一次数据库调用中创建多个相关模型。
创建新记录和关系
以下是一个创建带有附加照片和视频的帖子的示例
class Post extends NeoEloquent { public function photos() { return $this->hasMany('Photo', 'PHOTO'); } public function videos() { return $this->hasMany('Video', 'VIDEO'); } }
Post::createWith(['title' => 'the title', 'body' => 'the body'], [ 'photos' => [ [ 'url' => 'http://url', 'caption' => '...', 'metadata' => '...' ], [ 'url' => 'http://other.url', 'caption' => 'the bay', 'metadata' => '...' ] ], 'videos' => [ 'title' => 'Boats passing us by', 'description' => '...' ] ]);
键
photos
和videos
必须与Post
模型中的关系方法名称相同。
上述示例执行了以下Cypher查询
CREATE (post:`Post` {title: 'the title', body: 'the body'}),
(post)-[:PHOTO]->(:`Photo` {url: 'http://url', caption: '...', metadata: '...'}),
(post)-[:PHOTO]->(:`Photo` {url: 'http://other', caption: 'the bay', metadata: '...'}),
(post)-[:VIDEO]->(:`Video` {title: 'Boats passing us by', description: '...'});
我们将以以下方式获取创建的节点及其关系
您还可以将模型和属性作为关系值混合,但这是不必要的,因为NeoEloquent将通过 $fillable
过滤器管道传递提供的属性。
$videos = new Video(['title' => 'foo', 'description' => 'bar']); Post::createWith($info, compact('videos'));
您还可以使用单个属性数组
class User extends NeoEloquent { public function account() { return $this->hasOne('Account'); } } User::createWith(['name' => 'foo'], ['account' => ['guid' => 'bar', 'email' => 'some@mail.net']]);
将现有记录作为关系附加
createWith
足够智能,可以区分您传递的是现有模型、模型ID或需要创建的新记录,这使得您可以混合新记录和现有记录。
class Post extends NeoEloquent { public function tags() { return $this->hasMany('Tag', 'TAG'); } }
$tag1 = Tag::create(['title' => 'php']); $tag2 = Tag::create(['title' => 'dev']); $post = Post::createWith(['title' => 'foo', 'body' => 'bar'], ['tags' => [$tag1, $tag2]]);
然后我们将得到与现有 Tag
节点相关的 Post
。
或者使用模型的 id
。
Post::createWith(['title' => 'foo', 'body' => 'bar'], ['tags' => 1, 'privacy' => 2]);
用于附加记录的查询的Cypher语句将是
CREATE (post:`Post` {title: 'foo', 'body' => 'bar'})
WITH post
MATCH (tag:`Tag`)
WHERE id(tag) IN [1, 2]
CREATE (post)-[:TAG]->(tag);
迁移
为了让迁移正常工作,请执行以下操作
- 创建
app/database/labels
文件夹 - 修改
composer.json
并将app/database/labels
添加到classmap
数组中
由于Neo4j是一个无模式的数据库,因此您不需要为标签预先定义属性类型。但是,您将能够使用NeoEloquent的简单索引和约束。
命令
NeoEloquent在neo4j
命名空间下引入了新的命令,因此您仍然可以同时使用Eloquent的迁移命令。
迁移命令与Eloquent相同,格式为neo4j:migrate[:command]
neo4j:make:migration Create a new migration file
neo4j:migrate Run the database migrations
neo4j:migrate:reset Rollback all database migrations
neo4j:migrate:refresh Reset and re-run all migrations
neo4j:migrate:rollback Rollback the last database migration
创建迁移
像Laravel一样,您可以使用Artisan的make
命令创建一个新的迁移。
php artisan neo4j:migrate:make create_user_label
标签迁移将被放置在app/database/labels
中
您可以在命令中添加额外的选项,例如
php artisan neo4j:migrate:make foo --path=app/labels
php artisan neo4j:migrate:make create_user_label --create=User
php artisan neo4j:migrate:make create_user_label --label=User
运行迁移
运行所有挂起的迁移
php artisan neo4j:migrate
运行路径上的所有挂起迁移
php artisan neo4j:migrate --path=app/foo/labels
运行包上的所有挂起迁移
php artisan neo4j:migrate --package=vendor/package
注意:如果在运行迁移时收到“类未找到”错误,请尝试运行
composer dump-autoload
命令。
在生产环境中强制运行迁移
要在生产数据库上强制运行迁移,可以使用
php artisan neo4j:migrate --force
回滚迁移
回滚最后一个迁移操作
php artisan neo4j:migrate:rollback
回滚所有迁移
php artisan neo4j:migrate:reset
回滚所有迁移并重新运行它们
php artisan neo4j:migrate:refresh
php artisan neo4j:migrate:refresh --seed
模式
NeoEloquent会自动为您将Neo4jSchema
外观代理别名,以便在操作标签时使用。
Neo4jSchema::label('User', function(Blueprint $label) { $label->unique('uuid'); });
如果您决定手动编写迁移类(而不是使用生成器),请确保有这些use
语句
use Vinelab\NeoEloquent\Schema\Blueprint;
use Vinelab\NeoEloquent\Migrations\Migration;
目前,Neo4j支持属性上的UNIQUE
约束和INDEX
。您可以在此处了解更多信息。
http://docs.neo4j.org/chunked/stable/graphdb-neo4j-schema.html
模式方法
删除标签
Neo4jSchema::drop('User'); Neo4jSchema::dropIfExists('User');
重命名标签
Neo4jSchema::renameLabel($from, $to);
检查标签的存在性
if (Neo4jSchema::hasLabel('User')) { } else { }
检查关系的存在性
if (Neo4jSchema::hasRelation('FRIEND_OF')) { } else { }
https://laravel.net.cn/docs/schema
https://laravel.net.cn/docs/migrations
聚合
除了Eloquent构建器聚合之外,NeoEloquent还支持Neo4j特定的聚合,如percentile和standard deviation,为了方便,保留了相同的函数名称。有关更多信息,请参阅文档。
table()
表示模型的标签
$users = DB::table('User')->count();
$distinct = DB::table('User')->countDistinct('points');
$price = DB::table('Order')->max('price');
$price = DB::table('Order')->min('price');
$price = DB::table('Order')->avg('price');
$total = DB::table('User')->sum('votes');
$disc = DB::table('User')->percentileDisc('votes', 0.2);
$cont = DB::table('User')->percentileCont('votes', 0.8);
$deviation = DB::table('User')->stdev('sex');
$population = DB::table('User')->stdevp('sex');
$emails = DB::table('User')->collect('email');
变更日志
请查看发行版以获取详细信息。
避免
以下是一些约束和图特定的注意事项,这些是既不受支持也不推荐的功能列表。
连接 😖
- 它们对图没有意义,图也不喜欢它们!这使得它们故意不受支持。如果您从一个基于
SQL
的应用迁移,它们将是您的噩梦。
多对多关系中的交叉表
这不受支持,相反,我们将使用边来处理模型之间的关系。
嵌套数组和对象
- 由于单个对象映射类型存储的限制,您无法在单个模型中拥有嵌套的数组或对象,请确保它是扁平的。示例:
// Don't User::create(['name' => 'Some Name', 'location' => ['lat' => 123, 'lng'=> -123 ] ]);
请查看createWith()方法,了解如何在图中实现这一点。
测试
- 安装一个Neo4j实例并使用默认配置
localhost:7474
运行它 - 确保数据库图是空的,以避免冲突
- 在运行
composer install
之后,应该有/vendor/bin/phpunit
- 在确保Neo4j实例正在运行后,运行
./vendor/bin/phpunit
标记为不完整的测试意味着它们是已知问题或不受支持的功能,请查看包含的消息以获取更多信息。