prinick96 / Ocrend-Framework

app/models/Users.php

Indentation +7 added lines, -7 removed lines

@@ -302,11 +302,11 @@ 
     }
     
     /**
-      * Envía un correo electrónico al usuario que quiere recuperar la contraseña, con un token y una nueva contraseña.
-      * Si el usuario no visita el enlace, el sistema no cambiará la contraseña.
-      *
-      * @return array<string,integer|string>
-    */  
+     * Envía un correo electrónico al usuario que quiere recuperar la contraseña, con un token y una nueva contraseña.
+     * Si el usuario no visita el enlace, el sistema no cambiará la contraseña.
+     *
+     * @return array<string,integer|string>
+     */  
     public function lostpass() {
         try {
             global $http, $config;
@@ -342,8 +342,8 @@ 
 
             # Enviar el correo electrónico
             $dest = array();
-			$dest[$email] = $user_data[0]['name'];
-			$email = Emails::send_mail($dest,Emails::plantilla($HTML),'Recuperar contraseña perdida');
+      $dest[$email] = $user_data[0]['name'];
+      $email = Emails::send_mail($dest,Emails::plantilla($HTML),'Recuperar contraseña perdida');
 
             # Verificar si hubo algún problema con el envío del correo
             if(false === $email) {

Ocrend/Kernel/Models/Models.php

Indentation +26 added lines, -26 removed lines

@@ -23,32 +23,32 @@ 
 abstract class Models {
 
     /**
-      * Tiene siempre el id pasado por la ruta, en caso de no haber ninguno, será cero.
-      *
-      * @var int 
-    */
+     * Tiene siempre el id pasado por la ruta, en caso de no haber ninguno, será cero.
+     *
+     * @var int 
+     */
     protected $id = 0;
 
     /**
-      * Contiene una instancia del helper para funciones
-      *
-      * @var \Ocrend\Kernel\Helpers\Functions
-    */
+     * Contiene una instancia del helper para funciones
+     *
+     * @var \Ocrend\Kernel\Helpers\Functions
+     */
     protected $functions;
 
     /**
-      * Contiene el id del usuario que tiene su sesión iniciada.
-      *
-      * @var int|null con id del usuario
-    */
+     * Contiene el id del usuario que tiene su sesión iniciada.
+     *
+     * @var int|null con id del usuario
+     */
     protected $id_user = null;
 
     /**
-      * Inicia la configuración inicial de cualquier modelo
-      *
-      * @param IRouter $router: Instancia de un Router 
-      *                                    
-    */
+     * Inicia la configuración inicial de cualquier modelo
+     *
+     * @param IRouter $router: Instancia de un Router 
+     *                                    
+     */
     protected function __construct(IRouter $router = null) {
         global $session, $config;
         
@@ -63,19 +63,19 @@ 
 
         # Verificar sesión del usuario
         if(null !== $session->get('user_id') && $session->get('unique_session') == $config['sessions']['unique']) {
-           $this->id_user = $session->get('user_id');
+            $this->id_user = $session->get('user_id');
         }
     }
 
     /**
-      * Asigna el id desde un modelo, ideal para cuando queremos darle un valor numérico 
-      * que proviene de un formulario y puede ser inseguro.
-      *
-      * @param mixed $id : Id a asignar en $this->id
-      * @param string $default_msg : Mensaje a mostrar en caso de que no se pueda asignar
-      *
-      * @throws ModelsException
-      */
+     * Asigna el id desde un modelo, ideal para cuando queremos darle un valor numérico 
+     * que proviene de un formulario y puede ser inseguro.
+     *
+     * @param mixed $id : Id a asignar en $this->id
+     * @param string $default_msg : Mensaje a mostrar en caso de que no se pueda asignar
+     *
+     * @throws ModelsException
+     */
     protected function setId($id, string $default_msg = 'No puedede asignarse el id.') {
         if (null == $id || !is_numeric($id) || $id <= 0) {
             throw new ModelsException($default_msg);

Ocrend/Kernel/Helpers/Arrays.php

Indentation +26 added lines, -26 removed lines

@@ -120,12 +120,12 @@ 
   //------------------------------------------------
 
   /**
-    * Evalúa si un arreglo es de tipo asociativo o no
-    *
-    * @param array $a: Arreglo a evaluar
-    *
-    * @return bool false si no lo es, true si lo es
-  */
+   * Evalúa si un arreglo es de tipo asociativo o no
+   *
+   * @param array $a: Arreglo a evaluar
+   *
+   * @return bool false si no lo es, true si lo es
+   */
   final public static function is_assoc(array $a) : bool {
     if (sizeof($a) === 0) {
       return false;
@@ -137,12 +137,12 @@ 
   //------------------------------------------------
 
   /**
-    * Evalúa si un arreglo es secuencial (de índices numéricos)
-    *
-    * @param array $a: Arreglo a evaluar
-    *
-    * @return bool false si no lo es, true si lo es
-  */
+   * Evalúa si un arreglo es secuencial (de índices numéricos)
+   *
+   * @param array $a: Arreglo a evaluar
+   *
+   * @return bool false si no lo es, true si lo es
+   */
   final public static function is_numeric_array(array $a) : bool {
     return !self::is_assoc($a);
   }
@@ -150,12 +150,12 @@ 
   //------------------------------------------------
 
   /**
-    * Obtiene de forma random un elemento de un arreglo
-    *
-    * @param array $a: Arreglo a evaluar
-    *
-    * @return mixed elemento random dentro del arreglo
-  */
+   * Obtiene de forma random un elemento de un arreglo
+   *
+   * @param array $a: Arreglo a evaluar
+   *
+   * @return mixed elemento random dentro del arreglo
+   */
   final public static function array_random_element(array $a) {
     return $a[array_rand($a)];
   }
@@ -163,10 +163,10 @@ 
   //------------------------------------------------
 
   /**
-    * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig
-    *
-    * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig
-  */
+   * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig
+   *
+   * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig
+   */
   public function getFunctions() : array {
     return array(
       new \Twig_Function('get_key_by_index', array($this, 'get_key_by_index')),
@@ -181,10 +181,10 @@ 
   //------------------------------------------------
 
   /**
-    * Identificador único para la extensión de twig
-    *
-    * @return string con el nombre de la extensión
-  */
+   * Identificador único para la extensión de twig
+   *
+   * @return string con el nombre de la extensión
+   */
   public function getName() : string {
     return 'ocrend_framework_helper_arrays';
   }

Ocrend/Kernel/Helpers/Emails.php

Indentation +24 added lines, -24 removed lines

@@ -20,14 +20,14 @@ 
 final class Emails {
 
   /**
-    * FUNCIÓN NO ACCESIBLE, USO ESTRICTO PARA UNA FUNCIÓN INTERNA DEL HELPER
-    * Inicializa la clase PHPMailer y las configuraciones necesarias
-    * Método privado utilizado en todo el Helper
-    *
-    * @param bool $is_smtp: Define si se hará la conexión a través de SMTP o no
-    *
-    * @return \PHPMailer un objeto de la clase PHPMailer
-  */
+   * FUNCIÓN NO ACCESIBLE, USO ESTRICTO PARA UNA FUNCIÓN INTERNA DEL HELPER
+   * Inicializa la clase PHPMailer y las configuraciones necesarias
+   * Método privado utilizado en todo el Helper
+   *
+   * @param bool $is_smtp: Define si se hará la conexión a través de SMTP o no
+   *
+   * @return \PHPMailer un objeto de la clase PHPMailer
+   */
   final private static function init(bool $is_smtp = true) : \PHPMailer {
     global $config;
 
@@ -60,22 +60,22 @@ 
   //------------------------------------------------
 
   /**
-    * Envía un correo electrónico utilizando PHPMailer
-    *
-    * @param array $dest: Arreglo con la forma array(
-    *                                           'email destinatario 1' => 'nombre destinatario 1',
-    *                                           'email destinatario 2' => 'nombre destinatario 2'
-    *                                            )
-    * @param string $HTML: Contenido en HTML del email
-    * @param string $titulo: Asunto del email
-    * @param bool $is_smtp: Define si se hará la conexión a través de SMTP o no
-    * @param array $adj: Arreglo con direccion local de los adjuntos a enviar, con la forma array(
-    *                                                                                       'ruta archivo 1',
-    *                                                                                       'ruta archivo 2'
-    *                                                                                       )
-    *
-    * @return string|bool true si fue enviado correctamente, string con el Error descrito por PHPMailer
-  */
+   * Envía un correo electrónico utilizando PHPMailer
+   *
+   * @param array $dest: Arreglo con la forma array(
+   *                                           'email destinatario 1' => 'nombre destinatario 1',
+   *                                           'email destinatario 2' => 'nombre destinatario 2'
+   *                                            )
+   * @param string $HTML: Contenido en HTML del email
+   * @param string $titulo: Asunto del email
+   * @param bool $is_smtp: Define si se hará la conexión a través de SMTP o no
+   * @param array $adj: Arreglo con direccion local de los adjuntos a enviar, con la forma array(
+   *                                                                                       'ruta archivo 1',
+   *                                                                                       'ruta archivo 2'
+   *                                                                                       )
+   *
+   * @return string|bool true si fue enviado correctamente, string con el Error descrito por PHPMailer
+   */
   final public static function send_mail(array $dest, string $HTML, string $titulo, bool $is_smtp = true, array $adj = []) {
     global $config;
 

Ocrend/Kernel/Helpers/Files.php

Indentation +55 added lines, -55 removed lines

@@ -40,13 +40,13 @@ 
   //------------------------------------------------
 
   /**
-    * Escribe un string completo en un archivo, si este no existe lo crea
-    *
-    * @param string $dir: Directorio del archivo escribir/crear
-    * @param string $content: Contenido a escribir
-    *
-    * @return int catidad de bytes escritos en el archivo
-  */
+   * Escribe un string completo en un archivo, si este no existe lo crea
+   *
+   * @param string $dir: Directorio del archivo escribir/crear
+   * @param string $content: Contenido a escribir
+   *
+   * @return int catidad de bytes escritos en el archivo
+   */
   final public static function write_file(string $dir, string $content) : int {
     $f = new \SplFileObject($dir,'w');
     return (int) $f->fwrite($content);
@@ -74,12 +74,12 @@ 
   //------------------------------------------------
 
   /**
-    * Devuelve la extensión de un archivo cualquiera, da igual si es solo el nombre o la ruta con el nombre
-    *
-    * @param string $file_name: Nombre del archivo, da igual si es solo el nombre o la ruta con el nombre
-    *
-    * @return mixed string con la extensión, devuelve un string '' si no existe información alguna acerca de la extensión
-  */
+   * Devuelve la extensión de un archivo cualquiera, da igual si es solo el nombre o la ruta con el nombre
+   *
+   * @param string $file_name: Nombre del archivo, da igual si es solo el nombre o la ruta con el nombre
+   *
+   * @return mixed string con la extensión, devuelve un string '' si no existe información alguna acerca de la extensión
+   */
   final public static function get_file_ext(string $file_name) {
     return pathinfo($file_name, PATHINFO_EXTENSION);
   }
@@ -87,12 +87,12 @@ 
   //------------------------------------------------
 
   /**
-    * Dice si un elemento es una imagen o no según su extensión
-    *
-    * @param string $file_name: Nombre del archivo, da igual si es solo el nombre o la ruta con el nombre
-    *
-    * @return bool true si es una imagen, false si no lo es
-  */
+   * Dice si un elemento es una imagen o no según su extensión
+   *
+   * @param string $file_name: Nombre del archivo, da igual si es solo el nombre o la ruta con el nombre
+   *
+   * @return bool true si es una imagen, false si no lo es
+   */
   final public static function is_image(string $file_name) : bool {
     return (bool) in_array(self::get_file_ext($file_name), ['jpg', 'png', 'jpeg', 'gif', 'JPG', 'PNG', 'JPEG', 'GIF']);
   }
@@ -100,39 +100,39 @@ 
   //------------------------------------------------
 
   /**
-    * Devuelve el tamaño en Kbytes de un fichero
-    *
-    * @param string $file: path del fichero
-    *
-    * @return int con el tamaño del fichero
-  */
+   * Devuelve el tamaño en Kbytes de un fichero
+   *
+   * @param string $file: path del fichero
+   *
+   * @return int con el tamaño del fichero
+   */
   final public static function file_size(string $file) : int {
-  	return (int) round(filesize($file)*0.0009765625, 1);
+    return (int) round(filesize($file)*0.0009765625, 1);
   }
 
   //------------------------------------------------
 
   /**
-    * Devuelve la fecha y hora exacta de creación de un fichero
-    *
-    * @param string $file: path del fichero
-    *
-    * @return string con la fecha del fichero en el formato d-m-y h:i:s
-  */
+   * Devuelve la fecha y hora exacta de creación de un fichero
+   *
+   * @param string $file: path del fichero
+   *
+   * @return string con la fecha del fichero en el formato d-m-y h:i:s
+   */
   final public static function date_file(string $file) : string {
-  	return date('d-m-Y h:i:s', filemtime($file));
+    return date('d-m-Y h:i:s', filemtime($file));
   }
 
   //------------------------------------------------
 
   /**
-    * Devuelve en un arreglo numérico, la ruta de todos los ficheros en un directorio filtrado por tipos
-    *
-    * @param string $dir: directorio completo
-    * @param string $types: tipos de archivos a buscar, por defecto '' significa todos, se puede pasar por ejemplo 'jpg'
-    *
-    * @return array con las rutas de todos los ficheros encontrados, un array vacío si no encontró ficheros
-  */
+   * Devuelve en un arreglo numérico, la ruta de todos los ficheros en un directorio filtrado por tipos
+   *
+   * @param string $dir: directorio completo
+   * @param string $types: tipos de archivos a buscar, por defecto '' significa todos, se puede pasar por ejemplo 'jpg'
+   *
+   * @return array con las rutas de todos los ficheros encontrados, un array vacío si no encontró ficheros
+   */
   final public static function get_files_in_dir(string $dir, string $types = '') : array {
     $array = array();
     if (is_dir($dir)) {
@@ -146,13 +146,13 @@ 
   //------------------------------------------------
 
   /**
-    * Crea un directorio
-    *
-    * @param string $dir: Directorio a crear
-    * @param int $permisos: Permisos del directorio a crear, por defecto es "todos los permisos"
-    *
-    * @return bool con true si fue creado con éxito, false si el directorio ya existía o hubo algún error
-  */
+   * Crea un directorio
+   *
+   * @param string $dir: Directorio a crear
+   * @param int $permisos: Permisos del directorio a crear, por defecto es "todos los permisos"
+   *
+   * @return bool con true si fue creado con éxito, false si el directorio ya existía o hubo algún error
+   */
   final public static function create_dir(string $dir, int $permisos = 0755) : bool {
     if(is_dir($dir)) {
       return false;
@@ -248,10 +248,10 @@ 
   //------------------------------------------------
 
   /**
-    * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig
-    *
-    * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig
-  */
+   * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig
+   *
+   * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig
+   */
   public function getFunctions() : array {
     return array(
       new \Twig_Function('images_in_dir', array($this, 'images_in_dir')),
@@ -266,10 +266,10 @@ 
   //------------------------------------------------
 
   /**
-    * Identificador único para la extensión de twig
-    *
-    * @return string con el nombre de la extensión
-  */
+   * Identificador único para la extensión de twig
+   *
+   * @return string con el nombre de la extensión
+   */
   public function getName() : string {
     return 'ocrend_framework_helper_files';
   }

Ocrend/Kernel/Controllers/Controllers.php

Indentation +38 added lines, -38 removed lines

@@ -25,65 +25,65 @@
 abstract class Controllers {
     
     /**
-      * Obtiene el objeto del template 
-      *
-      * @var \Twig_Environment
-    */
+     * Obtiene el objeto del template 
+     *
+     * @var \Twig_Environment
+     */
     protected $template;
 
     /**
-      * Verifica si está definida la ruta /id como un integer >= 1
-      *
-      * @var bool
-    */
+     * Verifica si está definida la ruta /id como un integer >= 1
+     *
+     * @var bool
+     */
     protected $isset_id = false;
 
     /**
-      * Tiene el valor de la ruta /método
-      *
-      * @var string|null
-    */
+     * Tiene el valor de la ruta /método
+     *
+     * @var string|null
+     */
     protected $method;
 
     /**
-      * Contiene una instancia del helper para funciones
-      *
-      * @var \Ocrend\Kernel\Helpers\Functions
-    */
+     * Contiene una instancia del helper para funciones
+     *
+     * @var \Ocrend\Kernel\Helpers\Functions
+     */
     protected $functions;
     
     /**
-      * Arreglo con la información del usuario conectado actualmente.
-      *
-      * @var array 
-    */
+     * Arreglo con la información del usuario conectado actualmente.
+     *
+     * @var array 
+     */
     protected $user = array();
 
     /**
-      * Contiene información sobre el estado del usuario, si está o no conectado.
-      *
-      * @var bool
-    */
+     * Contiene información sobre el estado del usuario, si está o no conectado.
+     *
+     * @var bool
+     */
     private $is_logged = false;
 
     /** 
-      * Parámetros de configuración para el controlador con la forma:
-      * 'parmáetro' => (bool) valor
-      *
-      * @var array
-    */
+     * Parámetros de configuración para el controlador con la forma:
+     * 'parmáetro' => (bool) valor
+     *
+     * @var array
+     */
     private $controllerConfig;
 
     /**
-      * Configuración inicial de cualquier controlador
-      *
-      * @param IRouter $router: Instancia de un Router
-      * @param array|null $configController: Arreglo de configuración con la forma  
-      *     'twig_cache_reload' => bool, # Configura el autoreload del caché de twig
-      *     'users_logged' => bool, # Configura el controlador para solo ser visto por usuarios logeados
-      *     'users_not_logged' => bool, # Configura el controlador para solo ser visto por !(usuarios logeados)
-      *
-    */
+     * Configuración inicial de cualquier controlador
+     *
+     * @param IRouter $router: Instancia de un Router
+     * @param array|null $configController: Arreglo de configuración con la forma  
+     *     'twig_cache_reload' => bool, # Configura el autoreload del caché de twig
+     *     'users_logged' => bool, # Configura el controlador para solo ser visto por usuarios logeados
+     *     'users_not_logged' => bool, # Configura el controlador para solo ser visto por !(usuarios logeados)
+     *
+     */
     protected function __construct(IRouter $router, $configController = null) {
         global $config, $http, $session;
 

Ocrend/Kernel/Router/Rules.php

Indentation +48 added lines, -48 removed lines

@@ -20,89 +20,89 @@
 final class Rules {
 
     /**
-        * Sin ninguna regla
-        *
-        * @param mixed $ruta : Ruta a aplicar la regla
-        *
-        * @return mixed
-    */
+     * Sin ninguna regla
+     *
+     * @param mixed $ruta : Ruta a aplicar la regla
+     *
+     * @return mixed
+     */
     final public function none($ruta) {
         return $ruta;
     }
 
     /**
-        * Sólamente letras
-        *
-        * @param mixed $ruta : Ruta a aplicar la regla
-        *
-        * @return mixed
-    */    
+     * Sólamente letras
+     *
+     * @param mixed $ruta : Ruta a aplicar la regla
+     *
+     * @return mixed
+     */    
     final public function letters($ruta) {
         return preg_match("/^[a-zA-Z ]*$/", $ruta) ? $ruta : null;
     }
 
     /**
-        * Letras y números
-        *
-        * @param mixed $ruta : Ruta a aplicar la regla
-        *
-        * @return mixed
-    */   
+     * Letras y números
+     *
+     * @param mixed $ruta : Ruta a aplicar la regla
+     *
+     * @return mixed
+     */   
     final public function alphanumeric($ruta) {
         return preg_match('/^[a-zA-Z0-9 ]*$/', $ruta) ? $ruta : null;
     }
 
     /**
-        * Con forma para URL (letras,números y el caracter -)
-        *
-        * @param mixed $ruta : Ruta a aplicar la regla
-        *
-        * @return mixed
-    */
+     * Con forma para URL (letras,números y el caracter -)
+     *
+     * @param mixed $ruta : Ruta a aplicar la regla
+     *
+     * @return mixed
+     */
     final public function url($ruta) {
         return preg_match('/^[a-zA-Z0-9- ]*$/', $ruta) ? $ruta : null;
     }
 
     /**
-        * Sólamente números enteros
-        *
-        * @param mixed $ruta : Ruta a aplicar la regla
-        *
-        * @return int|null
-    */
+     * Sólamente números enteros
+     *
+     * @param mixed $ruta : Ruta a aplicar la regla
+     *
+     * @return int|null
+     */
     final public function integer($ruta) {
         return is_numeric($ruta) ? (int) $ruta : null;
     }
 
     /**
-        * Solamente números enteros positivos
-        *
-        * @param mixed $ruta : Ruta a aplicar la regla
-        *
-        * @return int|null
-    */    
+     * Solamente números enteros positivos
+     *
+     * @param mixed $ruta : Ruta a aplicar la regla
+     *
+     * @return int|null
+     */    
     final public function integer_positive($ruta) {
         return (is_numeric($ruta) && $ruta >= 0) ? (int) $ruta : null;
     }
 
     /**
-        * Solamente números con decimal
-        *
-        * @param mixed $ruta : Ruta a aplicar la regla
-        *
-        * @return float|null
-    */
+     * Solamente números con decimal
+     *
+     * @param mixed $ruta : Ruta a aplicar la regla
+     *
+     * @return float|null
+     */
     final public function float($ruta) {
         return is_numeric($ruta) ? (float) $ruta : null;
     }
 
     /**
-        * Solamente números con decimal y positivos
-        *
-        * @param mixed $ruta : Ruta a aplicar la regla
-        *
-        * @return float|null
-    */
+     * Solamente números con decimal y positivos
+     *
+     * @param mixed $ruta : Ruta a aplicar la regla
+     *
+     * @return float|null
+     */
     final public function float_positive($ruta) {
         return (is_numeric($ruta) && $ruta >= 0) ? (float) $ruta : null;
     }

Ocrend/Kernel/Helpers/Strings.php

Indentation +116 added lines, -116 removed lines

@@ -20,13 +20,13 @@ 
 final class Strings extends \Twig_Extension {
   //------------------------------------------------
   /**
-    * Convierte un tiempo dado al formato hace 1 minuto, hace 2 horas, hace 1 año ...
-    *
-    * @param int $from: Tiempo en segundo desde donde se desea contar
-    * @param int $to: Tiempo en segundo hasta donde se desea contar, si no se pasa por defecto es el tiempo actual
-    *
-    * @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 ...
-  */
+   * Convierte un tiempo dado al formato hace 1 minuto, hace 2 horas, hace 1 año ...
+   *
+   * @param int $from: Tiempo en segundo desde donde se desea contar
+   * @param int $to: Tiempo en segundo hasta donde se desea contar, si no se pasa por defecto es el tiempo actual
+   *
+   * @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 ...
+   */
   final public static function amigable_time(int $from, int $to = 0) : string {   
     $intervalos = array("segundo", "minuto", "hora", "día", "semana", "mes", "año");
     $duraciones = array("60","60","24","7","4.35","12");
@@ -59,39 +59,39 @@ 
   }
   //------------------------------------------------
   /**
-    * Compara un string hash con un string sin hash, si el string sin hash al encriptar posee la misma llave que hash, son iguales
-    *
-    * @param string $hash: Hash con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G
-    * @param string $s2: Cadena de texto a comparar
-    *
-    * @example Strings::chash('$2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G','123456'); //return true
-    *
-    * @return bool true si $s2 contiene la misma llave que $hash, por tanto el contenido de $hash es $s2, de lo contrario false
-  */
+   * Compara un string hash con un string sin hash, si el string sin hash al encriptar posee la misma llave que hash, son iguales
+   *
+   * @param string $hash: Hash con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G
+   * @param string $s2: Cadena de texto a comparar
+   *
+   * @example Strings::chash('$2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G','123456'); //return true
+   *
+   * @return bool true si $s2 contiene la misma llave que $hash, por tanto el contenido de $hash es $s2, de lo contrario false
+   */
   final public static function chash(string $hash, string $s2) : bool  {
     return $hash == crypt($s2, substr($hash, 0, 29));
-   }
-   //------------------------------------------------
+    }
+    //------------------------------------------------
   /**
-    * Devuelve un hash DINÁMICO, para comparar un hash con un elemento se utiliza chash
-    *
-    * @param string $p: Cadena de texto a encriptar
-    *
-    * @return string Hash, con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G
-  */
+   * Devuelve un hash DINÁMICO, para comparar un hash con un elemento se utiliza chash
+   *
+   * @param string $p: Cadena de texto a encriptar
+   *
+   * @return string Hash, con la forma $2a$10$87b2b603324793cc37f8dOPFTnHRY0lviq5filK5cN4aMCQDJcC9G
+   */
   final public static function hash(string $p) : string {
     return crypt($p, '$2a$10$' . substr(sha1(mt_rand()), 0, 22));
   }
   //------------------------------------------------
   /**
-    * Calcula el tiempo de diferencia entre dos fechas
-    *
-    * @param string $ini: Fecha menor con el formato d-m-Y ó d/m/Y
-    * @param string $fin: Fecha mayor con el formato d-m-Y ó d/m/Y
-    *
-    * @return int con la diferencia de tiempo en días
-    *
-  */
+   * Calcula el tiempo de diferencia entre dos fechas
+   *
+   * @param string $ini: Fecha menor con el formato d-m-Y ó d/m/Y
+   * @param string $fin: Fecha mayor con el formato d-m-Y ó d/m/Y
+   *
+   * @return int con la diferencia de tiempo en días
+   *
+   */
   final public static function date_difference(string $ini, string $fin) : int {
     $ini_i = explode('-',str_replace('/','-',$ini));
     $fin_i = explode('-',str_replace('/','-',$fin));
@@ -99,90 +99,90 @@ 
   }
   //------------------------------------------------
   /**
-    * Calcula la edad de una persona segun la fecha de nacimiento
-    *
-    * @param string $cumple: Fecha de nacimiento con el formato d-m-Y ó d/m/Y
-    *
-    * @return int con la edad
-    *
-  */
+   * Calcula la edad de una persona segun la fecha de nacimiento
+   *
+   * @param string $cumple: Fecha de nacimiento con el formato d-m-Y ó d/m/Y
+   *
+   * @return int con la edad
+   *
+   */
   final public static function calculate_age(string $cumple) : int {
     $age = explode('.', (string) (self::date_difference($cumple, date('d-m-Y', time()))/365));
     return (int) $age[0];
   }
   //------------------------------------------------
   /**
-    * Calcula cuántos días tiene el mes actual
-    *
-    * @return integer con la cantidad de días del mes
-    *
-  */
+   * Calcula cuántos días tiene el mes actual
+   *
+   * @return integer con la cantidad de días del mes
+   *
+   */
   final public static function days_of_month() : int {
     return cal_days_in_month(CAL_GREGORIAN, (int) date('m',time()), (int) date('Y',time()));
   }
   //------------------------------------------------
   /**
-    * Verifica si una cadena de texto tiene forma de email
-    *
-    * @param string $address: Cadena de texto con el email
-    *
-    * @return mixed devuelve TRUE si es un email y FALSE si no lo es
-  */
+   * Verifica si una cadena de texto tiene forma de email
+   *
+   * @param string $address: Cadena de texto con el email
+   *
+   * @return mixed devuelve TRUE si es un email y FALSE si no lo es
+   */
   final public static function is_email(string $address) {
     return filter_var($address, FILTER_VALIDATE_EMAIL);
   }
   //------------------------------------------------
   /**
-    * Remueve todos los espacios en blanco de un string
-    *
-    * @param string $s: Cadena de texto a convertir
-    *
-    * @return string del texto sin espacios
-  */
+   * Remueve todos los espacios en blanco de un string
+   *
+   * @param string $s: Cadena de texto a convertir
+   *
+   * @return string del texto sin espacios
+   */
   final public static function remove_spaces(string $s) : string {
     return trim(str_replace(' ', '', $s));
   }
   //------------------------------------------------
   /**
-    * Analiza si una cadena de texto es alfanumérica
-    *
-    * @param string $s: Cadena de texto a verificar
-    *
-    * @return bool, verdadero si es alfanumerica, falso si no
-  */
+   * Analiza si una cadena de texto es alfanumérica
+   *
+   * @param string $s: Cadena de texto a verificar
+   *
+   * @return bool, verdadero si es alfanumerica, falso si no
+   */
   final public static function alphanumeric(string $s) : bool {
     return ctype_alnum(self::remove_spaces($s));
   }
   //------------------------------------------------
   /**
-    * Analiza si una cadena de texto verificando si sólamente tiene letras
-    *
-    * @param string $s: Cadena de texto a verificar
-    *
-    * @return bool, verdadero si sólamente tiene letras, falso si no
-  */
+   * Analiza si una cadena de texto verificando si sólamente tiene letras
+   *
+   * @param string $s: Cadena de texto a verificar
+   *
+   * @return bool, verdadero si sólamente tiene letras, falso si no
+   */
   final public static function only_letters(string $s) : bool {
     return ctype_alpha(self::remove_spaces($s));
   }
   //------------------------------------------------
   /**
-    * Analiza si una cadena de texto contiene sólamente letras y números
-    *
-    * @param string $s: Cadena de texto a verificar
-    *
-    * @return bool, verdadero si sólamente contiene letras y números, falso si no
-  */
+   * Analiza si una cadena de texto contiene sólamente letras y números
+   *
+   * @param string $s: Cadena de texto a verificar
+   *
+   * @return bool, verdadero si sólamente contiene letras y números, falso si no
+   */
   final public static function letters_and_numbers(string $s) : bool {
     return (boolean) preg_match('/^[\w.]*$/', self::remove_spaces($s));
   }
   //------------------------------------------------
   /**
-    * Convierte una expresión de texto, a una compatible con url amigables
-    *
-    * @param string $url: Cadena de texto a convertir
-    *
-    * @return string Cadena de texto con formato de url amigable
-  */
+   * Convierte una expresión de texto, a una compatible con url amigables
+   *
+   * @param string $url: Cadena de texto a convertir
+   *
+   * @return string Cadena de texto con formato de url amigable
+   */
   final public static function url_amigable(string $url) : string {
     $url = strtolower($url);
     $url = str_replace(['á', 'é', 'í', 'ó', 'ú', 'ñ'], ['a', 'e', 'i', 'o', 'u', 'n'], $url);
@@ -244,58 +244,58 @@ 
   }
   //------------------------------------------------
   /**
-    * Dice si un string comienza con un caracter especificado
-    *
-    * @param string $sx: Caracter de inicio
-    * @param string $str: String a evaluar
-    * @param bool $case_sensitive: Boolean para definir si será seible a mayúsculas o no
-    *
-    * @return bool True si comienza con el caracter especificado, False si no
-  */
+   * Dice si un string comienza con un caracter especificado
+   *
+   * @param string $sx: Caracter de inicio
+   * @param string $str: String a evaluar
+   * @param bool $case_sensitive: Boolean para definir si será seible a mayúsculas o no
+   *
+   * @return bool True si comienza con el caracter especificado, False si no
+   */
   final public static function begin_with(string $sx, string $str) : bool {
     return (bool) (strlen($str) > 0 and $str[0] == $sx);
   }
   //------------------------------------------------
   /**
-    * Dice si un string termina con una caracter especificado
-    *
-    * @param string $sx: Caracter del final
-    * @param string $str: String a evaluar
-    *
-    * @return bool True si termina con el caracter especificado, False si no
-  */
+   * Dice si un string termina con una caracter especificado
+   *
+   * @param string $sx: Caracter del final
+   * @param string $str: String a evaluar
+   *
+   * @return bool True si termina con el caracter especificado, False si no
+   */
   final public static function end_with(string $sx, string $str) : bool {
     return (bool) (strlen($str) > 0 and $str[strlen($str) - 1] == $sx);
   }
   //------------------------------------------------
   /**
-    * Ver si un string está contenido en otro
-    *
-    * @param $s: String contenido en $str
-    * @param $str: String a evaluar
-    *
-    * @return bool True si $s está dentro de $str, False si no
-  */
+   * Ver si un string está contenido en otro
+   *
+   * @param $s: String contenido en $str
+   * @param $str: String a evaluar
+   *
+   * @return bool True si $s está dentro de $str, False si no
+   */
   final public static function contain(string $s, string $str) : bool {
     return (bool) (strpos($str, $s) !== false);
   }
   //------------------------------------------------
   /**
-    * Devuelve la cantidad de palabras en un string
-    *
-    * @param $str: String a evaluar
-    *
-    * @return int Cantidad de palabras
-  */
+   * Devuelve la cantidad de palabras en un string
+   *
+   * @param $str: String a evaluar
+   *
+   * @return int Cantidad de palabras
+   */
   final public static function count_words(string $s) : int {
     return (int) str_word_count($s,0);
   }
   //------------------------------------------------
   /**
-    * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig
-    *
-    * @return array Todas las funciones con sus respectivos nombres de acceso en plantillas twig
-  */
+   * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig
+   *
+   * @return array Todas las funciones con sus respectivos nombres de acceso en plantillas twig
+   */
   public function getFunctions() : array {
     return array(
       new \Twig_Function('amigable_time', array($this, 'amigable_time')),
@@ -319,10 +319,10 @@ 
   }
   //------------------------------------------------
   /**
-    * Identificador único para la extensión de twig
-    *
-    * @return string Nombre de la extensión
-  */
+   * Identificador único para la extensión de twig
+   *
+   * @return string Nombre de la extensión
+   */
   public function getName() : string {
     return 'ocrend_framework_helper_strings';
   }

Ocrend/Kernel/Helpers/Functions.php

Indentation +142 added lines, -142 removed lines

@@ -19,20 +19,20 @@ 
 
 final class Functions extends \Twig_Extension {
 
-   /**
-      * Verifica parte de una fecha, método privado usado en str_to_time
-      * 
-      * @param int $index: Índice del arreglo
-      * @param array $detail: Arreglo
-      * @param int $max: Valor a comparar
-      *
-      * @return bool con el resultado de la comparación
-   */
+    /**
+     * Verifica parte de una fecha, método privado usado en str_to_time
+     * 
+     * @param int $index: Índice del arreglo
+     * @param array $detail: Arreglo
+     * @param int $max: Valor a comparar
+     *
+     * @return bool con el resultado de la comparación
+     */
   final private function check_str_to_time(int $index, array $detail, int $max) : bool {
     return !array_key_exists($index,$detail) || !is_numeric($detail[$index]) || intval($detail[$index]) < $max;
   }
 
-   //------------------------------------------------
+    //------------------------------------------------
 
     /**
      * Redirecciona a una URL
@@ -84,55 +84,55 @@ 
   //------------------------------------------------
 
   /**
-    * Retorna la URL de un gravatar, según el email
-    *
-    * @param string  $email: El email del usuario a extraer el gravatar
-    * @param int $size: El tamaño del gravatar
-    * @return string con la URl
-  */
-   final public function get_gravatar(string $email, int $size = 32) : string  {
-       return 'http://www.gravatar.com/avatar/' . md5($email) . '?s=' . (int) abs($size);
-   }
-
-   //------------------------------------------------
-
-   /**
+   * Retorna la URL de un gravatar, según el email
+   *
+   * @param string  $email: El email del usuario a extraer el gravatar
+   * @param int $size: El tamaño del gravatar
+   * @return string con la URl
+   */
+    final public function get_gravatar(string $email, int $size = 32) : string  {
+        return 'http://www.gravatar.com/avatar/' . md5($email) . '?s=' . (int) abs($size);
+    }
+
+    //------------------------------------------------
+
+    /**
      * Alias de Empty, más completo
      *
      * @param mixed $var: Variable a analizar
      *
      * @return bool con true si está vacío, false si no, un espacio en blanco cuenta como vacío
-   */
-   final public function emp($var) : bool {
-     return (null === $var || empty(trim(str_replace(' ','',$var))));
-   }
+     */
+    final public function emp($var) : bool {
+      return (null === $var || empty(trim(str_replace(' ','',$var))));
+    }
 
-   //------------------------------------------------
+    //------------------------------------------------
 
-   /**
+    /**
      * 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
      * pasando como parámetro $_POST
      *
      * @param array $array, arreglo a analizar
      *
      * @return bool con true si están todos llenos, false si al menos uno está vacío
-   */
-   final public function all_full(array $array) : bool {
-     foreach($array as $e) {
-       if($this->emp($e) and $e != '0') {
-         return false;
-       }
-     }
-     return true;
-   }
-
-   //------------------------------------------------
-
-   /**
+     */
+    final public function all_full(array $array) : bool {
+      foreach($array as $e) {
+        if($this->emp($e) and $e != '0') {
+          return false;
+        }
+      }
+      return true;
+    }
+
+    //------------------------------------------------
+
+    /**
      * Alias de Empty() pero soporta más de un parámetro (infinitos)
      *
      * @return bool con true si al menos uno está vacío, false si todos están llenos
-   */
+     */
     final public function e() : bool  {
       for ($i = 0, $nargs = func_num_args(); $i < $nargs; $i++) {
         if($this->emp(func_get_arg($i)) && func_get_arg($i) != '0') {
@@ -145,58 +145,58 @@ 
     //------------------------------------------------
 
     /**
-      * Alias de date() pero devuele días y meses en español
-      *
-      * @param string $format: Formato de salida (igual que en date())
-      * @param int $time: Tiempo, por defecto es time() (igual que en date())
-      *
-      * @return string con la fecha en formato humano (y en español)
-    */
+     * Alias de date() pero devuele días y meses en español
+     *
+     * @param string $format: Formato de salida (igual que en date())
+     * @param int $time: Tiempo, por defecto es time() (igual que en date())
+     *
+     * @return string con la fecha en formato humano (y en español)
+     */
     final public function fecha(string $format, int $time = 0) : string  {
-       $date = date($format,$time == 0 ? time() : $time);
-       $cambios = array(
-         'Monday'=> 'Lunes',
-         'Tuesday'=> 'Martes',
-         'Wednesday'=> 'Miércoles',
-         'Thursday'=> 'Jueves',
-         'Friday'=> 'Viernes',
-         'Saturday'=> 'Sábado',
-         'Sunday'=> 'Domingo',
-         'January'=> 'Enero',
-         'February'=> 'Febrero',
-         'March'=> 'Marzo',
-         'April'=> 'Abril',
-         'May'=> 'Mayo',
-         'June'=> 'Junio',
-         'July'=> 'Julio',
-         'August'=> 'Agosto',
-         'September'=> 'Septiembre',
-         'October'=> 'Octubre',
-         'November'=> 'Noviembre',
-         'December'=> 'Diciembre',
-         'Mon'=> 'Lun',
-         'Tue'=> 'Mar',
-         'Wed'=> 'Mie',
-         'Thu'=> 'Jue',
-         'Fri'=> 'Vie',
-         'Sat'=> 'Sab',
-         'Sun'=> 'Dom',
-         'Jan'=> 'Ene',
-         'Aug'=> 'Ago',
-         'Apr'=> 'Abr',
-         'Dec'=> 'Dic'
-       );
-       return str_replace(array_keys($cambios), array_values($cambios), $date);
-     }
-
-   //------------------------------------------------
+        $date = date($format,$time == 0 ? time() : $time);
+        $cambios = array(
+          'Monday'=> 'Lunes',
+          'Tuesday'=> 'Martes',
+          'Wednesday'=> 'Miércoles',
+          'Thursday'=> 'Jueves',
+          'Friday'=> 'Viernes',
+          'Saturday'=> 'Sábado',
+          'Sunday'=> 'Domingo',
+          'January'=> 'Enero',
+          'February'=> 'Febrero',
+          'March'=> 'Marzo',
+          'April'=> 'Abril',
+          'May'=> 'Mayo',
+          'June'=> 'Junio',
+          'July'=> 'Julio',
+          'August'=> 'Agosto',
+          'September'=> 'Septiembre',
+          'October'=> 'Octubre',
+          'November'=> 'Noviembre',
+          'December'=> 'Diciembre',
+          'Mon'=> 'Lun',
+          'Tue'=> 'Mar',
+          'Wed'=> 'Mie',
+          'Thu'=> 'Jue',
+          'Fri'=> 'Vie',
+          'Sat'=> 'Sab',
+          'Sun'=> 'Dom',
+          'Jan'=> 'Ene',
+          'Aug'=> 'Ago',
+          'Apr'=> 'Abr',
+          'Dec'=> 'Dic'
+        );
+        return str_replace(array_keys($cambios), array_values($cambios), $date);
+      }
+
+    //------------------------------------------------
 
   /**
-    *  Devuelve la etiqueta <base> html adecuada para que los assets carguen desde allí.
-    *  Se adapta a la configuración del dominio en general.
-    *
-    * @return string <base href="ruta" />
-  */
+   *  Devuelve la etiqueta <base> html adecuada para que los assets carguen desde allí.
+   *  Se adapta a la configuración del dominio en general.
+   *
+   * @return string <base href="ruta" />
+   */
   final public function base_assets() : string {
     global $config, $http;
 
@@ -224,7 +224,7 @@ 
    * @param int $anio: Año (1975 a 2xxx)
    *
    * @return string con el número del día
-  */
+   */
   final public function last_day_month(int $mes, int $anio) : string {
     return date('d', (mktime(0,0,0,$mes + 1, 1, $anio) - 1));
   }
@@ -237,7 +237,7 @@ 
    * @param int $num: cifra
    *
    * @return string cifra con cero a la izquirda
-  */
+   */
   final public function cero_izq(int $num) : string {
     if($num < 10) {
       return '0' . $num;
@@ -248,14 +248,14 @@ 
 
   //------------------------------------------------
 
-   /**
-    * Devuelve el timestamp de una fecha, y null si su formato es incorrecto.
-    * 
-    * @param string|null $fecha: Fecha con formato dd/mm/yy
-    * @param string $hora: Hora de inicio de la $fecha
-    *
-    * @return int|null con el timestamp
-  */
+    /**
+     * Devuelve el timestamp de una fecha, y null si su formato es incorrecto.
+     * 
+     * @param string|null $fecha: Fecha con formato dd/mm/yy
+     * @param string $hora: Hora de inicio de la $fecha
+     *
+     * @return int|null con el timestamp
+     */
   final public function str_to_time($fecha, string $hora = '00:00:00') {
     if(null == $fecha) {
       return null;
@@ -292,7 +292,7 @@ 
    * @param int $desde: Desde donde
    *
    * @return mixed
-  */
+   */
   final public function desde_date(int $desde) {
     # Obtener esta fecha
     $hoy = date('d/m/Y/D',time());
@@ -300,19 +300,19 @@ 
 
     # Arreglo de condiciones y subcondiciones
     $fecha = array(
-       1 => date('d/m/Y', time()),
-       2 => date('d/m/Y', time() - (60*60*24)),
-       3 => array(
-         'Mon' => $hoy[0],
-         'Tue' => intval($hoy[0]) - 1,
-         'Wed' => intval($hoy[0]) - 2,
-         'Thu' => intval($hoy[0]) - 3,
-         'Fri' => intval($hoy[0]) - 4,
-         'Sat' => intval($hoy[0]) - 5,
-         'Sun' => intval($hoy[0]) - 6
-       ),
-       4 => '01/'. $this->cero_izq($hoy[1]) .'/' . $hoy[2],
-       5 => '01/01/' . $hoy[2]
+        1 => date('d/m/Y', time()),
+        2 => date('d/m/Y', time() - (60*60*24)),
+        3 => array(
+          'Mon' => $hoy[0],
+          'Tue' => intval($hoy[0]) - 1,
+          'Wed' => intval($hoy[0]) - 2,
+          'Thu' => intval($hoy[0]) - 3,
+          'Fri' => intval($hoy[0]) - 4,
+          'Sat' => intval($hoy[0]) - 5,
+          'Sun' => intval($hoy[0]) - 6
+        ),
+        4 => '01/'. $this->cero_izq($hoy[1]) .'/' . $hoy[2],
+        5 => '01/01/' . $hoy[2]
     );
 
     if($desde == 3) {
@@ -347,44 +347,44 @@ 
    * Obtiene el tiempo actual
    *
    * @return int devuelve time()
-  */
+   */
   final public function timestamp() : int {
-     return time();
+      return time();
   }
 
   //------------------------------------------------
 
   /**
    * Se obtiene de Twig_Extension y sirve para que cada función esté disponible como etiqueta en twig
-    *
+   *
    * @return array con todas las funciones con sus respectivos nombres de acceso en plantillas twig
-  */
+   */
   public function getFunctions() : array {
       return array(
-       new \Twig_Function('percent', array($this, 'percent')),
-       new \Twig_Function('convert', array($this, 'convert')),
-       new \Twig_Function('get_gravatar', array($this, 'get_gravatar')),
-       new \Twig_Function('emp', array($this, 'emp')),
-       new \Twig_Function('e_dynamic', array($this, 'e')),
-       new \Twig_Function('all_full', array($this, 'all_full')),
-       new \Twig_Function('fecha', array($this, 'fecha')),
-       new \Twig_Function('base_assets', array($this, 'base_assets')),
-       new \Twig_Function('timestamp', array($this, 'timestamp')),
-       new \Twig_Function('desde_date', array($this, 'desde_date')),
-       new \Twig_Function('cero_izq', array($this, 'cero_izq')),
-       new \Twig_Function('last_day_month', array($this, 'last_day_month')),
-       new \Twig_Function('str_to_time', array($this, 'str_to_time')),
-       new \Twig_Function('desde_date', array($this, 'desde_date'))
-     );
-   }
-
-   //------------------------------------------------
+        new \Twig_Function('percent', array($this, 'percent')),
+        new \Twig_Function('convert', array($this, 'convert')),
+        new \Twig_Function('get_gravatar', array($this, 'get_gravatar')),
+        new \Twig_Function('emp', array($this, 'emp')),
+        new \Twig_Function('e_dynamic', array($this, 'e')),
+        new \Twig_Function('all_full', array($this, 'all_full')),
+        new \Twig_Function('fecha', array($this, 'fecha')),
+        new \Twig_Function('base_assets', array($this, 'base_assets')),
+        new \Twig_Function('timestamp', array($this, 'timestamp')),
+        new \Twig_Function('desde_date', array($this, 'desde_date')),
+        new \Twig_Function('cero_izq', array($this, 'cero_izq')),
+        new \Twig_Function('last_day_month', array($this, 'last_day_month')),
+        new \Twig_Function('str_to_time', array($this, 'str_to_time')),
+        new \Twig_Function('desde_date', array($this, 'desde_date'))
+      );
+    }
+
+    //------------------------------------------------
 
   /**
-      * Identificador único para la extensión de twig
-      *
-      * @return string con el nombre de la extensión
-  */
+   * Identificador único para la extensión de twig
+   *
+   * @return string con el nombre de la extensión
+   */
   public function getName() : string {
         return 'ocrend_framework_func_class';
   }