Passed
Pull Request — master (#20)
by
unknown
01:29
created
src/Multibyte.php 2 patches
Indentation   +173 added lines, -173 removed lines patch added patch discarded remove patch
@@ -7,177 +7,177 @@
 block discarded – undo
7 7
  */
8 8
 class Multibyte
9 9
 {
10
-    //https://stackoverflow.com/questions/20025030/convert-all-types-of-smart-quotes-with-php
11
-    private static $unicodeCharacterMap = [
12
-        // Windows codepage 1252
13
-        "\xC2\x82" => "'", // U+0082⇒U+201A single low-9 quotation mark
14
-        "\xC2\x84" => '"', // U+0084⇒U+201E double low-9 quotation mark
15
-        "\xC2\x8B" => "'", // U+008B⇒U+2039 single left-pointing angle quotation mark
16
-        "\xC2\x91" => "'", // U+0091⇒U+2018 left single quotation mark
17
-        "\xC2\x92" => "'", // U+0092⇒U+2019 right single quotation mark
18
-        "\xC2\x93" => '"', // U+0093⇒U+201C left double quotation mark
19
-        "\xC2\x94" => '"', // U+0094⇒U+201D right double quotation mark
20
-        "\xC2\x9B" => "'", // U+009B⇒U+203A single right-pointing angle quotation mark
21
-        // Regular Unicode     // U+0022 quotation mark (")
22
-        // U+0027 apostrophe     (')
23
-        "\xC2\xAB" => '"', // U+00AB left-pointing double angle quotation mark
24
-        "\xC2\xBB" => '"', // U+00BB right-pointing double angle quotation mark
25
-        "\xE2\x80\x98" => "'", // U+2018 left single quotation mark
26
-        "\xE2\x80\x99" => "'", // U+2019 right single quotation mark
27
-        "\xE2\x80\x9A" => "'", // U+201A single low-9 quotation mark
28
-        "\xE2\x80\x9B" => "'", // U+201B single high-reversed-9 quotation mark
29
-        "\xE2\x80\x9C" => '"', // U+201C left double quotation mark
30
-        "\xE2\x80\x9D" => '"', // U+201D right double quotation mark
31
-        "\xE2\x80\x9E" => '"', // U+201E double low-9 quotation mark
32
-        "\xE2\x80\x9F" => '"', // U+201F double high-reversed-9 quotation mark
33
-        "\xE2\x80\xB9" => "'", // U+2039 single left-pointing angle quotation mark
34
-        "\xE2\x80\xBA" => "'", // U+203A single right-pointing angle quotation mark
35
-    ];
36
-
37
-    /**
38
-     * Replace
39
-     *
40
-     * @staticvar array $chr_map
41
-     * @param string $string
42
-     * @return string
43
-     */
44
-    public static function cleanUnicode($string)
45
-    {
46
-        $character = array_keys(self::$unicodeCharacterMap); // but: for efficiency you should
47
-        $replace = array_values(self::$unicodeCharacterMap); // pre-calculate these two arrays
48
-        return str_replace($character, $replace, html_entity_decode($string, ENT_QUOTES, "UTF-8"));
49
-    }
50
-
51
-    /**
52
-     * Multibyte.php safe version of standard trim() function.
53
-     *
54
-     * @param string $string
55
-     * @return string
56
-     */
57
-    public static function trim($string)
58
-    {
59
-        return mb_ereg_replace('^\s*([\s\S]*?)\s*$', '\1', $string);
60
-    }
61
-
62
-    /**
63
-     * A cross between mb_split and preg_split, adding the preg_split flags
64
-     * to mb_split.
65
-     *
66
-     * @param string $pattern
67
-     * @param string $string
68
-     * @param int $limit
69
-     * @param int $flags
70
-     * @return array
71
-     */
72
-    public static function split($pattern, $string, $limit = -1, $flags = 0)
73
-    {
74
-        $offset_capture = (bool)($flags & PREG_SPLIT_OFFSET_CAPTURE);
75
-
76
-        $lengths = self::getSplitLengths($pattern, $string);
77
-
78
-        // Substrings
79
-        $parts = [];
80
-        $position = 0;
81
-        $count = 1;
82
-        foreach ($lengths as $length) {
83
-            if (self::isLastPart($length, $flags, $limit, $count)) {
84
-                $parts[] = self::makePart($string, $position, null, $offset_capture);
85
-                return $parts;
86
-            }
87
-
88
-            if (self::isPart($length, $flags)) {
89
-                $parts[] = self::makePart($string, $position, $length[0], $offset_capture);
90
-            }
91
-
92
-            $position += $length[0];
93
-        }
94
-
95
-        return $parts;
96
-    }
97
-
98
-    /**
99
-     * @param $length
100
-     * @param $flags
101
-     * @param $limit
102
-     * @param $count
103
-     * @return bool
104
-     */
105
-    private static function isLastPart($length, $flags, $limit, &$count)
106
-    {
107
-        $split_empty = !($flags & PREG_SPLIT_NO_EMPTY) || $length[0];
108
-        $is_delimiter = $length[1];
109
-
110
-        return $limit > 0
111
-            && !$is_delimiter
112
-            && $split_empty
113
-            && ++$count > $limit;
114
-    }
115
-
116
-    /**
117
-     * @param $length
118
-     * @param $flags
119
-     * @return bool
120
-     */
121
-    private static function isPart($length, $flags)
122
-    {
123
-        $split_empty = !($flags & PREG_SPLIT_NO_EMPTY) || $length[0];
124
-        $is_delimiter = $length[1];
125
-        $is_captured = ($flags & PREG_SPLIT_DELIM_CAPTURE) && $length[2];
126
-
127
-        return (!$is_delimiter
128
-                || $is_captured)
129
-            && $split_empty;
130
-    }
131
-
132
-    /**
133
-     * Make part
134
-     * @param string $string
135
-     * @param integer $position
136
-     * @param integer|null $length
137
-     * @param bool $offset_capture
138
-     * @return array|string
139
-     */
140
-    private static function makePart($string, $position, $length = null, $offset_capture = false)
141
-    {
142
-        $cut = mb_strcut($string, $position, $length);
143
-
144
-        return $offset_capture
145
-            ? [$cut, $position]
146
-            : $cut;
147
-    }
148
-
149
-    /**
150
-     * Splits the string by pattern and for each element (part or split) returns:
151
-     *  [ 0 => length, 1 => is_delimiter?, 2 =>
152
-     *
153
-     * @param $pattern
154
-     * @param $string
155
-     * @return array
156
-     */
157
-    private static function getSplitLengths($pattern, $string)
158
-    {
159
-        $strlen = strlen($string); // bytes!
160
-        $lengths = [];
161
-
162
-        mb_ereg_search_init($string);
163
-
164
-        $position = 0;
165
-        while ($position < $strlen
166
-            && ($array = mb_ereg_search_pos($pattern, '')) !== false) {
167
-            // capture split
168
-            $lengths[] = [$array[0] - $position, false, null];
169
-
170
-            // move position
171
-            $position = $array[0] + $array[1];
172
-
173
-            // capture delimiter
174
-            $regs = mb_ereg_search_getregs();
175
-            $lengths[] = [$array[1], true, isset($regs[1]) && $regs[1]];
176
-        }
177
-
178
-        // Add last bit, if not ending with split
179
-        $lengths[] = [$strlen - $position, false, null];
180
-
181
-        return $lengths;
182
-    }
10
+	//https://stackoverflow.com/questions/20025030/convert-all-types-of-smart-quotes-with-php
11
+	private static $unicodeCharacterMap = [
12
+		// Windows codepage 1252
13
+		"\xC2\x82" => "'", // U+0082⇒U+201A single low-9 quotation mark
14
+		"\xC2\x84" => '"', // U+0084⇒U+201E double low-9 quotation mark
15
+		"\xC2\x8B" => "'", // U+008B⇒U+2039 single left-pointing angle quotation mark
16
+		"\xC2\x91" => "'", // U+0091⇒U+2018 left single quotation mark
17
+		"\xC2\x92" => "'", // U+0092⇒U+2019 right single quotation mark
18
+		"\xC2\x93" => '"', // U+0093⇒U+201C left double quotation mark
19
+		"\xC2\x94" => '"', // U+0094⇒U+201D right double quotation mark
20
+		"\xC2\x9B" => "'", // U+009B⇒U+203A single right-pointing angle quotation mark
21
+		// Regular Unicode     // U+0022 quotation mark (")
22
+		// U+0027 apostrophe     (')
23
+		"\xC2\xAB" => '"', // U+00AB left-pointing double angle quotation mark
24
+		"\xC2\xBB" => '"', // U+00BB right-pointing double angle quotation mark
25
+		"\xE2\x80\x98" => "'", // U+2018 left single quotation mark
26
+		"\xE2\x80\x99" => "'", // U+2019 right single quotation mark
27
+		"\xE2\x80\x9A" => "'", // U+201A single low-9 quotation mark
28
+		"\xE2\x80\x9B" => "'", // U+201B single high-reversed-9 quotation mark
29
+		"\xE2\x80\x9C" => '"', // U+201C left double quotation mark
30
+		"\xE2\x80\x9D" => '"', // U+201D right double quotation mark
31
+		"\xE2\x80\x9E" => '"', // U+201E double low-9 quotation mark
32
+		"\xE2\x80\x9F" => '"', // U+201F double high-reversed-9 quotation mark
33
+		"\xE2\x80\xB9" => "'", // U+2039 single left-pointing angle quotation mark
34
+		"\xE2\x80\xBA" => "'", // U+203A single right-pointing angle quotation mark
35
+	];
36
+
37
+	/**
38
+	 * Replace
39
+	 *
40
+	 * @staticvar array $chr_map
41
+	 * @param string $string
42
+	 * @return string
43
+	 */
44
+	public static function cleanUnicode($string)
45
+	{
46
+		$character = array_keys(self::$unicodeCharacterMap); // but: for efficiency you should
47
+		$replace = array_values(self::$unicodeCharacterMap); // pre-calculate these two arrays
48
+		return str_replace($character, $replace, html_entity_decode($string, ENT_QUOTES, "UTF-8"));
49
+	}
50
+
51
+	/**
52
+	 * Multibyte.php safe version of standard trim() function.
53
+	 *
54
+	 * @param string $string
55
+	 * @return string
56
+	 */
57
+	public static function trim($string)
58
+	{
59
+		return mb_ereg_replace('^\s*([\s\S]*?)\s*$', '\1', $string);
60
+	}
61
+
62
+	/**
63
+	 * A cross between mb_split and preg_split, adding the preg_split flags
64
+	 * to mb_split.
65
+	 *
66
+	 * @param string $pattern
67
+	 * @param string $string
68
+	 * @param int $limit
69
+	 * @param int $flags
70
+	 * @return array
71
+	 */
72
+	public static function split($pattern, $string, $limit = -1, $flags = 0)
73
+	{
74
+		$offset_capture = (bool)($flags & PREG_SPLIT_OFFSET_CAPTURE);
75
+
76
+		$lengths = self::getSplitLengths($pattern, $string);
77
+
78
+		// Substrings
79
+		$parts = [];
80
+		$position = 0;
81
+		$count = 1;
82
+		foreach ($lengths as $length) {
83
+			if (self::isLastPart($length, $flags, $limit, $count)) {
84
+				$parts[] = self::makePart($string, $position, null, $offset_capture);
85
+				return $parts;
86
+			}
87
+
88
+			if (self::isPart($length, $flags)) {
89
+				$parts[] = self::makePart($string, $position, $length[0], $offset_capture);
90
+			}
91
+
92
+			$position += $length[0];
93
+		}
94
+
95
+		return $parts;
96
+	}
97
+
98
+	/**
99
+	 * @param $length
100
+	 * @param $flags
101
+	 * @param $limit
102
+	 * @param $count
103
+	 * @return bool
104
+	 */
105
+	private static function isLastPart($length, $flags, $limit, &$count)
106
+	{
107
+		$split_empty = !($flags & PREG_SPLIT_NO_EMPTY) || $length[0];
108
+		$is_delimiter = $length[1];
109
+
110
+		return $limit > 0
111
+			&& !$is_delimiter
112
+			&& $split_empty
113
+			&& ++$count > $limit;
114
+	}
115
+
116
+	/**
117
+	 * @param $length
118
+	 * @param $flags
119
+	 * @return bool
120
+	 */
121
+	private static function isPart($length, $flags)
122
+	{
123
+		$split_empty = !($flags & PREG_SPLIT_NO_EMPTY) || $length[0];
124
+		$is_delimiter = $length[1];
125
+		$is_captured = ($flags & PREG_SPLIT_DELIM_CAPTURE) && $length[2];
126
+
127
+		return (!$is_delimiter
128
+				|| $is_captured)
129
+			&& $split_empty;
130
+	}
131
+
132
+	/**
133
+	 * Make part
134
+	 * @param string $string
135
+	 * @param integer $position
136
+	 * @param integer|null $length
137
+	 * @param bool $offset_capture
138
+	 * @return array|string
139
+	 */
140
+	private static function makePart($string, $position, $length = null, $offset_capture = false)
141
+	{
142
+		$cut = mb_strcut($string, $position, $length);
143
+
144
+		return $offset_capture
145
+			? [$cut, $position]
146
+			: $cut;
147
+	}
148
+
149
+	/**
150
+	 * Splits the string by pattern and for each element (part or split) returns:
151
+	 *  [ 0 => length, 1 => is_delimiter?, 2 =>
152
+	 *
153
+	 * @param $pattern
154
+	 * @param $string
155
+	 * @return array
156
+	 */
157
+	private static function getSplitLengths($pattern, $string)
158
+	{
159
+		$strlen = strlen($string); // bytes!
160
+		$lengths = [];
161
+
162
+		mb_ereg_search_init($string);
163
+
164
+		$position = 0;
165
+		while ($position < $strlen
166
+			&& ($array = mb_ereg_search_pos($pattern, '')) !== false) {
167
+			// capture split
168
+			$lengths[] = [$array[0] - $position, false, null];
169
+
170
+			// move position
171
+			$position = $array[0] + $array[1];
172
+
173
+			// capture delimiter
174
+			$regs = mb_ereg_search_getregs();
175
+			$lengths[] = [$array[1], true, isset($regs[1]) && $regs[1]];
176
+		}
177
+
178
+		// Add last bit, if not ending with split
179
+		$lengths[] = [$strlen - $position, false, null];
180
+
181
+		return $lengths;
182
+	}
183 183
 }
184 184
\ No newline at end of file
Please login to merge, or discard this patch.
Spacing   +1 added lines, -1 removed lines patch added patch discarded remove patch
@@ -71,7 +71,7 @@
 block discarded – undo
71 71
      */
72 72
     public static function split($pattern, $string, $limit = -1, $flags = 0)
73 73
     {
74
-        $offset_capture = (bool)($flags & PREG_SPLIT_OFFSET_CAPTURE);
74
+        $offset_capture = (bool) ($flags & PREG_SPLIT_OFFSET_CAPTURE);
75 75
 
76 76
         $lengths = self::getSplitLengths($pattern, $string);
77 77
 
Please login to merge, or discard this patch.
src/Sentence.php 2 patches
Spacing   +4 added lines, -4 removed lines patch added patch discarded remove patch
@@ -75,7 +75,7 @@  discard block
 block discarded – undo
75 75
 
76 76
             $this->replacements[$index] = $number;
77 77
 
78
-            $text = (string)substr_replace($text, $code, $offset, mb_strlen($number));
78
+            $text = (string) substr_replace($text, $code, $offset, mb_strlen($number));
79 79
 
80 80
             ++$index;
81 81
         }
@@ -92,7 +92,7 @@  discard block
 block discarded – undo
92 92
      */
93 93
     private function restoreReplacements($text)
94 94
     {
95
-        return array_map(function ($value) {
95
+        return array_map(function($value) {
96 96
             foreach ($this->replacements as $index => $number) {
97 97
                 $code = $this->getReplaceCode($index);
98 98
                 $value = str_replace($code, $number, $value);
@@ -190,7 +190,7 @@  discard block
 block discarded – undo
190 190
         $merges = [];
191 191
         $merge = '';
192 192
 
193
-        $filtered = array_filter($punctuations, function ($p) {
193
+        $filtered = array_filter($punctuations, function($p) {
194 194
             return $p !== '';
195 195
         });
196 196
 
@@ -448,7 +448,7 @@  discard block
 block discarded – undo
448 448
      */
449 449
     private static function trimSentences($sentences)
450 450
     {
451
-        return array_map(function ($sentence) {
451
+        return array_map(function($sentence) {
452 452
             return Multibyte::trim($sentence);
453 453
         }, $sentences);
454 454
     }
Please login to merge, or discard this patch.
Indentation   +449 added lines, -449 removed lines patch added patch discarded remove patch
@@ -17,454 +17,454 @@
 block discarded – undo
17 17
 class Sentence
18 18
 {
19 19
 
20
-    /**
21
-     * Specify this flag with the split method to trim whitespace.
22
-     */
23
-    const SPLIT_TRIM = 0x1;
24
-
25
-    /**
26
-     * List of characters used to terminate sentences.
27
-     *
28
-     * @var string[]
29
-     */
30
-    private $terminals = ['.', '!', '?'];
31
-
32
-    /**
33
-     * List of characters used for abbreviations.
34
-     *
35
-     * @var string[]
36
-     */
37
-    private $abbreviators = ['.'];
38
-
39
-    /**
40
-     * List of replacements in the text.
41
-     *
42
-     * @var string[]
43
-     */
44
-    private $replacements = [];
45
-
46
-    /**
47
-     * Generate an in-text replacement code for the specified index
48
-     *
49
-     * @param int $index
50
-     *
51
-     * @return string
52
-     */
53
-    private function getReplaceCode(int $index)
54
-    {
55
-        return 0x02 . $index . 0x03;
56
-    }
57
-
58
-    /**
59
-     * Clean floating point numbers by replace them with an in-text index
60
-     *
61
-     * @param string $text
62
-     *
63
-     * @return string
64
-     */
65
-    private function replaceFloatNumbers(string $text)
66
-    {
67
-        preg_match_all('!\d+(?:\.\d+)?!', $text, $matches, PREG_OFFSET_CAPTURE);
68
-
69
-        $this->replacements = [];
70
-        $index = 0;
71
-        foreach (array_reverse($matches[0]) as $match) {
72
-            $number = $match[0];
73
-            $offset = $match[1];
74
-            $code = $this->getReplaceCode($index);
75
-
76
-            $this->replacements[$index] = $number;
77
-
78
-            $text = (string)substr_replace($text, $code, $offset, mb_strlen($number));
79
-
80
-            ++$index;
81
-        }
82
-
83
-        return $text;
84
-    }
85
-
86
-    /**
87
-     * Restore any stored replacements
88
-     *
89
-     * @param string[] $text
90
-     *
91
-     * @return string[]
92
-     */
93
-    private function restoreReplacements($text)
94
-    {
95
-        return array_map(function ($value) {
96
-            foreach ($this->replacements as $index => $number) {
97
-                $code = $this->getReplaceCode($index);
98
-                $value = str_replace($code, $number, $value);
99
-            }
100
-
101
-            return $value;
102
-        }, $text);
103
-    }
104
-
105
-    /**
106
-     * Breaks a piece of text into lines by linebreak.
107
-     * Eats up any linebreak characters as if one.
108
-     *
109
-     * Multibyte.php safe
110
-     *
111
-     * @param string $text
112
-     *
113
-     * @return string[]
114
-     */
115
-    private static function linebreakSplit($text)
116
-    {
117
-        $lines = [];
118
-        $line = '';
119
-
120
-        foreach (Multibyte::split('([\r\n]+)', $text, -1, PREG_SPLIT_DELIM_CAPTURE) as $part) {
121
-            $line .= $part;
122
-            if (Multibyte::trim($part) === '') {
123
-                $lines[] = $line;
124
-                $line = '';
125
-            }
126
-        }
127
-        $lines[] = $line;
128
-
129
-        return $lines;
130
-    }
131
-
132
-    /**
133
-     * Splits an array of lines by (consecutive sequences of)
134
-     * terminals, keeping terminals.
135
-     *
136
-     * Multibyte.php safe (atleast for UTF-8)
137
-     *
138
-     * For example:
139
-     *    "There ... is. More!"
140
-     *        ... becomes ...
141
-     *    [ "There ", "...", " is", ".", " More", "!" ]
142
-     *
143
-     * @param string $line
144
-     *
145
-     * @return string[]
146
-     */
147
-    private function punctuationSplit($line)
148
-    {
149
-        $parts = [];
150
-
151
-        $chars = preg_split('//u', $line, -1, PREG_SPLIT_NO_EMPTY); // This is UTF8 multibyte safe!
152
-        $is_terminal = in_array($chars[0], $this->terminals);
153
-
154
-        $part = '';
155
-        foreach ($chars as $char) {
156
-            if (in_array($char, $this->terminals) !== $is_terminal) {
157
-                $parts[] = $part;
158
-                $part = '';
159
-                $is_terminal = !$is_terminal;
160
-            }
161
-            $part .= $char;
162
-        }
163
-
164
-        if (!empty($part)) {
165
-            $parts[] = $part;
166
-        }
167
-
168
-        return $parts;
169
-    }
170
-
171
-    /**
172
-     * Appends each terminal item after it's preceding
173
-     * non-terminals.
174
-     *
175
-     * Multibyte.php safe (atleast for UTF-8)
176
-     *
177
-     * For example:
178
-     *    [ "There ", "...", " is", ".", " More", "!" ]
179
-     *        ... becomes ...
180
-     *    [ "There ... is.", "More!" ]
181
-     *
182
-     * @param string[] $punctuations
183
-     *
184
-     * @return string[]
185
-     */
186
-    private function punctuationMerge($punctuations)
187
-    {
188
-        $definite_terminals = array_diff($this->terminals, $this->abbreviators);
189
-
190
-        $merges = [];
191
-        $merge = '';
192
-
193
-        $filtered = array_filter($punctuations, function ($p) {
194
-            return $p !== '';
195
-        });
196
-
197
-        foreach ($filtered as $punctuation) {
198
-            $merge .= $punctuation;
199
-            if (mb_strlen($punctuation) === 1
200
-                && in_array($punctuation, $this->terminals)) {
201
-                $merges[] = $merge;
202
-                $merge = '';
203
-            } else {
204
-                foreach ($definite_terminals as $terminal) {
205
-                    if (mb_strpos($punctuation, $terminal) !== false) {
206
-                        $merges[] = $merge;
207
-                        $merge = '';
208
-                        break;
209
-                    }
210
-                }
211
-            }
212
-        }
213
-        if (!empty($merge)) {
214
-            $merges[] = $merge;
215
-        }
216
-
217
-        return $merges;
218
-    }
219
-
220
-    /**
221
-     * Looks for capitalized abbreviations & includes them with the following fragment.
222
-     *
223
-     * For example:
224
-     *    [ "Last week, former director of the F.B.I. James B. Comey was fired. Mr. Comey was not available for comment." ]
225
-     *        ... becomes ...
226
-     *    [ "Last week, former director of the F.B.I. James B. Comey was fired." ]
227
-     *  [ "Mr. Comey was not available for comment." ]
228
-     *
229
-     * @param string[] $fragments
230
-     *
231
-     * @return string[]
232
-     */
233
-    private function abbreviationMerge($fragments)
234
-    {
235
-        $return_fragment = [];
236
-
237
-        $previous_fragment = '';
238
-        $previous_is_abbreviation = false;
239
-        $i = 0;
240
-        foreach ($fragments as $fragment) {
241
-            $is_abbreviation = self::isAbreviation($fragment);
242
-
243
-            // merge previous fragment with this
244
-            if ($previous_is_abbreviation) {
245
-                $fragment = $previous_fragment . $fragment;
246
-            }
247
-            $return_fragment[$i] = $fragment;
248
-
249
-            $previous_is_abbreviation = $is_abbreviation;
250
-            $previous_fragment = $fragment;
251
-
252
-            // only increment if this isn't an abbreviation
253
-            if (!$is_abbreviation) {
254
-                $i++;
255
-            }
256
-        }
257
-
258
-        return $return_fragment;
259
-    }
260
-
261
-    /**
262
-     * Check if the last word of fragment starts with a Capital, ends in "." & has less than 3 characters.
263
-     *
264
-     * @param $fragment
265
-     *
266
-     * @return bool
267
-     */
268
-    private static function isAbreviation($fragment)
269
-    {
270
-        $words = mb_split('\s+', Multibyte::trim($fragment));
271
-
272
-        $word_count = count($words);
273
-
274
-        $last_word = Multibyte::trim($words[$word_count - 1]);
275
-        $last_is_capital = preg_match('#^\p{Lu}#u', $last_word);
276
-        $last_is_abbreviation = mb_substr(Multibyte::trim($fragment), -1) === '.';
277
-
278
-        return $last_is_capital > 0
279
-            && $last_is_abbreviation > 0
280
-            && mb_strlen($last_word) <= 3;
281
-    }
282
-
283
-    /**
284
-     * Merges any part starting with a closing parenthesis ')' to the previous
285
-     * part.
286
-     *
287
-     * @param string[] $parts
288
-     *
289
-     * @return string[]
290
-     */
291
-    private function parenthesesMerge($parts)
292
-    {
293
-        $subsentences = [];
294
-
295
-        foreach ($parts as $part) {
296
-            if ($part[0] === ')' && !empty($subsentences)) {
297
-                $subsentences[count($subsentences) - 1] .= $part;
298
-            } else {
299
-                $subsentences[] = $part;
300
-            }
301
-        }
302
-
303
-        return $subsentences;
304
-    }
305
-
306
-    /**
307
-     * Looks for closing quotes to include them with the previous statement.
308
-     * "That was very interesting," he said.
309
-     * "That was very interesting."
310
-     *
311
-     * @param string[] $statements
312
-     *
313
-     * @return string[]
314
-     */
315
-    private function closeQuotesMerge($statements)
316
-    {
317
-        $i = 0;
318
-        $previous_statement = '';
319
-        $return = [];
320
-        foreach ($statements as $statement) {
321
-            if (self::isEndQuote($statement)) {
322
-                $statement = $previous_statement . $statement;
323
-            } else {
324
-                $i++;
325
-            }
326
-
327
-            $return[$i] = $statement;
328
-            $previous_statement = $statement;
329
-        }
330
-
331
-        return $return;
332
-    }
333
-
334
-    /**
335
-     * Check if the entire string is a quotation mark or quote, then space, then lowercase.
336
-     *
337
-     * @param $statement
338
-     *
339
-     * @return bool
340
-     */
341
-    private static function isEndQuote($statement)
342
-    {
343
-        $trimmed = Multibyte::trim($statement);
344
-        $first = mb_substr($statement, 0, 1);
345
-
346
-        return in_array($trimmed, ['"', '\''])
347
-            || (
348
-                in_array($first, ['"', '\''])
349
-                && mb_substr($statement, 1, 1) === ' '
350
-                && ctype_lower(mb_substr($statement, 2, 1)) === true
351
-            );
352
-    }
353
-
354
-    /**
355
-     * Merges items into larger sentences.
356
-     * Multibyte.php safe
357
-     *
358
-     * @param string[] $shorts
359
-     *
360
-     * @return string[]
361
-     */
362
-    private function sentenceMerge($shorts)
363
-    {
364
-        $non_abbreviating_terminals = array_diff($this->terminals, $this->abbreviators);
365
-
366
-        $sentences = [];
367
-
368
-        $sentence = '';
369
-        $has_words = false;
370
-        $previous_word_ending = null;
371
-        foreach ($shorts as $short) {
372
-            $word_count = count(mb_split('\s+', Multibyte::trim($short)));
373
-            $after_non_abbreviating_terminal = in_array($previous_word_ending, $non_abbreviating_terminals);
374
-
375
-            if ($after_non_abbreviating_terminal
376
-                || ($has_words && $word_count > 1)) {
377
-
378
-                $sentences[] = $sentence;
379
-
380
-                $sentence = '';
381
-                $has_words = false;
382
-            }
383
-
384
-            $has_words = $has_words
385
-                || $word_count > 1;
386
-
387
-            $sentence .= $short;
388
-            $previous_word_ending = mb_substr($short, -1);
389
-        }
390
-
391
-        if (!empty($sentence)) {
392
-            $sentences[] = $sentence;
393
-        }
394
-
395
-        return $sentences;
396
-    }
397
-
398
-    /**
399
-     * Return the sentences sentences detected in the provided text.
400
-     * Set the Sentence::SPLIT_TRIM flag to trim whitespace.
401
-     *
402
-     * @param string  $text
403
-     * @param integer $flags
404
-     *
405
-     * @return string[]
406
-     */
407
-    public function split($text, $flags = 0, $pipeline = [])
408
-    {
409
-        if (empty($pipeline)) {
410
-            static $pipeline = [
411
-                'replaceFloatNumbers',
412
-                'punctuationSplit',
413
-                'parenthesesMerge', // also works after punctuationMerge or abbreviationMerge
414
-                'punctuationMerge',
415
-                'abbreviationMerge',
416
-                'closeQuotesMerge',
417
-                'sentenceMerge',
418
-                'restoreReplacements',
419
-            ];
420
-        }
421
-
422
-        // clean funny quotes
423
-        $text = Multibyte::cleanUnicode($text);
424
-
425
-        // Split
426
-        $sentences = [];
427
-        foreach (self::linebreakSplit($text) as $input) {
428
-            if (Multibyte::trim($input) !== '') {
429
-                foreach ($pipeline as $method) {
430
-                    $input = $this->$method($input);
431
-                }
432
-                $sentences = array_merge($sentences, $input);
433
-            }
434
-        }
435
-
436
-        // Post process
437
-        if ($flags & self::SPLIT_TRIM) {
438
-            return self::trimSentences($sentences);
439
-        }
440
-
441
-        return $sentences;
442
-    }
443
-
444
-    /**
445
-     * Multibyte.php trim each string in an array.
446
-     *
447
-     * @param string[] $sentences
448
-     *
449
-     * @return string[]
450
-     */
451
-    private static function trimSentences($sentences)
452
-    {
453
-        return array_map(function ($sentence) {
454
-            return Multibyte::trim($sentence);
455
-        }, $sentences);
456
-    }
457
-
458
-    /**
459
-     * Return the number of sentences detected in the provided text.
460
-     *
461
-     * @param string $text
462
-     *
463
-     * @return integer
464
-     */
465
-    public function count($text)
466
-    {
467
-        return count($this->split($text));
468
-    }
20
+	/**
21
+	 * Specify this flag with the split method to trim whitespace.
22
+	 */
23
+	const SPLIT_TRIM = 0x1;
24
+
25
+	/**
26
+	 * List of characters used to terminate sentences.
27
+	 *
28
+	 * @var string[]
29
+	 */
30
+	private $terminals = ['.', '!', '?'];
31
+
32
+	/**
33
+	 * List of characters used for abbreviations.
34
+	 *
35
+	 * @var string[]
36
+	 */
37
+	private $abbreviators = ['.'];
38
+
39
+	/**
40
+	 * List of replacements in the text.
41
+	 *
42
+	 * @var string[]
43
+	 */
44
+	private $replacements = [];
45
+
46
+	/**
47
+	 * Generate an in-text replacement code for the specified index
48
+	 *
49
+	 * @param int $index
50
+	 *
51
+	 * @return string
52
+	 */
53
+	private function getReplaceCode(int $index)
54
+	{
55
+		return 0x02 . $index . 0x03;
56
+	}
57
+
58
+	/**
59
+	 * Clean floating point numbers by replace them with an in-text index
60
+	 *
61
+	 * @param string $text
62
+	 *
63
+	 * @return string
64
+	 */
65
+	private function replaceFloatNumbers(string $text)
66
+	{
67
+		preg_match_all('!\d+(?:\.\d+)?!', $text, $matches, PREG_OFFSET_CAPTURE);
68
+
69
+		$this->replacements = [];
70
+		$index = 0;
71
+		foreach (array_reverse($matches[0]) as $match) {
72
+			$number = $match[0];
73
+			$offset = $match[1];
74
+			$code = $this->getReplaceCode($index);
75
+
76
+			$this->replacements[$index] = $number;
77
+
78
+			$text = (string)substr_replace($text, $code, $offset, mb_strlen($number));
79
+
80
+			++$index;
81
+		}
82
+
83
+		return $text;
84
+	}
85
+
86
+	/**
87
+	 * Restore any stored replacements
88
+	 *
89
+	 * @param string[] $text
90
+	 *
91
+	 * @return string[]
92
+	 */
93
+	private function restoreReplacements($text)
94
+	{
95
+		return array_map(function ($value) {
96
+			foreach ($this->replacements as $index => $number) {
97
+				$code = $this->getReplaceCode($index);
98
+				$value = str_replace($code, $number, $value);
99
+			}
100
+
101
+			return $value;
102
+		}, $text);
103
+	}
104
+
105
+	/**
106
+	 * Breaks a piece of text into lines by linebreak.
107
+	 * Eats up any linebreak characters as if one.
108
+	 *
109
+	 * Multibyte.php safe
110
+	 *
111
+	 * @param string $text
112
+	 *
113
+	 * @return string[]
114
+	 */
115
+	private static function linebreakSplit($text)
116
+	{
117
+		$lines = [];
118
+		$line = '';
119
+
120
+		foreach (Multibyte::split('([\r\n]+)', $text, -1, PREG_SPLIT_DELIM_CAPTURE) as $part) {
121
+			$line .= $part;
122
+			if (Multibyte::trim($part) === '') {
123
+				$lines[] = $line;
124
+				$line = '';
125
+			}
126
+		}
127
+		$lines[] = $line;
128
+
129
+		return $lines;
130
+	}
131
+
132
+	/**
133
+	 * Splits an array of lines by (consecutive sequences of)
134
+	 * terminals, keeping terminals.
135
+	 *
136
+	 * Multibyte.php safe (atleast for UTF-8)
137
+	 *
138
+	 * For example:
139
+	 *    "There ... is. More!"
140
+	 *        ... becomes ...
141
+	 *    [ "There ", "...", " is", ".", " More", "!" ]
142
+	 *
143
+	 * @param string $line
144
+	 *
145
+	 * @return string[]
146
+	 */
147
+	private function punctuationSplit($line)
148
+	{
149
+		$parts = [];
150
+
151
+		$chars = preg_split('//u', $line, -1, PREG_SPLIT_NO_EMPTY); // This is UTF8 multibyte safe!
152
+		$is_terminal = in_array($chars[0], $this->terminals);
153
+
154
+		$part = '';
155
+		foreach ($chars as $char) {
156
+			if (in_array($char, $this->terminals) !== $is_terminal) {
157
+				$parts[] = $part;
158
+				$part = '';
159
+				$is_terminal = !$is_terminal;
160
+			}
161
+			$part .= $char;
162
+		}
163
+
164
+		if (!empty($part)) {
165
+			$parts[] = $part;
166
+		}
167
+
168
+		return $parts;
169
+	}
170
+
171
+	/**
172
+	 * Appends each terminal item after it's preceding
173
+	 * non-terminals.
174
+	 *
175
+	 * Multibyte.php safe (atleast for UTF-8)
176
+	 *
177
+	 * For example:
178
+	 *    [ "There ", "...", " is", ".", " More", "!" ]
179
+	 *        ... becomes ...
180
+	 *    [ "There ... is.", "More!" ]
181
+	 *
182
+	 * @param string[] $punctuations
183
+	 *
184
+	 * @return string[]
185
+	 */
186
+	private function punctuationMerge($punctuations)
187
+	{
188
+		$definite_terminals = array_diff($this->terminals, $this->abbreviators);
189
+
190
+		$merges = [];
191
+		$merge = '';
192
+
193
+		$filtered = array_filter($punctuations, function ($p) {
194
+			return $p !== '';
195
+		});
196
+
197
+		foreach ($filtered as $punctuation) {
198
+			$merge .= $punctuation;
199
+			if (mb_strlen($punctuation) === 1
200
+				&& in_array($punctuation, $this->terminals)) {
201
+				$merges[] = $merge;
202
+				$merge = '';
203
+			} else {
204
+				foreach ($definite_terminals as $terminal) {
205
+					if (mb_strpos($punctuation, $terminal) !== false) {
206
+						$merges[] = $merge;
207
+						$merge = '';
208
+						break;
209
+					}
210
+				}
211
+			}
212
+		}
213
+		if (!empty($merge)) {
214
+			$merges[] = $merge;
215
+		}
216
+
217
+		return $merges;
218
+	}
219
+
220
+	/**
221
+	 * Looks for capitalized abbreviations & includes them with the following fragment.
222
+	 *
223
+	 * For example:
224
+	 *    [ "Last week, former director of the F.B.I. James B. Comey was fired. Mr. Comey was not available for comment." ]
225
+	 *        ... becomes ...
226
+	 *    [ "Last week, former director of the F.B.I. James B. Comey was fired." ]
227
+	 *  [ "Mr. Comey was not available for comment." ]
228
+	 *
229
+	 * @param string[] $fragments
230
+	 *
231
+	 * @return string[]
232
+	 */
233
+	private function abbreviationMerge($fragments)
234
+	{
235
+		$return_fragment = [];
236
+
237
+		$previous_fragment = '';
238
+		$previous_is_abbreviation = false;
239
+		$i = 0;
240
+		foreach ($fragments as $fragment) {
241
+			$is_abbreviation = self::isAbreviation($fragment);
242
+
243
+			// merge previous fragment with this
244
+			if ($previous_is_abbreviation) {
245
+				$fragment = $previous_fragment . $fragment;
246
+			}
247
+			$return_fragment[$i] = $fragment;
248
+
249
+			$previous_is_abbreviation = $is_abbreviation;
250
+			$previous_fragment = $fragment;
251
+
252
+			// only increment if this isn't an abbreviation
253
+			if (!$is_abbreviation) {
254
+				$i++;
255
+			}
256
+		}
257
+
258
+		return $return_fragment;
259
+	}
260
+
261
+	/**
262
+	 * Check if the last word of fragment starts with a Capital, ends in "." & has less than 3 characters.
263
+	 *
264
+	 * @param $fragment
265
+	 *
266
+	 * @return bool
267
+	 */
268
+	private static function isAbreviation($fragment)
269
+	{
270
+		$words = mb_split('\s+', Multibyte::trim($fragment));
271
+
272
+		$word_count = count($words);
273
+
274
+		$last_word = Multibyte::trim($words[$word_count - 1]);
275
+		$last_is_capital = preg_match('#^\p{Lu}#u', $last_word);
276
+		$last_is_abbreviation = mb_substr(Multibyte::trim($fragment), -1) === '.';
277
+
278
+		return $last_is_capital > 0
279
+			&& $last_is_abbreviation > 0
280
+			&& mb_strlen($last_word) <= 3;
281
+	}
282
+
283
+	/**
284
+	 * Merges any part starting with a closing parenthesis ')' to the previous
285
+	 * part.
286
+	 *
287
+	 * @param string[] $parts
288
+	 *
289
+	 * @return string[]
290
+	 */
291
+	private function parenthesesMerge($parts)
292
+	{
293
+		$subsentences = [];
294
+
295
+		foreach ($parts as $part) {
296
+			if ($part[0] === ')' && !empty($subsentences)) {
297
+				$subsentences[count($subsentences) - 1] .= $part;
298
+			} else {
299
+				$subsentences[] = $part;
300
+			}
301
+		}
302
+
303
+		return $subsentences;
304
+	}
305
+
306
+	/**
307
+	 * Looks for closing quotes to include them with the previous statement.
308
+	 * "That was very interesting," he said.
309
+	 * "That was very interesting."
310
+	 *
311
+	 * @param string[] $statements
312
+	 *
313
+	 * @return string[]
314
+	 */
315
+	private function closeQuotesMerge($statements)
316
+	{
317
+		$i = 0;
318
+		$previous_statement = '';
319
+		$return = [];
320
+		foreach ($statements as $statement) {
321
+			if (self::isEndQuote($statement)) {
322
+				$statement = $previous_statement . $statement;
323
+			} else {
324
+				$i++;
325
+			}
326
+
327
+			$return[$i] = $statement;
328
+			$previous_statement = $statement;
329
+		}
330
+
331
+		return $return;
332
+	}
333
+
334
+	/**
335
+	 * Check if the entire string is a quotation mark or quote, then space, then lowercase.
336
+	 *
337
+	 * @param $statement
338
+	 *
339
+	 * @return bool
340
+	 */
341
+	private static function isEndQuote($statement)
342
+	{
343
+		$trimmed = Multibyte::trim($statement);
344
+		$first = mb_substr($statement, 0, 1);
345
+
346
+		return in_array($trimmed, ['"', '\''])
347
+			|| (
348
+				in_array($first, ['"', '\''])
349
+				&& mb_substr($statement, 1, 1) === ' '
350
+				&& ctype_lower(mb_substr($statement, 2, 1)) === true
351
+			);
352
+	}
353
+
354
+	/**
355
+	 * Merges items into larger sentences.
356
+	 * Multibyte.php safe
357
+	 *
358
+	 * @param string[] $shorts
359
+	 *
360
+	 * @return string[]
361
+	 */
362
+	private function sentenceMerge($shorts)
363
+	{
364
+		$non_abbreviating_terminals = array_diff($this->terminals, $this->abbreviators);
365
+
366
+		$sentences = [];
367
+
368
+		$sentence = '';
369
+		$has_words = false;
370
+		$previous_word_ending = null;
371
+		foreach ($shorts as $short) {
372
+			$word_count = count(mb_split('\s+', Multibyte::trim($short)));
373
+			$after_non_abbreviating_terminal = in_array($previous_word_ending, $non_abbreviating_terminals);
374
+
375
+			if ($after_non_abbreviating_terminal
376
+				|| ($has_words && $word_count > 1)) {
377
+
378
+				$sentences[] = $sentence;
379
+
380
+				$sentence = '';
381
+				$has_words = false;
382
+			}
383
+
384
+			$has_words = $has_words
385
+				|| $word_count > 1;
386
+
387
+			$sentence .= $short;
388
+			$previous_word_ending = mb_substr($short, -1);
389
+		}
390
+
391
+		if (!empty($sentence)) {
392
+			$sentences[] = $sentence;
393
+		}
394
+
395
+		return $sentences;
396
+	}
397
+
398
+	/**
399
+	 * Return the sentences sentences detected in the provided text.
400
+	 * Set the Sentence::SPLIT_TRIM flag to trim whitespace.
401
+	 *
402
+	 * @param string  $text
403
+	 * @param integer $flags
404
+	 *
405
+	 * @return string[]
406
+	 */
407
+	public function split($text, $flags = 0, $pipeline = [])
408
+	{
409
+		if (empty($pipeline)) {
410
+			static $pipeline = [
411
+				'replaceFloatNumbers',
412
+				'punctuationSplit',
413
+				'parenthesesMerge', // also works after punctuationMerge or abbreviationMerge
414
+				'punctuationMerge',
415
+				'abbreviationMerge',
416
+				'closeQuotesMerge',
417
+				'sentenceMerge',
418
+				'restoreReplacements',
419
+			];
420
+		}
421
+
422
+		// clean funny quotes
423
+		$text = Multibyte::cleanUnicode($text);
424
+
425
+		// Split
426
+		$sentences = [];
427
+		foreach (self::linebreakSplit($text) as $input) {
428
+			if (Multibyte::trim($input) !== '') {
429
+				foreach ($pipeline as $method) {
430
+					$input = $this->$method($input);
431
+				}
432
+				$sentences = array_merge($sentences, $input);
433
+			}
434
+		}
435
+
436
+		// Post process
437
+		if ($flags & self::SPLIT_TRIM) {
438
+			return self::trimSentences($sentences);
439
+		}
440
+
441
+		return $sentences;
442
+	}
443
+
444
+	/**
445
+	 * Multibyte.php trim each string in an array.
446
+	 *
447
+	 * @param string[] $sentences
448
+	 *
449
+	 * @return string[]
450
+	 */
451
+	private static function trimSentences($sentences)
452
+	{
453
+		return array_map(function ($sentence) {
454
+			return Multibyte::trim($sentence);
455
+		}, $sentences);
456
+	}
457
+
458
+	/**
459
+	 * Return the number of sentences detected in the provided text.
460
+	 *
461
+	 * @param string $text
462
+	 *
463
+	 * @return integer
464
+	 */
465
+	public function count($text)
466
+	{
467
+		return count($this->split($text));
468
+	}
469 469
 
470 470
 }
Please login to merge, or discard this patch.