erikthiart/dbease

DBease 是一个轻量级的数据库抽象库,用于简化数据库操作。

v1.2.0 2023-10-02 08:59 UTC

This package is auto-updated.

Last update: 2024-10-01 00:09:20 UTC


README

License Latest Version Packagist GitHub Issues

DBease 是一个轻量级且易于使用的 PHP 数据库抽象库,专为 MySQL 设计,利用 PDO 的强大功能。它简化了常见的数据库操作,并提供了灵活的查询构建器,对于希望高效与数据库交互的开发者来说是一个非常有价值的工具。

功能

  • 简化 CRUD 操作:轻松执行创建、读取、更新和删除(CRUD)操作。
  • 灵活的查询构建器:通过流畅的接口构建复杂查询。
  • 自定义 SQL 执行:在需要时执行原始 SQL 查询。
  • 异常处理:强大的错误处理,提供详细的异常。
  • 查询日志:跟踪执行的查询以进行调试。
  • 表和列存在检查:验证表和列的存在。
  • Composer 友好:使用 Composer 轻松安装和管理。

安装

DBease 可以通过 Composer 安装

composer require erikthiart/dbease

入门指南

初始化 DBease

use DBease\Database;

// Initialize the database connection
$db = new Database();

插入数据

$data = [
    'name' => 'John Doe',
    'email' => 'john@example.com',
    'age' => 30,
];

// Insert into the 'users' table
$db->insert('users', $data);

更新数据

$updateData = ['status' => 'active'];

// Update records in the 'users' table where 'id' is 1
$db->update('users', $updateData, ['id' => 1]);

查询数据

// Find a single record from the 'users' table where 'id' is 1
$user = $db->find('users', ['id' => 1]);

// Find all active users
$activeUsers = $db->findAll('users', ['status' => 'active']);

执行原始 SQL

// Execute a custom SQL query
$sql = "SELECT * FROM products WHERE category = :category";
$params = ['category' => 'Electronics'];
$results = $db->raw($sql, $params);

查询构建器

// Build complex queries
$results = $db
    ->select('name, price')
    ->limit(5)
    ->offset(10)
    ->fetchWithOffset('products', ['category' => 'Electronics']);

更多示例和文档

有关更多示例和详细文档,请参阅 DBease Wiki

贡献

欢迎贡献!请查阅 贡献指南 以获取详细信息。

许可

DBease 是开源软件,根据 GNU 通用公共许可证 许可。

致谢

DBease 由 Erik Thiart 开发和维护。

支持

如果您有任何问题或需要帮助,请随时 创建一个问题