Passed
Push — master ( 66cd23...caf38d )
by Sebastian
19:58
created
src/Mailcode.php 1 patch
Indentation   +27 added lines, -27 removed lines patch added patch discarded remove patch
@@ -26,41 +26,41 @@  discard block
 block discarded – undo
26 26
  */
27 27
 class Mailcode
28 28
 {
29
-   /**
30
-    * @var Mailcode_Parser|NULL
31
-    */
29
+    /**
30
+     * @var Mailcode_Parser|NULL
31
+     */
32 32
     protected $parser = null;
33 33
     
34
-   /**
35
-    * @var Mailcode_Commands|NULL
36
-    */
34
+    /**
35
+     * @var Mailcode_Commands|NULL
36
+     */
37 37
     protected $commands = null;
38 38
     
39
-   /**
40
-    * Creates a new mailcode instance.
41
-    * @return Mailcode
42
-    */
39
+    /**
40
+     * Creates a new mailcode instance.
41
+     * @return Mailcode
42
+     */
43 43
     public static function create() : Mailcode
44 44
     {
45 45
         return new Mailcode();
46 46
     }
47 47
     
48
-   /**
49
-    * Parses the string to detect all commands contained within.
50
-    * 
51
-    * @param string $string
52
-    * @return Mailcode_Collection
53
-    */
48
+    /**
49
+     * Parses the string to detect all commands contained within.
50
+     * 
51
+     * @param string $string
52
+     * @return Mailcode_Collection
53
+     */
54 54
     public function parseString(string $string) : Mailcode_Collection
55 55
     {
56 56
         return $this->getParser()->parseString($string);
57 57
     }
58 58
     
59
-   /**
60
-    * Retrieves the string parser instance used to detect commands.
61
-    * 
62
-    * @return Mailcode_Parser
63
-    */
59
+    /**
60
+     * Retrieves the string parser instance used to detect commands.
61
+     * 
62
+     * @return Mailcode_Parser
63
+     */
64 64
     public function getParser() : Mailcode_Parser
65 65
     {
66 66
         if(!isset($this->parser)) 
@@ -71,12 +71,12 @@  discard block
 block discarded – undo
71 71
         return $this->parser;
72 72
     }
73 73
     
74
-   /**
75
-    * Retrieves the commands collection, which is used to
76
-    * access information on the available commands.
77
-    * 
78
-    * @return Mailcode_Commands
79
-    */
74
+    /**
75
+     * Retrieves the commands collection, which is used to
76
+     * access information on the available commands.
77
+     * 
78
+     * @return Mailcode_Commands
79
+     */
80 80
     public function getCommands() : Mailcode_Commands
81 81
     {
82 82
         if(!isset($this->commands)) 
Please login to merge, or discard this patch.
src/Mailcode/Commands.php 1 patch
Indentation   +36 added lines, -36 removed lines patch added patch discarded remove patch
@@ -23,16 +23,16 @@  discard block
 block discarded – undo
23 23
 {
24 24
     const ERROR_COMMAND_NAME_DOES_NOT_EXIST = 45901;
25 25
     
26
-   /**
27
-    * @var Mailcode_Commands_Command[]
28
-    */
26
+    /**
27
+     * @var Mailcode_Commands_Command[]
28
+     */
29 29
     private $commands = array();
30 30
     
31
-   /**
32
-    * Retrieves a list of all available command IDs.
33
-    * 
34
-    * @return string[]
35
-    */
31
+    /**
32
+     * Retrieves a list of all available command IDs.
33
+     * 
34
+     * @return string[]
35
+     */
36 36
     public function getIDs() : array
37 37
     {
38 38
         static $ids = array();
@@ -45,13 +45,13 @@  discard block
 block discarded – undo
45 45
         return $ids;
46 46
     }
47 47
     
48
-   /**
49
-    * Retrieves a list of all available commands, sorted by label.
50
-    * 
51
-    * NOTE: These instances are only used for information purposes.
52
-    * 
53
-    * @return Mailcode_Commands_Command[]
54
-    */
48
+    /**
49
+     * Retrieves a list of all available commands, sorted by label.
50
+     * 
51
+     * NOTE: These instances are only used for information purposes.
52
+     * 
53
+     * @return Mailcode_Commands_Command[]
54
+     */
55 55
     public function getAll()
56 56
     {
57 57
         if(!empty($this->commands)) {
@@ -77,12 +77,12 @@  discard block
 block discarded – undo
77 77
         return $result;
78 78
     }
79 79
     
80
-   /**
81
-    * Gets an available command by its ID.
82
-    * 
83
-    * @param string $id
84
-    * @return Mailcode_Commands_Command
85
-    */
80
+    /**
81
+     * Gets an available command by its ID.
82
+     * 
83
+     * @param string $id
84
+     * @return Mailcode_Commands_Command
85
+     */
86 86
     public function getByID(string $id) : Mailcode_Commands_Command
87 87
     {
88 88
         static $instances = array();
@@ -95,15 +95,15 @@  discard block
 block discarded – undo
95 95
         return $instances[$id];
96 96
     }
97 97
     
98
-   /**
99
-    * Retrieves the ID of a command by its name.
100
-    * 
101
-    * @param string $name
102
-    * @throws Mailcode_Exception
103
-    * @return string
104
-    * 
105
-    * @see Mailcode_Commands::ERROR_COMMAND_NAME_DOES_NOT_EXIST
106
-    */
98
+    /**
99
+     * Retrieves the ID of a command by its name.
100
+     * 
101
+     * @param string $name
102
+     * @throws Mailcode_Exception
103
+     * @return string
104
+     * 
105
+     * @see Mailcode_Commands::ERROR_COMMAND_NAME_DOES_NOT_EXIST
106
+     */
107 107
     public function getIDByName(string $name) : string
108 108
     {
109 109
         $items = $this->getAll();
@@ -132,12 +132,12 @@  discard block
 block discarded – undo
132 132
         return in_array($id, $ids);
133 133
     }
134 134
     
135
-   /**
136
-    * Checks wether the specified name exists.
137
-    * 
138
-    * @param string $name For example: "showvar".
139
-    * @return bool
140
-    */
135
+    /**
136
+     * Checks wether the specified name exists.
137
+     * 
138
+     * @param string $name For example: "showvar".
139
+     * @return bool
140
+     */
141 141
     public function nameExists(string $name) : bool
142 142
     {
143 143
         $items = $this->getAll();
Please login to merge, or discard this patch.
src/Mailcode/Collection.php 1 patch
Indentation   +28 added lines, -28 removed lines patch added patch discarded remove patch
@@ -20,9 +20,9 @@  discard block
 block discarded – undo
20 20
  */
21 21
 class Mailcode_Collection
22 22
 {
23
-   /**
24
-    * @var Mailcode_Commands_Command[]
25
-    */
23
+    /**
24
+     * @var Mailcode_Commands_Command[]
25
+     */
26 26
     protected $commands = array();
27 27
     
28 28
     /**
@@ -30,12 +30,12 @@  discard block
 block discarded – undo
30 30
      */
31 31
     protected $errors = array();
32 32
     
33
-   /**
34
-    * Adds a command to the collection.
35
-    * 
36
-    * @param Mailcode_Commands_Command $command
37
-    * @return Mailcode_Collection
38
-    */
33
+    /**
34
+     * Adds a command to the collection.
35
+     * 
36
+     * @param Mailcode_Commands_Command $command
37
+     * @return Mailcode_Collection
38
+     */
39 39
     public function addCommand(Mailcode_Commands_Command $command) : Mailcode_Collection
40 40
     {
41 41
         $hash = $command->getHash();
@@ -47,21 +47,21 @@  discard block
 block discarded – undo
47 47
         return $this;
48 48
     }
49 49
     
50
-   /**
51
-    * Whether there are any commands in the collection.
52
-    * 
53
-    * @return bool
54
-    */
50
+    /**
51
+     * Whether there are any commands in the collection.
52
+     * 
53
+     * @return bool
54
+     */
55 55
     public function hasCommands() : bool
56 56
     {
57 57
         return !empty($this->commands);
58 58
     }
59 59
     
60
-   /**
61
-    * Counts the amount of commands in the collection.
62
-    * 
63
-    * @return int
64
-    */
60
+    /**
61
+     * Counts the amount of commands in the collection.
62
+     * 
63
+     * @return int
64
+     */
65 65
     public function countCommands() : int
66 66
     {
67 67
         return count($this->commands);
@@ -81,9 +81,9 @@  discard block
 block discarded – undo
81 81
         $this->errors[] = new Mailcode_Collection_Error_Command($command);
82 82
     }
83 83
     
84
-   /**
85
-    * @return Mailcode_Collection_Error[]
86
-    */
84
+    /**
85
+     * @return Mailcode_Collection_Error[]
86
+     */
87 87
     public function getErrors()
88 88
     {
89 89
         return $this->errors;
@@ -94,13 +94,13 @@  discard block
 block discarded – undo
94 94
         return empty($this->errors);
95 95
     }
96 96
     
97
-   /**
98
-    * Retrieves all commands that were detected.
99
-    * 
100
-    * @return \Mailcode\Mailcode_Commands_Command[]
101
-    */
97
+    /**
98
+     * Retrieves all commands that were detected.
99
+     * 
100
+     * @return \Mailcode\Mailcode_Commands_Command[]
101
+     */
102 102
     public function getCommands()
103 103
     {
104
-       return $this->commands;
104
+        return $this->commands;
105 105
     }
106 106
 }
Please login to merge, or discard this patch.
src/Mailcode/Parser/Safeguard/Placeholder.php 1 patch
Indentation   +12 added lines, -12 removed lines patch added patch discarded remove patch
@@ -25,24 +25,24 @@
 block discarded – undo
25 25
 {
26 26
     const ERROR_PLACEHOLDER_TOO_LONG = 47901;
27 27
     
28
-   /**
29
-    * @var int
30
-    */
28
+    /**
29
+     * @var int
30
+     */
31 31
     protected $id;
32 32
     
33
-   /**
34
-    * @var Mailcode_Parser_Safeguard
35
-    */
33
+    /**
34
+     * @var Mailcode_Parser_Safeguard
35
+     */
36 36
     protected $safeguard;
37 37
 
38
-   /**
39
-    * @var Mailcode_Commands_Command
40
-    */
38
+    /**
39
+     * @var Mailcode_Commands_Command
40
+     */
41 41
     protected $command;
42 42
     
43
-   /**
44
-    * @var string
45
-    */
43
+    /**
44
+     * @var string
45
+     */
46 46
     protected $replacement = '';
47 47
     
48 48
     public function __construct(int $id, Mailcode_Commands_Command $command, Mailcode_Parser_Safeguard $safeguard)
Please login to merge, or discard this patch.
src/Mailcode/Commands/Command.php 1 patch
Indentation   +31 added lines, -31 removed lines patch added patch discarded remove patch
@@ -32,29 +32,29 @@  discard block
 block discarded – undo
32 32
     
33 33
     const VALIDATION_UNKNOWN_COMMAND_NAME = 4;
34 34
     
35
-   /**
36
-    * @var string
37
-    */
35
+    /**
36
+     * @var string
37
+     */
38 38
     protected $type = '';
39 39
 
40
-   /**
41
-    * @var string
42
-    */
40
+    /**
41
+     * @var string
42
+     */
43 43
     protected $paramsString = '';
44 44
     
45
-   /**
46
-    * @var string
47
-    */
45
+    /**
46
+     * @var string
47
+     */
48 48
     protected $matchedText = '';
49 49
 
50
-   /**
51
-    * @var string
52
-    */
50
+    /**
51
+     * @var string
52
+     */
53 53
     protected $hash = '';
54 54
     
55
-   /**
56
-    * @var \AppUtils\OperationResult
57
-    */
55
+    /**
56
+     * @var \AppUtils\OperationResult
57
+     */
58 58
     protected $validationResult = null;
59 59
     
60 60
     public function __construct(string $type='', string $paramsString='', string $matchedText='')
@@ -64,33 +64,33 @@  discard block
 block discarded – undo
64 64
         $this->matchedText = $matchedText;
65 65
     }
66 66
     
67
-   /**
68
-    * @return string The ID of the command = the name of the command class file.
69
-    */
67
+    /**
68
+     * @return string The ID of the command = the name of the command class file.
69
+     */
70 70
     public function getID() : string
71 71
     {
72 72
         $tokens = explode('_', get_class($this));
73 73
         return array_pop($tokens);
74 74
     }
75 75
     
76
-   /**
77
-    * Checks whether this is a dummy command, which is only
78
-    * used to access information on the command type. It cannot
79
-    * be used as an actual live command.
80
-    * 
81
-    * @return bool
82
-    */
76
+    /**
77
+     * Checks whether this is a dummy command, which is only
78
+     * used to access information on the command type. It cannot
79
+     * be used as an actual live command.
80
+     * 
81
+     * @return bool
82
+     */
83 83
     public function isDummy() : bool
84 84
     {
85 85
         return $this->type === '__dummy';
86 86
     }
87 87
     
88
-   /**
89
-    * Retrieves a hash of the actual matched command string,
90
-    * which is used in collections to detect duplicate commands.
91
-    * 
92
-    * @return string
93
-    */
88
+    /**
89
+     * Retrieves a hash of the actual matched command string,
90
+     * which is used in collections to detect duplicate commands.
91
+     * 
92
+     * @return string
93
+     */
94 94
     public function getHash() : string
95 95
     {
96 96
         $this->requireNonDummy();
Please login to merge, or discard this patch.
src/Mailcode/Parser.php 1 patch
Indentation   +43 added lines, -43 removed lines patch added patch discarded remove patch
@@ -26,14 +26,14 @@  discard block
 block discarded – undo
26 26
         '{\s*([a-z]+)\s+([a-z]+)\s*:([^}]+)}'
27 27
     );
28 28
     
29
-   /**
30
-    * @var Mailcode
31
-    */
29
+    /**
30
+     * @var Mailcode
31
+     */
32 32
     protected $mailcode;
33 33
     
34
-   /**
35
-    * @var Mailcode_Commands
36
-    */
34
+    /**
35
+     * @var Mailcode_Commands
36
+     */
37 37
     protected $commands;
38 38
     
39 39
     public function __construct(Mailcode $mailcode)
@@ -42,24 +42,24 @@  discard block
 block discarded – undo
42 42
         $this->commands = $this->mailcode->getCommands();
43 43
     }
44 44
     
45
-   /**
46
-    * Gets the regex format string used to detect commands.
47
-    * 
48
-    * @return string
49
-    */
45
+    /**
46
+     * Gets the regex format string used to detect commands.
47
+     * 
48
+     * @return string
49
+     */
50 50
     protected static function getRegex() : string
51 51
     {
52 52
         return '/'.implode('|', self::COMMAND_REGEX_PARTS).'/sixU';
53 53
     }
54 54
     
55
-   /**
56
-    * Parses a string to detect all commands within. Returns a
57
-    * collection instance that contains information on all the 
58
-    * commands.
59
-    * 
60
-    * @param string $string
61
-    * @return Mailcode_Collection A collection with all unique commands found.
62
-    */
55
+    /**
56
+     * Parses a string to detect all commands within. Returns a
57
+     * collection instance that contains information on all the 
58
+     * commands.
59
+     * 
60
+     * @param string $string
61
+     * @return Mailcode_Collection A collection with all unique commands found.
62
+     */
63 63
     public function parseString(string $string) : Mailcode_Collection
64 64
     {
65 65
         $collection = new Mailcode_Collection();
@@ -79,14 +79,14 @@  discard block
 block discarded – undo
79 79
         return $collection;
80 80
     }
81 81
     
82
-   /**
83
-    * Processes a single match found in the string: creates the command,
84
-    * and adds it to the collection if it's a valid command, or to the list
85
-    * of invalid commands otherwise.
86
-    * 
87
-    * @param Mailcode_Parser_Match $match
88
-    * @param Mailcode_Collection $collection
89
-    */
82
+    /**
83
+     * Processes a single match found in the string: creates the command,
84
+     * and adds it to the collection if it's a valid command, or to the list
85
+     * of invalid commands otherwise.
86
+     * 
87
+     * @param Mailcode_Parser_Match $match
88
+     * @param Mailcode_Collection $collection
89
+     */
90 90
     protected function processMatch(Mailcode_Parser_Match $match, Mailcode_Collection $collection) : void
91 91
     {
92 92
         $name = $match->getName();
@@ -117,14 +117,14 @@  discard block
 block discarded – undo
117 117
         $collection->addInvalidCommand($cmd);
118 118
     }
119 119
     
120
-   /**
121
-    * Parses a single regex match: determines which named group
122
-    * matches, and retrieves the according information.
123
-    * 
124
-    * @param array $matches The regex results array.
125
-    * @param int $index The matched index.
126
-    * @return Mailcode_Parser_Match
127
-    */
120
+    /**
121
+     * Parses a single regex match: determines which named group
122
+     * matches, and retrieves the according information.
123
+     * 
124
+     * @param array $matches The regex results array.
125
+     * @param int $index The matched index.
126
+     * @return Mailcode_Parser_Match
127
+     */
128 128
     protected function parseMatch(array $matches, int $index) : Mailcode_Parser_Match
129 129
     {
130 130
         $name = ''; // the command name, e.g. "showvar"
@@ -162,14 +162,14 @@  discard block
 block discarded – undo
162 162
         );
163 163
     }
164 164
     
165
-   /**
166
-    * Creates an instance of the safeguard tool, which
167
-    * is used to safeguard commands in a string with placeholders.
168
-    * 
169
-    * @param string $subject The string to use to safeguard commands in.
170
-    * @return Mailcode_Parser_Safeguard
171
-    * @see Mailcode_Parser_Safeguard
172
-    */
165
+    /**
166
+     * Creates an instance of the safeguard tool, which
167
+     * is used to safeguard commands in a string with placeholders.
168
+     * 
169
+     * @param string $subject The string to use to safeguard commands in.
170
+     * @return Mailcode_Parser_Safeguard
171
+     * @see Mailcode_Parser_Safeguard
172
+     */
173 173
     public function createSafeguard(string $subject) : Mailcode_Parser_Safeguard
174 174
     {
175 175
         return new Mailcode_Parser_Safeguard($this, $subject);
Please login to merge, or discard this patch.
src/Mailcode/Parser/Safeguard.php 1 patch
Indentation   +67 added lines, -67 removed lines patch added patch discarded remove patch
@@ -55,40 +55,40 @@  discard block
 block discarded – undo
55 55
     
56 56
     const ERROR_EMPTY_DELIMITER = 47803;
57 57
     
58
-   /**
59
-    * @var Mailcode_Parser
60
-    */
58
+    /**
59
+     * @var Mailcode_Parser
60
+     */
61 61
     protected $parser;
62 62
     
63
-   /**
64
-    * @var Mailcode_Collection
65
-    */
63
+    /**
64
+     * @var Mailcode_Collection
65
+     */
66 66
     protected $commands;
67 67
     
68
-   /**
69
-    * @var string
70
-    */
68
+    /**
69
+     * @var string
70
+     */
71 71
     protected $originalString;
72 72
     
73
-   /**
74
-    * @var Mailcode_Collection
75
-    */
73
+    /**
74
+     * @var Mailcode_Collection
75
+     */
76 76
     protected $collection;
77 77
     
78
-   /**
79
-    * Counter for the placeholders, global for all placeholders.
80
-    * @var integer
81
-    */
78
+    /**
79
+     * Counter for the placeholders, global for all placeholders.
80
+     * @var integer
81
+     */
82 82
     private static $counter = 0;
83 83
     
84
-   /**
85
-    * @var Mailcode_Parser_Safeguard_Placeholder[]
86
-    */
84
+    /**
85
+     * @var Mailcode_Parser_Safeguard_Placeholder[]
86
+     */
87 87
     protected $placeholders;
88 88
     
89
-   /**
90
-    * @var string
91
-    */
89
+    /**
90
+     * @var string
91
+     */
92 92
     protected $delimiter = '__';
93 93
     
94 94
     public function __construct(Mailcode_Parser $parser, string $subject)
@@ -97,15 +97,15 @@  discard block
 block discarded – undo
97 97
         $this->originalString = $subject;
98 98
     }
99 99
     
100
-   /**
101
-    * Sets the delimiter character sequence used to prepend
102
-    * and append to the placeholders.
103
-    * 
104
-    * The delimiter's default is "__" (two underscores).
105
-    * 
106
-    * @param string $delimiter
107
-    * @return Mailcode_Parser_Safeguard
108
-    */
100
+    /**
101
+     * Sets the delimiter character sequence used to prepend
102
+     * and append to the placeholders.
103
+     * 
104
+     * The delimiter's default is "__" (two underscores).
105
+     * 
106
+     * @param string $delimiter
107
+     * @return Mailcode_Parser_Safeguard
108
+     */
109 109
     public function setDelimiter(string $delimiter) : Mailcode_Parser_Safeguard
110 110
     {
111 111
         if(empty($delimiter))
@@ -127,15 +127,15 @@  discard block
 block discarded – undo
127 127
         return $this->delimiter;
128 128
     }
129 129
     
130
-   /**
131
-    * Retrieves the safe string in which all commands have been replaced
132
-    * by placeholder strings.
133
-    * 
134
-    * @return string
135
-    * @throws Mailcode_Exception 
136
-    *
137
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
138
-    */
130
+    /**
131
+     * Retrieves the safe string in which all commands have been replaced
132
+     * by placeholder strings.
133
+     * 
134
+     * @return string
135
+     * @throws Mailcode_Exception 
136
+     *
137
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
138
+     */
139 139
     public function makeSafe() : string
140 140
     {
141 141
         $this->requireValidCollection();
@@ -160,12 +160,12 @@  discard block
 block discarded – undo
160 160
     }
161 161
     
162 162
     
163
-   /**
164
-    * Retrieves all placeholders that have to be added to
165
-    * the subject text.
166
-    * 
167
-    * @return \Mailcode\Mailcode_Parser_Safeguard_Placeholder[]
168
-    */
163
+    /**
164
+     * Retrieves all placeholders that have to be added to
165
+     * the subject text.
166
+     * 
167
+     * @return \Mailcode\Mailcode_Parser_Safeguard_Placeholder[]
168
+     */
169 169
     public function getPlaceholders()
170 170
     {
171 171
         if(isset($this->placeholders))
@@ -191,17 +191,17 @@  discard block
 block discarded – undo
191 191
         return $this->placeholders;
192 192
     }
193 193
     
194
-   /**
195
-    * Makes the string whole again after transforming or filtering it,
196
-    * by replacing the command placeholders with the original commands.
197
-    * 
198
-    * @param string $string
199
-    * @return string
200
-    * @throws Mailcode_Exception 
201
-    *
202
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
203
-    * @see Mailcode_Parser_Safeguard::ERROR_COMMAND_PLACEHOLDER_MISSING
204
-    */
194
+    /**
195
+     * Makes the string whole again after transforming or filtering it,
196
+     * by replacing the command placeholders with the original commands.
197
+     * 
198
+     * @param string $string
199
+     * @return string
200
+     * @throws Mailcode_Exception 
201
+     *
202
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
203
+     * @see Mailcode_Parser_Safeguard::ERROR_COMMAND_PLACEHOLDER_MISSING
204
+     */
205 205
     public function makeWhole(string $string) : string
206 206
     {
207 207
         $this->requireValidCollection();
@@ -228,11 +228,11 @@  discard block
 block discarded – undo
228 228
         return str_replace($placeholderStrings, array_values($replaces), $string);
229 229
     }
230 230
     
231
-   /**
232
-    * Retrieves the commands collection contained in the string.
233
-    * 
234
-    * @return Mailcode_Collection
235
-    */
231
+    /**
232
+     * Retrieves the commands collection contained in the string.
233
+     * 
234
+     * @return Mailcode_Collection
235
+     */
236 236
     public function getCollection() : Mailcode_Collection
237 237
     {
238 238
         if(isset($this->collection))
@@ -250,11 +250,11 @@  discard block
 block discarded – undo
250 250
         return $this->getCollection()->isValid();
251 251
     }
252 252
     
253
-   /**
254
-    * @throws Mailcode_Exception
255
-    * 
256
-    * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
257
-    */
253
+    /**
254
+     * @throws Mailcode_Exception
255
+     * 
256
+     * @see Mailcode_Parser_Safeguard::ERROR_INVALID_COMMANDS
257
+     */
258 258
     protected function requireValidCollection() : void
259 259
     {
260 260
         if($this->getCollection()->isValid())
Please login to merge, or discard this patch.