模型
模型是应用程序中业务层的类。
这意味着它们负责管理工作域中几乎所有的与数据有关的东西:数据校验、交互和信息流演化。
通常模型类代理数据,用于 CakePHP 应用程序的数据访问,多数时候它们代理数据库表,但并不限于此,它也可以访问操纵数据的任何事物,如文件、外部 web service、iCal 事件或者一个 CSV 文件的行。
一个模型可以与其它模型相关联。例如,一个 Recipe 能够与食谱的 Author 及 食谱的 Ingredient 相关联。
这一节将说明模型的哪些特性可以是自动化的,如何覆盖这些特性,以及模型都有哪些方法和属性。还说明了关联数据的不同方法。描述了如果查找、保存和删除数据。最后,讲解了数据源。
理解模型
模型描述了你的数据模型。在面向对象编程中,一个数据模型是描述一件事的对象,比如一辆汽车、一个人、一幢房子。举例来说,一个博客可能有很多博客文章,每篇文章可能有很多评论。博客、文章和评论是全部示例模型,每一个都与其它的相关联。
下面是在 CakePHP 中定义的模型的简单示例:
1 class Ingredient extends AppModel { 2 public $name = 'Ingredient'; 3 }
只需这样一个简单的声明,Ingredient 模型就被赋予了建立保存和删除数据的查询所需的全部功能。这些魔术方法继承自 CakePHP 的 Model 类。Ingredient 模型继承了应用程序模型 AppModel(一个扩展自内部 Model 类的模型类)。它是向 Ingredient 模型赋予功能的核心模型类。
介于内部 Model 类和最终的模型类之间的 AppModel 类,在你创建专属于自己的 AppModel 类之前是空的,它位于 CakePHP 内核文件夹。覆写 AppModel 类允许你定义对应用程序中所有的模型类都可用的功能。要做到这一点,只需要在 Model 文件夹中建立你自己的 AppModel.php ,和应用程序中的其它模型类放在一起。使用 Bake 建立项目时,会自动为你生成这个文件。
关于如何向多个模型添加相同的逻辑的更多信息,请参见 Behaviors 。
回到我们的 Ingredient 模型,为了在其上工作,需要在 /app/Model 文件夹创建 PHP 文件。按照约定它的名字应该与类相同,对于本例,就是 Ingredient.php 。
注解
如果 CakePHP 没有在 /app/Model 文件夹中找到符合条件的文件,它将动态创建一个模型对象。这意味关如果你的模型文件命名错误(例如 ingredient.php 或者 Ingredients.php),CakePHP 将使用出乎你意料的 AppModel 的实例(按照 CakePHP 自己的思维方式)。如果你尝试使用你已经定义在你的模型听方法,或者附加到你的模型上的行为,你会收到一个以你调用的方法名标识的 SQL 错误信息 - 它是 CakePHP 找不到你的模型的明确提示,你需要检查文件名、应用程序缓存,或者两者都检查一下。
注解
一些类名不能用于模型名。举例来说,’‘File’’ 不能使用,因为 ‘’File’’ 是 CakePHP 内核中已经存在的类。
定义过的模型就可以在 控制器 中访问了。CakePHP 会自动使与当前控制器名字相同的模型可用。例如,如果一个控制器的名字是 IngredientsController,将自动初始化 Ingredient 模型并将其赋予此控制器的 $this->Ingredient 变量:
1 class IngredientsController extends AppController { 2 public function index() { 3 //抓取所有的 ingredients 并将其传递给视图: 4 $ingredients = $this->Ingredient->find('all'); 5 $this->set('ingredients', $ingredients); 6 } 7 }
关联模型通过主模型访问。在上面的例子中,Recipe 与 Ingredient 模型关联:
1 class Recipe extends AppModel { 2 3 public function steakRecipes() { 4 $ingredient = $this->Ingredient->findByName('Steak'); 5 return $this->findAllByMainIngredient($ingredient['Ingredient']['id']); 6 } 7 }
上面的代码显示了如何使用已经连接的模型。想了解如何定义关联请移步至 Associations section。
关于模型的更多...
- 关联:将模型连接在一起
- 关系类型
- hasOne
- belongsTo
- hasMany
- counterCache - 缓存你的 count()
- hasAndBelongsToMany (HABTM)
- hasMany 贯穿 (连接模型)
- 在运行期间创建和销毁关联
- 同一模型上的多个关系
- 连接表
- 检索数据
- find
- find(‘first’)
- find(‘count’)
- find(‘all’)
- find(‘list’)
- find(‘threaded’)
- find(‘neighbors’)
- 创建自定义 find 类型
- 魔术查找类型
- findAllBy
- findBy
- Model::query()
- Model::field()
- Model::read()
- 复杂的查找条件
- 子查询
- 预处理语句
- 保存数据
- Model::set($one, $two = null)
- Model::save(array $data = null, boolean $validate = true, array $fieldList = array())
- Model::create(array $data = array())
- Model::saveField(string $fieldName, string $fieldValue, $validate = false)
- Model::updateAll(array $fields, array $conditions)
- Model::saveMany(array $data = null, array $options = array())
- Model::saveAssociated(array $data = null, array $options = array())
- Model::saveAll(array $data = null, array $options = array())
- 保存相关模型的数据(hasOne, hasMany, belongsTo)
- 通过数据保存 hasMany
- 保存相关模型数据 (HABTM)
- 当 HABTM 变得复杂时怎么办?
- 保存相关模型数据 (HABTM)
- 数据表
- 使用 created 和 modified 列
- 删除数据
- delete
- deleteAll
- 数据校验
- Simple Rules
- One Rule Per Field
- rule
- required
- allowEmpty
- on
- message
- Multiple Rules per Field
- last
- Custom Validation Rules
- Custom Regular Expression Validation
- Adding your own Validation Methods
- Dynamically change validation rules
- Adding new validation rules
- Modifying current validation rules
- Removing rules from the set
- Core Validation Rules
- Localized Validation
- Validating Data from the Controller
- 回调方法
- beforeFind
- afterFind
- beforeValidate
- beforeSave
- afterSave
- beforeDelete
- afterDelete
- onError
- 行为
- Using Behaviors
- Creating Behaviors
- Creating behavior methods
- Mapped methods
- Behavior callbacks
- Creating a behavior callback
- 数据源
- Basic API For DataSources
- An Example
- Plugin DataSources
- 模型属性
- useDbConfig
- useTable
- tablePrefix
- 主键
- displayField
- recursive
- order
- data
- _schema
- validate
- virtualFields
- name
- cacheQueries
- 附加的方法和附属
- Model::associations()
- Model::buildQuery(string $type = 'first', array $query = array())
- Model::deconstruct(string $field, mixed $data)
- Model::escapeField(string $field = null, string $alias = null)
- Model::exists($id)
- Model::getAffectedRows()
- Model::getAssociated(string $type = null)
- Model::getColumnType(string $column)
- Model::getColumnTypes()
- Model::getID(integer $list = 0)
- Model::getInsertID()
- Model::getLastInsertID()
- 虚拟列
- Creating virtual fields
- Using virtual fields
- Model::hasField()
- Model::isVirtualField()
- Model::getVirtualField()
- Model::find() and virtual fields
- Pagination and virtual fields
- Virtual fields and model aliases
- Virtual fields in SQL queries
- Limitations of virtualFields
- 事务
- Nested Transactions