PHPackages                             d0niek/php-generic - 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. d0niek/php-generic

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

d0niek/php-generic
==================

Generator for generic array/vector.

1.0.2(9y ago)3121MITPHPPHP ^7.1

Since Apr 11Pushed 7y ago1 watchersCompare

[ Source](https://github.com/d0niek/php-generic)[ Packagist](https://packagist.org/packages/d0niek/php-generic)[ Docs](https://github.com/d0niek/php-generic)[ RSS](/packages/d0niek-php-generic/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependencies (4)Versions (6)Used By (0)

Prepare for future with php-generic
===================================

[](#prepare-for-future-with-php-generic)

According to this [article](https://www.sitepoint.com/creating-strictly-typed-arrays-collections-php/)which shows how to create strictly typed arrays and collections in Php7, php-generic generator was born.

---

There is some [discusion](https://wiki.php.net/rfc/generic-arrays) about generic in Php but who knows when it comes to us.

It is not exacly what you know from Java or C++ where generic looks like `Vector()`, `Array()` or `Vector()`.

Here generics looks like `VectorInt`, `ArrayBool` and `VectorUser`so I hope when they come to nativ Php all what you need to do will be:

1. Replace all `VectorType`, `ArrayType` to `Vector`, `array`,
2. Delete directory where you store all generated array/vector,
3. Enjoy a nice day.

What generics are (not)
-----------------------

[](#what-generics-are-not)

They are not collections like Doctrine or Laravel Collections. They are like normal php array which can store values one type. `array` can store only numeric values which will converted to `int`so you can not push `'some string value'` to it.

Install
-------

[](#install)

```
$ composer require d0niek/php-generic
```

Generate generic `array`
------------------------------

[](#generate-generic-arraytype)

There is a bin command that you should find in **vendor/bin**or somewhere else according to your **composer.json** settings.

To generate a generic array run:

```
$ bin/generic generate:array [-s|--save [SAVE]] [--]
```

where:

- **-s**|**--saveCollection** - do you want to save generated array for future regenerate (default **true**),
- **type** - is a type of generic array. It can be simple type (bool, int, float, string, array) or complex type (\\YourApp\\Module\\Repository\\User),
- **namespace** - is a namespace where new generic array will be save. Remember that namespace's directory have to exists. To separate namespace parts use **\\\\** or **/** to speed up typing if your namespace is 1:1 with your directory structure

For example you have project in **/path/to/project** and your **composer.json** contains this kind of entry:

```
"autoload": {
    "psr-4": {
        "VendorName\\AppName\\": "src/"
    }
}
```

Now, when you call command like this:

```
$ bin/generic generate:array int VendorName\\AppName\\Collections
```

new generic array `ArrayInt` will be save to **/path/to/project/src/Collections/** directory. If this directory does not exists, exceptions will be throw.

> Tip! Store all php-generics in one diretory and add it to **.gitignore**. When php will start support generics, replace `ArrayInt` to `array` and remove php-generic directory.

Generate generic `Vector`
-------------------------------

[](#generate-generic-vectortype)

You can alse generate generic [\\Ds\\Vector](http://php.net/manual/en/class.ds-vector.php)(it is new data structure since Php7, [here](https://medium.com/@rtheunissen/efficient-data-structures-for-php-7-9dda7af674cd)you can and you should read about it!). To do this just run:

```
$ bin/generic generate:vector [-s|--save [SAVE]] [--]
```

parameters means exacly the same whats means when you run `generate:array`.

Regenerate
----------

[](#regenerate)

By defaule generated array/vector are save in **generated-colletions.json** file in your root app path. Keep this file in repository and ignore all generated php-generics. When you clone repository, after `composer install` run:

```
$ bin/generic collections:regenerate
```

and all your collections will be regenerate.

Select data from DB
-------------------

[](#select-data-from-db)

Now you can create in easy way specific generic when you are selecting data from DB

```
class UserRepository implements UserRepositoryInterface
{
    ...

    /**
     * @inheritDoc
     */
    public function findAll(): VectorUser
    {
        $users = new VectorUser();
        $mysqli = new \mysqli('localhost:3306', 'user', 'password', 'db');

        $mysqliResult = $mysqli->query('SELECT id, name FROM users LIMIT 10');
        if ($mysqliResult !== false) {
            while (($user = $mysqliResult->fetch_object(User::class)) !== null) {
                $users->push($user);
            }
        }

        $mysqli->close();

        return $users;
    }

    ...
}
```

Test
----

[](#test)

Before you run tests remember to regenerate collections. Run:

```
$ bin/generic collections:regenerate
```

and now you can run

```
$ phpunit
```

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity62

Established project with proven stability

 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

Every ~0 days

Total

4

Last Release

3366d ago

Major Versions

0.1.0 → 1.0.02017-04-11

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/9316891?v=4)[Damian](/maintainers/d0niek)[@d0niek](https://github.com/d0niek)

---

Top Contributors

[![d0niek](https://avatars.githubusercontent.com/u/9316891?v=4)](https://github.com/d0niek "d0niek (27 commits)")

---

Tags

arraygeneratorgenericphpphp71vectorphparraygeneratorvectorgenericphp71

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/d0niek-php-generic/health.svg)

```
[![Health](https://phpackages.com/badges/d0niek-php-generic/health.svg)](https://phpackages.com/packages/d0niek-php-generic)
```

###  Alternatives

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

101466.4k45](/packages/friendsoftypo3-content-blocks)

PHPackages © 2026

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