README

http://j4mie.github.com/idiormandparis/

功能完整

从版本1.5.0开始，Idiorm被认为是功能完整的。虽然它将继续维护并修复错误，但从此之后将不再添加新功能。

请勿提交添加新功能的功能请求或拉取请求，因为这些请求将被无礼地关闭。

PHP5的轻量级几乎零配置对象关系映射器和流畅查询构建器。

在PHP 5.2.0+上测试 - 可能适用于更早的版本，只要使用PDO和正确的数据库驱动程序。

在BSD许可证下发布。

另请参阅：基于Idiorm构建的Active Record实现Paris。

特性

• 使简单查询和简单CRUD操作变得完全无痛。
• 在需要更复杂的SQL时不再妨碍。
• 基于PDO构建。
• 在整个应用程序中使用预处理语句以防止SQL注入攻击。
• 不需要模型类、XML配置或代码生成：仅提供连接字符串即可开箱即用。
• 由一个名为ORM的主要类组成。其他类以Idiorm为前缀。全局命名空间污染最小。
• 数据库无关。目前支持SQLite、MySQL、Firebird和PostgreSQL。可能支持其他数据库，请尝试一下！
• 支持模型集合，并使用方法链来过滤或一次性对多个结果应用操作。
• 支持多个连接
• 符合PSR-1的方法（任何方法都可以用驼峰式命名而不是下划线来调用，例如find_many()变为findMany()） - 您需要PHP 5.3+。

文档

文档托管在Read the Docs上：idiorm.rtfd.org

构建文档

您需要安装Sphinx，然后在docs文件夹中运行

make html

现在文档将在docs/_build/html/index.html

让我们看看一些代码

$user = ORM::for_table('user')
    ->where_equal('username', 'j4mie')
    ->find_one();

$user->first_name = 'Jamie';
$user->save();

$tweets = ORM::for_table('tweet')
    ->select('tweet.*')
    ->join('user', array(
        'user.id', '=', 'tweet.user_id'
    ))
    ->where_equal('user.username', 'j4mie')
    ->find_many();

foreach ($tweets as $tweet) {
    echo $tweet->text;
}

变更日志

1.5.1 - 发布于2014年6月23日

• 命名参数绑定已损坏 [cainmi] - 问题 #221

1.5.0 - 发布于2014年6月22日

• 支持多个OR条件 [lrlopez] - 问题 #201
• 为选择多个记录添加where_id_in() [lrlopez] - 问题 #202
• 添加复合主键支持 [lrlopez] - 问题 #171
• 在查询中添加原始JOIN源 [moiseevigor] - 问题 #163
• offsetExists() 应该对于 null 值返回 true，解决 #181 [cainmi] - 问题 #214
• 自定义缓存回调函数 [peter-mw] - 问题 #216
• 限制更新/删除操作中的 null 主键，解决 #203 [cainmi] - 问题 #205
• 确保参数类型处理正确 [charsleysa] & [SneakyBobito] - 问题 #206 & 问题 #208
• 减少聚合函数上的类型转换以允许字符 [herroffizier] - 问题 #150
• 防止无效的方法调用引发无限递归 [michaelward82] - 问题 #152
• 添加查询日志的时间 - 将查询时间参数添加到外部日志记录回调函数 [AgelxNash] - 问题 #180
• 更改数据库数组访问以确保始终正确设置 [falmp] - 问题 #159
• 允许取消设置数据库 (ORM::set_db(null)) 以使测试再次工作 [borrel] - 问题 #160
• 纠正 问题 #176：在构建选择之前确保数据库设置正确 [kendru] - 问题 #197
• 将 HHVM 添加到 travis-ci 构建矩阵 [ptarjan] - 问题 #168
• 改进 where 语句优先级文档 [thomasahle] - 问题 #190
• 改进测试检查 [charsleysa] - 问题 #173

1.4.1 - 发布日期 2013-12-12

修复更新以移除损坏的拉取请求 - 可能会影响利用了在 1.4.0 中合并的 "find_many() 现在返回一个以数据库主键作为数组键的关联数组" 改变的 1.4.0 用户。

• 撤销拉取请求/问题 #133，因为它以前未预料到的方式破坏了向后兼容性（见 #162、#156 和 #133） - 对将此更改合并到 Idiorm 感到抱歉 - 关闭 问题 156

1.4.0 - 发布日期 2013-09-05

• find_many() 现在返回一个关联数组，其中数据库的主键作为数组键 [Surt] - 问题 #133
• 调用 set() 和 set_expr() 返回 $this，允许它们进行链式调用 [Surt]
• 为 Idiorm 添加符合 PSR-1 的 camelCase 方法调用（需要 PHP 5.3+） [crhayes] - 问题 #108
• 添加静态方法 get_config() 以访问当前配置 [javierd] - 问题 #141
• 添加日志回调功能 [lalop] - 问题 #130
• 添加对 MS SQL TOP 限制样式的支持（自动用于 PDO 驱动程序：sqlsrv、dblib 和 mssql） [numkem] - 问题 #116
• 在 WHERE 子句中使用表别名 [vicvicvic] - 问题 #140
• 在调用聚合函数时忽略结果列 [tassoevan] - 问题 #120
• 改进文档 [bruston] - 问题 #111
• 改进 get_db() 的 PHPDoc [mailopl] - 问题 #106
• 改进文档 [sjparsons] - 问题 #103
• 使 tests/bootstrap.php 与 HHVM 兼容 [JoelMarcey] - 问题 #143
• 修复 docblock [ulrikjohansson] - 问题 #147
• 修复查询文档中错误的变量名 [fridde] - 问题 #146

1.3.0 - 发布于 2013-01-31

• 文档已迁移至 idiorm.rtfd.org，现在使用 Sphinx 构建
• 添加对多个数据库连接的支持 - 解决 问题 #15 [tag]
• 添加原始执行功能 - 解决 问题 #40 [tag]
• 添加 get_last_statement() - 解决 问题 #84 [tag]
• 添加 HAVING 子句功能 - 解决 问题 #50
• 添加 is_new 方法 - 解决 问题 #85
• 将模型实例添加对ArrayAccess的支持，允许通过$model['field']以及$model->field访问属性 - 问题 #51
• 为模型集合添加结果集对象，支持方法链以一次过滤或应用多个结果的操作 - 问题 #51 和 #22
• 添加对Firebird的支持，支持ROWS和TO结果集限制和标识符引号 [mapner] - 问题 #98
• 使用RETURNING修复PostgreSQL的最后插入ID - 解决问题 #62 和 #89 [laacz]
• 执行查询后重置Idiorm，以允许调用count()然后find_many() [fayland] - 问题 #97
• 将Composer更改为使用classmap，以更好地支持自动加载 [javierd] - 问题 #96
• 为delete_many添加查询日志 [tag]
• 修复使用set_expr时不会触发查询创建的问题 - 解决 问题 #90
• 在"_quote_identifier_part"中转义引号符号 - 解决 问题 #74
• 修复聚合函数在需要浮点数时始终返回int的问题 - 解决 问题 #92
• 将测试移动到PHPUnit以统一方法测试和查询生成测试

1.2.3 - 发布于2012-11-28

• 修复问题 #78 - 移除PHP 5.3静态调用的使用

1.2.2 - 发布于2012-11-15

• 修复输入参数部分索引、部分关联的问题

1.2.1 - 发布于2012-11-15

• 修复由于IdiormStringException没有扩展Exception而导致的微小错误

1.2.0 - 发布于2012-11-14

• 为安装通过packagist的composer设置 (j4mie/idiorm)
• 添加order_by_expr方法 [sandermarechal]
• 添加对不带参数的原始查询的支持 [sandermarechal]
• 添加通过将关联数组传递给set方法一次性设置多个属性的支持 [sandermarechal]
• 允许将关联数组传递给configure方法 [jordanlev]
• Patch以允许空的Paris模型被保存 ([j4mie/paris]) - 问题 #58
• 添加select_many和select_many_expr - 关闭问题 #49 和 #69
• 增加对 MIN、AVG、MAX 和 SUM 的支持 - 关闭问题 #16
• 增加 group_by_expr - 关闭问题 #24
• 增加 set_expr 允许将数据库表达式设置为 ORM 属性 - 关闭问题 #59 和 #43 [brianherbert]
• 防止在连接表时出现模糊的列名 - 问题 #66 [hellogerard]
• 增加 delete_many 方法 [CBeerta]
• 允许取消设置 ORM 参数 [CBeerta]
• 增加 find_array 以获取记录作为关联数组 [Surt] - 关闭问题 #17
• 修复 _log_query 中的 bug，其中在原始 where 语句等中提供了 ? 和 % - 关闭问题 #57 [ridgerunner]

1.1.1 - 发布于 2011-01-30

• 修复引号中列通配符的 bug。j4mie/paris#12
• 小幅改进文档

1.1.0 - 发布于 2011-01-24

• 增加 is_dirty 方法
• 增加基本的查询缓存
• 增加 distinct 方法
• 增加 group_by 方法

1.0.0 - 发布于 2010-12-01

• 初始版本发布