class Pivot extends Model (View source)
HasAttributes |
HasEvents |
HasGlobalScopes |
HasRelationships |
HasTimestamps |
HidesAttributes |
GuardsAttributes |
CREATED_AT | The name of the "created at" column. |
UPDATED_AT | The name of the "updated at" column. |
static bool | $snakeAttributes | Indicates whether attributes are snake cased on arrays. | from HasAttributes |
static array | $manyMethods | The many to many relationship methods. | from HasRelationships |
bool | $timestamps | Indicates if the model should be timestamped. | from HasTimestamps |
bool | $incrementing | Indicates if the IDs are auto-incrementing. | from Model |
bool | $exists | Indicates if the model exists. | from Model |
bool | $wasRecentlyCreated | Indicates if the model was inserted during the current request lifecycle. | from Model |
Model | $parent | The parent model of the relationship. |
array | attributesToArray() Convert the model's attributes to an array. | from HasAttributes |
array | relationsToArray() Get the model's relationships in array form. | from HasAttributes |
mixed | getAttribute(string $key) Get an attribute from the model. | from HasAttributes |
mixed | getAttributeValue(string $key) Get a plain attribute (not a relationship). | from HasAttributes |
mixed | getRelationValue(string $key) Get a relationship. | from HasAttributes |
bool | hasGetMutator(string $key) Determine if a get mutator exists for an attribute. | from HasAttributes |
$this | setAttribute(string $key, mixed $value) Set a given attribute on the model. | from HasAttributes |
bool | hasSetMutator(string $key) Determine if a set mutator exists for an attribute. | from HasAttributes |
$this | fillJsonAttribute(string $key, mixed $value) Set a given JSON attribute on the model. | from HasAttributes |
mixed | fromJson(string $value, bool $asObject = false) Decode the given JSON back into an array or object. | from HasAttributes |
string | fromDateTime(DateTime|int $value) Convert a DateTime to a storable string. | from HasAttributes |
array | getDates() Get the attributes that should be converted to dates. | from HasAttributes |
$this | setDateFormat(string $format) Set the date format used by the model. | from HasAttributes |
bool | hasCast(string $key, array|string|null $types = null) Determine whether an attribute should be cast to a native type. | from HasAttributes |
array | getCasts() Get the casts array. | from HasAttributes |
array | getAttributes() Get all of the current attributes on the model. | from HasAttributes |
$this | setRawAttributes(array $attributes, bool $sync = false) Set the array of model attributes. No checking is done. | from HasAttributes |
mixed|array | getOriginal(string|null $key = null, mixed $default = null) Get the model's original attribute values. | from HasAttributes |
$this | syncOriginal() Sync the original attributes with the current. | from HasAttributes |
$this | syncOriginalAttribute(string $attribute) Sync a single original attribute with its current value. | from HasAttributes |
bool | isDirty(array|string|null $attributes = null) Determine if the model or given attribute(s) have been modified. | from HasAttributes |
bool | isClean(array|string|null $attributes = null) Determine if the model or given attribute(s) have remained the same. | from HasAttributes |
array | getDirty() Get the attributes that have been changed since last sync. | from HasAttributes |
$this | append(array|string $attributes) Append attributes to query when building a query. | from HasAttributes |
$this | setAppends(array $appends) Set the accessors to append to model arrays. | from HasAttributes |
array | getMutatedAttributes() Get the mutated attributes for a given instance. | from HasAttributes |
static void | cacheMutatedAttributes(string $class) Extract and cache all the mutated attributes of a class. | from HasAttributes |
static void | observe(object|string $class) Register an observer with the Model. | from HasEvents |
array | getObservableEvents() Get the observable event names. | from HasEvents |
$this | setObservableEvents(array $observables) Set the observable event names. | from HasEvents |
void | addObservableEvents(array|mixed $observables) Add an observable event name. | from HasEvents |
void | removeObservableEvents(array|mixed $observables) Remove an observable event name. | from HasEvents |
static void | saving(Closure|string $callback) Register a saving model event with the dispatcher. | from HasEvents |
static void | saved(Closure|string $callback) Register a saved model event with the dispatcher. | from HasEvents |
static void | updating(Closure|string $callback) Register an updating model event with the dispatcher. | from HasEvents |
static void | updated(Closure|string $callback) Register an updated model event with the dispatcher. | from HasEvents |
static void | creating(Closure|string $callback) Register a creating model event with the dispatcher. | from HasEvents |
static void | created(Closure|string $callback) Register a created model event with the dispatcher. | from HasEvents |
static void | deleting(Closure|string $callback) Register a deleting model event with the dispatcher. | from HasEvents |
static void | deleted(Closure|string $callback) Register a deleted model event with the dispatcher. | from HasEvents |
static void | flushEventListeners() Remove all of the event listeners for the model. | from HasEvents |
static Dispatcher | getEventDispatcher() Get the event dispatcher instance. | from HasEvents |
static void | setEventDispatcher(Dispatcher $dispatcher) Set the event dispatcher instance. | from HasEvents |
static void | unsetEventDispatcher() Unset the event dispatcher for models. | from HasEvents |
static mixed | addGlobalScope(Scope|Closure|string $scope, Closure $implementation = null) Register a new global scope on the model. | from HasGlobalScopes |
static bool | hasGlobalScope(Scope|string $scope) Determine if a model has a global scope. | from HasGlobalScopes |
static Scope|Closure|null | getGlobalScope(Scope|string $scope) Get a global scope registered with the model. | from HasGlobalScopes |
array | getGlobalScopes() Get the global scopes for this class instance. | from HasGlobalScopes |
HasOne | hasOne(string $related, string $foreignKey = null, string $localKey = null) Define a one-to-one relationship. | from HasRelationships |
MorphOne | morphOne(string $related, string $name, string $type = null, string $id = null, string $localKey = null) Define a polymorphic one-to-one relationship. | from HasRelationships |
BelongsTo | belongsTo(string $related, string $foreignKey = null, string $ownerKey = null, string $relation = null) Define an inverse one-to-one or many relationship. | from HasRelationships |
MorphTo | morphTo(string $name = null, string $type = null, string $id = null) Define a polymorphic, inverse one-to-one or many relationship. | from HasRelationships |
static string | getActualClassNameForMorph(string $class) Retrieve the actual class name for a given morph class. | from HasRelationships |
HasMany | hasMany(string $related, string $foreignKey = null, string $localKey = null) Define a one-to-many relationship. | from HasRelationships |
HasManyThrough | hasManyThrough(string $related, string $through, string|null $firstKey = null, string|null $secondKey = null, string|null $localKey = null) Define a has-many-through relationship. | from HasRelationships |
MorphMany | morphMany(string $related, string $name, string $type = null, string $id = null, string $localKey = null) Define a polymorphic one-to-many relationship. | from HasRelationships |
BelongsToMany | belongsToMany(string $related, string $table = null, string $foreignKey = null, string $relatedKey = null, string $relation = null) Define a many-to-many relationship. | from HasRelationships |
MorphToMany | morphToMany(string $related, string $name, string $table = null, string $foreignKey = null, string $relatedKey = null, bool $inverse = false) Define a polymorphic many-to-many relationship. | from HasRelationships |
MorphToMany | morphedByMany(string $related, string $name, string $table = null, string $foreignKey = null, string $relatedKey = null) Define a polymorphic, inverse many-to-many relationship. | from HasRelationships |
string | joiningTable(string $related) Get the joining table name for a many-to-many relation. | from HasRelationships |
bool | touches(string $relation) Determine if the model touches a given relation. | from HasRelationships |
void | touchOwners() Touch the owning relations of the model. | from HasRelationships |
string | getMorphClass() Get the class name for polymorphic relations. | from HasRelationships |
array | getRelations() Get all the loaded relations for the instance. | from HasRelationships |
mixed | getRelation(string $relation) Get a specified relationship. | from HasRelationships |
bool | relationLoaded(string $key) Determine if the given relation is loaded. | from HasRelationships |
$this | setRelation(string $relation, mixed $value) Set the specific relationship in the model. | from HasRelationships |
$this | setRelations(array $relations) Set the entire relations array on the model. | from HasRelationships |
array | getTouchedRelations() Get the relationships that are touched on save. | from HasRelationships |
$this | setTouchedRelations(array $touches) Set the relationships that are touched on save. | from HasRelationships |
bool | touch() Update the model's update timestamp. | from HasTimestamps |
$this | setCreatedAt(mixed $value) Set the value of the "created at" attribute. | from HasTimestamps |
$this | setUpdatedAt(mixed $value) Set the value of the "updated at" attribute. | from HasTimestamps |
Carbon | freshTimestamp() Get a fresh timestamp for the model. | from HasTimestamps |
string | freshTimestampString() Get a fresh timestamp for the model. | from HasTimestamps |
bool | usesTimestamps() Determine if the model uses timestamps. | from HasTimestamps |
string | getCreatedAtColumn() Get the name of the "created at" column. | |
string | getUpdatedAtColumn() Get the name of the "updated at" column. | |
array | getHidden() Get the hidden attributes for the model. | from HidesAttributes |
$this | setHidden(array $hidden) Set the hidden attributes for the model. | from HidesAttributes |
void | addHidden(array|string|null $attributes = null) Add hidden attributes for the model. | from HidesAttributes |
array | getVisible() Get the visible attributes for the model. | from HidesAttributes |
$this | setVisible(array $visible) Set the visible attributes for the model. | from HidesAttributes |
void | addVisible(array|string|null $attributes = null) Add visible attributes for the model. | from HidesAttributes |
$this | makeVisible(array|string $attributes) Make the given, typically hidden, attributes visible. | from HidesAttributes |
$this | makeHidden(array|string $attributes) Make the given, typically visible, attributes hidden. | from HidesAttributes |
array | getFillable() Get the fillable attributes for the model. | from GuardsAttributes |
$this | fillable(array $fillable) Set the fillable attributes for the model. | from GuardsAttributes |
array | getGuarded() Get the guarded attributes for the model. | from GuardsAttributes |
$this | guard(array $guarded) Set the guarded attributes for the model. | from GuardsAttributes |
static void | unguard(bool $state = true) Disable all mass assignable restrictions. | from GuardsAttributes |
static void | reguard() Enable the mass assignment restrictions. | from GuardsAttributes |
static bool | isUnguarded() Determine if current state is "unguarded". | from GuardsAttributes |
static mixed | unguarded(callable $callback) Run the given callable while being unguarded. | from GuardsAttributes |
bool | isFillable(string $key) Determine if the given attribute may be mass assigned. | from GuardsAttributes |
bool | isGuarded(string $key) Determine if the given key is guarded. | from GuardsAttributes |
bool | totallyGuarded() Determine if the model is totally guarded. | from GuardsAttributes |
void | __construct(Model $parent, array $attributes, string $table, bool $exists = false) Create a new pivot model instance. | |
static void | clearBootedModels() Clear the list of booted models so they will be re-booted. | from Model |
$this | fill(array $attributes) Fill the model with an array of attributes. | from Model |
$this | forceFill(array $attributes) Fill the model with an array of attributes. Force mass assignment. | from Model |
Model | newInstance(array $attributes = array(), bool $exists = false) Create a new instance of the given model. | from Model |
Model | newFromBuilder(array $attributes = array(), string|null $connection = null) Create a new model instance that is existing. | from Model |
static Builder | on(string|null $connection = null) Begin querying the model on a given connection. | from Model |
static Builder | onWriteConnection() Begin querying the model on the write connection. | from Model |
static Collection|Model[] | all(array|mixed $columns = array('*')) Get all of the models from the database. | from Model |
static Builder|Model | with(array|string $relations) Begin querying a model with eager loading. | from Model |
$this | load(array|string $relations) Eager load relations on the model. | from Model |
bool | update(array $attributes = array(), array $options = array()) Update the model in the database. | from Model |
bool | push() Save the model and all of its relationships. | from Model |
bool | save(array $options = array()) Save the model to the database. | from Model |
bool | saveOrFail(array $options = array()) Save the model to the database using transaction. | from Model |
static int | destroy(array|int $ids) Destroy the models for the given IDs. | from Model |
bool|null | delete() Delete the pivot model record from the database. | |
bool|null | forceDelete() Force a hard delete on a soft deleted model. | from Model |
static Builder | query() Begin querying the model. | from Model |
Builder | newQuery() Get a new query builder for the model's table. | from Model |
Builder|Model | newQueryWithoutScopes() Get a new query builder that doesn't have any global scopes. | from Model |
Builder | newQueryWithoutScope(Scope|string $scope) Get a new query instance without a given scope. | from Model |
Builder|Model | newEloquentBuilder(Builder $query) Create a new Eloquent query builder for the model. | from Model |
Collection | newCollection(array $models = array()) Create a new Eloquent Collection instance. | from Model |
Pivot | newPivot(Model $parent, array $attributes, string $table, bool $exists, string|null $using = null) Create a new pivot model instance. | from Model |
array | toArray() Convert the model instance to an array. | from Model |
string | toJson(int $options) Convert the model instance to JSON. | from Model |
array | jsonSerialize() Convert the object into something JSON serializable. | from Model |
Model|null | fresh(array|string $with = array()) Reload a fresh model instance from the database. | from Model |
Model | replicate(array $except = null) Clone the model into a new, non-existing instance. | from Model |
bool | is(Model $model) Determine if two models have the same ID and belong to the same table. | from Model |
Connection | getConnection() Get the database connection for the model. | from Model |
string | getConnectionName() Get the current connection name for the model. | from Model |
$this | setConnection(string $name) Set the connection associated with the model. | from Model |
static Connection | resolveConnection(string|null $connection = null) Resolve a connection instance. | from Model |
static ConnectionResolverInterface | getConnectionResolver() Get the connection resolver instance. | from Model |
static void | setConnectionResolver(ConnectionResolverInterface $resolver) Set the connection resolver instance. | from Model |
static void | unsetConnectionResolver() Unset the connection resolver for models. | from Model |
string | getTable() Get the table associated with the model. | from Model |
$this | setTable(string $table) Set the table associated with the model. | from Model |
string | getKeyName() Get the primary key for the model. | from Model |
$this | setKeyName(string $key) Set the primary key for the model. | from Model |
string | getQualifiedKeyName() Get the table qualified key name. | from Model |
string | getKeyType() Get the auto incrementing key type. | from Model |
bool | getIncrementing() Get the value indicating whether the IDs are incrementing. | from Model |
$this | setIncrementing(bool $value) Set whether IDs are incrementing. | from Model |
mixed | getKey() Get the value of the model's primary key. | from Model |
mixed | getQueueableId() Get the queueable identity for the entity. | from Model |
mixed | getRouteKey() Get the value of the model's route key. | from Model |
string | getRouteKeyName() Get the route key for the model. | from Model |
string | getForeignKey() Get the foreign key column name. | |
int | getPerPage() Get the number of models to return per page. | from Model |
$this | setPerPage(int $perPage) Set the number of models to return per page. | from Model |
mixed | __get(string $key) Dynamically retrieve attributes on the model. | from Model |
void | __set(string $key, mixed $value) Dynamically set attributes on the model. | from Model |
bool | offsetExists(mixed $offset) Determine if the given attribute exists. | from Model |
mixed | offsetGet(mixed $offset) Get the value for a given offset. | from Model |
void | offsetSet(mixed $offset, mixed $value) Set the value for a given offset. | from Model |
void | offsetUnset(mixed $offset) Unset the value for a given offset. | from Model |
bool | __isset(string $key) Determine if an attribute or relation exists on the model. | from Model |
void | __unset(string $key) Unset an attribute on the model. | from Model |
mixed | __call(string $method, array $parameters) Handle dynamic method calls into the model. | from Model |
static mixed | __callStatic(string $method, array $parameters) Handle dynamic static method calls into the method. | from Model |
string | __toString() Convert the model to its string representation. | from Model |
void | __wakeup() When a model is being unserialized, check if it needs to be booted. | from Model |
static Pivot | fromRawAttributes(Model $parent, array $attributes, string $table, bool $exists = false) Create a new pivot model from raw values returned from a query. | |
string | getRelatedKey() Get the "related key" column name. | |
string | getOtherKey() Get the "related key" column name. | |
$this | setPivotKeys(string $foreignKey, string $relatedKey) Set the key names for the pivot model instance. | |
bool | hasTimestampAttributes() Determine if the pivot model has timestamp attributes. |
Convert the model's attributes to an array.
Get the model's relationships in array form.
Get an attribute from the model.
Get a plain attribute (not a relationship).
Get a relationship.
Determine if a get mutator exists for an attribute.
Set a given attribute on the model.
Determine if a set mutator exists for an attribute.
Set a given JSON attribute on the model.
Decode the given JSON back into an array or object.
Convert a DateTime to a storable string.
Get the attributes that should be converted to dates.
Set the date format used by the model.
Determine whether an attribute should be cast to a native type.
Get the casts array.
Get all of the current attributes on the model.
Set the array of model attributes. No checking is done.
Get the model's original attribute values.
Sync the original attributes with the current.
Sync a single original attribute with its current value.
Determine if the model or given attribute(s) have been modified.
Determine if the model or given attribute(s) have remained the same.
Get the attributes that have been changed since last sync.
Append attributes to query when building a query.
Set the accessors to append to model arrays.
Get the mutated attributes for a given instance.
Extract and cache all the mutated attributes of a class.
Register an observer with the Model.
Get the observable event names.
Set the observable event names.
Add an observable event name.
Remove an observable event name.
Register a saving model event with the dispatcher.
Register a saved model event with the dispatcher.
Register an updating model event with the dispatcher.
Register an updated model event with the dispatcher.
Register a creating model event with the dispatcher.
Register a created model event with the dispatcher.
Register a deleting model event with the dispatcher.
Register a deleted model event with the dispatcher.
Remove all of the event listeners for the model.
Get the event dispatcher instance.
Set the event dispatcher instance.
Unset the event dispatcher for models.
Register a new global scope on the model.
Determine if a model has a global scope.
Get a global scope registered with the model.
Get the global scopes for this class instance.
Define a one-to-one relationship.
Define a polymorphic one-to-one relationship.
Define an inverse one-to-one or many relationship.
Define a polymorphic, inverse one-to-one or many relationship.
Retrieve the actual class name for a given morph class.
Define a one-to-many relationship.
Define a has-many-through relationship.
Define a polymorphic one-to-many relationship.
Define a many-to-many relationship.
Define a polymorphic many-to-many relationship.
Define a polymorphic, inverse many-to-many relationship.
Get the joining table name for a many-to-many relation.
Determine if the model touches a given relation.
Touch the owning relations of the model.
Get the class name for polymorphic relations.
Get all the loaded relations for the instance.
Get a specified relationship.
Determine if the given relation is loaded.
Set the specific relationship in the model.
Set the entire relations array on the model.
Get the relationships that are touched on save.
Set the relationships that are touched on save.
Update the model's update timestamp.
Set the value of the "created at" attribute.
Set the value of the "updated at" attribute.
Get a fresh timestamp for the model.
Get a fresh timestamp for the model.
Determine if the model uses timestamps.
Get the name of the "created at" column.
Get the name of the "updated at" column.
Get the hidden attributes for the model.
Set the hidden attributes for the model.
Add hidden attributes for the model.
Get the visible attributes for the model.
Set the visible attributes for the model.
Add visible attributes for the model.
Make the given, typically hidden, attributes visible.
Make the given, typically visible, attributes hidden.
Get the fillable attributes for the model.
Set the fillable attributes for the model.
Get the guarded attributes for the model.
Set the guarded attributes for the model.
Disable all mass assignable restrictions.
Enable the mass assignment restrictions.
Determine if current state is "unguarded".
Run the given callable while being unguarded.
Determine if the given attribute may be mass assigned.
Determine if the given key is guarded.
Determine if the model is totally guarded.
Create a new pivot model instance.
Clear the list of booted models so they will be re-booted.
Fill the model with an array of attributes.
Fill the model with an array of attributes. Force mass assignment.
Create a new instance of the given model.
Create a new model instance that is existing.
Begin querying the model on a given connection.
Begin querying the model on the write connection.
Get all of the models from the database.
Eager load relations on the model.
Update the model in the database.
Save the model and all of its relationships.
Save the model to the database.
Save the model to the database using transaction.
Destroy the models for the given IDs.
Delete the pivot model record from the database.
Force a hard delete on a soft deleted model.
This method protects developers from running forceDelete when trait is missing.
Begin querying the model.
Get a new query builder for the model's table.
Create a new Eloquent Collection instance.
Create a new pivot model instance.
Convert the model instance to an array.
Convert the model instance to JSON.
Convert the object into something JSON serializable.
Reload a fresh model instance from the database.
Clone the model into a new, non-existing instance.
Determine if two models have the same ID and belong to the same table.
Get the database connection for the model.
Get the current connection name for the model.
Set the connection associated with the model.
Resolve a connection instance.
Get the connection resolver instance.
Set the connection resolver instance.
Unset the connection resolver for models.
Get the table associated with the model.
Set the table associated with the model.
Get the primary key for the model.
Set the primary key for the model.
Get the table qualified key name.
Get the auto incrementing key type.
Get the value indicating whether the IDs are incrementing.
Set whether IDs are incrementing.
Get the value of the model's primary key.
Get the queueable identity for the entity.
Get the value of the model's route key.
Get the route key for the model.
Get the foreign key column name.
Get the number of models to return per page.
Set the number of models to return per page.
Dynamically retrieve attributes on the model.
Dynamically set attributes on the model.
Determine if the given attribute exists.
Get the value for a given offset.
Set the value for a given offset.
Unset the value for a given offset.
Determine if an attribute or relation exists on the model.
Unset an attribute on the model.
Handle dynamic method calls into the model.
Handle dynamic static method calls into the method.
Convert the model to its string representation.
When a model is being unserialized, check if it needs to be booted.
Create a new pivot model from raw values returned from a query.
Get the "related key" column name.
Get the "related key" column name.
Set the key names for the pivot model instance.
Determine if the pivot model has timestamp attributes.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/5.4/Illuminate/Database/Eloquent/Relations/Pivot.html