royalcms / helpers
The Royalcms helpers package.
v5.0.0
2020-04-20 07:03 UTC
Requires
- php: >=5.6.0
This package is auto-updated.
Last update: 2024-10-20 17:50:02 UTC
README
所有依赖项都已提取到单个帮助程序文件中。 无需导入一般的Symphony和Laravel即可完成这些工作。
安装
在项目根目录中运行以下命令:
composer require royalcms/royalcms-helpers
文档
Arrays
append_config
/** * Assign high numeric IDs to a config item to force appending. * * @param array $array * @return array */ function append_config(array $array)
array_add
/** * Add an element to an array using "dot" notation if it doesn't exist. * * @param array $array * @param string $key * @param mixed $value * @return array */ function array_add($array, $key, $value)
array_build
/** * Build a new array using a callback. * * @param array $array * @param \Closure $callback * @return array */ function array_build($array, Closure $callback)
array_divide
/** * Divide an array into two arrays. One with keys and the other with values. * * @param array $array * @return array */ function array_divide($array)
array_dot
/** * Flatten a multi-dimensional associative array with dots. * * @param array $array * @param string $prepend * @return array */ function array_dot($array, $prepend = '')
array_except
/** * Get all of the given array except for a specified array of items. * * @param array $array * @param array|string $keys * @return array */ function array_except($array, $keys)
array_fetch
/** * Fetch a flattened array of a nested array element. * * @param array $array * @param string $key * @return array */ function array_fetch($array, $key)
array_first
/** * Return the first element in an array passing a given truth test. * * @param array $array * @param \Closure $callback * @param mixed $default * @return mixed */ function array_first($array, $callback, $default = null)
array_last
/** * Return the last element in an array passing a given truth test. * * @param array $array * @param \Closure $callback * @param mixed $default * @return mixed */ function array_last($array, $callback, $default = null)
array_flatten
/** * Flatten a multi-dimensional array into a single level. * * @param array $array * @return array */ function array_flatten($array)
array_forget
/** * Remove one or many array items from a given array using "dot" notation. * * @param array $array * @param array|string $keys * @return void */ function array_forget(&$array, $keys)
array_get
/** * Get an item from an array using "dot" notation. * * @param array $array * @param string $key * @param mixed $default * @return mixed */ function array_get($array, $key, $default = null)
array_has
/** * Check if an item exists in an array using "dot" notation. * * @param array $array * @param string $key * @return bool */ function array_has($array, $key)
array_only
/** * Get a subset of the items from the given array. * * @param array $array * @param array|string $keys * @return array */ function array_only($array, $keys)
array_pluck
/** * Pluck an array of values from an array. * * @param array $array * @param string $value * @param string $key * @return array */ function array_pluck($array, $value, $key = null)
array_pull
/** * Get a value from the array, and remove it. * * @param array $array * @param string $key * @param mixed $default * @return mixed */ function array_pull(&$array, $key, $default = null)
array_set
/** * Set an array item to a given value using "dot" notation. * * If no key is given to the method, the entire array will be replaced. * * @param array $array * @param string $key * @param mixed $value * @return array */ function array_set(&$array, $key, $value)
array_where
/** * Filter the array using the given Closure. * * @param array $array * @param \Closure $callback * @return array */ function array_where($array, Closure $callback)
head
/** * Get the first element of an array. Useful for method chaining. * * @param array $array * @return mixed */ function head($array)
last
/** * Get the last element from an array. * * @param array $array * @return mixed */ function last($array)
Strings
ascii
/** * Transliterate a UTF-8 value to ASCII. * * @param string $value * @return string */ function ascii($value)
camel_case
/** * Convert a value to camel case. * * @param string $value * @return string */ function camel_case($value)
charsArray
/** * Returns the replacements for the ascii method. * * Note: Adapted from Stringy\Stringy. * * @see https://github.com/danielstjules/Stringy/blob/2.3.1/LICENSE.txt * * @return array */ function charsArray()
ends_with
/** * Determine if a given string ends with a given substring. * * @param string $haystack * @param string|array $needles * @return bool */ function ends_with($haystack, $needles)
preg_replace_sub
/** * Replace a given pattern with each value in the array in sequentially. * * @param string $pattern * @param array $replacements * @param string $subject * @return string */ function preg_replace_sub($pattern, &$replacements, $subject)
snake_case
/** * Convert a string to snake case. * * @param string $value * @param string $delimiter * @return string */ function snake_case($value, $delimiter = '_')
starts_with
/** * Determine if a given string starts with a given substring. * * @param string $haystack * @param string|array $needles * @return bool */ function starts_with($haystack, $needles)
str_contains
/** * Determine if a given string contains a given substring. * * @param string $haystack * @param string|array $needles * @return bool */ function str_contains($haystack, $needles)
str_finish
/** * Cap a string with a single instance of a given value. * * @param string $value * @param string $cap * @return string */ function str_finish($value, $cap)
str_is
/** * Determine if a given string matches a given pattern. * * @param string $pattern * @param string $value * @return bool */ function str_is($pattern, $value)
str_limit
/** * Limit the number of characters in a string. * * @param string $value * @param int $limit * @param string $end * @return string */ function str_limit($value, $limit = 100, $end = '...')
str_random
/** * Generate a more truly "random" alpha-numeric string. * * @param int $length * @return string * * @throws \RuntimeException */ function str_random($length = 16)
str_replace_array
/** * Replace a given value in the string sequentially with an array. * * @param string $search * @param array $replace * @param string $subject * @return string */ function str_replace_array($search, array $replace, $subject)
str_slug
/** * Generate a URL friendly "slug" from a given string. * * @param string $title * @param string $separator * @return string */ function str_slug($title, $separator = '-')
studly_case
/** * Convert a value to studly caps case. * * @param string $value * @return string */ function studly_case($value)
Classes
class_basename
/** * Get the class "basename" of the given object / class. * * @param string|object $class * @return string */ function class_basename($class)
class_uses_recursive
/** * Returns all traits used by a class, it's subclasses and trait of their traits * * @param string $class * @return array */ function class_uses_recursive($class)
trait_uses_recursive
/** * Returns all traits used by a trait and its traits * * @param string $trait * @return array */ function trait_uses_recursive($trait)
Misc.
data_get
/** * Get an item from an array or object using "dot" notation. * * @param mixed $target * @param string $key * @param mixed $default * @return mixed */ function data_get($target, $key, $default = null)
e
/** * Escape HTML entities in a string. * * @param string $value * @return string */ function e($value)
object_get
/** * Get an item from an object using "dot" notation. * * @param object $object * @param string $key * @param mixed $default * @return mixed */ function object_get($object, $key, $default = null)
value
/** * Return the default value of the given value. * * @param mixed $value * @return mixed */ function value($value)
with
/** * Return the given object. Useful for chaining. * * @param mixed $object * @return mixed */ function with($object)
dd
/** * Dump the passed variables and end the script. * * @param mixed $args * @return void */ function dd($arg...)
data_set
/** * Set an item on an array or object using dot notation. * * @param mixed $target * @param string|array $key * @param mixed $value * @param bool $overwrite * @return mixed */ function data_set(&$target, $key, $value, $overwrite = true)
data_fill
/** * Fill in data where it's missing. * * @param mixed $target * @param string|array $key * @param mixed $value * @return mixed */ function data_fill(&$target, $key, $value)