administrador.base.orm.columnas.tabla_renombrada_extra - gamboamartin/administrador GitHub Wiki

tabla_renombrada_extra

La función tabla_renombrada_extra es una función privada que renombra una tabla si se proporciona un nombre alternativo en los datos de entrada. Esta función es útil para situaciones en las que se necesita utilizar un alias o un nombre alternativo para una tabla en consultas SQL u otros contextos.

Signatura


private function tabla_renombrada_extra(array $data, string $tabla): string|array

Parámetros

  • array $data:
    Un array que contiene los datos relacionados con la tabla. Este array puede incluir una clave renombre que especifica un nombre alternativo para la tabla.

  • string $tabla:
    El nombre original de la tabla que puede ser renombrado si se proporciona un nombre alternativo en el array $data.

Retorna

  • string|array:
    Retorna una cadena que representa el nombre de la tabla, ya sea el original o el renombrado. En caso de error, retorna un array de error generado por $this->error->error().

Explicación Detallada

  1. Validación del nombre de la tabla:

    • La función primero limpia el nombre de la tabla mediante trim() para eliminar espacios en blanco al inicio y al final.
    • Se verifica si la cadena resultante está vacía. Si es así, se genera un error y se retorna un array con el mensaje de error.

  2. Asignación del nombre de la tabla renombrada:

    • La variable $tabla_renombrada se inicializa con el valor de $tabla.
    • Se verifica si el array $data contiene la clave renombre. Si existe:
      • Se limpia el valor de renombre con trim().
      • Si renombre no es una cadena vacía, se asigna este valor a $tabla_renombrada.

  3. Retorno del nombre de la tabla:

    • Si no hay errores, la función retorna el nombre de la tabla, que puede ser el original o el renombrado.

Ejemplos

$data = ['renombre' => 'usuarios_activos'];
$tabla = 'usuarios';

$resultado = $this->tabla_renombrada_extra($data, $tabla);

// Resultado esperado:
// 'usuarios_activos' si $data['renombre'] está definido y no es una cadena vacía.
// 'usuarios' si $data['renombre'] no está definido o es una cadena vacía.
// Un array de error si $tabla está vacío.

Código de la Función

private function tabla_renombrada_extra(array $data, string $tabla): string|array
    {
        $tabla = trim($tabla);
        if($tabla === ''){
            return $this->error->error(mensaje:"Error tabla esta vacia", data:$tabla, es_final: true);
        }
        $tabla_renombrada = $tabla;
        if(isset($data['renombre'])){
            $data['renombre'] = trim($data['renombre']);
            if($data['renombre'] !== ''){
                $tabla_renombrada = $data['renombre'];
            }
        }
        return $tabla_renombrada;

    }