PHPackages                             rcalicdan/query-builder-primitives - 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. rcalicdan/query-builder-primitives

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

rcalicdan/query-builder-primitives
==================================

Immutable querybuilder building block for creating sql query builder libraries

010PHPCI passing

Since Oct 24Pushed 6mo agoCompare

[ Source](https://github.com/rcalicdan/query-builder-primitives)[ Packagist](https://packagist.org/packages/rcalicdan/query-builder-primitives)[ RSS](/packages/rcalicdan-query-builder-primitives/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

---

Query Builder Primitives
========================

[](#query-builder-primitives)

A collection of PHP traits for building immutable, fluent query builders. This library provides low-level primitives without forcing any specific implementation.

Installation
------------

[](#installation)

```
composer require rcalicdan/query-builder-primitives
```

Philosophy
----------

[](#philosophy)

This library provides **building blocks**, not a complete query builder. You compose the traits you need to create your own custom query builder implementation.

Architecture Overview
---------------------

[](#architecture-overview)

### Dependency Map

[](#dependency-map)

```
QueryBuilderCore (foundation - required)
  ↓
SqlBuilder (depends on: properties from condition/join/grouping traits)
  ↓
QueryConditions (depends on: QueryBuilderCore)
  ↓
QueryAdvancedConditions (depends on: QueryConditions, SqlBuilder)

QueryJoin (depends on: QueryBuilderCore)
QueryGrouping (depends on: QueryBuilderCore)
QueryDebug (depends on: all traits)

```

### Trait Descriptions

[](#trait-descriptions)

TraitPurposeDependencies`QueryBuilderCore`Core properties and table/select methodsNone (foundation)`SqlBuilder`Builds SQL query stringsQueryBuilderCore + condition/join/grouping traits`QueryConditions`Basic WHERE, HAVING, LIKE clausesQueryBuilderCore`QueryAdvancedConditions`Nested conditions, EXISTS, subqueriesQueryConditions, SqlBuilder`QueryJoin`JOIN operations (INNER, LEFT, RIGHT, CROSS)QueryBuilderCore`QueryGrouping`GROUP BY, ORDER BY, LIMIT, OFFSETQueryBuilderCore`QueryDebug`Debug utilities (toSql, dump, dd)All traitsQuick Start
-----------

[](#quick-start)

### Minimal Query Builder

[](#minimal-query-builder)

```