PHPackages edmondscommerce/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. edmondscommerce/php-generic ActiveLibrary[Utility & Helpers](/categories/utility) edmondscommerce/php-generic =========================== Generator for generic array/vector. 3.0.0(6y ago)02.1kMITPHPPHP ^7.2 Since Apr 11Pushed 6y ago1 watchersCompare [ Source](https://github.com/edmondscommerce/php-generic)[ Packagist](https://packagist.org/packages/edmondscommerce/php-generic)[ Docs](https://github.com/edmondscommerce/php-generic)[ RSS](/packages/edmondscommerce-php-generic/feed)WikiDiscussions master Synced 3d ago READMEChangelog (1)Dependencies (5)Versions (15)Used By (0) This is a Fork ============== [](#this-is-a-fork) Please see original: This is now becoming more of a pure wrapper for php-ds to allow generating of typed implementations of the php-ds data structures. Currently there is only Vector, though more might be added as we need them PHPStan ------- [](#phpstan) Currently seeing some issues with PHPStan, suggest the following ignore errors: ``` parameters: ignoreErrors: - '#unknown class.+?HumbugBox.+?Vector#' - '#Vector.+?offset.+?\(\) should be contravariant#' - '#Cannot .+? offset int .+? Ds\\Vector#' ``` --- Original README 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 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community9 Small or concentrated contributor base Maturity66 Established project with proven stability Bus Factor1 Top contributor holds 54.2% 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 ~79 days Recently: every ~22 days Total 11 Last Release 2526d ago Major Versions 0.1.0 → 1.0.02017-04-11 1.0.6 → 2.0.02019-03-21 2.0.1 → 3.0.02019-06-14 PHP version history (2 changes)0.1.0PHP ^7.1 3.0.0PHP ^7.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/7af407ceeb8622c9c164d386ef3e95cda4c94d141240348ac5703223bb499d0e?d=identicon)[edmondscommerce](/maintainers/edmondscommerce) --- Top Contributors [![edmondscommerce](https://avatars.githubusercontent.com/u/62842?v=4)](https://github.com/edmondscommerce "edmondscommerce (32 commits)")[![d0niek](https://avatars.githubusercontent.com/u/9316891?v=4)](https://github.com/d0niek "d0niek (27 commits)") --- Tags phparraygeneratorvectorgenericphp71 ### Embed Badge ![Health badge](/badges/edmondscommerce-php-generic/health.svg) ``` [![Health](https://phpackages.com/badges/edmondscommerce-php-generic/health.svg)](https://phpackages.com/packages/edmondscommerce-php-generic) ``` ### Alternatives [tomloprod/radiance A deterministic mesh gradient avatar generator for PHP. 1393.7k](/packages/tomloprod-radiance) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)