administrador.base.orm.sql.describe_table - gamboamartin/administrador GitHub Wiki

describe_table

La función describe_table valida el nombre de una tabla de base de datos y retorna una cadena SQL para describir la estructura de la tabla. Si la validación falla, retorna un array con información de error.

Signatura

final public function describe_table(string $tabla): string|array

Parámetros

$tabla (string): Nombre de la tabla de base de datos que se desea describir.

Retorna

  • string: Devuelve una cadena SQL DESCRIBE $tabla si la validación es exitosa.

  • array: Devuelve un array de error si la validación falla.

Explicación Detallada

  • Validación del nombre de la tabla:

    • La función utiliza una instancia de la clase val_sql para validar el nombre de la tabla.
    • Si la validación falla, se retorna un array con el mensaje de error y los datos de la validación fallida.
  • Generación de la cadena SQL:

    • Si la validación es exitosa, se retorna una cadena SQL para describir la estructura de la tabla.

Ejemplos

$tabla = 'usuarios';
$resultado = $this->describe_table($tabla);

if (is_array($resultado)) {
    // Manejar error
    print_r($resultado);
} else {
    // Usar la cadena SQL para describir la tabla
    echo $resultado;
}

Código de la Función

final public function describe_table(string $tabla): string|array
    {
        $valida = (new val_sql())->tabla(tabla: $tabla);
        if(errores::$error){
            return $this->error->error(mensaje: 'Error al validar tabla', data: $valida);
        }

        return "DESCRIBE $tabla";
    }