bayfrontmedia/php-string-helpers

Helper class to provide useful string functions.

Maintainers

Details

github.com/bayfrontmedia/php-string-helpers

Homepage

Source

Issues

Installs: 3 509

Dependents: 5

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 1

Open Issues: 0

pkg:composer/bayfrontmedia/php-string-helpers

v2.2.1 2024-12-23 20:28 UTC

Requires

MIT f3ae081fa216c8e872901378771917ac1ee8f615

phphelpersfunctionstringhelper

This package is auto-updated.

Last update: 2025-10-23 22:17:58 UTC

README

PHP helper class to provide useful string functions.

License

This project is open source and available under the MIT License.

Author

Bayfront Media

Requirements

  • PHP ^8.0 (Tested up to 8.4)

Installation

composer require bayfrontmedia/php-string-helpers

Usage

Depreciated:

startWith

Description:

Returns string, ensuring that it starts with a given string.

Parameters:

  • $string (string)
  • $start_with (string)

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

echo Str::startWith($string, 'Hello! ');

endWith

Description:

Returns string, ensuring that it ends with a given string.

Parameters:

  • $string (string)
  • $end_with (string)

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

echo Str::endWith($string, ' Goodbye!');

lowercase

Description:

Converts string to lowercase using a specified character encoding.

See: https://www.php.net/manual/en/mbstring.supported-encodings.php

Parameters:

  • $string (string)
  • $encoding = 'UTF-8' (string)

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

echo Str::lowercase($string);

uppercase

Description:

Converts string to uppercase using a specified character encoding.

See: https://www.php.net/manual/en/mbstring.supported-encodings.php

Parameters:

  • $string (string)
  • $encoding = 'UTF-8' (string)

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

echo Str::uppercase($string);

titleCase

Description:

Converts string to title case using a specified character encoding.

See: https://www.php.net/manual/en/mbstring.supported-encodings.php

Parameters:

  • $string (string)
  • $encoding = 'UTF-8' (string)

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

echo Str::titleCase($string);

camelCase

Description:

Converts string to camel case, removing any non-alpha and non-numeric characters.

Parameters:

  • $string (string)

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

echo Str::camelCase($string);

kebabCase

Description:

Converts string to kebab case (URL-friendly slug), replacing any non-alpha and non-numeric characters with a hyphen.

Parameters:

  • $string (string)
  • $lowercase = false (bool): Convert string to lowercase

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

echo Str::kebabCase($string);

snakeCase

Description:

Converts string to snake case, replacing any non-alpha and non-numeric characters with an underscore.

Parameters:

  • $string (string)
  • $lowercase = false (bool): Convert string to lowercase

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

echo Str::snakeCase($string);

random

Description:

Return a random string of specified length and type.

Note: Returned string is not cryptographically secure.

Parameters:

  • $length = 8 (int)
  • $type = self::RANDOM_TYPE_ALL (string): Any RANDOM_TYPE_* constant)

Valid $type constants include:

  • RANDOM_TYPE_NONZERO
  • RANDOM_TYPE_NUMERIC
  • RANDOM_TYPE_ALPHA: Alphabetic, upper and lowercase
  • RANDOM_TYPE_ALPHA_LOWER
  • RANDOM_TYPE_ALPHA_UPPER
  • RANDOM_TYPE_ALPHANUMERIC: Alphanumeric, upper and lowercase
  • RANDOM_TYPE_ALPHANUMERIC_LOWER
  • RANDOM_TYPE_ALPHANUMERIC_UPPER
  • RANDOM_TYPE_ALL: Alphanumeric and special characters

Backticks and quotation marks are excluded from special characters for safely inserting into a database.

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

echo Str::random(16, Str::RANDOM_TYPE_ALPHANUMERIC);

uid

Description:

Return a cryptographically secure unique identifier (UID) comprised of lowercase letters and numbers.

Parameters:

  • $length = 8 (int)

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

echo Str::uid(16);

uuid4

Description:

Return a UUID v4 string.

Parameters:

  • (None)

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

echo Str::uuid4();

uuid7

Description:

Return a lexicographically sortable UUID v7 string.

Parameters:

  • (None)

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

echo Str::uuid7();

hasComplexity

Description:

Verify input string has a specified complexity.

Parameters:

  • $string (string)
  • $min_length (int)
  • $max_length (int): 0 for no max
  • $lowercase (int): Minimum number of lowercase characters
  • $uppercase (int): Minimum number of uppercase characters
  • $digits (int): Minimum number of digits
  • $special_chars (int): Minimum number of non-alphabetic and non-numeric characters

Returns:

  • (bool)

Example:

use Bayfront\StringHelpers\Str;

if (!Str::hasComplexity('abc123', 8, 32, 1, 1, 1, 1)) {
    // Do something
}

has

Description:

Checks if string contains a case-sensitive needle.

This method has been depreciated in favor of PHP native function str_contains.

Parameters:

  • $string (string)
  • $needle (string)

Returns:

  • (bool)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

if (Str::has($string, 'this')) {

    // Do something

}

hasSpace

Description:

Checks if string contains any whitespace.

This method has been depreciated in favor of PHP native function str_contains.

Parameters:

  • $string (string)

Returns:

  • (bool)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

if (Str::hasSpace($string)) {

    // Do something

}

startsWith

Description:

Checks if a string starts with a given case-sensitive string.

This method has been depreciated in favor of PHP native function str_starts_with.

Parameters:

  • $string (string)
  • $starts_with (string)

Returns:

  • (bool)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

if (Str::startsWith($string, 'this')) {

    // Do something

}

endsWith

Description:

Checks if a string ends with a given case-sensitive string.

This method has been depreciated in favor of PHP native function str_ends_with.

Parameters:

  • $string (string)
  • $ends_with (string)

Returns:

  • (bool)

Example:

use Bayfront\StringHelpers\Str;

$string = 'This is a string.';

if (Str::endsWith($string, 'string.')) {

    // Do something

}

uuid

Description:

Return a UUID v4 string.

This method has been depreciated in favor of Str::uuid4 and Str::uuid7.

Parameters:

  • (None)

Returns:

  • (string)

Example:

use Bayfront\StringHelpers\Str;

echo Str::uuid();