summaryrefslogtreecommitdiff
path: root/tests/phpunit/includes/StringUtilsTest.php
blob: db3d265520a6d68212783693b3457fd59455052f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
<?php

class StringUtilsTest extends MediaWikiTestCase {

	/**
	 * This test StringUtils::isUtf8 whenever we have mbstring extension
	 * loaded.
	 *
	 * @covers StringUtils::isUtf8
	 * @dataProvider provideStringsForIsUtf8Check
	 */
	function testIsUtf8WithMbstring( $expected, $string ) {
		if ( !function_exists( 'mb_check_encoding' ) ) {
			$this->markTestSkipped( 'Test requires the mbstring PHP extension' );
		}
		$this->assertEquals( $expected,
			StringUtils::isUtf8( $string ),
			'Testing string "' . $this->escaped( $string ) . '" with mb_check_encoding'
		);
	}

	/**
	 * This test StringUtils::isUtf8 making sure we use the pure PHP
	 * implementation used as a fallback when mb_check_encoding() is
	 * not available.
	 *
	 * @covers StringUtils::isUtf8
	 * @dataProvider provideStringsForIsUtf8Check
	 */
	function testIsUtf8WithPhpFallbackImplementation( $expected, $string ) {
		$this->assertEquals( $expected,
			StringUtils::isUtf8( $string, /** disable mbstring: */ true ),
			'Testing string "' . $this->escaped( $string ) . '" with pure PHP implementation'
		);
	}

	/**
	 * Print high range characters as an hexadecimal
	 */
	function escaped( $string ) {
		$escaped = '';
		$length = strlen( $string );
		for ( $i = 0; $i < $length; $i++ ) {
			$char = $string[$i];
			$val = ord( $char );
			if ( $val > 127 ) {
				$escaped .= '\x' . dechex( $val );
			} else {
				$escaped .= $char;
			}
		}
		return $escaped;
	}

	/**
	 * See also "UTF-8 decoder capability and stress test" by
	 * Markus Kuhn:
	 * http://www.cl.cam.ac.uk/~mgk25/ucs/examples/UTF-8-test.txt
	 */
	function provideStringsForIsUtf8Check() {
		// Expected return values for StringUtils::isUtf8()
		$PASS = true;
		$FAIL = false;

		return array(
			array( $PASS, 'Some ASCII' ),
			array( $PASS, "Euro sign €" ),

			# First possible sequences
			array( $PASS, "\x00" ),
			array( $PASS, "\xc2\x80" ),
			array( $PASS, "\xe0\xa0\x80" ),
			array( $PASS, "\xf0\x90\x80\x80" ),
			array( $PASS, "\xf8\x88\x80\x80\x80" ),
			array( $PASS, "\xfc\x84\x80\x80\x80\x80" ),

			# Last possible sequence
			array( $PASS, "\x7f" ),
			array( $PASS, "\xdf\xbf" ),
			array( $PASS, "\xef\xbf\xbf" ),
			array( $PASS, "\xf7\xbf\xbf\xbf" ),
			array( $PASS, "\xfb\xbf\xbf\xbf\xbf" ),
			array( $FAIL, "\xfd\xbf\xbf\xbf\xbf\xbf" ),

			# boundaries:
			array( $PASS, "\xed\x9f\xbf" ),
			array( $PASS, "\xee\x80\x80" ),
			array( $PASS, "\xef\xbf\xbd" ),
			array( $PASS, "\xf4\x8f\xbf\xbf" ),
			array( $PASS, "\xf4\x90\x80\x80" ),

			# Malformed
			array( $FAIL, "\x80" ),
			array( $FAIL, "\xBF" ),
			array( $FAIL, "\x80\xbf" ),
			array( $FAIL, "\x80\xbf\x80" ),
			array( $FAIL, "\x80\xbf\x80\xbf" ),
			array( $FAIL, "\x80\xbf\x80\xbf\x80" ),
			array( $FAIL, "\x80\xbf\x80\xbf\x80\xbf" ),
			array( $FAIL, "\x80\xbf\x80\xbf\x80\xbf\x80" ),

			# last byte missing
			array( $FAIL, "\xc0" ),
			array( $FAIL, "\xe0\x80" ),
			array( $FAIL, "\xf0\x80\x80" ),
			array( $FAIL, "\xf8\x80\x80\x80" ),
			array( $FAIL, "\xfc\x80\x80\x80\x80" ),
			array( $FAIL, "\xdf" ),
			array( $FAIL, "\xef\xbf" ),
			array( $FAIL, "\xf7\xbf\xbf" ),
			array( $FAIL, "\xfb\xbf\xbf\xbf" ),
			array( $FAIL, "\xfd\xbf\xbf\xbf\xbf" ),

			# impossible bytes
			array( $FAIL, "\xfe" ),
			array( $FAIL, "\xff" ),
			array( $FAIL, "\xfe\xfe\xff\xff" ),

			/**
			# The PHP implementation does not handle characters
			# being represented in a form which is too long :(

			# overlong sequences
			array( $FAIL, "\xc0\xaf" ),
			array( $FAIL, "\xe0\x80\xaf" ),
			array( $FAIL, "\xf0\x80\x80\xaf" ),
			array( $FAIL, "\xf8\x80\x80\x80\xaf" ),
			array( $FAIL, "\xfc\x80\x80\x80\x80\xaf" ),

			# Maximum overlong sequences
			array( $FAIL, "\xc1\xbf" ),
			array( $FAIL, "\xe0\x9f\xbf" ),
			array( $FAIL, "\xf0\x8F\xbf\xbf" ),
			array( $FAIL, "\xf8\x87\xbf\xbf" ),
			array( $FAIL, "\xfc\x83\xbf\xbf\xbf\xbf" ),
			**/

			# non characters
			array( $PASS, "\xef\xbf\xbe" ),
			array( $PASS, "\xef\xbf\xbf" ),
		);
	}
}