PHP

Valida el tipo y tamaño de un archivo subido en Laravel

Portada del artículo «Valida el tipo y tamaño de un archivo subido en Laravel».

Crearás un formulario que acepta archivos PDF, JPG o PNG de hasta 1 MB y muestra un error si no cumplen esas condiciones. Te sirve para comprobar una subida antes de decidir si quieres guardarla o procesarla.

Requisitos

Necesitas un proyecto Laravel instalado que puedas ejecutar localmente, con sus dependencias y la clave de aplicación configuradas. También necesitas acceso a sus archivos y a una terminal.

1. Añade las rutas

Una ruta relaciona una dirección web con el código que responde a ella. Añade estas dos rutas al final de routes/web.php, sin borrar las rutas existentes ni añadir otra etiqueta <?php:

\Illuminate\Support\Facades\Route::get('/validar-archivo', function () {
    return view('validar-archivo');
})->name('archivo.formulario');

\Illuminate\Support\Facades\Route::post('/validar-archivo', function (\Illuminate\Http\Request $request) {
    $request->validate([
        'archivo' => ['required', 'file', 'mimes:pdf,jpg,png', 'max:1024'],
    ]);

    return redirect()
        ->route('archivo.formulario')
        ->with('resultado', 'El archivo cumple las condiciones.');
})->name('archivo.validar');

La primera ruta muestra el formulario. La segunda recibe la petición y valida el campo archivo:

  • required exige que se haya enviado un valor.
  • file exige que sea un archivo subido correctamente.
  • mimes:pdf,jpg,png comprueba el tipo a partir del contenido del archivo, no solo de su nombre.
  • max:1024 limita el tamaño a 1024 kilobytes, es decir, 1 MB.

Si la validación falla, Laravel devuelve al usuario al formulario con los errores. Si pasa, redirige al formulario con un mensaje de confirmación. Este ejemplo no guarda el archivo.

2. Crea el formulario

Crea resources/views/validar-archivo.blade.php con este contenido:

<!DOCTYPE html>
<html lang="es">
<head>
    <meta charset="utf-8">
    <title>Validar archivo</title>
</head>
<body>
    <h1>Validar archivo</h1>

    @if (session('resultado'))
        <p>{{ session('resultado') }}</p>
    @endif

    <form action="{{ route('archivo.validar') }}" method="POST" enctype="multipart/form-data">
        @csrf

        <label for="archivo">Archivo PDF, JPG o PNG de hasta 1 MB:</label>
        <input id="archivo" name="archivo" type="file">

        @error('archivo')
            <p>{{ $message }}</p>
        @enderror

        <button type="submit">Validar</button>
    </form>
</body>
</html>

El atributo enctype permite enviar el contenido del archivo en el formulario. La directiva @csrf añade el token que Laravel utiliza para proteger el envío, y @error muestra el mensaje de validación del campo.

3. Prueba el resultado

Desde la raíz del proyecto, inicia el servidor:

php artisan serve

Abre en el navegador la dirección que indique la terminal y añade /validar-archivo a la URL. Prueba estos casos:

  1. Envía un PDF, JPG o PNG de menos de 1 MB. Deberías ver «El archivo cumple las condiciones.».
  2. Envía un archivo de texto pequeño. Deberías ver un error de tipo.
  3. Envía un PDF, JPG o PNG de más de 1 MB. Deberías ver un error y no la confirmación.
  4. Envía el formulario sin seleccionar un archivo. Deberías ver un error de campo obligatorio.

Los mensajes de error pueden aparecer en inglés según la configuración del proyecto. Si una subida grande produce un error de transferencia en lugar del mensaje de tamaño esperado, revisa los límites upload_max_filesize y post_max_size de PHP: también restringen las subidas antes de que Laravel pueda validarlas. Tras cambiarlos, reinicia el servidor.

Esta validación comprueba tipo y tamaño; no analiza si el contenido es malicioso. Si más adelante guardas archivos, trata su almacenamiento y seguridad como un paso adicional.

Tutoriales relacionados