samsonos / cms_input
SamsonCMS 通用输入字段模块
Requires
This package is not auto-updated.
Last update: 2024-09-25 14:38:09 UTC
README
#SamsonCMS 输入模块
这是所有 CMS 输入模块的基模块。
用法
此模块有两个主要静态函数:
- create()
- createFromMetadata()
函数 create($dbObject, $type, $param = null, $className = CLASS) 根据给定参数创建并检索 SamsonCMS 输入实例。如您所见,前两个是必需的,它们分别是 \samson\activerecord\dbRecord 实例或其祖先和 SamsonCMS 输入字段类型,此参数应为 int。以下是此列表
其他参数不是必需的。例如,如果您不向此函数传递 $param,则将使用祖先类字段,如果没有定义,则将使用此类字段。最后一个参数用于双层或多层嵌套类。此功能尚未实现。
第二个函数 createFromMetadata($entity, $param, $identifier, $className = CLASS) 与 create() 函数非常相似,除了前两个和第三个参数外,它们用于获取 \samson\activerecord\dbRecord 实例。
以下是这些函数如何使用的一些示例
$input = Field::create($material, 7, 'remains'); ... $input = Field::createFromMetadata($_GET['e'], $_GET['f'], $_GET['i']);
其他方法
还有 value(),save($value) 和 convert($value) 函数。第一个函数返回 SamsonCMS 模块值字段。convert() 函数不执行任何操作,但可以覆盖以在保存之前转换值。save() 函数将值插入 \samson\activerecord\dbRecord 对象字段并将此对象写入数据库。
请注意不要与 __save() 控制器混淆。
由于此类是模块,因此它具有 __save() 控制器,可以通过例如 URL '...samson_cms_input/save' 来调用它。如您所知,每个 SamsonCMS 模块都有自己的 id,'samson_cms_input' 可以替换为它以执行祖先控制器。
此类实现了 \samson\core\iModuleViewable 接口,应实现 toView() 函数。默认情况下,此模块中有默认实现,但可以在祖先类中覆盖。