En este post voy a mostrarte cómo enviar o subir fotos con un formulario, y procesarlas para almacenarlas con Laravel.

También te voy a enseñar cómo validar las fotos, para permitir determinadas extensiones o peso.

Será un formulario que aceptará la subida de múltiples imágenes, las validará y almacenará.

Aunque es para imágenes, este ejemplo también serviría para subir otro tipo de archivos.

El formulario

El formulario de la subida de imágenes queda como se ve a continuación. Es importante definir el enctype en multipart/form-data y poner la directiva @csrf para el token CSRF (más información aquí)

Abajo del formulario estamos incluyendo un componente de errores, que simplemente muestra la lista de errores de validación.

<form enctype="multipart/form-data" method="post" action="{{route("agregarFotosDeArticulo")}}">
    @csrf
    <input accept="image/jpeg,image/png" multiple
           type="file" name="fotos[]">
    <button type="submit">Subir</button>
</form>
@include("errores")

Para que se puedan subir varias imágenes, se coloca el atributo multiple en el input. En el accept se muestran las extensiones que permitirá (aunque esta es una validación del lado del cliente, no confíes)

El name es muy importante, sobre todo con los corchetes del final. Puedes nombrarlo como quieras, pero agrega los [] al final.

Finalmente, el action del formulario es en la ruta agregarFotosDeArticulo que simplemente redirige al controlador:

Route::post("articulos/fotos","ArticulosController@agregarFotos")->name("agregarFotosDeArticulo");

Lista de errores

El componente que muestra los errores es el siguiente. Tiene algunas clases y estilos, pero eso no debe importar:

@if(!empty($errors->all()))
    <div class="notification is-danger">
        <h4 class="is-size-4">Por favor, valida los siguientes errores:</h4>
        <ul>
            @foreach ($errors->all() as $mensaje)
                <li>
                    {{$mensaje}}
                </li>
            @endforeach
        </ul>
    </div>
@endif

Si la validación falla, los errores van a ser mostrados aquí.

El FormRequest

Vamos a validar la petición, y para hacerla bien, vamos a crear un Request personalizado, que simplemente va a validar las imágenes.

Por favor mira más sobre las validaciones en este post, ya que aquí lo voy a resumir.

Vamos a crear el archivo app/Http/Requests/SubirFotosDeArticulosRequest.php con el siguiente contenido:

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class SubirFotosDeArticulosRequest extends FormRequest
{
    /**
     * Determine if the user is authorized to make this request.
     *
     * @return bool
     */
    public function authorize()
    {
        return true;
    }

    /**
     * Get the validation rules that apply to the request.
     *
     * @return array
     */
    public function rules()
    {
        return [
            "fotos" => "required|array",
            "fotos.*" => "required|image|mimes:jpeg,png|max:3000",
        ];
    }
}

Fíjate en el método rules, estamos regresando un arreglo que dice, en lenguaje humano:

• El campo fotos (aunque en el formulario se llama fotos[]) es requerido y debe ser un arreglo.
• Cualquier elemento de fotos:
  • Es requerido
  • Debe ser una imagen
  • Su mime type debe ser jpeg o png
  • Puede pesar hasta 3000 kilobytes

Si esta validación falla, se le mostrará al usuario en el formulario en el componente de errores, además de que el método del controlador no será llamado.

El controlador

Si la validación es correcta, se llamará al controlador en donde vamos a procesar los archivos subidos.

El método que se invoca es agregarFotos, y recibe como argumento el FormRequest que creamos anteriormente.

Para acceder a las fotos accedemos a $peticion->file("fotos") en un foreach.

<?php

namespace App\Http\Controllers;
use App\Http\Requests\SubirFotosDeArticulosRequest;

class ArticulosController extends Controller
{

    private $nombreCarpetaFotos = "fotos";

    public function agregarFotos(SubirFotosDeArticulosRequest $peticion)
    {
        foreach ($peticion->file("fotos") as $foto) {
            $fotoDeArticulo = new FotoDeArticulo;
            $rutaLarga = $foto->store($this->nombreCarpetaFotos);
        }
        return back()
            ->with("mensaje", "Foto(s) agregada(s) con éxito")
            ->with("tipo", "success");
    }
}

Para guardar la foto en el disco duro, invocamos al método llamado store indicando el nombre de la carpeta en donde se va a almacenar.

Ese método va a devolver la ruta de la imagen recién guardada.

Opcionalmente se podrían guardar los datos de la imagen en la base de datos a través de un modelo, esto es totalmente opcional, pero si quieres llevar un registro de las fotos que se suben, deberías hacerlo.

Al final hacemos un return back() para mostrar un mensaje de retroalimentación en el formulario, y ya quedó.

Demostración de subida de imágenes con Laravel

Vamos a mostrar lo aprendido aquí. Cuando los datos se envían y son correctos, se muestra un mensaje de éxito y los archivos son almacenados:

En cambio, cuando la validación falla, ya sea porque una imagen es pesada o porque algo no es una imagen, se muestran los errores:

De esta manera podemos validar no solo fotos, sino cualquier otro tipo de archivos.

Recuerda que todas las validaciones están en la documentación oficial.

Nota sobre los campos opcionales

Si quieres que las fotos o archivos sean opcionales, pero quieres validarlos en caso de que estén presentes, haz algo como lo siguiente:

<?php
public function rules()
{
    return [
        "titulo" => "required",
        "contenido" => "required",
        "fotos" => "sometimes|required|array",
        "fotos.*" => [
            new RequiredIf($this->input("fotos")),
            "image",
            "mimes:jpeg,png",
            "max:3000",
        ]

    ];
}

Nota: mi campo en el formulario se llama fotos[].

Validación de formularios en Laravel

En este post voy a mostrarte cómo hacer el envío de un formulario con Laravel, así como la validación del mismo del lado del servidor. Laravel provee una forma fácil de validar, además de mostrar los errores en una lista que puede estar bajo el formulario. Nota: si quieres usar…

junio 20, 2019

En "laravel"

Laravel: validar confirmación de contraseña

En el corto post de hoy veremos cómo validar que las contraseñas que el usuario escribe sean iguales al momento de registrar un usuario, es decir, que la contraseña y la confirmación de la contraseña coincidan. Así vas a poder mostrar el mensaje de "Las contraseñas deben coincidir" o "Vuelve…

agosto 14, 2022

En "laravel"

Solución a Error 419 en Laravel – Page Expired

Resumen: mostrar cómo solucionar el error 419 Page Expired en Laravel, mismo que se ocasiona al enviar un formulario o al hacer una petición AJAX. Explicación del error Este error de programación en Laravel nos puede ocurrir al empezar a usar este framework. Se trata de que enviamos un formulario…

julio 4, 2020

En "laravel"