This library provides a consistent, self-explaining layer to accomplish string related tasks.

Speaking method names make string operations more readable and reveal the intention clearly. Please compare the following, common snippets regarding readability:

// Native:
if (strpos($log, 'failure') !== false) {
    // [...]
}

// With StringUtil:
if (StringUtil::contains($log, 'failure')) {
    // [...]
}

In contrast to the built-in PHP string functions, the library provides methods with consistent signatures, which always expect the subject string as first parameter.

This library is meant for common, light-weight string operations. It is currently not designed for heavy, complex string tasks such as transparent charset handling.

Add the following to your composer.json (see getcomposer.org):

"require" :  {
    // ...
    "wuzzitor/string-util": "~1.0"
}

The library provides a single class (Wuzzitor\StringUtil), whose static methods are the entry points for all string operations.

All methods are stateless to ensure full testability and to avoid code that is hard to debug.

Example:

use Wuzzitor\StringUtil;

$filename = 'example.php';
$withoutExtension = StringUtil::removeSuffix($filename, '.php);
// $withoutExtension == 'example'

The following signatures show all available operations:

• StringUtil::startsWith(string $subject, string $prefix) : boolean
• StringUtil::endsWith(string $subject, string $suffix) : boolean
• StringUtil::contains(string $subject, string $needle) : boolean
• StringUtil::containsAny(string $subject, string[] $needles) : boolean
• StringUtil::containsAll(string $subject, string[] $needles) : boolean
• StringUtil::removePrefix(string $subject, string $prefix) : string
• StringUtil::removeSuffix(string $subject, string $suffix) : string
• StringUtil::replace(string $subject, string $search, string $replace) : string
• StringUtil::replace(string $subject, array<string, string> $searchReplaceMapping) : string

Code released under the MIT license.