Managing Request Host Information in Laravel

Laravel offers robust tools for managing request host information, allowing for fine-grained control over URL handling and environment-specific configurations. The host(), httpHost(), and schemeAndHttpHost() methods provide distinct functionalities for URL manipulation and domain-specific logic. This is especially valuable in multi-tenant applications, cross-domain requests, and dynamic URL generation scenarios.

The following code snippets illustrate their usage:

// Accessing host information
$domain = $request->host();       // Returns the domain name
$hostWithPort = $request->httpHost();// Includes the port if not standard (e.g., :8080)
$fullHost = $request->schemeAndHttpHost();// Returns the full scheme and host (e.g., https://example.com)

Consider this example of a multi-environment URL generator service:

// app/Services/DomainRouter.php
<?php

namespace App\Services;

use Illuminate\Http\Request;

class DomainRouter
{
    public function __construct(private Request $request) {}

    public function generateUrls(): array
    {
        $baseDomain = $this->request->host();
        $fullSchemeHost = $this->request->schemeAndHttpHost();

        return match ($this->detectEnvironment($baseDomain)) {
            'production' => [
                'api' => "{$fullSchemeHost}/api/v1",
                'web' => $this->request->httpHost(),
                'assets' => str_replace('api', 'cdn', $fullSchemeHost),
                'environment' => 'production'
            ],
            'staging' => [
                'api' => "{$fullSchemeHost}/api/v1",
                'web' => str_replace('api', 'staging', $this->request->httpHost()),
                'assets' => str_replace('api', 'staging-cdn', $fullSchemeHost),
                'environment' => 'staging'
            ],
            default => [
                'api' => 'http://localhost:8000/api/v1',
                'web' => 'http://localhost:3000',
                'assets' => 'http://localhost:9000',
                'environment' => 'local'
            ]
        };
    }

    private function detectEnvironment(string $host): string
    {
        if (str_contains($host, 'prod')) {
            return 'production';
        }
        if (str_contains($host, 'staging')) {
            return 'staging';
        }
        return 'local';
    }
}

Usage example:

// Production (api.example.com)
{
  "api": "https://api.example.com/api/v1",
  "web": "api.example.com",
  "assets": "https://cdn.example.com",
  "environment": "production"
}

// Staging (api.staging.example.com)
{
  "api": "https://api.staging.example.com/api/v1",
  "web": "staging.example.com",
  "assets": "https://staging-cdn.example.com",
  "environment": "staging"
}

Laravel's host-related methods offer a flexible and efficient approach to managing domain-specific logic and URL generation across various deployment environments.

The above is the detailed content of Managing Request Host Information in Laravel. For more information, please follow other related articles on the PHP Chinese website!