Passed
Push — master ( 272fc4...138b71 )
by Sebastian
04:04
created
src/Mailcode/Parser/Safeguard.php 1 patch
Indentation   +150 added lines, -150 removed lines patch added patch discarded remove patch
@@ -61,50 +61,50 @@  discard block
 block discarded – undo
61 61
     
62 62
     const ERROR_NOT_A_SINGLE_LINES_FORMATTER = 47806;
63 63
     
64
-   /**
65
-    * @var Mailcode_Parser
66
-    */
64
+    /**
65
+     * @var Mailcode_Parser
66
+     */
67 67
     protected $parser;
68 68
     
69
-   /**
70
-    * @var Mailcode_Collection
71
-    */
69
+    /**
70
+     * @var Mailcode_Collection
71
+     */
72 72
     protected $commands;
73 73
     
74
-   /**
75
-    * @var string
76
-    */
74
+    /**
75
+     * @var string
76
+     */
77 77
     protected $originalString;
78 78
     
79
-   /**
80
-    * @var Mailcode_Collection
81
-    */
79
+    /**
80
+     * @var Mailcode_Collection
81
+     */
82 82
     protected $collection;
83 83
     
84
-   /**
85
-    * Counter for the placeholders, global for all placeholders.
86
-    * @var integer
87
-    */
84
+    /**
85
+     * Counter for the placeholders, global for all placeholders.
86
+     * @var integer
87
+     */
88 88
     private static $counter = 0;
89 89
     
90
-   /**
91
-    * @var Mailcode_Parser_Safeguard_Placeholder[]
92
-    */
90
+    /**
91
+     * @var Mailcode_Parser_Safeguard_Placeholder[]
92
+     */
93 93
     protected $placeholders;
94 94
     
95
-   /**
96
-    * @var string
97
-    */
95
+    /**
96
+     * @var string
97
+     */
98 98
     protected $delimiter = '__';
99 99
     
100
-   /**
101
-    * @var string[]|NULL
102
-    */
100
+    /**
101
+     * @var string[]|NULL
102
+     */
103 103
     protected $placeholderStrings;
104 104
     
105
-   /**
106
-    * @var Mailcode_Parser_Safeguard_Formatter
107
-    */
105
+    /**
106
+     * @var Mailcode_Parser_Safeguard_Formatter
107
+     */
108 108
     protected $formatter;
109 109
     
110 110
     public function __construct(Mailcode_Parser $parser, string $subject)
@@ -113,25 +113,25 @@  discard block
 block discarded – undo
113 113
         $this->originalString = $subject;
114 114
     }
115 115
     
116
-   /**
117
-    * Retrieves the string the safeguard was created for.
118
-    * 
119
-    * @return string
120
-    */
116
+    /**
117
+     * Retrieves the string the safeguard was created for.
118
+     * 
119
+     * @return string
120
+     */
121 121
     public function getOriginalString() : string
122 122
     {
123 123
         return $this->originalString;
124 124
     }
125 125
     
126
-   /**
127
-    * Sets the delimiter character sequence used to prepend
128
-    * and append to the placeholders.
129
-    * 
130
-    * The delimiter's default is "__" (two underscores).
131
-    * 
132
-    * @param string $delimiter
133
-    * @return Mailcode_Parser_Safeguard
134
-    */
126
+    /**
127
+     * Sets the delimiter character sequence used to prepend
128
+     * and append to the placeholders.
129
+     * 
130
+     * The delimiter's default is "__" (two underscores).
131
+     * 
132
+     * @param string $delimiter
133
+     * @return Mailcode_Parser_Safeguard
134
+     */
135 135
     public function setDelimiter(string $delimiter) : Mailcode_Parser_Safeguard
136 136
     {
137 137
         if(empty($delimiter))
@@ -153,15 +153,15 @@  discard block
 block discarded – undo
153 153
         return $this->delimiter;
154 154
     }
155 155
     
156
-   /**
157
-    * Retrieves the safe string in which all commands have been replaced
158
-    * by placeholder strings.
159
-    *
160
-    * @return string
161
-    * @throws Mailcode_Exception 
162
-    *
163
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
164
-    */
156
+    /**
157
+     * Retrieves the safe string in which all commands have been replaced
158
+     * by placeholder strings.
159
+     *
160
+     * @return string
161
+     * @throws Mailcode_Exception 
162
+     *
163
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
164
+     */
165 165
     public function makeSafe() : string
166 166
     {
167 167
         $this->requireValidCollection();
@@ -169,16 +169,16 @@  discard block
 block discarded – undo
169 169
         return $this->makeSafePartial();
170 170
     }
171 171
     
172
-   /**
173
-    * Like makeSafe(), but allows partial (invalid) commands: use this
174
-    * if the subject string may contain only part of the whole set of
175
-    * commands. 
176
-    * 
177
-    * Example: parsing a text with an opening if statement, without the 
178
-    * matching end statement.
179
-    * 
180
-    * @return string
181
-    */
172
+    /**
173
+     * Like makeSafe(), but allows partial (invalid) commands: use this
174
+     * if the subject string may contain only part of the whole set of
175
+     * commands. 
176
+     * 
177
+     * Example: parsing a text with an opening if statement, without the 
178
+     * matching end statement.
179
+     * 
180
+     * @return string
181
+     */
182 182
     public function makeSafePartial() : string
183 183
     {
184 184
         $replaces = $this->getReplaces();
@@ -216,10 +216,10 @@  discard block
 block discarded – undo
216 216
         );
217 217
     }
218 218
     
219
-   /**
220
-    * Enables the formatter that ensures that all commands that
221
-    * @return Mailcode_Parser_Safeguard_Formatter_SingleLines
222
-    */
219
+    /**
220
+     * Enables the formatter that ensures that all commands that
221
+     * @return Mailcode_Parser_Safeguard_Formatter_SingleLines
222
+     */
223 223
     public function selectSingleLinesFormatter() : Mailcode_Parser_Safeguard_Formatter_SingleLines
224 224
     {
225 225
         $formatter = $this->selectFormatter('SingleLines');
@@ -239,13 +239,13 @@  discard block
 block discarded – undo
239 239
         );
240 240
     }
241 241
     
242
-   /**
243
-    * Retrieves an associative array with pairs of
244
-    * [placeholder string => replacement text]. 
245
-    * 
246
-    * @param bool $highlighted
247
-    * @return string[]string
248
-    */
242
+    /**
243
+     * Retrieves an associative array with pairs of
244
+     * [placeholder string => replacement text]. 
245
+     * 
246
+     * @param bool $highlighted
247
+     * @return string[]string
248
+     */
249 249
     protected function getReplaces(bool $highlighted=false) : array
250 250
     {
251 251
         $placeholders = $this->getPlaceholders();
@@ -272,12 +272,12 @@  discard block
 block discarded – undo
272 272
     }
273 273
     
274 274
     
275
-   /**
276
-    * Retrieves all placeholders that have to be added to
277
-    * the subject text.
278
-    * 
279
-    * @return \Mailcode\Mailcode_Parser_Safeguard_Placeholder[]
280
-    */
275
+    /**
276
+     * Retrieves all placeholders that have to be added to
277
+     * the subject text.
278
+     * 
279
+     * @return \Mailcode\Mailcode_Parser_Safeguard_Placeholder[]
280
+     */
281 281
     public function getPlaceholders()
282 282
     {
283 283
         if(isset($this->placeholders))
@@ -329,17 +329,17 @@  discard block
 block discarded – undo
329 329
         return str_replace($placeholderStrings, array_values($replaces), $string);
330 330
     }
331 331
     
332
-   /**
333
-    * Makes the string whole again after transforming or filtering it,
334
-    * by replacing the command placeholders with the original commands.
335
-    *
336
-    * @param string $string
337
-    * @return string
338
-    * @throws Mailcode_Exception
339
-    *
340
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
341
-    * @see Mailcode_Parser_Safeguard::ERROR_COMMAND_PLACEHOLDER_MISSING
342
-    */
332
+    /**
333
+     * Makes the string whole again after transforming or filtering it,
334
+     * by replacing the command placeholders with the original commands.
335
+     *
336
+     * @param string $string
337
+     * @return string
338
+     * @throws Mailcode_Exception
339
+     *
340
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
341
+     * @see Mailcode_Parser_Safeguard::ERROR_COMMAND_PLACEHOLDER_MISSING
342
+     */
343 343
     public function makeWhole(string $string) : string
344 344
     {
345 345
         return $this->restore(
@@ -349,15 +349,15 @@  discard block
 block discarded – undo
349 349
         );
350 350
     }
351 351
     
352
-   /**
353
-    * Like `makeWhole()`, but ignores missing command placeholders.
354
-    *
355
-    * @param string $string
356
-    * @return string
357
-    * @throws Mailcode_Exception
358
-    *
359
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
360
-    */
352
+    /**
353
+     * Like `makeWhole()`, but ignores missing command placeholders.
354
+     *
355
+     * @param string $string
356
+     * @return string
357
+     * @throws Mailcode_Exception
358
+     *
359
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
360
+     */
361 361
     public function makeWholePartial(string $string) : string
362 362
     {
363 363
         return $this->restore(
@@ -367,20 +367,20 @@  discard block
 block discarded – undo
367 367
         );
368 368
     }
369 369
 
370
-   /**
371
-    * Like `makeWhole()`, but replaces the commands with a syntax
372
-    * highlighted version, meant for human readable texts only.
373
-    * 
374
-    * Note: the commands lose their functionality (They cannot be 
375
-    * parsed from that string again).
376
-    *
377
-    * @param string $string
378
-    * @return string
379
-    * @throws Mailcode_Exception
380
-    *
381
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
382
-    * @see Mailcode_Parser_Safeguard::ERROR_COMMAND_PLACEHOLDER_MISSING
383
-    */
370
+    /**
371
+     * Like `makeWhole()`, but replaces the commands with a syntax
372
+     * highlighted version, meant for human readable texts only.
373
+     * 
374
+     * Note: the commands lose their functionality (They cannot be 
375
+     * parsed from that string again).
376
+     *
377
+     * @param string $string
378
+     * @return string
379
+     * @throws Mailcode_Exception
380
+     *
381
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
382
+     * @see Mailcode_Parser_Safeguard::ERROR_COMMAND_PLACEHOLDER_MISSING
383
+     */
384 384
     public function makeHighlighted(string $string) : string
385 385
     {
386 386
         return $this->restore(
@@ -390,15 +390,15 @@  discard block
 block discarded – undo
390 390
         );
391 391
     }
392 392
     
393
-   /**
394
-    * Like `makeHighlighted()`, but ignores missing command placeholders.
395
-    * 
396
-    * @param string $string
397
-    * @return string
398
-    * @throws Mailcode_Exception
399
-    *
400
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
401
-    */
393
+    /**
394
+     * Like `makeHighlighted()`, but ignores missing command placeholders.
395
+     * 
396
+     * @param string $string
397
+     * @return string
398
+     * @throws Mailcode_Exception
399
+     *
400
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
401
+     */
402 402
     public function makeHighlightedPartial(string $string) : string
403 403
     {
404 404
         return $this->restore(
@@ -408,11 +408,11 @@  discard block
 block discarded – undo
408 408
         );
409 409
     }
410 410
     
411
-   /**
412
-    * Retrieves the commands collection contained in the string.
413
-    * 
414
-    * @return Mailcode_Collection
415
-    */
411
+    /**
412
+     * Retrieves the commands collection contained in the string.
413
+     * 
414
+     * @return Mailcode_Collection
415
+     */
416 416
     public function getCollection() : Mailcode_Collection
417 417
     {
418 418
         if(isset($this->collection))
@@ -430,11 +430,11 @@  discard block
 block discarded – undo
430 430
         return $this->getCollection()->isValid();
431 431
     }
432 432
     
433
-   /**
434
-    * @throws Mailcode_Exception
435
-    * 
436
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
437
-    */
433
+    /**
434
+     * @throws Mailcode_Exception
435
+     * 
436
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
437
+     */
438 438
     protected function requireValidCollection() : void
439 439
     {
440 440
         if($this->getCollection()->isValid())
@@ -453,11 +453,11 @@  discard block
 block discarded – undo
453 453
         );
454 454
     }
455 455
     
456
-   /**
457
-    * Retrieves a list of all placeholder IDs used in the text.
458
-    * 
459
-    * @return string[]
460
-    */
456
+    /**
457
+     * Retrieves a list of all placeholder IDs used in the text.
458
+     * 
459
+     * @return string[]
460
+     */
461 461
     public function getPlaceholderStrings() : array
462 462
     {
463 463
         if(is_array($this->placeholderStrings))
@@ -484,13 +484,13 @@  discard block
 block discarded – undo
484 484
         return in_array($subject, $ids);
485 485
     }
486 486
     
487
-   /**
488
-    * Retrieves a placeholder instance by its ID.
489
-    * 
490
-    * @param int $id
491
-    * @throws Mailcode_Exception If the placeholder was not found.
492
-    * @return Mailcode_Parser_Safeguard_Placeholder
493
-    */
487
+    /**
488
+     * Retrieves a placeholder instance by its ID.
489
+     * 
490
+     * @param int $id
491
+     * @throws Mailcode_Exception If the placeholder was not found.
492
+     * @return Mailcode_Parser_Safeguard_Placeholder
493
+     */
494 494
     public function getPlaceholderByID(int $id) : Mailcode_Parser_Safeguard_Placeholder
495 495
     {
496 496
         $placeholders = $this->getPlaceholders();
@@ -513,13 +513,13 @@  discard block
 block discarded – undo
513 513
         );
514 514
     }
515 515
     
516
-   /**
517
-    * Retrieves a placeholder instance by its replacement text.
518
-    * 
519
-    * @param string $string
520
-    * @throws Mailcode_Exception
521
-    * @return Mailcode_Parser_Safeguard_Placeholder
522
-    */
516
+    /**
517
+     * Retrieves a placeholder instance by its replacement text.
518
+     * 
519
+     * @param string $string
520
+     * @throws Mailcode_Exception
521
+     * @return Mailcode_Parser_Safeguard_Placeholder
522
+     */
523 523
     public function getPlaceholderByString(string $string) : Mailcode_Parser_Safeguard_Placeholder
524 524
     {
525 525
         $placeholders = $this->getPlaceholders();
Please login to merge, or discard this patch.