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

valida_columnas_sql

La función valida_columnas_sql se encarga de validar que los parámetros necesarios para construir una consulta SQL estén correctamente definidos. Verifica que los nombres de la tabla, la columna parseada, y el alias de las columnas no estén vacíos. Si alguno de estos valores es inválido (es decir, está vacío), la función genera un error. De lo contrario, la función retorna true, indicando que las validaciones pasaron correctamente.

Signatura

private function valida_columnas_sql(string $alias_columnas, string $columna_parseada, string $tabla_nombre): true|array

Parámetros

• $alias_columnas (string): Alias que se utilizará para las columnas en la consulta SQL.
• $columna_parseada (string): El nombre de la columna que ha sido parseada o transformada.
• $tabla_nombre (string): El nombre de la tabla en la base de datos.

Retorna

• Tipo: true

• Descripción: Si todos los parámetros son válidos y no están vacíos.

• Tipo: array

• Descripción: Si alguno de los parámetros está vacío, se retorna un array con un mensaje de error, detallando cuál parámetro es el problemático.

Explicación Detallada

• Validación del Nombre de la Tabla:

• • La función comienza verificando si el parámetro $tabla_nombre está vacío.
• • Si $tabla_nombre está vacío, la función retorna un array con un mensaje de error indicando que el nombre de la tabla no puede estar vacío.

• Validación de la Columna Parseada:

• • Luego, la función verifica si el parámetro $columna_parseada está vacío.
• • Si $columna_parseada está vacío, la función retorna un array con un mensaje de error indicando que la columna parseada no puede estar vacía.

• Validación del Alias de las Columnas:

• • Finalmente, se verifica si el parámetro $alias_columnas está vacío.
• • Si $alias_columnas está vacío, la función retorna un array con un mensaje de error indicando que el alias de las columnas no puede estar vacío.

• Retorno en Caso de Éxito:

• • Si todos los parámetros son válidos (no están vacíos), la función retorna true.

Ejemplos

$alias_columnas = "c";
$columna_parseada = "nombre";
$tabla_nombre = "usuarios";

$resultado = $this->valida_columnas_sql($alias_columnas, $columna_parseada, $tabla_nombre);
echo $resultado;  // Resultado: true

$alias_columnas = "c";
$columna_parseada = "nombre";
$tabla_nombre = "";

$resultado = $this->valida_columnas_sql($alias_columnas, $columna_parseada, $tabla_nombre);
print_r($resultado);
// Resultado: Array con un error indicando que el nombre de la tabla no puede estar vacío.

$alias_columnas = "c";
$columna_parseada = "";
$tabla_nombre = "usuarios";

$resultado = $this->valida_columnas_sql($alias_columnas, $columna_parseada, $tabla_nombre);
print_r($resultado);
// Resultado: Array con un error indicando que la columna parseada no puede estar vacía.

$alias_columnas = "";
$columna_parseada = "nombre";
$tabla_nombre = "usuarios";

$resultado = $this->valida_columnas_sql($alias_columnas, $columna_parseada, $tabla_nombre);
print_r($resultado);
// Resultado: Array con un error indicando que el alias de las columnas no puede estar vacío.

Código de la Función

private function valida_columnas_sql(
        string $alias_columnas, string $columna_parseada, string $tabla_nombre): true|array
    {
        if($tabla_nombre === ''){
            return $this->error->error(mensaje: 'Error $tabla_nombre no puede venir vacia', data: $tabla_nombre,
                es_final: true);
        }
        if($columna_parseada === ''){
            return $this->error->error(mensaje:'Error $columna_parseada no puede venir vacia',data: $columna_parseada,
                es_final: true);
        }
        if($alias_columnas === ''){
            return $this->error->error(mensaje:'Error $alias_columnas no puede venir vacia',data: $alias_columnas,
                es_final: true);
        }
        return true;

    }