Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jnessier/datahandler
Data handler for PHP arrays.
https://github.com/jnessier/datahandler
data data-handler php73
Last synced: 1 day ago
JSON representation
Data handler for PHP arrays.
- Host: GitHub
- URL: https://github.com/jnessier/datahandler
- Owner: jnessier
- License: mit
- Created: 2020-08-05T11:49:49.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-09-05T20:08:49.000Z (about 1 year ago)
- Last Synced: 2024-11-18T22:08:59.301Z (1 day ago)
- Topics: data, data-handler, php73
- Language: PHP
- Homepage:
- Size: 80.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Data handler
[](https://github.com/jnessier/DataHandler/actions?query=branch:4.x)
[](https://packagist.org/packages/jnessier/data-handler)
[](https://packagist.org/packages/jnessier/data-handler)
[](https://packagist.org/packages/jnessier/data-handler)
Data handler for PHP arrays.
## Table of Contents
- [Requirement](#requirement)
- [Installation](#installation)
- [Usage](#usage)
- [Limitations](#limitations)
- [Contributors](#contributors)
- [License](#license)
## Requirement
* PHP >= 8.1
## Installation
Install package of the data handler via Composer...
```bash
composer require jnessier/data-handler
```
...or manually download the latest release from [here](https://github.com/jnessier/DataHandler/releases/).
## Usage
```php
use DataHandler\Data;
// Create new data handler.
$data = new Data([
// Array with key/value pairs
]);
// Get value by key.
$default = null; // Default value, when key doesn't exists
$value = $data->get('key', $default);
// Pull value by key and delete it afterward.
$default = null; // Default value, when key doesn't exists
$value = $data->pull('key', $default);
// Set value by key.
$overwrite = true; // Set FALSE to prevent overwrite existing value
$data = $data->set('key', 'value', $overwrite);
// Check whether value exists by key.
$valueExists = $data->has('key');
// Delete value by key.
$data->delete('key');
// Count number of values.
$numberOfValues = $data->count();
// Get all values as array.
$array = $data->getAll();
// Iterate trough values.
$data->each(function ($value, string $key) {
// Callback for each key/value pair
});
// Clear values.
$data = $data->clear();
// Replace values. Existing values with similar keys will be overwritten.
$recursive = true; // Set FALSE to prevent recursive merge
$data = $data->replace([
// Array with key/value pairs
], $recursive);
// Set array as values. Existing data will be overwritten.
$data = $data->setAll([
// Array with key/value pairs
]);
// Set referenced array as values. Existing data will be overwritten.
$values = [
// Array with key/value pairs
];
$data = $data->setAllReferenced($values);
```
## Limitations
* Only string as key supported
* Only array as key/value pairs supported
* No dot notation implementation
* No type check for values
## Contributors
* Jonathan Nessier (jnessier)
If you would like to see this library develop further, or if you want to support me or show me your appreciation, please
donate any amount through PayPal. Thank you! :beers:
[](https://www.paypal.me/JonathanNessier)
## License
Licensed under [MIT](LICENSE).
*Made in Switzerland with :cheese: and :heart:*