Twine: String Manipulation, Leveled Up

Twine: String Manipulation, Leveled Up

Twine is a stand-alone PHP 7 package by Chris Kankiewicz for string manipulation and comparison with an expressive fluid syntax.

Here’s the basic usage and some examples of transformation methods:

use PHLAK\Twine;

$string = new Twine\Str('john pinkerton');

$string->substring(5, 4); // Returns 'pink'
$string->pad(20, '_');  // Returns 'john pinkerton______'
$string->pad(20, '_', Twine\Config\Pad::LEFT); // Returns '______john pinkerton'
$string->pad(20, '_', Twine\Config\Pad::BOTH); // Returns '___john pinkerton___'

// Aliases
$string->padLeft(20, '_');
$string->padRight(20, '_');
$string->padBoth(20, '_');

Converting to uppercase provides you with some different options, such as the whole string, the first character, and the first character of every word:

$string = new Twine\Str('john pinkerton');

// Uppercase
$string->uppercase(); // Returns 'JOHN PINKERTON'
$string->uppercase(Twine\Config\Uppercase::FIRST); // Returns 'John pinkerton'
$string->uppercase(Twine\Config\Uppercase::WORDS); // Returns 'John Pinkerton'

// Aliases for first and words
$string->uppercaseFirst();
$string->uppercaseWords();

Twine provides various comparison methods to verify a string in a variety of ways:


$string = new Twine\Str('john pinkerton'); $string->startsWith('pink'); // false $string->endsWith('ton'); // true $string->contains('pin'); // true $string->equals('JoHN PiNKeRToN', Twine\Config\Equals::CASE_INSENSITIVE); // Returns true // Alias $string->insensitiveMatch('JoHN PiNKeRToN'); // true

You can encode a string instance with the base64() method and also generate various hashes:

$string = new Twine\Str('john pinkerton');

$string->base64(); // Returns 'am9obiBwaW5rZXJ0b24='
$string->md5(); // Returns '30cac4703a16a2201ec5cafbd600d803'
$string->sha1(); // Returns 'fcaf28c7705ba8f267472bb5aa8ad883f6bf0427'
$string->sha256(); // Returns '7434f26c8c2fc83e57347feb2dfb235c2f47b149b54b80692beca9d565159dfd'

The format() method is really neat looking, and allows you to create multiple strings from the same formatted text:

$string = new Twine\Str('Hello %s! Welcome to %s, population %b.');

$string->format('John', 'Pinkertown', 1337);
// Returns 'Hello John! Welcome to Pinkertown, population 10100111001.'

Another cool trick with this library is chaining methods and even doing assertions after chaining:

$string = new Twine\Str('john pinkerton');

$string->substring(5, 4)->equals('pink'); // Returns true

Learn More

There are a ton of string methods in this library, and I’d encourage you to check out the GitHub repo for the complete API found in the readme file. You can install it via composer at phlak/twine.

Filed in: News
Laravel News Partners

Laravel Jobs

Laravel Developer
Remote
Enjin
Senior Laravel Backend Engineer
Remote, USA Only
Kittyhawk.io, Inc.
Senior Laravel Developer
Remote, EU timezones only
Mindbeat
Experienced Laravel Developer
Remote
SolidProfessor
Full Time ad Remote - Experienced Laravel Developer
Europe Only
Thunderbite

Newsletter

Join 31,000+ others and never miss out on new tips, tutorials, and more.