Download the PHP package oliverde8/associative-array-simplified without Composer
On this page you can find all versions of the php package oliverde8/associative-array-simplified. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download oliverde8/associative-array-simplified
More information about oliverde8/associative-array-simplified
Files in oliverde8/associative-array-simplified
Package associative-array-simplified
Short Description Allow simplified manupulation of recursive associative arrays.
License MIT
Informations about the package associative-array-simplified
PHP - Associative Arrays Simplified
This library allow simplified manipulation of recursive associative arrays with an object oriented aproach in php.
Associative Array
This is the main clas of the library. It allows the manipulation of the association arrays with ease.
This allow you to get data from an associative array with ease. This can be used many places even for getting information from SESSION or POST & GET values.
Typically when we try and get information from a an array of which we don't know the content we need to write a lot of conditions :
After a certain while we write a lot conditions and the array is very nested it becomes difficult to understand. This library makes it much easier to write code of this type & makes it easier to read and understand. The code above is simply replaced by :
Requirments
PHP
5.4 or higher.
Installation
You should always install the library using composer.
Manual installation is not recomended and not supported.
Usage Exemples
Get values from a simple array
Get a value and if no value is set get a default one
Get nested values recursively
And of course you can continue to use default values with the recursive get.
Use separators in the string keys to get nested values
The default separator is /
You can set new values or replace them.
You can get back your array
Using custom separators
When creating the AssociativeArray you can specify the separator to use. So instead of
You can write
Example usage of static methods
The class has also static methods to manipulate your array directly. The method of the objects actually uses these static methods to manipulate the array.
And to set new data.
Other functions
The class has also other functions.
- clear : Empties all the data from the array.
- keyExist : Checks if a key exists. (value may be null)
FAQ
Why don't the associative array has an iterator ?
Associative Array Simplified doesen't try and replace arrays; other libraries were designed to do so. This library simply makes it easier yo access values in associative arrays.
Why don't the associative array return associative array instead of normal array's ?
This is something I spent quite some time to decide, but doing it that way would require during the creation of the associative array to process the array to create the nested associative arrays. This would have slowned then the process of creation without really increasing perormance at any other level. On long term I might create a second object working that way.
There is some questions about this how should this work :
So there is some reflexion to be done on the subject.
Why don't the assotiative array use references ?
It's planned. Current implementation is slower as it duplicated the arrays during the set operations.
...
TODO
- Add some more options (clear, disable new data ...)
- uses references to use less memory.
- create second version returning Associative Array instead of normal arrays.
- Something else? Open a ticket :)