1. class
  2. Illuminate
  3. \
  4. Support
  5. \
  6. Fluent

Fluent

class Fluent implements Arrayable, ArrayAccess, Jsonable, JsonSerializable (View source)

Traits

InteractsWithData
Macroable

Properties

static protected array $macros

The registered string macros.

 from  Macroable
protected $attributes

Methods

array
all(array|mixed|null $keys = null)

Get all of the attributes from the fluent instance.

mixed
data(string $key = null, mixed $default = null)

Get data from the fluent instance.

bool
exists(string|array $key)

Determine if the data contains a given key.

from  InteractsWithData
bool
has(string|array $key)

Determine if the data contains a given key.

from  InteractsWithData
bool
hasAny(string|array $keys)

Determine if the instance contains any of the given keys.

from  InteractsWithData
$this|mixed
whenHas(string $key, callable $callback, callable|null $default = null)

Apply the callback if the instance contains the given key.

from  InteractsWithData
bool
filled(string|array $key)

Determine if the instance contains a non-empty value for the given key.

from  InteractsWithData
bool
isNotFilled(string|array $key)

Determine if the instance contains an empty value for the given key.

from  InteractsWithData
bool
anyFilled(string|array $keys)

Determine if the instance contains a non-empty value for any of the given keys.

from  InteractsWithData
$this|mixed
whenFilled(string $key, callable $callback, callable|null $default = null)

Apply the callback if the instance contains a non-empty value for the given key.

from  InteractsWithData
bool
missing(string|array $key)

Determine if the instance is missing a given key.

from  InteractsWithData
$this|mixed
whenMissing(string $key, callable $callback, callable|null $default = null)

Apply the callback if the instance is missing the given key.

from  InteractsWithData
bool
isEmptyString(string $key)

Determine if the given key is an empty string for "filled".

from  InteractsWithData
Stringable
str(string $key, mixed $default = null)

Retrieve data from the instance as a Stringable instance.

from  InteractsWithData
Stringable
string(string $key, mixed $default = null)

Retrieve data from the instance as a Stringable instance.

from  InteractsWithData
bool
boolean(string|null $key = null, bool $default = false)

Retrieve data as a boolean value.

from  InteractsWithData
int
integer(string $key, int $default = 0)

Retrieve data as an integer value.

from  InteractsWithData
float
float(string $key, float $default = 0.0)

Retrieve data as a float value.

from  InteractsWithData
Carbon|null
date(string $key, string|null $format = null, string|null $tz = null)

Retrieve data from the instance as a Carbon instance.

from  InteractsWithData
TEnum|null
enum(string $key, TEnum> $enumClass)

Retrieve data from the instance as an enum.

from  InteractsWithData
TEnum[]
enums(string $key, TEnum> $enumClass)

Retrieve data from the instance as an array of enums.

from  InteractsWithData
bool
isBackedEnum(class-string $enumClass)

Determine if the given enum class is backed.

from  InteractsWithData
array
array(array|string|null $key = null)

Retrieve data from the instance as an array.

from  InteractsWithData
Collection
collect(array|string|null $key = null)

Retrieve data from the instance as a collection.

from  InteractsWithData
array
only(array|mixed $keys)

Get a subset containing the provided keys with values from the instance data.

from  InteractsWithData
array
except(array|mixed $keys)

Get all of the data except for a specified array of items.

from  InteractsWithData
static void
macro(string $name, object|callable $macro)

Register a custom macro.

from  Macroable
static void
mixin(object $mixin, bool $replace = true)

Mix another object into the class.

from  Macroable
static bool
hasMacro(string $name)

Checks if macro is registered.

from  Macroable
static void
flushMacros()

Flush the existing macros.

from  Macroable
static mixed
__callStatic(string $method, array $parameters)

Dynamically handle calls to the class.

from  Macroable
$this
__call(TKey $method, $parameters)

Handle dynamic calls to the fluent instance to set attributes.

__construct(TValue> $attributes = [])

Create a new fluent instance.

get($key, $default = null)

No description

$this
set(TKey $key, TValue $value)

Set an attribute on the fluent instance using "dot" notation.

$this
fill(TValue> $attributes)

Fill the fluent instance with an array of attributes.

mixed
value(string $key, mixed $default = null)

Get an attribute from the fluent instance.

Fluent
scope(string $key, mixed $default = null)

Get the value of the given key as a new Fluent instance.

getAttributes()

No description

toArray()

No description

array
jsonSerialize()

No description

string
toJson(int $options = 0)

Convert the fluent instance to JSON.

bool
offsetExists(TKey $offset)

Determine if the given offset exists.

mixed
offsetGet(TKey $offset)

Get the value for a given offset.

void
offsetSet(TKey $offset, TValue $value)

Set the value at the given offset.

void
offsetUnset(TKey $offset)

Unset the value at the given offset.

TValue|null
__get(TKey $key)

Dynamically retrieve the value of an attribute.

void
__set(TKey $key, TValue $value)

Dynamically set the value of an attribute.

bool
__isset(TKey $key)

Dynamically check if an attribute is set.

void
__unset(TKey $key)

Dynamically unset an attribute.

Details

at line 121
array all(array|mixed|null $keys = null)

Get all of the attributes from the fluent instance.

Parameters

array|mixed|null $keys

Return Value

array

at line 145
protected mixed data(string $key = null, mixed $default = null)

Get data from the fluent instance.

Parameters

string $key
mixed $default

Return Value

mixed

in InteractsWithData at line 36
bool exists(string|array $key)

Determine if the data contains a given key.

Parameters

string|array $key

Return Value

bool

in InteractsWithData at line 47
bool has(string|array $key)

Determine if the data contains a given key.

Parameters

string|array $key

Return Value

bool

in InteractsWithData at line 68
bool hasAny(string|array $keys)

Determine if the instance contains any of the given keys.

Parameters

string|array $keys

Return Value

bool

in InteractsWithData at line 85
$this|mixed whenHas(string $key, callable $callback, callable|null $default = null)

Apply the callback if the instance contains the given key.

Parameters

string $key
callable $callback
callable|null $default

Return Value

$this|mixed

in InteractsWithData at line 104
bool filled(string|array $key)

Determine if the instance contains a non-empty value for the given key.

Parameters

string|array $key

Return Value

bool

in InteractsWithData at line 123
bool isNotFilled(string|array $key)

Determine if the instance contains an empty value for the given key.

Parameters

string|array $key

Return Value

bool

in InteractsWithData at line 142
bool anyFilled(string|array $keys)

Determine if the instance contains a non-empty value for any of the given keys.

Parameters

string|array $keys

Return Value

bool

in InteractsWithData at line 163
$this|mixed whenFilled(string $key, callable $callback, callable|null $default = null)

Apply the callback if the instance contains a non-empty value for the given key.

Parameters

string $key
callable $callback
callable|null $default

Return Value

$this|mixed

in InteractsWithData at line 182
bool missing(string|array $key)

Determine if the instance is missing a given key.

Parameters

string|array $key

Return Value

bool

in InteractsWithData at line 197
$this|mixed whenMissing(string $key, callable $callback, callable|null $default = null)

Apply the callback if the instance is missing the given key.

Parameters

string $key
callable $callback
callable|null $default

Return Value

$this|mixed

in InteractsWithData at line 216
protected bool isEmptyString(string $key)

Determine if the given key is an empty string for "filled".

Parameters

string $key

Return Value

bool

in InteractsWithData at line 230
Stringable str(string $key, mixed $default = null)

Retrieve data from the instance as a Stringable instance.

Parameters

string $key
mixed $default

Return Value

Stringable

in InteractsWithData at line 242
Stringable string(string $key, mixed $default = null)

Retrieve data from the instance as a Stringable instance.

Parameters

string $key
mixed $default

Return Value

Stringable

in InteractsWithData at line 256
bool boolean(string|null $key = null, bool $default = false)

Retrieve data as a boolean value.

Returns true when value is "1", "true", "on", and "yes". Otherwise, returns false.

Parameters

string|null $key
bool $default

Return Value

bool

in InteractsWithData at line 268
int integer(string $key, int $default = 0)

Retrieve data as an integer value.

Parameters

string $key
int $default

Return Value

int

in InteractsWithData at line 280
float float(string $key, float $default = 0.0)

Retrieve data as a float value.

Parameters

string $key
float $default

Return Value

float

in InteractsWithData at line 295
Carbon|null date(string $key, string|null $format = null, string|null $tz = null)

Retrieve data from the instance as a Carbon instance.

Parameters

string $key
string|null $format
string|null $tz

Return Value

Carbon|null

Exceptions

InvalidFormatException

in InteractsWithData at line 317
TEnum|null enum(string $key, TEnum> $enumClass)

Retrieve data from the instance as an enum.

Parameters

string $key
TEnum> $enumClass

Return Value

TEnum|null

in InteractsWithData at line 335
TEnum[] enums(string $key, TEnum> $enumClass)

Retrieve data from the instance as an array of enums.

Parameters

string $key
TEnum> $enumClass

Return Value

TEnum[]

in InteractsWithData at line 353
protected bool isBackedEnum(class-string $enumClass)

Determine if the given enum class is backed.

Parameters

class-string $enumClass

Return Value

bool

in InteractsWithData at line 364
array array(array|string|null $key = null)

Retrieve data from the instance as an array.

Parameters

array|string|null $key

Return Value

array

in InteractsWithData at line 375
Collection collect(array|string|null $key = null)

Retrieve data from the instance as a collection.

Parameters

array|string|null $key

Return Value

Collection

in InteractsWithData at line 386
array only(array|mixed $keys)

Get a subset containing the provided keys with values from the instance data.

Parameters

array|mixed $keys

Return Value

array

in InteractsWithData at line 411
array except(array|mixed $keys)

Get all of the data except for a specified array of items.

Parameters

array|mixed $keys

Return Value

array

in Macroable at line 29
static void macro(string $name, object|callable $macro)

Register a custom macro.

Parameters

string $name
object|callable $macro

Return Value

void

in Macroable at line 43
static void mixin(object $mixin, bool $replace = true)

Mix another object into the class.

Parameters

object $mixin
bool $replace

Return Value

void

Exceptions

ReflectionException

in Macroable at line 62
static bool hasMacro(string $name)

Checks if macro is registered.

Parameters

string $name

Return Value

bool

in Macroable at line 72
static void flushMacros()

Flush the existing macros.

Return Value

void

in Macroable at line 86
static mixed __callStatic(string $method, array $parameters)

Dynamically handle calls to the class.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

at line 243
$this __call(TKey $method, $parameters)

Handle dynamic calls to the fluent instance to set attributes.

Parameters

TKey $method
$parameters

Return Value

$this

at line 37
__construct(TValue> $attributes = [])

Create a new fluent instance.

Parameters

TValue> $attributes

at line 51
get($key, $default = null)

No description

Parameters

$key
$default

at line 63
$this set(TKey $key, TValue $value)

Set an attribute on the fluent instance using "dot" notation.

Parameters

TKey $key
TValue $value

Return Value

$this

at line 76
$this fill(TValue> $attributes)

Fill the fluent instance with an array of attributes.

Parameters

TValue> $attributes

Return Value

$this

at line 92
mixed value(string $key, mixed $default = null)

Get an attribute from the fluent instance.

Parameters

string $key
mixed $default

Return Value

mixed

at line 108
Fluent scope(string $key, mixed $default = null)

Get the value of the given key as a new Fluent instance.

Parameters

string $key
mixed $default

Return Value

Fluent

at line 155
getAttributes()

No description

at line 165
toArray()

No description

at line 175
array jsonSerialize()

No description

Return Value

array

at line 186
string toJson(int $options = 0)

Convert the fluent instance to JSON.

Parameters

int $options

Return Value

string

at line 197
bool offsetExists(TKey $offset)

Determine if the given offset exists.

Parameters

TKey $offset

Return Value

bool

at line 208
mixed offsetGet(TKey $offset)

Get the value for a given offset.

Parameters

TKey $offset

Return Value

mixed

at line 220
void offsetSet(TKey $offset, TValue $value)

Set the value at the given offset.

Parameters

TKey $offset
TValue $value

Return Value

void

at line 231
void offsetUnset(TKey $offset)

Unset the value at the given offset.

Parameters

TKey $offset

Return Value

void

at line 260
TValue|null __get(TKey $key)

Dynamically retrieve the value of an attribute.

Parameters

TKey $key

Return Value

TValue|null

at line 272
void __set(TKey $key, TValue $value)

Dynamically set the value of an attribute.

Parameters

TKey $key
TValue $value

Return Value

void

at line 283
bool __isset(TKey $key)

Dynamically check if an attribute is set.

Parameters

TKey $key

Return Value

bool

at line 294
void __unset(TKey $key)

Dynamically unset an attribute.

Parameters

TKey $key

Return Value

void