Laravel 6 如何根据本地化语言加载对应文件？含PDF协议场景优化咨询

Great question! Using App::isLocale() works, but there's a much cleaner, scalable way to handle localized document loading that avoids messy conditional checks. Let's break this down:

Instead of writing multiple App::isLocale() checks, leverage Laravel's built-in locale helpers and structured file organization to dynamically build paths. This approach is more scalable (add new locales just by adding a folder) and cleaner to maintain.

Step 1: Organize Your Files #

First, structure your documents by locale in a consistent directory (e.g., resources/documents/):

resources/
└── documents/
    ├── en/
    │   ├── agreement.pdf
    │   ├── terms_of_service.docx
    │   └── privacy_policy.txt
    ├── zh-CN/
    │   ├── agreement.pdf
    │   ├── terms_of_service.docx
    │   └── privacy_policy.txt
    └── es/
        ├── agreement.pdf
        ├── terms_of_service.docx
        └── privacy_policy.txt

Step 2: Create a Reusable Helper/Function #

Wrap the path logic in a helper function or service class to centralize the logic (and handle fallback to your default locale if a document doesn't exist for the current language).

Example Helper Function #

1. Create app/helpers.php (if you don't have one already) and add:

<?php

use Illuminate\Support\Facades\File;
use Illuminate\Support\Facades\App;

function get_localized_document_path(string $documentName, ?string $locale = null): string
{
    // Use current locale if none is provided
    $targetLocale = $locale ?? App::getLocale();
    $defaultLocale = config('app.fallback_locale');

    // Build the target path
    $targetPath = resource_path("documents/{$targetLocale}/{$documentName}");

    // Fallback to default locale if target document doesn't exist
    if (!File::exists($targetPath)) {
        $targetPath = resource_path("documents/{$defaultLocale}/{$documentName}");
    }

    // Throw an exception if even the default locale document is missing
    if (!File::exists($targetPath)) {
        throw new \RuntimeException("Document '{$documentName}' not found for locale '{$targetLocale}' (or default '{$defaultLocale}')");
    }

    return $targetPath;
}

2. Update your composer.json to autoload the helper:

"autoload": {
    "files": [
        "app/helpers.php"
    ],
    // ... rest of your autoload config
}

3. Run composer dump-autoload to apply the change.

Step 3: Load Documents in Laravel 6 #

Now you can use this helper to load PDFs, Word docs, and text files easily. Here are examples for each type:

Loading PDFs #

Use Laravel's response()->download() to let users download the PDF, or response()->file() to display it in the browser:

public function downloadAgreement()
{
    $filePath = get_localized_document_path('agreement.pdf');
    // Use a localized filename (pull from lang files)
    $downloadName = trans('documents.agreement_filename');

    return response()->download($filePath, $downloadName);
}

Loading Word Documents (.docx, .doc) #

Word files work the same way—use response()->file() to render it in the browser (if the user's browser supports it) or response()->download() to let them save it:

public function viewTermsOfService()
{
    $filePath = get_localized_document_path('terms_of_service.docx');
    return response()->file($filePath);
}

Loading Text Files #

Read the text content directly and return it as a plain text response:

public function getPrivacyPolicyText()
{
    $filePath = get_localized_document_path('privacy_policy.txt');
    $content = File::get($filePath);

    return response($content, 200)
        ->header('Content-Type', 'text/plain');
}

Why This Is Better Than App::isLocale() #

• Scalability: No need to add new if blocks when you add a new locale—just create a new folder and drop in the translated documents.
• Maintainability: All path logic lives in one place, so you only need to update it once if you change your directory structure.
• Fallback Handling: Automatically falls back to your default locale if a document is missing for the current language, preventing 404s or errors.

内容的提问来源于stack exchange，提问作者akmal saeed