@@ -302,11 +302,11 @@ discard block |
||
302 | 302 | } |
303 | 303 | |
304 | 304 | /** |
305 | - * Envía un correo electrónico al usuario que quiere recuperar la contraseña, con un token y una nueva contraseña. |
|
306 | - * Si el usuario no visita el enlace, el sistema no cambiará la contraseña. |
|
307 | - * |
|
308 | - * @return array<string,integer|string> |
|
309 | - */ |
|
305 | + * Envía un correo electrónico al usuario que quiere recuperar la contraseña, con un token y una nueva contraseña. |
|
306 | + * Si el usuario no visita el enlace, el sistema no cambiará la contraseña. |
|
307 | + * |
|
308 | + * @return array<string,integer|string> |
|
309 | + */ |
|
310 | 310 | public function lostpass() { |
311 | 311 | try { |
312 | 312 | global $http, $config; |
@@ -342,8 +342,8 @@ discard block |
||
342 | 342 | |
343 | 343 | # Enviar el correo electrónico |
344 | 344 | $dest = array(); |
345 | - $dest[$email] = $user_data[0]['name']; |
|
346 | - $email = Emails::send_mail($dest,Emails::plantilla($HTML),'Recuperar contraseña perdida'); |
|
345 | + $dest[$email] = $user_data[0]['name']; |
|
346 | + $email = Emails::send_mail($dest,Emails::plantilla($HTML),'Recuperar contraseña perdida'); |
|
347 | 347 | |
348 | 348 | # Verificar si hubo algún problema con el envío del correo |
349 | 349 | if(false === $email) { |
@@ -23,32 +23,32 @@ discard block |
||
23 | 23 | abstract class Models { |
24 | 24 | |
25 | 25 | /** |
26 | - * Tiene siempre el id pasado por la ruta, en caso de no haber ninguno, será cero. |
|
27 | - * |
|
28 | - * @var int |
|
29 | - */ |
|
26 | + * Tiene siempre el id pasado por la ruta, en caso de no haber ninguno, será cero. |
|
27 | + * |
|
28 | + * @var int |
|
29 | + */ |
|
30 | 30 | protected $id = 0; |
31 | 31 | |
32 | 32 | /** |
33 | - * Contiene una instancia del helper para funciones |
|
34 | - * |
|
35 | - * @var \Ocrend\Kernel\Helpers\Functions |
|
36 | - */ |
|
33 | + * Contiene una instancia del helper para funciones |
|
34 | + * |
|
35 | + * @var \Ocrend\Kernel\Helpers\Functions |
|
36 | + */ |
|
37 | 37 | protected $functions; |
38 | 38 | |
39 | 39 | /** |
40 | - * Contiene el id del usuario que tiene su sesión iniciada. |
|
41 | - * |
|
42 | - * @var int|null con id del usuario |
|
43 | - */ |
|
40 | + * Contiene el id del usuario que tiene su sesión iniciada. |
|
41 | + * |
|
42 | + * @var int|null con id del usuario |
|
43 | + */ |
|
44 | 44 | protected $id_user = null; |
45 | 45 | |
46 | 46 | /** |
47 | - * Inicia la configuración inicial de cualquier modelo |
|
48 | - * |
|
49 | - * @param IRouter $router: Instancia de un Router |
|
50 | - * |
|
51 | - */ |
|
47 | + * Inicia la configuración inicial de cualquier modelo |
|
48 | + * |
|
49 | + * @param IRouter $router: Instancia de un Router |
|
50 | + * |
|
51 | + */ |
|
52 | 52 | protected function __construct(IRouter $router = null) { |
53 | 53 | global $session, $config; |
54 | 54 | |
@@ -63,19 +63,19 @@ discard block |
||
63 | 63 | |
64 | 64 | # Verificar sesión del usuario |
65 | 65 | if(null !== $session->get('user_id') && $session->get('unique_session') == $config['sessions']['unique']) { |
66 | - $this->id_user = $session->get('user_id'); |
|
66 | + $this->id_user = $session->get('user_id'); |
|
67 | 67 | } |
68 | 68 | } |
69 | 69 | |
70 | 70 | /** |
71 | - * Asigna el id desde un modelo, ideal para cuando queremos darle un valor numérico |
|
72 | - * que proviene de un formulario y puede ser inseguro. |
|
73 | - * |
|
74 | - * @param mixed $id : Id a asignar en $this->id |
|
75 | - * @param string $default_msg : Mensaje a mostrar en caso de que no se pueda asignar |
|
76 | - * |
|
77 | - * @throws ModelsException |
|
78 | - */ |
|
71 | + * Asigna el id desde un modelo, ideal para cuando queremos darle un valor numérico |
|
72 | + * que proviene de un formulario y puede ser inseguro. |
|
73 | + * |
|
74 | + * @param mixed $id : Id a asignar en $this->id |
|
75 | + * @param string $default_msg : Mensaje a mostrar en caso de que no se pueda asignar |
|
76 | + * |
|
77 | + * @throws ModelsException |
|
78 | + */ |
|
79 | 79 | protected function setId($id, string $default_msg = 'No puedede asignarse el id.') { |
80 | 80 | if (null == $id || !is_numeric($id) || $id <= 0) { |
81 | 81 | throw new ModelsException($default_msg); |
@@ -65,39 +65,39 @@ discard block |
||
65 | 65 | } |
66 | 66 | //------------------------------------------------ |
67 | 67 | /** |
68 | - * Compara un string hash con un string sin hash, si el string sin hash al encriptar posee la misma llave que hash, son iguales |
|
69 | - * |
|
70 | - * @param string $hash: Hash con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G |
|
71 | - * @param string $s2: Cadena de texto a comparar |
|
72 | - * |
|
73 | - * @example Strings::chash('$2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G','123456'); //return true |
|
74 | - * |
|
75 | - * @return bool true si $s2 contiene la misma llave que $hash, por tanto el contenido de $hash es $s2, de lo contrario false |
|
76 | - */ |
|
68 | + * Compara un string hash con un string sin hash, si el string sin hash al encriptar posee la misma llave que hash, son iguales |
|
69 | + * |
|
70 | + * @param string $hash: Hash con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G |
|
71 | + * @param string $s2: Cadena de texto a comparar |
|
72 | + * |
|
73 | + * @example Strings::chash('$2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G','123456'); //return true |
|
74 | + * |
|
75 | + * @return bool true si $s2 contiene la misma llave que $hash, por tanto el contenido de $hash es $s2, de lo contrario false |
|
76 | + */ |
|
77 | 77 | final public static function chash(string $hash, string $s2) : bool { |
78 | 78 | return $hash == crypt($s2, substr($hash, 0, 29)); |
79 | - } |
|
80 | - //------------------------------------------------ |
|
79 | + } |
|
80 | + //------------------------------------------------ |
|
81 | 81 | /** |
82 | - * Devuelve un hash DINÁMICO, para comparar un hash con un elemento se utiliza chash |
|
83 | - * |
|
84 | - * @param string $p: Cadena de texto a encriptar |
|
85 | - * |
|
86 | - * @return string Hash, con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G |
|
87 | - */ |
|
82 | + * Devuelve un hash DINÁMICO, para comparar un hash con un elemento se utiliza chash |
|
83 | + * |
|
84 | + * @param string $p: Cadena de texto a encriptar |
|
85 | + * |
|
86 | + * @return string Hash, con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G |
|
87 | + */ |
|
88 | 88 | final public static function hash(string $p) : string { |
89 | 89 | return crypt($p, '$2a$10$' . substr(sha1(mt_rand()), 0, 22)); |
90 | 90 | } |
91 | 91 | //------------------------------------------------ |
92 | 92 | /** |
93 | - * Calcula el tiempo de diferencia entre dos fechas |
|
94 | - * |
|
95 | - * @param string $ini: Fecha menor con el formato d-m-Y ó d/m/Y |
|
96 | - * @param string $fin: Fecha mayor con el formato d-m-Y ó d/m/Y |
|
97 | - * |
|
98 | - * @return int con la diferencia de tiempo en días |
|
99 | - * |
|
100 | - */ |
|
93 | + * Calcula el tiempo de diferencia entre dos fechas |
|
94 | + * |
|
95 | + * @param string $ini: Fecha menor con el formato d-m-Y ó d/m/Y |
|
96 | + * @param string $fin: Fecha mayor con el formato d-m-Y ó d/m/Y |
|
97 | + * |
|
98 | + * @return int con la diferencia de tiempo en días |
|
99 | + * |
|
100 | + */ |
|
101 | 101 | final public static function date_difference(string $ini, string $fin) : int { |
102 | 102 | $ini_i = explode('-',str_replace('/','-',$ini)); |
103 | 103 | $fin_i = explode('-',str_replace('/','-',$fin)); |
@@ -105,90 +105,90 @@ discard block |
||
105 | 105 | } |
106 | 106 | //------------------------------------------------ |
107 | 107 | /** |
108 | - * Calcula la edad de una persona segun la fecha de nacimiento |
|
109 | - * |
|
110 | - * @param string $cumple: Fecha de nacimiento con el formato d-m-Y ó d/m/Y |
|
111 | - * |
|
112 | - * @return int con la edad |
|
113 | - * |
|
114 | - */ |
|
108 | + * Calcula la edad de una persona segun la fecha de nacimiento |
|
109 | + * |
|
110 | + * @param string $cumple: Fecha de nacimiento con el formato d-m-Y ó d/m/Y |
|
111 | + * |
|
112 | + * @return int con la edad |
|
113 | + * |
|
114 | + */ |
|
115 | 115 | final public static function calculate_age(string $cumple) : int { |
116 | 116 | $age = explode('.', (string) (self::date_difference($cumple, date('d-m-Y', time()))/365)); |
117 | 117 | return (int) $age[0]; |
118 | 118 | } |
119 | 119 | //------------------------------------------------ |
120 | 120 | /** |
121 | - * Calcula cuántos días tiene el mes actual |
|
122 | - * |
|
123 | - * @return integer con la cantidad de días del mes |
|
124 | - * |
|
125 | - */ |
|
121 | + * Calcula cuántos días tiene el mes actual |
|
122 | + * |
|
123 | + * @return integer con la cantidad de días del mes |
|
124 | + * |
|
125 | + */ |
|
126 | 126 | final public static function days_of_month() : int { |
127 | 127 | return cal_days_in_month(CAL_GREGORIAN, (int) date('m',time()), (int) date('Y',time())); |
128 | 128 | } |
129 | 129 | //------------------------------------------------ |
130 | 130 | /** |
131 | - * Verifica si una cadena de texto tiene forma de email |
|
132 | - * |
|
133 | - * @param string $address: Cadena de texto con el email |
|
134 | - * |
|
135 | - * @return mixed devuelve TRUE si es un email y FALSE si no lo es |
|
136 | - */ |
|
131 | + * Verifica si una cadena de texto tiene forma de email |
|
132 | + * |
|
133 | + * @param string $address: Cadena de texto con el email |
|
134 | + * |
|
135 | + * @return mixed devuelve TRUE si es un email y FALSE si no lo es |
|
136 | + */ |
|
137 | 137 | final public static function is_email(string $address) { |
138 | 138 | return filter_var($address, FILTER_VALIDATE_EMAIL); |
139 | 139 | } |
140 | 140 | //------------------------------------------------ |
141 | 141 | /** |
142 | - * Remueve todos los espacios en blanco de un string |
|
143 | - * |
|
144 | - * @param string $s: Cadena de texto a convertir |
|
145 | - * |
|
146 | - * @return string del texto sin espacios |
|
147 | - */ |
|
142 | + * Remueve todos los espacios en blanco de un string |
|
143 | + * |
|
144 | + * @param string $s: Cadena de texto a convertir |
|
145 | + * |
|
146 | + * @return string del texto sin espacios |
|
147 | + */ |
|
148 | 148 | final public static function remove_spaces(string $s) : string { |
149 | 149 | return trim(str_replace(' ', '', $s)); |
150 | 150 | } |
151 | 151 | //------------------------------------------------ |
152 | 152 | /** |
153 | - * Analiza si una cadena de texto es alfanumérica |
|
154 | - * |
|
155 | - * @param string $s: Cadena de texto a verificar |
|
156 | - * |
|
157 | - * @return bool, verdadero si es alfanumerica, falso si no |
|
158 | - */ |
|
153 | + * Analiza si una cadena de texto es alfanumérica |
|
154 | + * |
|
155 | + * @param string $s: Cadena de texto a verificar |
|
156 | + * |
|
157 | + * @return bool, verdadero si es alfanumerica, falso si no |
|
158 | + */ |
|
159 | 159 | final public static function alphanumeric(string $s) : bool { |
160 | 160 | return ctype_alnum(self::remove_spaces($s)); |
161 | 161 | } |
162 | 162 | //------------------------------------------------ |
163 | 163 | /** |
164 | - * Analiza si una cadena de texto verificando si sólamente tiene letras |
|
165 | - * |
|
166 | - * @param string $s: Cadena de texto a verificar |
|
167 | - * |
|
168 | - * @return bool, verdadero si sólamente tiene letras, falso si no |
|
169 | - */ |
|
164 | + * Analiza si una cadena de texto verificando si sólamente tiene letras |
|
165 | + * |
|
166 | + * @param string $s: Cadena de texto a verificar |
|
167 | + * |
|
168 | + * @return bool, verdadero si sólamente tiene letras, falso si no |
|
169 | + */ |
|
170 | 170 | final public static function only_letters(string $s) : bool { |
171 | 171 | return ctype_alpha(self::remove_spaces($s)); |
172 | 172 | } |
173 | 173 | //------------------------------------------------ |
174 | 174 | /** |
175 | - * Analiza si una cadena de texto contiene sólamente letras y números |
|
176 | - * |
|
177 | - * @param string $s: Cadena de texto a verificar |
|
178 | - * |
|
179 | - * @return bool, verdadero si sólamente contiene letras y números, falso si no |
|
180 | - */ |
|
175 | + * Analiza si una cadena de texto contiene sólamente letras y números |
|
176 | + * |
|
177 | + * @param string $s: Cadena de texto a verificar |
|
178 | + * |
|
179 | + * @return bool, verdadero si sólamente contiene letras y números, falso si no |
|
180 | + */ |
|
181 | 181 | final public static function letters_and_numbers(string $s) : bool { |
182 | 182 | return (boolean) preg_match('/^[\w.]*$/', self::remove_spaces($s)); |
183 | 183 | } |
184 | 184 | //------------------------------------------------ |
185 | 185 | /** |
186 | - * Convierte una expresión de texto, a una compatible con url amigables |
|
187 | - * |
|
188 | - * @param string $url: Cadena de texto a convertir |
|
189 | - * |
|
190 | - * @return string Cadena de texto con formato de url amigable |
|
191 | - */ |
|
186 | + * Convierte una expresión de texto, a una compatible con url amigables |
|
187 | + * |
|
188 | + * @param string $url: Cadena de texto a convertir |
|
189 | + * |
|
190 | + * @return string Cadena de texto con formato de url amigable |
|
191 | + */ |
|
192 | 192 | final public static function url_amigable(string $url) : string { |
193 | 193 | $url = strtolower($url); |
194 | 194 | $url = str_replace(['á', 'é', 'í', 'ó', 'ú', 'ñ'], ['a', 'e', 'i', 'o', 'u', 'n'], $url); |
@@ -250,58 +250,58 @@ discard block |
||
250 | 250 | } |
251 | 251 | //------------------------------------------------ |
252 | 252 | /** |
253 | - * Dice si un string comienza con un caracter especificado |
|
254 | - * |
|
255 | - * @param string $sx: Caracter de inicio |
|
256 | - * @param string $str: String a evaluar |
|
257 | - * @param bool $case_sensitive: Boolean para definir si será seible a mayúsculas o no |
|
258 | - * |
|
259 | - * @return bool True si comienza con el caracter especificado, False si no |
|
260 | - */ |
|
253 | + * Dice si un string comienza con un caracter especificado |
|
254 | + * |
|
255 | + * @param string $sx: Caracter de inicio |
|
256 | + * @param string $str: String a evaluar |
|
257 | + * @param bool $case_sensitive: Boolean para definir si será seible a mayúsculas o no |
|
258 | + * |
|
259 | + * @return bool True si comienza con el caracter especificado, False si no |
|
260 | + */ |
|
261 | 261 | final public static function begin_with(string $sx, string $str) : bool { |
262 | 262 | return (bool) (strlen($str) > 0 and $str[0] == $sx); |
263 | 263 | } |
264 | 264 | //------------------------------------------------ |
265 | 265 | /** |
266 | - * Dice si un string termina con una caracter especificado |
|
267 | - * |
|
268 | - * @param string $sx: Caracter del final |
|
269 | - * @param string $str: String a evaluar |
|
270 | - * |
|
271 | - * @return bool True si termina con el caracter especificado, False si no |
|
272 | - */ |
|
266 | + * Dice si un string termina con una caracter especificado |
|
267 | + * |
|
268 | + * @param string $sx: Caracter del final |
|
269 | + * @param string $str: String a evaluar |
|
270 | + * |
|
271 | + * @return bool True si termina con el caracter especificado, False si no |
|
272 | + */ |
|
273 | 273 | final public static function end_with(string $sx, string $str) : bool { |
274 | 274 | return (bool) (strlen($str) > 0 and $str[strlen($str) - 1] == $sx); |
275 | 275 | } |
276 | 276 | //------------------------------------------------ |
277 | 277 | /** |
278 | - * Ver si un string está contenido en otro |
|
279 | - * |
|
280 | - * @param $s: String contenido en $str |
|
281 | - * @param $str: String a evaluar |
|
282 | - * |
|
283 | - * @return bool True si $s está dentro de $str, False si no |
|
284 | - */ |
|
278 | + * Ver si un string está contenido en otro |
|
279 | + * |
|
280 | + * @param $s: String contenido en $str |
|
281 | + * @param $str: String a evaluar |
|
282 | + * |
|
283 | + * @return bool True si $s está dentro de $str, False si no |
|
284 | + */ |
|
285 | 285 | final public static function contain(string $s, string $str) : bool { |
286 | 286 | return (bool) (strpos($str, $s) !== false); |
287 | 287 | } |
288 | 288 | //------------------------------------------------ |
289 | 289 | /** |
290 | - * Devuelve la cantidad de palabras en un string |
|
291 | - * |
|
292 | - * @param $str: String a evaluar |
|
293 | - * |
|
294 | - * @return int Cantidad de palabras |
|
295 | - */ |
|
290 | + * Devuelve la cantidad de palabras en un string |
|
291 | + * |
|
292 | + * @param $str: String a evaluar |
|
293 | + * |
|
294 | + * @return int Cantidad de palabras |
|
295 | + */ |
|
296 | 296 | final public static function count_words(string $s) : int { |
297 | 297 | return (int) str_word_count($s,0); |
298 | 298 | } |
299 | 299 | //------------------------------------------------ |
300 | 300 | /** |
301 | - * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig |
|
302 | - * |
|
303 | - * @return array Todas las funciones con sus respectivos nombres de acceso en plantillas twig |
|
304 | - */ |
|
301 | + * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig |
|
302 | + * |
|
303 | + * @return array Todas las funciones con sus respectivos nombres de acceso en plantillas twig |
|
304 | + */ |
|
305 | 305 | public function getFunctions() : array { |
306 | 306 | return array( |
307 | 307 | new \Twig_Function('amigable_time', array($this, 'amigable_time')), |
@@ -325,10 +325,10 @@ discard block |
||
325 | 325 | } |
326 | 326 | //------------------------------------------------ |
327 | 327 | /** |
328 | - * Identificador único para la extensión de twig |
|
329 | - * |
|
330 | - * @return string Nombre de la extensión |
|
331 | - */ |
|
328 | + * Identificador único para la extensión de twig |
|
329 | + * |
|
330 | + * @return string Nombre de la extensión |
|
331 | + */ |
|
332 | 332 | public function getName() : string { |
333 | 333 | return 'ocrend_framework_helper_strings'; |
334 | 334 | } |
@@ -120,12 +120,12 @@ discard block |
||
120 | 120 | //------------------------------------------------ |
121 | 121 | |
122 | 122 | /** |
123 | - * Evalúa si un arreglo es de tipo asociativo o no |
|
124 | - * |
|
125 | - * @param array $a: Arreglo a evaluar |
|
126 | - * |
|
127 | - * @return bool false si no lo es, true si lo es |
|
128 | - */ |
|
123 | + * Evalúa si un arreglo es de tipo asociativo o no |
|
124 | + * |
|
125 | + * @param array $a: Arreglo a evaluar |
|
126 | + * |
|
127 | + * @return bool false si no lo es, true si lo es |
|
128 | + */ |
|
129 | 129 | final public static function is_assoc(array $a) : bool { |
130 | 130 | if (sizeof($a) === 0) { |
131 | 131 | return false; |
@@ -137,12 +137,12 @@ discard block |
||
137 | 137 | //------------------------------------------------ |
138 | 138 | |
139 | 139 | /** |
140 | - * Evalúa si un arreglo es secuencial (de índices numéricos) |
|
141 | - * |
|
142 | - * @param array $a: Arreglo a evaluar |
|
143 | - * |
|
144 | - * @return bool false si no lo es, true si lo es |
|
145 | - */ |
|
140 | + * Evalúa si un arreglo es secuencial (de índices numéricos) |
|
141 | + * |
|
142 | + * @param array $a: Arreglo a evaluar |
|
143 | + * |
|
144 | + * @return bool false si no lo es, true si lo es |
|
145 | + */ |
|
146 | 146 | final public static function is_numeric_array(array $a) : bool { |
147 | 147 | return !self::is_assoc($a); |
148 | 148 | } |
@@ -150,12 +150,12 @@ discard block |
||
150 | 150 | //------------------------------------------------ |
151 | 151 | |
152 | 152 | /** |
153 | - * Obtiene de forma random un elemento de un arreglo |
|
154 | - * |
|
155 | - * @param array $a: Arreglo a evaluar |
|
156 | - * |
|
157 | - * @return mixed elemento random dentro del arreglo |
|
158 | - */ |
|
153 | + * Obtiene de forma random un elemento de un arreglo |
|
154 | + * |
|
155 | + * @param array $a: Arreglo a evaluar |
|
156 | + * |
|
157 | + * @return mixed elemento random dentro del arreglo |
|
158 | + */ |
|
159 | 159 | final public static function array_random_element(array $a) { |
160 | 160 | return $a[array_rand($a)]; |
161 | 161 | } |
@@ -163,10 +163,10 @@ discard block |
||
163 | 163 | //------------------------------------------------ |
164 | 164 | |
165 | 165 | /** |
166 | - * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig |
|
167 | - * |
|
168 | - * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig |
|
169 | - */ |
|
166 | + * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig |
|
167 | + * |
|
168 | + * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig |
|
169 | + */ |
|
170 | 170 | public function getFunctions() : array { |
171 | 171 | return array( |
172 | 172 | new \Twig_Function('get_key_by_index', array($this, 'get_key_by_index')), |
@@ -181,10 +181,10 @@ discard block |
||
181 | 181 | //------------------------------------------------ |
182 | 182 | |
183 | 183 | /** |
184 | - * Identificador único para la extensión de twig |
|
185 | - * |
|
186 | - * @return string con el nombre de la extensión |
|
187 | - */ |
|
184 | + * Identificador único para la extensión de twig |
|
185 | + * |
|
186 | + * @return string con el nombre de la extensión |
|
187 | + */ |
|
188 | 188 | public function getName() : string { |
189 | 189 | return 'ocrend_framework_helper_arrays'; |
190 | 190 | } |
@@ -19,20 +19,20 @@ discard block |
||
19 | 19 | |
20 | 20 | final class Functions extends \Twig_Extension { |
21 | 21 | |
22 | - /** |
|
23 | - * Verifica parte de una fecha, método privado usado en str_to_time |
|
24 | - * |
|
25 | - * @param int $index: Índice del arreglo |
|
26 | - * @param array $detail: Arreglo |
|
27 | - * @param int $max: Valor a comparar |
|
28 | - * |
|
29 | - * @return bool con el resultado de la comparación |
|
30 | - */ |
|
22 | + /** |
|
23 | + * Verifica parte de una fecha, método privado usado en str_to_time |
|
24 | + * |
|
25 | + * @param int $index: Índice del arreglo |
|
26 | + * @param array $detail: Arreglo |
|
27 | + * @param int $max: Valor a comparar |
|
28 | + * |
|
29 | + * @return bool con el resultado de la comparación |
|
30 | + */ |
|
31 | 31 | final private function check_str_to_time(int $index, array $detail, int $max) : bool { |
32 | 32 | return !array_key_exists($index,$detail) || !is_numeric($detail[$index]) || intval($detail[$index]) < $max; |
33 | 33 | } |
34 | 34 | |
35 | - //------------------------------------------------ |
|
35 | + //------------------------------------------------ |
|
36 | 36 | |
37 | 37 | /** |
38 | 38 | * Redirecciona a una URL |
@@ -84,55 +84,55 @@ discard block |
||
84 | 84 | //------------------------------------------------ |
85 | 85 | |
86 | 86 | /** |
87 | - * Retorna la URL de un gravatar, según el email |
|
88 | - * |
|
89 | - * @param string $email: El email del usuario a extraer el gravatar |
|
90 | - * @param int $size: El tamaño del gravatar |
|
91 | - * @return string con la URl |
|
92 | - */ |
|
93 | - final public function get_gravatar(string $email, int $size = 32) : string { |
|
94 | - return 'http://www.gravatar.com/avatar/' . md5($email) . '?s=' . (int) abs($size); |
|
95 | - } |
|
96 | - |
|
97 | - //------------------------------------------------ |
|
98 | - |
|
99 | - /** |
|
87 | + * Retorna la URL de un gravatar, según el email |
|
88 | + * |
|
89 | + * @param string $email: El email del usuario a extraer el gravatar |
|
90 | + * @param int $size: El tamaño del gravatar |
|
91 | + * @return string con la URl |
|
92 | + */ |
|
93 | + final public function get_gravatar(string $email, int $size = 32) : string { |
|
94 | + return 'http://www.gravatar.com/avatar/' . md5($email) . '?s=' . (int) abs($size); |
|
95 | + } |
|
96 | + |
|
97 | + //------------------------------------------------ |
|
98 | + |
|
99 | + /** |
|
100 | 100 | * Alias de Empty, más completo |
101 | 101 | * |
102 | 102 | * @param mixed $var: Variable a analizar |
103 | 103 | * |
104 | 104 | * @return bool con true si está vacío, false si no, un espacio en blanco cuenta como vacío |
105 | - */ |
|
106 | - final public function emp($var) : bool { |
|
107 | - return (isset($var) && empty(trim(str_replace(' ', '', $var)))); |
|
108 | - } |
|
105 | + */ |
|
106 | + final public function emp($var) : bool { |
|
107 | + return (isset($var) && empty(trim(str_replace(' ', '', $var)))); |
|
108 | + } |
|
109 | 109 | |
110 | - //------------------------------------------------ |
|
110 | + //------------------------------------------------ |
|
111 | 111 | |
112 | - /** |
|
112 | + /** |
|
113 | 113 | * Aanaliza que TODOS los elementos de un arreglo estén llenos, útil para analizar por ejemplo que todos los elementos de un formulario esté llenos |
114 | 114 | * pasando como parámetro $_POST |
115 | 115 | * |
116 | 116 | * @param array $array, arreglo a analizar |
117 | 117 | * |
118 | 118 | * @return bool con true si están todos llenos, false si al menos uno está vacío |
119 | - */ |
|
120 | - final public function all_full(array $array) : bool { |
|
121 | - foreach($array as $e) { |
|
122 | - if($this->emp($e) and $e != '0') { |
|
123 | - return false; |
|
124 | - } |
|
125 | - } |
|
126 | - return true; |
|
127 | - } |
|
128 | - |
|
129 | - //------------------------------------------------ |
|
130 | - |
|
131 | - /** |
|
119 | + */ |
|
120 | + final public function all_full(array $array) : bool { |
|
121 | + foreach($array as $e) { |
|
122 | + if($this->emp($e) and $e != '0') { |
|
123 | + return false; |
|
124 | + } |
|
125 | + } |
|
126 | + return true; |
|
127 | + } |
|
128 | + |
|
129 | + //------------------------------------------------ |
|
130 | + |
|
131 | + /** |
|
132 | 132 | * Alias de Empty() pero soporta más de un parámetro (infinitos) |
133 | 133 | * |
134 | 134 | * @return bool con true si al menos uno está vacío, false si todos están llenos |
135 | - */ |
|
135 | + */ |
|
136 | 136 | final public function e() : bool { |
137 | 137 | for ($i = 0, $nargs = func_num_args(); $i < $nargs; $i++) { |
138 | 138 | if(null === func_get_arg($i) || ($this->emp(func_get_arg($i)) && func_get_arg($i) != '0')) { |
@@ -145,58 +145,58 @@ discard block |
||
145 | 145 | //------------------------------------------------ |
146 | 146 | |
147 | 147 | /** |
148 | - * Alias de date() pero devuele días y meses en español |
|
149 | - * |
|
150 | - * @param string $format: Formato de salida (igual que en date()) |
|
151 | - * @param int $time: Tiempo, por defecto es time() (igual que en date()) |
|
152 | - * |
|
153 | - * @return string con la fecha en formato humano (y en español) |
|
154 | - */ |
|
148 | + * Alias de date() pero devuele días y meses en español |
|
149 | + * |
|
150 | + * @param string $format: Formato de salida (igual que en date()) |
|
151 | + * @param int $time: Tiempo, por defecto es time() (igual que en date()) |
|
152 | + * |
|
153 | + * @return string con la fecha en formato humano (y en español) |
|
154 | + */ |
|
155 | 155 | final public function fecha(string $format, int $time = 0) : string { |
156 | - $date = date($format,$time == 0 ? time() : $time); |
|
157 | - $cambios = array( |
|
158 | - 'Monday'=> 'Lunes', |
|
159 | - 'Tuesday'=> 'Martes', |
|
160 | - 'Wednesday'=> 'Miércoles', |
|
161 | - 'Thursday'=> 'Jueves', |
|
162 | - 'Friday'=> 'Viernes', |
|
163 | - 'Saturday'=> 'Sábado', |
|
164 | - 'Sunday'=> 'Domingo', |
|
165 | - 'January'=> 'Enero', |
|
166 | - 'February'=> 'Febrero', |
|
167 | - 'March'=> 'Marzo', |
|
168 | - 'April'=> 'Abril', |
|
169 | - 'May'=> 'Mayo', |
|
170 | - 'June'=> 'Junio', |
|
171 | - 'July'=> 'Julio', |
|
172 | - 'August'=> 'Agosto', |
|
173 | - 'September'=> 'Septiembre', |
|
174 | - 'October'=> 'Octubre', |
|
175 | - 'November'=> 'Noviembre', |
|
176 | - 'December'=> 'Diciembre', |
|
177 | - 'Mon'=> 'Lun', |
|
178 | - 'Tue'=> 'Mar', |
|
179 | - 'Wed'=> 'Mie', |
|
180 | - 'Thu'=> 'Jue', |
|
181 | - 'Fri'=> 'Vie', |
|
182 | - 'Sat'=> 'Sab', |
|
183 | - 'Sun'=> 'Dom', |
|
184 | - 'Jan'=> 'Ene', |
|
185 | - 'Aug'=> 'Ago', |
|
186 | - 'Apr'=> 'Abr', |
|
187 | - 'Dec'=> 'Dic' |
|
188 | - ); |
|
189 | - return str_replace(array_keys($cambios), array_values($cambios), $date); |
|
190 | - } |
|
191 | - |
|
192 | - //------------------------------------------------ |
|
156 | + $date = date($format,$time == 0 ? time() : $time); |
|
157 | + $cambios = array( |
|
158 | + 'Monday'=> 'Lunes', |
|
159 | + 'Tuesday'=> 'Martes', |
|
160 | + 'Wednesday'=> 'Miércoles', |
|
161 | + 'Thursday'=> 'Jueves', |
|
162 | + 'Friday'=> 'Viernes', |
|
163 | + 'Saturday'=> 'Sábado', |
|
164 | + 'Sunday'=> 'Domingo', |
|
165 | + 'January'=> 'Enero', |
|
166 | + 'February'=> 'Febrero', |
|
167 | + 'March'=> 'Marzo', |
|
168 | + 'April'=> 'Abril', |
|
169 | + 'May'=> 'Mayo', |
|
170 | + 'June'=> 'Junio', |
|
171 | + 'July'=> 'Julio', |
|
172 | + 'August'=> 'Agosto', |
|
173 | + 'September'=> 'Septiembre', |
|
174 | + 'October'=> 'Octubre', |
|
175 | + 'November'=> 'Noviembre', |
|
176 | + 'December'=> 'Diciembre', |
|
177 | + 'Mon'=> 'Lun', |
|
178 | + 'Tue'=> 'Mar', |
|
179 | + 'Wed'=> 'Mie', |
|
180 | + 'Thu'=> 'Jue', |
|
181 | + 'Fri'=> 'Vie', |
|
182 | + 'Sat'=> 'Sab', |
|
183 | + 'Sun'=> 'Dom', |
|
184 | + 'Jan'=> 'Ene', |
|
185 | + 'Aug'=> 'Ago', |
|
186 | + 'Apr'=> 'Abr', |
|
187 | + 'Dec'=> 'Dic' |
|
188 | + ); |
|
189 | + return str_replace(array_keys($cambios), array_values($cambios), $date); |
|
190 | + } |
|
191 | + |
|
192 | + //------------------------------------------------ |
|
193 | 193 | |
194 | 194 | /** |
195 | - * Devuelve la etiqueta <base> html adecuada para que los assets carguen desde allí. |
|
196 | - * Se adapta a la configuración del dominio en general. |
|
197 | - * |
|
198 | - * @return string <base href="ruta" /> |
|
199 | - */ |
|
195 | + * Devuelve la etiqueta <base> html adecuada para que los assets carguen desde allí. |
|
196 | + * Se adapta a la configuración del dominio en general. |
|
197 | + * |
|
198 | + * @return string <base href="ruta" /> |
|
199 | + */ |
|
200 | 200 | final public function base_assets() : string { |
201 | 201 | global $config, $http; |
202 | 202 | |
@@ -224,7 +224,7 @@ discard block |
||
224 | 224 | * @param int $anio: Año (1975 a 2xxx) |
225 | 225 | * |
226 | 226 | * @return string con el número del día |
227 | - */ |
|
227 | + */ |
|
228 | 228 | final public function last_day_month(int $mes, int $anio) : string { |
229 | 229 | return date('d', (mktime(0,0,0,$mes + 1, 1, $anio) - 1)); |
230 | 230 | } |
@@ -237,7 +237,7 @@ discard block |
||
237 | 237 | * @param int $num: cifra |
238 | 238 | * |
239 | 239 | * @return string cifra con cero a la izquirda |
240 | - */ |
|
240 | + */ |
|
241 | 241 | final public function cero_izq(int $num) : string { |
242 | 242 | if($num < 10) { |
243 | 243 | return '0' . $num; |
@@ -248,14 +248,14 @@ discard block |
||
248 | 248 | |
249 | 249 | //------------------------------------------------ |
250 | 250 | |
251 | - /** |
|
252 | - * Devuelve el timestamp de una fecha, y null si su formato es incorrecto. |
|
253 | - * |
|
254 | - * @param string|null $fecha: Fecha con formato dd/mm/yy |
|
255 | - * @param string $hora: Hora de inicio de la $fecha |
|
256 | - * |
|
257 | - * @return int|null con el timestamp |
|
258 | - */ |
|
251 | + /** |
|
252 | + * Devuelve el timestamp de una fecha, y null si su formato es incorrecto. |
|
253 | + * |
|
254 | + * @param string|null $fecha: Fecha con formato dd/mm/yy |
|
255 | + * @param string $hora: Hora de inicio de la $fecha |
|
256 | + * |
|
257 | + * @return int|null con el timestamp |
|
258 | + */ |
|
259 | 259 | final public function str_to_time($fecha, string $hora = '00:00:00') { |
260 | 260 | if(null == $fecha) { |
261 | 261 | return null; |
@@ -299,11 +299,11 @@ discard block |
||
299 | 299 | * @param int $desde: Desde donde |
300 | 300 | * |
301 | 301 | * @return mixed |
302 | - */ |
|
302 | + */ |
|
303 | 303 | final public function desde_date(int $desde) { |
304 | - # Obtener esta fecha |
|
305 | - $hoy = date('d/m/Y/D',time()); |
|
306 | - $hoy = explode('/',$hoy); |
|
304 | + # Obtener esta fecha |
|
305 | + $hoy = date('d/m/Y/D',time()); |
|
306 | + $hoy = explode('/',$hoy); |
|
307 | 307 | |
308 | 308 | |
309 | 309 | switch($desde) { |
@@ -365,7 +365,7 @@ discard block |
||
365 | 365 | |
366 | 366 | default: |
367 | 367 | throw new \RuntimeException('Problema con el valor $desde en desde_date()'); |
368 | - break; |
|
368 | + break; |
|
369 | 369 | } |
370 | 370 | } |
371 | 371 | |
@@ -375,44 +375,44 @@ discard block |
||
375 | 375 | * Obtiene el tiempo actual |
376 | 376 | * |
377 | 377 | * @return int devuelve time() |
378 | - */ |
|
378 | + */ |
|
379 | 379 | final public function timestamp() : int { |
380 | - return time(); |
|
380 | + return time(); |
|
381 | 381 | } |
382 | 382 | |
383 | 383 | //------------------------------------------------ |
384 | 384 | |
385 | 385 | /** |
386 | 386 | * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig |
387 | - * |
|
387 | + * |
|
388 | 388 | * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig |
389 | - */ |
|
389 | + */ |
|
390 | 390 | public function getFunctions() : array { |
391 | 391 | return array( |
392 | - new \Twig_Function('percent', array($this, 'percent')), |
|
393 | - new \Twig_Function('convert', array($this, 'convert')), |
|
394 | - new \Twig_Function('get_gravatar', array($this, 'get_gravatar')), |
|
395 | - new \Twig_Function('emp', array($this, 'emp')), |
|
396 | - new \Twig_Function('e_dynamic', array($this, 'e')), |
|
397 | - new \Twig_Function('all_full', array($this, 'all_full')), |
|
398 | - new \Twig_Function('fecha', array($this, 'fecha')), |
|
399 | - new \Twig_Function('base_assets', array($this, 'base_assets')), |
|
400 | - new \Twig_Function('timestamp', array($this, 'timestamp')), |
|
401 | - new \Twig_Function('desde_date', array($this, 'desde_date')), |
|
402 | - new \Twig_Function('cero_izq', array($this, 'cero_izq')), |
|
403 | - new \Twig_Function('last_day_month', array($this, 'last_day_month')), |
|
404 | - new \Twig_Function('str_to_time', array($this, 'str_to_time')), |
|
405 | - new \Twig_Function('desde_date', array($this, 'desde_date')) |
|
406 | - ); |
|
407 | - } |
|
408 | - |
|
409 | - //------------------------------------------------ |
|
392 | + new \Twig_Function('percent', array($this, 'percent')), |
|
393 | + new \Twig_Function('convert', array($this, 'convert')), |
|
394 | + new \Twig_Function('get_gravatar', array($this, 'get_gravatar')), |
|
395 | + new \Twig_Function('emp', array($this, 'emp')), |
|
396 | + new \Twig_Function('e_dynamic', array($this, 'e')), |
|
397 | + new \Twig_Function('all_full', array($this, 'all_full')), |
|
398 | + new \Twig_Function('fecha', array($this, 'fecha')), |
|
399 | + new \Twig_Function('base_assets', array($this, 'base_assets')), |
|
400 | + new \Twig_Function('timestamp', array($this, 'timestamp')), |
|
401 | + new \Twig_Function('desde_date', array($this, 'desde_date')), |
|
402 | + new \Twig_Function('cero_izq', array($this, 'cero_izq')), |
|
403 | + new \Twig_Function('last_day_month', array($this, 'last_day_month')), |
|
404 | + new \Twig_Function('str_to_time', array($this, 'str_to_time')), |
|
405 | + new \Twig_Function('desde_date', array($this, 'desde_date')) |
|
406 | + ); |
|
407 | + } |
|
408 | + |
|
409 | + //------------------------------------------------ |
|
410 | 410 | |
411 | 411 | /** |
412 | - * Identificador único para la extensión de twig |
|
413 | - * |
|
414 | - * @return string con el nombre de la extensión |
|
415 | - */ |
|
412 | + * Identificador único para la extensión de twig |
|
413 | + * |
|
414 | + * @return string con el nombre de la extensión |
|
415 | + */ |
|
416 | 416 | public function getName() : string { |
417 | 417 | return 'ocrend_framework_func_class'; |
418 | 418 | } |
@@ -20,14 +20,14 @@ discard block |
||
20 | 20 | final class Emails { |
21 | 21 | |
22 | 22 | /** |
23 | - * FUNCIÓN NO ACCESIBLE, USO ESTRICTO PARA UNA FUNCIÓN INTERNA DEL HELPER |
|
24 | - * Inicializa la clase PHPMailer y las configuraciones necesarias |
|
25 | - * Método privado utilizado en todo el Helper |
|
26 | - * |
|
27 | - * @param bool $is_smtp: Define si se hará la conexión a través de SMTP o no |
|
28 | - * |
|
29 | - * @return \PHPMailer un objeto de la clase PHPMailer |
|
30 | - */ |
|
23 | + * FUNCIÓN NO ACCESIBLE, USO ESTRICTO PARA UNA FUNCIÓN INTERNA DEL HELPER |
|
24 | + * Inicializa la clase PHPMailer y las configuraciones necesarias |
|
25 | + * Método privado utilizado en todo el Helper |
|
26 | + * |
|
27 | + * @param bool $is_smtp: Define si se hará la conexión a través de SMTP o no |
|
28 | + * |
|
29 | + * @return \PHPMailer un objeto de la clase PHPMailer |
|
30 | + */ |
|
31 | 31 | final private static function init(bool $is_smtp = true) : \PHPMailer { |
32 | 32 | global $config; |
33 | 33 | |
@@ -60,22 +60,22 @@ discard block |
||
60 | 60 | //------------------------------------------------ |
61 | 61 | |
62 | 62 | /** |
63 | - * Envía un correo electrónico utilizando PHPMailer |
|
64 | - * |
|
65 | - * @param array $dest: Arreglo con la forma array( |
|
66 | - * 'email destinatario 1' => 'nombre destinatario 1', |
|
67 | - * 'email destinatario 2' => 'nombre destinatario 2' |
|
68 | - * ) |
|
69 | - * @param string $HTML: Contenido en HTML del email |
|
70 | - * @param string $titulo: Asunto del email |
|
71 | - * @param bool $is_smtp: Define si se hará la conexión a través de SMTP o no |
|
72 | - * @param array $adj: Arreglo con direccion local de los adjuntos a enviar, con la forma array( |
|
73 | - * 'ruta archivo 1', |
|
74 | - * 'ruta archivo 2' |
|
75 | - * ) |
|
76 | - * |
|
77 | - * @return string|bool true si fue enviado correctamente, string con el Error descrito por PHPMailer |
|
78 | - */ |
|
63 | + * Envía un correo electrónico utilizando PHPMailer |
|
64 | + * |
|
65 | + * @param array $dest: Arreglo con la forma array( |
|
66 | + * 'email destinatario 1' => 'nombre destinatario 1', |
|
67 | + * 'email destinatario 2' => 'nombre destinatario 2' |
|
68 | + * ) |
|
69 | + * @param string $HTML: Contenido en HTML del email |
|
70 | + * @param string $titulo: Asunto del email |
|
71 | + * @param bool $is_smtp: Define si se hará la conexión a través de SMTP o no |
|
72 | + * @param array $adj: Arreglo con direccion local de los adjuntos a enviar, con la forma array( |
|
73 | + * 'ruta archivo 1', |
|
74 | + * 'ruta archivo 2' |
|
75 | + * ) |
|
76 | + * |
|
77 | + * @return string|bool true si fue enviado correctamente, string con el Error descrito por PHPMailer |
|
78 | + */ |
|
79 | 79 | final public static function send_mail(array $dest, string $HTML, string $titulo, bool $is_smtp = true, array $adj = []) { |
80 | 80 | global $config; |
81 | 81 |
@@ -40,13 +40,13 @@ discard block |
||
40 | 40 | //------------------------------------------------ |
41 | 41 | |
42 | 42 | /** |
43 | - * Escribe un string completo en un archivo, si este no existe lo crea |
|
44 | - * |
|
45 | - * @param string $dir: Directorio del archivo escribir/crear |
|
46 | - * @param string $content: Contenido a escribir |
|
47 | - * |
|
48 | - * @return int catidad de bytes escritos en el archivo |
|
49 | - */ |
|
43 | + * Escribe un string completo en un archivo, si este no existe lo crea |
|
44 | + * |
|
45 | + * @param string $dir: Directorio del archivo escribir/crear |
|
46 | + * @param string $content: Contenido a escribir |
|
47 | + * |
|
48 | + * @return int catidad de bytes escritos en el archivo |
|
49 | + */ |
|
50 | 50 | final public static function write_file(string $dir, string $content) : int { |
51 | 51 | $f = new \SplFileObject($dir,'w'); |
52 | 52 | return (int) $f->fwrite($content); |
@@ -74,12 +74,12 @@ discard block |
||
74 | 74 | //------------------------------------------------ |
75 | 75 | |
76 | 76 | /** |
77 | - * Devuelve la extensión de un archivo cualquiera, da igual si es solo el nombre o la ruta con el nombre |
|
78 | - * |
|
79 | - * @param string $file_name: Nombre del archivo, da igual si es solo el nombre o la ruta con el nombre |
|
80 | - * |
|
81 | - * @return mixed string con la extensión, devuelve un string '' si no existe información alguna acerca de la extensión |
|
82 | - */ |
|
77 | + * Devuelve la extensión de un archivo cualquiera, da igual si es solo el nombre o la ruta con el nombre |
|
78 | + * |
|
79 | + * @param string $file_name: Nombre del archivo, da igual si es solo el nombre o la ruta con el nombre |
|
80 | + * |
|
81 | + * @return mixed string con la extensión, devuelve un string '' si no existe información alguna acerca de la extensión |
|
82 | + */ |
|
83 | 83 | final public static function get_file_ext(string $file_name) { |
84 | 84 | return pathinfo($file_name, PATHINFO_EXTENSION); |
85 | 85 | } |
@@ -87,12 +87,12 @@ discard block |
||
87 | 87 | //------------------------------------------------ |
88 | 88 | |
89 | 89 | /** |
90 | - * Dice si un elemento es una imagen o no según su extensión |
|
91 | - * |
|
92 | - * @param string $file_name: Nombre del archivo, da igual si es solo el nombre o la ruta con el nombre |
|
93 | - * |
|
94 | - * @return bool true si es una imagen, false si no lo es |
|
95 | - */ |
|
90 | + * Dice si un elemento es una imagen o no según su extensión |
|
91 | + * |
|
92 | + * @param string $file_name: Nombre del archivo, da igual si es solo el nombre o la ruta con el nombre |
|
93 | + * |
|
94 | + * @return bool true si es una imagen, false si no lo es |
|
95 | + */ |
|
96 | 96 | final public static function is_image(string $file_name) : bool { |
97 | 97 | return (bool) in_array(self::get_file_ext($file_name), ['jpg', 'png', 'jpeg', 'gif', 'JPG', 'PNG', 'JPEG', 'GIF']); |
98 | 98 | } |
@@ -100,39 +100,39 @@ discard block |
||
100 | 100 | //------------------------------------------------ |
101 | 101 | |
102 | 102 | /** |
103 | - * Devuelve el tamaño en Kbytes de un fichero |
|
104 | - * |
|
105 | - * @param string $file: path del fichero |
|
106 | - * |
|
107 | - * @return int con el tamaño del fichero |
|
108 | - */ |
|
103 | + * Devuelve el tamaño en Kbytes de un fichero |
|
104 | + * |
|
105 | + * @param string $file: path del fichero |
|
106 | + * |
|
107 | + * @return int con el tamaño del fichero |
|
108 | + */ |
|
109 | 109 | final public static function file_size(string $file) : int { |
110 | - return (int) round(filesize($file)*0.0009765625, 1); |
|
110 | + return (int) round(filesize($file)*0.0009765625, 1); |
|
111 | 111 | } |
112 | 112 | |
113 | 113 | //------------------------------------------------ |
114 | 114 | |
115 | 115 | /** |
116 | - * Devuelve la fecha y hora exacta de creación de un fichero |
|
117 | - * |
|
118 | - * @param string $file: path del fichero |
|
119 | - * |
|
120 | - * @return string con la fecha del fichero en el formato d-m-y h:i:s |
|
121 | - */ |
|
116 | + * Devuelve la fecha y hora exacta de creación de un fichero |
|
117 | + * |
|
118 | + * @param string $file: path del fichero |
|
119 | + * |
|
120 | + * @return string con la fecha del fichero en el formato d-m-y h:i:s |
|
121 | + */ |
|
122 | 122 | final public static function date_file(string $file) : string { |
123 | - return date('d-m-Y h:i:s', filemtime($file)); |
|
123 | + return date('d-m-Y h:i:s', filemtime($file)); |
|
124 | 124 | } |
125 | 125 | |
126 | 126 | //------------------------------------------------ |
127 | 127 | |
128 | 128 | /** |
129 | - * Devuelve en un arreglo numérico, la ruta de todos los ficheros en un directorio filtrado por tipos |
|
130 | - * |
|
131 | - * @param string $dir: directorio completo |
|
132 | - * @param string $types: tipos de archivos a buscar, por defecto '' significa todos, se puede pasar por ejemplo 'jpg' |
|
133 | - * |
|
134 | - * @return array con las rutas de todos los ficheros encontrados, un array vacío si no encontró ficheros |
|
135 | - */ |
|
129 | + * Devuelve en un arreglo numérico, la ruta de todos los ficheros en un directorio filtrado por tipos |
|
130 | + * |
|
131 | + * @param string $dir: directorio completo |
|
132 | + * @param string $types: tipos de archivos a buscar, por defecto '' significa todos, se puede pasar por ejemplo 'jpg' |
|
133 | + * |
|
134 | + * @return array con las rutas de todos los ficheros encontrados, un array vacío si no encontró ficheros |
|
135 | + */ |
|
136 | 136 | final public static function get_files_in_dir(string $dir, string $types = '') : array { |
137 | 137 | $array = array(); |
138 | 138 | if (is_dir($dir)) { |
@@ -146,13 +146,13 @@ discard block |
||
146 | 146 | //------------------------------------------------ |
147 | 147 | |
148 | 148 | /** |
149 | - * Crea un directorio |
|
150 | - * |
|
151 | - * @param string $dir: Directorio a crear |
|
152 | - * @param int $permisos: Permisos del directorio a crear, por defecto es "todos los permisos" |
|
153 | - * |
|
154 | - * @return bool con true si fue creado con éxito, false si el directorio ya existía o hubo algún error |
|
155 | - */ |
|
149 | + * Crea un directorio |
|
150 | + * |
|
151 | + * @param string $dir: Directorio a crear |
|
152 | + * @param int $permisos: Permisos del directorio a crear, por defecto es "todos los permisos" |
|
153 | + * |
|
154 | + * @return bool con true si fue creado con éxito, false si el directorio ya existía o hubo algún error |
|
155 | + */ |
|
156 | 156 | final public static function create_dir(string $dir, int $permisos = 0755) : bool { |
157 | 157 | if(is_dir($dir)) { |
158 | 158 | return false; |
@@ -248,10 +248,10 @@ discard block |
||
248 | 248 | //------------------------------------------------ |
249 | 249 | |
250 | 250 | /** |
251 | - * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig |
|
252 | - * |
|
253 | - * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig |
|
254 | - */ |
|
251 | + * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig |
|
252 | + * |
|
253 | + * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig |
|
254 | + */ |
|
255 | 255 | public function getFunctions() : array { |
256 | 256 | return array( |
257 | 257 | new \Twig_Function('images_in_dir', array($this, 'images_in_dir')), |
@@ -266,10 +266,10 @@ discard block |
||
266 | 266 | //------------------------------------------------ |
267 | 267 | |
268 | 268 | /** |
269 | - * Identificador único para la extensión de twig |
|
270 | - * |
|
271 | - * @return string con el nombre de la extensión |
|
272 | - */ |
|
269 | + * Identificador único para la extensión de twig |
|
270 | + * |
|
271 | + * @return string con el nombre de la extensión |
|
272 | + */ |
|
273 | 273 | public function getName() : string { |
274 | 274 | return 'ocrend_framework_helper_files'; |
275 | 275 | } |
@@ -25,65 +25,65 @@ |
||
25 | 25 | abstract class Controllers { |
26 | 26 | |
27 | 27 | /** |
28 | - * Obtiene el objeto del template |
|
29 | - * |
|
30 | - * @var \Twig_Environment |
|
31 | - */ |
|
28 | + * Obtiene el objeto del template |
|
29 | + * |
|
30 | + * @var \Twig_Environment |
|
31 | + */ |
|
32 | 32 | protected $template; |
33 | 33 | |
34 | 34 | /** |
35 | - * Verifica si está definida la ruta /id como un integer >= 1 |
|
36 | - * |
|
37 | - * @var bool |
|
38 | - */ |
|
35 | + * Verifica si está definida la ruta /id como un integer >= 1 |
|
36 | + * |
|
37 | + * @var bool |
|
38 | + */ |
|
39 | 39 | protected $isset_id = false; |
40 | 40 | |
41 | 41 | /** |
42 | - * Tiene el valor de la ruta /método |
|
43 | - * |
|
44 | - * @var string|null |
|
45 | - */ |
|
42 | + * Tiene el valor de la ruta /método |
|
43 | + * |
|
44 | + * @var string|null |
|
45 | + */ |
|
46 | 46 | protected $method; |
47 | 47 | |
48 | 48 | /** |
49 | - * Contiene una instancia del helper para funciones |
|
50 | - * |
|
51 | - * @var \Ocrend\Kernel\Helpers\Functions |
|
52 | - */ |
|
49 | + * Contiene una instancia del helper para funciones |
|
50 | + * |
|
51 | + * @var \Ocrend\Kernel\Helpers\Functions |
|
52 | + */ |
|
53 | 53 | protected $functions; |
54 | 54 | |
55 | 55 | /** |
56 | - * Arreglo con la información del usuario conectado actualmente. |
|
57 | - * |
|
58 | - * @var array |
|
59 | - */ |
|
56 | + * Arreglo con la información del usuario conectado actualmente. |
|
57 | + * |
|
58 | + * @var array |
|
59 | + */ |
|
60 | 60 | protected $user = array(); |
61 | 61 | |
62 | 62 | /** |
63 | - * Contiene información sobre el estado del usuario, si está o no conectado. |
|
64 | - * |
|
65 | - * @var bool |
|
66 | - */ |
|
63 | + * Contiene información sobre el estado del usuario, si está o no conectado. |
|
64 | + * |
|
65 | + * @var bool |
|
66 | + */ |
|
67 | 67 | private $is_logged = false; |
68 | 68 | |
69 | 69 | /** |
70 | - * Parámetros de configuración para el controlador con la forma: |
|
71 | - * 'parmáetro' => (bool) valor |
|
72 | - * |
|
73 | - * @var array |
|
74 | - */ |
|
70 | + * Parámetros de configuración para el controlador con la forma: |
|
71 | + * 'parmáetro' => (bool) valor |
|
72 | + * |
|
73 | + * @var array |
|
74 | + */ |
|
75 | 75 | private $controllerConfig; |
76 | 76 | |
77 | 77 | /** |
78 | - * Configuración inicial de cualquier controlador |
|
79 | - * |
|
80 | - * @param IRouter $router: Instancia de un Router |
|
81 | - * @param array|null $configController: Arreglo de configuración con la forma |
|
82 | - * 'twig_cache_reload' => bool, # Configura el autoreload del caché de twig |
|
83 | - * 'users_logged' => bool, # Configura el controlador para solo ser visto por usuarios logeados |
|
84 | - * 'users_not_logged' => bool, # Configura el controlador para solo ser visto por !(usuarios logeados) |
|
85 | - * |
|
86 | - */ |
|
78 | + * Configuración inicial de cualquier controlador |
|
79 | + * |
|
80 | + * @param IRouter $router: Instancia de un Router |
|
81 | + * @param array|null $configController: Arreglo de configuración con la forma |
|
82 | + * 'twig_cache_reload' => bool, # Configura el autoreload del caché de twig |
|
83 | + * 'users_logged' => bool, # Configura el controlador para solo ser visto por usuarios logeados |
|
84 | + * 'users_not_logged' => bool, # Configura el controlador para solo ser visto por !(usuarios logeados) |
|
85 | + * |
|
86 | + */ |
|
87 | 87 | protected function __construct(IRouter $router, $configController = null) { |
88 | 88 | global $config, $http, $session; |
89 | 89 |
@@ -50,16 +50,16 @@ discard block |
||
50 | 50 | } |
51 | 51 | |
52 | 52 | /** |
53 | - * Inicia la conexión con la base de datos seleccionada |
|
54 | - * |
|
55 | - * @param string|null $name : Nombre de la base de datos a conectar |
|
56 | - * @param string|null $motor: Motor de la base de datos a conectar |
|
57 | - * @param bool $new_instance: true para iniciar una nueva instancia (al querer conectar a una DB distinta) |
|
58 | - * |
|
59 | - * @throws \RuntimeException si el motor no existe |
|
60 | - * @throws \RuntimeException si existe algún problema de conexión con la base de datos |
|
61 | - * @return Database : Instancia de conexión |
|
62 | - */ |
|
53 | + * Inicia la conexión con la base de datos seleccionada |
|
54 | + * |
|
55 | + * @param string|null $name : Nombre de la base de datos a conectar |
|
56 | + * @param string|null $motor: Motor de la base de datos a conectar |
|
57 | + * @param bool $new_instance: true para iniciar una nueva instancia (al querer conectar a una DB distinta) |
|
58 | + * |
|
59 | + * @throws \RuntimeException si el motor no existe |
|
60 | + * @throws \RuntimeException si existe algún problema de conexión con la base de datos |
|
61 | + * @return Database : Instancia de conexión |
|
62 | + */ |
|
63 | 63 | final public function __construct(string $name, string $motor) { |
64 | 64 | global $config; |
65 | 65 | |
@@ -134,34 +134,34 @@ discard block |
||
134 | 134 | } |
135 | 135 | |
136 | 136 | /** |
137 | - * Convierte en arreglo asociativo de todos los resultados arrojados por una query |
|
138 | - * |
|
139 | - * @param object \PDOStatement $query, valor devuelto de la query |
|
140 | - * |
|
141 | - * @return array arreglo asociativo |
|
142 | - */ |
|
137 | + * Convierte en arreglo asociativo de todos los resultados arrojados por una query |
|
138 | + * |
|
139 | + * @param object \PDOStatement $query, valor devuelto de la query |
|
140 | + * |
|
141 | + * @return array arreglo asociativo |
|
142 | + */ |
|
143 | 143 | final public function fetch_array(\PDOStatement $query) : array { |
144 | 144 | return $query->fetchAll(\PDO::FETCH_ASSOC); |
145 | 145 | } |
146 | 146 | |
147 | - /** |
|
148 | - * Cantidad de filas encontradas después de un SELECT |
|
149 | - * |
|
150 | - * @param object \PDOStatement $query, valor devuelto de la query |
|
151 | - * |
|
152 | - * @return int numero de filas encontradas |
|
153 | - */ |
|
147 | + /** |
|
148 | + * Cantidad de filas encontradas después de un SELECT |
|
149 | + * |
|
150 | + * @param object \PDOStatement $query, valor devuelto de la query |
|
151 | + * |
|
152 | + * @return int numero de filas encontradas |
|
153 | + */ |
|
154 | 154 | final public function rows(\PDOStatement $query) : int { |
155 | 155 | return $query->rowCount(); |
156 | 156 | } |
157 | 157 | |
158 | 158 | /** |
159 | - * Sana un valor para posteriormente ser introducido en una query |
|
160 | - * |
|
161 | - * @param null/string/int/float a sanar |
|
162 | - * |
|
163 | - * @return mixed elemento sano |
|
164 | - */ |
|
159 | + * Sana un valor para posteriormente ser introducido en una query |
|
160 | + * |
|
161 | + * @param null/string/int/float a sanar |
|
162 | + * |
|
163 | + * @return mixed elemento sano |
|
164 | + */ |
|
165 | 165 | final public function scape($e) { |
166 | 166 | if (null === $e) { |
167 | 167 | return ''; |
@@ -178,28 +178,28 @@ discard block |
||
178 | 178 | } |
179 | 179 | |
180 | 180 | /** |
181 | - * Borra una serie de elementos de forma segura de una tabla en la base de datos |
|
182 | - * |
|
183 | - * @param string $table: Tabla a la cual se le quiere remover un elemento |
|
184 | - * @param string $where: Condición de borrado que define quien/quienes son dichos elementos |
|
185 | - * @param string $limit: Por defecto se limita a borrar un solo elemento que cumpla el $where |
|
186 | - * |
|
187 | - * @return \PDOStatement |
|
188 | - */ |
|
181 | + * Borra una serie de elementos de forma segura de una tabla en la base de datos |
|
182 | + * |
|
183 | + * @param string $table: Tabla a la cual se le quiere remover un elemento |
|
184 | + * @param string $where: Condición de borrado que define quien/quienes son dichos elementos |
|
185 | + * @param string $limit: Por defecto se limita a borrar un solo elemento que cumpla el $where |
|
186 | + * |
|
187 | + * @return \PDOStatement |
|
188 | + */ |
|
189 | 189 | final public function delete(string $table, string $where, string $limit = 'LIMIT 1') : \PDOStatement { |
190 | 190 | return $this->query("DELETE FROM $table WHERE $where $limit;"); |
191 | 191 | } |
192 | 192 | |
193 | 193 | /** |
194 | - * Inserta una serie de elementos a una tabla en la base de datos |
|
195 | - * |
|
196 | - * @param string $table: Tabla a la cual se le va a insertar elementos |
|
197 | - * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo', |
|
198 | - * todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo |
|
199 | - * |
|
200 | - * @throws \RuntimeException si el arreglo está vacío |
|
201 | - * @return \PDOStatement |
|
202 | - */ |
|
194 | + * Inserta una serie de elementos a una tabla en la base de datos |
|
195 | + * |
|
196 | + * @param string $table: Tabla a la cual se le va a insertar elementos |
|
197 | + * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo', |
|
198 | + * todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo |
|
199 | + * |
|
200 | + * @throws \RuntimeException si el arreglo está vacío |
|
201 | + * @return \PDOStatement |
|
202 | + */ |
|
203 | 203 | final public function insert(string $table, array $e) : \PDOStatement { |
204 | 204 | if (sizeof($e) == 0) { |
205 | 205 | throw new \RuntimeException('El arreglo pasado por $this->db->insert(\'' . $table . '\',...) está vacío.'); |
@@ -219,17 +219,17 @@ discard block |
||
219 | 219 | } |
220 | 220 | |
221 | 221 | /** |
222 | - * Actualiza elementos de una tabla en la base de datos según una condición |
|
223 | - * |
|
224 | - * @param string $table: Tabla a actualizar |
|
225 | - * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo', |
|
226 | - * todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo |
|
227 | - * @param string $where: Condición que indica quienes serán modificados |
|
228 | - * @param string $limite: Límite de elementos modificados, por defecto los modifica a todos |
|
229 | - * |
|
230 | - * @throws \RuntimeException si el arreglo está vacío |
|
231 | - * @return \PDOStatement |
|
232 | - */ |
|
222 | + * Actualiza elementos de una tabla en la base de datos según una condición |
|
223 | + * |
|
224 | + * @param string $table: Tabla a actualizar |
|
225 | + * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo', |
|
226 | + * todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo |
|
227 | + * @param string $where: Condición que indica quienes serán modificados |
|
228 | + * @param string $limite: Límite de elementos modificados, por defecto los modifica a todos |
|
229 | + * |
|
230 | + * @throws \RuntimeException si el arreglo está vacío |
|
231 | + * @return \PDOStatement |
|
232 | + */ |
|
233 | 233 | final public function update(string $table, array $e, string $where, string $limit = '') : \PDOStatement { |
234 | 234 | if (sizeof($e) == 0) { |
235 | 235 | throw new \RuntimeException('El arreglo pasado por $this->db->update(\'' . $table . '\'...) está vacío.'); |
@@ -246,24 +246,24 @@ discard block |
||
246 | 246 | } |
247 | 247 | |
248 | 248 | /** |
249 | - * Selecciona y lista en un arreglo asociativo/numérico los resultados de una búsqueda en la base de datos |
|
250 | - * |
|
251 | - * @param string $e: Elementos a seleccionar separados por coma |
|
252 | - * @param string $tbale: Tabla de la cual se quiere extraer los elementos $e |
|
253 | - * @param string $where: Condición que indica quienes son los que se extraen, si no se coloca extrae todos |
|
254 | - * @param string $limite: Límite de elemntos a traer, por defecto trae TODOS los que cumplan $where |
|
255 | - * |
|
256 | - * @return mixed false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno |
|
257 | - */ |
|
249 | + * Selecciona y lista en un arreglo asociativo/numérico los resultados de una búsqueda en la base de datos |
|
250 | + * |
|
251 | + * @param string $e: Elementos a seleccionar separados por coma |
|
252 | + * @param string $tbale: Tabla de la cual se quiere extraer los elementos $e |
|
253 | + * @param string $where: Condición que indica quienes son los que se extraen, si no se coloca extrae todos |
|
254 | + * @param string $limite: Límite de elemntos a traer, por defecto trae TODOS los que cumplan $where |
|
255 | + * |
|
256 | + * @return mixed false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno |
|
257 | + */ |
|
258 | 258 | final public function select(string $e, string $table, string $where = '1 = 1', string $limit = "") { |
259 | 259 | return $this->query_select("SELECT $e FROM $table WHERE $where $limit;"); |
260 | 260 | } |
261 | 261 | |
262 | - /** |
|
263 | - * Realiza una query, ideal para trabajar con SELECTS, JOINS, etc |
|
264 | - * |
|
265 | - * @return array|false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno |
|
266 | - */ |
|
262 | + /** |
|
263 | + * Realiza una query, ideal para trabajar con SELECTS, JOINS, etc |
|
264 | + * |
|
265 | + * @return array|false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno |
|
266 | + */ |
|
267 | 267 | final public function query_select(string $query) { |
268 | 268 | $sql = $this->query($query); |
269 | 269 | $result = $sql->fetchAll(); |
@@ -277,13 +277,13 @@ discard block |
||
277 | 277 | } |
278 | 278 | |
279 | 279 | /** |
280 | - * Alert para evitar clonaciones |
|
281 | - * |
|
282 | - * @throws \RuntimeException si se intenta clonar la conexión |
|
283 | - * @return void |
|
284 | - */ |
|
280 | + * Alert para evitar clonaciones |
|
281 | + * |
|
282 | + * @throws \RuntimeException si se intenta clonar la conexión |
|
283 | + * @return void |
|
284 | + */ |
|
285 | 285 | final public function __clone() { |
286 | 286 | throw new \RuntimeException('Estás intentando clonar la Conexión'); |
287 | 287 | } |
288 | 288 | |
289 | - } |
|
290 | 289 | \ No newline at end of file |
290 | + } |
|
291 | 291 | \ No newline at end of file |