PHPackages                             biohzrdmx/datum-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. biohzrdmx/datum-php

ActiveLibrary[Database & ORM](/categories/database)

biohzrdmx/datum-php
===================

Simple (as in VERY simple) database abstraction layer

1.0(3y ago)012MITPHPPHP >=8.1

Since Feb 10Pushed 3y ago1 watchersCompare

[ Source](https://github.com/biohzrdmx/datum-php)[ Packagist](https://packagist.org/packages/biohzrdmx/datum-php)[ RSS](/packages/biohzrdmx-datum-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

datum-php
=========

[](#datum-php)

Simple (as in VERY simple) database abstraction layer

### Basic usage

[](#basic-usage)

First require `biohzrdmx/datum-php` with Composer.

Then create a `Database` instance, to call the constructor you will need an `AdapterInterface` implementation instance; there are two adapters included: `MySQLAdapter` and `SQLiteAdapter`, both of which extend from `PDOAdapter`:

```
$options = [
  'host' => getenv('TEST_DB_HOST') ?: 'localhost',
  'name' => getenv('TEST_DB_NAME') ?: 'test',
  'user' => getenv('TEST_DB_USER') ?: 'root',
];
$adapter = new MySQLAdapter($options);
$database = new Database($adapter);
```

Or using SQLite:

```
$options = [
  'file' => 'path/to/database.sqlite'
];
$adapter = new SQLiteAdapter($options);
$database = new Database($adapter);
```

#### Simple queries

[](#simple-queries)

To run a simple query use the `query` method:

```
$database->query("CREATE TABLE test ...");
```

```
$database->query("DROP TABLE IF EXISTS test");
```

For `INSERT` statements you can easily get the auto-increment ID with the `lastInsertId` method:

```
$database->query("INSERT INTO ...");
$id = $database->lastInsertId();
```

If you need to do more complex stuff, you may pass a `Closure` as the third argument, to manipulate the `PDOStatement` object directly:

```
$params = [4];
$row = $database->query("SELECT * FROM test WHERE id = ?", $params, function($stmt) {
  return $stmt->fetch();
});
```

#### Selecting data

[](#selecting-data)

To retrieve data from the database, use the `select` method:

```
$rows = $database->select("SELECT * FROM test");
```

If you need to pass parameters, pass an `array` as the second argument:

```
$params = ['Draft'];
$rows = $database->select("SELECT * FROM test WHERE status = ?", $params);
```

Named parameters are supported too:

```
$params = ['status' => 'Draft'];
$rows = $database->select("SELECT * FROM test WHERE status = :status", $params);
```

To retrieve just one row, use the `first` method:

```
$params = ['id' => 2];
$row = $database->first("SELECT * FROM test WHERE id = :id", $params);
```

You can also query single, scalar values with the `scalar` method:

```
$count = $database->scalar("SELECT count(*) FROM test");
```

Chunking is also possible by means of the `chunk` method:

```
$params = ['Published'];
$database->chunk(100, "SELECT id, title FROM test WHERE status = ?", $params, function($rows) {
  foreach ($rows as $row) {
    // Do something with the row data
  }
});
```

Just pass the number of rows per chunk, the query, its parameters as an `array` and a `Closure` that will be executed for each chunk, and that receives the `$rows`.

#### Transactions

[](#transactions)

Automatic transactions are supported, if the query generates an error the transaction will be rolled-back automatically, otherwise it will commit.

To use them, call the `transaction` method:

```
$database->transaction(function($database) {
  $params = ['Draft', 2];
  $database->query("UPDATE test SET status = ? WHERE id = ?", $params);
});
```

Pass a `Closure`, inside it you will call your queries by using the `$database` argument that it receives.

You can also use manual transactions with the `begin`, `commit` and `rollback` methods:

```
$params = ['Published', 3];
try {
  $database->begin();
  $database->query("UPDATE test SET status = ? WHERE id = ?", $params);
  $database->commit();
} catch (Exception $e) {
  $database->rollback();
}
```

### Licensing

[](#licensing)

This software is released under the MIT license.

Copyright © 2023 biohzrdmx

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

### Credits

[](#credits)

**Lead coder:** biohzrdmx [github.com/biohzrdmx](http://github.com/biohzrdmx)

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1193d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/44b968bb45d47a621ce8e81c422ef4c126316a702156a7faf96df75610cc0d45?d=identicon)[biohzrdmx](/maintainers/biohzrdmx)

---

Top Contributors

[![biohzrdmx](https://avatars.githubusercontent.com/u/2053303?v=4)](https://github.com/biohzrdmx "biohzrdmx (2 commits)")

### Embed Badge

![Health badge](/badges/biohzrdmx-datum-php/health.svg)

```
[![Health](https://phpackages.com/badges/biohzrdmx-datum-php/health.svg)](https://phpackages.com/packages/biohzrdmx-datum-php)
```

###  Alternatives

[doctrine/orm

Object-Relational-Mapper for PHP

10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database

The Illuminate Database package.

2.8k52.4M9.4k](/packages/illuminate-database)[ramsey/uuid-doctrine

Use ramsey/uuid as a Doctrine field type.

90440.3M211](/packages/ramsey-uuid-doctrine)[reliese/laravel

Reliese Components for Laravel Framework code generation.

1.7k3.4M16](/packages/reliese-laravel)[wildside/userstamps

Laravel Userstamps provides an Eloquent trait which automatically maintains `created\_by` and `updated\_by` columns on your model, populated by the currently authenticated user in your application.

7511.7M13](/packages/wildside-userstamps)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)