PHPackages                             sambenge/codeigniter4-sole - 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. sambenge/codeigniter4-sole

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

sambenge/codeigniter4-sole
==========================

Adds Laravel's sole() model method to CodeIgniter 4.

1.0.3(8mo ago)056MITPHPPHP >=7.4

Since Oct 9Pushed 8mo agoCompare

[ Source](https://github.com/sambenge/codeigniter4-sole)[ Packagist](https://packagist.org/packages/sambenge/codeigniter4-sole)[ RSS](/packages/sambenge-codeigniter4-sole/feed)WikiDiscussions main Synced today

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

CodeIgniter 4 Sole
==================

[](#codeigniter-4-sole)

A lightweight package that adds **Laravel-style `sole()`** behaviour to CodeIgniter 4 models.

> Ensures that a query returns **exactly one record**, otherwise throws an exception.

---

🚀 Installation
--------------

[](#-installation)

### From Packagist (recommended)

[](#from-packagist-recommended)

```
composer require sambenge/codeigniter4-sole
```

⚙️ Usage
--------

[](#️-usage)

In your model:

```
use CodeIgniter\Model;
use Bengey\Sole\SoleTrait;

class UserModel extends Model
{
    use SoleTrait;

    protected $table = 'users';
}
```

Then, in your service or controller:

```
$userModel = new UserModel();
try {
    $user = $userModel->where('email', 'john@smith.com')->sole();
    // Do something with $user
} catch (\Bengey\Sole\Exceptions\RecordNotFoundException $e) {
    // No records found
} catch (\Bengey\Sole\Exceptions\MultipleRecordsFoundException $e) {
    // More than one record found
}
```

🧠 Why use `sole()`?
-------------------

[](#-why-use-sole)

The `sole()` method is useful when you expect a query to return exactly one record. It helps to enforce this expectation by throwing exceptions if the result set is empty or contains multiple records. This can help to prevent bugs and ensure that your application behaves as expected.

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance58

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 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

269d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/13433133?v=4)[Sam](/maintainers/sambenge)[@sambenge](https://github.com/sambenge)

---

Top Contributors

[![sambenge](https://avatars.githubusercontent.com/u/13433133?v=4)](https://github.com/sambenge "sambenge (6 commits)")

### Embed Badge

![Health badge](/badges/sambenge-codeigniter4-sole/health.svg)

```
[![Health](https://phpackages.com/badges/sambenge-codeigniter4-sole/health.svg)](https://phpackages.com/packages/sambenge-codeigniter4-sole)
```

###  Alternatives

[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k117.2M118](/packages/jdorn-sql-formatter)[propel/propel1

Propel is an open-source Object-Relational Mapping (ORM) for PHP5.

8351.6M87](/packages/propel-propel1)[jfelder/oracledb

Oracle DB driver for Laravel

11518.4k](/packages/jfelder-oracledb)

PHPackages © 2026

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