Documentation

VehicleLocationRepository extends Repository

Table of Contents

PAGINATION_LIMIT  = 15
RESPONSE_STATUS_ERROR  = 'error'
RESPONSE_STATUS_FAIL  = 'fail'
RESPONSE_STATUS_SUCCESS  = 'success'
$agencyRepo  : mixed
$model  : mixed
Model var
$repo  : mixed
Repo vars
__construct()  : mixed
all()  : array<string|int, mixed>
Get all instances of model
allChild()  : array<string|int, mixed>
cleanNullValues()  : null
Change null values and put string("")
create()  : object
Create a new record in the database
delete()  : bool
It soft-deletes a record from the database
deleteChild()  : null
ensureHttp400Code()  : string
Return a extension from mimetype
firstOrCreate()  : object
Retrieves first element of the database. If it doesn't exists, it creates it before returning it.
firstOrNew()  : object
Retrieves first element of the database. If it doesn't exists, it instanciates it before returning it.
forceDelete()  : bool
It definitely removes a record from the database
getConcatString()  : string
Concatenate string to make it compatible with SQLite
getErrorResponse()  : array<string|int, mixed>
Return all an array of errors like validation in one format
getFailResponse()  : array<string|int, mixed>
Return all an array of errors like validation in one format
getModel()  : Model
Get the associated model
getSuccessResponse()  : array<string|int, mixed>
Return all an array of errors like validation in one format
indexByState()  : array<string|int, mixed>
indexWithoutState()  : array<string|int, mixed>
microsecondsToSeconds()  : array<string|int, mixed>
Return all an array of errors like validation in one format
mime2ext()  : string
Return a extension from mimetype
orderQuery()  : null
Destroy record from the database
paginate()  : Model
publicIndexByState()  : array<string|int, mixed>
publicIndexWithoutState()  : array<string|int, mixed>
sendMail()  : bool
Send an email
setModel()  : mixed
Set the associated model
show()  : object
Show the record with the given id
showChild()  : VehicleLocation
showWith()  : Model
Eager load database relationships
storeChild()  : VehicleLocation
update()  : object
Updates a record in the database
updateChild()  : VehicleLocation
checkDifferentDestination()  : bool
checkVat()  : int

Constants

PAGINATION_LIMIT

public mixed PAGINATION_LIMIT = 15

RESPONSE_STATUS_ERROR

public mixed RESPONSE_STATUS_ERROR = 'error'

RESPONSE_STATUS_FAIL

public mixed RESPONSE_STATUS_FAIL = 'fail'

RESPONSE_STATUS_SUCCESS

public mixed RESPONSE_STATUS_SUCCESS = 'success'

Properties

Methods

all()

Get all instances of model

public all() : array<string|int, mixed>
Return values
array<string|int, mixed> —

allChild()

public allChild(int $parent_id) : array<string|int, mixed>
Parameters
$parent_id : int
  • Id of the parent object (agency) which we want to get its car rental offices.
Tags
desc

Return all Car Rental Office related to the agency received

Return values
array<string|int, mixed> —

of Car rental Offices related to the agency given

cleanNullValues()

Change null values and put string("")

public cleanNullValues(array<string|int, mixed> &$data[, array<string|int, mixed> $exceptions = [] ]) : null
Parameters
$data : array<string|int, mixed>
  • Array with parameters
$exceptions : array<string|int, mixed> = []
  • Array with exceptions keys
Return values
null —

create()

Create a new record in the database

public create(array<string|int, mixed> $data) : object
Parameters
$data : array<string|int, mixed>
  • Data of the object that we want to create.
Tags
throws
Exception
Return values
object —

delete()

It soft-deletes a record from the database

public delete(array<string|int, mixed> $data, int $id) : bool
Parameters
$data : array<string|int, mixed>
$id : int
  • Id of the object that we want to remove.
Tags
throws
Exception
Return values
bool —
  • Success or fail

deleteChild()

public deleteChild(array<string|int, mixed> $data, int $parent_id, int $id) : null
Parameters
$data : array<string|int, mixed>
  • Has the delete confirm field.
$parent_id : int
  • Id of the parent object (Agency) that we want to delete.
$id : int
  • Id of the object (VehicleLocation) that we want to delete.
Tags
desc

Delete record (Car Rental Office) from the database matching id received

Return values
null —
  • if everything goes fine.

ensureHttp400Code()

Return a extension from mimetype

public ensureHttp400Code(mixed $code) : string
Parameters
$code : mixed
Return values
string —

firstOrCreate()

Retrieves first element of the database. If it doesn't exists, it creates it before returning it.

public firstOrCreate(array<string|int, mixed> $data) : object
Parameters
$data : array<string|int, mixed>
  • Data of the object that we want to create.
Tags
throws
Exception
Return values
object —

firstOrNew()

Retrieves first element of the database. If it doesn't exists, it instanciates it before returning it.

public firstOrNew(array<string|int, mixed> $data) : object
Parameters
$data : array<string|int, mixed>
  • Data of the object that we want to create.
Tags
throws
Exception
Return values
object —

forceDelete()

It definitely removes a record from the database

public forceDelete(array<string|int, mixed> $data, int $id) : bool
Parameters
$data : array<string|int, mixed>
$id : int
  • Id of the object that we want to remove.
Tags
throws
Exception
Return values
bool —
  • Success or fail

getConcatString()

Concatenate string to make it compatible with SQLite

public getConcatString( $firstField,  $secondField[,  $concatCharacter = ' ' ]) : string
Parameters
$firstField :

to concat

$secondField :

to concat

$concatCharacter : = ' '

Character used to join fields, default is space

Return values
string —

getErrorResponse()

Return all an array of errors like validation in one format

public getErrorResponse(mixed $message[, mixed $code = null ]) : array<string|int, mixed>
Parameters
$message : mixed
$code : mixed = null
Return values
array<string|int, mixed> —

getFailResponse()

Return all an array of errors like validation in one format

public getFailResponse(array<string|int, mixed> $data) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed>
  • Array with parameters
Return values
array<string|int, mixed> —

getModel()

Get the associated model

public getModel() : Model
Return values
Model —

$model - A specific model

getSuccessResponse()

Return all an array of errors like validation in one format

public getSuccessResponse([array<string|int, mixed> $data = "" ]) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed> = ""
  • Array with parameters
Return values
array<string|int, mixed> —

indexByState()

public indexByState(array<string|int, mixed> $data, int|array<string|int, mixed> $agency, int $state_id) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed>
  • Has optional parameters for search.
$agency : int|array<string|int, mixed>
  • Type depends on input (public: array, private: int)
$state_id : int
  • Id of the state wich we want to get their VehicleLocations.
Tags
desc

Return car rental offices related to Agency given, filtered by state

Return values
array<string|int, mixed> —

of VehicleLocation

indexWithoutState()

public indexWithoutState(array<string|int, mixed> $data, mixed $agency) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed>
$agency : mixed
Tags
desc

Return all Car Rental Office related to the agency received

Return values
array<string|int, mixed> —

of Car rental Offices related to the agency given

microsecondsToSeconds()

Return all an array of errors like validation in one format

public microsecondsToSeconds(mixed $microseconds) : array<string|int, mixed>
Parameters
$microseconds : mixed
Return values
array<string|int, mixed> —

mime2ext()

Return a extension from mimetype

public mime2ext(string $mime) : string
Parameters
$mime : string
  • String with mimetype
Return values
string —

orderQuery()

Destroy record from the database

public orderQuery(mixed &$query, array<string|int, mixed> $params) : null
Parameters
$query : mixed
$params : array<string|int, mixed>
  • Array with the pagination params
Return values
null —

paginate()

public paginate(mixed $paginationLimit) : Model
Parameters
$paginationLimit : mixed
Tags
desc

Get items with pagination

Return values
Model —

$model - N instances of mode

publicIndexByState()

public publicIndexByState(array<string|int, mixed> $data, int $state_id) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed>
  • Has optional parameter for searching - opened_at
$state_id : int
  • Id of the state wich we want to get their VehicleLocations..
Tags
desc

Return car rental offices related to Agency given (through access token) filtered by state

Return values
array<string|int, mixed> —

of VehicleLocation

publicIndexWithoutState()

public publicIndexWithoutState(array<string|int, mixed> $data) : array<string|int, mixed>
Parameters
$data : array<string|int, mixed>
  • Data received for the object that we want to create.
Tags
desc

Return all Car Rental Office related to the agency received

Return values
array<string|int, mixed> —

of Car rental Offices related to the agency given

sendMail()

Send an email

public sendMail( $mail, string $toEmail[, string $bccEmail = null ]) : bool
Parameters
$mail :
  • Mailable extended class to send
$toEmail : string
  • Delivery address
$bccEmail : string = null
  • Black carbon copy address
Return values
bool —

setModel()

Set the associated model

public setModel(Model $model) : mixed
Parameters
$model : Model
  • A specific model
Return values
mixed —

show()

Show the record with the given id

public show(int $id) : object
Parameters
$id : int
  • Id of the object that we want to show.
Return values
object —

showChild()

public showChild(int $parent_id, int $id) : VehicleLocation
Parameters
$parent_id : int
  • Id of the parent object (Agency) which we want to show.
$id : int
  • Id of the object (VehicleLocation) which we want to show.
Tags
desc

Shows the VehicleLocation with the given id

Return values
VehicleLocation —
  • instance to be shown

showWith()

Eager load database relationships

public showWith(mixed $id, string $relations) : Model
Parameters
$id : mixed
$relations : string
  • A name of relations to add
Return values
Model —

$model - A specific model

storeChild()

public storeChild(array<string|int, mixed> $data, int $parent_id) : VehicleLocation
Parameters
$data : array<string|int, mixed>
  • Data received for the object that we want to create.
$parent_id : int
  • Id of the parent object (agency) which we want to create.
Tags
desc

Create a new record of Car Rental Office in the database

Return values
VehicleLocation —
  • instance created and stored in DB

update()

Updates a record in the database

public update(array<string|int, mixed> $data, int $id) : object
Parameters
$data : array<string|int, mixed>
  • Datas of the object that we want to update.
$id : int
  • Id of the object that we want to update.
Tags
throws
Exception
Return values
object —

updateChild()

public updateChild(array<string|int, mixed> $data, int $parent_id, int $id) : VehicleLocation
Parameters
$data : array<string|int, mixed>
  • Data received for the object that we want to update.
$parent_id : int
  • Id of the parent object (Agency) that we want to update.
$id : int
  • Id of the object (VehicleLocation) that we want to update.
Tags
desc

Updates the VehicleLocation with the given id in database

Return values
VehicleLocation —
  • instance to be updated with its new values

checkDifferentDestination()

private checkDifferentDestination(array<string|int, mixed> $data) : bool
Parameters
$data : array<string|int, mixed>
  • Data needed to verify. (different_return)
Tags
desc

Verifies if returning VehicleLocation is different than the picking up one

Return values
bool —
  • true if VehicleLocations are different.

checkVat()

private checkVat(array<string|int, mixed> $data) : int
Parameters
$data : array<string|int, mixed>
  • Data needed to retrieve vat. (vat_included - optional and office_id)
Tags
desc

Return vat from VehicleLocation

Return values
int —
  • vat value

Search results