摘要：使用模型模型表示应用程序信息数据以及这些数据的处理规则，主要用于管理与对应数据表的交互规则。应用中，是所有模型的基类。创建模型模型需继承类，以大驼峰格式命名。方法在请求期间只调用一次，目的是为该模型的所有实例执行初始化操作。
使用模型(Working with Models)
模型表示应用程序信息(数据)以及这些数据的处理规则，主要用于管理与对应数据表的交互规则。大多数情况下，数据库中的每一张表都有对应的模型。应用程序中的大部分业务逻辑集中在模型中。
Phalcon应用中，PhalconMvcModel是所有模型的基类。它提供了数据库独立、基础CRUD、高级查找、模型关联以及其他服务。
PhalconMvcModel将调用的方法动态转换为相应的数据库操作，避免了直接使用SQL。
模型使用数据库高级抽象层，如果想要使用更为底层的方式操作数据库，请参考PhalconDb组件文档。
创建模型(Creating Models)模型需继承PhalconMvcModel类，以大驼峰格式命名。
如果使用PHP 5.4、5.5版本，建议在模型中声明对应数据表的所有字段，以节约内存。
模型StoreToysRobotParts默认映射robot_parts表，可以调用setSource()方法手动指定映射表：
setSource("toys_robot_parts"); } }模型RobotParts现在映射toys_robot_parts表。initialize()方法有助于在模型中创建自定义行为，如为模型指定映射表。
initialize()方法在请求期间只调用一次，目的是为该模型的所有实例执行初始化操作。如果每次实例化模型的时候都需要进行初始化，可以使用onConstruct()方法：
公共属性和Setters、Getters方法(Public properties vs. Setters/Getters)模型可以定义公共属性，在任何获取了模型实例的地方都可以读写模型的公共属性：
另一种实现方式是getters和setters方法，控制哪些模型属性可以公开访问。这种方式的好处是，开发者可以在对模型属性进行写操作时执行转换和验证，这是使用公共属性方式无法实现的。此外，getters和setters可以在不改动模型和接口的前提下，应对未来可能的改动。如果字段名称改变，唯一需要的改动的地方是getters和setters中引用的模型私有属性。
id; } public function setName($name) { // name不能太短 if (strlen($name) < 10) { throw new InvalidArgumentException( "The name is too short" ); } $this->name = $name; } public function getName() { return $this->name; } public function setPrice($price) { // price不能为负 if ($price < 0) { throw new InvalidArgumentException( "Price can"t be negative" ); } $this->price = $price; } public function getPrice() { // 返回前，将该值转换为double类型 return (double) $this->price; } }虽然公共属性在开发中的复杂度更低，但是getters和setters可以大大提高程序的测试性、扩展性和可维护性。开发者可以根据需求决定哪种方式更适合他们的应用。ORM兼容这两种方式。
使用getters和setters时，属性名中的下划线可能会导致问题。
如果在属性名中使用下划线，在声明getters和setters魔术方法时，仍然要使用驼峰格式($model->getPropertyName()代替$model->getProperty_name()，$model->findByPropertyName()代替$model->findByProperty_name()等)。大多数系统推荐驼峰写法，而不是下划线写法，所以建议按照文档中的写法为属性命名。可以使用字段映射(如上所述)以确保属性正确映射到数据表中对应字段。
理解记录对象(Understanding Records To Objects)模型的每一个实例代表数据表中的一条记录，可以通过读取模型对象属性来访问记录数据。例如，表robots有如下记录：
mysql> select * from robots; +----+------------+------------+------+ | id | name | type | year | +----+------------+------------+------+ | 1 | Robotina | mechanical | 1972 | | 2 | Astro Boy | mechanical | 1952 | | 3 | Terminator | cyborg | 2029 | +----+------------+------------+------+ 3 rows in set (0.00 sec)通过主键查找某条记录：
name;一旦记录存储在内存中，就可以修改其中的数据并保存：
name = "RoboCop"; $robot->save();PhalconMvcModel为web应用提供了数据库高级抽象层，不需要使用原生SQL语句。
查找记录(Finding Records)PhalconMvcModel提供了多种查询记录的方法，下面例子演示如何用模型查找一条或多条记录：
"name", ] ); foreach ($robots as $robot) { echo $robot->name, " "; } // 获取type = "virtual"的前100条记录，根据name排序 $robots = Robots::find( [ "type = "virtual"", "order" => "name", "limit" => 100, ] ); foreach ($robots as $robot) { echo $robot->name, " "; }如果要使用外部数据(如用户输入)或变量查找记录，必须进行参数绑定。
使用findFirst()方法，获取满足给定条件的第一条记录：
name, " "; // 获取robots表中type = "mechanical"的第一条记录 $robot = Robots::findFirst("type = "mechanical""); echo "The first mechanical robot name is ", $robot->name, " "; // 获取robots表中type = "virtual"的第一条记录，根据name排序 $robot = Robots::findFirst( [ "type = "virtual"", "order" => "name", ] ); echo "The first virtual robot name is ", $robot->name, " ";find()方法和findFirst()方法都接受一个包含指定搜索条件的关联数组：
"name DESC", "limit" => 30, ] ); $robots = Robots::find( [ "conditions" => "type = ?1", "bind" => [ 1 => "virtual", ], ] );有下列查询选项：
| 参数 | 说明 | 示例 |
|---|---|---|
| conditions | 查询操作的搜索条件，用于筛选符合指定条件的记录。默认情况下，PhalconMvcModel假定第一个参数就是搜索条件 | "conditions" => "name LIKE "steve%"" |
| columns | 获取模型中的指定字段，而不是所有字段。使用此选项时，返回不完整对象。 | "columns" => "id, name" |
| bind | 参数绑定与conditions一起使用，通过替换占位符、转义特殊字符从而提高安全性 | "bind" => ["status" => "A", "type" => "some-time"] |
| bindTypes | 使用参数绑定时，可以使用这个参数为绑定参数定义额外的类型限制，从而提高安全性 | "bindTypes" => [Column::BIND_PARAM_STR, Column::BIND_PARAM_INT] |
| order | 用于对结果集进行排序，使用逗号分隔多个字段 | "order" => "name DESC, status" |
| limit | 将查询结果的数量限制在一定范围内 | "limit" => 10 |
| offset | 设定查询结果偏移量 | "offset" => 5 |
| group | 允许跨记录收集数据，并将结果集按一个或多个字段分组 | "group" => "name, status" |
| for_update | 使用此选项，PhalconMvcModel将读取最新的可用数据，并为读取到的每一条记录设置独占锁 | "for_update" => true |
| shared_lock | 使用此选项，PhalconMvcModel将读取最新的可用数据，并为读取到的每一条记录设置共享锁 | "shared_lock" => true |
| cache | 缓存结果集，减少对数据库的持续访问 | "cache" => ["lifetime" => 3600, "key" => "my-find-key"] |
| hydration | 设置结果集返回模式 | "hydration" => Resultset::HYDRATE_OBJECTS |
除了使用参数数组，还可以使用面向对象的方式创建查询：
where("type = :type:")
->addWhere("year < 2000")
->bind(["type" => "machanical"])
->order("name")
->execute();
静态方法query()返回一个IDE自动完成友好的PhalconMvcModelCriteria对象。
所有查询在内部都以PHQL查询的方式处理。PHQL是一种高级的、面向对象的类SQL语言，这种语言提供了多种功能来执行查询，如join其他模型，定义分组，添加聚合等。
最后，还有一个findFirstBy
这里有三个属性：$id，$name和$price，假设要检索name为"Terminator"的第一条记录，代码如下：
price, "."; } else { echo "There were no robots found in our table with the name " . $name . "."; }请注意，我们在调用的方法中使用了Name并传递了变量$name，表中name字段值为$name的记录就是我们要查找的。
模型结果集(Model Resultsets)findFirst()方法返回被调用类的实例(如果有结果返回)，而find()方法返回PhalconMvcModelResultsetsSimple对象，该对象封装了结果集应有的所有功能，如遍历，查找特定记录，统计等。
这些对象比一般数组功能强大，PhalconMvcModelResultset一个最大的特点是，任何时刻，只有一条记录保存在内存中。这对内存管理有极大帮助，特别是在处理大批量数据时。
name, " "; } // while遍历 while ($robots->valid()) { $robot = $robots->current(); echo $robot->name, " "; $robots->next(); } // 结果集计数 echo count($robots); // 另一种结果集计数方法 echo $robots->count(); // 移动游标到第三条记录 $robots->seek(2); $robot = $robots->current(); // 通过位置访问结果集中的记录 $robot = $robots[5]; // 检查指定位置是否有记录 if (isset($robots[3])) { $robot = $robots[3]; } // 获取结果集中第一条记录 $robot = $robots->getFirst(); // 获取结果集中最后一条记录 $robot = $robots->getLast();Phalcon结果集模拟游标，可以通过访问其位置或内部指针获取任一条记录。注意，某些数据库系统不支持游标，这会导致查询被反复执行，以重置游标到初始位置并获取被请求位置的记录。同样的，遍历多少次结果集，查询便要执行多少次。
将大量查询结果保存在内存中会消耗太多资源，因此，在某些情况下，以32条记录为一块从数据库中获取记录，可以降低重复执行请求的内存消耗。
注意，结果集可以序列化后存储在缓存中，PhalconCache可以实现该需求。但是序列化数据会导致PhalconMvcModel以数组形式保存从数据库中检索到的数据，这会导致更多的内存消耗。
id; }自定义结果集(Custom Resultsets)有时候应用程序需要对数据库中检索到的数据进行额外处理。以前，我们只需要扩展模型或将功能封装在模型或trait当中，然后返回一组经过转换的数据。
通过自定义结果集，不需要再如此处理。自定义结果集将封装原本封装在模型中并能被其他模型重用的功能，这样可以简化代码。如此，find()方法返回自定义对象，而不再返回PhalconMvcModelResultset对象。Phalcon允许在模型中定义getResultsetClass()方法来实现此操作。
首先，声明resultset类：
模型中，在getResultsetClass()方法里设置resultset类，如下：
最后，代码里应包含如下内容：
"date between "2017-01-01" AND "2017-12-31"", "order" => "date", ] ); /** * 传递数据到视图 */ $this->view->mydata = $robots->getSomeData();过滤结果集(Filtering Resultsets)过滤数据最有效的方法之一是设置搜索条件，数据库将使用表索引以更快的返回数据。Phalcon允许使用PHP函数或是数据库不支持的方式过滤数据:
filter( function ($customer) { // 只返回e-mail合法的记录 if (filter_var($customer->email, FILTER_VALIDATE_EMAIL)) { return $customer; } } );参数绑定(Binding Parameters)PhalconMvcModel支持参数绑定，建议使用这种方法以避免SQL注入，字符串占位符和数字占位符均被支持。参数绑定简单实现如下：
[ "name" => "Robotina", "type" => "maid", ], ] ); // 数字占位符 $robots = Robots::find( [ "name = ?1 AND type = ?2", "bind" => [ 1 => "Robotina", 2 => "maid", ], ] ); // 同时使用字符串占位符和数字占位符 $robots = Robots::find( [ "name = :name: AND type = ?1", "bind" => [ "name" => "Robotina", 1 => "maid", ], ] );使用数字占位符时，需要将它们定义成整数形式，即1或2。而"1"或"2"会被当成字符串，所以占位符不能被成功替换。
字符串会自动使用PDO转义，该功能会考虑连接字符集，因此建议在连接参数或数据库配置中定义正确字符集，因为错误字符集会在存储和检索数据时产生不良影响。
还可以设置bindTypes参数，定义参数如何根据其类型绑定:
"Robotina", "year" => 2008, ]; // 参数类型转换 $types = [ "name" => Column::BIND_PARAM_STR, "year" => Column::BIND_PARAM_INT, ]; // 字符串占位符 $robots = Robots::find( [ "name = :name: AND year = :year:", "bind" => $parameters, "bindTypes" => $types, ] );由于默认的绑定类型是PhalconDbColumn::BIND_PARAM_STR，如果所有字段都是字符串类型，则没有必要指定bindTypes参数。
如果使用数组作为绑定参数，则数组必须是键名从0开始的索引数组:
"a", [1] => "b", [2] => "c"] unset($array[1]); // $array: [[0] => "a", [2] => "c"] // 现在必须重建数组索引 $array = array_values($array); // $array: [[0] => "a", [1] => "c"] $robots = Robots::find( [ "letter IN ({letter:array})", "bind" => [ "letter" => $array, ], ] );参数绑定除了可用于所有查询方法，如find()和findFirst()外，还可用于count()，sum()，average()等统计方法。
使用finders时，会自动使用参数绑定：
[ "Ultron", ], ] ); // 隐式使用参数绑定 $robots = Robots::findByName("Ultron");初始化已获取记录(Initializing / Preparing fetched records)有时从数据库获取记录之后，在数据被应用程序使用之前，需要对数据进行初始化。可以在模型中实现afterFetch()方法，实例化模型时会执行该方法，并将数据传递给它：
status = join(",", $this->status); } public function afterFetch() { // 将字符串转换成数组 $this->status = explode(",", $this->status); } public function afterSave() { // 将字符串转换成数组 $this->status = explode(",", $this->status); } }如果使用getters/setters代替公共属性，或同时使用它们，可以在字段被访问时初始化字段：
status); } }生成运算(Generating Calculations)运算(或聚合)是数据库中常用的辅助方法，如COUNT，SUM，MAX，MIN和AVG。PhalconMvcModel可以直接使用这些方法。
Count示例："area", ] ); // 表employees共有多少area为"Testing"的记录 $rowcount = Employees::count( "area = "Testing"" ); // 按area分组统计表employees记录 $group = Employees::count( [ "group" => "area", ] ); foreach ($group as $row) { echo "There are ", $row->rowcount, " in ", $row->area; } // 按area分组统计表employees记录，并根据数目排序 $group = Employees::count( [ "group" => "area", "order" => "rowcount", ] ); // 使用参数绑定避免SQL注入 $group = Employees::count( [ "type > ?0", "bind" => [ $type, ], ] );Sum示例：
"salary", ] ); // area = "Sales"的所有employees的salaries总和 $total = Employees::sum( [ "column" => "salary", "conditions" => "area = "Sales"", ] ); // 根据area分组统计salaries $group = Employees::sum( [ "column" => "salary", "group" => "area", ] ); foreach ($group as $row) { echo "The sum of salaries of the ", $row->area, " is ", $row->sumatory; } // 根据area分组统计salaries，salaries由高到低排序 $group = Employees::sum( [ "column" => "salary", "group" => "area", "order" => "sumatory DESC", ] ); // 使用参数绑定避免参数绑定 $group = Employees::sum( [ "conditions" => "area > ?0", "bind" => [ $area, ], ] );Average示例：
"salary", ] ); // area = "Sales"的employees的平均salary $average = Employees::average( [ "column" => "salary", "conditions" => "area = "Sales"", ] ); // 使用参数绑定避免SQL注 $average = Employees::average( [ "column" => "age", "conditions" => "area > ?0", "bind" => [ $area, ], ] );Max / Min示例：
"age", ] ); // area = "Sales"的employees中age最大的 $age = Employees::maximum( [ "column" => "age", "conditions" => "area = "Sales"", ] ); // 所有employees中salary最低的 $salary = Employees::minimum( [ "column" => "salary", ] );创建 / 更新记录(Creating / Updating Records)PhalconMvcModel::save()方法会根据记录是否存在于模型映射表中而创建 / 更新记录，PhalconMvcModel的创建和更新方法会在内部调用该方法。为此，必须在实体中正确定义主键，以确定是创建记录还是更新记录。
该方法会执行相关验证器，虚拟外键和模型中定义的事件：
type = "mechanical"; $robot->name = "Astro Boy"; $robot->year = 1952; if ($robot->save() === false) { echo "Umh, We can"t store robots right now: "; $messages = $robot->getMessages(); foreach ($messages as $message) { echo $message, " "; } } else { echo "Great, a new robot was saved successfully!"; }直接传递或者通过属性数组传递的值会根据其数据类型自动被转义 / 过滤，所以可以传递一个不安全的数组而不用担心SQL注入：
save($_POST);毫无防护的批量传值可能会允许攻击者设置任意字段的值，仅在允许用户插入 / 更新模型中所有字段的情况下使用上述功能，即使这些字段不是使用表单提交的。
可以在save()方法中设置额外参数，以设置批量传值时，执行插入 / 更新操作的白名单字段。
save( $_POST, [ "name", "type", ] );创建 / 更新执行结果(Create / Update with Confidence)应用程序高并发时，创建记录操作可能会变成更新操作。使用PhalconMvcModel::save()方法保存记录时，可能发生这种情况。如果想确保执行创建或更新，可以使用create()和update()方法替换save()：
type = "mechanical"; $robot->name = "Astro Boy"; $robot->year = 1952; // 仅创建记录 if ($robot->create() === false) { echo "Umh, We can"t store robots right now: "; $messages = $robot->getMessages(); foreach ($messages as $message) { echo $message, " "; } } else { echo "Great, a new robot was created successfully!"; }create()方法和update()方法同样接受一个数组作为参数。
删除记录(Deleting Records)PhalconMvcModel::delete()方法允许删除记录，使用示例：
delete() === false) { echo "Sorry, we can"t delete the robot right now: "; $messages = $robot->getMessages(); foreach ($messages as $message) { echo $message, " "; } } else { echo "The robots was deleted successfully!"; } }也可以通过使用foreach遍历结果集来删除多条记录：
delete() === false) { echo "Sorry, we can"t delete the robot right now: "; $messages = $robot->getMessages(); foreach ($messages as $message) { echo $message, " "; } } else { echo "The robot was deleted successfully!"; } }以下事件可以用于定义在执行删除操作时，要执行的自定义业务规则：
| 操作 | 事件名称 | 能否终止操作 | 说明 |
|---|---|---|---|
| 删除 | afterDelete | 否 | 删除操作后执行 |
| 删除 | beforeDelete | 是 | 删除操作前执行 |
通过上述事件，可以在模型中定义业务规则：
status === "A") {
echo "The robot is active, it can"t be deleted";
return false;
}
return true;
}
}
Hydrations模式(Hydration Modes)
如前所述，结果集是完整对象的集合，这意味着每条返回结果都是一个对象，代表数据表中的一行。这些对象可以修改并永久保存：
year = 2000;
$robot->save();
}
有时记录只能以只读模式呈现给用户，这种情况下，改变记录的展现方式有助于用户处理数据。用于表示结果集中返回的对象的策略称为"hydration mode"：
setHydrateMode(
Resultset::HYDRATE_ARRAYS
);
foreach ($robots as $robot) {
echo $robot["year"], PHP_EOL;
}
// 返回stdClass对象
$robots->setHydrateMode(
Resultset::HYDRATE_OBJECTS
);
foreach ($robots as $robot) {
echo $robot->year, PHP_EOL;
}
// 返回模型实例
$robots->setHydrateMode(
Resultset::HYDRATE_RECORDS
);
foreach ($robots as $robot) {
echo $robot->year, PHP_EOL;
}
Hydration mode也可以作为find()方法的参数传递：
Resultset::HYDRATE_ARRAYS,
]
);
foreach ($robots as $robot) {
echo $robot["year"], PHP_EOL;
}
表前缀(Table prefixes)
如果希望所有表名称都有特定前缀，并且不想在每个模型中都调用setSource()方法，则可以调用PhalconMvcModelManager的setModelprefix()方法：
setModelPrefix("wp_");
$robots = new Robots(null, null, $manager);
echo $robots->getSource(); // 返回wp_robots
自动生成的标识字段(Auto-generated identity columns)
某些模型有标识字段，这些字段通常是映射表的主键。PhalconMvcModel能够识别标识字段，并在生成INSERT语句时忽略它，所以数据库能够自动为它生成一个值。创建记录之后，标识字段的值会被注册为数据库为其生成的值:
save(); echo "The generated id is: ", $robot->id;
PhalconMvcModel能够识别标识字段，根据数据库系统，这些字段可能是PostgreSQL的串行列，或者是MySQL的自增列。
PostgreSQL使用序列生成自增值，默认情况下，Phalcon试图从序列table_field_seq中获取生成的值，例如：robots_id_seq，如果序列具有其他名称，则需要实现getSequenceName()方法：
忽略字段(Skipping Columns)为PhalconMvcModel指定创建 / 更新记录时需要被忽略的字段，以便数据库为其赋默认值：
skipAttributes( [ "year", "price", ] ); // INSERT操作忽略字段 $this->skipAttributes( [ "created_at", ] ); // UPDATE操作忽略字段 $this->skipAttributes( [ "modified_in", ] ); } }这将全局忽略应用程序中每个INSERT / UPDATE操作的这些字段。如果想在不同的INSERT / UPDATE操作时忽略不同字段，可以传递第二个参数(布尔值) - true。强制使用默认值，实现方式如下：
name = "Bender"; $robot->year = 1999; $robot->created_at = new RawValue("default"); $robot->create();回调函数也可以用于为默认值创建分配条件：
price > 10000) { $this->type = new RawValue("default"); } } }切勿使用PhalconDbRawValue传递外部数据(如用户输入)或可变数据，因为参数绑定时，这些字段的值也会被忽略，所以有可能会被用来实施注入攻击。
动态更新(Dynamic Updates)UPDATE语句默认使用模型中定义的所有字段创建(全字段更新SQL)，可以更改特定模型以进行动态更新，用需要更新的字段创建SQL语句。
useDynamicUpdate(true); } }独立列映射(Independent Column Mapping)ORM支持独立的列映射，它允许开发者在模型中定义与映射表列名称不相同的字段名，Phalcon会识别新的字段名称，并重命名字段以匹配数据库中相应的列。这是一项很棒的功能，当需要重命名数据库中的列名称时，不需要更改查询代码，模型中的映射列会处理好这一切。例如：
"code", "the_name" => "theName", "the_type" => "theType", "the_year" => "theYear", ]; } }然后，可以使用新的字段名:
theName, " "; // 根据type排序 $robot = Robots::find( [ "order" => "theType DESC", ] ); foreach ($robots as $robot) { echo "Code: ", $robot->code, " "; } // 添加记录 $robot = new Robots(); $robot->code = "10101"; $robot->theName = "Bender"; $robot->theType = "Industrial"; $robot->theYear = 2999; $robot->save();重命名字段时需要注意以下事项：
关系 / 验证器中对属性的引用必须使用新名称
引用实际列名称将导致ORM异常
独立列映射允许：
使用自定义约定编写应用程序
清除代码中列的前后缀
改变列名称时，无需更改应用代码
记录快照(Record Snapshots)查询时可以设置特定的模型以保持记录快照。可以使用此功能来实现审计，或是根据持久性查询的数据了解哪些字段发生了改变：
keepSnapshots(true); } }当激活此功能时，应用程序会消耗更多的内存来与持久性查询的原始数据保持同步。在激活此功能的模型中，可以按如下方式检查发生改变的字段：
name = "Other name"; var_dump($robot->getChangedFields()); // ["name"] var_dump($robot->hasChanged("name")); // true var_dump($robot->hasChanged("type")); // false快照会在模型创建 / 更新时自动更新，使用hasUpdated()方法和getUploadedFields()方法检查create / save / update操作后，字段是否更新。但是在afterUpdate()，afterSave()和afterCreate()方法中调用getChangedFields()方法，会导致应用程序出问题。
可以禁用此功能：
false, ] );也可以在php.ini中设置：
phalcon.orm.update_snapshot_on_save = 0使用此功能会产生以下效果：
keepSnapshots(true); } } $user = new User(); $user->name = "Test User"; $user->create(); var_dump($user->getChangedFields()); $user->login = "testuser"; var_dump($user->getChangedFields()); $user->update(); var_dump($user->getChangedFields());在Phalcon 3.1.0及之后的版本中：
array(0) { } array(1) { [0] => string(5) "login" } array(0) { }getUpdatedFields()方法将正确返回更新的字段，或如上所述，可以通过设置相关的ini值回到先前的行为。
指向不同模式(Pointing to a different schema)如果模型映射到非默认的模式 / 数据库，可以使用setSchema()方法重新定义它：
setSchema("toys"); } }多数据库配置(Setting multiple databases)Phalcon应用中，所有模型可以属于相同的数据库连接，或具有独立的数据库连接。实际上，当PhalconMvcModel需要连接数据库时，它会在应用程序的服务容器中请求数据库服务。可以在initialize()方法中设置，覆盖该服务：
set( "dbMysql", function () { return new MysqlPdo( [ "host" => "localhost", "username" => "root", "password" => "secret", "dbname" => "invo", ] ); } ); // 注册PostgreSQL数据库服务 $di->set( "dbPostgres", function () { return new PostgreSQLPdo( [ "host" => "localhost", "username" => "postgres", "password" => "", "dbname" => "invo", ] ); } );然后，在initialize()方法中为模型定义连接服务：
setConnectionService("dbPostgres"); } }Phalcon提供了更灵活的操作，可以定义只读连接或写连接，这对于负载均衡和主从架构的的数据库非常有用：
setReadConnectionService("dbSlave"); $this->setWriteConnectionService("dbMaster"); } }ORM还支持分片功能，允许根据当前查询条件实施分片选择：
0 && $id < 10000) { return $this->getDI()->get("dbShard1"); } if ($id > 10000) { return $this->getDI()->get("dbShard2"); } } } // 使用默认分片 return $this->getDI()->get("dbShard0"); } }selectReadConnection()方法选择合适的连接，会影响任何新执行的查询：
注入服务到模型(Injecting services into Models)有时可能需要在模型中访问应用程序服务，以下示例介绍了如何执行此操作：
getDI()->getFlash(); $messages = $this->getMessages(); // 显示验证消息 foreach ($messages as $message) { $flash->error($message); } } }创建或更新操作执行失败时会触发notSaved事件，因此我们从DI容器中获取flash服务，然后闪存验证消息。这样，我们不必在每次保存后打印消息。
禁用 / 启用功能(Disabling / Enabling Features)在ORM中，我们实现了一种机制，允许在全局范围内启用 / 禁用特定功能或选项，根据ORM的使用情况，可以禁用那些你没有使用到的功能。如有需要，下面这些选项可以暂时禁用：
false, "columnRenaming" => false, ] );可用选项：
| 选项 | 说明 | 默认值 |
|---|---|---|
| astCache | 启用 / 禁用模型中的回调、钩子和事件通知 | null |
| cacheLevel | 设置ORM的缓存级别 | 3 |
| castOnHydrate | false | |
| columnRenaming | 启用 / 禁用字段重命名 | true |
| disableAssignSetters | 模型中禁用setter | false |
| enableImplicitJoins | true | |
| enableLiterals | true | |
| escapeIdentifiers | true | |
| events | 启用 / 禁用模型中的回调、钩子和事件通知 | true |
| exceptionOnFailedSave | 启用 / 禁用save()操作失败时抛出异常 | false |
| forceCasting | false | |
| ignoreUnknownColumns | 启用 / 禁用忽略模型上的未知字段 | false |
| lateStateBinding | 启用 / 禁用PhalconMvcModel::cloneResultMap()方法的延迟绑定 | false |
| notNullValidations | ORM自动验证映射表中的非空列 | true |
| parserCache | null | |
| phqlLiterals | 启用 / 禁用PHQL解析器中的字面量 | true |
| uniqueCacheId | 3 | |
| updateSnapshotOnSave | 启用 / 禁用save()方法的更新快照 | true |
| virtualForeignKeys | 启用 / 禁用虚拟外键 | true |
注意，给PhalconMvcModel::assign()方法(创建 / 更新 / 保存模型中常用到它)传递参数时，setters始终会被调用，这会给应用程序增加额外开销。可以在php.ini文件中添加配置phalcon.orm.disable_assign_setters = 1，这样就只会简单的使用$this->property = value。
独立组件(Stand-Along component)下面演示以独立组件模式使用PhalconMvcModel：
set(
"db",
new Connection(
[
"dbname" => "sample.db",
]
)
);
// 创建模型管理器
$di->set(
"modelsManager",
new ModelsManager()
);
// 使用内存元数据适配器或其他
$di->set(
"modelsMetadata",
new MetaData()
);
// 创建模型
class Robots extends Model
{
}
// 使用模型
echo Robots::count();
文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。
转载请注明本文地址：https://www.ucloud.cn/yun/28682.html
摘要：原文发表于入门教程之模型提供了四种方式操作数据库模型数据库抽象层以及原生。创建模型模型类的命名必须符合驼峰命名法，而且须继承自类文件路径继承自类。 原文发表于：Phalcon入门教程之模型 Phalcon 提供了四种方式操作Mysql数据库：模型、PHQL、数据库抽象层以及原生SQL。不论何种方式，首先都需要在DI中注册 db 服务才能正常使用： DI注册db服务 // 文件路径：...
摘要：本文描述了框架中数据库操作方法，主要讨论框架的组件中的操作方法。属性方法在框架中支持属性的扩展查询，在上例中，可以把条件语句改为同时省略查询条件结果不变。 本文描述了PHP-Phalcon框架中数据库操作方法，主要讨论Phalcon框架的Model组件中的操作方法。更详细的Model介绍请参考:官方文档 1. 连接数据库 在Phalcon框架中，通过在DI中注入db参数来实现数据库的...
摘要：查询语言查询语言，简称或，是一种面向对象的高级语言，允许用标准化的编写。该对象的每个成员都是一个包含所查询字段的标准对象。 Phalcon查询语言(Phalcon Query Language) Phalcon查询语言，简称PhalconQL或PHQL，是一种面向对象的高级SQL语言，允许用标准化的SQL编写。PHQL实现了把操作语句解析为RDBMS目标语言的解析器(C语言编写)。 为...
摘要：原文发表于入门教程之目录结构很多初学的朋友，对于以框架为基础构建的项目，应该如何组织目录结构有点摸不着头脑。只需要通过注册这些目录结构，即可正常使用。 原文发表于：Phalcon入门教程之目录结构 很多初学Phalcon的朋友，对于以Phalcon框架为基础构建的项目，应该如何组织目录结构有点摸不着头脑。比如多模块的项目中，如何共用libs类库和models目录中模型类的情况，就有很...
摘要：数据库抽象层是底层组件，由它驱动框架中的模型层。它完全由语言编写，是一个独立的数据库高级抽象层。使用任何数据库适配器，数据都会被自动转义。配合使用，可以在数据库抽象层上提供日志记录功能。语法因数据库而异。并非所有数据库系统都允许修改列或 数据库抽象层(Database Abstraction Layer) PhalconDb是PhalconMvcModel底层组件，由它驱动框架中的模型...
阅读 1743·2021-09-22 15:25
阅读 1307·2019-08-29 12:34
阅读 1907·2019-08-26 13:57
阅读 3188·2019-08-26 10:48
阅读 1443·2019-08-26 10:45
阅读 792·2019-08-23 18:23
阅读 733·2019-08-23 18:01
阅读 1944·2019-08-23 16:07
