Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/omnicode/php-util
Utility functions for php
https://github.com/omnicode/php-util
functions php utility
Last synced: about 2 months ago
JSON representation
Utility functions for php
- Host: GitHub
- URL: https://github.com/omnicode/php-util
- Owner: omnicode
- License: mit
- Created: 2017-05-18T18:12:10.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-05-02T07:16:54.000Z (over 5 years ago)
- Last Synced: 2024-10-08T11:29:05.841Z (3 months ago)
- Topics: functions, php, utility
- Language: PHP
- Size: 33.2 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Utility Functions for PHP
Functions are added to global namespace
## Contents
* dbg
* h
* is_natural
* between
* is_numeric_list
* last_chars
* create_slug
* coalesce
* get_first_key
* get_first_value
* get_last_key
* get_last_value
* array_unset
* array_iunique
* get_directory_size
* get_file_name
* get_file_extension
* check_file_exists
* format_bytes
* datetotime
* is_date
* t2d
* t2dt
* get_range
* _humanize
* get_class_constant
* get_class_constants
* shorten
* safe_json_encode
* get_client_ip
* rm_rf
* copy_r
* get_query_params
* get_class_name
* extract_number
* seconds_to_hour_minute
* is_cli
### dbg
```
/**
* debug method from Cakephp - convenient wrapper for print_r
*
* @param $var
* @param bool|false $return
* @return string
*/
function dbg($var, $return = false)
```
### h
```
/**
* Convenience method for htmlspecialchars.
*
* @param string|array|object $text Text to wrap through htmlspecialchars. Also works with arrays, and objects.
* Arrays will be mapped and have all their elements escaped. Objects will be string cast if they
* implement a `__toString` method. Otherwise the class name will be used.
* @param bool $double Encode existing html entities.
* @param string|null $charset Character set to use when escaping. Defaults to config value in `mb_internal_encoding()`
* or 'UTF-8'.
* @return string Wrapped text.
* @link http://book.cakephp.org/3.0/en/core-libraries/global-constants-and-functions.html#h
*/
function h($text, $double = true, $charset = null)
```
```
/**
* checks if the given number is a natural number
*
* @param int|float|array $number
* @param bool $zero - if set to true zero will be considered
* @return bool
*/
function is_natural($number, $zero = false)
```
```
/**
* checks if the given value is between 2 values(inclusive)
*
* @param int $number
* @param int $min
* @param int $max
* @return bool
*/
function between($number, $min, $max)
```
### is_numeric_list
```
/**
* if an array is provided checks the values of the array all to be numeric,
* if string is provided, will check to be comma separated list
*
* @param mixed $data - array of numbers or string as comma separated numbers
* @return bool
*/
function is_numeric_list($data)
```
### last_chars
```
/**
* returns given amount of characters counting backwards
*
* @param string $str
* @param int $count
* @return string
*/
function last_chars($str, $count = 1)
```
### create_slug
```
/**
* create slug from string
*
* @param string $str
* @param string $symbol
* @return string - e.g. in word1-word2-word3 format
*/
function create_slug($str = "", $symbol = "-")
```
### coalesce
```
/**
* mysql coalesce equivalent
*
* @param mixed - list of arguments
* @return mixed
* @link http://stackoverflow.com/a/4688108/932473
*/
function coalesce()
```
### get_first_key
```
/**
* returns the first key of the array
*
* @param array $array
* @return mixed
*/
function get_first_key(array $array = [])
```
### get_first_value
```
/**
* returns the first value of the array
*
* @param array $array
* @return mixed
*/
function get_first_value($array)
```
### get_last_key
```
/**
* returns the last key of the array
*
* @param array $array
* @return mixed
*/
function get_last_key($array)
```
### get_last_value
```
/**
* returns the last value of the array
*
* @param array $array
* @return mixed
*/
function get_last_value($array)
```
### array_unset
```
/**
* unsets array's items by value
*
* @param array $array - the original array
* @param array|string - the value or array of values to be unset
* @return array - the processed array
*/
function array_unset($array, $values = [])
```
### array_iunique
```
/**
* case-insensitive array_unique
*
* @param array
* @return array
* @link http://stackoverflow.com/a/2276400/932473
*/
function array_iunique($array)
```
### get_directory_size
```
/**
* returns the size of the directory
*
* @param null $path
* @param bool|false $unit
* @param bool|false $intOnly
* @return string
* @throws Exception
* @link http://stackoverflow.com/a/478161/932473
*/
function get_directory_size($path = null, $unit = false, $intOnly = false)
```
### get_file_name
```
/**
* returns the file name without the extension
*
* @param string $fileName
* @return string
*/
function get_file_name($fileName = '')
```
### get_file_extension
```
/**
* returns the file extension from full file name
*
* @param string $fileName
* @return string
*/
function get_file_extension($fileName)
```
### check_file_exists
```
/**
* if file exists will return it - with number concatenated
*
* @param $path
* @param $fileName
* @param int $n
* @return bool|string
*/
function check_file_exists($path, $fileName, $n = 100)
```
### format_bytes
```
/**
* @param $bytes
* @param int $precision
* @return string
* @link http://stackoverflow.com/a/2510459/932473
*/
function format_bytes($bytes, $precision = 0)
```
### datetotime
```
/**
* return timestamp from date considering "/" delimiter
*
* @return string
*/
function datetotime($date)
```
### is_date
```
/**
* checks if the given date(s) are valid mysql dates
*
* @param null $date1
* @param null $date
* @return bool - true if all dates are valid, false otherwise
*/
function is_date($date1 = null, $date = null)
```
### t2d
```
/**
* returns date in Y-m-d format from seconds
*
* @param time $timeStr
* @return date
*/
function t2d($timeStr = null)
```
### t2dt
```
/**
* returns date in Y-m-d H:i:s format from seconds
*
* @param time $timeStr
* @return datetime
*/
function t2dt($timeStr = null)
```
### get_range
```
/**
* returns array with options for select box
*
* @param $min
* @param $max
* @param int $step
* @return array
*/
function get_range($min, $max, $step = 1)
```
### _humanize
```
/**
* @param $val
* @return string
*/
function _humanize($val)
```
### get_class_constant
```
/**
* returns constant of the class based on its value
*
* @param $className
* @param $value
* @param bool|true $humanize
* @return string
* @throws Exception
*/
function get_class_constant($className, $value, $humanize = true)
```
### get_class_constants
```
/**
* returns the list of constants of the given class
*
* @param $className
* @param bool|false $reverse
* @param bool|true $humanize
* @return array
* @throws Exception
*/
function get_class_constants($className, $reverse = false, $humanize = true)
```
### shorten
```
/**
* returns the short string based on $length if string's length is more than $length
*
* @param string $str
* @param number $length
* @param bool $raw
* @return string
*/
function shorten($str = '', $length = null, $raw = false)
```
### safe_json_encode
```
/**
* safe json_encode
*
* @param string $value
* @return string
*/
function safe_json_encode($value)
```
### get_client_ip
```
/**
* get client ip
*
* @return string
*/
function get_client_ip()
```
### rm_rf
```
/**
* linux "rm -rf" command equivalent
* recursively deletes directory
*
* @param string $path
* @throws Exception
* @return bool
*/
function rm_rf($path)
```
### copy_r
```
/**
* recursively copies files and directories
*
* @param string $src
* @param string $dst
* @return bool
*/
function copy_r($src, $dst)
```
### get_query_params
```
/**
* parses the url and returns the specified or all list of params
*
* @access public
* @param string $url
* @param bool $onlyQuery - if true the param will be checked only in the query string, default - false
* @return mixed - string if found the param, bool false otherwise
*/
function get_query_params($url, $param = '', $onlyQuery = false)
```
### get_class_name
```
/**
* returns class name from object - without namespace
*
* @param string $object
* @return mixed
*/
function get_class_name($object = '')
```
### extract_number
```
/**
* returns numbers from the string
*
* @param string $str
* @return string
*/
function extract_number($str = '')
```
### seconds_to_hour_minute
```
/**
* converts given seconds to hours and minutes
*
* @param null $seconds
* @return string
*/
function seconds_to_hour_minute($seconds = null)
```
### is_cli
```
/**
* check if the current request is from CLI
*
* @return bool
*/
function is_cli()
```