class FormRequest extends Request implements ValidatesWhenResolved (View source)

Traits

Provides default implementation of ValidatesWhenResolved contract.

Properties

static protected array $macros

The registered string macros.

from  Macroable
protected ParameterBag|null $json

The decoded JSON content for the request.

from  Request
protected array $convertedFiles

All of the converted files for the request.

from  Request
protected Closure $userResolver

The user resolver callback.

from  Request
protected Closure $routeResolver

The route resolver callback.

from  Request
protected Container $container

The container instance.

protected Redirector $redirector

The redirector instance.

protected string $redirect

The URI to redirect to if validation fails.

protected string $redirectRoute

The route to redirect to if validation fails.

protected string $redirectAction

The controller action to redirect to if validation fails.

protected string $errorBag

The key to be used for the view error bag.

protected bool $stopOnFirstFailure

Indicates whether validation should stop after the first rule failure.

protected Validator $validator

The validator instance.

Methods

bool
isJson()

Determine if the request is sending JSON.

bool
expectsJson()

Determine if the current request probably expects a JSON response.

bool
wantsJson()

Determine if the current request is asking for JSON.

bool
accepts(string|array $contentTypes)

Determines whether the current requests accepts a given content type.

string|null
prefers(string|array $contentTypes)

Return the most suitable content type from the given array based on content negotiation.

bool
acceptsAnyContentType()

Determine if the current request accepts any content type.

bool
acceptsJson()

Determines whether a request accepts JSON.

bool
acceptsHtml()

Determines whether a request accepts HTML.

static bool
matchesType(string $actual, string $type)

Determine if the given content types match.

string
format(string $default = 'html')

Get the data format expected in the response.

string|array|null
old(string|null $key = null, string|array|null $default = null)

Retrieve an old input item.

void
flash()

Flash the input for the current request to the session.

void
flashOnly(array|mixed $keys)

Flash only some of the input to the session.

void
flashExcept(array|mixed $keys)

Flash only some of the input to the session.

void
flush()

Flush all of the old input from the session.

string|array|null
server(string|null $key = null, string|array|null $default = null)

Retrieve a server variable from the request.

bool
hasHeader(string $key)

Determine if a header is set on the request.

string|array|null
header(string|null $key = null, string|array|null $default = null)

Retrieve a header from the request.

string|null
bearerToken()

Get the bearer token from the request headers.

bool
exists(string|array $key)

Determine if the request contains a given input item key.

bool
has(string|array $key)

Determine if the request contains a given input item key.

bool
hasAny(string|array $keys)

Determine if the request contains any of the given inputs.

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

Apply the callback if the request contains the given input item key.

bool
filled(string|array $key)

Determine if the request contains a non-empty value for an input item.

bool
isNotFilled(string|array $key)

Determine if the request contains an empty value for an input item.

bool
anyFilled(string|array $keys)

Determine if the request contains a non-empty value for any of the given inputs.

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

Apply the callback if the request contains a non-empty value for the given input item key.

bool
missing(string|array $key)

Determine if the request is missing a given input item key.

bool
isEmptyString(string $key)

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

array
keys()

Get the keys for all of the input and files.

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

Get all of the input and files for the request.

mixed
input(string|null $key = null, mixed $default = null)

Retrieve an input item from the request.

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

Retrieve input as a boolean value.

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

Retrieve input from the request as a Carbon instance.

collect(array|string|null $key = null)

Retrieve input from the request as a collection.

array
only(array|mixed $keys)

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

array
except(array|mixed $keys)

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

string|array|null
query(string|null $key = null, string|array|null $default = null)

Retrieve a query string item from the request.

string|array|null
post(string|null $key = null, string|array|null $default = null)

Retrieve a request payload item from the request.

bool
hasCookie(string $key)

Determine if a cookie is set on the request.

string|array|null
cookie(string|null $key = null, string|array|null $default = null)

Retrieve a cookie from the request.

array
allFiles()

Get an array of all of the files on the request.

array
convertUploadedFiles(array $files)

Convert the given array of Symfony UploadedFiles to custom Laravel UploadedFiles.

bool
hasFile(string $key)

Determine if the uploaded data contains a file.

bool
isValidFile(mixed $file)

Check that the given file is a valid file instance.

UploadedFile|UploadedFile[]|array|null
file(string|null $key = null, mixed $default = null)

Retrieve a file from the request.

string|array|null
retrieveItem(string $source, string $key, string|array|null $default)

Retrieve a parameter item from a given source.

void
dd(mixed ...$keys)

Dump the request items and end the script.

$this
dump(mixed $keys = [])

Dump the items.

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

Register a custom macro.

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

Mix another object into the class.

static bool
hasMacro(string $name)

Checks if macro is registered.

static void
flushMacros()

Flush the existing macros.

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

Dynamically handle calls to the class.

mixed
__call(string $method, array $parameters)

Dynamically handle calls to the class.

static Request
capture()

Create a new Illuminate HTTP request from server variables.

from  Request
$this
instance()

Return the Request instance.

from  Request
string
method()

Get the request method.

from  Request
string
root()

Get the root URL for the application.

from  Request
string
url()

Get the URL (no query string) for the request.

from  Request
string
fullUrl()

Get the full URL for the request.

from  Request
string
fullUrlWithQuery(array $query)

Get the full URL for the request with the added query string parameters.

from  Request
string
fullUrlWithoutQuery($keys)

Get the full URL for the request without the given query string parameters.

from  Request
string
path()

Get the current path info for the request.

from  Request
string
decodedPath()

Get the current decoded path info for the request.

from  Request
string|null
segment(int $index, string|null $default = null)

Get a segment from the URI (1 based index).

from  Request
array
segments()

Get all of the segments for the request path.

from  Request
bool
is(mixed ...$patterns)

Determine if the current request URI matches a pattern.

from  Request
bool
routeIs(mixed ...$patterns)

Determine if the route name matches a given pattern.

from  Request
bool
fullUrlIs(mixed ...$patterns)

Determine if the current request URL and query string match a pattern.

from  Request
bool
ajax()

Determine if the request is the result of an AJAX call.

from  Request
bool
pjax()

Determine if the request is the result of a PJAX call.

from  Request
bool
prefetch()

Determine if the request is the result of a prefetch call.

from  Request
bool
secure()

Determine if the request is over HTTPS.

from  Request
string|null
ip()

Get the client IP address.

from  Request
array
ips()

Get the client IP addresses.

from  Request
string|null
userAgent()

Get the client user agent.

from  Request
$this
merge(array $input)

Merge new input into the current request's input array.

from  Request
$this
mergeIfMissing(array $input)

Merge new input into the request's input, but only when that key is missing from the request.

from  Request
$this
replace(array $input)

Replace the input for the current request.

from  Request
mixed
get(string $key, mixed $default = null)

This method belongs to Symfony HttpFoundation and is not usually needed when using Laravel.

from  Request
ParameterBag|mixed
json(string|null $key = null, mixed $default = null)

Get the JSON payload for the request.

from  Request
ParameterBag
getInputSource()

Get the input source for the request.

from  Request
static Request
createFrom(Request $from, Request|null $to = null)

Create a new request instance from the given Laravel request.

from  Request
static Request
createFromBase(Request $request)

Create an Illuminate request from a Symfony instance.

from  Request
duplicate(array $query = null, array $request = null, array $attributes = null, array $cookies = null, array $files = null, array $server = null)

{@inheritdoc}

from  Request
mixed
filterFiles(mixed $files)

Filter the given array of files, removing any empty values.

from  Request
session()

Get the session associated with the request.

from  Request
Store|null
getSession()

Get the session associated with the request.

from  Request
void
setLaravelSession(Session $session)

Set the session instance on the request.

from  Request
mixed
user(string|null $guard = null)

Get the user making the request.

from  Request
Route|object|string|null
route(string|null $param = null, mixed $default = null)

Get the route handling the request.

from  Request
string
fingerprint()

Get a unique fingerprint for the request / route / IP address.

from  Request
$this
setJson(ParameterBag $json)

Set the JSON payload for the request.

from  Request
getUserResolver()

Get the user resolver callback.

from  Request
$this
setUserResolver(Closure $callback)

Set the user resolver callback.

from  Request
getRouteResolver()

Get the route resolver callback.

from  Request
$this
setRouteResolver(Closure $callback)

Set the route resolver callback.

from  Request
array
toArray()

Get all of the input and files for the request.

from  Request
bool
offsetExists(string $offset)

Determine if the given offset exists.

from  Request
mixed
offsetGet(string $offset)

Get the value at the given offset.

from  Request
void
offsetSet(string $offset, mixed $value)

Set the value at the given offset.

from  Request
void
offsetUnset(string $offset)

Remove the value at the given offset.

from  Request
bool
__isset(string $key)

Check if an input element is set on the request.

from  Request
mixed
__get(string $key)

Get an input element from the request.

from  Request
array
validate(array $rules, mixed $params)

No description

from  Request
array
validateWithBag(string $errorBag, array $rules, mixed $params)

No description

from  Request
bool
hasValidSignature(bool $absolute = true)

No description

from  Request
void
validateResolved()

Validate the class instance.

void
prepareForValidation()

Prepare the data for validation.

getValidatorInstance()

Get the validator instance for the request.

void
passedValidation()

Handle a passed validation attempt.

void
failedValidation(Validator $validator)

Handle a failed validation attempt.

bool
passesAuthorization()

Determine if the request passes the authorization check.

void
failedAuthorization()

Handle a failed authorization attempt.

createDefaultValidator(Factory $factory)

Create the default validator instance.

array
validationData()

Get data to be validated from the request.

string
getRedirectUrl()

Get the URL to redirect to on a validation error.

safe(array $keys = null)

Get a validated input container for the validated input.

array
validated()

Get the validated data from the request.

array
messages()

Get custom messages for validator errors.

array
attributes()

Get custom attributes for validator errors.

$this
setValidator(Validator $validator)

Set the Validator instance.

$this
setRedirector(Redirector $redirector)

Set the Redirector instance.

$this
setContainer(Container $container)

Set the container implementation.

Details

bool isJson()

Determine if the request is sending JSON.

Return Value

bool

bool expectsJson()

Determine if the current request probably expects a JSON response.

Return Value

bool

bool wantsJson()

Determine if the current request is asking for JSON.

Return Value

bool

bool accepts(string|array $contentTypes)

Determines whether the current requests accepts a given content type.

Parameters

string|array $contentTypes

Return Value

bool

string|null prefers(string|array $contentTypes)

Return the most suitable content type from the given array based on content negotiation.

Parameters

string|array $contentTypes

Return Value

string|null

bool acceptsAnyContentType()

Determine if the current request accepts any content type.

Return Value

bool

bool acceptsJson()

Determines whether a request accepts JSON.

Return Value

bool

bool acceptsHtml()

Determines whether a request accepts HTML.

Return Value

bool

static bool matchesType(string $actual, string $type)

Determine if the given content types match.

Parameters

string $actual
string $type

Return Value

bool

string format(string $default = 'html')

Get the data format expected in the response.

Parameters

string $default

Return Value

string

string|array|null old(string|null $key = null, string|array|null $default = null)

Retrieve an old input item.

Parameters

string|null $key
string|array|null $default

Return Value

string|array|null

void flash()

Flash the input for the current request to the session.

Return Value

void

void flashOnly(array|mixed $keys)

Flash only some of the input to the session.

Parameters

array|mixed $keys

Return Value

void

void flashExcept(array|mixed $keys)

Flash only some of the input to the session.

Parameters

array|mixed $keys

Return Value

void

void flush()

Flush all of the old input from the session.

Return Value

void

string|array|null server(string|null $key = null, string|array|null $default = null)

Retrieve a server variable from the request.

Parameters

string|null $key
string|array|null $default

Return Value

string|array|null

bool hasHeader(string $key)

Determine if a header is set on the request.

Parameters

string $key

Return Value

bool

string|array|null header(string|null $key = null, string|array|null $default = null)

Retrieve a header from the request.

Parameters

string|null $key
string|array|null $default

Return Value

string|array|null

string|null bearerToken()

Get the bearer token from the request headers.

Return Value

string|null

bool exists(string|array $key)

Determine if the request contains a given input item key.

Parameters

string|array $key

Return Value

bool

bool has(string|array $key)

Determine if the request contains a given input item key.

Parameters

string|array $key

Return Value

bool

bool hasAny(string|array $keys)

Determine if the request contains any of the given inputs.

Parameters

string|array $keys

Return Value

bool

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

Apply the callback if the request contains the given input item key.

Parameters

string $key
callable $callback
callable $default

Return Value

$this|mixed

bool filled(string|array $key)

Determine if the request contains a non-empty value for an input item.

Parameters

string|array $key

Return Value

bool

bool isNotFilled(string|array $key)

Determine if the request contains an empty value for an input item.

Parameters

string|array $key

Return Value

bool

bool anyFilled(string|array $keys)

Determine if the request contains a non-empty value for any of the given inputs.

Parameters

string|array $keys

Return Value

bool

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

Apply the callback if the request contains a non-empty value for the given input item key.

Parameters

string $key
callable $callback
callable $default

Return Value

$this|mixed

bool missing(string|array $key)

Determine if the request is missing a given input item key.

Parameters

string|array $key

Return Value

bool

protected bool isEmptyString(string $key)

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

Parameters

string $key

Return Value

bool

array keys()

Get the keys for all of the input and files.

Return Value

array

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

Get all of the input and files for the request.

Parameters

array|mixed|null $keys

Return Value

array

mixed input(string|null $key = null, mixed $default = null)

Retrieve an input item from the request.

Parameters

string|null $key
mixed $default

Return Value

mixed

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

Retrieve input 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

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

Retrieve input from the request as a Carbon instance.

Parameters

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

Return Value

Carbon|null

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

Retrieve input from the request as a collection.

Parameters

array|string|null $key

Return Value

Collection

array only(array|mixed $keys)

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

Parameters

array|mixed $keys

Return Value

array

array except(array|mixed $keys)

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

Parameters

array|mixed $keys

Return Value

array

string|array|null query(string|null $key = null, string|array|null $default = null)

Retrieve a query string item from the request.

Parameters

string|null $key
string|array|null $default

Return Value

string|array|null

string|array|null post(string|null $key = null, string|array|null $default = null)

Retrieve a request payload item from the request.

Parameters

string|null $key
string|array|null $default

Return Value

string|array|null

bool hasCookie(string $key)

Determine if a cookie is set on the request.

Parameters

string $key

Return Value

bool

Retrieve a cookie from the request.

Parameters

string|null $key
string|array|null $default

Return Value

string|array|null

array allFiles()

Get an array of all of the files on the request.

Return Value

array

protected array convertUploadedFiles(array $files)

Convert the given array of Symfony UploadedFiles to custom Laravel UploadedFiles.

Parameters

array $files

Return Value

array

bool hasFile(string $key)

Determine if the uploaded data contains a file.

Parameters

string $key

Return Value

bool

protected bool isValidFile(mixed $file)

Check that the given file is a valid file instance.

Parameters

mixed $file

Return Value

bool

UploadedFile|UploadedFile[]|array|null file(string|null $key = null, mixed $default = null)

Retrieve a file from the request.

Parameters

string|null $key
mixed $default

Return Value

UploadedFile|UploadedFile[]|array|null

protected string|array|null retrieveItem(string $source, string $key, string|array|null $default)

Retrieve a parameter item from a given source.

Parameters

string $source
string $key
string|array|null $default

Return Value

string|array|null

void dd(mixed ...$keys)

Dump the request items and end the script.

Parameters

mixed ...$keys

Return Value

void

$this dump(mixed $keys = [])

Dump the items.

Parameters

mixed $keys

Return Value

$this

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

Register a custom macro.

Parameters

string $name
object|callable $macro

Return Value

void

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

Mix another object into the class.

Parameters

object $mixin
bool $replace

Return Value

void

Exceptions

ReflectionException

static bool hasMacro(string $name)

Checks if macro is registered.

Parameters

string $name

Return Value

bool

static void flushMacros()

Flush the existing macros.

Return Value

void

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

Dynamically handle calls to the class.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

mixed __call(string $method, array $parameters)

Dynamically handle calls to the class.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

static Request capture()

Create a new Illuminate HTTP request from server variables.

Return Value

Request

$this instance()

Return the Request instance.

Return Value

$this

string method()

Get the request method.

Return Value

string

string root()

Get the root URL for the application.

Return Value

string

string url()

Get the URL (no query string) for the request.

Return Value

string

string fullUrl()

Get the full URL for the request.

Return Value

string

string fullUrlWithQuery(array $query)

Get the full URL for the request with the added query string parameters.

Parameters

array $query

Return Value

string

string fullUrlWithoutQuery($keys)

Get the full URL for the request without the given query string parameters.

Parameters

$keys

Return Value

string

string path()

Get the current path info for the request.

Return Value

string

string decodedPath()

Get the current decoded path info for the request.

Return Value

string

string|null segment(int $index, string|null $default = null)

Get a segment from the URI (1 based index).

Parameters

int $index
string|null $default

Return Value

string|null

array segments()

Get all of the segments for the request path.

Return Value

array

bool is(mixed ...$patterns)

Determine if the current request URI matches a pattern.

Parameters

mixed ...$patterns

Return Value

bool

bool routeIs(mixed ...$patterns)

Determine if the route name matches a given pattern.

Parameters

mixed ...$patterns

Return Value

bool

bool fullUrlIs(mixed ...$patterns)

Determine if the current request URL and query string match a pattern.

Parameters

mixed ...$patterns

Return Value

bool

bool ajax()

Determine if the request is the result of an AJAX call.

Return Value

bool

bool pjax()

Determine if the request is the result of a PJAX call.

Return Value

bool

bool prefetch()

Determine if the request is the result of a prefetch call.

Return Value

bool

bool secure()

Determine if the request is over HTTPS.

Return Value

bool

string|null ip()

Get the client IP address.

Return Value

string|null

array ips()

Get the client IP addresses.

Return Value

array

string|null userAgent()

Get the client user agent.

Return Value

string|null

$this merge(array $input)

Merge new input into the current request's input array.

Parameters

array $input

Return Value

$this

$this mergeIfMissing(array $input)

Merge new input into the request's input, but only when that key is missing from the request.

Parameters

array $input

Return Value

$this

$this replace(array $input)

Replace the input for the current request.

Parameters

array $input

Return Value

$this

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

This method belongs to Symfony HttpFoundation and is not usually needed when using Laravel.

Instead, you may use the "input" method.

Parameters

string $key
mixed $default

Return Value

mixed

ParameterBag|mixed json(string|null $key = null, mixed $default = null)

Get the JSON payload for the request.

Parameters

string|null $key
mixed $default

Return Value

ParameterBag|mixed

protected ParameterBag getInputSource()

Get the input source for the request.

Return Value

ParameterBag

static Request createFrom(Request $from, Request|null $to = null)

Create a new request instance from the given Laravel request.

Parameters

Request $from
Request|null $to

Return Value

Request

static Request createFromBase(Request $request)

Create an Illuminate request from a Symfony instance.

Parameters

Request $request

Return Value

Request

Request duplicate(array $query = null, array $request = null, array $attributes = null, array $cookies = null, array $files = null, array $server = null)

{@inheritdoc}

Parameters

array $query
array $request
array $attributes
array $cookies
array $files
array $server

Return Value

Request

protected mixed filterFiles(mixed $files)

Filter the given array of files, removing any empty values.

Parameters

mixed $files

Return Value

mixed

Store session()

Get the session associated with the request.

Return Value

Store

Exceptions

RuntimeException

Store|null getSession()

Get the session associated with the request.

Return Value

Store|null

void setLaravelSession(Session $session)

Set the session instance on the request.

Parameters

Session $session

Return Value

void

mixed user(string|null $guard = null)

Get the user making the request.

Parameters

string|null $guard

Return Value

mixed

Route|object|string|null route(string|null $param = null, mixed $default = null)

Get the route handling the request.

Parameters

string|null $param
mixed $default

Return Value

Route|object|string|null

string fingerprint()

Get a unique fingerprint for the request / route / IP address.

Return Value

string

Exceptions

RuntimeException

$this setJson(ParameterBag $json)

Set the JSON payload for the request.

Parameters

ParameterBag $json

Return Value

$this

Closure getUserResolver()

Get the user resolver callback.

Return Value

Closure

$this setUserResolver(Closure $callback)

Set the user resolver callback.

Parameters

Closure $callback

Return Value

$this

Closure getRouteResolver()

Get the route resolver callback.

Return Value

Closure

$this setRouteResolver(Closure $callback)

Set the route resolver callback.

Parameters

Closure $callback

Return Value

$this

array toArray()

Get all of the input and files for the request.

Return Value

array

bool offsetExists(string $offset)

Determine if the given offset exists.

Parameters

string $offset

Return Value

bool

mixed offsetGet(string $offset)

Get the value at the given offset.

Parameters

string $offset

Return Value

mixed

void offsetSet(string $offset, mixed $value)

Set the value at the given offset.

Parameters

string $offset
mixed $value

Return Value

void

void offsetUnset(string $offset)

Remove the value at the given offset.

Parameters

string $offset

Return Value

void

bool __isset(string $key)

Check if an input element is set on the request.

Parameters

string $key

Return Value

bool

mixed __get(string $key)

Get an input element from the request.

Parameters

string $key

Return Value

mixed

array validate(array $rules, mixed $params)

No description

Parameters

array $rules
mixed $params

Return Value

array

array validateWithBag(string $errorBag, array $rules, mixed $params)

No description

Parameters

string $errorBag
array $rules
mixed $params

Return Value

array

bool hasValidSignature(bool $absolute = true)

No description

Parameters

bool $absolute

Return Value

bool

void validateResolved()

Validate the class instance.

Return Value

void

protected void prepareForValidation()

Prepare the data for validation.

Return Value

void

protected Validator getValidatorInstance()

Get the validator instance for the request.

Return Value

Validator

protected void passedValidation()

Handle a passed validation attempt.

Return Value

void

protected void failedValidation(Validator $validator)

Handle a failed validation attempt.

Parameters

Validator $validator

Return Value

void

Exceptions

ValidationException

protected bool passesAuthorization()

Determine if the request passes the authorization check.

Return Value

bool

Exceptions

AuthorizationException

protected void failedAuthorization()

Handle a failed authorization attempt.

Return Value

void

Exceptions

AuthorizationException

protected Validator createDefaultValidator(Factory $factory)

Create the default validator instance.

Parameters

Factory $factory

Return Value

Validator

array validationData()

Get data to be validated from the request.

Return Value

array

protected string getRedirectUrl()

Get the URL to redirect to on a validation error.

Return Value

string

ValidatedInput|array safe(array $keys = null)

Get a validated input container for the validated input.

Parameters

array $keys

Return Value

ValidatedInput|array

array validated()

Get the validated data from the request.

Return Value

array

array messages()

Get custom messages for validator errors.

Return Value

array

array attributes()

Get custom attributes for validator errors.

Return Value

array

$this setValidator(Validator $validator)

Set the Validator instance.

Parameters

Validator $validator

Return Value

$this

$this setRedirector(Redirector $redirector)

Set the Redirector instance.

Parameters

Redirector $redirector

Return Value

$this

$this setContainer(Container $container)

Set the container implementation.

Parameters

Container $container

Return Value

$this