prinick96 / Ocrend-Framework

app/models/Users.php

Indentation +127 added lines, -127 removed lines

@@ -28,36 +28,36 @@ 
 
 class Users extends Models implements IModels {
     /**
-      * Característica para establecer conexión con base de datos. 
-    */
+     * Característica para establecer conexión con base de datos. 
+     */
     use DBModel;
 
     /**
-      * Máximos intentos de inincio de sesión de un usuario
-      *
-      * @var int
-    */
+     * Máximos intentos de inincio de sesión de un usuario
+     *
+     * @var int
+     */
     const MAX_ATTEMPTS = 5;
 
     /**
-      * Tiempo entre máximos intentos en segundos
-      *
-      * @var int
-    */
+     * Tiempo entre máximos intentos en segundos
+     *
+     * @var int
+     */
     const MAX_ATTEMPTS_TIME = 120; # (dos minutos)
 
     /**
-      * Log de intentos recientes con la forma 'email' => (int) intentos
-      *
-      * @var array
-    */
+     * Log de intentos recientes con la forma 'email' => (int) intentos
+     *
+     * @var array
+     */
     private $recentAttempts = array();
 
-     /**
-      * Hace un set() a la sesión login_user_recentAttempts con el valor actualizado.
-      *
-      * @return void
-    */
+      /**
+       * Hace un set() a la sesión login_user_recentAttempts con el valor actualizado.
+       *
+       * @return void
+       */
     private function updateSessionAttempts() {
         global $session;
 
@@ -65,13 +65,13 @@ 
     }
 
     /**
-      * Genera la sesión con el id del usuario que ha iniciado
-      *
-      * @param string $pass : Contraseña sin encriptar
-      * @param string $pass_repeat : Contraseña repetida sin encriptar
-      *
-      * @throws ModelsException cuando las contraseñas no coinciden
-    */
+     * Genera la sesión con el id del usuario que ha iniciado
+     *
+     * @param string $pass : Contraseña sin encriptar
+     * @param string $pass_repeat : Contraseña repetida sin encriptar
+     *
+     * @throws ModelsException cuando las contraseñas no coinciden
+     */
     private function checkPassMatch(string $pass, string $pass_repeat) {
         if($pass != $pass_repeat) {
             throw new ModelsException('Las contraseñas no coinciden.');
@@ -79,12 +79,12 @@ 
     }
 
     /**
-      * Verifica el email introducido, tanto el formato como su existencia en el sistema
-      *
-      * @param string $email: Email del usuario
-      *
-      * @throws ModelsException en caso de que no tenga formato válido o ya exista
-    */
+     * Verifica el email introducido, tanto el formato como su existencia en el sistema
+     *
+     * @param string $email: Email del usuario
+     *
+     * @throws ModelsException en caso de que no tenga formato válido o ya exista
+     */
     private function checkEmail(string $email) {
         # Formato de email
         if(!Strings::is_email($email)) {
@@ -99,13 +99,13 @@ 
     }
 
     /**
-      * Restaura los intentos de un usuario al iniciar sesión
-      *
-      * @param string $email: Email del usuario a restaurar
-      *
-      * @throws ModelsException cuando hay un error de lógica utilizando este método
-      * @return void
-    */
+     * Restaura los intentos de un usuario al iniciar sesión
+     *
+     * @param string $email: Email del usuario a restaurar
+     *
+     * @throws ModelsException cuando hay un error de lógica utilizando este método
+     * @return void
+     */
     private function restoreAttempts(string $email) {       
         if(array_key_exists($email,$this->recentAttempts)) {
             $this->recentAttempts[$email]['attempts'] = 0;
@@ -118,12 +118,12 @@ 
     }
 
     /**
-      * Genera la sesión con el id del usuario que ha iniciado
-      *
-      * @param array $user_data: Arreglo con información de la base de datos, del usuario
-      *
-      * @return void
-    */
+     * Genera la sesión con el id del usuario que ha iniciado
+     *
+     * @param array $user_data: Arreglo con información de la base de datos, del usuario
+     *
+     * @return void
+     */
     private function generateSession(array $user_data) {
         global $session, $config;
 
@@ -132,14 +132,14 @@ 
     }
 
     /**
-      * Verifica en la base de datos, el email y contraseña ingresados por el usuario
-      *
-      * @param string $email: Email del usuario que intenta el login
-      * @param string $pass: Contraseña sin encriptar del usuario que intenta el login
-      *
-      * @return bool true: Cuando el inicio de sesión es correcto 
-      *              false: Cuando el inicio de sesión no es correcto
-    */
+     * Verifica en la base de datos, el email y contraseña ingresados por el usuario
+     *
+     * @param string $email: Email del usuario que intenta el login
+     * @param string $pass: Contraseña sin encriptar del usuario que intenta el login
+     *
+     * @return bool true: Cuando el inicio de sesión es correcto 
+     *              false: Cuando el inicio de sesión no es correcto
+     */
     private function authentication(string $email,string $pass) : bool {
         $email = $this->db->scape($email);
         $query = $this->db->select('id_user,pass','users',"email='$email'",'LIMIT 1');
@@ -159,10 +159,10 @@ 
     }
 
     /**
-      * Establece los intentos recientes desde la variable de sesión acumulativa
-      *
-      * @return void
-    */
+     * Establece los intentos recientes desde la variable de sesión acumulativa
+     *
+     * @return void
+     */
     private function setDefaultAttempts() {
         global $session;
 
@@ -172,12 +172,12 @@ 
     }
     
     /**
-      * Establece el intento del usuario actual o incrementa su cantidad si ya existe
-      *
-      * @param string $email: Email del usuario
-      *
-      * @return void
-    */
+     * Establece el intento del usuario actual o incrementa su cantidad si ya existe
+     *
+     * @param string $email: Email del usuario
+     *
+     * @return void
+     */
     private function setNewAttempt(string $email) {
         if(!array_key_exists($email,$this->recentAttempts)) {
             $this->recentAttempts[$email] = array(
@@ -191,14 +191,14 @@ 
     }
 
     /**
-      * Controla la cantidad de intentos permitidos máximos por usuario, si llega al límite,
-      * el usuario podrá seguir intentando en self::MAX_ATTEMPTS_TIME segundos.
-      *
-      * @param string $email: Email del usuario
-      *
-      * @throws ModelsException cuando ya ha excedido self::MAX_ATTEMPTS
-      * @return void
-    */
+     * Controla la cantidad de intentos permitidos máximos por usuario, si llega al límite,
+     * el usuario podrá seguir intentando en self::MAX_ATTEMPTS_TIME segundos.
+     *
+     * @param string $email: Email del usuario
+     *
+     * @throws ModelsException cuando ya ha excedido self::MAX_ATTEMPTS
+     * @return void
+     */
     private function maximumAttempts(string $email) {
         if($this->recentAttempts[$email]['attempts'] >= self::MAX_ATTEMPTS) {
             
@@ -219,10 +219,10 @@ 
     }
 
     /**
-      * Realiza la acción de login dentro del sistema
-      *
-      * @return array : Con información de éxito/falla al inicio de sesión.
-    */
+     * Realiza la acción de login dentro del sistema
+     *
+     * @return array : Con información de éxito/falla al inicio de sesión.
+     */
     public function login() : array {
         try {
             global $http;
@@ -258,10 +258,10 @@ 
     }
 
     /**
-      * Realiza la acción de registro dentro del sistema
-      *
-      * @return array : Con información de éxito/falla al registrar el usuario nuevo.
-    */
+     * Realiza la acción de registro dentro del sistema
+     *
+     * @return array : Con información de éxito/falla al registrar el usuario nuevo.
+     */
     public function register() : array {
         try {
             global $http;
@@ -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) {
@@ -364,13 +364,13 @@ 
     }
 
     /**
-      * Cambia la contraseña de un usuario en el sistema, luego de que éste haya solicitado cambiarla.
-      * Luego retorna al sitio de inicio con la variable GET success=(bool)
-      *
-      * La URL debe tener la forma URL/lostpass/cambiar/&token=TOKEN&user=ID
-      *
-      * @return void
-    */  
+     * Cambia la contraseña de un usuario en el sistema, luego de que éste haya solicitado cambiarla.
+     * Luego retorna al sitio de inicio con la variable GET success=(bool)
+     *
+     * La URL debe tener la forma URL/lostpass/cambiar/&token=TOKEN&user=ID
+     *
+     * @return void
+     */  
     public function changeTemporalPass() {
         global $config, $http;
         
@@ -394,10 +394,10 @@ 
     }
 
     /**
-      * Desconecta a un usuario si éste está conectado, y lo devuelve al inicio
-      *
-      * @return void
-    */    
+     * Desconecta a un usuario si éste está conectado, y lo devuelve al inicio
+     *
+     * @return void
+     */    
     public function logout() {
         global $session;
 
@@ -409,36 +409,36 @@ 
     }
 
     /**
-      * Obtiene datos de un usuario según su id en la base de datos
-      *    
-      * @param int $id: Id del usuario a obtener
-      * @param string $select : Por defecto es *, se usa para obtener sólo los parámetros necesarios 
-      *
-      * @return false|array con información del usuario
-    */   
+     * Obtiene datos de un usuario según su id en la base de datos
+     *    
+     * @param int $id: Id del usuario a obtener
+     * @param string $select : Por defecto es *, se usa para obtener sólo los parámetros necesarios 
+     *
+     * @return false|array con información del usuario
+     */   
     public function getUserById(int $id, string $select = '*') {
-       return $this->db->select($select,'users',"id_user='$id'",'LIMIT 1');
+        return $this->db->select($select,'users',"id_user='$id'",'LIMIT 1');
     }
     
     /**
-      * Obtiene a todos los usuarios
-      *    
-      * @param string $select : Por defecto es *, se usa para obtener sólo los parámetros necesarios 
-      *
-      * @return false|array con información de los usuarios
-    */  
+     * Obtiene a todos los usuarios
+     *    
+     * @param string $select : Por defecto es *, se usa para obtener sólo los parámetros necesarios 
+     *
+     * @return false|array con información de los usuarios
+     */  
     public function getUsers(string $select = '*') {
-       return $this->db->select($select,'users');
+        return $this->db->select($select,'users');
     }
 
     /**
-      * Obtiene datos del usuario conectado actualmente
-      *
-      * @param string $select : Por defecto es *, se usa para obtener sólo los parámetros necesarios
-      *
-      * @throws ModelsException si el usuario no está logeado
-      * @return array con datos del usuario conectado
-    */
+     * Obtiene datos del usuario conectado actualmente
+     *
+     * @param string $select : Por defecto es *, se usa para obtener sólo los parámetros necesarios
+     *
+     * @throws ModelsException si el usuario no está logeado
+     * @return array con datos del usuario conectado
+     */
     public function getOwnerUser(string $select = '*') : array {
         if(null !== $this->id_user) {    
                
@@ -456,10 +456,10 @@ 
     }
 
     /**
-      * Instala el módulo de usuarios en la base de datos para que pueda funcionar correctamete.
-      *
-      * @throws \RuntimeException si no se puede realizar la query
-    */
+     * Instala el módulo de usuarios en la base de datos para que pueda funcionar correctamete.
+     *
+     * @throws \RuntimeException si no se puede realizar la query
+     */
     public function install() {
         if(!$this->db->query("
             CREATE TABLE IF NOT EXISTS `users` (
@@ -480,16 +480,16 @@ 
     }
 
     /**
-      * __construct()
-    */
+     * __construct()
+     */
     public function __construct(IRouter $router = null) {
         parent::__construct($router);
         $this->startDBConexion();
     }
 
     /**
-      * __destruct()
-    */ 
+     * __destruct()
+     */ 
     public function __destruct() {
         parent::__destruct();
         $this->endDBConexion();

Ocrend/Kernel/Controllers/Controllers.php

Indentation +49 added lines, -49 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;
 
@@ -131,13 +131,13 @@ 
     }
 
     /**
-      * Establece los parámetros de configuración de un controlador
-      *
-      * @param IRouter $router: Instancia de un Router
-      * @param array|null $config: Arreglo de configuración   
-      *
-      * @return void
-    */
+     * Establece los parámetros de configuración de un controlador
+     *
+     * @param IRouter $router: Instancia de un Router
+     * @param array|null $config: Arreglo de configuración   
+     *
+     * @return void
+     */
     private function setControllerConfig($config) {
       # Configuración por defecto
       $this->controllerConfig['twig_cache_reload'] = true;
@@ -162,10 +162,10 @@ 
     }
     
     /**
-      * Acción que regula quién entra o no al controlador según la configuración
-      *
-      * @return void
-    */
+     * Acción que regula quién entra o no al controlador según la configuración
+     *
+     * @return void
+     */
     private function knowVisitorPermissions() {
       # Sólamente usuarios logeados
       if($this->controllerConfig['users_logged'] && !$this->is_logged) {

Ocrend/Kernel/Helpers/Emails.php

Indentation +30 added lines, -30 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;
 
@@ -104,12 +104,12 @@ 
   //------------------------------------------------
 
   /**
-    * Plantilla estándar que muestra de forma amigable el texto, utiliza bootstrap
-    *
-    * @param string $content: Cadena de texto en HTML, puede ser en bootstrap
-    *
-    * @return string con el HTML para enviar
-  */
+   * Plantilla estándar que muestra de forma amigable el texto, utiliza bootstrap
+   *
+   * @param string $content: Cadena de texto en HTML, puede ser en bootstrap
+   *
+   * @return string con el HTML para enviar
+   */
   final public static function plantilla(string $content) : string {
     return '
     <html>

Ocrend/Kernel/Helpers/Arrays.php

Indentation +61 added lines, -61 removed lines

@@ -19,28 +19,28 @@ 
 
 final class Arrays extends \Twig_Extension {
 
-   //------------------------------------------------
+    //------------------------------------------------
 
   /**
-    * Suma los contenidos del segundo arreglo en el primer arreglo, en las coincidencias de llaves.
-    *
-    * Si el primer arreglo está vacío, copiará todo el segundo arreglo en el primero. 
-    *
-    * Si el segundo arreglo está vacío, copiará todo el primer arreglo en el segundo.
-    *
-    * Si el arreglo $a tiene una estructura distinta a $b, la estructura de $a queda intacta y sólamente,
-    * se hará sumas en las posiciones donde haya coincidencias de llaves.
-    *
-    * El valor null será tomado como cero.
-    *
-    * @param array $a: Primer arreglo
-    * @param array $b: Segundo arreglo
-    *
-    * @throws RuntimeException si los arreglos son de distinto nivel
-    * @throws RuntimeException si en la posición de coincidencia no se puede realizar una operación de suma
-    *
-    * @return array fusión de los dos arreglos, dejando intactal estructura de $a
-  */
+   * Suma los contenidos del segundo arreglo en el primer arreglo, en las coincidencias de llaves.
+   *
+   * Si el primer arreglo está vacío, copiará todo el segundo arreglo en el primero. 
+   *
+   * Si el segundo arreglo está vacío, copiará todo el primer arreglo en el segundo.
+   *
+   * Si el arreglo $a tiene una estructura distinta a $b, la estructura de $a queda intacta y sólamente,
+   * se hará sumas en las posiciones donde haya coincidencias de llaves.
+   *
+   * El valor null será tomado como cero.
+   *
+   * @param array $a: Primer arreglo
+   * @param array $b: Segundo arreglo
+   *
+   * @throws RuntimeException si los arreglos son de distinto nivel
+   * @throws RuntimeException si en la posición de coincidencia no se puede realizar una operación de suma
+   *
+   * @return array fusión de los dos arreglos, dejando intactal estructura de $a
+   */
   final public static function arrays_sum(array $a, array $b) : array {
     # Si alguno está vacío
     if(sizeof($a) == 0) {
@@ -84,13 +84,13 @@ 
   //------------------------------------------------
 
   /**
-    * Dado un índice asociativo y un arreglo, devuelve el índice numérico correspondiente al asociativo
-    *
-    * @param string $index: Índice asociativo del arreglo
-    * @param array $a: Arreglo a evaluar
-    *
-    * @return int el índice correspondiente, -1 si no existe el indice
-  */
+   * Dado un índice asociativo y un arreglo, devuelve el índice numérico correspondiente al asociativo
+   *
+   * @param string $index: Índice asociativo del arreglo
+   * @param array $a: Arreglo a evaluar
+   *
+   * @return int el índice correspondiente, -1 si no existe el indice
+   */
   final public static function get_key_by_index(string $index, array $a) : int {
     $i = 0;
     foreach ($a as $key => $val) {
@@ -105,14 +105,14 @@ 
   //------------------------------------------------
 
   /**
-    * Elimina todos los elementos repetidos de un array
-    * (string) '1' se considera igual a (int) 1
-    *
-    * @param array $a: Arreglo a evaluar
-    *
-    * @return array devuelve un arreglo sin elementos repetidos
-    * http://stackoverflow.com/questions/8321620/array-unique-vs-array-flip
-  */
+   * Elimina todos los elementos repetidos de un array
+   * (string) '1' se considera igual a (int) 1
+   *
+   * @param array $a: Arreglo a evaluar
+   *
+   * @return array devuelve un arreglo sin elementos repetidos
+   * http://stackoverflow.com/questions/8321620/array-unique-vs-array-flip
+   */
   final public static function unique_array(array $a) : array {
     return array_keys(array_flip($a));
   }
@@ -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/Models/Models.php

Indentation +28 added lines, -28 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);
@@ -85,8 +85,8 @@ 
     }
 
     /**
-      * Cierra el modelo
-    */
+     * Cierra el modelo
+     */
     protected function __destruct() {}
 
 }
\ No newline at end of file

Ocrend/Kernel/Database/Database.php

Indentation +89 added lines, -89 removed lines

@@ -18,24 +18,24 @@ 
  * @author Brayan Narváez <prinick@ocrend.com>
  */
 
- class Database extends \PDO {
+  class Database extends \PDO {
 
-   /**
+    /**
      * Contiene la instancia de conexión a la base de datos
      * 
      * @var Database
-   */
-   private static $inst;
+     */
+    private static $inst;
 
   /**
-    * Inicia la instancia de conexión, si esta ya ha sido declarada antes, no la duplica y ahorra memoria.
-    *
-    * @param string|null $name : Nombre de la base de datos a conectar
-    * @param string|null $motor: Motor de la base de datos a conectar
-    * @param bool $new_instance: true para iniciar una nueva instancia (al querer conectar a una DB distinta)
-    *
-    * @return Database : Instancia de conexión
-  */
+   * Inicia la instancia de conexión, si esta ya ha sido declarada antes, no la duplica y ahorra memoria.
+   *
+   * @param string|null $name : Nombre de la base de datos a conectar
+   * @param string|null $motor: Motor de la base de datos a conectar
+   * @param bool $new_instance: true para iniciar una nueva instancia (al querer conectar a una DB distinta)
+   *
+   * @return Database : Instancia de conexión
+   */
   final public static function Start($name = null, $motor = null, bool $new_instance = false) : Database {
     global $config;
 
@@ -50,16 +50,16 @@ 
   }
 
   /**
-    * Inicia la conexión con la base de datos seleccionada
-    *
-    * @param string|null $name : Nombre de la base de datos a conectar
-    * @param string|null $motor: Motor de la base de datos a conectar
-    * @param bool $new_instance: true para iniciar una nueva instancia (al querer conectar a una DB distinta)
-    *
-    * @throws \RuntimeException si el motor no existe
-    * @throws \RuntimeException si existe algún problema de conexión con la base de datos
-    * @return Database : Instancia de conexión
-  */
+   * Inicia la conexión con la base de datos seleccionada
+   *
+   * @param string|null $name : Nombre de la base de datos a conectar
+   * @param string|null $motor: Motor de la base de datos a conectar
+   * @param bool $new_instance: true para iniciar una nueva instancia (al querer conectar a una DB distinta)
+   *
+   * @throws \RuntimeException si el motor no existe
+   * @throws \RuntimeException si existe algún problema de conexión con la base de datos
+   * @return Database : Instancia de conexión
+   */
   final public function __construct(string $name, string $motor) {
     global $config;
 
@@ -134,34 +134,34 @@ 
   }
 
   /**
-    * Convierte en arreglo asociativo de todos los resultados arrojados por una query
-    *
-    * @param object \PDOStatement $query, valor devuelto de la query
-    *
-    * @return array arreglo asociativo
-  */
+   * Convierte en arreglo asociativo de todos los resultados arrojados por una query
+   *
+   * @param object \PDOStatement $query, valor devuelto de la query
+   *
+   * @return array arreglo asociativo
+   */
   final public function fetch_array(\PDOStatement $query) : array {
     return $query->fetchAll(\PDO::FETCH_ASSOC);
   }
 
-   /**
-    * Cantidad de filas encontradas después de un SELECT
-    *
-    * @param object \PDOStatement $query, valor devuelto de la query
-    *
-    * @return int numero de filas encontradas
-  */
+    /**
+     * Cantidad de filas encontradas después de un SELECT
+     *
+     * @param object \PDOStatement $query, valor devuelto de la query
+     *
+     * @return int numero de filas encontradas
+     */
   final public function rows(\PDOStatement $query) : int {
     return $query->rowCount();
   }
 
   /**
-    * Sana un valor para posteriormente ser introducido en una query
-    *
-    * @param null/string/int/float a sanar
-    *
-    * @return mixed elemento sano
-  */
+   * Sana un valor para posteriormente ser introducido en una query
+   *
+   * @param null/string/int/float a sanar
+   *
+   * @return mixed elemento sano
+   */
   final public function scape($e) {
     if(null === $e) {
       return '';
@@ -178,28 +178,28 @@ 
   }
 
   /**
-    * Borra una serie de elementos de forma segura de una tabla en la base de datos
-    *
-    * @param string $table: Tabla a la cual se le quiere remover un elemento
-    * @param string $where: Condición de borrado que define quien/quienes son dichos elementos
-    * @param string $limit: Por defecto se limita a borrar un solo elemento que cumpla el $where
-    *
-    * @return \PDOStatement
-  */
+   * Borra una serie de elementos de forma segura de una tabla en la base de datos
+   *
+   * @param string $table: Tabla a la cual se le quiere remover un elemento
+   * @param string $where: Condición de borrado que define quien/quienes son dichos elementos
+   * @param string $limit: Por defecto se limita a borrar un solo elemento que cumpla el $where
+   *
+   * @return \PDOStatement
+   */
   final public function delete(string $table, string $where, string $limit = 'LIMIT 1') : \PDOStatement {
     return $this->query("DELETE FROM $table WHERE $where $limit;");
   }
 
   /**
-    * Inserta una serie de elementos a una tabla en la base de datos
-    *
-    * @param string $table: Tabla a la cual se le va a insertar elementos
-    * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo',
-    *                  todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo
-    *
-    * @throws \RuntimeException si el arreglo está vacío
-    * @return \PDOStatement
-  */
+   * Inserta una serie de elementos a una tabla en la base de datos
+   *
+   * @param string $table: Tabla a la cual se le va a insertar elementos
+   * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo',
+   *                  todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo
+   *
+   * @throws \RuntimeException si el arreglo está vacío
+   * @return \PDOStatement
+   */
   final public function insert(string $table, array $e) : \PDOStatement {
       if (sizeof($e) == 0) {
           throw new \RuntimeException('El arreglo pasado por $this->db->insert(\''.$table.'\',...) está vacío.');
@@ -219,17 +219,17 @@ 
   }
 
   /**
-    * Actualiza elementos de una tabla en la base de datos según una condición
-    *
-    * @param string $table: Tabla a actualizar
-    * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo',
-    *                  todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo
-    * @param string $where: Condición que indica quienes serán modificados
-    * @param string $limite: Límite de elementos modificados, por defecto los modifica a todos
-    *
-    * @throws \RuntimeException si el arreglo está vacío
-    * @return \PDOStatement
-  */
+   * Actualiza elementos de una tabla en la base de datos según una condición
+   *
+   * @param string $table: Tabla a actualizar
+   * @param array $e: Arreglo asociativo de elementos, con la estrctura 'campo_en_la_tabla' => 'valor_a_insertar_en_ese_campo',
+   *                  todos los elementos del arreglo $e, serán sanados por el método sin necesidad de hacerlo manualmente al crear el arreglo
+   * @param string $where: Condición que indica quienes serán modificados
+   * @param string $limite: Límite de elementos modificados, por defecto los modifica a todos
+   *
+   * @throws \RuntimeException si el arreglo está vacío
+   * @return \PDOStatement
+   */
   final public function update(string $table, array $e, string $where, string $limit = '') : \PDOStatement {
       if (sizeof($e) == 0) {
           throw new \RuntimeException('El arreglo pasado por $this->db->update(\''.$table.'\'...) está vacío.');
@@ -246,24 +246,24 @@ 
   }
 
   /**
-    * Selecciona y lista en un arreglo asociativo/numérico los resultados de una búsqueda en la base de datos
-    *
-    * @param string $e: Elementos a seleccionar separados por coma
-    * @param string $tbale: Tabla de la cual se quiere extraer los elementos $e
-    * @param string $where: Condición que indica quienes son los que se extraen, si no se coloca extrae todos
-    * @param string $limite: Límite de elemntos a traer, por defecto trae TODOS los que cumplan $where
-    *
-    * @return mixed false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno
-  */
+   * Selecciona y lista en un arreglo asociativo/numérico los resultados de una búsqueda en la base de datos
+   *
+   * @param string $e: Elementos a seleccionar separados por coma
+   * @param string $tbale: Tabla de la cual se quiere extraer los elementos $e
+   * @param string $where: Condición que indica quienes son los que se extraen, si no se coloca extrae todos
+   * @param string $limite: Límite de elemntos a traer, por defecto trae TODOS los que cumplan $where
+   *
+   * @return mixed false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno
+   */
   final public function select(string $e, string $table, string $where = '1 = 1', string $limit = "") {    
     return $this->query_select("SELECT $e FROM $table WHERE $where $limit;");
   }
 
-   /**
-    * Realiza una query, ideal para trabajar con SELECTS, JOINS, etc
-    *
-    * @return array|false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno
-  */
+    /**
+     * Realiza una query, ideal para trabajar con SELECTS, JOINS, etc
+     *
+     * @return array|false si no encuentra ningún resultado, array asociativo/numérico si consigue al menos uno
+     */
   final public function query_select(string $query) {
     $sql = $this->query($query);
     $result = $sql->fetchAll();
@@ -277,13 +277,13 @@ 
   }
 
   /**
-    * Alert para evitar clonaciones
-    *
-    * @throws \RuntimeException si se intenta clonar la conexión
-    * @return void
-  */
+   * Alert para evitar clonaciones
+   *
+   * @throws \RuntimeException si se intenta clonar la conexión
+   * @return void
+   */
   final public function __clone() {
     throw new \RuntimeException('Estás intentando clonar la Conexión');
   }
 
- }
\ No newline at end of file
+  }
\ No newline at end of file

Ocrend/Kernel/Helpers/Strings.php

Indentation +122 added lines, -122 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 {
     $to = $to == 0 ? time() : $to;
     $form = new \DateTime(date('Y-m-d H:i:s', $from));
@@ -65,39 +65,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));
@@ -105,90 +105,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);
@@ -197,12 +197,12 @@ 
   }
   //------------------------------------------------
   /**
-    * Convierte código BBCode en su equivalente HTML
-    *
-    * @param string $string: Código con formato BBCode dentro
-    *
-    * @return string del código BBCode transformado en HTML
-  */
+   * Convierte código BBCode en su equivalente HTML
+   *
+   * @param string $string: Código con formato BBCode dentro
+   *
+   * @return string del código BBCode transformado en HTML
+   */
   final public static function bbcode(string $string) : string {
     $BBcode = array(
         '/\[i\](.*?)\[\/i\]/is',
@@ -250,58 +250,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')),
@@ -325,10 +325,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 +154 added lines, -154 removed lines

@@ -19,29 +19,29 @@ 
 
 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
-    *
-    * @param string $url: Sitio a donde redireccionará, si no se pasa, por defecto
-    * se redirecciona a la URL principal del sitio
-    *
-    * @return void
-  */
+    /**
+     * Redirecciona a una URL
+     *
+     * @param string $url: Sitio a donde redireccionará, si no se pasa, por defecto
+     * se redirecciona a la URL principal del sitio
+     *
+     * @return void
+     */
   final public function redir($url = null) {
     global $config;
     
@@ -56,13 +56,13 @@ 
   //------------------------------------------------
 
   /**
-    * Calcula el porcentaje de una cantidad
-    *
-    * @param float $por: El porcentaje a evaluar, por ejemplo 1, 20, 30 % sin el "%", sólamente el número
-    * @param float $n: El número al cual se le quiere sacar el porcentaje
-    *
-    * @return float con el porcentaje correspondiente
-  */
+   * Calcula el porcentaje de una cantidad
+   *
+   * @param float $por: El porcentaje a evaluar, por ejemplo 1, 20, 30 % sin el "%", sólamente el número
+   * @param float $n: El número al cual se le quiere sacar el porcentaje
+   *
+   * @return float con el porcentaje correspondiente
+   */
   final public function percent(float $por, float $n) : float {
     return $n * ($por / 100);
   }
@@ -70,12 +70,12 @@ 
   //------------------------------------------------
 
   /**
-    * Da unidades de peso a un integer según sea su tamaño asumida en bytes
-    *
-    * @param int $size: Un entero que representa el tamaño a convertir
-    *
-    * @return string del tamaño $size convertido a la unidad más adecuada
-  */
+   * Da unidades de peso a un integer según sea su tamaño asumida en bytes
+   *
+   * @param int $size: Un entero que representa el tamaño a convertir
+   *
+   * @return string del tamaño $size convertido a la unidad más adecuada
+   */
   final public function convert(int $size) : string {
       $unit = array('bytes','kb','mb','gb','tb','pb');
       return round($size/pow(1024,($i=floor(log($size,1024)))),2).' '.$unit[$i];
@@ -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 (isset($var) && empty(trim(str_replace(' ','',$var))));
-   }
+     */
+    final public function emp($var) : bool {
+      return (isset($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(null === func_get_arg($i) || ($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;
@@ -299,11 +299,11 @@ 
    * @param int $desde: Desde donde
    *
    * @return mixed
-  */
+   */
   final public function desde_date(int $desde) {
-     # Obtener esta fecha
-     $hoy = date('d/m/Y/D',time());
-     $hoy = explode('/',$hoy);
+      # Obtener esta fecha
+      $hoy = date('d/m/Y/D',time());
+      $hoy = explode('/',$hoy);
 
 
     switch($desde) {
@@ -365,7 +365,7 @@ 
 
       default:
         throw new \RuntimeException('Problema con el valor $desde en desde_date()');
-       break;
+        break;
     }
   }
 
@@ -375,44 +375,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';
   }

Ocrend/Kernel/Helpers/Files.php

Indentation +91 added lines, -91 removed lines

@@ -22,12 +22,12 @@ 
   //------------------------------------------------
 
   /**
-    * Devuelve un string con el contenido de un archivo
-    *
-    * @param string $dir: Directorio del archivo a leer
-    *
-    * @return string con contenido del archivo
-  */
+   * Devuelve un string con el contenido de un archivo
+   *
+   * @param string $dir: Directorio del archivo a leer
+   *
+   * @return string con contenido del archivo
+   */
   final public static function read_file(string $dir) : string {
     $lines = '';
     $f = new \SplFileObject($dir);
@@ -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);
@@ -55,12 +55,12 @@ 
   //------------------------------------------------
 
   /**
-    * Borra un archivo en un directorio
-    *
-    * @param string $route: Ruta del fichero
-    *
-    * @return bool true si borró el fichero, false si no (porque no existía)
-  */
+   * Borra un archivo en un directorio
+   *
+   * @param string $route: Ruta del fichero
+   *
+   * @return bool true si borró el fichero, false si no (porque no existía)
+   */
   final public static function delete_file(string $route) : bool {
     if(file_exists($route)) {
       unlink($route);
@@ -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;
@@ -164,14 +164,14 @@ 
   //------------------------------------------------
 
   /**
-    * Elimina de forma recursiva un directorio con su contenido
-    *
-    * @author brandonwamboldt
-    *
-    * @param string $dir: Directorio a borrar
-    *
-    * @return bool true si todo se borró con éxito
-  */
+   * Elimina de forma recursiva un directorio con su contenido
+   *
+   * @author brandonwamboldt
+   *
+   * @param string $dir: Directorio a borrar
+   *
+   * @return bool true si todo se borró con éxito
+   */
   final public static function rm_dir(string $dir) {
 
     # Evitar una desgracia
@@ -203,12 +203,12 @@ 
   //------------------------------------------------
 
   /**
-    * Devuelve la cantidad de imágenes contenidas dentro de un directorio
-    *
-    * @param string $dir: Directorio en donde están las imagenes
-    *
-    * @return int cantidad de  imágenes
-  */
+   * Devuelve la cantidad de imágenes contenidas dentro de un directorio
+   *
+   * @param string $dir: Directorio en donde están las imagenes
+   *
+   * @return int cantidad de  imágenes
+   */
   final public static function images_in_dir(string $dir) : int {
     return sizeof(glob($dir . '{*.jpg,*.gif,*.png,*.gif,*.jpeg,*.JPG,*.GIF,*.PNG,*.JPEG}',GLOB_BRACE));
   }
@@ -216,16 +216,16 @@ 
   //------------------------------------------------
 
   /**
-    * Copia todos los ficheros de un directorio a un directorio nuevo, si el directorio nuevo no existe, es creado.
-    * Si en el directorio nuevo existe un archivo con el mismo nombre de alguno en el viejo, este será sobreescrito.
-    *
-    * @param string $old_dir: Ruta del directorio viejo (de donde se moverán los ficheros)
-    * @param string $new_dir: Ruta del directorio nuevo (hacia donde se moverán los ficheros)
-    * @param bool $only_images: Pasar como TRUE, si sólo quiere pasar imagenes
-    * @param bool $delete_old: Pasar como TRUE, si se quiere borrar todo el contenido del viejo directorio al pasarse
-    *
-    * @return void
-  */
+   * Copia todos los ficheros de un directorio a un directorio nuevo, si el directorio nuevo no existe, es creado.
+   * Si en el directorio nuevo existe un archivo con el mismo nombre de alguno en el viejo, este será sobreescrito.
+   *
+   * @param string $old_dir: Ruta del directorio viejo (de donde se moverán los ficheros)
+   * @param string $new_dir: Ruta del directorio nuevo (hacia donde se moverán los ficheros)
+   * @param bool $only_images: Pasar como TRUE, si sólo quiere pasar imagenes
+   * @param bool $delete_old: Pasar como TRUE, si se quiere borrar todo el contenido del viejo directorio al pasarse
+   *
+   * @return void
+   */
   final public static function move_from_dir(string $old_dir, string $new_dir, bool $only_images = false, bool $delete_old = false) {
 
     self::create_dir($new_dir);
@@ -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';
   }