lakedawson / vocal
2.0.0
2015-02-16 11:36 UTC
Requires
- php: >=5.4.0
- illuminate/database: >=4.0
- illuminate/hashing: >=4.0
- illuminate/support: >=4.0
Requires (Dev)
- orchestra/testbench: >=2.0
README
Laravel 4 和 5 中 Eloquent 的扩展功能。
Vocal 的某些部分基于 Max Ehsan 为 Laravel 4 编写的 Ardent。
版权(c)2014-2015 Scott Dawson。
文档
什么是 Vocal
Vocal 让处理嵌套关系变得更容易。如果你需要一次性向用户显示多个模型,例如用户资料和通讯录,并希望他们能够一次性更改他们的姓名并更新他们的地址,这将特别有帮助。
安装
首先,你需要在 composer.json 中添加 sjdaws/vocal 作为依赖项。
{ "require": { "sjdaws/vocal": "2.0.*" } }
使用 composer update 更新你的包,然后就可以开始使用了。
入门
Vocal 扩展了 Eloquent 基类,因此你的模型仍然完全兼容 Eloquent。Vocal 只是在将某些方法(如 validate 和 save)传递给 Eloquent 之前拦截它们。
要创建一个新的 Vocal 模型,只需让模型类继承 Vocal 基类即可。
use Sjdaws\Vocal\Vocal; class User extends Vocal {}
不需要添加任何 Facades 或 Service Providers。
使用
Vocal 提供了几个设置和方法
| 变量 | 访问修饰符 | 类型 |
|---|---|---|
$allowHydrationFromInput |
protected | boolean |
$hashable |
protected | array |
$languageFolder |
protected | string |
$languageKey |
protected | string |
$messages |
protected | array |
$rules |
public | array |
$validateBeforeSave |
protected | boolean |
| 方法 | 参数 |
|---|---|
| create | $data, $rules, $messages |
| forceCreate | $data |
| forceSave | $data |
| forceSaveAndDelete | $data |
| forceSaveRecursive | $data |
| getErrors | $filter |
| getErrorBag | |
| hydrateModel | $data |
| save | $data, $rules, $messages |
| saveAndDelete | $data, $rules, $messages |
| saveRecursive | $data, $rules, $messages |
| timestamp | $value |
| validate | $data, $rules, $messages |
| validateRecursive | $data, $rules, $messages |