当Solar类中的方法执行以下相关功能时,它们应该合理地使用以下名字:
Table B.1. 规范的方法名
方法名 | 用途 | 示例 |
---|---|---|
delete | 从存储中删除数据(而不应该使用remove/destroy) | $table->delete($where) |
fetch 或fetchOne | 从存储中返回一条记录(而不应该使用get/find/retrieve) | $cache->fetch($id) |
fetchBy fetchOneBy | 从存储中返回一条记录,使用方法中指定的替代或额外标准(而不应该使用fetchWith/fetchFor) | $table->fetchByName($name) |
fetchAll | 从存储中返回多条记录 |
$table->fetchAll() |
fetchAllBy | 从存储中返回多条记录,使用方法中指定的替代或额外标准 | $table->fetchAllByName($name) |
fix | 修改一个配置值、参数或属性,以符合某个标准格式或结构 | $fetch->fixParams() |
get | 获取某个属性的值 | $obj->getProperty() |
has 或exists | 检查某个值或某个属性是否已存在,返回布类型的true或false | $session->hasFlash() |
insert | 向存储插入新数据(而不应该使用add/new/save) | $table->insert($data) |
is | 此方法返回布类型的true或false | $cache->isActive() |
load | 从外部源加载属性值 | $role->load($handle) |
sanitize | 强制某个值匹配某个规刚 | $filter->sanitizeFloat($value) |
save | 在存储中更新现有数据或插入新的数据(而不应该使用replace) | $cache->save($id, $data) |
set | 设置属性的值 | $obj->setProperty($value) |
update | 更新存储中现有数据(而不应该使用save/change) | $table->update($data, $where) |
validate | 检查某个值是否匹配某个规刚,返回布类型的true或false | $filter->validateFloat($value) |
这些名字并不是硬性要求,只是应合理地使用它们。