README

LEAP 是一个为 Kohana PHP 框架设计的数据库管理库，可以与 DB2、Drizzle、Firebird、MariaDB、MS SQL、MySQL、Oracle、PostgreSQL 和 SQLite 等数据库协同工作。LEAP 作为不同数据库方言和连接之间的通用接口。它提供强大的查询构建器和 ORM。LEAP 的 ORM 基于活动记录设计模式，利用 PHP 对象来建模数据库表。

如果您喜欢这个项目，请确保“Star”它。

动机

LEAP 旨在成为一个简单、干净的工程。LEAP 的主要目标是创建一个可以与所有主要数据库协同工作的 Kohana PHP 框架 ORM，并且旨在成为一个真正的 Kohana 模块，因此可以直接将其放入 Kohana 的模块文件夹中并运行。尽管其他 ORM 框架（如 Doctrine）可以适配 Kohana，但这样做需要大量工作。LEAP 开发的另一个目标是创建一个 ORM，它可以利用组合键的强大功能，而许多其他 ORM（例如 Kohana 的官方 ORM、Jelly 和 Sprig）都无法处理。

特性

LEAP 提供了以下特性：

• DB2、Drizzle、Firebird、MariaDB、MS SQL、MySQL、Oracle、PostgreSQL 和 SQLite 的插件。
• 设计用于与其他 Kohana 数据库工具协同工作。
• 配置文件，用于指定数据库驱动程序（例如 PDO）和连接字符串.
• 类易于扩展。
• 用于管理资源的数据库连接池。
• 用于创建 SQL 语句的强大查询构建器。
• 清理数据以帮助防止 SQL 注入攻击。
• 能够处理非整数主键。
• 支持组合主键和组合外键。
• 在数据库字段上强制执行强数据类型。
• 允许声明字段别名。
• 使用字段适配器简化与某些数据库字段的交互。
• 用于用户登录认证的 Auth 类集。
• 一系列有用的函数。
• Leap 的 API，用于记录每个类。
• 许多教程。

入门指南

要开始使用 LEAP，请按照以下步骤操作

1. 只需从 github 下载模块（有关分支的说明见下文）。
2. 将下载解压到 Kohana 的模块文件夹中。
3. 将未压缩文件夹重命名为 "leap"。
4. 修改 leap/config/database.php。
5. 在应用文件夹的/bootstrap.php中添加"leap"模块。
6. 开始在你的应用文件夹的/classes/model/leap/文件夹中创建模型。

有关更多信息，请参阅安装LEAP的教程。

关于分支

• 3.3/master - PHP 5.3+, Kohana 3.3.X，维护中，稳定
• 3.3/develop - PHP 5.3+, Kohana 3.3.X，维护中，不稳定
• 3.3/legacy - PHP 5.2+, Kohana 3.3.X，已弃用，稳定
• 3.2/master - PHP 5.3+, Kohana 3.2.X，维护中，稳定
• 3.2/develop - PHP 5.3+, Kohana 3.2.X，维护中，不稳定
• 3.2/legacy - PHP 5.2+, Kohana 3.2.X，已弃用，稳定
• 3.1/master - PHP 5.3+, Kohana 3.1.X，维护中，稳定
• 3.1/develop - PHP 5.3+, Kohana 3.1.X，维护中，不稳定
• 3.1/legacy - PHP 5.2+, Kohana 3.1.X，已弃用，稳定

所需文件

LEAP ORM模块旨在完全独立于其他Kohana模块。然而，建议安装Kohana的数据库模块，以便您可以使用Database_Expression类。至于LEAP中的文件，您可以移除任何不使用的数据库插件。这是可能的，因为LEAP中的每个数据库插件都被认为是相互独立的。

文档

本项目附带配套网站，该网站记录了LEAP ORM的API，并包含多个示例和教程。您还可以在网上找到其他教程和示例（如果找到我们应该突出的教程，请告诉我们）。

进一步帮助

虽然LEAP与Kohana PHP框架使用简单，但您可以在Kohana的论坛或 Stack Overflow上提问以获得进一步的帮助。您还可以发送电子邮件至spadefoot.oss@gmail.com。

报告错误和提出建议

如果您在代码中找到错误或想提出建议，我们将很高兴听到您的意见。以下是您可以使用的三种方法来通知我们：

• 在本项目的问题跟踪器中记录问题。
• 创建此项目的分支并提交拉取请求。
• 发送电子邮件至spadefoot.oss@gmail.com。

已知问题

请参阅此项目的问题跟踪器以了解任何已知问题。

更新

请确保将您自己添加为该项目的监视者，以便您可以监视更新。如果您希望直接通过电子邮件接收通知，请发送电子邮件至spadefoot.oss@gmail.com。

未来开发

本项目不断得到改进和扩展。如果您想为LEAP做出贡献，请分支此项目，然后通过拉取请求发送您的添加/修改。

许可证

Apache v2.0

版权所有 © 2011–2013 Spadefoot团队。

除非另有说明，否则LEAP根据Apache许可证2.0版（“许可证”）授权；除非遵守许可证，否则不得使用这些文件。您可以在以下位置获得许可证副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则根据本许可证分发的软件按“原样”分发，不提供任何形式的明示或默示保证或条件。有关许可证的权限和限制的具体语言，请参阅许可证。