@@ -23,9 +23,9 @@ discard block |
||
| 23 | 23 | */ |
| 24 | 24 | trait Mailcode_Traits_Commands_IfNotEmpty |
| 25 | 25 | { |
| 26 | - /** |
|
| 27 | - * @var Mailcode_Parser_Statement_Tokenizer_Token_Variable|NULL |
|
| 28 | - */ |
|
| 26 | + /** |
|
| 27 | + * @var Mailcode_Parser_Statement_Tokenizer_Token_Variable|NULL |
|
| 28 | + */ |
|
| 29 | 29 | protected $variableToken; |
| 30 | 30 | |
| 31 | 31 | protected function getValidations() : array |
@@ -53,11 +53,11 @@ discard block |
||
| 53 | 53 | ); |
| 54 | 54 | } |
| 55 | 55 | |
| 56 | - /** |
|
| 57 | - * Retrieves the variable being compared. |
|
| 58 | - * |
|
| 59 | - * @return Mailcode_Variables_Variable |
|
| 60 | - */ |
|
| 56 | + /** |
|
| 57 | + * Retrieves the variable being compared. |
|
| 58 | + * |
|
| 59 | + * @return Mailcode_Variables_Variable |
|
| 60 | + */ |
|
| 61 | 61 | public function getVariable() : Mailcode_Variables_Variable |
| 62 | 62 | { |
| 63 | 63 | if($this->variableToken instanceof Mailcode_Parser_Statement_Tokenizer_Token_Variable) |
@@ -23,9 +23,9 @@ discard block |
||
| 23 | 23 | */ |
| 24 | 24 | trait Mailcode_Traits_Commands_IfEmpty |
| 25 | 25 | { |
| 26 | - /** |
|
| 27 | - * @var Mailcode_Parser_Statement_Tokenizer_Token_Variable|NULL |
|
| 28 | - */ |
|
| 26 | + /** |
|
| 27 | + * @var Mailcode_Parser_Statement_Tokenizer_Token_Variable|NULL |
|
| 28 | + */ |
|
| 29 | 29 | protected $variableToken; |
| 30 | 30 | |
| 31 | 31 | protected function getValidations() : array |
@@ -53,11 +53,11 @@ discard block |
||
| 53 | 53 | ); |
| 54 | 54 | } |
| 55 | 55 | |
| 56 | - /** |
|
| 57 | - * Retrieves the variable being compared. |
|
| 58 | - * |
|
| 59 | - * @return Mailcode_Variables_Variable |
|
| 60 | - */ |
|
| 56 | + /** |
|
| 57 | + * Retrieves the variable being compared. |
|
| 58 | + * |
|
| 59 | + * @return Mailcode_Variables_Variable |
|
| 60 | + */ |
|
| 61 | 61 | public function getVariable() : Mailcode_Variables_Variable |
| 62 | 62 | { |
| 63 | 63 | if($this->variableToken instanceof Mailcode_Parser_Statement_Tokenizer_Token_Variable) |
@@ -27,21 +27,21 @@ discard block |
||
| 27 | 27 | |
| 28 | 28 | const ERROR_INVALID_DUMMY_COMMAND_TYPE = 45903; |
| 29 | 29 | |
| 30 | - /** |
|
| 31 | - * @var Mailcode_Commands_Command[] |
|
| 32 | - */ |
|
| 30 | + /** |
|
| 31 | + * @var Mailcode_Commands_Command[] |
|
| 32 | + */ |
|
| 33 | 33 | private $commands = array(); |
| 34 | 34 | |
| 35 | - /** |
|
| 36 | - * @var string[]Mailcode_Commands_Command |
|
| 37 | - */ |
|
| 35 | + /** |
|
| 36 | + * @var string[]Mailcode_Commands_Command |
|
| 37 | + */ |
|
| 38 | 38 | private static $dummyCommands = array(); |
| 39 | 39 | |
| 40 | - /** |
|
| 41 | - * Retrieves a list of all available command IDs. |
|
| 42 | - * |
|
| 43 | - * @return string[] |
|
| 44 | - */ |
|
| 40 | + /** |
|
| 41 | + * Retrieves a list of all available command IDs. |
|
| 42 | + * |
|
| 43 | + * @return string[] |
|
| 44 | + */ |
|
| 45 | 45 | public function getIDs() : array |
| 46 | 46 | { |
| 47 | 47 | static $ids = array(); |
@@ -54,13 +54,13 @@ discard block |
||
| 54 | 54 | return $ids; |
| 55 | 55 | } |
| 56 | 56 | |
| 57 | - /** |
|
| 58 | - * Retrieves a list of all available commands, sorted by label. |
|
| 59 | - * |
|
| 60 | - * NOTE: These instances are only used for information purposes. |
|
| 61 | - * |
|
| 62 | - * @return Mailcode_Commands_Command[] |
|
| 63 | - */ |
|
| 57 | + /** |
|
| 58 | + * Retrieves a list of all available commands, sorted by label. |
|
| 59 | + * |
|
| 60 | + * NOTE: These instances are only used for information purposes. |
|
| 61 | + * |
|
| 62 | + * @return Mailcode_Commands_Command[] |
|
| 63 | + */ |
|
| 64 | 64 | public function getAll() |
| 65 | 65 | { |
| 66 | 66 | if(!empty($this->commands)) { |
@@ -86,12 +86,12 @@ discard block |
||
| 86 | 86 | return $result; |
| 87 | 87 | } |
| 88 | 88 | |
| 89 | - /** |
|
| 90 | - * Gets an available command by its ID. |
|
| 91 | - * |
|
| 92 | - * @param string $id |
|
| 93 | - * @return Mailcode_Commands_Command |
|
| 94 | - */ |
|
| 89 | + /** |
|
| 90 | + * Gets an available command by its ID. |
|
| 91 | + * |
|
| 92 | + * @param string $id |
|
| 93 | + * @return Mailcode_Commands_Command |
|
| 94 | + */ |
|
| 95 | 95 | public function getByID(string $id) : Mailcode_Commands_Command |
| 96 | 96 | { |
| 97 | 97 | static $instances = array(); |
@@ -104,15 +104,15 @@ discard block |
||
| 104 | 104 | return $instances[$id]; |
| 105 | 105 | } |
| 106 | 106 | |
| 107 | - /** |
|
| 108 | - * Retrieves the ID of a command by its name. |
|
| 109 | - * |
|
| 110 | - * @param string $name |
|
| 111 | - * @throws Mailcode_Exception |
|
| 112 | - * @return string |
|
| 113 | - * |
|
| 114 | - * @see Mailcode_Commands::ERROR_COMMAND_NAME_DOES_NOT_EXIST |
|
| 115 | - */ |
|
| 107 | + /** |
|
| 108 | + * Retrieves the ID of a command by its name. |
|
| 109 | + * |
|
| 110 | + * @param string $name |
|
| 111 | + * @throws Mailcode_Exception |
|
| 112 | + * @return string |
|
| 113 | + * |
|
| 114 | + * @see Mailcode_Commands::ERROR_COMMAND_NAME_DOES_NOT_EXIST |
|
| 115 | + */ |
|
| 116 | 116 | public function getIDByName(string $name) : string |
| 117 | 117 | { |
| 118 | 118 | $items = $this->getAll(); |
@@ -141,12 +141,12 @@ discard block |
||
| 141 | 141 | return in_array($id, $ids); |
| 142 | 142 | } |
| 143 | 143 | |
| 144 | - /** |
|
| 145 | - * Checks wether the specified name exists. |
|
| 146 | - * |
|
| 147 | - * @param string $name For example: "showvar". |
|
| 148 | - * @return bool |
|
| 149 | - */ |
|
| 144 | + /** |
|
| 145 | + * Checks wether the specified name exists. |
|
| 146 | + * |
|
| 147 | + * @param string $name For example: "showvar". |
|
| 148 | + * @return bool |
|
| 149 | + */ |
|
| 150 | 150 | public function nameExists(string $name) : bool |
| 151 | 151 | { |
| 152 | 152 | $items = $this->getAll(); |
@@ -200,14 +200,14 @@ discard block |
||
| 200 | 200 | return $class; |
| 201 | 201 | } |
| 202 | 202 | |
| 203 | - /** |
|
| 204 | - * Translates the command type to the expected class naming scheme. |
|
| 205 | - * |
|
| 206 | - * Example: not-empty => NotEmpty |
|
| 207 | - * |
|
| 208 | - * @param string $type |
|
| 209 | - * @return string |
|
| 210 | - */ |
|
| 203 | + /** |
|
| 204 | + * Translates the command type to the expected class naming scheme. |
|
| 205 | + * |
|
| 206 | + * Example: not-empty => NotEmpty |
|
| 207 | + * |
|
| 208 | + * @param string $type |
|
| 209 | + * @return string |
|
| 210 | + */ |
|
| 211 | 211 | private function adjustTypeName(string $type) : string |
| 212 | 212 | { |
| 213 | 213 | $type = str_replace('-', ' ', $type); |
@@ -217,13 +217,13 @@ discard block |
||
| 217 | 217 | return $type; |
| 218 | 218 | } |
| 219 | 219 | |
| 220 | - /** |
|
| 221 | - * Retrieves the dummy command of the specified type, which |
|
| 222 | - * is used to retrieve information on the command's capabilities. |
|
| 223 | - * |
|
| 224 | - * @param string $id |
|
| 225 | - * @return Mailcode_Commands_Command |
|
| 226 | - */ |
|
| 220 | + /** |
|
| 221 | + * Retrieves the dummy command of the specified type, which |
|
| 222 | + * is used to retrieve information on the command's capabilities. |
|
| 223 | + * |
|
| 224 | + * @param string $id |
|
| 225 | + * @return Mailcode_Commands_Command |
|
| 226 | + */ |
|
| 227 | 227 | private function getDummyCommand(string $id) : Mailcode_Commands_Command |
| 228 | 228 | { |
| 229 | 229 | if(!isset(self::$dummyCommands[$id])) |
@@ -20,9 +20,9 @@ |
||
| 20 | 20 | */ |
| 21 | 21 | abstract class Mailcode_Factory_CommandSets_Set |
| 22 | 22 | { |
| 23 | - /** |
|
| 24 | - * @var Mailcode_Factory_Instantiator |
|
| 25 | - */ |
|
| 23 | + /** |
|
| 24 | + * @var Mailcode_Factory_Instantiator |
|
| 25 | + */ |
|
| 26 | 26 | protected $instantiator; |
| 27 | 27 | |
| 28 | 28 | public function __construct() |
@@ -35,14 +35,14 @@ |
||
| 35 | 35 | */ |
| 36 | 36 | private $misc; |
| 37 | 37 | |
| 38 | - /** |
|
| 39 | - * @var Mailcode_Factory_CommandSets_Set_Set |
|
| 40 | - */ |
|
| 38 | + /** |
|
| 39 | + * @var Mailcode_Factory_CommandSets_Set_Set |
|
| 40 | + */ |
|
| 41 | 41 | private $set; |
| 42 | 42 | |
| 43 | - /** |
|
| 44 | - * @var Mailcode_Factory_CommandSets_Set_ElseIf |
|
| 45 | - */ |
|
| 43 | + /** |
|
| 44 | + * @var Mailcode_Factory_CommandSets_Set_ElseIf |
|
| 45 | + */ |
|
| 46 | 46 | private $elseIf; |
| 47 | 47 | |
| 48 | 48 | public function if() : Mailcode_Factory_CommandSets_Set_If |
@@ -32,44 +32,44 @@ discard block |
||
| 32 | 32 | const VALIDATION_UNKNOWN_COMMAND_NAME = 48304; |
| 33 | 33 | const VALIDATION_INVALID_PARAMS_STATEMENT = 48305; |
| 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 | - /** |
|
| 61 | - * @var \Mailcode\Mailcode |
|
| 62 | - */ |
|
| 60 | + /** |
|
| 61 | + * @var \Mailcode\Mailcode |
|
| 62 | + */ |
|
| 63 | 63 | protected $mailcode; |
| 64 | 64 | |
| 65 | - /** |
|
| 66 | - * @var \Mailcode\Mailcode_Parser_Statement |
|
| 67 | - */ |
|
| 65 | + /** |
|
| 66 | + * @var \Mailcode\Mailcode_Parser_Statement |
|
| 67 | + */ |
|
| 68 | 68 | protected $params; |
| 69 | 69 | |
| 70 | - /** |
|
| 71 | - * @var string[] |
|
| 72 | - */ |
|
| 70 | + /** |
|
| 71 | + * @var string[] |
|
| 72 | + */ |
|
| 73 | 73 | protected $validations = array( |
| 74 | 74 | 'params_empty', |
| 75 | 75 | 'params_keywords', |
@@ -78,14 +78,14 @@ discard block |
||
| 78 | 78 | 'type_unsupported' |
| 79 | 79 | ); |
| 80 | 80 | |
| 81 | - /** |
|
| 82 | - * @var string |
|
| 83 | - */ |
|
| 81 | + /** |
|
| 82 | + * @var string |
|
| 83 | + */ |
|
| 84 | 84 | protected $comment = ''; |
| 85 | 85 | |
| 86 | - /** |
|
| 87 | - * @var Mailcode_Commands_LogicKeywords|NULL |
|
| 88 | - */ |
|
| 86 | + /** |
|
| 87 | + * @var Mailcode_Commands_LogicKeywords|NULL |
|
| 88 | + */ |
|
| 89 | 89 | protected $logicKeywords; |
| 90 | 90 | |
| 91 | 91 | public function __construct(string $type='', string $paramsString='', string $matchedText='') |
@@ -103,9 +103,9 @@ discard block |
||
| 103 | 103 | |
| 104 | 104 | } |
| 105 | 105 | |
| 106 | - /** |
|
| 107 | - * @return string The ID of the command = the name of the command class file. |
|
| 108 | - */ |
|
| 106 | + /** |
|
| 107 | + * @return string The ID of the command = the name of the command class file. |
|
| 108 | + */ |
|
| 109 | 109 | public function getID() : string |
| 110 | 110 | { |
| 111 | 111 | // account for commands with types: If_Variable should still return If. |
@@ -114,14 +114,14 @@ discard block |
||
| 114 | 114 | return array_shift($tokens); |
| 115 | 115 | } |
| 116 | 116 | |
| 117 | - /** |
|
| 118 | - * Sets an optional comment that is not used anywhere, but |
|
| 119 | - * can be used by the application to track why a command is |
|
| 120 | - * used somewhere. |
|
| 121 | - * |
|
| 122 | - * @param string $comment |
|
| 123 | - * @return Mailcode_Commands_Command |
|
| 124 | - */ |
|
| 117 | + /** |
|
| 118 | + * Sets an optional comment that is not used anywhere, but |
|
| 119 | + * can be used by the application to track why a command is |
|
| 120 | + * used somewhere. |
|
| 121 | + * |
|
| 122 | + * @param string $comment |
|
| 123 | + * @return Mailcode_Commands_Command |
|
| 124 | + */ |
|
| 125 | 125 | public function setComment(string $comment) : Mailcode_Commands_Command |
| 126 | 126 | { |
| 127 | 127 | $this->comment = $comment; |
@@ -129,34 +129,34 @@ discard block |
||
| 129 | 129 | return $this; |
| 130 | 130 | } |
| 131 | 131 | |
| 132 | - /** |
|
| 133 | - * Retrieves the previously set comment, if any. |
|
| 134 | - * |
|
| 135 | - * @return string |
|
| 136 | - */ |
|
| 132 | + /** |
|
| 133 | + * Retrieves the previously set comment, if any. |
|
| 134 | + * |
|
| 135 | + * @return string |
|
| 136 | + */ |
|
| 137 | 137 | public function getComment() : string |
| 138 | 138 | { |
| 139 | 139 | return $this->comment; |
| 140 | 140 | } |
| 141 | 141 | |
| 142 | - /** |
|
| 143 | - * Checks whether this is a dummy command, which is only |
|
| 144 | - * used to access information on the command type. It cannot |
|
| 145 | - * be used as an actual live command. |
|
| 146 | - * |
|
| 147 | - * @return bool |
|
| 148 | - */ |
|
| 142 | + /** |
|
| 143 | + * Checks whether this is a dummy command, which is only |
|
| 144 | + * used to access information on the command type. It cannot |
|
| 145 | + * be used as an actual live command. |
|
| 146 | + * |
|
| 147 | + * @return bool |
|
| 148 | + */ |
|
| 149 | 149 | public function isDummy() : bool |
| 150 | 150 | { |
| 151 | 151 | return $this->type === '__dummy'; |
| 152 | 152 | } |
| 153 | 153 | |
| 154 | - /** |
|
| 155 | - * Retrieves a hash of the actual matched command string, |
|
| 156 | - * which is used in collections to detect duplicate commands. |
|
| 157 | - * |
|
| 158 | - * @return string |
|
| 159 | - */ |
|
| 154 | + /** |
|
| 155 | + * Retrieves a hash of the actual matched command string, |
|
| 156 | + * which is used in collections to detect duplicate commands. |
|
| 157 | + * |
|
| 158 | + * @return string |
|
| 159 | + */ |
|
| 160 | 160 | public function getHash() : string |
| 161 | 161 | { |
| 162 | 162 | $this->requireNonDummy(); |
@@ -253,9 +253,9 @@ discard block |
||
| 253 | 253 | return $this->validationResult->isValid(); |
| 254 | 254 | } |
| 255 | 255 | |
| 256 | - /** |
|
| 257 | - * @return string[] |
|
| 258 | - */ |
|
| 256 | + /** |
|
| 257 | + * @return string[] |
|
| 258 | + */ |
|
| 259 | 259 | abstract protected function getValidations() : array; |
| 260 | 260 | |
| 261 | 261 | protected function validateSyntax_params_empty() : void |
@@ -410,12 +410,12 @@ discard block |
||
| 410 | 410 | |
| 411 | 411 | abstract public function supportsType() : bool; |
| 412 | 412 | |
| 413 | - /** |
|
| 414 | - * Whether the command allows using logic keywords like "and:" or "or:" |
|
| 415 | - * in the command parameters. |
|
| 416 | - * |
|
| 417 | - * @return bool |
|
| 418 | - */ |
|
| 413 | + /** |
|
| 414 | + * Whether the command allows using logic keywords like "and:" or "or:" |
|
| 415 | + * in the command parameters. |
|
| 416 | + * |
|
| 417 | + * @return bool |
|
| 418 | + */ |
|
| 419 | 419 | abstract public function supportsLogicKeywords() : bool; |
| 420 | 420 | |
| 421 | 421 | abstract public function generatesContent() : bool; |
@@ -461,22 +461,22 @@ discard block |
||
| 461 | 461 | return $normalizer->normalize(); |
| 462 | 462 | } |
| 463 | 463 | |
| 464 | - /** |
|
| 465 | - * Retrieves the names of all the command's supported types: the part |
|
| 466 | - * between the command name and the colon. Example: {command type: params}. |
|
| 467 | - * |
|
| 468 | - * @return string[] |
|
| 469 | - */ |
|
| 464 | + /** |
|
| 465 | + * Retrieves the names of all the command's supported types: the part |
|
| 466 | + * between the command name and the colon. Example: {command type: params}. |
|
| 467 | + * |
|
| 468 | + * @return string[] |
|
| 469 | + */ |
|
| 470 | 470 | public function getSupportedTypes() : array |
| 471 | 471 | { |
| 472 | 472 | return array(); |
| 473 | 473 | } |
| 474 | 474 | |
| 475 | - /** |
|
| 476 | - * Retrieves all variable names used in the command. |
|
| 477 | - * |
|
| 478 | - * @return Mailcode_Variables_Collection_Regular |
|
| 479 | - */ |
|
| 475 | + /** |
|
| 476 | + * Retrieves all variable names used in the command. |
|
| 477 | + * |
|
| 478 | + * @return Mailcode_Variables_Collection_Regular |
|
| 479 | + */ |
|
| 480 | 480 | public function getVariables() : Mailcode_Variables_Collection_Regular |
| 481 | 481 | { |
| 482 | 482 | return Mailcode::create()->findVariables($this->paramsString); |
@@ -26,9 +26,9 @@ discard block |
||
| 26 | 26 | |
| 27 | 27 | const VALIDATION_VARIABLE_COUNT_MISMATCH = 48402; |
| 28 | 28 | |
| 29 | - /** |
|
| 30 | - * @var Mailcode_Variables_Variable|NULL |
|
| 31 | - */ |
|
| 29 | + /** |
|
| 30 | + * @var Mailcode_Variables_Variable|NULL |
|
| 31 | + */ |
|
| 32 | 32 | protected $variable; |
| 33 | 33 | |
| 34 | 34 | public function getName() : string |
@@ -61,15 +61,15 @@ discard block |
||
| 61 | 61 | return false; |
| 62 | 62 | } |
| 63 | 63 | |
| 64 | - /** |
|
| 65 | - * Retrieves the variable to show. |
|
| 66 | - * |
|
| 67 | - * NOTE: Only available once the command has been |
|
| 68 | - * validated. Always use isValid() first. |
|
| 69 | - * |
|
| 70 | - * @throws Mailcode_Exception |
|
| 71 | - * @return Mailcode_Variables_Variable |
|
| 72 | - */ |
|
| 64 | + /** |
|
| 65 | + * Retrieves the variable to show. |
|
| 66 | + * |
|
| 67 | + * NOTE: Only available once the command has been |
|
| 68 | + * validated. Always use isValid() first. |
|
| 69 | + * |
|
| 70 | + * @throws Mailcode_Exception |
|
| 71 | + * @return Mailcode_Variables_Variable |
|
| 72 | + */ |
|
| 73 | 73 | public function getVariable() : Mailcode_Variables_Variable |
| 74 | 74 | { |
| 75 | 75 | $this->validate(); |
@@ -86,15 +86,15 @@ discard block |
||
| 86 | 86 | ); |
| 87 | 87 | } |
| 88 | 88 | |
| 89 | - /** |
|
| 90 | - * Retrieves the full name of the variable to show. |
|
| 91 | - * |
|
| 92 | - * NOTE: Only available once the command has been |
|
| 93 | - * validated. Always use isValid() first. |
|
| 94 | - * |
|
| 95 | - * @throws Mailcode_Exception |
|
| 96 | - * @return string |
|
| 97 | - */ |
|
| 89 | + /** |
|
| 90 | + * Retrieves the full name of the variable to show. |
|
| 91 | + * |
|
| 92 | + * NOTE: Only available once the command has been |
|
| 93 | + * validated. Always use isValid() first. |
|
| 94 | + * |
|
| 95 | + * @throws Mailcode_Exception |
|
| 96 | + * @return string |
|
| 97 | + */ |
|
| 98 | 98 | public function getVariableName() : string |
| 99 | 99 | { |
| 100 | 100 | return $this->getVariable()->getFullName(); |
@@ -102,19 +102,19 @@ discard block |
||
| 102 | 102 | |
| 103 | 103 | protected function validateSyntax_require_variable() : void |
| 104 | 104 | { |
| 105 | - $vars = $this->getVariables()->getGroupedByName(); |
|
| 106 | - $amount = count($vars); |
|
| 105 | + $vars = $this->getVariables()->getGroupedByName(); |
|
| 106 | + $amount = count($vars); |
|
| 107 | 107 | |
| 108 | - if($amount === 1) |
|
| 109 | - { |
|
| 110 | - $this->variable = array_pop($vars); |
|
| 111 | - return; |
|
| 112 | - } |
|
| 108 | + if($amount === 1) |
|
| 109 | + { |
|
| 110 | + $this->variable = array_pop($vars); |
|
| 111 | + return; |
|
| 112 | + } |
|
| 113 | 113 | |
| 114 | - $this->validationResult->makeError( |
|
| 114 | + $this->validationResult->makeError( |
|
| 115 | 115 | t('Command has %1$s variables, %2$s expected.', $amount, 1), |
| 116 | 116 | self::VALIDATION_VARIABLE_COUNT_MISMATCH |
| 117 | - ); |
|
| 117 | + ); |
|
| 118 | 118 | } |
| 119 | 119 | |
| 120 | 120 | protected function getValidations() : array |
@@ -24,9 +24,9 @@ discard block |
||
| 24 | 24 | |
| 25 | 25 | const VALIDATION_VARIABLE_MISSING = 52001; |
| 26 | 26 | |
| 27 | - /** |
|
| 28 | - * @var Mailcode_Variables_Variable|NULL |
|
| 29 | - */ |
|
| 27 | + /** |
|
| 28 | + * @var Mailcode_Variables_Variable|NULL |
|
| 29 | + */ |
|
| 30 | 30 | protected $variable; |
| 31 | 31 | |
| 32 | 32 | public function getName() : string |
@@ -59,13 +59,13 @@ discard block |
||
| 59 | 59 | return false; |
| 60 | 60 | } |
| 61 | 61 | |
| 62 | - /** |
|
| 63 | - * Retrieves the variable to show, provided the command |
|
| 64 | - * is valid. |
|
| 65 | - * |
|
| 66 | - * @throws Mailcode_Exception |
|
| 67 | - * @return Mailcode_Variables_Variable |
|
| 68 | - */ |
|
| 62 | + /** |
|
| 63 | + * Retrieves the variable to show, provided the command |
|
| 64 | + * is valid. |
|
| 65 | + * |
|
| 66 | + * @throws Mailcode_Exception |
|
| 67 | + * @return Mailcode_Variables_Variable |
|
| 68 | + */ |
|
| 69 | 69 | public function getVariable() : Mailcode_Variables_Variable |
| 70 | 70 | { |
| 71 | 71 | $this->validate(); |
@@ -82,13 +82,13 @@ discard block |
||
| 82 | 82 | ); |
| 83 | 83 | } |
| 84 | 84 | |
| 85 | - /** |
|
| 86 | - * Retrieves the full name of the variable to show, |
|
| 87 | - * provided the command is valid. |
|
| 88 | - * |
|
| 89 | - * @throws Mailcode_Exception |
|
| 90 | - * @return string |
|
| 91 | - */ |
|
| 85 | + /** |
|
| 86 | + * Retrieves the full name of the variable to show, |
|
| 87 | + * provided the command is valid. |
|
| 88 | + * |
|
| 89 | + * @throws Mailcode_Exception |
|
| 90 | + * @return string |
|
| 91 | + */ |
|
| 92 | 92 | public function getVariableName() : string |
| 93 | 93 | { |
| 94 | 94 | return $this->getVariable()->getFullName(); |
@@ -31,27 +31,27 @@ discard block |
||
| 31 | 31 | const VALIDATION_CANNOT_MIX_LOGIC_KEYWORDS = 60701; |
| 32 | 32 | const VALIDATION_INVALID_SUB_COMMAND = 60702; |
| 33 | 33 | |
| 34 | - /** |
|
| 35 | - * @var string |
|
| 36 | - */ |
|
| 34 | + /** |
|
| 35 | + * @var string |
|
| 36 | + */ |
|
| 37 | 37 | private $paramsString; |
| 38 | 38 | |
| 39 | - /** |
|
| 40 | - * @var string[] |
|
| 41 | - */ |
|
| 39 | + /** |
|
| 40 | + * @var string[] |
|
| 41 | + */ |
|
| 42 | 42 | private $names = array( |
| 43 | 43 | 'and', |
| 44 | 44 | 'or' |
| 45 | 45 | ); |
| 46 | 46 | |
| 47 | - /** |
|
| 48 | - * @var Mailcode_Commands_LogicKeywords_Keyword[] |
|
| 49 | - */ |
|
| 47 | + /** |
|
| 48 | + * @var Mailcode_Commands_LogicKeywords_Keyword[] |
|
| 49 | + */ |
|
| 50 | 50 | private $keywords = array(); |
| 51 | 51 | |
| 52 | - /** |
|
| 53 | - * @var string |
|
| 54 | - */ |
|
| 52 | + /** |
|
| 53 | + * @var string |
|
| 54 | + */ |
|
| 55 | 55 | private $mainParams = ''; |
| 56 | 56 | |
| 57 | 57 | public function __construct(Mailcode_Commands_Command $command, string $paramsString) |
@@ -136,9 +136,9 @@ discard block |
||
| 136 | 136 | } |
| 137 | 137 | } |
| 138 | 138 | |
| 139 | - /** |
|
| 140 | - * @return string[] |
|
| 141 | - */ |
|
| 139 | + /** |
|
| 140 | + * @return string[] |
|
| 141 | + */ |
|
| 142 | 142 | private function detectParameters() : array |
| 143 | 143 | { |
| 144 | 144 | $params = $this->paramsString; |
@@ -156,13 +156,13 @@ discard block |
||
| 156 | 156 | return $stack; |
| 157 | 157 | } |
| 158 | 158 | |
| 159 | - /** |
|
| 160 | - * @param string $params |
|
| 161 | - * @param Mailcode_Commands_LogicKeywords_Keyword $keyword |
|
| 162 | - * @param string[] $stack |
|
| 163 | - * @throws Mailcode_Exception |
|
| 164 | - * @return string |
|
| 165 | - */ |
|
| 159 | + /** |
|
| 160 | + * @param string $params |
|
| 161 | + * @param Mailcode_Commands_LogicKeywords_Keyword $keyword |
|
| 162 | + * @param string[] $stack |
|
| 163 | + * @throws Mailcode_Exception |
|
| 164 | + * @return string |
|
| 165 | + */ |
|
| 166 | 166 | private function detectParamsKeyword(string $params, Mailcode_Commands_LogicKeywords_Keyword $keyword, array &$stack) : string |
| 167 | 167 | { |
| 168 | 168 | $search = $keyword->getMatchedString(); |
@@ -187,22 +187,22 @@ discard block |
||
| 187 | 187 | return $params; |
| 188 | 188 | } |
| 189 | 189 | |
| 190 | - /** |
|
| 191 | - * Extracts the parameters string to use for the |
|
| 192 | - * original command itself, omitting all the logic |
|
| 193 | - * keywords for the sub-commands. |
|
| 194 | - * |
|
| 195 | - * @return string |
|
| 196 | - */ |
|
| 190 | + /** |
|
| 191 | + * Extracts the parameters string to use for the |
|
| 192 | + * original command itself, omitting all the logic |
|
| 193 | + * keywords for the sub-commands. |
|
| 194 | + * |
|
| 195 | + * @return string |
|
| 196 | + */ |
|
| 197 | 197 | public function getMainParamsString() : string |
| 198 | 198 | { |
| 199 | 199 | return $this->mainParams; |
| 200 | 200 | } |
| 201 | 201 | |
| 202 | - /** |
|
| 203 | - * Retrieves the detected keyword names. |
|
| 204 | - * @return string[] |
|
| 205 | - */ |
|
| 202 | + /** |
|
| 203 | + * Retrieves the detected keyword names. |
|
| 204 | + * @return string[] |
|
| 205 | + */ |
|
| 206 | 206 | public function getDetectedNames() : array |
| 207 | 207 | { |
| 208 | 208 | $names = array(); |
@@ -220,23 +220,23 @@ discard block |
||
| 220 | 220 | return $names; |
| 221 | 221 | } |
| 222 | 222 | |
| 223 | - /** |
|
| 224 | - * Retrieves all keywords that were detected in the |
|
| 225 | - * command's parameters string, if any. |
|
| 226 | - * |
|
| 227 | - * @return Mailcode_Commands_LogicKeywords_Keyword[] |
|
| 228 | - */ |
|
| 223 | + /** |
|
| 224 | + * Retrieves all keywords that were detected in the |
|
| 225 | + * command's parameters string, if any. |
|
| 226 | + * |
|
| 227 | + * @return Mailcode_Commands_LogicKeywords_Keyword[] |
|
| 228 | + */ |
|
| 229 | 229 | public function getKeywords() : array |
| 230 | 230 | { |
| 231 | 231 | return $this->keywords; |
| 232 | 232 | } |
| 233 | 233 | |
| 234 | - /** |
|
| 235 | - * Detects any keyword statements in the parameters by keyword name. |
|
| 236 | - * |
|
| 237 | - * @param string $name |
|
| 238 | - * @return Mailcode_Commands_LogicKeywords_Keyword[] |
|
| 239 | - */ |
|
| 234 | + /** |
|
| 235 | + * Detects any keyword statements in the parameters by keyword name. |
|
| 236 | + * |
|
| 237 | + * @param string $name |
|
| 238 | + * @return Mailcode_Commands_LogicKeywords_Keyword[] |
|
| 239 | + */ |
|
| 240 | 240 | private function detectKeywords(string $name) : array |
| 241 | 241 | { |
| 242 | 242 | $regex = sprintf('/%1$s\s+([a-z\-0-9]+):|%1$s:/x', $name); |