W3cubDocs

/CakePHP 4.1

Class SaveOptionsBuilder

OOP style Save Option Builder.

This allows you to build options to save entities in a OOP style and helps you to avoid mistakes by validating the options as you build them.

Namespace: Cake\ORM

Properties summary

  • $_options protected
    array

    Options

  • $_table protected
    \Cake\ORM\Table

    Table object.

Method Summary

Method Detail

__construct() public

__construct(\Cake\ORM\Table $table, array $options)

Constructor.

Parameters

\Cake\ORM\Table $table

A table instance.

array $options optional

Options to parse when instantiating.

_associated() protected

_associated(\Cake\ORM\Table $table, array $associations)

Checks that the associations exists recursively.

Parameters

\Cake\ORM\Table $table

Table object.

array $associations

An associations array.

_checkAssociation() protected

_checkAssociation(\Cake\ORM\Table $table, string $association)

Checks if an association exists.

Parameters

\Cake\ORM\Table $table

Table object.

string $association

Association name.

Throws

RuntimeException
If no such association exists for the given table.

_normalizeAssociations() protected

_normalizeAssociations(mixed $associations)

Returns an array out of the original passed associations list where dot notation is transformed into nested arrays so that they can be parsed by other routines

Parameters

array|string $associations

The array of included associations.

Returns

array

An array having dot notation transformed into nested arrays

associated() public

associated(mixed $associated)

Set associated options.

Parameters

string|array $associated

String or array of associations.

Returns

$this

atomic() public

atomic(bool $atomic)

Sets the atomic option.

Parameters

bool $atomic

Atomic or not.

Returns

$this

checkExisting() public

checkExisting(bool $checkExisting)

Set check existing option.

Parameters

bool $checkExisting

Guard the properties or not.

Returns

$this

checkRules() public

checkRules(bool $checkRules)

Option to check the rules.

Parameters

bool $checkRules

Check the rules or not.

Returns

$this

guard() public

guard(bool $guard)

Set the guard option.

Parameters

bool $guard

Guard the properties or not.

Returns

$this

parseArrayOptions() public

parseArrayOptions(array $array)

Takes an options array and populates the option object with the data.

This can be used to turn an options array into the object.

Parameters

array $array

Options array.

Returns

$this

Throws

InvalidArgumentException
If a given option key does not exist.

set() public

set(string $option, mixed $value)

Setting custom options.

Parameters

string $option

Option key.

mixed $value

Option value.

Returns

$this

toArray() public

toArray()

Returns

array

validate() public

validate(string $validate)

Set the validation rule set to use.

Parameters

string $validate

Name of the validation rule set to use.

Returns

$this

Property Detail

$_options protected

Options

Type

array

$_table protected

Table object.

Type

\Cake\ORM\Table

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.1/class-Cake.ORM.SaveOptionsBuilder.html