Download the PHP package code-distortion/array-object-extended without Composer
On this page you can find all versions of the php package code-distortion/array-object-extended. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download code-distortion/array-object-extended
More information about code-distortion/array-object-extended
Files in code-distortion/array-object-extended
Package array-object-extended
Short Description ArrayObjectExtended class which adds methods missing from PHP's ArrayObject
License MIT
Homepage https://github.com/code-distortion/array-object-extended
Informations about the package array-object-extended
ArrayObjectExtended
code-distortion/array-object-extended provides a substitute ArrayObject class that includes the methods missing from PHP's ArrayObject.
Introduction
PHP has many array functions to manipulate arrays. It also has an ArrayObject which is a class that acts like an array.
However, most of the regular array functions aren't implemented by ArrayObject.
This package offers ArrayObjectExtended which extends from PHP's ArrayObject, and adds many of the missing methods in.
ArrayObjectExtended is not intended to:
- improve the methods or functionality,
- be complete (it adds methods where it makes sense),
- be a Collection class, or
- provide a fluent interface.
It is designed to be faithful to PHP's original method names, parameter usage and return types.
In almost all cases, the only difference between the new class methods and the original is that the $array or $haystack parameter is removed (because the object inherently contains the array, so it doesn't need to be passed).
Installation
Install the package via composer:
Usage
ArrayObjectExtended acts like PHP's ArrayObject. Instantiate and start using it like normal. e.g.
You can extend from ArrayObjectExtended to add in your own functionality.
Available Methods
Notes
ArrayObjects have a key TKey and value TValue type. You can define them in your classes when you extend from ArrayObjectExtendend.
For methods like values() and map(..), a key consideration in having them return plain arrays is those key and value type requirements. If they updated the object, or returned new instances of the class, we can't be sure their keys and values would be valid types.
On-Change Hook
Whenever a change is made to the data in an ArrayObjectExtendend instance, it calls onAfterUpdate(). This gives you an opportunity to clear internal caches, etc.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
SemVer
This library uses SemVer 2.0.0 versioning. This means that changes to X indicate a breaking change: 0.0.X, 0.X.y, X.y.z. When this library changes to version 1.0.0, 2.0.0 and so forth, it doesn't indicate that it's necessarily a notable release, it simply indicates that the changes were breaking.
Treeware
This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.
Contributing
Please see CONTRIBUTING for details.
Code of Conduct
Please see CODE_OF_CONDUCT for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.