PHPackages                             gnbit/alabra-entity - 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. [Utility & Helpers](/categories/utility)
4. /
5. gnbit/alabra-entity

ActiveLibrary[Utility & Helpers](/categories/utility)

gnbit/alabra-entity
===================

entity class

0.1(4y ago)02.6kMITPHPPHP ^7 || ^8

Since Dec 30Pushed 2y ago2 watchersCompare

[ Source](https://github.com/gnbitdev/alabra-entity)[ Packagist](https://packagist.org/packages/gnbit/alabra-entity)[ Docs](https://github.com/gnbit/alabra-entity)[ RSS](/packages/gnbit-alabra-entity/feed)WikiDiscussions main Synced 4d ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Alabra Entity
=============

[](#alabra-entity)

**Alabra Entity** is a PHP package that provides a flexible and extensible way to work with object collections. It includes an `EntityCollection` class that implements common array interfaces such as `ArrayAccess`, `IteratorAggregate`, and `Countable`. This allows for easy manipulation and traversal of collections of objects.

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

[](#installation)

You can install this package via [Composer](https://getcomposer.org/):

```
composer require alabra/alabra-entity
```

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

Creating Entity

```
class UserProfile implements EntityInterface
{
    use EntityTrait;

    private string $username;
    private PersonalInfo $personalInfo;

    public function __construct(
        private string $firstName,
        private string $lastName,
        private string $email,
        private int $age,
        private bool $isSubscribed
    )
    {

    }

    public function setUsername(string $username): void
    {
        $this->username = $username;
    }

    public function setPersonalInfo(PersonalInfo $personalInfo): void
    {
        $this->personalInfo = $personalInfo;
    }
}
```

```
        $personalInfo = new PersonalInfo('123 Main St', '555-1234');
        $this->userProfile = new UserProfile('Jhon', 'Smith', 'test@example.com', 40, true);
        $this->userProfile->setUsername('other');
        $this->userProfile->setPersonalInfo($personalInfo);

        //Methods
        $this->userProfile->toArray();
        $this->userProfile->toJson();
        $this->userProfile->getIterator();
```

### Create Collections

[](#create-collections)

```
use Alabra\Entity\EntityCollection;

// Create an instance of EntityCollection
$collection = new EntityCollection();

// Add objects to the collection
$object1 = new YourEntityClass();
$object2 = new YourEntityClass();

$collection[] = $object1;
$collection[] = $object2;

// Access objects by key or iterate through the collection
foreach ($collection as $key => $object) {
    // Do something with each object
}

// Check if an offset exists
if (isset($collection['some_key'])) {
    // Object with key 'some_key' exists
}

// Remove an object by key
unset($collection['some_key']);

// Get the number of objects in the collection
$count = count($collection);
```

### Advanced Usage

[](#advanced-usage)

#### Using a Key Property

[](#using-a-key-property)

If your objects have a specific property that should be used as the key in the collection, you can set it using the setKeyPropertyName method:

```
use Alabra\Entity\EntityCollection;

// Create an instance of EntityCollection
$collection = new EntityCollection();

// Set the key property name
$collection->setKeyPropertyName('id');

// Add objects to the collection
$object1 = new YourEntityClass('A', 'B', 1, true, 1.5, 'key1');
$object2 = new YourEntityClass('C', 'D', 2, false, 2.5, 'key2');

$collection[] = $object1;
$collection[] = $object2;

// Access objects by their key property
$objectByKey = $collection['key1']; // Returns $object1
```

#### Merging Collections

[](#merging-collections)

You can merge two collections, either using a key property or by a simple merge:

```
use Alabra\Entity\EntityCollection;

// Create two instances of EntityCollection
$collection1 = new EntityCollection();
$collection2 = new EntityCollection();

// Merge collections
$collection1->merge($collection2->toArray());
```

#### Transforming Collections to Arrays

[](#transforming-collections-to-arrays)

You can easily convert the collection and its objects to an associative array:

```
use Alabra\Entity\EntityCollection;

// Create an instance of EntityCollection
$collection = new EntityCollection();

// Add objects to the collection
$object1 = new YourEntityClass('A', 'B', 1, true, 1.5);
$object2 = new YourEntityClass('C', 'D', 2, false, 2.5);

$collection[] = $object1;
$collection[] = $object2;

// Convert the collection to an array
$arrayRepresentation = $collection->toArray();
```

License
-------

[](#license)

This package is open-sourced software licensed under the MIT license.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

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

1595d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/523f5103721721e8b4108959e2362c2096c9f7e6aa6c0fae8019f70265ff2353?d=identicon)[benjamin741](/maintainers/benjamin741)

---

Top Contributors

[![benjamingb](https://avatars.githubusercontent.com/u/249177?v=4)](https://github.com/benjamingb "benjamingb (6 commits)")[![gnbitdev](https://avatars.githubusercontent.com/u/69834726?v=4)](https://github.com/gnbitdev "gnbitdev (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/gnbit-alabra-entity/health.svg)

```
[![Health](https://phpackages.com/badges/gnbit-alabra-entity/health.svg)](https://phpackages.com/packages/gnbit-alabra-entity)
```

PHPackages © 2026

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