Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thomassquall/phputils
Generic Utilities for PHP
https://github.com/thomassquall/phputils
array json php utils utils-library
Last synced: about 1 month ago
JSON representation
Generic Utilities for PHP
- Host: GitHub
- URL: https://github.com/thomassquall/phputils
- Owner: ThomasSquall
- License: mit
- Created: 2018-12-29T19:45:32.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-08-23T09:22:29.000Z (over 5 years ago)
- Last Synced: 2024-07-26T20:48:41.061Z (5 months ago)
- Topics: array, json, php, utils, utils-library
- Language: PHP
- Size: 11.7 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Utils for php
## List of available functions
1) [array_to_object](#array_to_object)
2) [json_to_object](#json_to_object)
3) [parse_args](#parse_args)
4) [get](#get)
5) [dispose](#dispose)
6) [is_cli](#is_cli)#### Other contained Repositories
1) [String utils](https://github.com/ThomasSquall/PHPStringUtils)
1) [File utils](https://github.com/ThomasSquall/PHPFileUtils)### array_to_object
#### Description
Returns an object out of an array.
Note that only fields corresponding to the array keys will be returned.#### Definition
array_to_object($array, $object)
Where:
1) $array is the array to convert
2) $object is the object or class to be returned
3) $add_not_existing_properties is used to choose whether to add properties not defined in the class to the object#### Usage
``` php
class Person {
public $name;
public $age;
}$array = [
"name" => "MyName",
"surname" => "MySurname",
"age" => 27
];print_r(array_to_object($array, "Person"));
echo PHP_EOL;
print_r(array_to_object($array, "Person", true));
```This will print:
``` sh
Person Object ( [name] => MyName [age] => 27 )
Person Object ( [name] => MyName [age] => 27 [surname] => MySurname )
```### json_to_object
#### Description
Returns an object out of a json string.
Note that only fields corresponding to the json keys will be returned unless you pass $add_not_existing_properties to true.#### Definition
json_to_object($json, $object, $add_not_existing_properties = false)
Where:
1) json is the json to convert
2) $object is the object or class to be returned
3) $add_not_existing_properties is used to choose whether to add properties not defined in the class to the object#### Usage
``` php
class Person {
public $name;
public $age;
}$json = '{
"name": "MyName",
"surname": "MySurname",
"age": 27
}';print_r(array_to_object($json, "Person"));
echo PHP_EOL;
print_r(array_to_object($json, "Person", true));
```This will print:
``` sh
Person Object ( [name] => MyName [age] => 27 )
Person Object ( [name] => MyName [age] => 27 [surname] => MySurname )
```### parse_args
#### Description
Build a new array out of the $options one with defaults values taken from $defaults when nothing is found.
#### Definition
parse_args($options, $defaults)
Where:
1) $options is the array to be parsed and used to build the new array
2) $defaults is the array containing default values to use when no correspondence is found#### Usage
``` php
$defaults = [
"name" => "MyName",
"surname" => "MySurname",
"age" => 27
];$person = [
"name" => "MyRealName",
"surname" => "MyRealSurname"
];print_r(parse_args($person, $defaults));
```This will print:
``` sh
Array ( [name] => MyRealName [surname] => MyRealSurname [age] => 27 )
```### get
#### Description
Checks if the provided value is empty and, if it is, the default value will be returned. The value itself will be returned otherwise.#### Definition
get($value, $default = "")
Where:
1) $value is the value to be checked to be empty or not
2) $default is the value to pass in case the first is empty. Defaulted to empty string#### Usage
``` php
$value = "";echo get($value, "hello");
```This will print:
``` sh
hello
```### dispose
#### Description
Disposes any item.
#### Definition
dispose(&$item)
Where:
1) $item is the item to be disposes#### Usage
``` php
$array = [
"Hello",
" ",
"world"
];dispose($array);
```### is_cli
#### Description
Returns true if the script is running in the cli or not.
#### Definition
is_cli()
#### Usage
``` php
if (is_cli())
echo "This script is running in the shell";
else
echo "This script is not running in the shell";
```## More utilities coming...