W3cubDocs

/Laravel 8

Factory

class Factory (View source)

Traits

Macroable

Properties

static protected array $macros The registered string macros. from Macroable
protected Collection $stubCallbacks The stub callables that will handle requests.
protected bool $recording Indicates if the factory is recording requests and responses.
protected array $recorded The recorded response array.
protected array $responseSequences All created response sequences.

Methods

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 mixed __callStatic(string $method, array $parameters)

Dynamically handle calls to the class.

from Macroable
mixed __call(string $method, array $parameters)

Execute a method against a new pending request instance.

void __construct()

Create a new factory instance.

static PromiseInterface response(array|string $body = null, int $status = 200, array $headers = [])

Create a new response instance for use during stubbing.

ResponseSequence sequence(array $responses = [])

Get an invokable object that returns a sequence of responses in order for use during stubbing.

$this fake(callable|array $callback = null)

Register a stub callable that will intercept requests and be able to return stub responses.

ResponseSequence fakeSequence(string $url = '*')

Register a response sequence for the given URL pattern.

$this stubUrl(string $url, Response|PromiseInterface|callable $callback)

Stub the given URL using the given callback.

$this record()

Begin recording request / response pairs.

void recordRequestResponsePair(Request $request, Response $response)

Record a request response pair.

void assertSent(callable $callback)

Assert that a request / response pair was recorded matching a given truth test.

void assertNotSent(callable $callback)

Assert that a request / response pair was not recorded matching a given truth test.

void assertNothingSent()

Assert that no request / response pair was recorded.

void assertSentCount(int $count)

Assert how many requests have been recorded.

void assertSequencesAreEmpty()

Assert that every created response sequence is empty.

Collection recorded(callable $callback = null)

Get a collection of the request / response pairs matching the given truth test.

PendingRequest newPendingRequest()

Create a new pending request instance for this factory.

PendingRequest accept(string $contentType)

No description

PendingRequest acceptJson()

No description

PendingRequest asForm()

No description

PendingRequest asJson()

No description

PendingRequest asMultipart()

No description

PendingRequest attach(string $name, string $contents, string|null $filename = null, array $headers = [])

No description

PendingRequest baseUrl(string $url)

No description

PendingRequest beforeSending(callable $callback)

No description

PendingRequest bodyFormat(string $format)

No description

PendingRequest contentType(string $contentType)

No description

PendingRequest retry(int $times, int $sleep)

No description

PendingRequest stub(callable $callback)

No description

PendingRequest timeout(int $seconds)

No description

PendingRequest withBasicAuth(string $username, string $password)

No description

PendingRequest withBody(resource|string $content, string $contentType)

No description

PendingRequest withCookies(array $cookies, string $domain)

No description

PendingRequest withDigestAuth(string $username, string $password)

No description

PendingRequest withHeaders(array $headers)

No description

PendingRequest withOptions(array $options)

No description

PendingRequest withToken(string $token, string $type = 'Bearer')

No description

PendingRequest withoutRedirecting()

No description

PendingRequest withoutVerifying()

No description

Response delete(string $url, array $data = [])

No description

Response get(string $url, array $query = [])

No description

Response head(string $url, array $query = [])

No description

Response patch(string $url, array $data = [])

No description

Response post(string $url, array $data = [])

No description

Response put(string $url, array $data = [])

No description

Response send(string $method, string $url, array $options = [])

No description

Details

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 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)

Execute a method against a new pending request instance.

Parameters

string $method
array $parameters

Return Value

mixed

void __construct()

Create a new factory instance.

Return Value

void

static PromiseInterface response(array|string $body = null, int $status = 200, array $headers = [])

Create a new response instance for use during stubbing.

Parameters

array|string $body
int $status
array $headers

Return Value

PromiseInterface

ResponseSequence sequence(array $responses = [])

Get an invokable object that returns a sequence of responses in order for use during stubbing.

Parameters

array $responses

Return Value

ResponseSequence

$this fake(callable|array $callback = null)

Register a stub callable that will intercept requests and be able to return stub responses.

Parameters

callable|array $callback

Return Value

$this

ResponseSequence fakeSequence(string $url = '*')

Register a response sequence for the given URL pattern.

Parameters

string $url

Return Value

ResponseSequence

$this stubUrl(string $url, Response|PromiseInterface|callable $callback)

Stub the given URL using the given callback.

Parameters

string $url
Response|PromiseInterface|callable $callback

Return Value

$this

protected $this record()

Begin recording request / response pairs.

Return Value

$this

void recordRequestResponsePair(Request $request, Response $response)

Record a request response pair.

Parameters

Request $request
Response $response

Return Value

void

void assertSent(callable $callback)

Assert that a request / response pair was recorded matching a given truth test.

Parameters

callable $callback

Return Value

void

void assertNotSent(callable $callback)

Assert that a request / response pair was not recorded matching a given truth test.

Parameters

callable $callback

Return Value

void

void assertNothingSent()

Assert that no request / response pair was recorded.

Return Value

void

void assertSentCount(int $count)

Assert how many requests have been recorded.

Parameters

int $count

Return Value

void

void assertSequencesAreEmpty()

Assert that every created response sequence is empty.

Return Value

void

Collection recorded(callable $callback = null)

Get a collection of the request / response pairs matching the given truth test.

Parameters

callable $callback

Return Value

Collection

protected PendingRequest newPendingRequest()

Create a new pending request instance for this factory.

Return Value

PendingRequest

PendingRequest accept(string $contentType)

Parameters

string $contentType

Return Value

PendingRequest

PendingRequest acceptJson()

Return Value

PendingRequest

PendingRequest asForm()

Return Value

PendingRequest

PendingRequest asJson()

Return Value

PendingRequest

PendingRequest asMultipart()

Return Value

PendingRequest

PendingRequest attach(string $name, string $contents, string|null $filename = null, array $headers = [])

Parameters

string $name
string $contents
string|null $filename
array $headers

Return Value

PendingRequest

PendingRequest baseUrl(string $url)

Parameters

string $url

Return Value

PendingRequest

PendingRequest beforeSending(callable $callback)

Parameters

callable $callback

Return Value

PendingRequest

PendingRequest bodyFormat(string $format)

Parameters

string $format

Return Value

PendingRequest

PendingRequest contentType(string $contentType)

Parameters

string $contentType

Return Value

PendingRequest

PendingRequest retry(int $times, int $sleep)

Parameters

int $times
int $sleep

Return Value

PendingRequest

PendingRequest stub(callable $callback)

Parameters

callable $callback

Return Value

PendingRequest

PendingRequest timeout(int $seconds)

Parameters

int $seconds

Return Value

PendingRequest

PendingRequest withBasicAuth(string $username, string $password)

Parameters

string $username
string $password

Return Value

PendingRequest

PendingRequest withBody(resource|string $content, string $contentType)

Parameters

resource|string $content
string $contentType

Return Value

PendingRequest

PendingRequest withCookies(array $cookies, string $domain)

Parameters

array $cookies
string $domain

Return Value

PendingRequest

PendingRequest withDigestAuth(string $username, string $password)

Parameters

string $username
string $password

Return Value

PendingRequest

PendingRequest withHeaders(array $headers)

Parameters

array $headers

Return Value

PendingRequest

PendingRequest withOptions(array $options)

Parameters

array $options

Return Value

PendingRequest

PendingRequest withToken(string $token, string $type = 'Bearer')

Parameters

string $token
string $type

Return Value

PendingRequest

PendingRequest withoutRedirecting()

Return Value

PendingRequest

PendingRequest withoutVerifying()

Return Value

PendingRequest

Response delete(string $url, array $data = [])

Parameters

string $url
array $data

Return Value

Response

Response get(string $url, array $query = [])

Parameters

string $url
array $query

Return Value

Response

Response head(string $url, array $query = [])

Parameters

string $url
array $query

Return Value

Response

Response patch(string $url, array $data = [])

Parameters

string $url
array $data

Return Value

Response

Response post(string $url, array $data = [])

Parameters

string $url
array $data

Return Value

Response

Response put(string $url, array $data = [])

Parameters

string $url
array $data

Return Value

Response

Response send(string $method, string $url, array $options = [])

Parameters

string $method
string $url
array $options

Return Value

Response

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/8.x/Illuminate/Http/Client/Factory.html