Stringy - A PHP string manipulation library with multibyte support, performance optimized

Overview

Build Status codecov.io Codacy Badge Latest Stable Version Total Downloads License Donate to this project using Paypal Donate to this project using Patreon

馃墤 Stringy

A PHP string manipulation library with multibyte support. Compatible with PHP 7+

100% compatible with the original "Stringy" library, but this fork is optimized for performance and is using PHP 7+ features.

s('string')->toTitleCase()->ensureRight('y') == 'Stringy'

Why?

In part due to a lack of multibyte support (including UTF-8) across many of PHP's standard string functions. But also to offer an OO wrapper around the mbstring module's multibyte-compatible functions. Stringy handles some quirks, provides additional functionality, and hopefully makes strings a little easier to work with!

// Standard library
strtoupper('f貌么b脿艡');       // 'F貌么B脿艡'
strlen('f貌么b脿艡');           // 10

// mbstring
mb_strtoupper('f貌么b脿艡');    // 'F脪脭B脌艠'
mb_strlen('f貌么b脿艡');        // '6'

// Stringy
$stringy = Stringy\Stringy::create('f貌么b脿艡');
$stringy->toUpperCase();    // 'F脪脭B脌艠'
$stringy->length();         // '6'

Alternative

If you like a more Functional Way to edit strings, then you can take a look at voku/portable-utf8, also "voku/Stringy" used the functions from the "Portable UTF-8"-Class but in a more Object Oriented Way.

// Portable UTF-8
use voku\helper\UTF8;
UTF8::strtoupper('f貌么b脿艡');    // 'F脪脭B脌艠'
UTF8::strlen('f貌么b脿艡');        // '6'

Installation via "composer require"

composer require voku/stringy

Installation via composer (manually)

If you're using Composer to manage dependencies, you can include the following in your composer.json file:

"require": {
    "voku/stringy": "~6.0"
}

Then, after running composer update or php composer.phar update, you can load the class using Composer's autoloading:

require 'vendor/autoload.php';

Otherwise, you can simply require the file directly:

require_once 'path/to/Stringy/src/Stringy.php';

And in either case, I'd suggest using an alias.

use Stringy\Stringy as S;

OO and Chaining

The library offers OO method chaining, as seen below:

use Stringy\Stringy as S;
echo S::create('f貌么     b脿艡')->collapseWhitespace()->swapCase(); // 'F脪脭 B脌艠'

Stringy\Stringy has a __toString() method, which returns the current string when the object is used in a string context, ie: (string) S::create('foo') // 'foo'

Implemented Interfaces

Stringy\Stringy implements the IteratorAggregate interface, meaning that foreach can be used with an instance of the class:

$stringy = S::create('f貌么b脿艡');
foreach ($stringy as $char) {
    echo $char;
}
// 'f貌么b脿艡'

It implements the Countable interface, enabling the use of count() to retrieve the number of characters in the string:

$stringy = S::create('f貌么');
count($stringy);  // 3

Furthermore, the ArrayAccess interface has been implemented. As a result, isset() can be used to check if a character at a specific index exists. And since Stringy\Stringy is immutable, any call to offsetSet or offsetUnset will throw an exception. offsetGet has been implemented, however, and accepts both positive and negative indexes. Invalid indexes result in an OutOfBoundsException.

$stringy = S::create('b脿艡');
echo $stringy[2];     // '艡'
echo $stringy[-2];    // '脿'
isset($stringy[-4]);  // false

$stringy[3];          // OutOfBoundsException
$stringy[2] = 'a';    // Exception

PHP Class Call Creation

As of PHP 5.6+, use function is available for importing functions. Stringy exposes a namespaced function, Stringy\create, which emits the same behaviour as Stringy\Stringy::create().

use function Stringy\create as s;

// Instead of: S::create('f貌么     b脿艡')
s('f貌么     b脿艡')->collapseWhitespace()->swapCase();

Class methods

create(mixed $str [, $encoding ])

Creates a Stringy object and assigns both str and encoding properties the supplied values. $str is cast to a string prior to assignment, and if $encoding is not specified, it defaults to mb_internal_encoding(). It then returns the initialized object. Throws an InvalidArgumentException if the first argument is an array or object without a __toString method.

$stringy = S::create('f貌么b脿艡', 'UTF-8'); // 'f貌么b脿艡'

If you need a collection of Stringy objects you can use the S::collection() method.

$stringyCollection = \Stringy\collection(['f貌么b脿艡', 'lall', '枚盲眉']);

Instance Methods

Stringy objects are immutable. All examples below make use of PHP 5.6 function importing, and PHP 5.4 short array syntax. They also assume the encoding returned by mb_internal_encoding() is UTF-8. For further details, see the documentation for the create method above.

after afterFirst afterFirstIgnoreCase afterLast
afterLastIgnoreCase append appendPassword appendRandomString
appendStringy appendUniqueIdentifier at base64Decode
base64Encode bcrypt before beforeFirst
beforeFirstIgnoreCase beforeLast beforeLastIgnoreCase between
callUserFunction camelize capitalizePersonalName chars
chunk chunkCollection collapseWhitespace contains
containsAll containsAny containsBom count
countSubstr crc32 create crypt
dasherize decrypt delimit encode
encrypt endsWith endsWithAny ensureLeft
ensureRight escape explode explodeCollection
extractIntegers extractSpecialCharacters extractText first
format getEncoding getIterator hardWrap
hasLowerCase hasUpperCase hash hexDecode
hexEncode htmlDecode htmlEncode humanize
in indexOf indexOfIgnoreCase indexOfLast
indexOfLastIgnoreCase insert is isAlpha
isAlphanumeric isAscii isBase64 isBinary
isBlank isBom isEmail isEmpty
isEquals isEqualsCaseInsensitive isEqualsCaseSensitive isHexadecimal
isHtml isJson isLowerCase isNotEmpty
isNumeric isPrintable isPunctuation isSerialized
isSimilar isUpperCase isUrl isUtf8
isUtf16 isUtf32 isWhitespace jsonSerialize
kebabCase last lastSubstringOf lastSubstringOfIgnoreCase
length lineWrap lineWrapAfterWord lines
linesCollection longestCommonPrefix longestCommonSubstring longestCommonSuffix
lowerCaseFirst matchCaseInsensitive matchCaseSensitive md5
newLineToHtmlBreak nth offsetExists offsetGet
offsetSet offsetUnset pad padBoth
padLeft padRight pascalCase prepend
prependStringy regexReplace removeHtml removeHtmlBreak
removeLeft removeRight removeXss repeat
replace replaceAll replaceBeginning replaceEnding
replaceFirst replaceLast reverse safeTruncate
setInternalEncoding sha1 sha256 sha512
shortenAfterWord shuffle similarity slice
slugify snakeCase snakeize softWrap
split splitCollection startsWith startsWithAny
strip stripWhitespace stripeCssMediaQueries stripeEmptyHtmlTags
studlyCase substr substring substringOf
substringOfIgnoreCase surround swapCase tidy
titleize titleizeForHumans toAscii toBoolean
toLowerCase toSpaces toString toTabs
toTitleCase toTransliterate toUpperCase trim
trimLeft trimRight truncate underscored
upperCamelize upperCaseFirst urlDecode urlDecodeMulti
urlDecodeRaw urlDecodeRawMulti urlEncode urlEncodeRaw
urlify utf8ify words wordsCollection
wrap

after(string $string): static

Return part of the string occurring after a specific string.

EXAMPLE: s('瀹湰 鑼')->after('鏈'); // ' 鑼'

Parameters:

  • string $string

    The delimiting string.

Return:

  • static

afterFirst(string $separator): static

Gets the substring after the first occurrence of a separator.

If no match is found returns new empty Stringy object.

EXAMPLE: s('')->afterFirst('b'); // '>'

Parameters:

  • string $separator

Return:

  • static

afterFirstIgnoreCase(string $separator): static

Gets the substring after the first occurrence of a separator.

If no match is found returns new empty Stringy object.

EXAMPLE: s('')->afterFirstIgnoreCase('b'); // '>'

Parameters:

  • string $separator

Return:

  • static

afterLast(string $separator): static

Gets the substring after the last occurrence of a separator.

If no match is found returns new empty Stringy object.

EXAMPLE: s('')->afterLast('b'); // '>'

Parameters:

  • string $separator

Return:

  • static

afterLastIgnoreCase(string $separator): static

Gets the substring after the last occurrence of a separator.

If no match is found returns new empty Stringy object.

EXAMPLE: s('')->afterLastIgnoreCase('b'); // '>'

Parameters:

  • string $separator

Return:

  • static

append(string $suffix): static

Returns a new string with $suffix appended.

EXAMPLE: s('f貌么')->append('b脿艡'); // 'f貌么b脿艡'

Parameters:

  • string ...$suffix

    The string to append.

Return:

  • static

    Object with appended $suffix.


appendPassword(int $length): static

Append an password (limited to chars that are good readable).

EXAMPLE: s('')->appendPassword(8); // e.g.: '89bcdfgh'

Parameters:

  • int $length

    Length of the random string.

Return:

  • static

    Object with appended password.


appendRandomString(int $length, string $possibleChars): static

Append an random string.

EXAMPLE: s('')->appendUniqueIdentifier(5, 'ABCDEFGHI'); // e.g.: 'CDEHI'

Parameters:

  • int $length

    Length of the random string.

  • string $possibleChars [optional]

    Characters string for the random selection.

Return:

  • static

    Object with appended random string.


appendStringy(\CollectionStringy|static $suffix): static

Returns a new string with $suffix appended.

EXAMPLE:

Parameters:

  • CollectionStringy |static ...$suffix

    The Stringy objects to append.

Return:

  • static

    Object with appended $suffix.


appendUniqueIdentifier(int|string $entropyExtra, bool $md5): static

Append an unique identifier.

EXAMPLE: s('')->appendUniqueIdentifier(); // e.g.: '1f3870be274f6c49b3e31a0c6728957f'

Parameters:

  • int|string $entropyExtra [optional]

    Extra entropy via a string or int value.

  • bool $md5 [optional]

    Return the unique identifier as md5-hash? Default: true

Return:

  • static

    Object with appended unique identifier as md5-hash.


at(int $index): static

Returns the character at $index, with indexes starting at 0.

EXAMPLE: s('f貌么b脿艡')->at(3); // 'b'

Parameters:

  • int $index

    Position of the character.

Return:

  • static

    The character at $index.


base64Decode(): self

Decode the base64 encoded string.

EXAMPLE:

Parameters: nothing

Return:

  • self

base64Encode(): self

Encode the string to base64.

EXAMPLE:

Parameters: nothing

Return:

  • self

bcrypt(int[]|string[] $options): static

Creates a hash from the string using the CRYPT_BLOWFISH algorithm.

WARNING: Using this algorithm, will result in the $this->str being truncated to a maximum length of 72 characters.

EXAMPLE:

Parameters:

  • array $options [optional]

    An array of bcrypt hasing options.

Return:

  • static

before(string $string): static

Return part of the string occurring before a specific string.

EXAMPLE:

Parameters:

  • string $string

    The delimiting string.

Return:

  • static

beforeFirst(string $separator): static

Gets the substring before the first occurrence of a separator.

If no match is found returns new empty Stringy object.

EXAMPLE: s('')->beforeFirst('b'); // '

Parameters:

  • string $separator

Return:

  • static

beforeFirstIgnoreCase(string $separator): static

Gets the substring before the first occurrence of a separator.

If no match is found returns new empty Stringy object.

EXAMPLE: s('')->beforeFirstIgnoreCase('b'); // '

Parameters:

  • string $separator

Return:

  • static

beforeLast(string $separator): static

Gets the substring before the last occurrence of a separator.

If no match is found returns new empty Stringy object.

EXAMPLE: s('')->beforeLast('b'); // '

Parameters:

  • string $separator

Return:

  • static

beforeLastIgnoreCase(string $separator): static

Gets the substring before the last occurrence of a separator.

If no match is found returns new empty Stringy object.

EXAMPLE: s('')->beforeLastIgnoreCase('b'); // '

Parameters:

  • string $separator

Return:

  • static

between(string $start, string $end, int $offset): static

Returns the substring between $start and $end, if found, or an empty string. An optional offset may be supplied from which to begin the search for the start string.

EXAMPLE: s('{foo} and {bar}')->between('{', '}'); // 'foo'

Parameters:

  • string $start

    Delimiter marking the start of the substring.

  • string $end

    Delimiter marking the end of the substring.

  • int $offset [optional]

    Index from which to begin the search. Default: 0

Return:

  • static

    Object whose $str is a substring between $start and $end.


callUserFunction(callable $function, mixed $parameter): static

Call a user function.

EXAMPLE: S::create('foo bar lall')->callUserFunction(static function ($str) { return UTF8::str_limit($str, 8); })->toString(); // "foo bar鈥"

Parameters:

  • callable $function
  • mixed ...$parameter

Return:

  • static

    Object having a $str changed via $function.


camelize(): static

Returns a camelCase version of the string. Trims surrounding spaces, capitalizes letters following digits, spaces, dashes and underscores, and removes spaces, dashes, as well as underscores.

EXAMPLE: s('Camel-Case')->camelize(); // 'camelCase'

Parameters: nothing

Return:

  • static

    Object with $str in camelCase.


capitalizePersonalName(): static

Returns the string with the first letter of each word capitalized, except for when the word is a name which shouldn't be capitalized.

EXAMPLE: s('jaap de hoop scheffer')->capitalizePersonName(); // 'Jaap de Hoop Scheffer'

Parameters: nothing

Return:

  • static

    Object with $str capitalized.


chars(): string[]

Returns an array consisting of the characters in the string.

EXAMPLE: s('f貌么b脿艡')->chars(); // ['f', '貌', '么', 'b', '脿', '艡']

Parameters: nothing

Return:

  • string[]

    An array of string chars.


chunk(int $length): static[]

Splits the string into chunks of Stringy objects.

EXAMPLE: s('foobar')->chunk(3); // ['foo', 'bar']

Parameters:

  • int $length [optional]

    Max character length of each array element.

Return:

  • static[]

    An array of Stringy objects.


chunkCollection(int $length): CollectionStringy|static[]

Splits the string into chunks of Stringy objects collection.

EXAMPLE:

Parameters:

  • int $length [optional]

    Max character length of each array element.

Return:

  • \CollectionStringy|static[]

    An collection of Stringy objects.


collapseWhitespace(): static

Trims the string and replaces consecutive whitespace characters with a single space. This includes tabs and newline characters, as well as multibyte whitespace such as the thin space and ideographic space.

EXAMPLE: s(' 螣 蟽蠀纬纬蟻伪蠁苇伪蟼 ')->collapseWhitespace(); // '螣 蟽蠀纬纬蟻伪蠁苇伪蟼'

Parameters: nothing

Return:

  • static

    Object with a trimmed $str and condensed whitespace.


contains(string $needle, bool $caseSensitive): bool

Returns true if the string contains $needle, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.

EXAMPLE: s('螣 蟽蠀纬纬蟻伪蠁苇伪蟼 蔚委蟺蔚')->contains('蟽蠀纬纬蟻伪蠁苇伪蟼'); // true

Parameters:

  • string $needle

    Substring to look for.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • bool

    Whether or not $str contains $needle.


containsAll(string[] $needles, bool $caseSensitive): bool

Returns true if the string contains all $needles, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.

EXAMPLE: s('foo & bar')->containsAll(['foo', 'bar']); // true

Parameters:

  • string[] $needles

    SubStrings to look for.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • bool

    Whether or not $str contains $needle.


containsAny(string[] $needles, bool $caseSensitive): bool

Returns true if the string contains any $needles, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.

EXAMPLE: s('str contains foo')->containsAny(['foo', 'bar']); // true

Parameters:

  • string[] $needles

    SubStrings to look for.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • bool

    Whether or not $str contains $needle.


containsBom(): bool

Checks if string starts with "BOM" (Byte Order Mark Character) character.

EXAMPLE: s("\xef\xbb\xbf foobar")->containsBom(); // true

Parameters: nothing

Return:

  • bool true if the string has BOM at the start,
    false otherwise

count(): int

Returns the length of the string, implementing the countable interface.

EXAMPLE:

Parameters: nothing

Return:

  • int

    The number of characters in the string, given the encoding.


countSubstr(string $substring, bool $caseSensitive): int

Returns the number of occurrences of $substring in the given string.

By default, the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.

EXAMPLE: s('螣 蟽蠀纬纬蟻伪蠁苇伪蟼 蔚委蟺蔚')->countSubstr('伪'); // 2

Parameters:

  • string $substring

    The substring to search for.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • int

crc32(): int

Calculates the crc32 polynomial of a string.

EXAMPLE:

Parameters: nothing

Return:

  • int

create(mixed $str, string $encoding): static

Creates a Stringy object and assigns both str and encoding properties the supplied values. $str is cast to a string prior to assignment, and if $encoding is not specified, it defaults to mb_internal_encoding(). It then returns the initialized object. Throws an InvalidArgumentException if the first argument is an array or object without a __toString method.

Parameters:

  • mixed $str [optional]

    Value to modify, after being cast to string. Default: ''

  • string $encoding [optional]

    The character encoding. Fallback: 'UTF-8'

Return:

  • static

    A Stringy object.


crypt(string $salt): static

One-way string encryption (hashing).

Hash the string using the standard Unix DES-based algorithm or an alternative algorithm that may be available on the system.

PS: if you need encrypt / decrypt, please use static::encrypt($password) and static::decrypt($password)

EXAMPLE:

Parameters:

  • string $salt

    A salt string to base the hashing on.

Return:

  • static

dasherize(): static

Returns a lowercase and trimmed string separated by dashes. Dashes are inserted before uppercase characters (with the exception of the first character of the string), and in place of spaces as well as underscores.

EXAMPLE: s('fooBar')->dasherize(); // 'foo-bar'

Parameters: nothing

Return:

  • static

    Object with a dasherized $str


decrypt(string $password): static

Decrypt the string.

EXAMPLE:

Parameters:

  • string $password The key for decrypting

Return:

  • static

delimit(string $delimiter): static

Returns a lowercase and trimmed string separated by the given delimiter.

Delimiters are inserted before uppercase characters (with the exception of the first character of the string), and in place of spaces, dashes, and underscores. Alpha delimiters are not converted to lowercase.

EXAMPLE: s('fooBar')->delimit('::'); // 'foo::bar'

Parameters:

  • string $delimiter

    Sequence used to separate parts of the string.

Return:

  • static

    Object with a delimited $str.


encode(string $new_encoding, bool $auto_detect_encoding): static

Encode the given string into the given $encoding + set the internal character encoding.

EXAMPLE:

Parameters:

  • string $new_encoding

    The desired character encoding.

  • bool $auto_detect_encoding [optional]

    Auto-detect the current string-encoding

Return:

  • static

encrypt(string $password): static

Encrypt the string.

EXAMPLE:

Parameters:

  • string $password

    The key for encrypting

Return:

  • static

endsWith(string $substring, bool $caseSensitive): bool

Returns true if the string ends with $substring, false otherwise. By default, the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.

EXAMPLE: s('f貌么b脿艡')->endsWith('b脿艡', true); // true

Parameters:

  • string $substring

    The substring to look for.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • bool

    Whether or not $str ends with $substring.


endsWithAny(string[] $substrings, bool $caseSensitive): bool

Returns true if the string ends with any of $substrings, false otherwise.

By default, the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.

EXAMPLE: s('f貌么b脿艡')->endsWithAny(['b脿艡', 'baz'], true); // true

Parameters:

  • string[] $substrings

    Substrings to look for.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • bool

    Whether or not $str ends with $substring.


ensureLeft(string $substring): static

Ensures that the string begins with $substring. If it doesn't, it's prepended.

EXAMPLE: s('foobar')->ensureLeft('http://'); // 'http://foobar'

Parameters:

  • string $substring

    The substring to add if not present.

Return:

  • static

    Object with its $str prefixed by the $substring.


ensureRight(string $substring): static

Ensures that the string ends with $substring. If it doesn't, it's appended.

EXAMPLE: s('foobar')->ensureRight('.com'); // 'foobar.com'

Parameters:

  • string $substring

    The substring to add if not present.

Return:

  • static

    Object with its $str suffixed by the $substring.


escape(): static

Create a escape html version of the string via "htmlspecialchars()".

EXAMPLE: s('<鈭傗垎 onerror="alert(xss)">')->escape(); // '<鈭傗垎 onerror="alert(xss)">'

Parameters: nothing

Return:

  • static

explode(string $delimiter, int $limit): array

Split a string by a string.

EXAMPLE:

Parameters:

  • string $delimiter

    The boundary string

  • `int $limit [optional]

    The maximum number of elements in the exploded collection.

  • If limit is set and positive, the returned collection will contain a maximum of limit elements with the last element containing the rest of string.

  • If the limit parameter is negative, all components except the last -limit are returned.

  • If the limit parameter is zero, then this is treated as 1`

Return:

  • array

explodeCollection(string $delimiter, int $limit): CollectionStringy|static[]

Split a string by a string.

EXAMPLE:

Parameters:

  • string $delimiter

    The boundary string

  • `int $limit [optional]

    The maximum number of elements in the exploded collection.

  • If limit is set and positive, the returned collection will contain a maximum of limit elements with the last element containing the rest of string.

  • If the limit parameter is negative, all components except the last -limit are returned.

  • If the limit parameter is zero, then this is treated as 1`

Return:

  • \CollectionStringy|static[]

    An collection of Stringy objects.


extractIntegers(): static

Returns the integer value of the current string.

EXAMPLE: s('foo1 ba2r')->extractIntegers(); // '12'

Parameters: nothing

Return:

  • static

extractSpecialCharacters(): static

Returns the special chars of the current string.

EXAMPLE: s('foo1 ba2!r')->extractSpecialCharacters(); // '!'

Parameters: nothing

Return:

  • static

extractText(string $search, int|null $length, string $replacerForSkippedText): static

Create an extract from a sentence, so if the search-string was found, it try to centered in the output.

EXAMPLE: $sentence = 'This is only a Fork of Stringy, take a look at the new features.'; s($sentence)->extractText('Stringy'); // '...Fork of Stringy...'

Parameters:

  • string $search
  • int|null $length [optional]

    Default: null === text->length / 2

  • string $replacerForSkippedText [optional]

    Default: 鈥

Return:

  • static

first(int $n): static

Returns the first $n characters of the string.

EXAMPLE: s('f貌么b脿艡')->first(3); // 'f貌么'

Parameters:

  • int $n

    Number of characters to retrieve from the start.

Return:

  • static

    Object with its $str being the first $n chars.


format(mixed $args): static

Return a formatted string via sprintf + named parameters via array syntax.


It will use "sprintf()" so you can use e.g.:

s('There are %d monkeys in the %s')->format(5, 'tree');


s('There are %2$d monkeys in the %1$s')->format('tree', 5);


But you can also use named parameter via array syntax e.g.:

s('There are %:count monkeys in the %:location')->format(['count' => 5, 'location' => 'tree');

EXAMPLE: $input = 'one: %2$d, %1$s: 2, %:text_three: %3$d'; s($input)->format(['text_three' => '%4$s'], 'two', 1, 3, 'three'); // 'One: 1, two: 2, three: 3'

Parameters:

  • mixed ...$args [optional]

Return:

  • static

    A Stringy object produced according to the formatting string format.


getEncoding(): string

Returns the encoding used by the Stringy object.

EXAMPLE: s('f貌么b脿艡', 'UTF-8')->getEncoding(); // 'UTF-8'

Parameters: nothing

Return:

  • string

    The current value of the $encoding property.


getIterator(): ArrayIterator

Returns a new ArrayIterator, thus implementing the IteratorAggregate interface. The ArrayIterator's constructor is passed an array of chars in the multibyte string. This enables the use of foreach with instances of Stringy\Stringy.

EXAMPLE:

Parameters: nothing

Return:

  • \ArrayIterator

    An iterator for the characters in the string.


hardWrap(int $width, string $break): static

Wrap the string after an exact number of characters.

EXAMPLE:

Parameters:

  • int $width

    Number of characters at which to wrap.

  • string $break [optional]

    Character used to break the string. | Default: "\n"

Return:

  • static

hasLowerCase(): bool

Returns true if the string contains a lower case char, false otherwise

EXAMPLE: s('f貌么b脿艡')->hasLowerCase(); // true

Parameters: nothing

Return:

  • bool

    Whether or not the string contains a lower case character.


hasUpperCase(): bool

Returns true if the string contains an upper case char, false otherwise.

EXAMPLE: s('f貌么b脿艡')->hasUpperCase(); // false

Parameters: nothing

Return:

  • bool

    Whether or not the string contains an upper case character.


hash(string $algorithm): static

Generate a hash value (message digest).

EXAMPLE:

Parameters:

  • string $algorithm

    Name of selected hashing algorithm (i.e. "md5", "sha256", "haval160,4", etc..)

Return:

  • static

hexDecode(): static

Decode the string from hex.

EXAMPLE:

Parameters: nothing

Return:

  • static

hexEncode(): static

Encode string to hex.

EXAMPLE:

Parameters: nothing

Return:

  • static

htmlDecode(int $flags): static

Convert all HTML entities to their applicable characters.

EXAMPLE: s('&')->htmlDecode(); // '&'

Parameters:

  • `int $flags [optional]

    A bitmask of one or more of the following flags, which specify how to handle quotes and which document type to use. The default is ENT_COMPAT.

Available flags constants
Constant Name Description
ENT_COMPAT Will convert double-quotes and leave single-quotes alone.
ENT_QUOTES Will convert both double and single quotes.
ENT_NOQUOTES Will leave both double and single quotes unconverted.
ENT_HTML401 Handle code as HTML 4.01.
ENT_XML1 Handle code as XML 1.
ENT_XHTML Handle code as XHTML.
ENT_HTML5 Handle code as HTML 5.

`

Return:

  • static

    Object with the resulting $str after being html decoded.


htmlEncode(int $flags): static

Convert all applicable characters to HTML entities.

EXAMPLE: s('&')->htmlEncode(); // '&'

Parameters:

  • `int $flags [optional]

    A bitmask of one or more of the following flags, which specify how to handle quotes and which document type to use. The default is ENT_COMPAT.

Available flags constants
Constant Name Description
ENT_COMPAT Will convert double-quotes and leave single-quotes alone.
ENT_QUOTES Will convert both double and single quotes.
ENT_NOQUOTES Will leave both double and single quotes unconverted.
ENT_HTML401 Handle code as HTML 4.01.
ENT_XML1 Handle code as XML 1.
ENT_XHTML Handle code as XHTML.
ENT_HTML5 Handle code as HTML 5.

`

Return:

  • static

    Object with the resulting $str after being html encoded.


humanize(): static

Capitalizes the first word of the string, replaces underscores with spaces, and strips '_id'.

EXAMPLE: s('author_id')->humanize(); // 'Author'

Parameters: nothing

Return:

  • static

    Object with a humanized $str.


in(string $str, bool $caseSensitive): bool

Determine if the current string exists in another string. By default, the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.

EXAMPLE:

Parameters:

  • string $str

    The string to compare against.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • bool

indexOf(string $needle, int $offset): false|int

Returns the index of the first occurrence of $needle in the string, and false if not found. Accepts an optional offset from which to begin the search.

EXAMPLE: s('string')->indexOf('ing'); // 3

Parameters:

  • string $needle

    Substring to look for.

  • int $offset [optional]

    Offset from which to search. Default: 0

Return:

  • false|int

    The occurrence's index if found, otherwise false.


indexOfIgnoreCase(string $needle, int $offset): false|int

Returns the index of the first occurrence of $needle in the string, and false if not found. Accepts an optional offset from which to begin the search.

EXAMPLE: s('string')->indexOfIgnoreCase('ING'); // 3

Parameters:

  • string $needle

    Substring to look for.

  • int $offset [optional]

    Offset from which to search. Default: 0

Return:

  • false|int

    The occurrence's index if found, otherwise false.


indexOfLast(string $needle, int $offset): false|int

Returns the index of the last occurrence of $needle in the string, and false if not found. Accepts an optional offset from which to begin the search. Offsets may be negative to count from the last character in the string.

EXAMPLE: s('foobarfoo')->indexOfLast('foo'); // 10

Parameters:

  • string $needle

    Substring to look for.

  • int $offset [optional]

    Offset from which to search. Default: 0

Return:

  • false|int

    The last occurrence's index if found, otherwise false.


indexOfLastIgnoreCase(string $needle, int $offset): false|int

Returns the index of the last occurrence of $needle in the string, and false if not found. Accepts an optional offset from which to begin the search. Offsets may be negative to count from the last character in the string.

EXAMPLE: s('fooBarFoo')->indexOfLastIgnoreCase('foo'); // 10

Parameters:

  • string $needle

    Substring to look for.

  • int $offset [optional]

    Offset from which to search. Default: 0

Return:

  • false|int

    The last occurrence's index if found, otherwise false.


insert(string $substring, int $index): static

Inserts $substring into the string at the $index provided.

EXAMPLE: s('f貌么b艡')->insert('脿', 4); // 'f貌么b脿艡'

Parameters:

  • string $substring

    String to be inserted.

  • int $index

    The index at which to insert the substring.

Return:

  • static

    Object with the resulting $str after the insertion.


is(string $pattern): bool

Returns true if the string contains the $pattern, otherwise false.

WARNING: Asterisks ("") are translated into (".") zero-or-more regular expression wildcards.

EXAMPLE: s('Foo\Bar\Lall')->is('\Bar\'); // true

Parameters:

  • string $pattern

    The string or pattern to match against.

Return:

  • bool

    Whether or not we match the provided pattern.


isAlpha(): bool

Returns true if the string contains only alphabetic chars, false otherwise.

EXAMPLE: s('涓瑰凹鐖')->isAlpha(); // true

Parameters: nothing

Return:

  • bool

    Whether or not $str contains only alphabetic chars.


isAlphanumeric(): bool

Returns true if the string contains only alphabetic and numeric chars, false otherwise.

EXAMPLE: s('丿丕賳賷丕賱1')->isAlphanumeric(); // true

Parameters: nothing

Return:

  • bool

    Whether or not $str contains only alphanumeric chars.


isAscii(): bool

Checks if a string is 7 bit ASCII.

EXAMPLE: s('鐧')->isAscii; // false

Parameters: nothing

Return:

  • `bool

    true if it is ASCII
    false otherwise

`

isBase64(bool $emptyStringIsValid): bool

Returns true if the string is base64 encoded, false otherwise.

EXAMPLE: s('Zm9vYmFy')->isBase64(); // true

Parameters:

  • bool $emptyStringIsValid

Return:

  • bool

    Whether or not $str is base64 encoded.


isBinary(): bool

Check if the input is binary... (is look like a hack).

EXAMPLE: s(01)->isBinary(); // true

Parameters: nothing

Return:

  • bool

isBlank(): bool

Returns true if the string contains only whitespace chars, false otherwise.

EXAMPLE: s("\n\t \v\f")->isBlank(); // true

Parameters: nothing

Return:

  • bool

    Whether or not $str contains only whitespace characters.


isBom(): bool

Checks if the given string is equal to any "Byte Order Mark".

WARNING: Use "s::string_has_bom()" if you will check BOM in a string.

EXAMPLE: s->("\xef\xbb\xbf")->isBom(); // true

Parameters: nothing

Return:

  • bool

    true if the $utf8_chr is Byte Order Mark, false otherwise.


isEmail(bool $useExampleDomainCheck, bool $useTypoInDomainCheck, bool $useTemporaryDomainCheck, bool $useDnsCheck): bool

Returns true if the string contains a valid E-Mail address, false otherwise.

EXAMPLE: s('[email protected]')->isEmail(); // true

Parameters:

  • bool $useExampleDomainCheck [optional]

    Default: false

  • bool $useTypoInDomainCheck [optional]

    Default: false

  • bool $useTemporaryDomainCheck [optional]

    Default: false

  • bool $useDnsCheck [optional]

    Default: false

Return:

  • bool

    Whether or not $str contains a valid E-Mail address.


isEmpty(): bool

Determine whether the string is considered to be empty.

A variable is considered empty if it does not exist or if its value equals FALSE.

EXAMPLE: s('')->isEmpty(); // true

Parameters: nothing

Return:

  • bool

    Whether or not $str is empty().


isEquals(string|\Stringy $str): bool

Determine whether the string is equals to $str.

Alias for isEqualsCaseSensitive()

EXAMPLE: s('foo')->isEquals('foo'); // true

Parameters:

  • string|\Stringy ...$str

Return:

  • bool

isEqualsCaseInsensitive(float|int|string|\Stringy $str): bool

Determine whether the string is equals to $str.

EXAMPLE:

Parameters:

  • float|int|string|\Stringy ...$str

    The string to compare.

Return:

  • bool

    Whether or not $str is equals.


isEqualsCaseSensitive(float|int|string|\Stringy $str): bool

Determine whether the string is equals to $str.

EXAMPLE:

Parameters:

  • float|int|string|\Stringy ...$str

    The string to compare.

Return:

  • bool

    Whether or not $str is equals.


isHexadecimal(): bool

Returns true if the string contains only hexadecimal chars, false otherwise.

EXAMPLE: s('A102F')->isHexadecimal(); // true

Parameters: nothing

Return:

  • bool

    Whether or not $str contains only hexadecimal chars.


isHtml(): bool

Returns true if the string contains HTML-Tags, false otherwise.

EXAMPLE: s('

foo

')->isHtml(); // true

Parameters: nothing

Return:

  • bool

    Whether or not $str contains HTML-Tags.


isJson(bool $onlyArrayOrObjectResultsAreValid): bool

Returns true if the string is JSON, false otherwise. Unlike json_decode in PHP 5.x, this method is consistent with PHP 7 and other JSON parsers, in that an empty string is not considered valid JSON.

EXAMPLE: s('{"foo":"bar"}')->isJson(); // true

Parameters:

  • bool $onlyArrayOrObjectResultsAreValid

Return:

  • bool

    Whether or not $str is JSON.


isLowerCase(): bool

Returns true if the string contains only lower case chars, false otherwise.

EXAMPLE: s('f貌么b脿艡')->isLowerCase(); // true

Parameters: nothing

Return:

  • bool

    Whether or not $str contains only lower case characters.


isNotEmpty(): bool

Determine whether the string is considered to be NOT empty.

A variable is considered NOT empty if it does exist or if its value equals TRUE.

EXAMPLE: s('')->isNotEmpty(); // false

Parameters: nothing

Return:

  • bool

    Whether or not $str is empty().


isNumeric(): bool

Determine if the string is composed of numeric characters.

EXAMPLE:

Parameters: nothing

Return:

  • bool

isPrintable(): bool

Determine if the string is composed of printable (non-invisible) characters.

EXAMPLE:

Parameters: nothing

Return:

  • bool

isPunctuation(): bool

Determine if the string is composed of punctuation characters.

EXAMPLE:

Parameters: nothing

Return:

  • bool

isSerialized(): bool

Returns true if the string is serialized, false otherwise.

EXAMPLE: s('a:1:{s:3:"foo";s:3:"bar";}')->isSerialized(); // true

Parameters: nothing

Return:

  • bool

    Whether or not $str is serialized.


isSimilar(string $str, float $minPercentForSimilarity): bool

Check if two strings are similar.

EXAMPLE:

Parameters:

  • string $str

    The string to compare against.

  • float $minPercentForSimilarity [optional]

    The percentage of needed similarity. | Default: 80%

Return:

  • bool

isUpperCase(): bool

Returns true if the string contains only lower case chars, false otherwise.

EXAMPLE: s('F脪脭B脌艠')->isUpperCase(); // true

Parameters: nothing

Return:

  • bool

    Whether or not $str contains only lower case characters.


isUrl(bool $disallow_localhost): bool

/** Check if $url is an correct url.

Parameters:

  • bool $disallow_localhost

Return:

  • bool

isUtf8(bool $strict): bool

Checks whether the passed input contains only byte sequences that appear valid UTF-8.

EXAMPLE: s('I帽t毛rn芒ti么n脿liz忙ti酶n')->isUtf8(); // true // s("I帽t毛rn芒ti么n脿liz忙ti酶n\xA0\xA1")->isUtf8(); // false

Parameters:

  • bool $strict

    Check also if the string is not UTF-16 or UTF-32.

Return:

  • bool

isUtf16(): false|int

Check if the string is UTF-16.

Parameters: nothing

Return:

  • false|int false if is't not UTF-16,
    1 for UTF-16LE,
    2 for UTF-16BE

isUtf32(): false|int

Check if the string is UTF-32.

Parameters: nothing

Return:

  • false|int false if is't not UTF-32,
    1 for UTF-32LE,
    2 for UTF-32BE

isWhitespace(): bool

Returns true if the string contains only whitespace chars, false otherwise.

EXAMPLE:

Parameters: nothing

Return:

  • bool

    Whether or not $str contains only whitespace characters.


jsonSerialize(): string

Returns value which can be serialized by json_encode().

EXAMPLE:

Parameters: nothing

Return:

  • string The current value of the $str property

kebabCase(): static

Convert the string to kebab-case.

EXAMPLE:

Parameters: nothing

Return:

  • static

last(int $n): static

Returns the last $n characters of the string.

EXAMPLE: s('f貌么b脿艡')->last(3); // 'b脿艡'

Parameters:

  • int $n

    Number of characters to retrieve from the end.

Return:

  • static

    Object with its $str being the last $n chars.


lastSubstringOf(string $needle, bool $beforeNeedle): static

Gets the substring after (or before via "$beforeNeedle") the last occurrence of the "$needle".

If no match is found returns new empty Stringy object.

EXAMPLE:

Parameters:

  • string $needle

    The string to look for.

  • bool $beforeNeedle [optional]

    Default: false

Return:

  • static

lastSubstringOfIgnoreCase(string $needle, bool $beforeNeedle): static

Gets the substring after (or before via "$beforeNeedle") the last occurrence of the "$needle".

If no match is found returns new empty Stringy object.

EXAMPLE:

Parameters:

  • string $needle

    The string to look for.

  • bool $beforeNeedle [optional]

    Default: false

Return:

  • static

length(): int

Returns the length of the string.

EXAMPLE: s('f貌么b脿艡')->length(); // 6

Parameters: nothing

Return:

  • int

    The number of characters in $str given the encoding.


lineWrap(int $limit, string $break, bool $add_final_break, string|null $delimiter): static

Line-Wrap the string after $limit, but also after the next word.

EXAMPLE:

Parameters:

  • int $limit [optional]

    The column width.

  • string $break [optional]

    The line is broken using the optional break parameter.

  • `bool $add_final_break [optional]

    If this flag is true, then the method will add a $break at the end of the result string.

` - `string|null $delimiter [optional]

You can change the default behavior, where we split the string by newline.

`

Return:

  • static

lineWrapAfterWord(int $limit, string $break, bool $add_final_break, string|null $delimiter): static

Line-Wrap the string after $limit, but also after the next word.

EXAMPLE:

Parameters:

  • int $limit [optional]

    The column width.

  • string $break [optional]

    The line is broken using the optional break parameter.

  • `bool $add_final_break [optional]

    If this flag is true, then the method will add a $break at the end of the result string.

` - `string|null $delimiter [optional]

You can change the default behavior, where we split the string by newline.

`

Return:

  • static

lines(): static[]

Splits on newlines and carriage returns, returning an array of Stringy objects corresponding to the lines in the string.

EXAMPLE: s("f貌么\r\nb脿艡\n")->lines(); // ['f貌么', 'b脿艡', '']

Parameters: nothing

Return:

  • static[]

    An array of Stringy objects.


linesCollection(): CollectionStringy|static[]

Splits on newlines and carriage returns, returning an array of Stringy objects corresponding to the lines in the string.

EXAMPLE:

Parameters: nothing

Return:

  • \CollectionStringy|static[]

    An collection of Stringy objects.


longestCommonPrefix(string $otherStr): static

Returns the longest common prefix between the string and $otherStr.

EXAMPLE: s('foobar')->longestCommonPrefix('foobaz'); // 'fooba'

Parameters:

  • string $otherStr

    Second string for comparison.

Return:

  • static

    Object with its $str being the longest common prefix.


longestCommonSubstring(string $otherStr): static

Returns the longest common substring between the string and $otherStr.

In the case of ties, it returns that which occurs first.

EXAMPLE: s('foobar')->longestCommonSubstring('boofar'); // 'oo'

Parameters:

  • string $otherStr

    Second string for comparison.

Return:

  • static

    Object with its $str being the longest common substring.


longestCommonSuffix(string $otherStr): static

Returns the longest common suffix between the string and $otherStr.

EXAMPLE: s('f貌么b脿艡')->longestCommonSuffix('f貌rb脿艡'); // 'b脿艡'

Parameters:

  • string $otherStr

    Second string for comparison.

Return:

  • static

    Object with its $str being the longest common suffix.


lowerCaseFirst(): static

Converts the first character of the string to lower case.

EXAMPLE: s('危 Foo')->lowerCaseFirst(); // '蟽 Foo'

Parameters: nothing

Return:

  • static

    Object with the first character of $str being lower case.


matchCaseInsensitive(string|\Stringy $str): bool

Determine if the string matches another string regardless of case.

Alias for isEqualsCaseInsensitive()

EXAMPLE:

Parameters:

  • string|\Stringy ...$str

    The string to compare against.

Return:

  • bool

matchCaseSensitive(string|\Stringy $str): bool

Determine if the string matches another string.

Alias for isEqualsCaseSensitive()

EXAMPLE:

Parameters:

  • string|\Stringy ...$str

    The string to compare against.

Return:

  • bool

md5(): static

Create a md5 hash from the current string.

Parameters: nothing

Return:

  • static

newLineToHtmlBreak(): static

Replace all breaks [
| \r\n | \r | \n | ...] into "
".

EXAMPLE:

Parameters: nothing

Return:

  • static

nth(int $step, int $offset): static

Get every nth character of the string.

EXAMPLE:

Parameters:

  • int $step

    The number of characters to step.

  • int $offset [optional]

    The string offset to start at.

Return:

  • static

offsetExists(int $offset): bool

Returns whether or not a character exists at an index. Offsets may be negative to count from the last character in the string. Implements part of the ArrayAccess interface.

EXAMPLE:

Parameters:

  • int $offset

    The index to check.

Return:

  • bool

    Whether or not the index exists.


offsetGet(int $offset): string

Returns the character at the given index. Offsets may be negative to count from the last character in the string. Implements part of the ArrayAccess interface, and throws an OutOfBoundsException if the index does not exist.

EXAMPLE:

Parameters:

  • int $offset

    The index from which to retrieve the char.

Return:

  • string

    The character at the specified index.


offsetSet(int $offset, mixed $value): void

Implements part of the ArrayAccess interface, but throws an exception when called. This maintains the immutability of Stringy objects.

EXAMPLE:

Parameters:

  • int $offset

    The index of the character.

  • mixed $value

    Value to set.

Return:

  • void

offsetUnset(int $offset): void

Implements part of the ArrayAccess interface, but throws an exception when called. This maintains the immutability of Stringy objects.

EXAMPLE:

Parameters:

  • int $offset

    The index of the character.

Return:

  • void

pad(int $length, string $padStr, string $padType): static

Pads the string to a given length with $padStr. If length is less than or equal to the length of the string, no padding takes places. The default string used for padding is a space, and the default type (one of 'left', 'right', 'both') is 'right'. Throws an InvalidArgumentException if $padType isn't one of those 3 values.

EXAMPLE: s('f貌么b脿艡')->pad(9, '-/', 'left'); // '-/-f貌么b脿艡'

Parameters:

  • int $length

    Desired string length after padding.

  • string $padStr [optional]

    String used to pad, defaults to space. Default: ' '

  • string $padType [optional]

    One of 'left', 'right', 'both'. Default: 'right'

Return:

  • static

    Object with a padded $str.


padBoth(int $length, string $padStr): static

Returns a new string of a given length such that both sides of the string are padded. Alias for pad() with a $padType of 'both'.

EXAMPLE: s('foo bar')->padBoth(9, ' '); // ' foo bar '

Parameters:

  • int $length

    Desired string length after padding.

  • string $padStr [optional]

    String used to pad, defaults to space. Default: ' '

Return:

  • static

    String with padding applied.


padLeft(int $length, string $padStr): static

Returns a new string of a given length such that the beginning of the string is padded. Alias for pad() with a $padType of 'left'.

EXAMPLE: s('foo bar')->padLeft(9, ' '); // ' foo bar'

Parameters:

  • int $length

    Desired string length after padding.

  • string $padStr [optional]

    String used to pad, defaults to space. Default: ' '

Return:

  • static

    String with left padding.


padRight(int $length, string $padStr): static

Returns a new string of a given length such that the end of the string is padded. Alias for pad() with a $padType of 'right'.

EXAMPLE: s('foo bar')->padRight(10, '*'); // 'foo bar*_'

Parameters:

  • int $length

    Desired string length after padding.

  • string $padStr [optional]

    String used to pad, defaults to space. Default: ' '

Return:

  • static

    String with right padding.


pascalCase(): static

Convert the string to PascalCase.

Alias for studlyCase()

EXAMPLE:

Parameters: nothing

Return:

  • static

prepend(string $prefix): static

Returns a new string starting with $prefix.

EXAMPLE: s('b脿艡')->prepend('f貌么'); // 'f貌么b脿艡'

Parameters:

  • string ...$prefix

    The string to append.

Return:

  • static

    Object with appended $prefix.


prependStringy(\CollectionStringy|static $prefix): static

Returns a new string starting with $prefix.

EXAMPLE:

Parameters:

  • CollectionStringy |static ...$prefix

    The Stringy objects to append.

Return:

  • static

    Object with appended $prefix.


regexReplace(string $pattern, string $replacement, string $options, string $delimiter): static

Replaces all occurrences of $pattern in $str by $replacement.

EXAMPLE: s('f貌么 ')->regexReplace('f[貌么]+\s', 'b脿艡'); // 'b脿艡' s('f貌')->regexReplace('(貌)', '\1么'); // 'f貌么'

Parameters:

  • string $pattern

    The regular expression pattern.

  • string $replacement

    The string to replace with.

  • string $options [optional]

    Matching conditions to be used.

  • string $delimiter [optional]

    Delimiter the the regex. Default: '/'

Return:

  • static

    Object with the result2ing $str after the replacements.


removeHtml(string $allowableTags): static

Remove html via "strip_tags()" from the string.

EXAMPLE: s('艡脿b <么> 貌f', 么
foo lall')->removeHtml('

'); // '艡脿b 貌f', 么
foo lall'

Parameters:

  • `string $allowableTags [optional]

    You can use the optional second parameter to specify tags which should not be stripped. Default: null

`

Return:

  • static

removeHtmlBreak(string $replacement): static

Remove all breaks [
| \r\n | \r | \n | ...] from the string.

EXAMPLE: s('艡脿b <么> 貌f', 么
foo lall')->removeHtmlBreak(''); // '艡脿b <么> 貌f', 么< foo lall'

Parameters:

  • string $replacement [optional]

    Default is a empty string.

Return:

  • static

removeLeft(string $substring): static

Returns a new string with the prefix $substring removed, if present.

EXAMPLE: s('f貌么b脿艡')->removeLeft('f貌么'); // 'b脿艡'

Parameters:

  • string $substring

    The prefix to remove.

Return:

  • static

    Object having a $str without the prefix $substring.


removeRight(string $substring): static

Returns a new string with the suffix $substring removed, if present.

EXAMPLE: s('f貌么b脿艡')->removeRight('b脿艡'); // 'f貌么'

Parameters:

  • string $substring

    The suffix to remove.

Return:

  • static

    Object having a $str without the suffix $substring.


removeXss(): static

Try to remove all XSS-attacks from the string.

EXAMPLE: s('')->removeXss(); // ''

Parameters: nothing

Return:

  • static

repeat(int $multiplier): static

Returns a repeated string given a multiplier.

EXAMPLE: s('伪')->repeat(3); // '伪伪伪'

Parameters:

  • int $multiplier

    The number of times to repeat the string.

Return:

  • static

    Object with a repeated str.


replace(string $search, string $replacement, bool $caseSensitive): static

Replaces all occurrences of $search in $str by $replacement.

EXAMPLE: s('f貌么 b脿艡 f貌么 b脿艡')->replace('f貌么 ', ''); // 'b脿艡 b脿艡'

Parameters:

  • string $search

    The needle to search for.

  • string $replacement

    The string to replace with.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • static

    Object with the resulting $str after the replacements.


replaceAll(string[] $search, string|string[] $replacement, bool $caseSensitive): static

Replaces all occurrences of $search in $str by $replacement.

EXAMPLE: s('f貌么 b脿艡 lall b脿艡')->replaceAll(['f貌脭 ', 'lall'], '', false); // 'b脿艡 b脿艡'

Parameters:

  • string[] $search

    The elements to search for.

  • string|string[] $replacement

    The string to replace with.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • static

    Object with the resulting $str after the replacements.


replaceBeginning(string $search, string $replacement): static

Replaces all occurrences of $search from the beginning of string with $replacement.

EXAMPLE: s('f貌么 b脿艡 f貌么 b脿艡')->replaceBeginning('f貌么', ''); // ' b脿艡 b脿艡'

Parameters:

  • string $search

    The string to search for.

  • string $replacement

    The replacement.

Return:

  • static

    Object with the resulting $str after the replacements.


replaceEnding(string $search, string $replacement): static

Replaces all occurrences of $search from the ending of string with $replacement.

EXAMPLE: s('f貌么 b脿艡 f貌么 b脿艡')->replaceEnding('b脿艡', ''); // 'f貌么 b脿艡 f貌么 '

Parameters:

  • string $search

    The string to search for.

  • string $replacement

    The replacement.

Return:

  • static

    Object with the resulting $str after the replacements.


replaceFirst(string $search, string $replacement): static

Replaces first occurrences of $search from the beginning of string with $replacement.

EXAMPLE:

Parameters:

  • string $search

    The string to search for.

  • string $replacement

    The replacement.

Return:

  • static

    Object with the resulting $str after the replacements.


replaceLast(string $search, string $replacement): static

Replaces last occurrences of $search from the ending of string with $replacement.

EXAMPLE:

Parameters:

  • string $search

    The string to search for.

  • string $replacement

    The replacement.

Return:

  • static

    Object with the resulting $str after the replacements.


reverse(): static

Returns a reversed string. A multibyte version of strrev().

EXAMPLE: s('f貌么b脿艡')->reverse(); // '艡脿b么貌f'

Parameters: nothing

Return:

  • static

    Object with a reversed $str.


safeTruncate(int $length, string $substring, bool $ignoreDoNotSplitWordsForOneWord): static

Truncates the string to a given length, while ensuring that it does not split words. If $substring is provided, and truncating occurs, the string is further truncated so that the substring may be appended without exceeding the desired length.

EXAMPLE: s('What are your plans today?')->safeTruncate(22, '...'); // 'What are your plans...'

Parameters:

  • int $length

    Desired length of the truncated string.

  • string $substring [optional]

    The substring to append if it can fit. Default: ''

  • bool $ignoreDoNotSplitWordsForOneWord

Return:

  • static

    Object with the resulting $str after truncating.


setInternalEncoding(string $new_encoding): static

Set the internal character encoding.

EXAMPLE:

Parameters:

  • string $new_encoding

    The desired character encoding.

Return:

  • static

sha1(): static

Create a sha1 hash from the current string.

EXAMPLE:

Parameters: nothing

Return:

  • static

sha256(): static

Create a sha256 hash from the current string.

EXAMPLE:

Parameters: nothing

Return:

  • static

sha512(): static

Create a sha512 hash from the current string.

EXAMPLE:

Parameters: nothing

Return:

  • static

shortenAfterWord(int $length, string $strAddOn): static

Shorten the string after $length, but also after the next word.

EXAMPLE: s('this is a test')->shortenAfterWord(2, '...'); // 'this...'

Parameters:

  • int $length

    The given length.

  • string $strAddOn [optional]

    Default: '鈥'

Return:

  • static

shuffle(): static

A multibyte string shuffle function. It returns a string with its characters in random order.

EXAMPLE: s('f貌么b脿艡')->shuffle(); // '脿么艡b貌f'

Parameters: nothing

Return:

  • static

    Object with a shuffled $str.


similarity(string $str): float

Calculate the similarity between two strings.

EXAMPLE:

Parameters:

  • string $str

    The delimiting string.

Return:

  • float

slice(int $start, int $end): static

Returns the substring beginning at $start, and up to, but not including the index specified by $end. If $end is omitted, the function extracts the remaining string. If $end is negative, it is computed from the end of the string.

EXAMPLE: s('f貌么b脿艡')->slice(3, -1); // 'b脿'

Parameters:

  • int $start

    Initial index from which to begin extraction.

  • int $end [optional]

    Index at which to end extraction. Default: null

Return:

  • static

    Object with its $str being the extracted substring.


slugify(string $separator, string $language, string[] $replacements, bool $replace_extra_symbols, bool $use_str_to_lower, bool $use_transliterate): static

Converts the string into an URL slug. This includes replacing non-ASCII characters with their closest ASCII equivalents, removing remaining non-ASCII and non-alphanumeric characters, and replacing whitespace with $separator. The separator defaults to a single dash, and the string is also converted to lowercase. The language of the source string can also be supplied for language-specific transliteration.

EXAMPLE: s('Using strings like f貌么 b脿艡')->slugify(); // 'using-strings-like-foo-bar'

Parameters:

  • string $separator [optional]

    The string used to replace whitespace.

  • string $language [optional]

    Language of the source string.

  • array $replacements [optional]

    A map of replaceable strings.

  • bool $replace_extra_symbols [optional]

    Add some more replacements e.g. "拢" with " pound ".

  • bool $use_str_to_lower [optional]

    Use "string to lower" for the input.

  • bool $use_transliterate [optional]

    Use ASCII::to_transliterate() for unknown chars.

Return:

  • static

    Object whose $str has been converted to an URL slug.


snakeCase(): static

Convert the string to snake_case.

EXAMPLE:

Parameters: nothing

Return:

  • static

snakeize(): static

Convert a string to snake_case.

EXAMPLE: s('foo1 Bar')->snakeize(); // 'foo_1_bar'

Parameters: nothing

Return:

  • static

    Object with $str in snake_case.


softWrap(int $width, string $break): static

Wrap the string after the first whitespace character after a given number of characters.

EXAMPLE:

Parameters:

  • int $width

    Number of characters at which to wrap.

  • string $break [optional]

    Character used to break the string. | Default "\n"

Return:

  • static

split(string $pattern, int $limit): static[]

Splits the string with the provided regular expression, returning an array of Stringy objects. An optional integer $limit will truncate the results.

EXAMPLE: s('foo,bar,baz')->split(',', 2); // ['foo', 'bar']

Parameters:

  • string $pattern

    The regex with which to split the string.

  • int $limit [optional]

    Maximum number of results to return. Default: -1 === no limit

Return:

  • static[]

    An array of Stringy objects.


splitCollection(string $pattern, int $limit): CollectionStringy|static[]

Splits the string with the provided regular expression, returning an collection of Stringy objects. An optional integer $limit will truncate the results.

EXAMPLE:

Parameters:

  • string $pattern

    The regex with which to split the string.

  • int $limit [optional]

    Maximum number of results to return. Default: -1 === no limit

Return:

  • \CollectionStringy|static[]

    An collection of Stringy objects.


startsWith(string $substring, bool $caseSensitive): bool

Returns true if the string begins with $substring, false otherwise. By default, the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.

EXAMPLE: s('F脪脭b脿艡baz')->startsWith('f貌么b脿艡', false); // true

Parameters:

  • string $substring

    The substring to look for.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • bool

    Whether or not $str starts with $substring.


startsWithAny(string[] $substrings, bool $caseSensitive): bool

Returns true if the string begins with any of $substrings, false otherwise.

By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.

EXAMPLE: s('F脪脭b脿艡baz')->startsWithAny(['f貌么', 'b脿艡'], false); // true

Parameters:

  • string[] $substrings

    Substrings to look for.

  • bool $caseSensitive [optional]

    Whether or not to enforce case-sensitivity. Default: true

Return:

  • bool

    Whether or not $str starts with $substring.


strip(string|string[] $search): static

Remove one or more strings from the string.

EXAMPLE:

Parameters:

  • string|string[] $search One or more strings to be removed

Return:

  • static

stripWhitespace(): static

Strip all whitespace characters. This includes tabs and newline characters, as well as multibyte whitespace such as the thin space and ideographic space.

EXAMPLE: s(' 螣 蟽蠀纬纬蟻伪蠁苇伪蟼 ')->stripWhitespace(); // '螣蟽蠀纬纬蟻伪蠁苇伪蟼'

Parameters: nothing

Return:

  • static

stripeCssMediaQueries(): static

Remove css media-queries.

EXAMPLE: s('test @media (min-width:660px){ .des-cla #mv-tiles{width:480px} } test ')->stripeCssMediaQueries(); // 'test test '

Parameters: nothing

Return:

  • static

stripeEmptyHtmlTags(): static

Remove empty html-tag.

EXAMPLE: s('foo

bar')->stripeEmptyHtmlTags(); // 'foobar'

Parameters: nothing

Return:

  • static

studlyCase(): static

Convert the string to StudlyCase.

EXAMPLE:

Parameters: nothing

Return:

  • static

substr(int $start, int $length): static

Returns the substring beginning at $start with the specified $length.

It differs from the $this->utf8::substr() function in that providing a $length of null will return the rest of the string, rather than an empty string.

EXAMPLE:

Parameters:

  • int $start

    Position of the first character to use.

  • int $length [optional]

    Maximum number of characters used. Default: null

Return:

  • static

    Object with its $str being the substring.


substring(int $start, int $length): static

Return part of the string.

Alias for substr()

EXAMPLE: s('f貌么b脿艡')->substring(2, 3); // '么b脿'

Parameters:

  • int $start

    Starting position of the substring.

  • int $length [optional]

    Length of substring.

Return:

  • static

substringOf(string $needle, bool $beforeNeedle): static

Gets the substring after (or before via "$beforeNeedle") the first occurrence of the "$needle".

If no match is found returns new empty Stringy object.

EXAMPLE:

Parameters:

  • string $needle

    The string to look for.

  • bool $beforeNeedle [optional]

    Default: false

Return:

  • static

substringOfIgnoreCase(string $needle, bool $beforeNeedle): static

Gets the substring after (or before via "$beforeNeedle") the first occurrence of the "$needle".

If no match is found returns new empty Stringy object.

EXAMPLE:

Parameters:

  • string $needle

    The string to look for.

  • bool $beforeNeedle [optional]

    Default: false

Return:

  • static

surround(string $substring): static

Surrounds $str with the given substring.

EXAMPLE: s(' 蜏 ')->surround('蕵'); // '蕵 蜏 蕵'

Parameters:

  • string $substring

    The substring to add to both sides.

Return:

  • static

    Object whose $str had the substring both prepended and appended.


swapCase(): static

Returns a case swapped version of the string.

EXAMPLE: s('螡蟿伪谓喂位')->swapCase(); // '谓韦螒螡螜螞'

Parameters: nothing

Return:

  • static

    Object whose $str has each character's case swapped.


tidy(): static

Returns a string with smart quotes, ellipsis characters, and dashes from Windows-1252 (commonly used in Word documents) replaced by their ASCII equivalents.

EXAMPLE: s('鈥淚 see鈥︹')->tidy(); // '"I see..."'

Parameters: nothing

Return:

  • static

    Object whose $str has those characters removed.


titleize(string[]|null $ignore, string|null $word_define_chars, string|null $language): static

Returns a trimmed string with the first letter of each word capitalized.

Also accepts an array, $ignore, allowing you to list words not to be capitalized.

EXAMPLE: $ignore = ['at', 'by', 'for', 'in', 'of', 'on', 'out', 'to', 'the']; s('i like to watch television')->titleize($ignore); // 'I Like to Watch Television'

Parameters:

  • string[]|null $ignore [optional]

    An array of words not to capitalize or null. Default: null

  • string|null $word_define_chars [optional]

    An string of chars that will be used as whitespace separator === words.

  • string|null $language [optional]

    Language of the source string.

Return:

  • static

    Object with a titleized $str.


titleizeForHumans(string[] $ignore): static

Returns a trimmed string in proper title case: Also accepts an array, $ignore, allowing you to list words not to be capitalized.

EXAMPLE:

Adapted from John Gruber's script.

Parameters:

  • string[] $ignore

    An array of words not to capitalize.

Return:

  • static

    Object with a titleized $str


toAscii(string $language, bool $removeUnsupported): static

Returns an ASCII version of the string. A set of non-ASCII characters are replaced with their closest ASCII counterparts, and the rest are removed by default. The language or locale of the source string can be supplied for language-specific transliteration in any of the following formats: en, en_GB, or en-GB. For example, passing "de" results in "盲枚眉" mapping to "aeoeue" rather than "aou" as in other languages.

EXAMPLE: s('f貌么b脿艡')->toAscii(); // 'foobar'

Parameters:

  • string $language [optional]

    Language of the source string.

  • bool $removeUnsupported [optional]

    Whether or not to remove the unsupported characters.

Return:

  • static

    Object whose $str contains only ASCII characters.


toBoolean(): bool

Returns a boolean representation of the given logical string value.

For example, 'true', '1', 'on' and 'yes' will return true. 'false', '0', 'off', and 'no' will return false. In all instances, case is ignored. For other numeric strings, their sign will determine the return value. In addition, blank strings consisting of only whitespace will return false. For all other strings, the return value is a result of a boolean cast.

EXAMPLE: s('OFF')->toBoolean(); // false

Parameters: nothing

Return:

  • bool

    A boolean value for the string.


toLowerCase(bool $tryToKeepStringLength, string|null $lang): static

Converts all characters in the string to lowercase.

EXAMPLE: s('F脪脭B脌艠')->toLowerCase(); // 'f貌么b脿艡'

Parameters:

  • bool $tryToKeepStringLength [optional]

    true === try to keep the string length: e.g. 岷 -> 脽

  • string|null $lang [optional]

    Set the language for special cases: az, el, lt, tr

Return:

  • static

    Object with all characters of $str being lowercase.


toSpaces(int $tabLength): static

Converts each tab in the string to some number of spaces, as defined by $tabLength. By default, each tab is converted to 4 consecutive spaces.

EXAMPLE: s(' String speech = "Hi"')->toSpaces(); // ' String speech = "Hi"'

Parameters:

  • int $tabLength [optional]

    Number of spaces to replace each tab with. Default: 4

Return:

  • static

    Object whose $str has had tabs switched to spaces.


toString(): string

Return Stringy object as string, but you can also use (string) for automatically casting the object into a string.

EXAMPLE: s('f貌么b脿艡')->toString(); // 'f貌么b脿艡'

Parameters: nothing

Return:

  • string

toTabs(int $tabLength): static

Converts each occurrence of some consecutive number of spaces, as defined by $tabLength, to a tab. By default, each 4 consecutive spaces are converted to a tab.

EXAMPLE: s(' f貌么 b脿艡')->toTabs(); // ' f貌么 b脿艡'

Parameters:

  • int $tabLength [optional]

    Number of spaces to replace with a tab. Default: 4

Return:

  • static

    Object whose $str has had spaces switched to tabs.


toTitleCase(): static

Converts the first character of each word in the string to uppercase and all other chars to lowercase.

EXAMPLE: s('f貌么 b脿艡')->toTitleCase(); // 'F貌么 B脿艡'

Parameters: nothing

Return:

  • static

    Object with all characters of $str being title-cased.


toTransliterate(bool $strict, string $unknown): static

Returns an ASCII version of the string. A set of non-ASCII characters are replaced with their closest ASCII counterparts, and the rest are removed unless instructed otherwise.

EXAMPLE:

Parameters:

  • bool $strict [optional]

    Use "transliterator_transliterate()" from PHP-Intl | WARNING: bad performance | Default: false

  • string $unknown [optional]

    Character use if character unknown. (default is ?)

Return:

  • static

    Object whose $str contains only ASCII characters.


toUpperCase(bool $tryToKeepStringLength, string|null $lang): static

Converts all characters in the string to uppercase.

EXAMPLE: s('f貌么b脿艡')->toUpperCase(); // 'F脪脭B脌艠'

Parameters:

  • bool $tryToKeepStringLength [optional]

    true === try to keep the string length: e.g. 岷 -> 脽

  • string|null $lang [optional]

    Set the language for special cases: az, el, lt, tr

Return:

  • static

    Object with all characters of $str being uppercase.


trim(string $chars): static

Returns a string with whitespace removed from the start and end of the string. Supports the removal of unicode whitespace. Accepts an optional string of characters to strip instead of the defaults.

EXAMPLE: s(' f貌么b脿艡 ')->trim(); // 'f貌么b脿艡'

Parameters:

  • string $chars [optional]

    String of characters to strip. Default: null

Return:

  • static

    Object with a trimmed $str.


trimLeft(string $chars): static

Returns a string with whitespace removed from the start of the string.

Supports the removal of unicode whitespace. Accepts an optional string of characters to strip instead of the defaults.

EXAMPLE: s(' f貌么b脿艡 ')->trimLeft(); // 'f貌么b脿艡 '

Parameters:

  • string $chars [optional]

    Optional string of characters to strip. Default: null

Return:

  • static

    Object with a trimmed $str.


trimRight(string $chars): static

Returns a string with whitespace removed from the end of the string.

Supports the removal of unicode whitespace. Accepts an optional string of characters to strip instead of the defaults.

EXAMPLE: s(' f貌么b脿艡 ')->trimRight(); // ' f貌么b脿艡'

Parameters:

  • string $chars [optional]

    Optional string of characters to strip. Default: null

Return:

  • static

    Object with a trimmed $str.


truncate(int $length, string $substring): static

Truncates the string to a given length. If $substring is provided, and truncating occurs, the string is further truncated so that the substring may be appended without exceeding the desired length.

EXAMPLE: s('What are your plans today?')->truncate(19, '...'); // 'What are your pl...'

Parameters:

  • int $length

    Desired length of the truncated string.

  • string $substring [optional]

    The substring to append if it can fit. Default: ''

Return:

  • static

    Object with the resulting $str after truncating.


underscored(): static

Returns a lowercase and trimmed string separated by underscores.

Underscores are inserted before uppercase characters (with the exception of the first character of the string), and in place of spaces as well as dashes.

EXAMPLE: s('TestUCase')->underscored(); // 'test_u_case'

Parameters: nothing

Return:

  • static

    Object with an underscored $str.


upperCamelize(): static

Returns an UpperCamelCase version of the supplied string. It trims surrounding spaces, capitalizes letters following digits, spaces, dashes and underscores, and removes spaces, dashes, underscores.

EXAMPLE: s('Upper Camel-Case')->upperCamelize(); // 'UpperCamelCase'

Parameters: nothing

Return:

  • static

    Object with $str in UpperCamelCase.


upperCaseFirst(): static

Converts the first character of the supplied string to upper case.

EXAMPLE: s('蟽 foo')->upperCaseFirst(); // '危 foo'

Parameters: nothing

Return:

  • static

    Object with the first character of $str being upper case.


urlDecode(): static

Simple url-decoding.

e.g: 'test+test' => 'test test'

EXAMPLE:

Parameters: nothing

Return:

  • static

urlDecodeMulti(): static

Multi url-decoding + decode HTML entity + fix urlencoded-win1252-chars.

e.g: 'test+test' => 'test test' 'D眉sseldorf' => 'D眉sseldorf' 'D%FCsseldorf' => 'D眉sseldorf' 'D眉sseldorf' => 'D眉sseldorf' 'D%26%23xFC%3Bsseldorf' => 'D眉sseldorf' 'D脙录sseldorf' => 'D眉sseldorf' 'D%C3%BCsseldorf' => 'D眉sseldorf' 'D%C3%83%C2%BCsseldorf' => 'D眉sseldorf' 'D%25C3%2583%25C2%25BCsseldorf' => 'D眉sseldorf'

EXAMPLE:

Parameters: nothing

Return:

  • static

urlDecodeRaw(): static

Simple url-decoding.

e.g: 'test+test' => 'test+test

EXAMPLE:

Parameters: nothing

Return:

  • static

urlDecodeRawMulti(): static

Multi url-decoding + decode HTML entity + fix urlencoded-win1252-chars.

e.g: 'test+test' => 'test+test' 'D眉sseldorf' => 'D眉sseldorf' 'D%FCsseldorf' => 'D眉sseldorf' 'D眉sseldorf' => 'D眉sseldorf' 'D%26%23xFC%3Bsseldorf' => 'D眉sseldorf' 'D脙录sseldorf' => 'D眉sseldorf' 'D%C3%BCsseldorf' => 'D眉sseldorf' 'D%C3%83%C2%BCsseldorf' => 'D眉sseldorf' 'D%25C3%2583%25C2%25BCsseldorf' => 'D眉sseldorf'

EXAMPLE:

Parameters: nothing

Return:

  • static

urlEncode(): static

Simple url-encoding.

e.g: 'test test' => 'test+test'

EXAMPLE:

Parameters: nothing

Return:

  • static

urlEncodeRaw(): static

Simple url-encoding.

e.g: 'test test' => 'test%20test'

EXAMPLE:

Parameters: nothing

Return:

  • static

urlify(string $separator, string $language, string[] $replacements, bool $strToLower): static

Converts the string into an URL slug. This includes replacing non-ASCII characters with their closest ASCII equivalents, removing remaining non-ASCII and non-alphanumeric characters, and replacing whitespace with $separator. The separator defaults to a single dash, and the string is also converted to lowercase.

EXAMPLE: s('Using strings like f貌么 b脿艡 - 1$')->urlify(); // 'using-strings-like-foo-bar-1-dollar'

Parameters:

  • string $separator [optional]

    The string used to replace whitespace. Default: '-'

  • string $language [optional]

    The language for the url. Default: 'en'

  • array $replacements [optional]

    A map of replaceable strings.

  • bool $strToLower [optional]

    string to lower. Default: true

Return:

  • static

    Object whose $str has been converted to an URL slug.


utf8ify(): static

Converts the string into an valid UTF-8 string.

EXAMPLE: s('D脙录sseldorf')->utf8ify(); // 'D眉sseldorf'

Parameters: nothing

Return:

  • static

words(string $char_list, bool $remove_empty_values, int|null $remove_short_values): static[]

Convert a string into an array of words.

EXAMPLE:

Parameters:

  • string $char_list [optional]

    Additional chars for the definition of "words".

  • bool $remove_empty_values [optional]

    Remove empty values.

  • int|null $remove_short_values [optional]

    The min. string length or null to disable

Return:

  • static[]

wordsCollection(string $char_list, bool $remove_empty_values, int|null $remove_short_values): CollectionStringy|static[]

Convert a string into an collection of words.

EXAMPLE: S::create('涓枃绌虹櫧 o枚盲眉#s')->wordsCollection('#', true)->toStrings(); // ['涓枃绌虹櫧', 'o枚盲眉#s']

Parameters:

  • string $char_list [optional]

    Additional chars for the definition of "words".

  • bool $remove_empty_values [optional]

    Remove empty values.

  • int|null $remove_short_values [optional]

    The min. string length or null to disable

Return:

  • \CollectionStringy|static[]

    An collection of Stringy objects.


wrap(string $substring): static

Surrounds $str with the given substring.

EXAMPLE:

Parameters:

  • string $substring

    The substring to add to both sides.

Return:

  • static

    Object whose $str had the substring both prepended and appended.


Tests

From the project directory, tests can be ran using phpunit

Support

For support and donations please visit Github | Issues | PayPal | Patreon.

For status updates and release announcements please visit Releases | Twitter | Patreon.

For professional support please contact me.

Thanks

  • Thanks to GitHub (Microsoft) for hosting the code and a good infrastructure including Issues-Managment, etc.
  • Thanks to IntelliJ as they make the best IDEs for PHP and they gave me an open source license for PhpStorm!
  • Thanks to Travis CI for being the most awesome, easiest continous integration tool out there!
  • Thanks to StyleCI for the simple but powerfull code style check.
  • Thanks to PHPStan && Psalm for relly great Static analysis tools and for discover bugs in the code!

License

Released under the MIT License - see LICENSE.txt for details.

Comments
  • Fatal Error when installing Craft CMS

    Fatal Error when installing Craft CMS

    What is this feature about (expected vs actual behaviour)?

    Running composer install Expected: CMS installs Actual: Fatal error in voku/portable-utf8/src/voku/helper/Bootup.php on line 27 every time

    How can I reproduce it?

    This only seems to have happened to me on one out of two servers, so I can't say for sure. But the method I used was to pull a Craft CMS installation from a git repo, then run composer install to install dependencies. The version of Stringy this is running is 5.1.1

    Does it take minutes, hours or days to fix?

    At least hours, because I haven't fixed it yet

    Any additional information?

    I've been migrating a Craft CMS site to a development server but when I run composer install to install dependencies I get this on the 'Generating optimized autoload files' step:

    Generating optimized autoload files
    Deprecation Notice: Class yii\queue\amqp_interop\Command located in ./vendor/yiisoft/yii2-queue/src/drivers/amqp_interop/Command.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\amqp_interop\Queue located in ./vendor/yiisoft/yii2-queue/src/drivers/amqp_interop/Queue.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\db\Command located in ./vendor/yiisoft/yii2-queue/src/drivers/db/Command.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\db\InfoAction located in ./vendor/yiisoft/yii2-queue/src/drivers/db/InfoAction.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\db\Queue located in ./vendor/yiisoft/yii2-queue/src/drivers/db/Queue.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\db\migrations\M161119140200Queue located in ./vendor/yiisoft/yii2-queue/src/drivers/db/migrations/M161119140200Queue.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\db\migrations\M170601155600Priority located in ./vendor/yiisoft/yii2-queue/src/drivers/db/migrations/M170601155600Priority.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\db\migrations\M170509001400Retry located in ./vendor/yiisoft/yii2-queue/src/drivers/db/migrations/M170509001400Retry.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\db\migrations\M170307170300Later located in ./vendor/yiisoft/yii2-queue/src/drivers/db/migrations/M170307170300Later.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\sync\Queue located in ./vendor/yiisoft/yii2-queue/src/drivers/sync/Queue.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\sqs\Command located in ./vendor/yiisoft/yii2-queue/src/drivers/sqs/Command.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\sqs\Queue located in ./vendor/yiisoft/yii2-queue/src/drivers/sqs/Queue.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\file\Command located in ./vendor/yiisoft/yii2-queue/src/drivers/file/Command.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\file\InfoAction located in ./vendor/yiisoft/yii2-queue/src/drivers/file/InfoAction.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\file\Queue located in ./vendor/yiisoft/yii2-queue/src/drivers/file/Queue.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\amqp\Command located in ./vendor/yiisoft/yii2-queue/src/drivers/amqp/Command.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\amqp\Queue located in ./vendor/yiisoft/yii2-queue/src/drivers/amqp/Queue.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\redis\Command located in ./vendor/yiisoft/yii2-queue/src/drivers/redis/Command.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\redis\InfoAction located in ./vendor/yiisoft/yii2-queue/src/drivers/redis/InfoAction.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\redis\Queue located in ./vendor/yiisoft/yii2-queue/src/drivers/redis/Queue.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\gearman\Command located in ./vendor/yiisoft/yii2-queue/src/drivers/gearman/Command.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\gearman\Queue located in ./vendor/yiisoft/yii2-queue/src/drivers/gearman/Queue.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\beanstalk\Command located in ./vendor/yiisoft/yii2-queue/src/drivers/beanstalk/Command.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\beanstalk\InfoAction located in ./vendor/yiisoft/yii2-queue/src/drivers/beanstalk/InfoAction.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class yii\queue\beanstalk\Queue located in ./vendor/yiisoft/yii2-queue/src/drivers/beanstalk/Queue.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class dolphiq\sitemap\assetbundles\Sitemap\SitemapAsset located in ./vendor/dolphiq/sitemap/src/assetbundles/sitemap/SitemapAsset.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class adigital\cookieconsentbanner\assetbundles\CookieConsentBanner\CookieConsentBannerAsset located in ./vendor/adigital/cookie-consent-banner/src/assetbundles/cookieconsentbanner/CookieConsentBannerAsset.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class Solspace\Freeform\Library\Codepack\Exceptions\CodepackException located in ./vendor/solspace/craft-freeform/src/Library/Codepack/Exceptions/CodePackException.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class Solspace\ExpressForms\utilities\CodePack\Exceptions\CodepackException located in ./vendor/solspace/craft-express-forms/src/utilities/CodePack/Exceptions/CodePackException.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class Solspace\ExpressForms\Services\Widgets located in ./vendor/solspace/craft-express-forms/src/services/Widgets.php does not comply with psr-4 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    Deprecation Notice: Class HTMLPurifier_Language_en_x_test located in ./vendor/ezyang/htmlpurifier/library/HTMLPurifier/Language/classes/en-x-test.php does not comply with psr-0 autoloading standard. It will not autoload anymore in Composer v1.11+. in phar:///usr/lib/plesk-9.0/composer.phar/src/Composer/Autoload/ClassMapGenerator.php:186
    PHP Warning:  Unsupported declare 'strict_types' in /var/www/vhosts/example.co.uk/dev.example.co.uk/vendor/voku/portable-utf8/src/voku/helper/Bootup.php on line 3
    
    Warning: Unsupported declare 'strict_types' in /var/www/vhosts/example.co.uk/dev.example.co.uk/vendor/voku/portable-utf8/src/voku/helper/Bootup.php on line 3
    PHP Fatal error:  Default value for parameters with a class type hint can only be NULL in /var/www/vhosts/example/dev.example.co.uk/vendor/voku/portable-utf8/src/voku/helper/Bootup.php on line 27
    
    Fatal error: Default value for parameters with a class type hint can only be NULL in /var/www/vhosts/example.co.uk/dev.example.co.uk/vendor/voku/portable-utf8/src/voku/helper/Bootup.php on line 27
    

    The important line is ovviously the fatal error at the end, which seems to be to do with voku Stringy.

    What I've tried Bumping PHP CLI version 5.5.9 -> 7.3.5 Dropping PHP CLI version 7.3.5 -> 7.2.18 Dropping website PHP version 7.3.5 -> 7.2.18 Purging all references to danielstjules repo from composer.lock (no longer appears in either .lock or .json composer files) The one thing I tried which seemed to work is running composer install --no-plugins --no-scripts (the command they recommend you run when running as root). However, this didn't produce the security key for the installation, and then running ./craft setup/security-key produces the same error:

    PHP Warning:  Unsupported declare 'strict_types' in /var/www/vhosts/tsadvertising.co.uk/dev.jurassicfibre.tsadvertising.co.uk/vendor/voku/portable-utf8/src/voku/helper/Bootup.php on line 3
    PHP Fatal error:  Default value for parameters with a class type hint can only be NULL in /var/www/vhosts/tsadvertising.co.uk/dev.jurassicfibre.tsadvertising.co.uk/vendor/voku/portable-utf8/src/voku/helper/Bootup.php on line 27
    

    Help please!

    wait for response 
    opened by jcush 6
  • More verbosity

    More verbosity

    What is this feature about (expected vs actual behaviour)?

    The tool is great, but it needs more verbosity to make its use more fluid.

    How can I reproduce it?

    Examples of methods to implement: isEmpty, isNotEmpty, equals, chunk, format, etc.

    Does it take minutes, hours or days to fix?

    days

    Any additional information?

    Method list:

    鈥 after 鈥 base64 鈥 base64Decode 鈥 base64Encode 鈥 bcrypt 鈥 before 鈥 chunk 鈥 count 鈥 crc32 鈥 crypt 鈥 decrypt 鈥 encoding 鈥 encrypt 鈥 equals 鈥 explode 鈥 first 鈥 format 鈥 from 鈥 hex 鈥 hexEncode 鈥 hexDecode 鈥 insensitiveMatch 鈥 in 鈥 isEmpty 鈥 isNotEmpty 鈥 isNumeric 鈥 isPrintable 鈥 isPunctuation 鈥 isWhitespace 鈥 join 鈥 kebabCase 鈥 matches 鈥 md5 鈥 nth 鈥 pascalCase 鈥 sha1 鈥 sha256 鈥 similarity 鈥 strip 鈥 studlyCase 鈥 substring 鈥 to 鈥 uppercase 鈥 url 鈥 words 鈥 wrap 鈥 wrapHard 鈥 wrapSoft

    opened by dimacros 5
  • About regex Extraction string

    About regex Extraction string

    What is this feature about (expected vs actual behaviour)?

    Hello, is there a regex string extraction function? I don't seem to have seen it. If anyone sees it, please give me a link. Thank you

    opened by shenmadouyaowen 4
  • How to pass an array of replacements to make? -- Should I use strtr()?

    How to pass an array of replacements to make? -- Should I use strtr()?

    What's the recommended way to pass an array of replacements to make?

    Should I just use PHP's strtr() or Portable UTF8's strtr() directly?

    Basically, I'm wanting an enhanced version of tidy() to normalize searching "this - plus" to find text like "Th茂s & That -- plus more!".

    Example replacements to make (but not quite my code, since tidy() helps a lot already): https://github.com/msaari/relevanssi/blob/4.7.2/lib/common.php#L750

    Code so far:

    $result = s( $orig_string )
    	->utf8ify() // do I need this?
    	->tidy()
    	->stripWhitespace()
    	->replaceAll(
    ...
    	);
    

    I see replaceAll() can take an array, but I'm unsure if it's advisable over strtr's logic of starting with longest string. It looks like replaceAll uses the replacement array in order, and I don't think it takes both the subject and replacement (array key => value).

    Maybe the documentation for replaceAll() could be enhanced or a new method added?

    Thanks for any tips!

    opened by cliffordp 4
  • Move defuse/php-encryption to

    Move defuse/php-encryption to "require-dev" because unused other than Tests

    What is this feature about (expected vs actual behaviour)?

    Can "defuse/php-encryption" be moved to "require-dev"?

    How can I reproduce it?

    • use Defuse\Crypto\Crypto; in https://github.com/voku/Stringy/blob/6.4.0/src/Stringy.php#L7 was added with the original commit that added the package itself: https://github.com/voku/Stringy/commit/10ad6d33e05437446a890b408d362f5392972949
    • But it's not used/called within this file, only within Tests files.
    • So should it be moved to "require-dev", for the sake of composer install --no-dev?

    Does it take minutes, hours or days to fix?

    Minutes?

    Any additional information?

    N/A

    feature_request 
    opened by cliffordp 3
  • Method to pass user callback function?

    Method to pass user callback function?

    What is this feature about (expected vs actual behaviour)?

    How can I reproduce it?

    Does it take minutes, hours or days to fix?

    Any additional information?

    Hello, there is exists method to pass user function, that modify string? For example, in Laravel i have str_plural and class_basename so i could be use it in chain

    s($myClass)
        ->callUserFunc(fn($myClass) => class_basename($myClass))
        ->toLowerCase()
        ->callUserFunc(fn($myClass) => str_plural($myClass));
    

    or

    s($myClass)
        ->callUserFunc('class_basename')
        ->toLowerCase()
        ->callUserFunc('str_plural');
    
    opened by fey 3
  • Proper Vendor Prefixed Namespacing

    Proper Vendor Prefixed Namespacing

    I'm running into issues Ambiguous class resolution warnings from composer since some require your fork and others the older unmaintained version. I could ask there to vendor prefix the lib, but well, it's dead. I do understand the backward compat issues with this though...

    wait for response 
    opened by renzo-s 3
  • Update phpunit/phpunit requirement from ~6.0 || ~7.0 to ^8.0.1

    Update phpunit/phpunit requirement from ~6.0 || ~7.0 to ^8.0.1

    Updates the requirements on phpunit/phpunit to permit the latest version.

    Changelog

    Sourced from phpunit/phpunit's changelog.

    8.0.1 - 2019-02-03

    Fixed

    • Fixed #3509: Process Isolation does not work with phpunit.phar

    [8.0.0] - 2019-02-01

    Changed

    • Implemented #3060: Cleanup PHPUnit\Framework\Constraint\Constraint
    • Implemented #3133: Enable dependency resolution by default
    • Implemented #3236: Define which parts of PHPUnit are covered by the backward compatibility promise
    • Implemented #3244: Enable result cache by default
    • Implemented #3288: The void_return fixer of php-cs-fixer is now in effect
    • Implemented #3439: Improve colorization of TestDox output
    • Implemented #3444: Consider data provider that provides data with duplicate keys to be invalid
    • Implemented #3467: Code location hints for [**requires**](https://github.com/requires) annotations as well as --SKIPIF--, --EXPECT--, --EXPECTF--, --EXPECTREGEX--, and --{SECTION}_EXTERNAL-- sections of PHPT tests
    • Implemented #3481: Improved --help output

    Deprecated

    • Implemented #3332: Deprecate annotation(s) for expecting exceptions
    • Implemented #3338: Deprecate assertions (and helper methods) that operate on (non-public) attributes
    • Implemented #3341: Deprecate optional parameters of assertEquals() and assertNotEquals()
    • Implemented #3369: Deprecate assertInternalType() and assertNotInternalType()
    • Implemented #3388: Deprecate the TestListener interface
    • Implemented #3425: Deprecate optional parameters of assertContains() and assertNotContains() as well as using these methods with string haystacks
    • Implemented #3494: Deprecate assertArraySubset()

    Removed

    • Implemented #2762: Drop support for PHP 7.1
    • Implemented #3123: Remove PHPUnit_Framework_MockObject_MockObject

    [8.0.0]: https://github.com/sebastianbergmann/phpunit/compare/7.5...8.0.0

    Commits

    Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.


    Note: This repo was added to Dependabot recently, so you'll receive a maximum of 5 PRs for your first few update runs. Once an update run creates fewer than 5 PRs we'll remove that limit.

    You can always request more updates by clicking Bump now in your Dependabot dashboard.

    Dependabot commands and options

    You can trigger Dependabot actions by commenting on this PR:

    • @dependabot rebase will rebase this PR
    • @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
    • @dependabot merge will merge this PR after your CI passes on it
    • @dependabot cancel merge will cancel a previously requested merge
    • @dependabot reopen will reopen this PR if it is closed
    • @dependabot ignore this [patch|minor|major] version will close this PR and stop Dependabot creating any more for this minor/major version (unless you reopen the PR or upgrade to it yourself)
    • @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
    • @dependabot use these labels will set the current labels as the default for future PRs for this repo and language
    • @dependabot use these reviewers will set the current reviewers as the default for future PRs for this repo and language
    • @dependabot use these assignees will set the current assignees as the default for future PRs for this repo and language
    • @dependabot use this milestone will set the current milestone as the default for future PRs for this repo and language
    • @dependabot badge me will comment on this PR with code to add a "Dependabot enabled" badge to your readme

    Additionally, you can set the following in your Dependabot dashboard:

    • Update frequency (including time of day and day of week)
    • Automerge options (never/patch/minor, and dev/runtime dependencies)
    • Pull request limits (per update run and/or open at any time)
    • Out-of-range updates (receive only lockfile updates, if desired)
    • Security updates (receive only security updates, if desired)

    Finally, you can contact us by mentioning @dependabot.


    This change is鈥Reviewable

    dependencies 
    opened by dependabot-preview[bot] 3
  • Update voku/urlify requirement from ~4.1 to ~5.0

    Update voku/urlify requirement from ~4.1 to ~5.0

    Updates the requirements on voku/urlify to permit the latest version.

    Changelog

    Sourced from voku/urlify's changelog.

    v5.0.0 (2019-09-03)

    • use "en" as default language
    • use "Portable ASCII" for much better performance

    v4.1.1 (2019-09-03)

    • optimize regex
    • use "preg_quote" | thanks @鈥媍bj4074
    • fix duplicate code

    v4.1.0 (2019-01-12)

    • fix "maxLength" usage
    • use phpcs fixer
    • add support for "Kazakh" and "Slovak"

    v4.0.0 (2017-12-23)

    • update "Portable UTF8" from v4 -> v5

      -> this is a breaking change without API-changes - but the requirement from "Portable UTF8" has been changed (it no longer requires all polyfills from Symfony)

    v3.0.0 (2017-12-01)

    • drop support for PHP < 7.0
    • use "strict_types"

    v2.3.1 (2017-06-25)

    • fix logic of "add_array_to_separator()"
    • "remove apostrophes which are not used as quotes around a string"

    v2.3.0 (2017-05-22)

    • use "voku/stop-words" for the URLify::$remove_list
    • fix "vietnamese"-language-code ('vn' => 'vi')

    v2.2.0

    • add more languages && update docs
    • add more tests
    ... (truncated)
    Commits
    • b0e8524 [+]: use "Portable ASCII" for much better performance
    • 4961b57 [+]: small fixes + code optimizations
    • 41798b1 Merge branch 'master' of https://github.com/voku/urlify
    • fca0ecc Update README.md
    • See full diff in compare view

    Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.


    Dependabot commands and options

    You can trigger Dependabot actions by commenting on this PR:

    • @dependabot rebase will rebase this PR
    • @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
    • @dependabot merge will merge this PR after your CI passes on it
    • @dependabot squash and merge will squash and merge this PR after your CI passes on it
    • @dependabot cancel merge will cancel a previously requested merge and block automerging
    • @dependabot reopen will reopen this PR if it is closed
    • @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
    • @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
    • @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
    • @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
    • @dependabot use these labels will set the current labels as the default for future PRs for this repo and language
    • @dependabot use these reviewers will set the current reviewers as the default for future PRs for this repo and language
    • @dependabot use these assignees will set the current assignees as the default for future PRs for this repo and language
    • @dependabot use this milestone will set the current milestone as the default for future PRs for this repo and language
    • @dependabot badge me will comment on this PR with code to add a "Dependabot enabled" badge to your readme

    Additionally, you can set the following in your Dependabot dashboard:

    • Update frequency (including time of day and day of week)
    • Pull request limits (per update run and/or open at any time)
    • Automerge options (never/patch/minor, and dev/runtime dependencies)
    • Out-of-range updates (receive only lockfile updates, if desired)
    • Security updates (receive only security updates, if desired)

    Finally, you can contact us by mentioning @dependabot.


    This change is鈥Reviewable

    dependencies 
    opened by dependabot-preview[bot] 2
  • Consider extracting the ascii stuff to a separate package

    Consider extracting the ascii stuff to a separate package

    It would be wonderful if you could extract the toAscii to a separate packagae, and then depend on it like you do for XSS. I'd like to propose that Laravel 7 uses this package's toAscii, but this package currently has too many other dependencies, so I'd love to be able to only pull in toAscii.

    opened by GrahamCampbell 2
  • Slugify function doesnt replace /

    Slugify function doesnt replace /

    Was using the original danielstjules repo but saw they lack updated support. So plan to use this instead. My question/issue is, when using the slugify function it doesnt replace / with a dash like I want it to. So Im having to install a whole new repo, cocur/slugify. I rather use Stringy for all my needs. So is there a way to add support for this? Example:

    $text = 'Texttile/Machine Learning';
    echo s::create($text)->slugify();
    //Comes out as texttilemachine-learning, want it to come out as texttile-machine-learning
    

    Can you add this additional functionality to the slugify function? Or is there something I can do on my end?

    opened by brightboxtech 2
  • Upgrade to GitHub-native Dependabot

    Upgrade to GitHub-native Dependabot

    Dependabot Preview will be shut down on August 3rd, 2021. In order to keep getting Dependabot updates, please merge this PR and migrate to GitHub-native Dependabot before then.

    Dependabot has been fully integrated into GitHub, so you no longer have to install and manage a separate app. This pull request migrates your configuration from Dependabot.com to a config file, using the new syntax. When merged, we'll swap out dependabot-preview (me) for a new dependabot app, and you'll be all set!

    With this change, you'll now use the Dependabot page in GitHub, rather than the Dependabot dashboard, to monitor your version updates, and you'll configure Dependabot through the new config file rather than a UI.

    If you've got any questions or feedback for us, please let us know by creating an issue in the dependabot/dependabot-core repository.

    Learn more about migrating to GitHub-native Dependabot

    Please note that regular @dependabot commands do not work on this pull request.


    This change is鈥Reviewable

    dependencies 
    opened by dependabot-preview[bot] 4
  • Configure WhiteSource Bolt for GitHub

    Configure WhiteSource Bolt for GitHub

    Welcome to WhiteSource Bolt for GitHub! This is an onboarding PR to help you understand and configure settings before WhiteSource starts scanning your repository for security vulnerabilities.

    :vertical_traffic_light: WhiteSource Bolt for GitHub will start scanning your repository only once you merge this Pull Request. To disable WhiteSource Bolt for GitHub, simply close this Pull Request.


    What to Expect

    This PR contains a '.whitesource' configuration file which can be customized to your needs. If no changes were applied to this file, WhiteSource Bolt for GitHub will use the default configuration.

    Before merging this PR, Make sure the Issues tab is enabled. Once you merge this PR, WhiteSource Bolt for GitHub will scan your repository and create a GitHub Issue for every vulnerability detected in your repository.

    If you do not want a GitHub Issue to be created for each detected vulnerability, you can edit the '.whitesource' file and set the 'minSeverityLevel' parameter to 'NONE'.


    :question: Got questions? Check out WhiteSource Bolt for GitHub docs. If you need any further assistance then you can also request help here.


    This change is鈥Reviewable

    opened by mend-bolt-for-github[bot] 2
Owner
Lars Moelleken
Webdeveloper & Sysadmin | egrep '#php|#js|#html|#css|#sass'
Lars Moelleken
PHP Japanese string helper functions for converting Japanese strings from full-width to half-width and reverse. Laravel Rule for validation Japanese string only full-width or only half-width.

Japanese String Helpers PHP Japanese string helper functions for converting Japanese strings from full-width to half-width and reverse. Laravel Rule f

Deha 54 Mar 22, 2022
MOP is a php query handling and manipulation library providing easy and reliable way to manipulate query and get result in a fastest way

Mysql Optimizer mysql optimizer also known as MOP is a php query handling and manipulation library providing easy and reliable way to manipulate query

null 2 Nov 20, 2021
Library allows to detect emoji, remove emoji, encode emoji and decode emoji in string.

It allows to detect emoji, remove emoji, encode emoji and decode emoji in string. Installation composer require anisimov/emoji How to use Encode and

Aleksey Anisimov 9 Nov 8, 2022
The Hoa\String library (deprecated by Hoa\Ustring).

Hoa is a modular, extensible and structured set of PHP libraries. Moreover, Hoa aims at being a bridge between industrial and research worlds. Hoa\Str

Hoa 6 Mar 27, 2018
Michael Pratt 307 Dec 23, 2022
php String Objects Chains like length,forEach,filter,replace,repalcAll much More.... Module

php String Objects Chains like length,forEach,filter,replace,repalcAll much More.... Module

im__koli 1 Mar 29, 2022
StringBuffer is a PHP class providing operations for efficient string buffering

StringBuffer is a PHP class providing operations for efficient string buffering

null 1 May 26, 2022
Lightning Fast, Minimalist PHP User Agent String Parser.

Lightning Fast, Minimalist PHP User Agent String Parser.

Jesse Donat 523 Dec 21, 2022
Ip2region is a offline IP location library with accuracy rate of 99.9% and 0.0x millseconds searching performance. DB file is ONLY a few megabytes with all IP address stored. binding for Java,PHP,C,Python,Nodejs,Golang,C#,lua. Binary,B-tree,Memory searching algorithm

Ip2region鏄粈涔堬紵 ip2region - 鍑嗙‘鐜99.9%鐨勭绾縄P鍦板潃瀹氫綅搴擄紝0.0x姣绾ф煡璇紝ip2region.db鏁版嵁搴撳彧鏈夋暟MB锛屾彁渚涗簡java,php,c,python,nodejs,golang,c#绛夋煡璇㈢粦瀹氬拰Binary,B鏍,鍐呭瓨涓夌鏌ヨ绠楁硶銆 Ip2region鐗规

Lion 12.6k Dec 30, 2022
A high-performance event loop library for PHP

?? A high-performance event loop library for PHP ??

workbunny 13 Dec 22, 2022
馃攳 Generates database queries based on one unique string

?? Laravel Search String Generates database queries based on one unique string using a simple and customizable syntax. Introduction Laravel Search Str

Loris Leiva 735 Dec 30, 2022
Miniset allows you to create compact sets of fields that either combine into a string of classes, or return a simple array of values

Miniset allows you to create compact sets of fields that either combine into a string of classes, or return a simple array of values. Miniset

Jack Sleight 5 Jun 13, 2022
The Assure Alliance support website. This website is based on Questions2Answers and is a forum for support using Biblical Tools

The Assure Alliance support website. This website is based on Questions2Answers and is a forum for support using Biblical Tools

United Bible Societies Institute for Computer Assisted Publishing 3 Jul 29, 2022
Optimizes class loading performance by generating a single PHP file containing all of the autoloaded files.

Class Preloader for PHP This tool is used to generate a single PHP script containing all of the classes required for a specific use case. Using a sing

Class Preloader 356 Nov 26, 2022
High performance view templating API for PHP applications using tags & expressions inspired by Java JSTL and C compiler

View Language API Table of contents: About Expressions Tags Configuration Compilation Installation Unit Tests Examples Reference Guide About This API

Lucian Gabriel Popescu 0 Jan 9, 2022
Track your farming and pool performance on the Binance Smart Chain

farm.army - Frontend Track your farming and pool performance on the Binance Smart Chain. Tech Stack PHP 8 + Symfony node.js + npm (Webpack, Symfony en

farm.army 28 Sep 3, 2022
Performance fixes for magento 2 core.

magento2-performance-fixes Performance fixes for magento 2 core. Problem and solution's concept - briefly PHP / Magento doesn't support concurency req

Mariusz 艁opuch 48 Dec 30, 2022
High-performance, low-memory-footprint, single-file embedded database for key/value storage

LDBA - a fast, pure PHP, key-value database. Information LDBA is a high-performance, low-memory-footprint, single-file embedded database for key/value

Simplito 12 Nov 13, 2022
Your performance & security consultant, an artisan command away.

Enlightn A Laravel Tool To Boost Your App's Performance & Security Introduction Think of Enlightn as your performance and security consultant. Enlight

Enlightn 726 Jan 1, 2023