Comprobar IP del servidor y enrutar descargas en Laravel

Autor:Lisa Farrell·2026-06-01

Laravel puede usar la misma interfaz IP de dos formas prácticas: el backend comprueba la IP de salida del servidor y la página de descarga llama la interfaz en el navegador para enrutar visitantes.

Objetivo de diseño

En «Comprobar IP del servidor y enrutar descargas en Laravel», la página debe seguir siendo útil antes de que termine la solicitud IP. El resultado geográfico es una mejora: se valida, se aplica a una decisión limitada y se descarta cuando faltan datos.

Flujo de solicitud y decisión

Comprobar IP del servidor y enrutar descargas en Laravel: El flujo siguiente pertenece a esta implementación concreta y no reutiliza una lista genérica de consulta IP.

  1. Paso 1 — Estado predeterminado: two explicit services
  2. Paso 2 — Solicitud: Http + Cache
  3. Paso 3 — Validación: allowlisted mirror map
  4. Paso 4 — Decisión: temporarySignedRoute
  5. Paso 5 — Reserva: mirror=global

Ejemplo orientado a producción

Comprobar IP del servidor y enrutar descargas en Laravel: El ejemplo incorpora tiempo de espera, validación de respuesta, un valor de reserva determinista y manejo específico del ciclo de vida del framework.

<?php
// config/downloads.php
return [
  'default' => 'global',
  'country_to_mirror' => ['JP'=>'asia', 'KR'=>'asia', 'DE'=>'eu', 'FR'=>'eu'],
  'mirrors' => [
    'global' => 'https://cdn.example.com/app.zip',
    'asia'   => 'https://asia.example.com/app.zip',
    'eu'     => 'https://eu.example.com/app.zip',
  ],
];

// app/Http/Controllers/DownloadResolverController.php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\URL;

final class DownloadResolverController extends Controller
{
    public function __invoke(Request $request)
    {
        $country = strtoupper((string) $request->query('country', 'ZZ'));
        $key = config("downloads.country_to_mirror.$country", config('downloads.default'));
        abort_unless(array_key_exists($key, config('downloads.mirrors')), 500);

        return response()->json([
            'mirror' => $key,
            'url' => URL::temporarySignedRoute(
                'download.file', now()->addMinutes(10), ['mirror' => $key]
            ),
        ]);
    }
}

// routes/web.php
Route::get('/download/resolve', DownloadResolverController::class);
Route::get('/download/{mirror}', function (string $mirror) {
    abort_unless(request()->hasValidSignature(), 403);
    $url = config("downloads.mirrors.$mirror");
    abort_unless($url, 404);
    return redirect()->away($url);
})->name('download.file');

Matriz de pruebas

Antes de publicar «Comprobar IP del servidor y enrutar descargas en Laravel», ejecute estos casos con respuestas simuladas o una salida VPN controlada.

CondiciónEntrada / configuraciónResultado esperado
T1country=JPmirror=asia; signed URL
T2country=ZZmirror=global
T3external URL inputserver map only
T4signature expiredHTTP 403

Prueba automatizada / smoke test

public function test_unknown_country_uses_global_mirror(): void
{
    $response = $this->getJson('/download/resolve?country=ZZ');
    $response->assertOk()->assertJsonPath('mirror', 'global');
    $this->assertStringContainsString('/download/global', $response->json('url'));
}

Gestión de fallos

Comprobar IP del servidor y enrutar descargas en Laravel: Los fallos deben verse en registros o herramientas de desarrollo, pero nunca dejar un bloque vacío ni romper el proceso de pago.

FalloCausaRespuesta
HTTP 429geo rate limitmirror=global
mirror maintenanceconfig keyremove key
signature mismatchedited / expired403 + resolve again
web ≠ worker IPproxy routeruntime-by-runtime check

Caso práctico

Un uso realista de «Comprobar IP del servidor y enrutar descargas en Laravel»: un proveedor de software elige el mirror público más cercano por comodidad y genera después la URL firmada final en el servidor Laravel.

Notas de producción

Comprobar IP del servidor y enrutar descargas en Laravel: Mantenga completo el HTML predeterminado. La ubicación IP no demuestra identidad y el resultado del navegador no debe controlar permisos.

Conclusión

«Comprobar IP del servidor y enrutar descargas en Laravel» ahora tiene una ruta de implementación, pruebas y comportamiento de reserva propios, en lugar de una plantilla compartida.