Carga de archivos Laravel: un tutorial completo paso a paso

Publicado: 2024-10-07

Tabla de contenido

Palanca

Carga de archivos laravel

La carga de archivos es una característica esencial en muchas aplicaciones web, que permite a los usuarios cargar varios tipos de archivos, como imágenes, documentos o videos. Laravel, un popular marco PHP, ofrece una forma sencilla y segura de manejar la carga de archivos. En este tutorial, exploraremos cómo configurar e implementar la carga de archivos en Laravel desde cero. Ya seas un desarrollador principiante o intermedio, esta guía te ayudará a dominar la carga de archivos en Laravel.

1. Introducción a la carga de archivos Laravel

La carga de archivos es parte integral de las aplicaciones web modernas. Ya sea subir fotos de perfil, currículums o contenido multimedia, tener un sistema de carga de archivos confiable y seguro es crucial. Laravel, con sus funciones integradas, hace que este proceso sea sencillo y eficiente. Con soporte para validación, almacenamiento y seguridad de archivos, Laravel ofrece una manera perfecta de administrar la carga de archivos.

En este tutorial, vamos a:

  • Cree un formulario de carga de archivos.
  • Manejar la validación de archivos.
  • Almacenar archivos en el servidor.
  • Muestra los archivos cargados.
  • Asegure el proceso de carga de archivos.

Al final de esta guía, tendrá una comprensión sólida de cómo implementar y personalizar la carga de archivos en aplicaciones Laravel.

2. Requisitos previos

Antes de sumergirse en el tutorial, asegúrese de que lo siguiente esté instalado en su máquina:

  • PHP >= 8.0
  • Composer(Administrador de dependencias para PHP)
  • Laravel 9 o superior
  • MySQL o SQLitepara gestión de bases de datos.
  • Conocimientos básicos de Laravel y PHP.

Si no está familiarizado con cómo configurar Laravel, consulte la documentación oficial de Laravel o use el siguiente comando para crear un nuevo proyecto de Laravel:

intento

Copiar código

compositor crear-proyecto –prefer-dist laravel/laravel file-upload-tutorial

Una vez creado el proyecto, navegue hasta la carpeta del proyecto:

intento

Copiar código

tutorial-de-carga-de-archivos en CD

3. Configurando un proyecto Laravel

Una vez que su proyecto Laravel esté configurado, configuremos los ajustes básicos:

Configuración de la base de datos:abra el archivo .env en el directorio raíz y actualice las credenciales de su base de datos. Si está utilizando MySQL, actualice los siguientes campos:
 texto plano
 Copiar código
 DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=laravel_upload

DB_USERNAME=raíz

DB_PASSWORD=

Después de configurar el archivo .env , ejecute el siguiente comando para migrar las tablas predeterminadas:
 intento
 Copiar código
 php migración artesanal

A. Instalar Bootstrap (opcional)

Para diseñar el formulario de carga, puede incluir Bootstrap para facilitarlo. En la carpeta recursos/vistas/diseños , cree un archivo layout.blade.php e incluya Bootstrap:

HTML
 Copiar código
 <!DOCTYPE html>

<html lang=”es”>

<cabeza>

<meta juego de caracteres =”UTF-8″>

<meta nombre=”viewport” content=”ancho=ancho-dispositivo, escala-inicial=1.0″>

<title>Tutorial de carga de archivos</title>

<enlace href=”https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css” rel=”hoja de estilo”>

</cabeza>

<cuerpo>

<div class="contenedor mt-5">

@rendimiento('contenido')

</div>

</cuerpo>

</html>

4. Creando el formulario de carga de archivos

Ahora, creemos un formulario de carga de archivos.

Cree un controlador:genere un controlador para manejar la carga de archivos:
 intento
 Copiar código
 php artesano hacer: controlador FileUploadController

Defina el formulario:en la carpeta recursos/vistas , cree un archivo llamado upload.blade.php con el siguiente código:
 HTML
 Copiar código
 @extends('diseños.diseño')

@sección('contenido')

<div clase=”fila”>

<div class="col-md-6 desplazamiento-md-3">

<h3 class="text-center">Subir un archivo</h3>

<formulario acción=”{{ ruta('file.upload.post') }}” método=”POST” enctype=”multipart/form-data”>

@csrf

<div class="form-grupo mb-3">

<label for=”file”>Elija un archivo:</label>

<tipo de entrada=”archivo” clase=”control-formulario” nombre=”archivo” id=”archivo”>

@error('archivo')

<small class="text-danger">{{ $mensaje }}</small>

@enderror

</div>

<botón tipo=”enviar” clase=”btn btn-primary”>Subir</botón>

</formulario>

</div>

</div>

@endsection

Configurar rutas:en el archivo route/web.php , defina las rutas para mostrar el formulario y manejar la carga de archivos:
 PHP
 Copiar código
 utilice App\Http\Controllers\FileUploadController;

Ruta::get('cargar', [FileUploadController::clase, 'showForm'])->nombre('archivo.cargar');

Ruta::post('upload', [FileUploadController::class, 'uploadFile'])->name('file.upload.post');

5. Manejo de la lógica de carga de archivos

En FileUploadController.php , escriba la lógica para manejar el proceso de carga de archivos:

Mostrar el formulario:
PHP
 Copiar código
 función pública mostrarForm() {

vista de retorno ('cargar');

}

Manejar cargas de archivos:
En el mismo controlador, agregue el siguiente método para manejar la carga de archivos:
 PHP
 Copiar código
 función pública subirArchivo(Solicitud $solicitud) {

// Validar el archivo cargado

$solicitud->validar([

'archivo' => 'requerido|archivo|mimes:jpeg,png,pdf,docx|max:2048',

]);

// Almacena el archivo

si ($solicitud->archivo('archivo')) {

$nombreDeArchivo = hora() . '_'. $solicitud->archivo->getClientOriginalName();

$filePath = $solicitud->file('archivo')->storeAs('cargas', $fileName, 'público');

}

return back()->with('éxito', 'Archivo cargado correctamente.');

}

Este método realiza la validación del archivo, verifica si el archivo está presente y lo almacena utilizando el método storeAs .

6. Validación de cargas de archivos

La validación es fundamental para garantizar que los usuarios solo carguen tipos y tamaños de archivos permitidos. El método de validación de Laravel simplifica este proceso. Las reglas de validación utilizadas aquí son:

  • requerido : garantiza que el archivo esté cargado.
  • archivo : garantiza que el elemento cargado sea un archivo.
  • mimes : especifica los tipos de archivos permitidos (p. ej., jpeg, png, pdf, docx).
  • max : especifica el tamaño máximo de archivo en kilobytes (por ejemplo, 2048 KB = 2 MB).

Puede personalizar estas reglas para que se ajusten a los requisitos de su aplicación.

7. Almacenamiento de archivos

La fachada de almacenamiento de Laravel le permite almacenar archivos fácilmente. En el ejemplo anterior, utilizamos el método storeAs para almacenar el archivo en el directorio público/uploads . Para que la carpeta pública/cargas sea accesible, debe vincular el directorio de almacenamiento con la carpeta pública. Ejecute el siguiente comando:

intento

Copiar código

almacenamiento artesanal php: enlace

Este comando crea un enlace simbólico desde almacenamiento/aplicación/público a público/almacenamiento .

8. Mostrar archivos cargados

Para mostrar los archivos cargados, recupérelos de la carpeta de almacenamiento y genere una URL utilizando la fachada de almacenamiento . Así es como puede mostrar imágenes o archivos:

En el controlador:
PHP
 Copiar código
 función pública mostrarCargas() {

$archivos = Almacenamiento::disco('público')->archivos('cargas');

return view('cargas', compact('archivos'));

}

  1. En la vista:

Cree un archivo resources/views/uploads.blade.php :
 HTML
 Copiar código
 @extends('diseños.diseño')

@sección('contenido')

<h3>Archivos cargados:</h3>

<ul>

@foreach($archivos como $archivo)

<li><a href=”{{ activo('almacenamiento/' . $archivo) }}”>{{ nombre base($archivo) }}</a></li>

@endforeach

</ul>

@endsection

  1. Esto generará una lista de archivos cargados con enlaces de descarga.

9. Proteger la carga de archivos

La carga de archivos puede presentar riesgos de seguridad si no se maneja adecuadamente. Estas son algunas de las mejores prácticas para proteger la carga de archivos:

  • Limitar los tipos de archivos permitidos: valide siempre el tipo de archivo utilizando la regla mimes .
  • Limitar tamaño de archivo: restrinja el tamaño de los archivos para evitar el consumo excesivo de recursos del servidor.
  • Utilice nombres de archivos adecuados: almacene archivos usando nombres únicos para evitar sobrescribir los archivos existentes.
  • Escanear archivos: considere usar antivirus o herramientas de escaneo de archivos para detectar cargas maliciosas.
  • Restringir el acceso público: evite almacenar archivos confidenciales en directorios de acceso público. Puede utilizar el directorio de almacenamiento de Laravel para archivos privados y crear un controlador para servirlos de forma segura.

10. Conclusión

La carga de archivos es una característica vital para muchas aplicaciones web y Laravel simplifica el proceso con sus herramientas y funcionalidades integradas. En este tutorial, cubrimos los conceptos básicos de configurar la carga de archivos, validar y almacenar archivos, mostrarlos y proteger el proceso de carga. Con esta base, puede personalizar y ampliar la funcionalidad de carga de archivos para adaptarla a las necesidades de su proyecto.