ApiController  

class ApiController implements ExtenderInterface

Methods

__construct(string $controllerClass)

No description

ApiController
prepareDataQuery(callable|string $callback)

No description

ApiController
prepareDataForSerialization(callable|string $callback)

No description

ApiController
setSerializer(string $serializerClass, callable|string|null $callback = null)

Set the serializer that will serialize data for the endpoint.

ApiController
addInclude(string|array $name, callable|string|null $callback = null)

Include the given relationship by default.

ApiController
removeInclude(string|array $name, callable|string|null $callback = null)

Don't include the given relationship by default.

ApiController
addOptionalInclude(string|array $name, callable|string|null $callback = null)

Make the given relationship available for inclusion.

ApiController
removeOptionalInclude(string|array $name, callable|string|null $callback = null)

Don't allow the given relationship to be included.

ApiController
setLimit(int $limit, callable|string|null $callback = null)

Set the default number of results.

ApiController
setMaxLimit(int $max, callable|string|null $callback = null)

Set the maximum number of results.

ApiController
addSortField(string|array $field, callable|string|null $callback = null)

Allow sorting results by the given field.

ApiController
removeSortField(string|array $field, callable|string|null $callback = null)

Disallow sorting results by the given field.

ApiController
setSort(array $sort, callable|string|null $callback = null)

Set the default sort order for the results.

extend(Container $container, Extension $extension = null)

No description

Details

at line 37
__construct(string $controllerClass)

Parameters

string $controllerClass The ::class attribute of the controller you are modifying. This controller should extend from \Flarum\Api\Controller\AbstractSerializeController.

at line 50
ApiController prepareDataQuery(callable|string $callback)

Parameters

callable|string $callback The callback can be a closure or an invokable class, and should accept: - $controller: An instance of this controller.

Return Value

ApiController

at line 72
ApiController prepareDataForSerialization(callable|string $callback)

Parameters

callable|string $callback The callback can be a closure or an invokable class, and should accept: - $controller: An instance of this controller. - $data: Mixed, can be an array of data or an object (like an instance of Collection or AbstractModel). - $request: An instance of \Psr\Http\Message\ServerRequestInterface. - $document: An instance of \Tobscure\JsonApi\Document.</p> <p>The callable should return: - An array of additional data to merge with the existing array. Or a modified $data array.

Return Value

ApiController

at line 86
ApiController setSerializer(string $serializerClass, callable|string|null $callback = null)

Set the serializer that will serialize data for the endpoint.

Parameters

string $serializerClass
callable|string|null $callback

Return Value

ApiController

at line 100
ApiController addInclude(string|array $name, callable|string|null $callback = null)

Include the given relationship by default.

Parameters

string|array $name
callable|string|null $callback

Return Value

ApiController

at line 114
ApiController removeInclude(string|array $name, callable|string|null $callback = null)

Don't include the given relationship by default.

Parameters

string|array $name
callable|string|null $callback

Return Value

ApiController

at line 128
ApiController addOptionalInclude(string|array $name, callable|string|null $callback = null)

Make the given relationship available for inclusion.

Parameters

string|array $name
callable|string|null $callback

Return Value

ApiController

at line 142
ApiController removeOptionalInclude(string|array $name, callable|string|null $callback = null)

Don't allow the given relationship to be included.

Parameters

string|array $name
callable|string|null $callback

Return Value

ApiController

at line 156
ApiController setLimit(int $limit, callable|string|null $callback = null)

Set the default number of results.

Parameters

int $limit
callable|string|null $callback

Return Value

ApiController

at line 170
ApiController setMaxLimit(int $max, callable|string|null $callback = null)

Set the maximum number of results.

Parameters

int $max
callable|string|null $callback

Return Value

ApiController

at line 184
ApiController addSortField(string|array $field, callable|string|null $callback = null)

Allow sorting results by the given field.

Parameters

string|array $field
callable|string|null $callback

Return Value

ApiController

at line 198
ApiController removeSortField(string|array $field, callable|string|null $callback = null)

Disallow sorting results by the given field.

Parameters

string|array $field
callable|string|null $callback

Return Value

ApiController

at line 212
ApiController setSort(array $sort, callable|string|null $callback = null)

Set the default sort order for the results.

Parameters

array $sort
callable|string|null $callback

Return Value

ApiController

at line 219
extend(Container $container, Extension $extension = null)

Parameters

Container $container
Extension $extension