PHPackages                             bitapps/wp-database - 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. bitapps/wp-database

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

bitapps/wp-database
===================

A simple orm with wpdb

2.0.1(3w ago)19.7k↓80%GPL-2.0-or-laterPHPPHP >=8.0

Since Dec 23Pushed 5d ago2 watchersCompare

[ Source](https://github.com/Bit-Apps-Pro/wp-database)[ Packagist](https://packagist.org/packages/bitapps/wp-database)[ RSS](/packages/bitapps-wp-database/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (9)Versions (25)Used By (0)

wp-database
===========

[](#wp-database)

A small ActiveRecord ORM with a fluent query and schema builder on top of WordPress' `$wpdb`.

Install
-------

[](#install)

```
// composer.json
"repositories": [
  { "type": "vcs", "url": "https://github.com/Bit-Apps-Pro/wp-database" }
]
```

```
composer require bitapps/wp-database:dev-main
```

Quick start
-----------

[](#quick-start)

```
use BitApps\WPDatabase\Model;

class Contact extends Model
{
    protected $fillable = ['name', 'email'];

    public function deals()
    {
        return $this->hasMany(Deal::class, 'contact_id', 'id');
    }
}

Contact::insert(['name' => 'Ada', 'email' => 'ada@x.com']);

$active = Contact::where('is_active', 1)
    ->withCount('deals')
    ->orderBy('name')->asc()
    ->get();                       // Collection of Contact models
```

Documentation
-------------

[](#documentation)

- **[Usage guide](docs/usage.md)** — models, query builder, relationships, casts, events, transactions, and more.
- **[Relationships](docs/relations.md)** — `hasOne`/`belongsTo`/`hasMany`/`belongsToMany`, eager & lazy loading, relation aggregates, and limitations.
- **[Schema builder](docs/schema.md)** — table creation, columns, indexes, and migrations.
- **[Breaking changes](docs/breaking-changes.md)** — upgrade notes.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance97

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 73.5% 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

Every ~67 days

Recently: every ~141 days

Total

14

Last Release

24d ago

Major Versions

1.11 → 2.0.02026-07-06

PHP version history (2 changes)1.0PHP ^7.4 || ^8.0

2.0.0PHP >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/287eaff46162d59243dbe681021af1569719ed94209acf697993cfdd018cf2fe?d=identicon)[Bit-Apps-Pro](/maintainers/Bit-Apps-Pro)

---

Top Contributors

[![abdul-kaioum](https://avatars.githubusercontent.com/u/58425930?v=4)](https://github.com/abdul-kaioum "abdul-kaioum (125 commits)")[![Arif-un](https://avatars.githubusercontent.com/u/19432983?v=4)](https://github.com/Arif-un "Arif-un (18 commits)")[![csemazharul](https://avatars.githubusercontent.com/u/54615735?v=4)](https://github.com/csemazharul "csemazharul (18 commits)")[![shuvomohajan](https://avatars.githubusercontent.com/u/34658843?v=4)](https://github.com/shuvomohajan "shuvomohajan (6 commits)")[![anisurov](https://avatars.githubusercontent.com/u/23195240?v=4)](https://github.com/anisurov "anisurov (3 commits)")

---

Tags

wordpressdatabasewpdb

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/bitapps-wp-database/health.svg)

```
[![Health](https://phpackages.com/badges/bitapps-wp-database/health.svg)](https://phpackages.com/packages/bitapps-wp-database)
```

###  Alternatives

[berlindb/core

A collection of PHP classes and functions that aims to provide an ORM-like experience and interface to WordPress database tables.

271468.5k13](/packages/berlindb-core)[williarin/wordpress-interop

Interoperability library to work with WordPress database in third party apps

6711.5k2](/packages/williarin-wordpress-interop)[10quality/wp-query-builder

Wordpress Query Builder class library for custom models and data querying.

4018.3k](/packages/10quality-wp-query-builder)[bradmkjr/monolog-wordpress

A handler for Monolog that sends messages to MySQL via WordPress Functions

2717.6k](/packages/bradmkjr-monolog-wordpress)[friedolinfoerder/wp-activerecord

An ActiveRecord implementation for WordPress

238.0k](/packages/friedolinfoerder-wp-activerecord)[codesvault/howdy-qb

Mysql Query Builder for WordPress

371.3k1](/packages/codesvault-howdy-qb)

PHPackages © 2026

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