Cómo potenciar el manejo de entradas de strings en Laravel con Stringable

#Entender $request->string()

El método string del objeto request le permite recuperar datos de entrada como una instancia de Illuminate\Support\Stringable. A continuación, le indicamos cómo utilizarlo:

$name = $request->string('name');

Esta única línea transforma su entrada en una instancia Stringable, lo que le brinda acceso a una amplia gama de métodos de manipulación de cadenas.

#Ejemplo práctico

Consideremos un escenario en el que estamos creando un formulario de registro de usuario. Queremos asegurarnos de que el nombre del usuario esté correctamente formateado antes de guardarlo en la base de datos. Así es como podemos manejar esto usando $request->string():

public function register(Request $request)
{
    $name = $request->string('name')
        ->trim()
        ->ucwords()
        ->limit(50);

    $email = $request->string('email')
        ->trim()
        ->lower();

    $user = User::create([
        'name' => $name->toString(),
        'email' => $email->toString(),
        'password' => Hash::make($request->input('password')),
    ]);

    return response()->json($user, 201);
}

En este ejemplo, usamos métodos Stringable para:

• Eliminar los espacios en blanco del nombre y el correo electrónico
• Convertir el nombre a mayúscula inicial con ucwords()
• Limitar el nombre a 50 caracteres
• Convertir el correo electrónico a minúsculas

Así es como se verían la entrada y la salida:

// Input
{
    "name": "  jOHN doe  ",
    "email": " JOHN@EXAMPLE.COM ",
    "password": "secret123"
}

// Output
{
    "id": 1,
    "name": "John Doe",
    "email": "john@example.com",
    "created_at": "2023-06-15T14:30:00.000000Z",
    "updated_at": "2023-06-15T14:30:00.000000Z"
}

Al aprovechar $request->string(), puede simplificar significativamente la lógica de manejo de la entrada, lo que hace que su código sea más legible y fácil de mantener. Ya sea que esté recortando, transformando o validando la entrada de cadena, las instancias Stringable brindan un conjunto de herramientas potente para manejar estas operaciones de manera eficiente.

A continuación, se incluye una referencia rápida de algunos métodos Stringable útiles que puede encadenar:

• trim(): elimina los espacios en blanco de ambos extremos
• ltrim() / rtrim(): elimina los espacios en blanco del lado izquierdo o derecho
• upper() / lower(): convierte a mayúsculas o minúsculas
• title(): convierte a mayúsculas y minúsculas
• slug(): genera un "slug" compatible con URL
• limit(): limita la cantidad de caracteres
• replaceFirst() / replaceLast(): reemplaza las ocurrencias de una subcadena
• before() / after(): obtiene la parte de la cadena antes o después de una subcadena dada

Recuerde llamar a toString() cuando necesite convertir la instancia Stringable nuevamente a una cadena primitiva, como al guardar en la base de datos o regresar en una respuesta.