mpclarkson/stringy

A PHP Library that provides a consistent api for object oriented manipulation of strings.

v1.0.2 2019-04-08 01:04 UTC

Requires

• php: >=5.4.0

Requires (Dev)

• phpunit/phpunit: 3.7.*

Apache-2.0

• Matthew Clarkson

• text
• string
• manipulation
• object oriented

README

Overview

Are you stick to death of PHP's inconsistencies in terms on manipulating strings? Well, look no further!

Rather than constantly having to write obtuse code like this to check if a string contains a substring:

  strpos($mystring, $substring) !== false ? true : false;

You can now do this (and many other things), sensibly!

  $string = new String($myString);

  $bool = $string->contains($substring);

Yay! :)

Usage

After applying any methods, the underlying text/string can be accessed as follows:

$stringy = new Stringy("mystring");
$stringy->append("is fun", " ");

echo $stringy->string();
//"mystring is fun";

Methods

Method	Parameters	Returns
string	nil	string
truncate	$chars = 50, $appendWith = "..."	$this
length	nil	int
contains	$substring	bool
startsWith	$substring	bool
endsWith	$substring	bool
append	$string	$this
reverse	nil	$this
uppercase	nil	$this
uppercaseFirst	nil	$this
lowercase	nil	$this
lowercaseFirst	nil	$this
titleCase	nil	$this
sentenceCase	nil	$this
toArray	$delimiter = null	array
apply	callback	$this

Checkout the tests for examples of each method.

Requirements

• PHP 5.4+

Composer

Use Composer by adding the following lines in your composer.json:

    "require": {
        "mpclarkson/stringy": "dev-master"
    },

Todos

• More methods
• Contributions welcome

Credits

This has been inspired by the beautify string manipulation in Apple's Swift language.

Thanks goes to Paper Planes Digital Marketing in Brisbane.