Download the PHP package agrandesr/arrays without Composer
On this page you can find all versions of the php package agrandesr/arrays. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download agrandesr/arrays
More information about agrandesr/arrays
Files in agrandesr/arrays
Package arrays
Short Description This is a basic library to help with arrays in the code development.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package arrays
Arrays
Arrays is a composer library designed to make easy some actions withs arrays.
How to start 🚀
Follow the next steps to use Arrays, you will see that is very easy to use.
Prerequisites 📋
You will need to have installed php and composer in your computer.
Installation 🔧
You need to require the package to your project.
Next, you can use in your code. We encourage to use in the root file index.php. It is important to write under the autoload require.
The result will be:
There is a easy example to test!
Like you can see it is very easy to add Arrays into your project. In the Documentation section you will be able to see the functions of the Utils components and there use.
Documentation
All the functions of Arrays are static. Now you can see each function, how to use and the utility.
Future I will try to make an easy video tutorial to make easy the first steps with this library.
pathSet()
This function allows to us to upsert a value into an array using a path route. The default value separator of the Arrays functions is the dot (.), but you can change this separator with the method setPathSeparator() that you can check in this documentation. With this function you can save time when you want to update a unique field of a big multidimensional array.
Parameters
- path: This is the route from the root of the array to the specific value that we want to upsert. [string]
- value: This is the content to upsert in the path position of the array. [mixed]
- receivedArray: This is the model array that is going to be use to insert the value. [array]
- byReference: Indicate if we are going to modify the original array or is goint to return only the copy modified. [bool][default: true]
Return
- array: Is the modified value set in receivedArray or a copy with the upsert.
Examples
Like you see, all the route is created. For this case is better directly, but in loops that you don't know if the path exist or not can be very usefull to avoid problems with array offset.
You can also change the value in arrays with content.
pathGet()
This function allows to us to get the value in an array using a path route. The default value separator of the Arrays functions is the dot (.), but you can change this separator with the method setPathSeparator() that you can check in this documentation. With this function you can save time when you want to get a array in a loop or in a function that you are not going to be sure if is going to exist and the deep of multidimensional array.
Parameters
- path: This is the route from the root of the array to the specific value that we want to read. [string]
- receivedArray: This is the model array that is going to be use to get the value. [array]
Return
- value: Is the value of inside the array. Null if not exist.
Examples
setUnidimensional()
This function transform a multidimensional array with path keys to a unidimensional array with a path. You can add a prefix to the key paths.
Parameters
- mdArray: This is the multidimensional array with paths in keys that we want to convert into unidimensional. [array]
- byReference: This is to indicate if you want to change the original array or not. [string]
- byReference: This is to add a prefix to your path key of the new array (for example "PREFIX.id.property.name"). [string]
Return
- value: The new unidimensional array.
setMultidimensional()
This function transform a unidimensional array with path keys to a multidimensional array. Is the function inverse to setUnidimensional.
Parameters
- udArray: This is the unidimensional array with paths in keys that we want to convert into multidimensional. [array]
- byReference: This is to indicate if you want to change the original array or not. [string]
Return
- value: The new multidimensional array.
Examples
Aditional information
Versioning: 📌
For all available versions, see the tags in this repository.
Authors ✒️
- A.Grandes.R - Main worker - Agrandesr
You can also look at the list of all [contributors] (https://github.com/your/project/contributors) who have participated in this project.
License 📄
This project is under the License MIT - read the file LICENSE.md for more details.
Thanks to: 🎁
- Villanuevand for his incredible template for documentation 😊
