bitapps / wp-database

2.0.5 2026-09-03 13:41 UTC

Requires

• php: >=8.0

Requires (Dev)

• dealerdirect/phpcodesniffer-composer-installer: ^0.7
• friendsofphp/php-cs-fixer: ^3.10
• phpcompatibility/phpcompatibility-wp: *
• phpunit/phpunit: ^11.5
• sirbrillig/phpcs-variable-analysis: *

GPL-2.0-or-later

• Bit-Code-Developer

• database
• wordpress
• wpdb

Published on Packagist.org on 2026-09-03 13:45 UTC

README

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

Install

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

composer require bitapps/wp-database:dev-main

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' => '[e-mail]']);

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

Documentation

• Usage guide — models, query builder, relationships, casts, events, transactions, and more.
• Relationships — hasOne/belongsTo/hasMany/belongsToMany, eager & lazy loading, relation aggregates, and limitations.
• Schema builder — table creation, columns, indexes, and migrations.
• Breaking changes — upgrade notes.