Joomla! API

下载
启动

CoreContent

继承自 Table 实现 CurrentUserInterface

核心内容表

自

3.1
包

Joomla CMS

方法

__construct

构造函数

__construct(\Joomla\Database\DatabaseDriver db, \Joomla\Event\DispatcherInterface dispatcher = null) :
自

3.1

参数

db

DatabaseDriver数据库连接器对象

dispatcher

DispatcherInterface|null此表的事件分发器

响应

混合

_getAssetName

计算资源默认名称的方法。

_getAssetName() :
继承

默认名称格式为 table_name.id，其中 id 是表主键的值。

自

1.7.0

响应

字符串

_getAssetParentId

获取要注册此资源的父资源的方法。

_getAssetParentId(\Joomla\CMS\Table\Table table = null,  id = null) :
继承

默认情况下，所有资源都注册到具有 ID 的 ROOT 节点，如果不存在，则默认为 1。扩展类可以定义一个表和 ID 来查找。如果资源不存在，则会创建它。

自

1.7.0

参数

表

Table资源父级的 Table 对象。

id

int要查找的 ID

响应

int

_getAssetTitle

返回用于资源表的标题的方法。

_getAssetTitle() :
继承

在跟踪资源时，每个资源都会保留一个标题，以便在统一的访问管理器中提供一些上下文。通常，这只会返回 $this->title 或 $this->name 或者用于行主要名称的任何内容。如果未重写此方法，则使用资源名称。

自

1.7.0

响应

string在资源表中用作标题的字符串。

_lock

锁定数据库表以进行写入的方法。

_lock() :
继承
自

1.7.0
抛出

RuntimeException

响应

bool成功时为真。

_unlock

解锁数据库表以进行写入的方法。

_unlock() :
继承
自

1.7.0

响应

bool成功时为真。

addIncludePath

添加 Table 应在其中搜索表类文件的系统路径。

addIncludePath(array|string path = null) : mixed||string|int
继承 static 已弃用
自

1.7.0
已弃用

4.3 将在 6.0 中删除 不应再使用，因为表是通过 MvcFactory 加载的

参数

路径

array<string|int, mixed>|string要添加的系统路径或系统路径数组。

响应

array<string|int, mixed>在其中查找 Table 类的系统路径数组。

appendPrimaryKeys

将此表的主键附加到查询的方法。

appendPrimaryKeys(\Joomla\Database\DatabaseQuery query,  pk = null) :
继承
自

3.1.4

参数

查询

DatabaseQuery要附加的查询对象。

pk

mixed可选的主键参数。

响应

void

bind

将关联数组或对象绑定到 Table 实例的方法。此方法仅绑定公开可访问的属性，并可选地接受一个属性数组，这些属性在绑定时将被忽略。

bind(array|object src, array|string ignore = []) :
继承
自

1.7.0
抛出

InvalidArgumentException

参数

src

array<string|int, mixed>|object要绑定到 Table 实例的关联数组或对象。

ignore

array<string|int, mixed>|string要忽略的属性的可选数组或空格分隔列表。

响应

bool成功时为真。

check

重载的 check 函数

check() :
参见 Table::check()
自

3.1

响应

bool成功时为真，失败时为假

checkIn

检查如果存在必要的属性/字段，则检查一行。

checkIn( pk = null) :
继承

检查一行将允许其他用户编辑该行。

自

1.7.0
抛出

UnexpectedValueException

参数

pk

mixed要签出的可选主键值。如果未设置，则使用实例属性值。

响应

bool成功时为真。

checkOut

如果存在必要的属性/字段，则检查一行的方法。

checkOut( userId,  pk = null) :
继承

为了防止在数据库中编辑行时出现竞争条件，如果字段 'checked_out' 和 'checked_out_time' 可用，则可以检查一行。当一行被签出时，任何用户（除签出该行的人以外）尝试存储该行的尝试都应保留，直到该行再次签入。

自

1.7.0
抛出

UnexpectedValueException

参数

userId

int签出该行的用户的 ID。

pk

mixed要签出的可选主键值。如果未设置，则使用实例属性值。

响应

bool成功时为真。

def

如果尚未分配，则设置默认值

def( property,  default = null) :
继承 已弃用
自

1.7.0
已弃用

4.3.0 将在 6.0 中删除 不应再使用定义动态属性

参数

属性

string属性的名称。

默认

mixed默认值。

响应

混合

delete

覆盖 \Joomla\CMS\Table\Table delete 方法以包括从 #__ucm_base 删除对应行的操作。

delete( pk = null) :
自

3.1
抛出

UnexpectedValueException

参数

pk

int要删除的主键值。必须设置，否则会抛出异常。

响应

bool成功时为真。

deleteByContentId

从 #__ucm_content 表中按 content_item_id 删除一行的方法。

deleteByContentId( contentItemId = null,  typeAlias = null) :
自

3.1
抛出

UnexpectedValueException

参数

contentItemId

int要删除的 core_content_item_id 的值。对应于内容表的主键。

typeAlias

string内容类型的别名

响应

bool成功时为真。

get

返回对象的属性或如果未设置该属性则返回默认值。

get( property,  default = null) :
继承 已弃用
自

1.7.0
参见 CMSObject::getProperties()
已弃用

4.3.0 将在 6.0 中删除 为该属性创建一个合适的 getter 函数

参数

属性

string属性的名称。

默认

mixed默认值。

响应

mixed属性的值。

getColumnAlias

返回“特殊”列的真实名称的方法，例如排序、命中率、已发布等等。这样，您就可以自由地遵循您的数据库命名约定并使用内置的 \Joomla 函数。

getColumnAlias( column) :
继承
自

3.4

参数

列

string“特殊”列的名称（例如排序、命中率）

响应

string识别特殊的字符串

getCurrentUser

返回当前用户，如果未设置，则返回全局应用程序的身份。这将在 6.0 中更改，并将返回空用户。

getCurrentUser() : \Joomla\CMS\User\User
继承
自

4.2.0

响应

用户

getDbo

获取 DatabaseDriver 对象的方法。

getDbo() : \Joomla\Database\DatabaseDriver
继承
自

1.7.0

响应

DatabaseDriver内部数据库驱动程序对象。

getError

获取最新的错误消息。

getError( i = null,  toString = true) :
继承 已弃用
自

1.7.0
已弃用

3.1.4 将在 6.0 中删除 将在没有替换的情况下删除 捕获抛出的异常而不是 getError

参数

i

int可选的错误索引。

toString

bool指示 Exception 对象是否应返回其错误消息。

响应

string错误消息

getErrors

返回所有错误（如果有）。

getErrors() : mixed||string|int
继承 已弃用
自

1.7.0
已弃用

3.1.4 将在 6.0 中删除 将在没有替换的情况下删除 捕获抛出的异常而不是 getErrors

响应

array<string|int, mixed>错误消息数组。

getFields

从数据库表获取列。

getFields( reload = false) :
继承
自

1.7.0
抛出

UnexpectedValueException

参数

reload

bool重新加载缓存的标志

响应

mixed字段名称数组，如果发生错误则为 false。

getId

返回此记录的身份（主键）值

getId() :
继承
自

4.0.0

响应

混合

getInstance

静态方法，用于在表包含路径中找到 Table 类时获取该类的实例。

getInstance( type,  prefix = 'JTable', mixed||string|int config = []) : \Joomla\CMS\Table\Table|bool
继承 static 已弃用

要添加用于搜索 Table 类的包含路径，请参见 Table::addIncludePath()。

自

1.7.0
已弃用

4.3 将在 6.0 中删除 使用 MvcFactory 代替 示例：Factory::getApplication()->bootComponent('...')->getMVCFactory()->createTable($name, $prefix, $config);

参数

类型

string要获取实例的 Table 类的类型（名称）。

前缀

stringTable 类名称的可选前缀。

配置

array<string|int, mixed>Table 对象的可选配置值数组。

响应

Table|bool如果找到则为 Table 对象，如果失败则为布尔值 false。

getKeyName

获取表的主键字段名称的方法。

getKeyName( multiple = false) :
继承
自

1.7.0

参数

多个

bool为 true 表示返回所有主键（作为数组），为 false 表示仅返回第一个主键（作为字符串）。

响应

mixed主键字段名称数组或包含第一个主键字段的字符串。

getNextOrder

获取由 SQL WHERE 子句定义的一组行的下一个排序值的方法。

getNextOrder( where = '') :
继承

这对于将新项目放置在表中一组项目的最后很有用。

自

1.7.0
抛出

UnexpectedValueException

参数

哪里

string用于选择表中 MAX(ordering) 的 WHERE 子句。

响应

int下一个排序值。

getPrimaryKey

使用传入的值作为默认值获取此表的主键值。

getPrimaryKey(mixed||string|int keys = []) : mixed||string|int
继承
自

3.1.4

参数

键

array<string|int, mixed>要使用的可选主键值。

响应

array<string|int, mixed>主键名称和值的数组。

getProperties

返回对象属性的关联数组。

getProperties( public = true) : mixed||string|int
继承 已弃用
自

1.7.0
参见 CMSObject::get()
已弃用

4.3.0 将在 6.0 中删除 为该属性创建一个合适的 getter 函数

参数

公共

bool如果为 true，则仅返回公共属性。

响应

array<string|int, mixed>

getRules

获取记录规则的方法。

getRules() : \Joomla\CMS\Access\Rules
继承
自

1.7.0

响应

Rules对象

getTableName

获取类对应的数据库表名的方法。

getTableName() :
继承
自

1.7.0

响应

string正在建模的数据库表名。

hasField

检查记录是否具有属性（如果存在则应用列别名）。

hasField( key) :
继承
自

3.9.11

参数

键

string要检查的键。

响应

布尔值

hasPrimaryKey

验证主键是否已设置。

hasPrimaryKey() :
继承
自

3.1.4

响应

bool如果主键已设置，则为 True。

hit

如果存在必要的属性/字段，则用于增加行点击数的方法。

hit( pk = null) :
继承
自

1.7.0
抛出

UnexpectedValueException

参数

pk

mixed可选的主键值，用于递增。如果未设置，则使用实例属性值。

响应

bool成功时为真。

isCheckedOut

用于确定行是否被检出，因此用户无法编辑的方法。

isCheckedOut( with,  against = null) :
继承

如果行被同一用户检出，则认为未检出 - 因为用户仍然可以编辑它。

自

1.7.0

参数

与

int用于执行匹配的用户 ID，如果项目被此用户检出，则该函数将返回 false。

对抗

int当该函数用作静态函数时，用于执行匹配的用户 ID。

响应

bool如果检出，则为 True。

load

通过主键从数据库加载行并将字段绑定到 Table 实例属性的方法。

load( keys = null,  reset = true) :
继承
自

1.7.0
抛出

InvalidArgumentException

RuntimeException

UnexpectedValueException

参数

键

mixed可选的主键值，用于加载行，或要匹配的字段数组。如果未设置，则使用实例属性值。

reset

bool如果在加载新行之前重置默认值，则为 True。

响应

bool如果成功，则为 True。如果未找到行，则为 False。

move

用于在由 SQL WHERE 子句定义的一组行的排序顺序中移动行的方法。

move( delta, string|string[] where = '') :
继承

负数将行向上移动，正数将行向下移动。

自

1.7.0
抛出

UnexpectedValueException

参数

增量

int在排序顺序中移动行的方向和幅度。

哪里

string|array<string|int, string>WHERE 子句，用于限制选择行以压缩排序值。

响应

bool成功时为真。

publish

用于为数据库表中的行或行列表设置发布状态的方法。

publish( pks = null,  state = 1,  userId) :
继承

该方法尊重其他用户检出的行，并将尝试在进行调整后检入可以检入的行。

自

1.7.0

参数

pks

mixed要更新的主键值的可选数组。如果未设置，则使用实例属性值。

状态

int发布状态。例如 [0 = 未发布，1 = 已发布]

userId

int执行操作的用户 ID。

响应

bool成功时为 True；如果 $pks 为空，则为 False。

reorder

用于压缩由 SQL WHERE 子句定义的一组行中的排序值的方法。

reorder(string|string[] where = '') :
继承
自

1.7.0
抛出

UnexpectedValueException

参数

哪里

string|array<string|int, string>WHERE 子句，用于限制选择行以压缩排序值。

响应

mixed成功时为布尔值 True。

reset

用于将类属性重置为类定义中设置的默认值的方法。它将忽略主键以及任何私有类属性（除了 $_errors）。

reset() :
继承
自

1.7.0

响应

void

save

提供将 Table 实例绑定、检查和存储到数据库表的快捷方式的方法。

save(array|object src,  orderingFilter = '', array|string ignore = '') :
继承

该方法将在数据存储后检查一次行，如果存在排序过滤器，则将尝试根据过滤器对表行重新排序。排序过滤器是一个实例属性名称。将被重新排序的行是其值与 Table 实例匹配的那些行，这些行的值与指定的属性相匹配。

自

1.7.0

参数

src

array<string|int, mixed>|object要绑定到 Table 实例的关联数组或对象。

排序过滤器

string用于更新顺序的过滤器。

ignore

array<string|int, mixed>|string要忽略的属性的可选数组或空格分隔列表。

响应

bool成功时为真。

set

修改对象的属性，如果属性不存在则创建属性。

set( property,  value = null) :
继承 已弃用
自

1.7.0
已弃用

4.3.0 将在 6.0 中删除 为属性创建合适的设置函数

参数

属性

string属性的名称。

价值

mixed要设置的属性的值。

响应

mixed属性的先前值。

setColumnAlias

用于为“特殊”列注册列别名的方法。

setColumnAlias( column,  columnAlias) :
继承
自

3.4

参数

列

string“特殊”列（即排序）

列别名

string真实列名（即 foo_ordering）

响应

void

setCurrentUser

设置当前用户。

setCurrentUser(\Joomla\CMS\User\User currentUser) :
继承
自

4.2.0

参数

currentUser

User当前用户对象

响应

void

setDbo

用于设置 DatabaseDriver 对象的方法。

setDbo(\Joomla\Database\DatabaseDriver db) :
继承
自

1.7.0

参数

db

DatabaseDriver表对象将使用的 DatabaseDriver 对象。

响应

bool成功时为真。

setError

添加错误消息。

setError( error) :
继承 已弃用
自

1.7.0
已弃用

3.1.4 将在 6.0 中删除 将被删除而不会被替换，改为抛出异常而不是使用 setError

参数

错误

string错误消息。

响应

void

setProperties

根据命名数组/哈希设置对象属性。

setProperties( properties) :
继承 已弃用
自

1.7.0
参见 CMSObject::set()
已弃用

4.3.0 将在 6.0 中删除 为属性创建合适的设置函数

参数

属性

mixed关联数组或另一个对象。

响应

布尔值

setRules

用于为记录设置规则的方法。

setRules( input) :
继承
自

1.7.0

参数

输入

mixedRules 对象、JSON 字符串或数组。

响应

void

store

覆盖 Table::store 以设置修改后的数据和用户 ID。

store( updateNulls = true) :
自

3.1

参数

updateNulls

bool如果要更新字段（即使它们为空），则为 True。

响应

bool成功时为真。

storeUcmBase

在 ucm_base 表中插入或更新行

storeUcmBase( updateNulls = true,  isNew = false) :
自

3.1

参数

updateNulls

bool如果要更新字段（即使它们为空），则为 True。

isNew

bool如果为 true，则需要插入。否则更新。

响应

bool成功时为真。

属性

_errors

错误消息或异常对象的数组。

继承 已弃用
自

1.7.0
已弃用

3.1.4 JError 已弃用

类型

array<string|int, mixed>

_includePaths

用于搜索 Table 类的包含路径。

继承 静态
自

3.0.0

类型

array<string|int, mixed>

tableFields

表字段缓存

继承 静态
自

3.10.4

类型

array<string|int, mixed>

_tbl

要建模的数据库表名。

继承
自

1.7.0

类型

字符串

_tbl_key

表中主键字段的名称。

继承
自

1.7.0

类型

字符串

_tbl_keys

表中主键字段的名称。

继承
自

3.0.1

类型

array<string|int, mixed>

_db

DatabaseDriver 对象。

继承
自

1.7.0

类型

DatabaseDriver

_trackAssets

是否应将行跟踪为 ACL 资源？

继承
自

1.7.0

类型

布尔值

_rules

与该记录关联的规则。

继承
自

1.7.0

类型

Rules

_locked

指示表已被锁定的指示器。

继承
自

1.7.0

类型

布尔值

_autoincrement

指示主键自动递增。

继承
自

3.1.4

类型

布尔值

_columnAlias

包含“特殊”列的别名的数组，例如排序、点击数等

继承
自

3.4.0

类型

array<string|int, mixed>

_jsonEncode

在绑定方法中将必要字段编码为 JSON

自

4.0.0

类型

array<string|int, mixed>

_supportNullValue

指示列完全支持数据库中的 NULL 值

自

4.0.0

类型

布尔值

typeAlias

UCM 类型别名。用于标签、内容版本控制等。留空以有效地禁用这些功能。

继承
自

4.0.0

类型

字符串

currentUser

当前用户对象。

继承
自

4.2.0

类型

用户
  • \ Joomla
  • \ CMS
  • \ Table
  • \ CoreContent