Passed
Push — master ( 89d9c2...d06d8f )
by Sebastian
02:25
created
src/Mailcode/Parser/Safeguard.php 1 patch
Indentation   +107 added lines, -107 removed lines patch added patch discarded remove patch
@@ -57,45 +57,45 @@  discard block
 block discarded – undo
57 57
     
58 58
     const ERROR_PLACEHOLDER_NOT_FOUND = 47804;
59 59
     
60
-   /**
61
-    * @var Mailcode_Parser
62
-    */
60
+    /**
61
+     * @var Mailcode_Parser
62
+     */
63 63
     protected $parser;
64 64
     
65
-   /**
66
-    * @var Mailcode_Collection
67
-    */
65
+    /**
66
+     * @var Mailcode_Collection
67
+     */
68 68
     protected $commands;
69 69
     
70
-   /**
71
-    * @var string
72
-    */
70
+    /**
71
+     * @var string
72
+     */
73 73
     protected $originalString;
74 74
     
75
-   /**
76
-    * @var Mailcode_Collection
77
-    */
75
+    /**
76
+     * @var Mailcode_Collection
77
+     */
78 78
     protected $collection;
79 79
     
80
-   /**
81
-    * Counter for the placeholders, global for all placeholders.
82
-    * @var integer
83
-    */
80
+    /**
81
+     * Counter for the placeholders, global for all placeholders.
82
+     * @var integer
83
+     */
84 84
     private static $counter = 0;
85 85
     
86
-   /**
87
-    * @var Mailcode_Parser_Safeguard_Placeholder[]
88
-    */
86
+    /**
87
+     * @var Mailcode_Parser_Safeguard_Placeholder[]
88
+     */
89 89
     protected $placeholders;
90 90
     
91
-   /**
92
-    * @var string
93
-    */
91
+    /**
92
+     * @var string
93
+     */
94 94
     protected $delimiter = '__';
95 95
     
96
-   /**
97
-    * @var string[]|NULL
98
-    */
96
+    /**
97
+     * @var string[]|NULL
98
+     */
99 99
     protected $placeholderStrings;
100 100
     
101 101
     public function __construct(Mailcode_Parser $parser, string $subject)
@@ -104,15 +104,15 @@  discard block
 block discarded – undo
104 104
         $this->originalString = $subject;
105 105
     }
106 106
     
107
-   /**
108
-    * Sets the delimiter character sequence used to prepend
109
-    * and append to the placeholders.
110
-    * 
111
-    * The delimiter's default is "__" (two underscores).
112
-    * 
113
-    * @param string $delimiter
114
-    * @return Mailcode_Parser_Safeguard
115
-    */
107
+    /**
108
+     * Sets the delimiter character sequence used to prepend
109
+     * and append to the placeholders.
110
+     * 
111
+     * The delimiter's default is "__" (two underscores).
112
+     * 
113
+     * @param string $delimiter
114
+     * @return Mailcode_Parser_Safeguard
115
+     */
116 116
     public function setDelimiter(string $delimiter) : Mailcode_Parser_Safeguard
117 117
     {
118 118
         if(empty($delimiter))
@@ -134,15 +134,15 @@  discard block
 block discarded – undo
134 134
         return $this->delimiter;
135 135
     }
136 136
     
137
-   /**
138
-    * Retrieves the safe string in which all commands have been replaced
139
-    * by placeholder strings.
140
-    * 
141
-    * @return string
142
-    * @throws Mailcode_Exception 
143
-    *
144
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
145
-    */
137
+    /**
138
+     * Retrieves the safe string in which all commands have been replaced
139
+     * by placeholder strings.
140
+     * 
141
+     * @return string
142
+     * @throws Mailcode_Exception 
143
+     *
144
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
145
+     */
146 146
     public function makeSafe() : string
147 147
     {
148 148
         $this->requireValidCollection();
@@ -152,10 +152,10 @@  discard block
 block discarded – undo
152 152
         return str_replace(array_values($replaces), array_keys($replaces), $this->originalString);
153 153
     }
154 154
     
155
-   /**
156
-    * @param bool $highlighted
157
-    * @return string[]string
158
-    */
155
+    /**
156
+     * @param bool $highlighted
157
+     * @return string[]string
158
+     */
159 159
     protected function getReplaces(bool $highlighted=false) : array
160 160
     {
161 161
         $placeholders = $this->getPlaceholders();
@@ -182,12 +182,12 @@  discard block
 block discarded – undo
182 182
     }
183 183
     
184 184
     
185
-   /**
186
-    * Retrieves all placeholders that have to be added to
187
-    * the subject text.
188
-    * 
189
-    * @return \Mailcode\Mailcode_Parser_Safeguard_Placeholder[]
190
-    */
185
+    /**
186
+     * Retrieves all placeholders that have to be added to
187
+     * the subject text.
188
+     * 
189
+     * @return \Mailcode\Mailcode_Parser_Safeguard_Placeholder[]
190
+     */
191 191
     public function getPlaceholders()
192 192
     {
193 193
         if(isset($this->placeholders))
@@ -239,46 +239,46 @@  discard block
 block discarded – undo
239 239
         return str_replace($placeholderStrings, array_values($replaces), $string);
240 240
     }
241 241
     
242
-   /**
243
-    * Makes the string whole again after transforming or filtering it,
244
-    * by replacing the command placeholders with the original commands.
245
-    *
246
-    * @param string $string
247
-    * @return string
248
-    * @throws Mailcode_Exception
249
-    *
250
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
251
-    * @see Mailcode_Parser_Safeguard::ERROR_COMMAND_PLACEHOLDER_MISSING
252
-    */
242
+    /**
243
+     * Makes the string whole again after transforming or filtering it,
244
+     * by replacing the command placeholders with the original commands.
245
+     *
246
+     * @param string $string
247
+     * @return string
248
+     * @throws Mailcode_Exception
249
+     *
250
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
251
+     * @see Mailcode_Parser_Safeguard::ERROR_COMMAND_PLACEHOLDER_MISSING
252
+     */
253 253
     public function makeWhole(string $string) : string
254 254
     {
255 255
         return $this->restore($string, false);
256 256
     }
257 257
 
258
-   /**
259
-    * Like makeWhole(), but replaces the commands with a syntax
260
-    * highlighted version, meant for human readable texts only.
261
-    * 
262
-    * Note: the commands lose their functionality (They cannot be 
263
-    * parsed from that string again).
264
-    *
265
-    * @param string $string
266
-    * @return string
267
-    * @throws Mailcode_Exception
268
-    *
269
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
270
-    * @see Mailcode_Parser_Safeguard::ERROR_COMMAND_PLACEHOLDER_MISSING
271
-    */
258
+    /**
259
+     * Like makeWhole(), but replaces the commands with a syntax
260
+     * highlighted version, meant for human readable texts only.
261
+     * 
262
+     * Note: the commands lose their functionality (They cannot be 
263
+     * parsed from that string again).
264
+     *
265
+     * @param string $string
266
+     * @return string
267
+     * @throws Mailcode_Exception
268
+     *
269
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
270
+     * @see Mailcode_Parser_Safeguard::ERROR_COMMAND_PLACEHOLDER_MISSING
271
+     */
272 272
     public function makeHighlighted(string $string) : string
273 273
     {
274 274
         return $this->restore($string, true);
275 275
     }
276 276
     
277
-   /**
278
-    * Retrieves the commands collection contained in the string.
279
-    * 
280
-    * @return Mailcode_Collection
281
-    */
277
+    /**
278
+     * Retrieves the commands collection contained in the string.
279
+     * 
280
+     * @return Mailcode_Collection
281
+     */
282 282
     public function getCollection() : Mailcode_Collection
283 283
     {
284 284
         if(isset($this->collection))
@@ -296,11 +296,11 @@  discard block
 block discarded – undo
296 296
         return $this->getCollection()->isValid();
297 297
     }
298 298
     
299
-   /**
300
-    * @throws Mailcode_Exception
301
-    * 
302
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
303
-    */
299
+    /**
300
+     * @throws Mailcode_Exception
301
+     * 
302
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
303
+     */
304 304
     protected function requireValidCollection() : void
305 305
     {
306 306
         if($this->getCollection()->isValid())
@@ -318,11 +318,11 @@  discard block
 block discarded – undo
318 318
         );
319 319
     }
320 320
     
321
-   /**
322
-    * Retrieves a list of all placeholder IDs used in the text.
323
-    * 
324
-    * @return string[]
325
-    */
321
+    /**
322
+     * Retrieves a list of all placeholder IDs used in the text.
323
+     * 
324
+     * @return string[]
325
+     */
326 326
     public function getPlaceholderStrings() : array
327 327
     {
328 328
         if(isset($this->placeholderStrings))
@@ -349,13 +349,13 @@  discard block
 block discarded – undo
349 349
         return in_array($subject, $ids);
350 350
     }
351 351
     
352
-   /**
353
-    * Retrieves a placeholder instance by its ID.
354
-    * 
355
-    * @param int $id
356
-    * @throws Mailcode_Exception If the placeholder was not found.
357
-    * @return Mailcode_Parser_Safeguard_Placeholder
358
-    */
352
+    /**
353
+     * Retrieves a placeholder instance by its ID.
354
+     * 
355
+     * @param int $id
356
+     * @throws Mailcode_Exception If the placeholder was not found.
357
+     * @return Mailcode_Parser_Safeguard_Placeholder
358
+     */
359 359
     public function getPlaceholderByID(int $id) : Mailcode_Parser_Safeguard_Placeholder
360 360
     {
361 361
         $placeholders = $this->getPlaceholders();
@@ -378,13 +378,13 @@  discard block
 block discarded – undo
378 378
         );
379 379
     }
380 380
     
381
-   /**
382
-    * Retrieves a placeholder instance by its replacement text.
383
-    * 
384
-    * @param string $string
385
-    * @throws Mailcode_Exception
386
-    * @return Mailcode_Parser_Safeguard_Placeholder
387
-    */
381
+    /**
382
+     * Retrieves a placeholder instance by its replacement text.
383
+     * 
384
+     * @param string $string
385
+     * @throws Mailcode_Exception
386
+     * @return Mailcode_Parser_Safeguard_Placeholder
387
+     */
388 388
     public function getPlaceholderByString(string $string) : Mailcode_Parser_Safeguard_Placeholder
389 389
     {
390 390
         $placeholders = $this->getPlaceholders();
Please login to merge, or discard this patch.