About

The library clausnz/php-helpers is a collection of 45 useful php helper functions (PHP 5.6, 7.*).
After installation with composer, the global functions are accessable from everywhere in your code:

Installation

composer require clausnz/php-helpers

Example

<?php

dump( 'any content' );

If a function with the same name already exists in the list of your project's defined functions ( built-in and user-defined ), it will simply not be registered in your environment. Therefore, no conflicts with existing functions will appear.

Nevertheless, every function is still accessable it in a static way with the proper use-statement:

Example

<?php

use CNZ\Helpers\Util as util;

util::dump( 'any content' );

CREDITS

This library makes use of the following brilliant and well known libraries:

• https://github.com/serbanghita/Mobile-Detect
• https://github.com/JayBizzle/Crawler-Detect
• https://github.com/mustangostang/spyc

Tests

All functions are tested against a number of unit tests and PHP Versions.

Install

Install the latest clausnz/php-helper library with composer:

composer require clausnz/php-helpers

Also make sure to require your composer autoload file:

require __DIR__ . '/vendor/autoload.php';

After installation, the new global PHP functions are available everywhere in your code. To access the ( almost identical ) static functions in the helper classes, add the proper use statement to your file:

Example

<?php

use CNZ\Helpers\Dev as dev;

if( dev::isIphone() ) {
   // Do something here
}

Available PHP Functions

Table of Contents

• Device
  • is_mobile
  • is_smartphone
  • is_tablet
  • is_desktop
  • is_robot
  • is_ios
  • is_android
  • is_iphone
  • is_samsung
• Array
  • array_get
  • array_set
  • array_first
  • array_last
  • to_array
  • to_object
  • is_assoc
• String
  • str_before
  • str_after
  • str_after_last
  • str_between
  • str_insert
  • str_limit
  • str_limit_words
  • str_contains
  • str_icontains
  • str_starts_with
  • str_istarts_with
  • str_ends_with
  • str_iends_with
• Utils
  • ip
  • is_email
  • dump
  • dd
  • crypt_password
  • is_password
• Yml
  • to_yml
  • to_yml_file
  • yml_parse
  • yml_parse_file
  • is_yml
  • is_yml_file
  • yml_get
  • yml_get_file
  • yml_set
  • yml_set_file

API Documentation

Table of Contents

• Arr
  • isAssoc
  • toObject
  • dump
  • first
  • last
  • get
  • set
• Dev
  • isSmartphone
  • isMobile
  • mobileDetect
  • isTablet
  • isDesktop
  • isRobot
  • crawlerDetect
  • isAndroid
  • isIphone
  • isSamsung
  • isIOS
• Str
  • insert
  • between
  • after
  • before
  • limitWords
  • limit
  • contains
  • containsIgnoreCase
  • startsWith
  • startsWithIgnoreCase
  • endsWith
  • endsWithIgnoreCase
  • afterLast
• Util
  • isEmail
  • ip
  • cryptPassword
  • isPassword
  • dd
  • dump
• Yml
  • isValidFile
  • isValid
  • parse
  • get
  • getFile
  • parseFile
  • setFile
  • dumpFile
  • dump
  • set

Arr

Helper class that provides easy access to useful php array functions.

Class Arr

• Full name: \CNZ\Helpers\Arr

isAssoc

Detects if the given value is an associative array.

Arr::isAssoc( array $array ): boolean

is_assoc

Related global function (description see above).

( jump back )

is_assoc( array $array ): boolean

Example

$array = [
    'foo' => 'bar'
];

is_assoc( $array );

// bool(true)

• This method is static. Parameters:

Return Value:

True if the array is associative, false otherwise.

toObject

Converts an array to an object.

Arr::toObject( array $array ): object|null

to_object

Related global function (description see above).

( jump back )

to_object( array $array ): object|null

Example

$array = [
    'foo' => [
         'bar' => 'baz'
    ]
];

$obj = to_object($array);
echo $obj->foo->bar;

// baz

• This method is static. Parameters:

Return Value:

A std object representation of the converted array.

dump

Converts a string or an object to an array.

Arr::dump( string|object $var ): array|null

to_array

Related global function (description see above).

( jump back )

to_array( string|object $var ): array|null

Example 1 (string)

$var = 'php';
to_array( $var );

// (
//     [0] => p
//     [1] => h
//     [2] => p
// )

Example 2 (object)

$var = new stdClass;
$var->foo = 'bar';

to_array( $var );

// (
//     [foo] => bar
// )

• This method is static. Parameters:

Return Value:

An array representation of the converted string or object. Returns null on error.

first

Returns the first element of an array.

Arr::first( array $array ): mixed

array_first

Related global function (description see above).

( jump back )

array_first( array $array ): mixed

Example

$array = [
     'foo' => 'bar',
     'baz' => 'qux'
];

array_first( $array )

// bar

• This method is static. Parameters:

Return Value:

The value of the first element, without key. Mixed type.

last

Returns the last element of an array.

Arr::last( array $array ): mixed

array_last

Related global function (description see above).

( jump back )

array_last( array $array ): mixed

Example

$array = [
     'foo' => 'bar',
     'baz' => 'qux'
];

array_last( $array )

// qux

• This method is static. Parameters:

Return Value:

The value of the last element, without key. Mixed type.

get

Gets a value in an array by dot notation for the keys.

Arr::get( string $key, array $array ): mixed

array_get

Related global function (description see above).

( jump back )

array_get( string key, array $array ): mixed

Example

$array = [
     'foo' => 'bar',
     'baz' => [
         'qux => 'foobar'
     ]
];

array_get( 'baz.qux', $array );

// foobar

• This method is static. Parameters:

Return Value:

The searched value, null otherwise.

set

Sets a value in an array using the dot notation.

Arr::set( string $key, mixed $value, array &$array ): boolean

array_set

Related global function (description see above).

( jump back )

array_set( string key, mixed value, array $array ): boolean

Example 1

$array = [
     'foo' => 'bar',
     'baz' => [
         'qux => 'foobar'
     ]
];

array_set( 'baz.qux', 'bazqux', $array );

// (
//     [foo] => bar
//     [baz] => [
//         [qux] => bazqux
//     ]
// )

Example 2

$array = [
     'foo' => 'bar',
     'baz' => [
         'qux => 'foobar'
     ]
];

array_set( 'baz.foo', 'bar', $array );

// (
//     [foo] => bar
//     [baz] => [
//         [qux] => bazqux
//         [foo] => bar
//     ]
// )

• This method is static. Parameters:

Return Value:

True if the new value was successfully set, false otherwise.

Dev

Helper class that provides easy access to useful php functions in conjunction with the user agent.

Class Dev

• Full name: \CNZ\Helpers\Dev

isSmartphone

Determes if the current device is a smartphone.

Dev::isSmartphone(  ): boolean

is_smartphone

Related global function (description see above).

( jump back )

is_smartphone(  ): boolean

Example

if ( is_smartphone() ) {
     // I am a smartphone
}

• This method is static.

Return Value:

True if current visitor uses a smartphone, false otherwise.

isMobile

Detects if the current visitor uses a mobile device (Smartphone/Tablet/Handheld).

Dev::isMobile(  ): boolean

is_mobile

Related global function (description see above).

( jump back )

is_mobile(  ): boolean

Example

if ( is_mobile() ) {
     // I am a mobile device (smartphone/tablet or handheld)
}

• This method is static.

Return Value:

True if current visitor uses a mobile device, false otherwise.

mobileDetect

Get a singleton MobileDetect object to call every method it provides.

Dev::mobileDetect(  ): \Detection\MobileDetect

Public access for use of outside this class. Mobile_Detect doku: https://github.com/serbanghita/Mobile-Detect

This method has no related global function!

( jump back )

Example

Dev::mobileDetect()->version('Android');

// 8.1

• This method is static.

Return Value:

A singleton MobileDetect object to call every method it provides.

isTablet

Determes if the current visitor uses a tablet device.

Dev::isTablet(  ): boolean

is_tablet

Related global function (description see above).

( jump back )

is_tablet(  ): boolean

Example

if ( is_tablet() ) {
     // I am a tablet
}

• This method is static.

Return Value:

True if current visitor uses a tablet device, false otherwise.

isDesktop

Determes if the current visitor uses a desktop computer.

Dev::isDesktop(  ): boolean

is_desktop

Related global function (description see above).

( jump back )

is_desktop(  ): boolean

Example

if ( is_desktop() ) {
     // I am a desktop computer (Mac, Linux, Windows)
}

• This method is static.

Return Value:

True if current visitor uses a desktop computer, false otherwise.

isRobot

Determes if the current visitor is a search engine/bot/crawler/spider.

Dev::isRobot(  ): boolean

is_robot

Related global function (description see above).

( jump back )

is_robot(  ): boolean

Example

if ( is_robot() ) {
     // I am a robot (search engine, bot, crawler, spider)
}

• This method is static.

Return Value:

True if the current visitor is a search engine/bot/crawler/spider, false otherwise.

crawlerDetect

Get a singleton CrawlerDetect object to call every method it provides.

Dev::crawlerDetect(  ): \Jaybizzle\CrawlerDetect\CrawlerDetect

Public access for use of outside this class. Crawler-Detect doku: https://github.com/JayBizzle/Crawler-Detect

This method has no related global function!

( jump back )

Example

Dev::crawlerDetect()->getMatches();

// Output the name of the bot that matched (if any)

• This method is static.

isAndroid

Determes if the current device is running an Android operating system.

Dev::isAndroid(  ): boolean

is_android

Related global function (description see above).

( jump back )

is_android(  ): boolean

Example

if ( is_android() ) {
     // I am an Android based device
}

• This method is static.

Return Value:

True if current visitor uses an Android based device, false otherwise.

isIphone

Determes if the current device is an iPhone.

Dev::isIphone(  ): boolean

is_iphone

Related global function (description see above).

( jump back )

is_iphone(  ): boolean

Example

if ( is_iphone() ) {
     // I am an iPhone
}

• This method is static.

Return Value:

True if current visitor uses an iPhone, false otherwise.

isSamsung

Determes if the current device is from Samsung.

Dev::isSamsung(  ): boolean

is_samsung

Related global function (description see above).

( jump back )

is_samsung(  ): boolean

Example

if ( is_samsung() ) {
     // I am a device from Samsung
}

• This method is static.

Return Value:

True if current visitor uses a Samsung device, false otherwise.

isIOS

Determes if the current device is running an iOS operating system.

Dev::isIOS(  ): boolean

is_ios

Related global function (description see above).

( jump back )

is_ios(  ): boolean

Example

if ( is_ios() ) {
     // I am an iOS based device
}

• This method is static.

Return Value:

True if current visitor uses an iOS device, false otherwise.

Str

Helper class that provides easy access to useful php string functions.

Class Str

• Full name: \CNZ\Helpers\Str

insert

Inserts one or more strings into another string on a defined position.

Str::insert( array $keyValue, string $string ): string

str_insert

Related global function (description see above).

( jump back )

str_insert( array $keyValue, string $string ): string

Example

$keyValue = [
     ':color' => 'brown',
     ':animal' => 'dog'
]
$string = 'The quick :color fox jumps over the lazy :animal.';

str_insert( $keyValue, $string );

// The quick brown fox jumps over the lazy dog.

• This method is static. Parameters:

Return Value:

The replaced string.

between

Return the content in a string between a left and right element.

Str::between( string $left, string $right, string $string ): array

str_between

Related global function (description see above).

( jump back )

str_between( string $left, string $right, string $string ): array

Example

$string = '<tag>foo</tag>foobar<tag>bar</tag>'

str_between( '<tag>', '</tag>' $string );

// (
//     [0] => foo
//     [1] => bar
// )

• This method is static. Parameters:

Return Value:

A result array with all matches of the search.

after

Return the part of a string after a given value.

Str::after( string $search, string $string ): string

str_after

Related global function (description see above).

( jump back )

str_after( string $search, string $string ): string

Example

$string = 'The quick brown fox jumps over the lazy dog';

str_after( 'fox' $string );

// jumps over the lazy dog

• This method is static. Parameters:

Return Value:

The found string after the search string. Whitespaces at beginning will be removed.

before

Get the part of a string before a given value.

Str::before( string $search, string $string ): string

str_before

Related global function (description see above).

( jump back )

str_before( string $search, string $string ): string

Example

$string = 'The quick brown fox jumps over the lazy dog';

str_before( 'fox' $string );

// The quick brown

• This method is static. Parameters:

Return Value:

The found string before the search string. Whitespaces at end will be removed.

limitWords

Limit the number of words in a string. Put value of $end to the string end.

Str::limitWords( string $string, integer $limit = 10, string $end = '...' ): string

str_limit_words

Related global function (description see above).

( jump back )

str_limit_words( string $string, int $limit = 10, string $end = '...' ): string

Example

$string = 'The quick brown fox jumps over the lazy dog';

str_limit_words( $string, 3 );

// The quick brown...

• This method is static. Parameters:

Return Value:

The limited string with $end at the end.

limit

Limit the number of characters in a string. Put value of $end to the string end.

Str::limit( string $string, integer $limit = 100, string $end = '...' ): string

str_limit

Related global function (description see above).

( jump back )

str_limit( string $string, int $limit = 100, string $end = '...' ): string

Example

$string = 'The quick brown fox jumps over the lazy dog';

str_limit( $string, 15 );

// The quick brown...

• This method is static. Parameters:

Return Value:

The limited string with $end at the end.

contains

Tests if a string contains a given element

Str::contains( string|array $needle, string $haystack ): boolean

str_contains

Related global function (description see above).

( jump back )

str_contains( string|array $needle, string $haystack ): boolean

Example

$string = 'The quick brown fox jumps over the lazy dog';
$array = [
     'cat',
     'fox'
];

str_contains( $array, $string );

// bool(true)

• This method is static. Parameters:

Return Value:

True if $needle is found, false otherwise.

containsIgnoreCase

Tests if a string contains a given element. Ignore case sensitivity.

Str::containsIgnoreCase( string|array $needle, string $haystack ): boolean

str_icontains

Related global function (description see above).

( jump back )

str_icontains( string|array $needle, string $haystack ): boolean

Example

$string = 'The quick brown fox jumps over the lazy dog';
$array = [
     'Cat',
     'Fox'
];

str_icontains( $array, $string );

// bool(true)

• This method is static. Parameters:

Return Value:

True if $needle is found, false otherwise.

startsWith

Determine if a given string starts with a given substring.

Str::startsWith( string|array $needle, string $haystack ): boolean

str_starts_with

Related global function (description see above).

( jump back )

str_starts_with( string|array $needle, string $haystack ): boolean

Example

$string = 'The quick brown fox jumps over the lazy dog';
$array = [
     'Cat',
     'The'
];

str_starts_with( $array, $string );

// bool(true)

• This method is static. Parameters:

Return Value:

True if $needle was found, false otherwise.

startsWithIgnoreCase

Determine if a given string starts with a given substring. Ignore case sensitivity.

Str::startsWithIgnoreCase( string|array $needle, string $haystack ): boolean

str_istarts_with

Related global function (description see above).

( jump back )

str_istarts_with( string|array $needle, string $haystack ): boolean

Example

$string = 'The quick brown fox jumps over the lazy dog';
$array = [
     'cat',
     'the'
];

str_istarts_with( $array, $string );

// bool(true)

• This method is static. Parameters:

Return Value:

True if $needle was found, false otherwise.

endsWith

Determine if a given string ends with a given substring.

Str::endsWith( string|array $needle, string $haystack ): boolean

str_ends_with

Related global function (description see above).

( jump back )

str_ends_with( string|array $needle, string $haystack ): boolean

Example

$string = 'The quick brown fox jumps over the lazy dog';
$array = [
     'cat',
     'dog'
];

str_ends_with( $array, $string );

// bool(true)

• This method is static. Parameters:

Return Value:

True if $needle was found, false otherwise.

endsWithIgnoreCase

Determine if a given string ends with a given substring.

Str::endsWithIgnoreCase( string|array $needle, string $haystack ): boolean

str_iends_with

Related global function (description see above).

( jump back )

str_iends_with( string|array $needle, string $haystack ): boolean

Example

$string = 'The quick brown fox jumps over the lazy dog';
$array = [
     'Cat',
     'Dog'
];

str_iends_with( $array, $string );

// bool(true)

• This method is static. Parameters:

Return Value:

True if $needle was found, false otherwise.

afterLast

Return the part of a string after the last occurrence of a given search value.

Str::afterLast( string $search, string $string ): string

str_after_last

Related global function (description see above).

( jump back )

str_after_last( string $search, string $string ): string

Example

$path = "/var/www/html/public/img/image.jpg";

str_after_last( '/' $path );

// image.jpg

• This method is static. Parameters:

Return Value:

The found string after the last occurrence of the search string. Whitespaces at beginning will be removed.

Util

Helper class that provides easy access to useful common php functions.

Class Util

• Full name: \CNZ\Helpers\Util

isEmail

Validate a given email address.

Util::isEmail( string $email ): boolean

is_email

Related global function (description see above).

( jump back )

is_email( string $email ): boolean

Example

$email = '[email protected]';

is_email( $email );

// bool(true)

• This method is static. Parameters:

Return Value:

True if given string is a valid email address, false otherwise.

ip

Get the current ip address of the user.

Util::ip(  ): string|null

user_ip

Related global function (description see above).

( jump back )

ip(  ): null|string

Example

echo ip();

// 127.0.0.1

• This method is static.

Return Value:

The detected ip address, null if the ip was not detected.

cryptPassword

Creates a secure hash from a given password. Uses the CRYPT_BLOWFISH algorithm.

Util::cryptPassword( string $password ): string

Note: 255 characters for database column recommended!

crypt_password

Related global function (description see above).

( jump back )

crypt_password( string $password ): string

Example

$password = 'foobar';

crypt_password( $password );

// $2y$10$6qKwbwTgwQNcmcaw04eSf.QpP3.4T0..bEnY62dd1ozM8L61nb8AC

• This method is static. Parameters:

Return Value:

The crypted password.

isPassword

Verifies that a password matches a crypted password (CRYPT_BLOWFISH algorithm).

Util::isPassword( string $password, string $cryptedPassword ): boolean

is_password

Related global function (description see above).

( jump back )

is_password( string $password, string $cryptedPassword ): boolean

Example

$password = 'foobar';
$cryptedPassword = '$2y$10$6qKwbwTgwQNcmcaw04eSf.QpP3.4T0..bEnY62dd1ozM8L61nb8AC';

is_password( $password, $cryptedPassword );

// bool(true)

• This method is static. Parameters:

dd

Dumps the content of the given variable and exits the script.

Util::dd( mixed $var )

dd

Related global function (description see above).

( jump back )

dd( mixed $var )

Example

$array = [
     'foo' => 'bar',
     'baz' => 'qux'
];

dd( $array );

// (
//     [foo] => bar
//     [baz] => qux
// )

• This method is static. Parameters:

dump

Dumps the content of the given variable. Script does NOT stop after call.

Util::dump( mixed $var )

dump

Related global function (description see above).

( jump back )

dump( mixed $var )

Example

$array = [
     'foo' => 'bar',
     'baz' => 'qux'
];

dump( $array );

// (
//     [foo] => bar
//     [baz] => qux
// )

• This method is static. Parameters:

Yml

Helper class that provides easy access to useful php yml functions.

Class Yml

• Full name: \CNZ\Helpers\Yml

isValidFile

Validates if a given file contains yaml syntax.

Yml::isValidFile( string $file ): boolean

is_yml_file

Related global function (description see above).

( jump back )

is_yml_file( string $file ): boolean

Example

$file = /path/to/file.yml

is_yml_file( $file );

// bool(true)

• This method is static. Parameters:

Return Value:

True if the file contains yaml syntax, false otherwise.

isValid

Tests if the syntax of a given string is yaml.

Yml::isValid( string $string ): boolean

is_yml

Related global function (description see above).

( jump back )

is_yml( string $string ): boolean

Example

$string = "
     foo: bar
     baz: qux
     foobar:
         foo: bar
";

is_yml( $string );

// bool(true)

• This method is static. Parameters:

Return Value:

True if the string is yaml, false otherwise.

parse

Transforms a given yaml string into an array.

Yml::parse( string $yml ): array|null

yml_parse

Related global function (description see above).

( jump back )

yml_parse( string $yml ): array|null

Example

$yml = "
     foo: bar
     baz: qux
     foobar:
         foo: bar
";

yml_parse( $yml );

// (
//       [foo] => bar
//       [baz] => qux
//       [foobar] => (
//           [foo] => bar
//       )
// )

• This method is static. Parameters:

Return Value:

The transformed array, null on error.

get

Gets a value in a yaml string using the dot notation.

Yml::get( string $key, string $yml ): mixed

yml_get

Related global function (description see above).

( jump back )

yml_get( string $key, string $yml ): mixed

Example

$yml = "
     foo: bar
     baz: qux
     foobar:
         foo: bar
";

yml_get( 'foobar.foo', $yml );

// bar

• This method is static. Parameters:

Return Value:

The found value, null otherwise.

getFile

Gets a value in a yaml file using the dot notation.

Yml::getFile( string $key, string $ymlfile ): mixed

yml_get_file

Related global function (description see above).

( jump back )

yml_get_file( string $key, string $ymlfile ): mixed

Example

$ymlfile = '/path/to/file.yml';

yml_get_file( 'foobar.foo', $ymlfile );

// bar

• This method is static. Parameters:

Return Value:

The found value, null otherwise.

parseFile

Loads the content of a yamlfile into an array.

Yml::parseFile( string $ymlfile ): array

yml_parse_file

Related global function (description see above).

( jump back )

yml_parse_file( string $ymlfile ): array|null

Example

$ymlfile = '/path/to/file.yml';

yml_parse_file( $ymlfile );

// (
//       [foo] => bar
//       [baz] => qux
//       [foobar] => (
//           [foo] => bar
//       )
// )

• This method is static. Parameters:

Return Value:

The parsed array.

setFile

Sets a value in a yamlfile using the dot notation. Note: all comments in the file will be removed!

Yml::setFile( string $key, mixed $value, string $ymlfile ): boolean

yml_set_file

Related global function (description see above).

( jump back )

yml_set_file( string $key, mixed $value, string $ymlfile ): boolean

Example

$ymlfile = '/path/to/file.yml';

yml_set_file( 'foobar.foo', 'baz', $ymlfile );

//   foo: bar
//   baz: qux
//   foobar:
//       foo: baz

• This method is static. Parameters:

Return Value:

True if value was successfully set in yamlfile, false otherwise.

dumpFile

Transformes a given array to yaml syntax and puts its content into a given file. Note: if the file exists, it will be overwritten!

Yml::dumpFile( array|object $var, string $filename, integer $indent = 2, integer $wordwrap, boolean $openingDashes = false ): boolean

to_yml_file

Related global function (description see above).

( jump back )

to_yml_file( array|object $var, string $filename, int $indent = 2, int $wordwrap = 0, bool $openingDashes = false ): boolean

Example

$array = [
     'foo' => 'bar',
     'baz' => 'qux'
];

to_yml_file( $array, '/path/to/file.yml' );

//   foo: bar
//   baz: qux

• This method is static. Parameters:

Return Value:

True on success, false otherwise.

dump

Transformes a given array or object to a yaml string.

Yml::dump( array|object $var, integer $indent = 2, integer $wordwrap, boolean $openingDashes = false ): string|null

to_yml

Related global function (description see above).

( jump back )

to_yml( array|object $array, string $filename, int $indent = 2, int $wordwrap = 0, bool $openingDashes = false ): string|null

Example

$array = [
     'foo' => 'bar',
     'baz' => 'qux',
     'foobar' => [
         'foo' => 'bar'
     ]
];

to_yml( $array );

//   foo: bar
//   baz: qux
//   foobar:
//     foo: bar

• This method is static. Parameters:

Return Value:

The converted yaml string. On errors, null is returned.

set

Sets a value in a yaml string using the dot notation.

Yml::set( string $key, mixed $value, string &$yml ): boolean

yml_set

Related global function (description see above).

( jump back )

yml_set( string $key, mixed $value, string &$yml ): boolean

Example

$yml = "
     foo: bar
     baz: qux
     foobar:
         foo: bar
";

yml_set( 'foobar.foo', 'baz', $yml );

//   foo: bar
//   baz: qux
//   foobar:
//       foo: baz

• This method is static. Parameters:

Return Value:

True if value was successfully set, false otherwise.

This document was automatically generated from source code comments on 2018-01-22 using phpDocumentor and cvuorinen/phpdoc-markdown-public