1. class
  2. Illuminate
  3. Database
  4. Eloquent
  5. Builder

Builder

class Builder (View source)

Methods

void
__construct( Builder $query)

Create a new Eloquent query builder instance.

$this
withGlobalScope( string $identifier, Scope|Closure $scope)

Register a new global scope.

$this
withoutGlobalScope( Scope|string $scope)

Remove a registered global scope.

$this
withoutGlobalScopes( array $scopes = null)

Remove all or passed registered global scopes.

Model|Collection|Builder[]|Builder|null
find( mixed $id, array $columns = array('*'))

Find a model by its primary key.

Collection
findMany( array $ids, array $columns = array('*'))

Find multiple models by their primary keys.

Model|Collection
findOrFail( mixed $id, array $columns = array('*'))

Find a model by its primary key or throw an exception.

Model
findOrNew( mixed $id, array $columns = array('*'))

Find a model by its primary key or return fresh model instance.

Model
firstOrNew( array $attributes)

Get the first record matching the attributes or instantiate it.

Model
firstOrCreate( array $attributes, array $values = array())

Get the first record matching the attributes or create it.

Model
updateOrCreate( array $attributes, array $values = array())

Create or update a record matching the attributes, and fill it with values.

Model|Builder|null
first( array $columns = array('*'))

Execute the query and get the first result.

Model|Builder
firstOrFail( array $columns = array('*'))

Execute the query and get the first result or throw an exception.

Collection|Builder[]
get( array $columns = array('*'))

Execute the query as a "select" statement.

mixed
value( string $column)

Get a single column's value from the first result of a query.

bool
chunk( int $count, callable $callback)

Chunk the results of the query.

bool
chunkById( int $count, callable $callback, string $column = 'id')

Chunk the results of a query by comparing numeric IDs.

bool
each( callable $callback, int $count = 1000)

Execute a callback over each item while chunking.

Collection
pluck( string $column, string|null $key = null)

Get an array with the values of a given column.

LengthAwarePaginator
paginate( int $perPage = null, array $columns = array('*'), string $pageName = 'page', int|null $page = null)

Paginate the given query.

Paginator
simplePaginate( int $perPage = null, array $columns = array('*'), string $pageName = 'page')

Paginate the given query into a simple paginator.

int
update( array $values)

Update a record in the database.

int
increment( string $column, int $amount = 1, array $extra = array())

Increment a column's value by a given amount.

int
decrement( string $column, int $amount = 1, array $extra = array())

Decrement a column's value by a given amount.

mixed
delete()

Delete a record from the database.

mixed
forceDelete()

Run the default delete function on the builder.

void
onDelete( Closure $callback)

Register a replacement for the default delete function.

Model[]
getModels( array $columns = array('*'))

Get the hydrated models without eager loading.

array
eagerLoadRelations( array $models)

Eager load the relationships for the models.

Relation
getRelation( string $name)

Get the relation instance for the given relation name.

$this
where( string $column, string $operator = null, mixed $value = null, string $boolean = 'and')

Add a basic where clause to the query.

Builder|Builder
orWhere( string $column, string $operator = null, mixed $value = null)

Add an "or where" clause to the query.

Builder|Builder
has( string $relation, string $operator = '>=', int $count = 1, string $boolean = 'and', Closure $callback = null)

Add a relationship count / exists condition to the query.

Builder|Builder
doesntHave( string $relation, string $boolean = 'and', Closure $callback = null)

Add a relationship count / exists condition to the query.

Builder|Builder
whereHas( string $relation, Closure $callback, string $operator = '>=', int $count = 1)

Add a relationship count / exists condition to the query with where clauses.

Builder|Builder
whereDoesntHave( string $relation, Closure $callback = null)

Add a relationship count / exists condition to the query with where clauses.

Builder|Builder
orHas( string $relation, string $operator = '>=', int $count = 1)

Add a relationship count / exists condition to the query with an "or".

Builder|Builder
orWhereHas( string $relation, Closure $callback, string $operator = '>=', int $count = 1)

Add a relationship count / exists condition to the query with where clauses and an "or".

$this
with( mixed $relations)

Set the relationships that should be eager loaded.

Builder|Builder
applyScopes()

Apply the scopes to the Eloquent builder instance and return it.

Builder|Builder
getQuery()

Get the underlying query builder instance.

Builder
toBase()

Get a base query builder instance.

$this
setQuery( Builder $query)

Set the underlying query builder instance.

array
getEagerLoads()

Get the relationships being eagerly loaded.

$this
setEagerLoads( array $eagerLoad)

Set the relationships being eagerly loaded.

Model
getModel()

Get the model instance being queried.

$this
setModel( Model $model)

Set a model instance for the model being queried.

void
macro( string $name, Closure $callback)

Extend the builder with a given callback.

Closure
getMacro( string $name)

Get the given macro by name.

mixed
__call( string $method, array $parameters)

Dynamically handle calls into the query instance.

void
__clone()

Force a clone of the underlying query builder when cloning.

Details

at line line 74
void __construct( Builder $query)

Create a new Eloquent query builder instance.

Parameters

Builder $query

Return Value

void

at line line 86
$this withGlobalScope( string $identifier, Scope|Closure $scope)

Register a new global scope.

Parameters

string $identifier
Scope|Closure $scope

Return Value

$this

at line line 103
$this withoutGlobalScope( Scope|string $scope)

Remove a registered global scope.

Parameters

Scope|string $scope

Return Value

$this

at line line 126
$this withoutGlobalScopes( array $scopes = null)

Remove all or passed registered global scopes.

Parameters

array $scopes

Return Value

$this

at line line 146
Model|Collection|Builder[]|Builder|null find( mixed $id, array $columns = array('*'))

Find a model by its primary key.

Parameters

mixed $id
array $columns

Return Value

Model|Collection|Builder[]|Builder|null

at line line 164
Collection findMany( array $ids, array $columns = array('*'))

Find multiple models by their primary keys.

Parameters

array $ids
array $columns

Return Value

Collection

at line line 184
Model|Collection findOrFail( mixed $id, array $columns = array('*'))

Find a model by its primary key or throw an exception.

Parameters

mixed $id
array $columns

Return Value

Model|Collection

Exceptions

ModelNotFoundException

at line line 206
Model findOrNew( mixed $id, array $columns = array('*'))

Find a model by its primary key or return fresh model instance.

Parameters

mixed $id
array $columns

Return Value

Model

at line line 221
Model firstOrNew( array $attributes)

Get the first record matching the attributes or instantiate it.

Parameters

array $attributes

Return Value

Model

at line line 237
Model firstOrCreate( array $attributes, array $values = array())

Get the first record matching the attributes or create it.

Parameters

array $attributes
array $values

Return Value

Model

at line line 257
Model updateOrCreate( array $attributes, array $values = array())

Create or update a record matching the attributes, and fill it with values.

Parameters

array $attributes
array $values

Return Value

Model

at line line 272
Model|Builder|null first( array $columns = array('*'))

Execute the query and get the first result.

Parameters

array $columns

Return Value

Model|Builder|null

at line line 285
Model|Builder firstOrFail( array $columns = array('*'))

Execute the query and get the first result or throw an exception.

Parameters

array $columns

Return Value

Model|Builder

Exceptions

ModelNotFoundException

at line line 300
Collection|Builder[] get( array $columns = array('*'))

Execute the query as a "select" statement.

Parameters

array $columns

Return Value

Collection|Builder[]

at line line 322
mixed value( string $column)

Get a single column's value from the first result of a query.

Parameters

string $column

Return Value

mixed

at line line 338
bool chunk( int $count, callable $callback)

Chunk the results of the query.

Parameters

int $count
callable $callback

Return Value

bool

at line line 366
bool chunkById( int $count, callable $callback, string $column = 'id')

Chunk the results of a query by comparing numeric IDs.

Parameters

int $count
callable $callback
string $column

Return Value

bool

at line line 392
bool each( callable $callback, int $count = 1000)

Execute a callback over each item while chunking.

Parameters

callable $callback
int $count

Return Value

bool

at line line 414
Collection pluck( string $column, string|null $key = null)

Get an array with the values of a given column.

Parameters

string $column
string|null $key

Return Value

Collection

at line line 441
LengthAwarePaginator paginate( int $perPage = null, array $columns = array('*'), string $pageName = 'page', int|null $page = null)

Paginate the given query.

Parameters

int $perPage
array $columns
string $pageName
int|null $page

Return Value

LengthAwarePaginator

Exceptions

InvalidArgumentException

at line line 466
Paginator simplePaginate( int $perPage = null, array $columns = array('*'), string $pageName = 'page')

Paginate the given query into a simple paginator.

Parameters

int $perPage
array $columns
string $pageName

Return Value

Paginator

at line line 486
int update( array $values)

Update a record in the database.

Parameters

array $values

Return Value

int

at line line 499
int increment( string $column, int $amount = 1, array $extra = array())

Increment a column's value by a given amount.

Parameters

string $column
int $amount
array $extra

Return Value

int

at line line 514
int decrement( string $column, int $amount = 1, array $extra = array())

Decrement a column's value by a given amount.

Parameters

string $column
int $amount
array $extra

Return Value

int

at line line 543
mixed delete()

Delete a record from the database.

Return Value

mixed

at line line 557
mixed forceDelete()

Run the default delete function on the builder.

Return Value

mixed

at line line 568
void onDelete( Closure $callback)

Register a replacement for the default delete function.

Parameters

Closure $callback

Return Value

void

at line line 579
Model[] getModels( array $columns = array('*'))

Get the hydrated models without eager loading.

Parameters

array $columns

Return Value

Model[]

at line line 594
array eagerLoadRelations( array $models)

Eager load the relationships for the models.

Parameters

array $models

Return Value

array

at line line 643
Relation getRelation( string $name)

Get the relation instance for the given relation name.

Parameters

string $name

Return Value

Relation

at line line 709
$this where( string $column, string $operator = null, mixed $value = null, string $boolean = 'and')

Add a basic where clause to the query.

Parameters

string $column
string $operator
mixed $value
string $boolean

Return Value

$this

at line line 732
Builder|Builder orWhere( string $column, string $operator = null, mixed $value = null)

Add an "or where" clause to the query.

Parameters

string $column
string $operator
mixed $value

Return Value

Builder|Builder

at line line 747
Builder|Builder has( string $relation, string $operator = '>=', int $count = 1, string $boolean = 'and', Closure $callback = null)

Add a relationship count / exists condition to the query.

Parameters

string $relation
string $operator
int $count
string $boolean
Closure $callback

Return Value

Builder|Builder

at line line 808
Builder|Builder doesntHave( string $relation, string $boolean = 'and', Closure $callback = null)

Add a relationship count / exists condition to the query.

Parameters

string $relation
string $boolean
Closure $callback

Return Value

Builder|Builder

at line line 822
Builder|Builder whereHas( string $relation, Closure $callback, string $operator = '>=', int $count = 1)

Add a relationship count / exists condition to the query with where clauses.

Parameters

string $relation
Closure $callback
string $operator
int $count

Return Value

Builder|Builder

at line line 834
Builder|Builder whereDoesntHave( string $relation, Closure $callback = null)

Add a relationship count / exists condition to the query with where clauses.

Parameters

string $relation
Closure $callback

Return Value

Builder|Builder

at line line 847
Builder|Builder orHas( string $relation, string $operator = '>=', int $count = 1)

Add a relationship count / exists condition to the query with an "or".

Parameters

string $relation
string $operator
int $count

Return Value

Builder|Builder

at line line 861
Builder|Builder orWhereHas( string $relation, Closure $callback, string $operator = '>=', int $count = 1)

Add a relationship count / exists condition to the query with where clauses and an "or".

Parameters

string $relation
Closure $callback
string $operator
int $count

Return Value

Builder|Builder

at line line 959
$this with( mixed $relations)

Set the relationships that should be eager loaded.

Parameters

mixed $relations

Return Value

$this

at line line 1064
Builder|Builder applyScopes()

Apply the scopes to the Eloquent builder instance and return it.

Return Value

Builder|Builder

at line line 1204
Builder|Builder getQuery()

Get the underlying query builder instance.

Return Value

Builder|Builder

at line line 1214
Builder toBase()

Get a base query builder instance.

Return Value

Builder

at line line 1225
$this setQuery( Builder $query)

Set the underlying query builder instance.

Parameters

Builder $query

Return Value

$this

at line line 1237
array getEagerLoads()

Get the relationships being eagerly loaded.

Return Value

array

at line line 1248
$this setEagerLoads( array $eagerLoad)

Set the relationships being eagerly loaded.

Parameters

array $eagerLoad

Return Value

$this

at line line 1260
Model getModel()

Get the model instance being queried.

Return Value

Model

at line line 1271
$this setModel( Model $model)

Set a model instance for the model being queried.

Parameters

Model $model

Return Value

$this

at line line 1287
void macro( string $name, Closure $callback)

Extend the builder with a given callback.

Parameters

string $name
Closure $callback

Return Value

void

at line line 1298
Closure getMacro( string $name)

Get the given macro by name.

Parameters

string $name

Return Value

Closure

at line line 1310
mixed __call( string $method, array $parameters)

Dynamically handle calls into the query instance.

Parameters

string $method
array $parameters

Return Value

mixed

at line line 1336
void __clone()

Force a clone of the underlying query builder when cloning.

Return Value

void