1 | <?php |
||
26 | trait CommandHandler |
||
27 | { |
||
28 | /** |
||
29 | * \addtogroup Commands |
||
30 | * \brief Bots command and usage. |
||
31 | * @{ |
||
32 | */ |
||
33 | |||
34 | /** @internal |
||
35 | * \brief Contains all command used by the bot. */ |
||
36 | private $_commands = []; |
||
37 | |||
38 | /** |
||
39 | * @internal |
||
40 | * \brief Initialize commands to speed up processing. |
||
41 | * \details Get all command that the bot handle, and put them in priority. |
||
42 | */ |
||
43 | 3 | protected function initCommands() |
|
58 | |||
59 | /** |
||
60 | * @internal |
||
61 | * \brief Process updates prioritizing bot's commands over the general methods (e.g. BaseBot::processMessage()) |
||
62 | * @param array $update Update to process. |
||
63 | * @return bool True if this update trigger any command. |
||
64 | */ |
||
65 | 3 | protected function processCommands(array $update) : bool |
|
85 | |||
86 | /** |
||
87 | * \brief Add a command to the bot. |
||
88 | * @param BasicCommand $command Command to add. Must be an object that inherits BasicCommand class. |
||
89 | */ |
||
90 | 1 | public function addCommand(BasicCommand $command) |
|
94 | |||
95 | /** |
||
96 | * \brief Add a message command to the bot. |
||
97 | * @param string $command The command that will trigger the function (e.g. start). |
||
98 | * @param callable $script The function that will be triggered by a command. |
||
99 | */ |
||
100 | public function addMessageCommand(string $command, callable $script) { |
||
103 | |||
104 | /** |
||
105 | * \brief Add a callback command to the bot. |
||
106 | * @param string $data The data that will trigger the function. |
||
107 | * @param callable $script The function that will be triggered by the data. |
||
108 | */ |
||
109 | public function addCallbackCommand(string $data, callable $script) { |
||
112 | |||
113 | /** |
||
114 | * @internal |
||
115 | * \brief Sort an array based on <code>prior</code> index value. |
||
116 | * @param array $a First array. |
||
117 | * @param array $b Second array. |
||
118 | * @return int 1 If $a > $b, -1 if $a < $b, 0 otherwise. |
||
119 | */ |
||
120 | public static function sortingPrior($a, $b) |
||
136 | |||
137 | /** @} */ |
||
138 | } |
||
139 |
In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code:
Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion: