README

https://j4mie.github.io/idiormandparis/

仅维护模式

从版本1.5.0开始，Idiorm和Paris被认为是功能完整的。虽然它们将继续通过修复错误进行维护，但从这一点开始将不再添加新功能。这意味着如果pull request对API进行了破坏性更改或需要库的其他任何版本号的增加，则不会合并。

请勿提交功能请求或API破坏性更改，因为它们将被无礼地关闭。

我应该使用Idiorm/Paris吗？

如果您正在启动一个新项目

不建议在新的项目中使用Idiorm或Paris。

我建议您使用来自Laravel的Eloquent数据库库，因为Taylor在编写它时基于Idiorm。这意味着那里有许多相同的概念，但它维护得更积极，并且代码风格更现代。

如果您有基于Idiorm或Paris的现有项目

您可以使用这两个项目，因为它们将继续接收安全补丁和错误修复。需要注意的是，如果它们需要更改以破坏向后兼容性，则未来的PHP版本可能不会得到支持。

此时，您可以选择使用另一个数据库库，例如Laravel中的Eloquent（如上所述）或决定分支Idiorm和/或Paris以添加您自己的修改。

但是，为什么？

有关此项目的状态的更多信息，请参阅j4mie#360

一个轻量级的近乎零配置的面向对象关系映射器和流畅查询构建器，适用于PHP5及以上版本。

在PHP 5.2.0+上进行了测试 - 可能可以在更早的版本上使用PDO和正确的数据库驱动程序工作。

在BSD许可证下发布。

另请参阅：Paris，一个基于Idiorm的Active Record实现。

功能

使简单的查询和简单的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，然后在文档文件夹中运行

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;
}

测试

测试是用PHPUnit编写的，可以通过composer运行

composer test

为了在PHP 5.2上进行测试（Idiorm支持回这个版本的PHP），在./test/docker_for_php52中有Docker设置 - 在那里的readme中查看更多信息。

变更日志

1.5.8 - 发布于2022年7月18日

更新以支持PHP 8.1 [edlerd 和 aaronpk] - 问题 #370 和问题 #372
GitHub actions用于执行单元测试/CI [Treffynnon 和 yan12125]

1.5.7 - 发布于2020年4月29日

修复在调用join()时的参数顺序 [CatalinFrancu] - 问题 #357

1.5.6 - 发布于2018年5月31日

在reset_db()中将null分配给self::$_db以确保PDO关闭连接 [bleakgadfly] - 问题 #338

1.5.5 - 发布于2018年1月5日

添加用于在PHP 5.2上测试的Docker设置（使用PHPUnit 3.6.12，这是与PHP 5.2兼容的最后一个版本） [Treffynnon]

1.5.4 - 发布于2018年1月4日

当返回缓存的结果时重置Idiorm状态 [fayland (和 Treffynnon)] - 问题 #319
修复travis构建以支持PHP 5.2+（添加7.0和7.1）并记录对新PHP版本的支持 [Treffynnon]
为selectMany()添加正确的PHPDoc注释 [kawausokun] - 问题 #325
将pdo_sqlite添加到composer require-dev依赖中 [qyanu] - 问题 #328

1.5.3 - 发布于2017年3月21日

记录raw_execute()方法并在查询文档中添加对get_db()的注释 - [Treffynnon]

1.5.2 - 发布于2016年12月14日

修复自动递增复合键插入 [lrlopez] - 问题 #233 和拉取 #235
为魔法方法添加@method标签 [stellis] - 问题 #237
确保当提供null或空字符串时，is_dirty()返回正确的结果 [tentwofour] - 问题 #268
在readme文件中添加Code Climate徽章 [e3betht] - 问题 #260
导航中的错误 [leongersen] - 问题 #257
支持命名占位符日志记录和测试 [m92o] - 问题 #223
having_id_is() 引用未定义变量 $value [Treffynnon] - 问题 #224
文档修复 - where_any_is() 的ORM查询输出 [uovidiu] - 问题 #306
修复代码风格，防止嵌套循环使用相同的变量名 [mkkeck] - 问题 #301
记录内置查询日志器的不足 [Treffynnon] - 问题 #307
将phpunit添加到开发依赖中，添加 composer test 脚本快捷方式并修复测试引导中的PDO模拟 [Treffynnon]
针对多个原始where子句的新测试 [Treffynnon] - 问题 #236
从travis-ci容器中移除PHP 5.2以进行测试（注意 Idiorm尽管如此仍然支持PHP 5.2） [Treffynnon]

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]
将符合 PSR-1 的 camelCase 方法调用添加到 Idiorm（需要 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 [标签]
添加原始执行功能 - 关闭问题 #40 [标签]
添加 get_last_statement() - 关闭问题 #84 [标签]
添加 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而有时需要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日

设置Composer通过packagist安装（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

初始版本

chezrd / idiorm

维护者

详情