README

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

警告：这只是一个对 "https://github.com/j4mie/idiorm/" 的维护分支

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

在PHP 5.3+上进行了测试 - 可能适用于早期版本，前提是有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;
}

变更日志

修复了ORM::__callStatic()

2.1.0 - 发布于2015-12-03

修复了ORM->is_dirty() [tentwofour] - pr #268
修复了ORM->is_new() [nicolas-brousse] - pr #249
修复了自增复合键插入 [lrlopez] - pr #235
增加了 "ORM->reset_order_by()" [nicolas-brousse] - +
使用静态关键字代替 self [maboiteaspam] - +
使用类型转换处理 limit 和 offset

2.0.0 - 发布于 2015-12-02

增加了 PSR-4 自动加载器
增加了 phpdocs
修复了 ORM::having_id_is() 中缺少变量的错误

1.5.1 - 发布于 2014-06-23

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

1.5.0 - 发布于 2014-06-22

支持多个 OR 条件 [lrlopez] - 问题 #201
使用 where_id_in() 通过主键选择多个记录 [lrlopez] - 问题 #202
添加了复合主键支持 [lrlopez] - 问题 #171
在查询中添加了 RAW 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]
添加 raw_execute - 关闭问题 #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
修复 PostgreSQL 使用 RETURNING 的最后插入 ID - 关闭问题 #62 和 #89 [laacz]
在执行查询后重置 Idiorm，以便调用 count() 然后调用 find_many() [fayland] - 问题 #97
将 Composer 更改为使用类映射，以更好地支持自动加载 [javierd] - 问题 #96
将查询日志添加到 delete_many [标签]
修复仅使用 set_expr 时不触发查询创建的问题 - 解决问题 #90
在 "_quote_identifier_part" 中转义引号符号 - 解决问题 #74
修复聚合函数总是返回 int 而有时需要 float 的问题 - 解决问题 #92
将测试移动到 PHPUnit 以统一方法测试和查询生成测试

1.2.3 - 发布 2012-11-28

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

1.2.2 - 发布 2012-11-15

修复输入参数作为部分索引、部分关联发送的 bug

1.2.1 - 发布 2012-11-15

修复由 IdiormStringException 未扩展 Exception 引起的轻微 bug

1.2.0 - 发布 2012-11-14

为通过 packagist 安装设置 composer (j4mie/idiorm)
添加 order_by_expr 方法 [sandermarechal]
添加对不带参数的原始查询的支持 [sandermarechal]
通过将关联数组传递到 set 方法以一次设置多个属性的支持 [sandermarechal]
允许将关联数组传递到 configure 方法 [jordanlev]
允许空的 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
修复在原始 WHERE 语句等中使用 ? 和 % 供应的 _log_query 中的错误 - 解决问题 #57 [ridgerunner]

1.1.1 - 发布于 2011-01-30

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

1.1.0 - 发布于 2011-01-24

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

1.0.0 - 发布于 2010-12-01

初始发布

voku / idiorm

维护者

详细信息