@@ -20,89 +20,89 @@ |
||
| 20 | 20 | final class Rules { |
| 21 | 21 | |
| 22 | 22 | /** |
| 23 | - * Sin ninguna regla |
|
| 24 | - * |
|
| 25 | - * @param mixed $ruta : Ruta a aplicar la regla |
|
| 26 | - * |
|
| 27 | - * @return mixed |
|
| 28 | - */ |
|
| 23 | + * Sin ninguna regla |
|
| 24 | + * |
|
| 25 | + * @param mixed $ruta : Ruta a aplicar la regla |
|
| 26 | + * |
|
| 27 | + * @return mixed |
|
| 28 | + */ |
|
| 29 | 29 | final public function none($ruta) { |
| 30 | 30 | return $ruta; |
| 31 | 31 | } |
| 32 | 32 | |
| 33 | 33 | /** |
| 34 | - * Sólamente letras |
|
| 35 | - * |
|
| 36 | - * @param mixed $ruta : Ruta a aplicar la regla |
|
| 37 | - * |
|
| 38 | - * @return mixed |
|
| 39 | - */ |
|
| 34 | + * Sólamente letras |
|
| 35 | + * |
|
| 36 | + * @param mixed $ruta : Ruta a aplicar la regla |
|
| 37 | + * |
|
| 38 | + * @return mixed |
|
| 39 | + */ |
|
| 40 | 40 | final public function letters($ruta) { |
| 41 | 41 | return preg_match("/^[a-zA-Z ]*$/", $ruta) ? $ruta : null; |
| 42 | 42 | } |
| 43 | 43 | |
| 44 | 44 | /** |
| 45 | - * Letras y números |
|
| 46 | - * |
|
| 47 | - * @param mixed $ruta : Ruta a aplicar la regla |
|
| 48 | - * |
|
| 49 | - * @return mixed |
|
| 50 | - */ |
|
| 45 | + * Letras y números |
|
| 46 | + * |
|
| 47 | + * @param mixed $ruta : Ruta a aplicar la regla |
|
| 48 | + * |
|
| 49 | + * @return mixed |
|
| 50 | + */ |
|
| 51 | 51 | final public function alphanumeric($ruta) { |
| 52 | 52 | return preg_match('/^[a-zA-Z0-9 ]*$/', $ruta) ? $ruta : null; |
| 53 | 53 | } |
| 54 | 54 | |
| 55 | 55 | /** |
| 56 | - * Con forma para URL (letras,números y el caracter -) |
|
| 57 | - * |
|
| 58 | - * @param mixed $ruta : Ruta a aplicar la regla |
|
| 59 | - * |
|
| 60 | - * @return mixed |
|
| 61 | - */ |
|
| 56 | + * Con forma para URL (letras,números y el caracter -) |
|
| 57 | + * |
|
| 58 | + * @param mixed $ruta : Ruta a aplicar la regla |
|
| 59 | + * |
|
| 60 | + * @return mixed |
|
| 61 | + */ |
|
| 62 | 62 | final public function url($ruta) { |
| 63 | 63 | return preg_match('/^[a-zA-Z0-9- ]*$/', $ruta) ? $ruta : null; |
| 64 | 64 | } |
| 65 | 65 | |
| 66 | 66 | /** |
| 67 | - * Sólamente números enteros |
|
| 68 | - * |
|
| 69 | - * @param mixed $ruta : Ruta a aplicar la regla |
|
| 70 | - * |
|
| 71 | - * @return int|null |
|
| 72 | - */ |
|
| 67 | + * Sólamente números enteros |
|
| 68 | + * |
|
| 69 | + * @param mixed $ruta : Ruta a aplicar la regla |
|
| 70 | + * |
|
| 71 | + * @return int|null |
|
| 72 | + */ |
|
| 73 | 73 | final public function integer($ruta) { |
| 74 | 74 | return is_numeric($ruta) ? (int) $ruta : null; |
| 75 | 75 | } |
| 76 | 76 | |
| 77 | 77 | /** |
| 78 | - * Solamente números enteros positivos |
|
| 79 | - * |
|
| 80 | - * @param mixed $ruta : Ruta a aplicar la regla |
|
| 81 | - * |
|
| 82 | - * @return int|null |
|
| 83 | - */ |
|
| 78 | + * Solamente números enteros positivos |
|
| 79 | + * |
|
| 80 | + * @param mixed $ruta : Ruta a aplicar la regla |
|
| 81 | + * |
|
| 82 | + * @return int|null |
|
| 83 | + */ |
|
| 84 | 84 | final public function integer_positive($ruta) { |
| 85 | 85 | return (is_numeric($ruta) && $ruta >= 0) ? (int) $ruta : null; |
| 86 | 86 | } |
| 87 | 87 | |
| 88 | 88 | /** |
| 89 | - * Solamente números con decimal |
|
| 90 | - * |
|
| 91 | - * @param mixed $ruta : Ruta a aplicar la regla |
|
| 92 | - * |
|
| 93 | - * @return float|null |
|
| 94 | - */ |
|
| 89 | + * Solamente números con decimal |
|
| 90 | + * |
|
| 91 | + * @param mixed $ruta : Ruta a aplicar la regla |
|
| 92 | + * |
|
| 93 | + * @return float|null |
|
| 94 | + */ |
|
| 95 | 95 | final public function float($ruta) { |
| 96 | 96 | return is_numeric($ruta) ? (float) $ruta : null; |
| 97 | 97 | } |
| 98 | 98 | |
| 99 | 99 | /** |
| 100 | - * Solamente números con decimal y positivos |
|
| 101 | - * |
|
| 102 | - * @param mixed $ruta : Ruta a aplicar la regla |
|
| 103 | - * |
|
| 104 | - * @return float|null |
|
| 105 | - */ |
|
| 100 | + * Solamente números con decimal y positivos |
|
| 101 | + * |
|
| 102 | + * @param mixed $ruta : Ruta a aplicar la regla |
|
| 103 | + * |
|
| 104 | + * @return float|null |
|
| 105 | + */ |
|
| 106 | 106 | final public function float_positive($ruta) { |
| 107 | 107 | return (is_numeric($ruta) && $ruta >= 0) ? (float) $ruta : null; |
| 108 | 108 | } |
@@ -20,13 +20,13 @@ discard block |
||
| 20 | 20 | final class Strings extends \Twig_Extension { |
| 21 | 21 | //------------------------------------------------ |
| 22 | 22 | /** |
| 23 | - * Convierte un tiempo dado al formato hace 1 minuto, hace 2 horas, hace 1 año ... |
|
| 24 | - * |
|
| 25 | - * @param int $from: Tiempo en segundo desde donde se desea contar |
|
| 26 | - * @param int $to: Tiempo en segundo hasta donde se desea contar, si no se pasa por defecto es el tiempo actual |
|
| 27 | - * |
|
| 28 | - * @return string con la forma: hace 20 segundos, hace 1 minuto, hace 2 horas, hace 4 días, hace 1 semana, hace 3 meses, hace 1 año ... |
|
| 29 | - */ |
|
| 23 | + * Convierte un tiempo dado al formato hace 1 minuto, hace 2 horas, hace 1 año ... |
|
| 24 | + * |
|
| 25 | + * @param int $from: Tiempo en segundo desde donde se desea contar |
|
| 26 | + * @param int $to: Tiempo en segundo hasta donde se desea contar, si no se pasa por defecto es el tiempo actual |
|
| 27 | + * |
|
| 28 | + * @return string con la forma: hace 20 segundos, hace 1 minuto, hace 2 horas, hace 4 días, hace 1 semana, hace 3 meses, hace 1 año ... |
|
| 29 | + */ |
|
| 30 | 30 | final public static function amigable_time(int $from, int $to = 0) : string { |
| 31 | 31 | $intervalos = array("segundo", "minuto", "hora", "día", "semana", "mes", "año"); |
| 32 | 32 | $duraciones = array("60","60","24","7","4.35","12"); |
@@ -59,39 +59,39 @@ discard block |
||
| 59 | 59 | } |
| 60 | 60 | //------------------------------------------------ |
| 61 | 61 | /** |
| 62 | - * Compara un string hash con un string sin hash, si el string sin hash al encriptar posee la misma llave que hash, son iguales |
|
| 63 | - * |
|
| 64 | - * @param string $hash: Hash con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G |
|
| 65 | - * @param string $s2: Cadena de texto a comparar |
|
| 66 | - * |
|
| 67 | - * @example Strings::chash('$2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G','123456'); //return true |
|
| 68 | - * |
|
| 69 | - * @return bool true si $s2 contiene la misma llave que $hash, por tanto el contenido de $hash es $s2, de lo contrario false |
|
| 70 | - */ |
|
| 62 | + * Compara un string hash con un string sin hash, si el string sin hash al encriptar posee la misma llave que hash, son iguales |
|
| 63 | + * |
|
| 64 | + * @param string $hash: Hash con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G |
|
| 65 | + * @param string $s2: Cadena de texto a comparar |
|
| 66 | + * |
|
| 67 | + * @example Strings::chash('$2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G','123456'); //return true |
|
| 68 | + * |
|
| 69 | + * @return bool true si $s2 contiene la misma llave que $hash, por tanto el contenido de $hash es $s2, de lo contrario false |
|
| 70 | + */ |
|
| 71 | 71 | final public static function chash(string $hash, string $s2) : bool { |
| 72 | 72 | return $hash == crypt($s2, substr($hash, 0, 29)); |
| 73 | - } |
|
| 74 | - //------------------------------------------------ |
|
| 73 | + } |
|
| 74 | + //------------------------------------------------ |
|
| 75 | 75 | /** |
| 76 | - * Devuelve un hash DINÁMICO, para comparar un hash con un elemento se utiliza chash |
|
| 77 | - * |
|
| 78 | - * @param string $p: Cadena de texto a encriptar |
|
| 79 | - * |
|
| 80 | - * @return string Hash, con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G |
|
| 81 | - */ |
|
| 76 | + * Devuelve un hash DINÁMICO, para comparar un hash con un elemento se utiliza chash |
|
| 77 | + * |
|
| 78 | + * @param string $p: Cadena de texto a encriptar |
|
| 79 | + * |
|
| 80 | + * @return string Hash, con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G |
|
| 81 | + */ |
|
| 82 | 82 | final public static function hash(string $p) : string { |
| 83 | 83 | return crypt($p, '$2a$10$' . substr(sha1(mt_rand()), 0, 22)); |
| 84 | 84 | } |
| 85 | 85 | //------------------------------------------------ |
| 86 | 86 | /** |
| 87 | - * Calcula el tiempo de diferencia entre dos fechas |
|
| 88 | - * |
|
| 89 | - * @param string $ini: Fecha menor con el formato d-m-Y ó d/m/Y |
|
| 90 | - * @param string $fin: Fecha mayor con el formato d-m-Y ó d/m/Y |
|
| 91 | - * |
|
| 92 | - * @return int con la diferencia de tiempo en días |
|
| 93 | - * |
|
| 94 | - */ |
|
| 87 | + * Calcula el tiempo de diferencia entre dos fechas |
|
| 88 | + * |
|
| 89 | + * @param string $ini: Fecha menor con el formato d-m-Y ó d/m/Y |
|
| 90 | + * @param string $fin: Fecha mayor con el formato d-m-Y ó d/m/Y |
|
| 91 | + * |
|
| 92 | + * @return int con la diferencia de tiempo en días |
|
| 93 | + * |
|
| 94 | + */ |
|
| 95 | 95 | final public static function date_difference(string $ini, string $fin) : int { |
| 96 | 96 | $ini_i = explode('-',str_replace('/','-',$ini)); |
| 97 | 97 | $fin_i = explode('-',str_replace('/','-',$fin)); |
@@ -99,90 +99,90 @@ discard block |
||
| 99 | 99 | } |
| 100 | 100 | //------------------------------------------------ |
| 101 | 101 | /** |
| 102 | - * Calcula la edad de una persona segun la fecha de nacimiento |
|
| 103 | - * |
|
| 104 | - * @param string $cumple: Fecha de nacimiento con el formato d-m-Y ó d/m/Y |
|
| 105 | - * |
|
| 106 | - * @return int con la edad |
|
| 107 | - * |
|
| 108 | - */ |
|
| 102 | + * Calcula la edad de una persona segun la fecha de nacimiento |
|
| 103 | + * |
|
| 104 | + * @param string $cumple: Fecha de nacimiento con el formato d-m-Y ó d/m/Y |
|
| 105 | + * |
|
| 106 | + * @return int con la edad |
|
| 107 | + * |
|
| 108 | + */ |
|
| 109 | 109 | final public static function calculate_age(string $cumple) : int { |
| 110 | 110 | $age = explode('.', (string) (self::date_difference($cumple, date('d-m-Y', time()))/365)); |
| 111 | 111 | return (int) $age[0]; |
| 112 | 112 | } |
| 113 | 113 | //------------------------------------------------ |
| 114 | 114 | /** |
| 115 | - * Calcula cuántos días tiene el mes actual |
|
| 116 | - * |
|
| 117 | - * @return integer con la cantidad de días del mes |
|
| 118 | - * |
|
| 119 | - */ |
|
| 115 | + * Calcula cuántos días tiene el mes actual |
|
| 116 | + * |
|
| 117 | + * @return integer con la cantidad de días del mes |
|
| 118 | + * |
|
| 119 | + */ |
|
| 120 | 120 | final public static function days_of_month() : int { |
| 121 | 121 | return cal_days_in_month(CAL_GREGORIAN, (int) date('m',time()), (int) date('Y',time())); |
| 122 | 122 | } |
| 123 | 123 | //------------------------------------------------ |
| 124 | 124 | /** |
| 125 | - * Verifica si una cadena de texto tiene forma de email |
|
| 126 | - * |
|
| 127 | - * @param string $address: Cadena de texto con el email |
|
| 128 | - * |
|
| 129 | - * @return mixed devuelve TRUE si es un email y FALSE si no lo es |
|
| 130 | - */ |
|
| 125 | + * Verifica si una cadena de texto tiene forma de email |
|
| 126 | + * |
|
| 127 | + * @param string $address: Cadena de texto con el email |
|
| 128 | + * |
|
| 129 | + * @return mixed devuelve TRUE si es un email y FALSE si no lo es |
|
| 130 | + */ |
|
| 131 | 131 | final public static function is_email(string $address) { |
| 132 | 132 | return filter_var($address, FILTER_VALIDATE_EMAIL); |
| 133 | 133 | } |
| 134 | 134 | //------------------------------------------------ |
| 135 | 135 | /** |
| 136 | - * Remueve todos los espacios en blanco de un string |
|
| 137 | - * |
|
| 138 | - * @param string $s: Cadena de texto a convertir |
|
| 139 | - * |
|
| 140 | - * @return string del texto sin espacios |
|
| 141 | - */ |
|
| 136 | + * Remueve todos los espacios en blanco de un string |
|
| 137 | + * |
|
| 138 | + * @param string $s: Cadena de texto a convertir |
|
| 139 | + * |
|
| 140 | + * @return string del texto sin espacios |
|
| 141 | + */ |
|
| 142 | 142 | final public static function remove_spaces(string $s) : string { |
| 143 | 143 | return trim(str_replace(' ', '', $s)); |
| 144 | 144 | } |
| 145 | 145 | //------------------------------------------------ |
| 146 | 146 | /** |
| 147 | - * Analiza si una cadena de texto es alfanumérica |
|
| 148 | - * |
|
| 149 | - * @param string $s: Cadena de texto a verificar |
|
| 150 | - * |
|
| 151 | - * @return bool, verdadero si es alfanumerica, falso si no |
|
| 152 | - */ |
|
| 147 | + * Analiza si una cadena de texto es alfanumérica |
|
| 148 | + * |
|
| 149 | + * @param string $s: Cadena de texto a verificar |
|
| 150 | + * |
|
| 151 | + * @return bool, verdadero si es alfanumerica, falso si no |
|
| 152 | + */ |
|
| 153 | 153 | final public static function alphanumeric(string $s) : bool { |
| 154 | 154 | return ctype_alnum(self::remove_spaces($s)); |
| 155 | 155 | } |
| 156 | 156 | //------------------------------------------------ |
| 157 | 157 | /** |
| 158 | - * Analiza si una cadena de texto verificando si sólamente tiene letras |
|
| 159 | - * |
|
| 160 | - * @param string $s: Cadena de texto a verificar |
|
| 161 | - * |
|
| 162 | - * @return bool, verdadero si sólamente tiene letras, falso si no |
|
| 163 | - */ |
|
| 158 | + * Analiza si una cadena de texto verificando si sólamente tiene letras |
|
| 159 | + * |
|
| 160 | + * @param string $s: Cadena de texto a verificar |
|
| 161 | + * |
|
| 162 | + * @return bool, verdadero si sólamente tiene letras, falso si no |
|
| 163 | + */ |
|
| 164 | 164 | final public static function only_letters(string $s) : bool { |
| 165 | 165 | return ctype_alpha(self::remove_spaces($s)); |
| 166 | 166 | } |
| 167 | 167 | //------------------------------------------------ |
| 168 | 168 | /** |
| 169 | - * Analiza si una cadena de texto contiene sólamente letras y números |
|
| 170 | - * |
|
| 171 | - * @param string $s: Cadena de texto a verificar |
|
| 172 | - * |
|
| 173 | - * @return bool, verdadero si sólamente contiene letras y números, falso si no |
|
| 174 | - */ |
|
| 169 | + * Analiza si una cadena de texto contiene sólamente letras y números |
|
| 170 | + * |
|
| 171 | + * @param string $s: Cadena de texto a verificar |
|
| 172 | + * |
|
| 173 | + * @return bool, verdadero si sólamente contiene letras y números, falso si no |
|
| 174 | + */ |
|
| 175 | 175 | final public static function letters_and_numbers(string $s) : bool { |
| 176 | 176 | return (boolean) preg_match('/^[\w.]*$/', self::remove_spaces($s)); |
| 177 | 177 | } |
| 178 | 178 | //------------------------------------------------ |
| 179 | 179 | /** |
| 180 | - * Convierte una expresión de texto, a una compatible con url amigables |
|
| 181 | - * |
|
| 182 | - * @param string $url: Cadena de texto a convertir |
|
| 183 | - * |
|
| 184 | - * @return string Cadena de texto con formato de url amigable |
|
| 185 | - */ |
|
| 180 | + * Convierte una expresión de texto, a una compatible con url amigables |
|
| 181 | + * |
|
| 182 | + * @param string $url: Cadena de texto a convertir |
|
| 183 | + * |
|
| 184 | + * @return string Cadena de texto con formato de url amigable |
|
| 185 | + */ |
|
| 186 | 186 | final public static function url_amigable(string $url) : string { |
| 187 | 187 | $url = strtolower($url); |
| 188 | 188 | $url = str_replace(['á', 'é', 'í', 'ó', 'ú', 'ñ'], ['a', 'e', 'i', 'o', 'u', 'n'], $url); |
@@ -244,58 +244,58 @@ discard block |
||
| 244 | 244 | } |
| 245 | 245 | //------------------------------------------------ |
| 246 | 246 | /** |
| 247 | - * Dice si un string comienza con un caracter especificado |
|
| 248 | - * |
|
| 249 | - * @param string $sx: Caracter de inicio |
|
| 250 | - * @param string $str: String a evaluar |
|
| 251 | - * @param bool $case_sensitive: Boolean para definir si será seible a mayúsculas o no |
|
| 252 | - * |
|
| 253 | - * @return bool True si comienza con el caracter especificado, False si no |
|
| 254 | - */ |
|
| 247 | + * Dice si un string comienza con un caracter especificado |
|
| 248 | + * |
|
| 249 | + * @param string $sx: Caracter de inicio |
|
| 250 | + * @param string $str: String a evaluar |
|
| 251 | + * @param bool $case_sensitive: Boolean para definir si será seible a mayúsculas o no |
|
| 252 | + * |
|
| 253 | + * @return bool True si comienza con el caracter especificado, False si no |
|
| 254 | + */ |
|
| 255 | 255 | final public static function begin_with(string $sx, string $str) : bool { |
| 256 | 256 | return (bool) (strlen($str) > 0 and $str[0] == $sx); |
| 257 | 257 | } |
| 258 | 258 | //------------------------------------------------ |
| 259 | 259 | /** |
| 260 | - * Dice si un string termina con una caracter especificado |
|
| 261 | - * |
|
| 262 | - * @param string $sx: Caracter del final |
|
| 263 | - * @param string $str: String a evaluar |
|
| 264 | - * |
|
| 265 | - * @return bool True si termina con el caracter especificado, False si no |
|
| 266 | - */ |
|
| 260 | + * Dice si un string termina con una caracter especificado |
|
| 261 | + * |
|
| 262 | + * @param string $sx: Caracter del final |
|
| 263 | + * @param string $str: String a evaluar |
|
| 264 | + * |
|
| 265 | + * @return bool True si termina con el caracter especificado, False si no |
|
| 266 | + */ |
|
| 267 | 267 | final public static function end_with(string $sx, string $str) : bool { |
| 268 | 268 | return (bool) (strlen($str) > 0 and $str[strlen($str) - 1] == $sx); |
| 269 | 269 | } |
| 270 | 270 | //------------------------------------------------ |
| 271 | 271 | /** |
| 272 | - * Ver si un string está contenido en otro |
|
| 273 | - * |
|
| 274 | - * @param $s: String contenido en $str |
|
| 275 | - * @param $str: String a evaluar |
|
| 276 | - * |
|
| 277 | - * @return bool True si $s está dentro de $str, False si no |
|
| 278 | - */ |
|
| 272 | + * Ver si un string está contenido en otro |
|
| 273 | + * |
|
| 274 | + * @param $s: String contenido en $str |
|
| 275 | + * @param $str: String a evaluar |
|
| 276 | + * |
|
| 277 | + * @return bool True si $s está dentro de $str, False si no |
|
| 278 | + */ |
|
| 279 | 279 | final public static function contain(string $s, string $str) : bool { |
| 280 | 280 | return (bool) (strpos($str, $s) !== false); |
| 281 | 281 | } |
| 282 | 282 | //------------------------------------------------ |
| 283 | 283 | /** |
| 284 | - * Devuelve la cantidad de palabras en un string |
|
| 285 | - * |
|
| 286 | - * @param $str: String a evaluar |
|
| 287 | - * |
|
| 288 | - * @return int Cantidad de palabras |
|
| 289 | - */ |
|
| 284 | + * Devuelve la cantidad de palabras en un string |
|
| 285 | + * |
|
| 286 | + * @param $str: String a evaluar |
|
| 287 | + * |
|
| 288 | + * @return int Cantidad de palabras |
|
| 289 | + */ |
|
| 290 | 290 | final public static function count_words(string $s) : int { |
| 291 | 291 | return (int) str_word_count($s,0); |
| 292 | 292 | } |
| 293 | 293 | //------------------------------------------------ |
| 294 | 294 | /** |
| 295 | - * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig |
|
| 296 | - * |
|
| 297 | - * @return array Todas las funciones con sus respectivos nombres de acceso en plantillas twig |
|
| 298 | - */ |
|
| 295 | + * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig |
|
| 296 | + * |
|
| 297 | + * @return array Todas las funciones con sus respectivos nombres de acceso en plantillas twig |
|
| 298 | + */ |
|
| 299 | 299 | public function getFunctions() : array { |
| 300 | 300 | return array( |
| 301 | 301 | new \Twig_Function('amigable_time', array($this, 'amigable_time')), |
@@ -319,10 +319,10 @@ discard block |
||
| 319 | 319 | } |
| 320 | 320 | //------------------------------------------------ |
| 321 | 321 | /** |
| 322 | - * Identificador único para la extensión de twig |
|
| 323 | - * |
|
| 324 | - * @return string Nombre de la extensión |
|
| 325 | - */ |
|
| 322 | + * Identificador único para la extensión de twig |
|
| 323 | + * |
|
| 324 | + * @return string Nombre de la extensión |
|
| 325 | + */ |
|
| 326 | 326 | public function getName() : string { |
| 327 | 327 | return 'ocrend_framework_helper_strings'; |
| 328 | 328 | } |
@@ -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 (null === $var || empty(trim(str_replace(' ','',$var)))); |
|
| 108 | - } |
|
| 105 | + */ |
|
| 106 | + final public function emp($var) : bool { |
|
| 107 | + return (null === $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($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; |
@@ -292,7 +292,7 @@ discard block |
||
| 292 | 292 | * @param int $desde: Desde donde |
| 293 | 293 | * |
| 294 | 294 | * @return mixed |
| 295 | - */ |
|
| 295 | + */ |
|
| 296 | 296 | final public function desde_date(int $desde) { |
| 297 | 297 | # Obtener esta fecha |
| 298 | 298 | $hoy = date('d/m/Y/D',time()); |
@@ -300,19 +300,19 @@ discard block |
||
| 300 | 300 | |
| 301 | 301 | # Arreglo de condiciones y subcondiciones |
| 302 | 302 | $fecha = array( |
| 303 | - 1 => date('d/m/Y', time()), |
|
| 304 | - 2 => date('d/m/Y', time() - (60*60*24)), |
|
| 305 | - 3 => array( |
|
| 306 | - 'Mon' => $hoy[0], |
|
| 307 | - 'Tue' => intval($hoy[0]) - 1, |
|
| 308 | - 'Wed' => intval($hoy[0]) - 2, |
|
| 309 | - 'Thu' => intval($hoy[0]) - 3, |
|
| 310 | - 'Fri' => intval($hoy[0]) - 4, |
|
| 311 | - 'Sat' => intval($hoy[0]) - 5, |
|
| 312 | - 'Sun' => intval($hoy[0]) - 6 |
|
| 313 | - ), |
|
| 314 | - 4 => '01/'. $this->cero_izq($hoy[1]) .'/' . $hoy[2], |
|
| 315 | - 5 => '01/01/' . $hoy[2] |
|
| 303 | + 1 => date('d/m/Y', time()), |
|
| 304 | + 2 => date('d/m/Y', time() - (60*60*24)), |
|
| 305 | + 3 => array( |
|
| 306 | + 'Mon' => $hoy[0], |
|
| 307 | + 'Tue' => intval($hoy[0]) - 1, |
|
| 308 | + 'Wed' => intval($hoy[0]) - 2, |
|
| 309 | + 'Thu' => intval($hoy[0]) - 3, |
|
| 310 | + 'Fri' => intval($hoy[0]) - 4, |
|
| 311 | + 'Sat' => intval($hoy[0]) - 5, |
|
| 312 | + 'Sun' => intval($hoy[0]) - 6 |
|
| 313 | + ), |
|
| 314 | + 4 => '01/'. $this->cero_izq($hoy[1]) .'/' . $hoy[2], |
|
| 315 | + 5 => '01/01/' . $hoy[2] |
|
| 316 | 316 | ); |
| 317 | 317 | |
| 318 | 318 | if($desde == 3) { |
@@ -347,44 +347,44 @@ discard block |
||
| 347 | 347 | * Obtiene el tiempo actual |
| 348 | 348 | * |
| 349 | 349 | * @return int devuelve time() |
| 350 | - */ |
|
| 350 | + */ |
|
| 351 | 351 | final public function timestamp() : int { |
| 352 | - return time(); |
|
| 352 | + return time(); |
|
| 353 | 353 | } |
| 354 | 354 | |
| 355 | 355 | //------------------------------------------------ |
| 356 | 356 | |
| 357 | 357 | /** |
| 358 | 358 | * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig |
| 359 | - * |
|
| 359 | + * |
|
| 360 | 360 | * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig |
| 361 | - */ |
|
| 361 | + */ |
|
| 362 | 362 | public function getFunctions() : array { |
| 363 | 363 | return array( |
| 364 | - new \Twig_Function('percent', array($this, 'percent')), |
|
| 365 | - new \Twig_Function('convert', array($this, 'convert')), |
|
| 366 | - new \Twig_Function('get_gravatar', array($this, 'get_gravatar')), |
|
| 367 | - new \Twig_Function('emp', array($this, 'emp')), |
|
| 368 | - new \Twig_Function('e_dynamic', array($this, 'e')), |
|
| 369 | - new \Twig_Function('all_full', array($this, 'all_full')), |
|
| 370 | - new \Twig_Function('fecha', array($this, 'fecha')), |
|
| 371 | - new \Twig_Function('base_assets', array($this, 'base_assets')), |
|
| 372 | - new \Twig_Function('timestamp', array($this, 'timestamp')), |
|
| 373 | - new \Twig_Function('desde_date', array($this, 'desde_date')), |
|
| 374 | - new \Twig_Function('cero_izq', array($this, 'cero_izq')), |
|
| 375 | - new \Twig_Function('last_day_month', array($this, 'last_day_month')), |
|
| 376 | - new \Twig_Function('str_to_time', array($this, 'str_to_time')), |
|
| 377 | - new \Twig_Function('desde_date', array($this, 'desde_date')) |
|
| 378 | - ); |
|
| 379 | - } |
|
| 380 | - |
|
| 381 | - //------------------------------------------------ |
|
| 364 | + new \Twig_Function('percent', array($this, 'percent')), |
|
| 365 | + new \Twig_Function('convert', array($this, 'convert')), |
|
| 366 | + new \Twig_Function('get_gravatar', array($this, 'get_gravatar')), |
|
| 367 | + new \Twig_Function('emp', array($this, 'emp')), |
|
| 368 | + new \Twig_Function('e_dynamic', array($this, 'e')), |
|
| 369 | + new \Twig_Function('all_full', array($this, 'all_full')), |
|
| 370 | + new \Twig_Function('fecha', array($this, 'fecha')), |
|
| 371 | + new \Twig_Function('base_assets', array($this, 'base_assets')), |
|
| 372 | + new \Twig_Function('timestamp', array($this, 'timestamp')), |
|
| 373 | + new \Twig_Function('desde_date', array($this, 'desde_date')), |
|
| 374 | + new \Twig_Function('cero_izq', array($this, 'cero_izq')), |
|
| 375 | + new \Twig_Function('last_day_month', array($this, 'last_day_month')), |
|
| 376 | + new \Twig_Function('str_to_time', array($this, 'str_to_time')), |
|
| 377 | + new \Twig_Function('desde_date', array($this, 'desde_date')) |
|
| 378 | + ); |
|
| 379 | + } |
|
| 380 | + |
|
| 381 | + //------------------------------------------------ |
|
| 382 | 382 | |
| 383 | 383 | /** |
| 384 | - * Identificador único para la extensión de twig |
|
| 385 | - * |
|
| 386 | - * @return string con el nombre de la extensión |
|
| 387 | - */ |
|
| 384 | + * Identificador único para la extensión de twig |
|
| 385 | + * |
|
| 386 | + * @return string con el nombre de la extensión |
|
| 387 | + */ |
|
| 388 | 388 | public function getName() : string { |
| 389 | 389 | return 'ocrend_framework_func_class'; |
| 390 | 390 | } |
@@ -50,10 +50,10 @@ discard block |
||
| 50 | 50 | } |
| 51 | 51 | |
| 52 | 52 | /** |
| 53 | - * Motor de base de datos MySQL |
|
| 54 | - * |
|
| 55 | - * @param array $params: Lista de parámetros de configuración |
|
| 56 | - */ |
|
| 53 | + * Motor de base de datos MySQL |
|
| 54 | + * |
|
| 55 | + * @param array $params: Lista de parámetros de configuración |
|
| 56 | + */ |
|
| 57 | 57 | final private function motor_mysql(array $params) { |
| 58 | 58 | parent::__construct('mysql:host='.$params['host'].';dbname='.$params['name'], |
| 59 | 59 | $params['user'], |
@@ -65,19 +65,19 @@ discard block |
||
| 65 | 65 | } |
| 66 | 66 | |
| 67 | 67 | /** |
| 68 | - * Motor de base de datos SQLite |
|
| 69 | - * |
|
| 70 | - * @param array $params: Lista de parámetros de configuración |
|
| 71 | - */ |
|
| 68 | + * Motor de base de datos SQLite |
|
| 69 | + * |
|
| 70 | + * @param array $params: Lista de parámetros de configuración |
|
| 71 | + */ |
|
| 72 | 72 | final private function motor_sqlite(array $params) { |
| 73 | 73 | parent::__construct('sqlite:'.$params['name']); |
| 74 | 74 | } |
| 75 | 75 | |
| 76 | 76 | /** |
| 77 | - * Motor de base de datos Cubrid |
|
| 78 | - * |
|
| 79 | - * @param array $params: Lista de parámetros de configuración |
|
| 80 | - */ |
|
| 77 | + * Motor de base de datos Cubrid |
|
| 78 | + * |
|
| 79 | + * @param array $params: Lista de parámetros de configuración |
|
| 80 | + */ |
|
| 81 | 81 | final private function motor_cubrid(array $params) { |
| 82 | 82 | parent::__construct('cubrid:host='.$params['host'].';dbname='.$params['name'].';port='.$params['port'], |
| 83 | 83 | $params['user'], |
@@ -88,10 +88,10 @@ discard block |
||
| 88 | 88 | } |
| 89 | 89 | |
| 90 | 90 | /** |
| 91 | - * Motor de base de datos Firebird |
|
| 92 | - * |
|
| 93 | - * @param array $params: Lista de parámetros de configuración |
|
| 94 | - */ |
|
| 91 | + * Motor de base de datos Firebird |
|
| 92 | + * |
|
| 93 | + * @param array $params: Lista de parámetros de configuración |
|
| 94 | + */ |
|
| 95 | 95 | final private function motor_firebird(array $params) { |
| 96 | 96 | parent::__construct('firebird:dbname='.$params['host'].':'.$params['name'], |
| 97 | 97 | $params['user'], |
@@ -102,10 +102,10 @@ discard block |
||
| 102 | 102 | } |
| 103 | 103 | |
| 104 | 104 | /** |
| 105 | - * Motor de base de datos ODBC |
|
| 106 | - * |
|
| 107 | - * @param array $params: Lista de parámetros de configuración |
|
| 108 | - */ |
|
| 105 | + * Motor de base de datos ODBC |
|
| 106 | + * |
|
| 107 | + * @param array $params: Lista de parámetros de configuración |
|
| 108 | + */ |
|
| 109 | 109 | final private function motor_odbc(array $params) { |
| 110 | 110 | parent::__construct('odbc:'.$params['name'], |
| 111 | 111 | $params['user'], |
@@ -114,10 +114,10 @@ discard block |
||
| 114 | 114 | } |
| 115 | 115 | |
| 116 | 116 | /** |
| 117 | - * Motor de base de datos Oracle |
|
| 118 | - * |
|
| 119 | - * @param array $params: Lista de parámetros de configuración |
|
| 120 | - */ |
|
| 117 | + * Motor de base de datos Oracle |
|
| 118 | + * |
|
| 119 | + * @param array $params: Lista de parámetros de configuración |
|
| 120 | + */ |
|
| 121 | 121 | final private function motor_oracle(array $params) { |
| 122 | 122 | parent::__construct('oci:dbname=(DESCRIPTION = |
| 123 | 123 | (ADDRESS_LIST = |
@@ -134,10 +134,10 @@ discard block |
||
| 134 | 134 | } |
| 135 | 135 | |
| 136 | 136 | /** |
| 137 | - * Motor de base de datos PostgreSQL |
|
| 138 | - * |
|
| 139 | - * @param array $params: Lista de parámetros de configuración |
|
| 140 | - */ |
|
| 137 | + * Motor de base de datos PostgreSQL |
|
| 138 | + * |
|
| 139 | + * @param array $params: Lista de parámetros de configuración |
|
| 140 | + */ |
|
| 141 | 141 | final private function motor_postgresql(array $params) { |
| 142 | 142 | parent::__construct('pgsql:host='.$params['host'].';dbname='.$params['name'].';charset=utf8', |
| 143 | 143 | $params['user'], |
@@ -148,11 +148,11 @@ discard block |
||
| 148 | 148 | } |
| 149 | 149 | |
| 150 | 150 | /** |
| 151 | - * Motor de base de datos MSSQL |
|
| 152 | - * Añadido por marc2684 https://github.com/prinick96/Ocrend-Framework/issues/7 |
|
| 153 | - * |
|
| 154 | - * @param array $params: Lista de parámetros de configuración |
|
| 155 | - */ |
|
| 151 | + * Motor de base de datos MSSQL |
|
| 152 | + * Añadido por marc2684 https://github.com/prinick96/Ocrend-Framework/issues/7 |
|
| 153 | + * |
|
| 154 | + * @param array $params: Lista de parámetros de configuración |
|
| 155 | + */ |
|
| 156 | 156 | final private function motor_mssql(array $params) { |
| 157 | 157 | parent::__construct('sqlsrv:Server='.$params['host'].';Database='.$params['name'].';ConnectionPooling=0', |
| 158 | 158 | $params['user'], |
@@ -163,16 +163,16 @@ discard block |
||
| 163 | 163 | } |
| 164 | 164 | |
| 165 | 165 | /** |
| 166 | - * Inicia la conexión con la base de datos seleccionada |
|
| 167 | - * |
|
| 168 | - * @param string|null $name : Nombre de la base de datos a conectar |
|
| 169 | - * @param string|null $motor: Motor de la base de datos a conectar |
|
| 170 | - * @param bool $new_instance: true para iniciar una nueva instancia (al querer conectar a una DB distinta) |
|
| 171 | - * |
|
| 172 | - * @throws \RuntimeException si el motor no existe |
|
| 173 | - * @throws \RuntimeException si existe algún problema de conexión con la base de datos |
|
| 174 | - * @return Database : Instancia de conexión |
|
| 175 | - */ |
|
| 166 | + * Inicia la conexión con la base de datos seleccionada |
|
| 167 | + * |
|
| 168 | + * @param string|null $name : Nombre de la base de datos a conectar |
|
| 169 | + * @param string|null $motor: Motor de la base de datos a conectar |
|
| 170 | + * @param bool $new_instance: true para iniciar una nueva instancia (al querer conectar a una DB distinta) |
|
| 171 | + * |
|
| 172 | + * @throws \RuntimeException si el motor no existe |
|
| 173 | + * @throws \RuntimeException si existe algún problema de conexión con la base de datos |
|
| 174 | + * @return Database : Instancia de conexión |
|
| 175 | + */ |
|
| 176 | 176 | final public function __construct(string $name, string $motor) { |
| 177 | 177 | global $config; |
| 178 | 178 | |
@@ -196,34 +196,34 @@ discard block |
||
| 196 | 196 | } |
| 197 | 197 | |
| 198 | 198 | /** |
| 199 | - * Convierte en arreglo asociativo de todos los resultados arrojados por una query |
|
| 200 | - * |
|
| 201 | - * @param object \PDOStatement $query, valor devuelto de la query |
|
| 202 | - * |
|
| 203 | - * @return array arreglo asociativo |
|
| 204 | - */ |
|
| 199 | + * Convierte en arreglo asociativo de todos los resultados arrojados por una query |
|
| 200 | + * |
|
| 201 | + * @param object \PDOStatement $query, valor devuelto de la query |
|
| 202 | + * |
|
| 203 | + * @return array arreglo asociativo |
|
| 204 | + */ |
|
| 205 | 205 | final public function fetch_array(\PDOStatement $query) : array { |
| 206 | 206 | return $query->fetchAll(\PDO::FETCH_ASSOC); |
| 207 | 207 | } |
| 208 | 208 | |
| 209 | - /** |
|
| 210 | - * Cantidad de filas encontradas después de un SELECT |
|
| 211 | - * |
|
| 212 | - * @param object \PDOStatement $query, valor devuelto de la query |
|
| 213 | - * |
|
| 214 | - * @return int numero de filas encontradas |
|
| 215 | - */ |
|
| 209 | + /** |
|
| 210 | + * Cantidad de filas encontradas después de un SELECT |
|
| 211 | + * |
|
| 212 | + * @param object \PDOStatement $query, valor devuelto de la query |
|
| 213 | + * |
|
| 214 | + * @return int numero de filas encontradas |
|
| 215 | + */ |
|
| 216 | 216 | final public function rows(\PDOStatement $query) : int { |
| 217 | 217 | return $query->rowCount(); |
| 218 | 218 | } |
| 219 | 219 | |
| 220 | 220 | /** |
| 221 | - * Sana un valor para posteriormente ser introducido en una query |
|
| 222 | - * |
|
| 223 | - * @param null/string/int/float a sanar |
|
| 224 | - * |
|
| 225 | - * @return mixed elemento sano |
|
| 226 | - */ |
|
| 221 | + * Sana un valor para posteriormente ser introducido en una query |
|
| 222 | + * |
|
| 223 | + * @param null/string/int/float a sanar |
|
| 224 | + * |
|
| 225 | + * @return mixed elemento sano |
|
| 226 | + */ |
|
| 227 | 227 | final public function scape($e) { |
| 228 | 228 | if (null === $e) { |
| 229 | 229 | return ''; |
@@ -240,28 +240,28 @@ discard block |
||
| 240 | 240 | } |
| 241 | 241 | |
| 242 | 242 | /** |
| 243 | - * Borra una serie de elementos de forma segura de una tabla en la base de datos |
|
| 244 | - * |
|
| 245 | - * @param string $table: Tabla a la cual se le quiere remover un elemento |
|
| 246 | - * @param string $where: Condición de borrado que define quien/quienes son dichos elementos |
|
| 247 | - * @param string $limit: Por defecto se limita a borrar un solo elemento que cumpla el $where |
|
| 248 | - * |
|
| 249 | - * @return \PDOStatement |
|
| 250 | - */ |
|
| 243 | + * Borra una serie de elementos de forma segura de una tabla en la base de datos |
|
| 244 | + * |
|
| 245 | + * @param string $table: Tabla a la cual se le quiere remover un elemento |
|
| 246 | + * @param string $where: Condición de borrado que define quien/quienes son dichos elementos |
|
| 247 | + * @param string $limit: Por defecto se limita a borrar un solo elemento que cumpla el $where |
|
| 248 | + * |
|
| 249 | + * @return \PDOStatement |
|
| 250 | + */ |
|
| 251 | 251 | final public function delete(string $table, string $where, string $limit = 'LIMIT 1') : \PDOStatement { |
| 252 | 252 | return $this->query("DELETE FROM $table WHERE $where $limit;"); |
| 253 | 253 | } |
| 254 | 254 | |
| 255 | 255 | /** |
| 256 | - * Inserta una serie de elementos a una tabla en la base de datos |
|
| 257 | - * |
|
| 258 | - * @param string $table: Tabla a la cual se le va a insertar elementos |
|
| 259 | - * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo', |
|
| 260 | - * todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo |
|
| 261 | - * |
|
| 262 | - * @throws \RuntimeException si el arreglo está vacío |
|
| 263 | - * @return \PDOStatement |
|
| 264 | - */ |
|
| 256 | + * Inserta una serie de elementos a una tabla en la base de datos |
|
| 257 | + * |
|
| 258 | + * @param string $table: Tabla a la cual se le va a insertar elementos |
|
| 259 | + * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo', |
|
| 260 | + * todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo |
|
| 261 | + * |
|
| 262 | + * @throws \RuntimeException si el arreglo está vacío |
|
| 263 | + * @return \PDOStatement |
|
| 264 | + */ |
|
| 265 | 265 | final public function insert(string $table, array $e) : \PDOStatement { |
| 266 | 266 | if (sizeof($e) == 0) { |
| 267 | 267 | throw new \RuntimeException('El arreglo pasado por $this->db->insert(\'' . $table . '\',...) está vacío.'); |
@@ -281,17 +281,17 @@ discard block |
||
| 281 | 281 | } |
| 282 | 282 | |
| 283 | 283 | /** |
| 284 | - * Actualiza elementos de una tabla en la base de datos según una condición |
|
| 285 | - * |
|
| 286 | - * @param string $table: Tabla a actualizar |
|
| 287 | - * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo', |
|
| 288 | - * todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo |
|
| 289 | - * @param string $where: Condición que indica quienes serán modificados |
|
| 290 | - * @param string $limite: Límite de elementos modificados, por defecto los modifica a todos |
|
| 291 | - * |
|
| 292 | - * @throws \RuntimeException si el arreglo está vacío |
|
| 293 | - * @return \PDOStatement |
|
| 294 | - */ |
|
| 284 | + * Actualiza elementos de una tabla en la base de datos según una condición |
|
| 285 | + * |
|
| 286 | + * @param string $table: Tabla a actualizar |
|
| 287 | + * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo', |
|
| 288 | + * todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo |
|
| 289 | + * @param string $where: Condición que indica quienes serán modificados |
|
| 290 | + * @param string $limite: Límite de elementos modificados, por defecto los modifica a todos |
|
| 291 | + * |
|
| 292 | + * @throws \RuntimeException si el arreglo está vacío |
|
| 293 | + * @return \PDOStatement |
|
| 294 | + */ |
|
| 295 | 295 | final public function update(string $table, array $e, string $where, string $limit = '') : \PDOStatement { |
| 296 | 296 | if (sizeof($e) == 0) { |
| 297 | 297 | throw new \RuntimeException('El arreglo pasado por $this->db->update(\'' . $table . '\'...) está vacío.'); |
@@ -308,24 +308,24 @@ discard block |
||
| 308 | 308 | } |
| 309 | 309 | |
| 310 | 310 | /** |
| 311 | - * Selecciona y lista en un arreglo asociativo/numérico los resultados de una búsqueda en la base de datos |
|
| 312 | - * |
|
| 313 | - * @param string $e: Elementos a seleccionar separados por coma |
|
| 314 | - * @param string $tbale: Tabla de la cual se quiere extraer los elementos $e |
|
| 315 | - * @param string $where: Condición que indica quienes son los que se extraen, si no se coloca extrae todos |
|
| 316 | - * @param string $limite: Límite de elemntos a traer, por defecto trae TODOS los que cumplan $where |
|
| 317 | - * |
|
| 318 | - * @return mixed false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno |
|
| 319 | - */ |
|
| 311 | + * Selecciona y lista en un arreglo asociativo/numérico los resultados de una búsqueda en la base de datos |
|
| 312 | + * |
|
| 313 | + * @param string $e: Elementos a seleccionar separados por coma |
|
| 314 | + * @param string $tbale: Tabla de la cual se quiere extraer los elementos $e |
|
| 315 | + * @param string $where: Condición que indica quienes son los que se extraen, si no se coloca extrae todos |
|
| 316 | + * @param string $limite: Límite de elemntos a traer, por defecto trae TODOS los que cumplan $where |
|
| 317 | + * |
|
| 318 | + * @return mixed false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno |
|
| 319 | + */ |
|
| 320 | 320 | final public function select(string $e, string $table, string $where = '1 = 1', string $limit = "") { |
| 321 | 321 | return $this->query_select("SELECT $e FROM $table WHERE $where $limit;"); |
| 322 | 322 | } |
| 323 | 323 | |
| 324 | - /** |
|
| 325 | - * Realiza una query, ideal para trabajar con SELECTS, JOINS, etc |
|
| 326 | - * |
|
| 327 | - * @return array|false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno |
|
| 328 | - */ |
|
| 324 | + /** |
|
| 325 | + * Realiza una query, ideal para trabajar con SELECTS, JOINS, etc |
|
| 326 | + * |
|
| 327 | + * @return array|false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno |
|
| 328 | + */ |
|
| 329 | 329 | final public function query_select(string $query) { |
| 330 | 330 | $sql = $this->query($query); |
| 331 | 331 | $result = $sql->fetchAll(); |
@@ -339,13 +339,13 @@ discard block |
||
| 339 | 339 | } |
| 340 | 340 | |
| 341 | 341 | /** |
| 342 | - * Alert para evitar clonaciones |
|
| 343 | - * |
|
| 344 | - * @throws \RuntimeException si se intenta clonar la conexión |
|
| 345 | - * @return void |
|
| 346 | - */ |
|
| 342 | + * Alert para evitar clonaciones |
|
| 343 | + * |
|
| 344 | + * @throws \RuntimeException si se intenta clonar la conexión |
|
| 345 | + * @return void |
|
| 346 | + */ |
|
| 347 | 347 | final public function __clone() { |
| 348 | 348 | throw new \RuntimeException('Estás intentando clonar la Conexión'); |
| 349 | 349 | } |
| 350 | 350 | |
| 351 | - } |
|
| 352 | 351 | \ No newline at end of file |
| 352 | + } |
|
| 353 | 353 | \ No newline at end of file |