HasOne 类
表示 1 - 1 关系,其中关系的源端仅与目标表中的一个记录相关联,反之亦然。
HasOne 关联的一个例子是用户有一个配置文件。
常量
-
string
MANY_TO_MANY ¶'manyToMany'
多对多关联的关联类型。
-
string
MANY_TO_ONE ¶'manyToOne'
多对一关联的关联类型。
-
string
ONE_TO_MANY ¶'oneToMany'
一对多关联的关联类型。
-
string
ONE_TO_ONE ¶'oneToOne'
一对一关联的关联类型。
-
string
STRATEGY_JOIN ¶'join'
用于使用联接来获取关联记录的策略名称
-
string
STRATEGY_SELECT ¶'select'
用于使用选择来获取关联记录的策略名称
-
string
STRATEGY_SUBQUERY ¶'subquery'
用于使用子查询来获取关联记录的策略名称
属性概要
-
$_bindingKey protected
list<string>|string
拥有方表中用于与外键匹配的字段名称
-
$_cascadeCallbacks protected
bool
是否级联删除也应该触发回调。
-
$_className protected
string
目标表对象的类名
-
$_conditions protected
Closure|array
从目标关联获取记录时始终包含的一组条件
-
$_dependent protected
bool
目标表上的记录是否依赖于源表,通常用于指示如果源表中拥有的记录被删除,应该删除记录。
-
$_finder protected
array|string
用于从目标表获取行时要使用的默认查找器名称,允许使用数组值、查找器名称和默认选项。
-
$_foreignKey protected
list<string>|string|false
表示要加载表的外部键的字段名称
-
$_joinType protected
string
将关联添加到查询时要使用的联接类型
-
$_name protected
string
赋予关联的名称,它通常表示分配给目标关联表的别名
-
$_propertyName protected
string
应该用目标表中的数据填充源表记录的属性名称。
-
$_sourceTable protected
Cake\ORM\Table
源表实例
-
$_strategy protected
string
用于获取关联记录的策略名称。某些关联类型可能没有实现,而是使用一种策略来获取记录。
-
$_tableLocator protected
Cake\ORM\Locator\LocatorInterface|null
表定位器实例
-
$_targetTable protected
Cake\ORM\Table
目标表实例
-
$_validStrategies protected
list<string>
此类型关联的有效策略
-
$defaultTable protected
string|null
此对象的默认表别名。
方法概要
-
__call() public
将方法调用代理到目标表。
-
__construct() public
构造函数。子类可以覆盖 _options 函数以获取如果期望任何其他特殊键则传递的选项的原始列表
-
__get() public
将属性检索代理到目标表。这对于获取此关联的关联很有用
-
__isset() public
将 isset 调用代理到目标表。这对于检查目标表是否具有与传递的名称相同的其他关联很有用
-
_appendFields() protected
用于有条件地将字段追加到查询的 select 子句的辅助函数,这些字段来自另一个查询对象中找到的字段。
-
_appendNotMatching() protected
有条件地将一个条件添加到传递的查询中,这将使它找到与该关联没有匹配项的记录。
-
_bindNewAssociations() protected
将所有可附加的关联应用于
$query
,这些关联来自$surrogate
查询中找到的包含项。 -
_camelize() protected
创建 $name 的驼峰式版本
-
_dispatchBeforeFind() protected
在该关联附加到的查询的目标表上触发 beforeFind
-
_entityName() protected
为指定名称创建适当的实体名称(单数)
-
_extractFinder() protected
用于推断请求的查找器及其选项的辅助方法。
-
_fixtureName() protected
创建夹具名称
-
_formatAssociationResults() protected
如果
$surrogate
查询声明了任何其他格式化程序,则将格式化程序函数添加到传递的$query
中。由于$surrogate
查询对应于关联的目标表,因此生成的格式化程序将是将代理格式化程序应用于仅对应于该表的属性的结果。 -
_joinCondition() protected
返回要追加到生成的联接子句中的单个或多个条件,以获取目标表上的结果。
-
_modelKey() protected
为关联创建适当的下划线模型键
-
_modelNameFromKey() protected
从外键创建适当的模型名称
-
_options() protected
覆盖此函数以初始化任何具体关联类,它将传递构造函数中使用的选项的原始列表
-
_pluginNamespace() protected
返回插件的命名空间
-
_pluginPath() protected
查找插件的正确路径。扫描 $pluginPaths 以查找所需的插件。
-
_pluralHumanName() protected
创建视图中使用的复数人名
-
_propertyName() protected
根据关联名称返回默认属性名称。
-
_singularHumanName() protected
创建视图中使用的单数人名
-
_singularName() protected
创建用于视图的单数名称。
-
_variableName() protected
为视图创建复数变量名称
-
attachTo() public
更改查询对象以在最终结果中包含关联的目标表数据
-
canBeJoined() public
此关联是否可以直接在查询联接中表达
-
cascadeDelete() public
处理级联删除关联模型。
-
defaultRowValue() public
在追加一个用于此关联的属性后,返回修改后的行,该属性具有根据关联是联接还是外部获取的默认空值。
-
deleteAll() public
将删除操作代理到目标
Table::deleteAll()
方法 -
eagerLoader() public
Eager 加载目标表中与源表中另一组记录相关的记录列表。 源记录可以通过两种方式指定:第一种是通过传递一个在源表上设置的 Query 对象,另一种是显式传递源表的主键值数组。
-
exists() public
在附加此关联的默认条件后,将操作代理到目标表的 exists 方法。
-
fetchTable() public
获取表实例的便捷方法。
-
find() public
将查找操作代理到目标表的 find 方法,并根据此关联配置相应地修改查询。
-
getBindingKey() public
获取表示与目标表绑定字段的字段名称。 如果未手动指定,则使用拥有方表的主键。
-
getCascadeCallbacks() public
获取是否应触发级联删除的回调。
-
getClassName() public
获取目标表对象的类名。
-
getConditions() public
获取从目标关联中获取记录时始终包含的条件列表。
-
getDependent() public
设置目标表上的记录是否依赖于源表。
-
getFinder() public
获取用于从目标表中获取行的默认查找器。
-
getForeignKey() public
获取表示目标表的外部键的字段名称。
-
getJoinType() public
获取将关联添加到查询时要使用的联接类型。
-
getName() public
获取此关联的名称,通常是分配给目标关联表的别名。
-
getProperty() public
获取应使用来自目标表的数据填充源表记录中的属性名称。
-
getSource() public
获取关联源端的表实例。
-
getStrategy() public
获取用于获取关联记录的策略名称。 请记住,某些关联类型可能没有实现,但有一个默认策略,这将使对此设置的任何更改无效。
-
getTableLocator() public
获取表定位器。
-
getTarget() public
获取关联目标端的表实例。
-
isOwningSide() public
返回传递的表是否是此关联的拥有方。 这意味着,如果“源”中的行不存在,则“目标”表中的行将丢失重要或必需的信息。
-
requiresKeys() public
如果 eager 加载过程需要一组拥有方表的绑定键才能将其用作查找器查询中的过滤器,则返回 true。
-
saveAssociated() public
获取源表中的实体,并查看是否存在与该关联的属性名称匹配的字段。 通过传递提供的
$options
,将找到的实体保存到此关联的目标表上。 -
setBindingKey() public
设置表示与目标表绑定字段的字段名称。 如果未手动指定,则使用拥有方表的主键。
-
setCascadeCallbacks() public
设置是否应触发级联删除的回调。
-
setClassName() public
设置目标表对象的类名。
-
setConditions() public
设置从目标关联中获取记录时始终包含的条件列表。
-
setDependent() public
设置目标表上的记录是否依赖于源表。
-
setFinder() public
设置用于从目标表中获取行的默认查找器。
-
setForeignKey() public
设置表示目标表的外部键的字段名称。
-
setJoinType() public
设置将关联添加到查询时要使用的联接类型。
-
setProperty() public
设置应使用来自目标表的数据填充源表记录中的属性名称。
-
setSource() public
设置关联源端的表实例。
-
setStrategy() public
设置用于获取关联记录的策略名称。 请记住,某些关联类型可能没有实现,但有一个默认策略,这将使对此设置的任何更改无效。
-
setTableLocator() public
设置表定位器。
-
setTarget() public
设置关联目标端的表实例。
-
transformRow() public
将关联值的結果行正确嵌套到源结果中的正确数组键中。
-
type() public
获取关系类型。
-
updateAll() public
将更新操作代理到目标
Table::updateAll()
方法
方法详细信息
__call() ¶ public
__call(string $method, array $argument): mixed
将方法调用代理到目标表。
参数
-
string
$method 要调用的方法名称
-
array
$argument 传递给函数的参数列表
返回值
mixed
抛出
BadMethodCallException
__construct() ¶ public
__construct(string $alias, array<string, mixed> $options = [])
构造函数。子类可以覆盖 _options 函数以获取如果期望任何其他特殊键则传递的选项的原始列表
参数
-
string
$alias 分配给关联的名称
-
array<string, mixed>
$options optional 要在此对象上设置的属性列表
__get() ¶ public
__get(string $property): self
将属性检索代理到目标表。这对于获取此关联的关联很有用
参数
-
string
$property 属性名称
返回值
self
抛出
RuntimeException
如果不存在具有此名称的关联
__isset() ¶ public
__isset(string $property): bool
将 isset 调用代理到目标表。这对于检查目标表是否具有与传递的名称相同的其他关联很有用
参数
-
string
$property 属性名称
返回值
bool
_appendFields() ¶ protected
_appendFields(Cake\ORM\Query\SelectQuery $query, Cake\ORM\Query\SelectQuery $surrogate, array<string, mixed> $options): void
用于有条件地将字段追加到查询的 select 子句的辅助函数,这些字段来自另一个查询对象中找到的字段。
参数
-
Cake\ORM\Query\SelectQuery
$query 将字段附加到的查询
-
Cake\ORM\Query\SelectQuery
$surrogate 具有要复制的字段的查询
-
array<string, mixed>
$options 传递给
attachTo
方法的选项
返回值
void
_appendNotMatching() ¶ protected
_appendNotMatching(Cake\ORM\Query\SelectQuery $query, array<string, mixed> $options): void
有条件地将一个条件添加到传递的查询中,这将使它找到与该关联没有匹配项的记录。
参数
-
Cake\ORM\Query\SelectQuery
$query 要修改的查询
-
array<string, mixed>
$options 包含
negateMatch
键的选项数组。
返回值
void
_bindNewAssociations() ¶ protected
_bindNewAssociations(Cake\ORM\Query\SelectQuery $query, Cake\ORM\Query\SelectQuery $surrogate, array<string, mixed> $options): void
将所有可附加的关联应用于 $query
,这些关联来自 $surrogate
查询中找到的包含项。
将所有包含的关联从 $surrogate
查询复制到传递的 $query
中。 包含被更改,以便它们尊重其起源的关联链。
参数
-
Cake\ORM\Query\SelectQuery
$query 将关联附加到的查询
-
Cake\ORM\Query\SelectQuery
$surrogate 具有要附加的包含的查询
-
array<string, mixed>
$options 传递给
attachTo
方法的选项
返回值
void
_camelize() ¶ protected
_camelize(string $name): string
创建 $name 的驼峰式版本
参数
-
string
$name name
返回值
string
_dispatchBeforeFind() ¶ protected
_dispatchBeforeFind(Cake\ORM\Query\SelectQuery $query): void
在该关联附加到的查询的目标表上触发 beforeFind
参数
-
Cake\ORM\Query\SelectQuery
$query 此关联正在附加到的查询
返回值
void
_entityName() ¶ protected
_entityName(string $name): string
为指定名称创建适当的实体名称(单数)
参数
-
string
$name Name
返回值
string
_extractFinder() ¶ protected
_extractFinder(array|string $finderData): array
用于推断请求的查找器及其选项的辅助方法。
返回从查找器 $type 推断的选项。
示例
以下将使用查找器的值为选项调用查找器“translations”: $query->contain(['Comments' => ['finder' => ['translations']]]); $query->contain(['Comments' => ['finder' => ['translations' => []]]]); $query->contain(['Comments' => ['finder' => ['translations' => ['locales' => ['en_US']]]]]);
参数
-
array|string
$finderData 查找器名称或一个数组,该数组以名称为键,选项为值。
返回值
array
_fixtureName() ¶ protected
_fixtureName(string $name): string
创建夹具名称
参数
-
string
$name 模型类名称
返回值
string
_formatAssociationResults() ¶ protected
_formatAssociationResults(Cake\ORM\Query\SelectQuery $query, Cake\ORM\Query\SelectQuery $surrogate, array<string, mixed> $options): void
如果 $surrogate
查询声明了任何其他格式化程序,则将格式化程序函数添加到传递的 $query
中。由于 $surrogate
查询对应于关联的目标表,因此生成的格式化程序将是将代理格式化程序应用于仅对应于该表的属性的结果。
参数
-
Cake\ORM\Query\SelectQuery
$query 将应用格式化程序的查询
-
Cake\ORM\Query\SelectQuery
$surrogate 对关联目标表具有格式化程序的查询。
-
array<string, mixed>
$options 传递给
attachTo
方法的选项
返回值
void
_joinCondition() ¶ protected
_joinCondition(array<string, mixed> $options): array
返回要追加到生成的联接子句中的单个或多个条件,以获取目标表上的结果。
参数
-
array<string, mixed>
$options 传递给 attachTo 方法的选项列表
返回值
array
抛出
Cake\Database\Exception\DatabaseException
如果外键中的列数与源表主键中的列数不匹配
_modelKey() ¶ protected
_modelKey(string $name): string
为关联创建适当的下划线模型键
如果输入包含点,则假设右侧是真正的表名。
参数
-
string
$name 模型类名称
返回值
string
_modelNameFromKey() ¶ protected
_modelNameFromKey(string $key): string
从外键创建适当的模型名称
参数
-
string
$key 外键
返回值
string
_options() ¶ protected
_options(array<string, mixed> $options): void
覆盖此函数以初始化任何具体关联类,它将传递构造函数中使用的选项的原始列表
参数
-
array<string, mixed>
$options 用于初始化的选项列表
返回值
void
_pluginNamespace() ¶ protected
_pluginNamespace(string $pluginName): string
返回插件的命名空间
参数
-
string
$pluginName 插件名称
返回值
string
_pluginPath() ¶ protected
_pluginPath(string $pluginName): string
查找插件的正确路径。扫描 $pluginPaths 以查找所需的插件。
参数
-
string
$pluginName 要使用的插件的名称,例如 DebugKit
返回值
string
_pluralHumanName() ¶ protected
_pluralHumanName(string $name): string
创建视图中使用的复数人名
参数
-
string
$name 控制器名称
返回值
string
_singularHumanName() ¶ protected
_singularHumanName(string $name): string
创建视图中使用的单数人名
参数
-
string
$name 控制器名称
返回值
string
_singularName() ¶ protected
_singularName(string $name): string
创建用于视图的单数名称。
参数
-
string
$name 要使用的名称
返回值
string
_variableName() ¶ protected
_variableName(string $name): string
为视图创建复数变量名称
参数
-
string
$name 要使用的名称
返回值
string
attachTo() ¶ public
attachTo(Cake\ORM\Query\SelectQuery $query, array<string, mixed> $options = []): void
更改查询对象以在最终结果中包含关联的目标表数据
选项数组接受以下键
- includeFields: 是否在结果中包含目标模型字段
- foreignKey: 用作外键的字段名称,如果为 false,则不使用任何字段
- conditions: 包含要过滤连接的条件列表的数组,这将与最初为该关联配置的任何条件合并
- fields: 要包含在结果中的目标表中的字段列表
- aliasPath: 一个点分隔的字符串,表示从传递的查询主表到该关联的关联名称路径。
- propertyPath: 一个点分隔的字符串,表示从传递的查询主实体到该关联的关联属性路径
- joinType: 要在查询中使用的 SQL 连接类型。
- negateMatch: 将一个条件附加到传递的查询以排除与该关联匹配的记录。
参数
-
Cake\ORM\Query\SelectQuery
$query 要更改以包含目标表数据的查询
-
array<string, mixed>
$options optional 要考虑的任何额外选项或覆盖
返回值
void
抛出
RuntimeException
无法构建查询或关联。
canBeJoined() ¶ public
canBeJoined(array<string, mixed> $options = []): bool
此关联是否可以直接在查询联接中表达
参数
-
array<string, mixed>
$options optional 可以更改返回值的自定义选项键
返回值
bool
cascadeDelete() ¶ public
cascadeDelete(Cake\Datasource\EntityInterface $entity, array<string, mixed> $options = []): bool
处理级联删除关联模型。
每个实现类都应该根据需要处理级联删除。
参数
-
Cake\Datasource\EntityInterface
$entity -
array<string, mixed>
$options optional
返回值
bool
defaultRowValue() ¶ public
defaultRowValue(array<string, mixed> $row, bool $joined): array<string, mixed>
在追加一个用于此关联的属性后,返回修改后的行,该属性具有根据关联是联接还是外部获取的默认空值。
参数
-
array<string, mixed>
$row 要设置默认值的行的内容。
-
bool
$joined 该行是否是与该关联的直接连接的结果
返回值
array<string, mixed>
deleteAll() ¶ public
deleteAll(Cake\Database\Expression\QueryExpressionClosure|array|string|null $conditions): int
将删除操作代理到目标 Table::deleteAll()
方法
参数
-
Cake\Database\Expression\QueryExpressionClosure|array|string|null
$conditions 要使用的条件,接受 Query::where() 可以接受的任何内容。
返回值
int
另请参见
eagerLoader() ¶ public
eagerLoader(array<string, mixed> $options): Closure
Eager 加载目标表中与源表中另一组记录相关的记录列表。 源记录可以通过两种方式指定:第一种是通过传递一个在源表上设置的 Query 对象,另一种是显式传递源表的主键值数组。
传递相关源记录的必要方式由 "strategy" 控制。当使用子查询策略时,它将需要对源表进行查询。当使用 select 策略时,将使用主键列表。
返回一个闭包,该闭包应针对特定 Query 中返回的每个记录运行。此可调用对象将负责注入与每个传递的行相关的字段。
选项数组接受以下键
- query: 设置为查找源表记录的 SelectQuery 对象
- keys: 来自源表的键值列表
- foreignKey: 用于关联两个表的字段名称
- conditions: 要传递给查询 where() 方法的条件列表
- sort: 返回记录的方向
- fields: 要从目标表中选择的字段列表
- contain: 要急切加载与目标表关联的相关表的列表
- strategy: 用于查找目标表记录的策略名称
- nestKey: 当转换行时将在其中找到结果的数组键
参数
-
array<string, mixed>
$options
返回值
Closure
exists() ¶ public
exists(Cake\Database\ExpressionInterfaceClosure|array|string|null $conditions): bool
在附加此关联的默认条件后,将操作代理到目标表的 exists 方法。
参数
-
Cake\Database\ExpressionInterfaceClosure|array|string|null
$conditions 用于检查是否有任何记录匹配的条件。
返回值
bool
另请参见
fetchTable() ¶ public
fetchTable(string|null $alias = null, array<string, mixed> $options = []): Cake\ORM\Table
获取表实例的便捷方法。
参数
-
string|null
$alias optional 要获取的别名。应使用驼峰命名法。如果为 `null`,则使用 `$defaultTable` 属性的值。
-
array<string, mixed>
$options optional 要使用这些选项来构建表。如果表已被加载,则注册表选项将被忽略。
返回值
Cake\ORM\Table
抛出
Cake\Core\Exception\CakeException
如果 `$alias` 参数和 `$defaultTable` 属性均为 `null`。
另请参见
find() ¶ public
find(array<string, mixed>|string|null $type = null, mixed ...$args): Cake\ORM\Query\SelectQuery
将查找操作代理到目标表的 find 方法,并根据此关联配置相应地修改查询。
参数
-
array<string, mixed>|string|null
$type optional 要执行的查询类型,如果传递的是数组,则将解释为 `$args` 参数
-
mixed
...$args 与查找器特定参数相匹配的参数
返回值
Cake\ORM\Query\SelectQuery
另请参见
getBindingKey() ¶ public
getBindingKey(): list<string>|string
获取表示与目标表绑定字段的字段名称。 如果未手动指定,则使用拥有方表的主键。
返回值
list<string>|string
getConditions() ¶ public
getConditions(): Closure|array
获取从目标关联中获取记录时始终包含的条件列表。
返回值
Closure|array
另请参见
getForeignKey() ¶ public
getForeignKey(): list<string>|string|false
获取表示目标表的外部键的字段名称。
返回值
list<string>|string|false
getStrategy() ¶ public
getStrategy(): string
获取用于获取关联记录的策略名称。 请记住,某些关联类型可能没有实现,但有一个默认策略,这将使对此设置的任何更改无效。
返回值
string
getTableLocator() ¶ public
getTableLocator(): Cake\ORM\Locator\LocatorInterface
获取表定位器。
返回值
Cake\ORM\Locator\LocatorInterface
isOwningSide() ¶ public
isOwningSide(Cake\ORM\Table $side): bool
返回传递的表是否是此关联的拥有方。 这意味着,如果“源”中的行不存在,则“目标”表中的行将丢失重要或必需的信息。
参数
-
Cake\ORM\Table
$side 拥有关系的潜在表格
返回值
bool
requiresKeys() ¶ public
requiresKeys(array<string, mixed> $options = []): bool
如果 eager 加载过程需要一组拥有方表的绑定键才能将其用作查找器查询中的过滤器,则返回 true。
参数
-
array<string, mixed>
$options optional 包含要使用的策略的选项。
返回值
bool
saveAssociated() ¶ public
saveAssociated(Cake\Datasource\EntityInterface $entity, array<string, mixed> $options = []): Cake\Datasource\EntityInterface|false
获取源表中的实体,并查看是否存在与该关联的属性名称匹配的字段。 通过传递提供的 $options
,将找到的实体保存到此关联的目标表上。
参数
-
Cake\Datasource\EntityInterface
$entity 源表中的实体
-
array<string, mixed>
$options optional 要传递给目标表保存方法的选项
返回值
Cake\Datasource\EntityInterface|false
另请参见
setBindingKey() ¶ public
setBindingKey(list<string>|string $key): $this
设置表示与目标表绑定字段的字段名称。 如果未手动指定,则使用拥有方表的主键。
参数
-
list<string>|string
$key 用于将两个表格链接在一起的表格字段或字段
返回值
$this
setCascadeCallbacks() ¶ public
setCascadeCallbacks(bool $cascadeCallbacks): $this
设置是否应触发级联删除的回调。
参数
-
bool
$cascadeCallbacks 级联回调切换值
返回值
$this
setClassName() ¶ public
setClassName(string $className): $this
设置目标表对象的类名。
参数
-
string
$className 要设置的类名。
返回值
$this
抛出
InvalidArgumentException
如果在解析目标表后设置类名,并且它与目标表的类名不匹配。
setConditions() ¶ public
setConditions(Closure|array $conditions): $this
设置从目标关联中获取记录时始终包含的条件列表。
参数
-
Closure|array
$conditions 要使用的条件列表
返回值
$this
另请参见
setDependent() ¶ public
setDependent(bool $dependent): $this
设置目标表上的记录是否依赖于源表。
这主要用于表明如果源表中拥有记录被删除,则应删除记录。
如果未传递参数,则返回当前设置。
参数
-
bool
$dependent 设置依赖模式。使用 null 读取当前状态。
返回值
$this
setFinder() ¶ public
setFinder(array|string $finder): $this
设置用于从目标表中获取行的默认查找器。
参数
-
array|string
$finder 要使用的查找器名称或查找器名称和选项数组。
返回值
$this
setForeignKey() ¶ public
setForeignKey(list<string>|string|false $key): $this
设置表示目标表的外部键的字段名称。
参数
-
list<string>|string|false
$key 用于将两个表格链接在一起的键或键,如果设置为
false
,则不会自动生成连接条件。
返回值
$this
setJoinType() ¶ public
setJoinType(string $type): $this
设置将关联添加到查询时要使用的联接类型。
参数
-
string
$type 要使用的连接类型(例如 INNER)
返回值
$this
setProperty() ¶ public
setProperty(string $name): $this
设置应使用来自目标表的数据填充源表记录中的属性名称。
参数
-
string
$name 关联属性的名称。使用 null 读取当前值。
返回值
$this
setSource() ¶ public
setSource(Cake\ORM\Table $table): $this
设置关联源端的表实例。
参数
-
Cake\ORM\Table
$table 要分配为源端的实例
返回值
$this
setStrategy() ¶ public
setStrategy(string $name): $this
设置用于获取关联记录的策略名称。 请记住,某些关联类型可能没有实现,但有一个默认策略,这将使对此设置的任何更改无效。
参数
-
string
$name 策略类型。使用 null 读取当前值。
返回值
$this
抛出
InvalidArgumentException
当提供无效的策略时。
setTableLocator() ¶ public
setTableLocator(Cake\ORM\Locator\LocatorInterface $tableLocator): $this
设置表定位器。
参数
-
Cake\ORM\Locator\LocatorInterface
$tableLocator LocatorInterface 实例。
返回值
$this
setTarget() ¶ public
setTarget(Cake\ORM\Table $table): $this
设置关联目标端的表实例。
参数
-
Cake\ORM\Table
$table 要分配为目标端的实例
返回值
$this
transformRow() ¶ public
transformRow(array<string, mixed> $row, string $nestKey, bool $joined, string|null $targetProperty = null): array
将关联值的結果行正确嵌套到源结果中的正确数组键中。
参数
-
array<string, mixed>
$row 要转换的行
-
string
$nestKey 此关联结果应在其中找到的数组键
-
bool
$joined 该行是否是与该关联的直接连接的结果
-
string|null
$targetProperty 可选 源结果中关联数据应嵌套其中的属性名称。如果没有提供,将使用默认值。
返回值
array
updateAll() ¶ public
updateAll(Cake\Database\Expression\QueryExpressionClosure|array|string $fields, Cake\Database\Expression\QueryExpressionClosure|array|string|null $conditions): int
将更新操作代理到目标 Table::updateAll()
方法
参数
-
Cake\Database\Expression\QueryExpressionClosure|array|string
$fields 字段 => 新值的哈希。
-
Cake\Database\Expression\QueryExpressionClosure|array|string|null
$conditions 要使用的条件,接受任何 Query::where()
返回值
int