Files
yii2/tests/framework/helpers/StringHelperTest.php
2023-10-23 11:26:59 -03:00

465 lines
22 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
/**
* @link https://www.yiiframework.com/
* @copyright Copyright (c) 2008 Yii Software LLC
* @license https://www.yiiframework.com/license/
*/
namespace yiiunit\framework\helpers;
use yii\helpers\StringHelper;
use yiiunit\TestCase;
/**
* StringHelperTest.
* @group helpers
*/
class StringHelperTest extends TestCase
{
protected function setUp(): void
{
parent::setUp();
// destroy application, Helper must work without Yii::$app
$this->destroyApplication();
}
public function testStrlen(): void
{
$this->assertEquals(4, StringHelper::byteLength('this'));
$this->assertEquals(6, StringHelper::byteLength('это'));
}
public function testSubstr(): void
{
$this->assertEquals('th', StringHelper::byteSubstr('this', 0, 2));
$this->assertEquals('э', StringHelper::byteSubstr('это', 0, 2));
$this->assertEquals('abcdef', StringHelper::byteSubstr('abcdef', 0));
$this->assertEquals('abcdef', StringHelper::byteSubstr('abcdef', 0, null));
$this->assertEquals('de', StringHelper::byteSubstr('abcdef', 3, 2));
$this->assertEquals('def', StringHelper::byteSubstr('abcdef', 3));
$this->assertEquals('def', StringHelper::byteSubstr('abcdef', 3, null));
$this->assertEquals('cd', StringHelper::byteSubstr('abcdef', -4, 2));
$this->assertEquals('cdef', StringHelper::byteSubstr('abcdef', -4));
$this->assertEquals('cdef', StringHelper::byteSubstr('abcdef', -4, null));
$this->assertEquals('', StringHelper::byteSubstr('abcdef', 4, 0));
$this->assertEquals('', StringHelper::byteSubstr('abcdef', -4, 0));
$this->assertEquals('это', StringHelper::byteSubstr('это', 0));
$this->assertEquals('это', StringHelper::byteSubstr('это', 0, null));
$this->assertEquals('т', StringHelper::byteSubstr('это', 2, 2));
$this->assertEquals('то', StringHelper::byteSubstr('это', 2));
$this->assertEquals('то', StringHelper::byteSubstr('это', 2, null));
$this->assertEquals('т', StringHelper::byteSubstr('это', -4, 2));
$this->assertEquals('то', StringHelper::byteSubstr('это', -4));
$this->assertEquals('то', StringHelper::byteSubstr('это', -4, null));
$this->assertEquals('', StringHelper::byteSubstr('это', 4, 0));
$this->assertEquals('', StringHelper::byteSubstr('это', -4, 0));
}
public function testBasename(): void
{
$this->assertEquals('', StringHelper::basename(''));
$this->assertEquals('file', StringHelper::basename('file'));
$this->assertEquals('file.test', StringHelper::basename('file.test', '.test2'));
$this->assertEquals('file', StringHelper::basename('file.test', '.test'));
$this->assertEquals('file', StringHelper::basename('/file'));
$this->assertEquals('file.test', StringHelper::basename('/file.test', '.test2'));
$this->assertEquals('file', StringHelper::basename('/file.test', '.test'));
$this->assertEquals('file', StringHelper::basename('/path/to/file'));
$this->assertEquals('file.test', StringHelper::basename('/path/to/file.test', '.test2'));
$this->assertEquals('file', StringHelper::basename('/path/to/file.test', '.test'));
$this->assertEquals('file', StringHelper::basename('\file'));
$this->assertEquals('file.test', StringHelper::basename('\file.test', '.test2'));
$this->assertEquals('file', StringHelper::basename('\file.test', '.test'));
$this->assertEquals('file', StringHelper::basename('C:\file'));
$this->assertEquals('file.test', StringHelper::basename('C:\file.test', '.test2'));
$this->assertEquals('file', StringHelper::basename('C:\file.test', '.test'));
$this->assertEquals('file', StringHelper::basename('C:\path\to\file'));
$this->assertEquals('file.test', StringHelper::basename('C:\path\to\file.test', '.test2'));
$this->assertEquals('file', StringHelper::basename('C:\path\to\file.test', '.test'));
// mixed paths
$this->assertEquals('file.test', StringHelper::basename('/path\to/file.test'));
$this->assertEquals('file.test', StringHelper::basename('/path/to\file.test'));
$this->assertEquals('file.test', StringHelper::basename('\path/to\file.test'));
// \ and / in suffix
$this->assertEquals('file', StringHelper::basename('/path/to/filete/st', 'te/st'));
$this->assertEquals('st', StringHelper::basename('/path/to/filete/st', 'te\st'));
$this->assertEquals('file', StringHelper::basename('/path/to/filete\st', 'te\st'));
$this->assertEquals('st', StringHelper::basename('/path/to/filete\st', 'te/st'));
// https://www.php.net/manual/en/function.basename.php#72254
$this->assertEquals('foo', StringHelper::basename('/bar/foo/'));
$this->assertEquals('foo', StringHelper::basename('\\bar\\foo\\'));
}
public function testTruncate(): void
{
$this->assertEquals('привет, я multibyte...', StringHelper::truncate('привет, я multibyte строка!', 20));
$this->assertEquals('Не трогаем строку', StringHelper::truncate('Не трогаем строку', 20));
$this->assertEquals('исполь!!!', StringHelper::truncate('используем восклицательные знаки', 6, '!!!'));
// With Html
$this->assertEquals('<span>This is a test</span>...', StringHelper::truncate('<span>This is a test sentance</span>', 14, '...', null, true));
$this->assertEquals('<span>This is a test</span>...', StringHelper::truncate('<span>This is a test </span>sentance', 14, '...', null, true));
$this->assertEquals('<span>This is a test </span><strong>for</strong>...', StringHelper::truncate('<span>This is a test </span><strong>for a sentance</strong>', 18, '...', null, true));
$this->assertEquals('<span>This is a test</span><strong> for</strong>...', StringHelper::truncate('<span>This is a test</span><strong> for a sentance</strong>', 18, '...', null, true));
$this->assertEquals('<span><img src="image.png" />This is a test</span>...', StringHelper::truncate('<span><img src="image.png" />This is a test sentance</span>', 14, '...', null, true));
$this->assertEquals('<span><img src="image.png" />This is a test</span>...', StringHelper::truncate('<span><img src="image.png" />This is a test </span>sentance', 14, '...', null, true));
$this->assertEquals('<span><img src="image.png" />This is a test </span><strong>for</strong>...', StringHelper::truncate('<span><img src="image.png" />This is a test </span><strong>for a sentance</strong>', 18, '...', null, true));
$this->assertEquals('<p>This is a test</p><ul><li>bullet1</li><li>b</li></ul>...', StringHelper::truncate('<p>This is a test</p><ul><li>bullet1</li><li>bullet2</li><li>bullet3</li><li>bullet4</li></ul>', 22, '...', null, true));
$this->assertEquals('<div><ul><li>bullet1</li><li><div>b</div></li></ul></div>...', StringHelper::truncate('<div><ul><li>bullet1</li><li><div>bullet2</div></li></ul><br></div>', 8, '...', null, true));
}
public function testTruncateWords(): void
{
$this->assertEquals('это тестовая multibyte строка', StringHelper::truncateWords('это тестовая multibyte строка', 5));
$this->assertEquals('это тестовая multibyte...', StringHelper::truncateWords('это тестовая multibyte строка', 3));
$this->assertEquals('это тестовая multibyte!!!', StringHelper::truncateWords('это тестовая multibyte строка', 3, '!!!'));
$this->assertEquals('это строка с неожиданными...', StringHelper::truncateWords('это строка с неожиданными пробелами', 4));
$this->assertEquals('lorem ipsum', StringHelper::truncateWords('lorem ipsum', 3, '...', true));
$this->assertEquals(' lorem ipsum', StringHelper::truncateWords(' lorem ipsum', 3, '...', true));
// With Html
$this->assertEquals('<span>This is a test</span>...', StringHelper::truncateWords('<span>This is a test sentance</span>', 4, '...', true));
$this->assertEquals('<span>This is a test </span><strong>for</strong>...', StringHelper::truncateWords('<span>This is a test </span><strong>for a sentance</strong>', 5, '...', true));
$this->assertEquals('<span>This is a test</span><strong> for</strong>...', StringHelper::truncateWords('<span>This is a test</span><strong> for a sentance</strong>', 5, '...', true));
$this->assertEquals('<p> раз два три четыре пять </p> <p> шесть</p>...', StringHelper::truncateWords('<p> раз два три четыре пять </p> <p> шесть семь восемь девять десять</p>', 6, '...', true));
$this->assertEquals('<span><img src="image.png" />This is a test</span>...', StringHelper::truncateWords('<span><img src="image.png" />This is a test sentance</span>', 4, '...', true));
$this->assertEquals('<span><img src="image.png" />This is a test </span><strong>for</strong>...', StringHelper::truncateWords('<span><img src="image.png" />This is a test </span><strong>for a sentance</strong>', 5, '...', true));
$this->assertEquals('<span><img src="image.png" />This is a test</span><strong> for</strong>...', StringHelper::truncateWords('<span><img src="image.png" />This is a test</span><strong> for a sentance</strong>', 5, '...', true));
}
/**
* @dataProvider providerStartsWith
* @param string|null $with
*/
public function testStartsWith(bool $result, string $string, ?string $with): void
{
// case sensitive version check
$this->assertSame($result, StringHelper::startsWith($string, $with));
// case insensitive version check
$this->assertSame($result, StringHelper::startsWith($string, $with, false));
}
/**
* Rules that should work the same for case-sensitive and case-insensitive `startsWith()`.
*/
public static function providerStartsWith()
{
return [
// positive check
[true, '', ''],
[true, '', null],
[true, 'string', ''],
[true, ' string', ' '],
[true, 'abc', 'abc'],
[true, 'Bürger', 'Bürger'],
[true, '我Я multibyte', '我Я'],
[true, 'Qנטשופ צרכנות', 'Qנ'],
[true, 'ไทย.idn.icann.org', 'ไ'],
[true, '!?+', "\x21\x3F"],
[true, "\x21?+", '!?'],
// false-positive check
[false, '', ' '],
[false, ' ', ' '],
[false, 'Abc', 'Abcde'],
[false, 'abc', 'abe'],
[false, 'abc', 'b'],
[false, 'abc', 'c'],
];
}
public function testStartsWithCaseSensitive(): void
{
$this->assertFalse(StringHelper::startsWith('Abc', 'a'));
$this->assertFalse(StringHelper::startsWith('üЯ multibyte', 'Üя multibyte'));
}
public function testStartsWithCaseInsensitive(): void
{
$this->assertTrue(StringHelper::startsWith('sTrInG', 'StRiNg', false));
$this->assertTrue(StringHelper::startsWith('CaSe', 'cAs', false));
$this->assertTrue(StringHelper::startsWith('HTTP://BÜrger.DE/', 'http://bürger.de', false));
$this->assertTrue(StringHelper::startsWith('üЯйΨB', 'ÜяЙΨ', false));
}
/**
* @dataProvider providerEndsWith
* @param string|null $with
*/
public function testEndsWith(bool $result, string $string, ?string $with): void
{
// case sensitive version check
$this->assertSame($result, StringHelper::endsWith($string, $with));
// case insensitive version check
$this->assertSame($result, StringHelper::endsWith($string, $with, false));
}
/**
* Rules that should work the same for case-sensitive and case-insensitive `endsWith()`.
*/
public static function providerEndsWith()
{
return [
// positive check
[true, '', ''],
[true, '', null],
[true, 'string', ''],
[true, 'string ', ' '],
[true, 'string', 'g'],
[true, 'abc', 'abc'],
[true, 'Bürger', 'Bürger'],
[true, 'Я multibyte строка我!', ' строка我!'],
[true, '+!?', "\x21\x3F"],
[true, "+\x21?", "!\x3F"],
[true, 'נטשופ צרכנות', 'ת'],
// false-positive check
[false, '', ' '],
[false, ' ', ' '],
[false, 'aaa', 'aaaa'],
[false, 'abc', 'abe'],
[false, 'abc', 'a'],
[false, 'abc', 'b'],
];
}
public function testEndsWithCaseSensitive(): void
{
$this->assertFalse(StringHelper::endsWith('string', 'G'));
$this->assertFalse(StringHelper::endsWith('multibyte строка', 'А'));
}
public function testEndsWithCaseInsensitive(): void
{
$this->assertTrue(StringHelper::endsWith('sTrInG', 'StRiNg', false));
$this->assertTrue(StringHelper::endsWith('string', 'nG', false));
$this->assertTrue(StringHelper::endsWith('BüЯйΨ', 'ÜяЙΨ', false));
}
public function testExplode(): void
{
$this->assertEquals(['It', 'is', 'a first', 'test'], StringHelper::explode('It, is, a first, test'));
$this->assertEquals(['It', 'is', 'a test with trimmed digits', '0', '1', '2'], StringHelper::explode('It, is, a test with trimmed digits, 0, 1, 2', ',', true, true));
$this->assertEquals(['It', 'is', 'a second', 'test'], StringHelper::explode('It+ is+ a second+ test', '+'));
$this->assertEquals(['Save', '', '', 'empty trimmed string'], StringHelper::explode('Save, ,, empty trimmed string', ','));
$this->assertEquals(['44', '512'], StringHelper::explode('0 0 440 512', ' ', '0', true));
$this->assertEquals(['Здесь', 'multibyte', 'строка'], StringHelper::explode('Здесь我 multibyte我 строка', '我'));
$this->assertEquals(['Disable', ' trim ', 'here but ignore empty'], StringHelper::explode('Disable, trim ,,,here but ignore empty', ',', false, true));
$this->assertEquals(['It/', ' is?', ' a', ' test with rtrim'], StringHelper::explode('It/, is?, a , test with rtrim', ',', 'rtrim'));
$this->assertEquals(['It', ' is', ' a ', ' test with closure'], StringHelper::explode('It/, is?, a , test with closure', ',', fn($value) => trim((string) $value, '/?')));
}
public function testWordCount(): void
{
$this->assertEquals(3, StringHelper::countWords('china 中国 ㄍㄐㄋㄎㄌ'));
$this->assertEquals(4, StringHelper::countWords('и много тут слов?'));
$this->assertEquals(4, StringHelper::countWords("и\rмного\r\nтут\nслов?"));
$this->assertEquals(1, StringHelper::countWords('крем-брюле'));
$this->assertEquals(1, StringHelper::countWords(' слово '));
}
/**
* @dataProvider base64UrlEncodedStringsProvider
* @param $input
* @param $base64UrlEncoded
*/
public function testBase64UrlEncode(string $input, string $base64UrlEncoded): void
{
$encoded = StringHelper::base64UrlEncode($input);
$this->assertEquals($base64UrlEncoded, $encoded);
}
/**
* @dataProvider base64UrlEncodedStringsProvider
* @param $output
* @param $base64UrlEncoded
*/
public function testBase64UrlDecode(string $output, string $base64UrlEncoded): void
{
$decoded = StringHelper::base64UrlDecode($base64UrlEncoded);
$this->assertEquals($output, $decoded);
}
public static function base64UrlEncodedStringsProvider()
{
return [
['This is an encoded string', 'VGhpcyBpcyBhbiBlbmNvZGVkIHN0cmluZw=='],
['subjects?_d=1', 'c3ViamVjdHM_X2Q9MQ=='],
['subjects>_d=1', 'c3ViamVjdHM-X2Q9MQ=='],
['Это закодированная строка', '0K3RgtC-INC30LDQutC-0LTQuNGA0L7QstCw0L3QvdCw0Y8g0YHRgtGA0L7QutCw'],
];
}
/**
* Data provider for [[testMatchWildcard()]]
* @return array test data.
*/
public static function dataProviderMatchWildcard()
{
return [
// *
['*', 'any', true],
['*', '', true],
['begin*end', 'begin-middle-end', true],
['begin*end', 'beginend', true],
['begin*end', 'begin-d', false],
['*end', 'beginend', true],
['*end', 'begin', false],
['begin*', 'begin-end', true],
['begin*', 'end', false],
['begin*', 'before-begin', false],
// ?
['begin?end', 'begin1end', true],
['begin?end', 'beginend', false],
['begin??end', 'begin12end', true],
['begin??end', 'begin1end', false],
// []
['gr[ae]y', 'gray', true],
['gr[ae]y', 'grey', true],
['gr[ae]y', 'groy', false],
['a[2-8]', 'a1', false],
['a[2-8]', 'a3', true],
['[][!]', ']', true],
['[-1]', '-', true],
// [!]
['gr[!ae]y', 'gray', false],
['gr[!ae]y', 'grey', false],
['gr[!ae]y', 'groy', true],
['a[!2-8]', 'a1', true],
['a[!2-8]', 'a3', false],
// -
['a-z', 'a-z', true],
['a-z', 'a-c', false],
// slashes
['begin/*/end', 'begin/middle/end', true],
['begin/*/end', 'begin/two/steps/end', true],
['begin/*/end', 'begin/end', false],
['begin\\\\*\\\\end', 'begin\middle\end', true],
['begin\\\\*\\\\end', 'begin\two\steps\end', true],
['begin\\\\*\\\\end', 'begin\end', false],
// dots
['begin.*.end', 'begin.middle.end', true],
['begin.*.end', 'begin.two.steps.end', true],
['begin.*.end', 'begin.end', false],
// case
['begin*end', 'BEGIN-middle-END', false],
['begin*end', 'BEGIN-middle-END', true, ['caseSensitive' => false]],
// file path
['begin/*/end', 'begin/middle/end', true, ['filePath' => true]],
['begin/*/end', 'begin/two/steps/end', false, ['filePath' => true]],
['begin\\\\*\\\\end', 'begin\middle\end', true, ['filePath' => true]],
['begin\\\\*\\\\end', 'begin\two\steps\end', false, ['filePath' => true]],
['*', 'any', true, ['filePath' => true]],
['*', 'any/path', false, ['filePath' => true]],
['[.-0]', 'any/path', false, ['filePath' => true]],
['*', '.dotenv', true, ['filePath' => true]],
// escaping
['\*\?', '*?', true],
['\*\?', 'zz', false],
['begin\*\end', 'begin\middle\end', true, ['escape' => false]],
['begin\*\end', 'begin\two\steps\end', true, ['escape' => false]],
['begin\*\end', 'begin\end', false, ['escape' => false]],
['begin\*\end', 'begin\middle\end', true, ['filePath' => true, 'escape' => false]],
['begin\*\end', 'begin\two\steps\end', false, ['filePath' => true, 'escape' => false]],
];
}
/**
* @dataProvider dataProviderMatchWildcard
*/
public function testMatchWildcard(string $pattern, string $string, bool $expectedResult, array $options = []): void
{
$this->assertSame($expectedResult, StringHelper::matchWildcard($pattern, $string, $options));
}
public static function dataProviderMb_ucfirst()
{
return [
['foo', 'Foo'],
['foo bar', 'Foo bar'],
['👍🏻 foo bar', '👍🏻 foo bar'],
['', ''],
[null, ''],
['здесь我 multibyte我 строка', 'Здесь我 multibyte我 строка'],
];
}
/**
* @param string $string
* @dataProvider dataProviderMb_ucfirst
*/
public function testMb_ucfirst(?string $string, string $expectedResult): void
{
$this->assertSame($expectedResult, StringHelper::mb_ucfirst($string));
}
public static function dataProviderMb_ucwords()
{
return [
['foo', 'Foo'],
['foo bar', 'Foo Bar'],
['!foo bar-baz', '!foo Bar-baz'],
[' foo BAR', ' Foo BAR'],
[' ! foo BAR', ' ! Foo BAR'],
["\tfoo\nbar baz", "\tFoo\nBar Baz"],
['👍🏻 foo bar', '👍🏻 Foo Bar'],
['', ''],
['0', '0'],
[null, ''],
['здесь我 multibyte我 строка', 'Здесь我 Multibyte我 Строка'],
['p0 upload', 'P0 Upload'],
['p5 upload', 'P5 Upload'],
];
}
/**
* @param string $string
* @dataProvider dataProviderMb_ucwords
*/
public function testMb_ucwords(?string $string, string $expectedResult): void
{
$this->assertSame($expectedResult, StringHelper::mb_ucwords($string));
}
/**
* @dataProvider dataProviderDirname
*/
public function testDirname(string $string, string $expectedResult): void
{
$this->assertSame($expectedResult, StringHelper::dirname($string));
}
public static function dataProviderDirname()
{
return [
['\\foo\\bar\\test', '\foo\bar'],
['\\foo/bar\\test', '\foo/bar'],
['\\foo\\bar\\test\\', '\foo\bar'],
['foo/bar/test', 'foo/bar'],
['foo', ''],
['', ''],
];
}
}