administrador.base.orm.inicializacion.limpia_valores - gamboamartin/administrador GitHub Wiki

limpia_valores

La función limpia_valores se encarga de limpiar (eliminar espacios en blanco al inicio y final) tanto el nombre de un campo como su valor. Además, valida que el nombre del campo no esté vacío. El retorno de la función es un objeto stdClass con los valores limpios o un array en caso de error.

Signatura

private function limpia_valores(string $campo, string $valor): stdClass|array

Parámetros

** $campo** (string): Nombre del campo a limpiar y validar.

• • Requisitos: Debe ser una cadena no vacía.
• • Comportamiento: Si está vacío, la función retorna un array con un mensaje de error.

** $valor** (string): Valor del campo que se desea limpiar.

• • Comportamiento: El valor será limpiado de espacios en blanco al inicio y al final de la cadena.

Retorna

• stdClass: Un objeto que contiene el nombre del campo y su valor, ambos limpiados.

• • Propiedades del Objeto:
• • • $campo: El nombre del campo limpio.
• • • $valor: El valor del campo limpio.

• array: Si el campo está vacío, la función retorna un array con un mensaje de error.

Explicación Detallada

• Limpieza de Espacios en Blanco:

• • La función utiliza trim() para eliminar los espacios en blanco al inicio y al final del nombre del campo ($campo) y del valor ($valor).

• Validación del Campo:

• • Se verifica si el nombre del campo ($campo) está vacío después de la limpieza. Si lo está, la función retorna un array con un mensaje de error.

• Retorno del Objeto:

• • Si el nombre del campo no está vacío, la función crea un objeto stdClass con dos propiedades: $campo y $valor, conteniendo los valores limpiados, y lo retorna.

• Posibles Errores

• • Campo vacío: Si el nombre del campo es una cadena vacía después de la limpieza, la función retorna un array con un mensaje de error.

Ejemplos

// Ejemplo 1: Limpiar y validar un campo con su valor
$campo = '  nombre ';
$valor = '  Juan Pérez  ';

$resultado = $this->limpia_valores($campo, $valor);
if (is_object($resultado)) {
    echo "Campo limpio: " . $resultado->campo; // Salida: "nombre"
    echo "Valor limpio: " . $resultado->valor; // Salida: "Juan Pérez"
} else {
    echo "Error: " . $resultado['error'];
}

// Ejemplo 2: Manejo de error cuando el campo está vacío
$campo = '   ';
$valor = 'Juan Pérez';

$resultado = $this->limpia_valores($campo, $valor);
if (is_array($resultado) && isset($resultado['error'])) {
    echo "Error: " . $resultado['error']; // Salida: "Error campo no puede venir vacío"
}

Código de la Función

private function limpia_valores(string $campo, string $valor): stdClass|array
    {
        $campo = trim($campo);
        $valor = trim($valor);

        if($campo === ''){
            return $this->error->error(mensaje: 'Error campo no puede venir vacio', data: $campo, es_final: true);
        }

        $data = new stdClass();
        $data->campo = $campo;
        $data->valor = $valor;
        return $data;

    }