PrestaShop 1.7 多语言发票生成：基于订单语言动态切换发票界面语言-php教程-PHP中文网

PrestaShop 1.7 多语言发票生成：基于订单语言动态切换发票界面语言

在 PrestaShop 1.7 中，即使后台使用英文，也可通过重写 HTMLTemplateInvoice 和 Context 类，使每张发票按对应客户订单的语言（如立陶宛语、拉脱维亚语、爱沙尼亚语）正确渲染，关键在于同步更新上下文语言与翻译器。

在 prestashop 1.7 中，即使后台使用英文，也可通过重写 `htmltemplateinvoice` 和 `context` 类，使每张发票按对应客户订单的语言（如立陶宛语、拉脱维亚语、爱沙尼亚语）正确渲染，关键在于同步更新上下文语言与翻译器。

在 PrestaShop 1.7 的多语言场景中，仅修改 Context::getContext()->language 并不足以触发模板中翻译内容的本地化——因为 Symfony 的 Translator 组件独立维护其语言环境（locale），而 PrestaShop 默认未在 PDF 模板上下文中主动刷新翻译器实例。因此，即使 Context->language->id 已设为 2（立陶宛语），若 translator 仍绑定于后台当前 locale（如 en-US），所有 {l s='...'} 标签仍将输出英文。

✅ 正确解决方案：双管齐下更新语言与翻译器

你需要同时完成两件事：

设置正确的 Language 实例（含 locale 属性）；
显式调用 setTranslatorFromLocale()，确保 Translator 加载对应语言的翻译目录（catalogue）。

以下是你应在主题或模块中覆盖的核心代码：

Flow Studio

Flow Studio是一款AI文本写作工具，FlowGPT推出的AI长视频生成工具。

下载

✅ 1. 重写 `HTMLTemplateInvoice.php`（位于 `/override/classes/pdf/`）

<?php class HTMLTemplateInvoice extends HTMLTemplateInvoiceCore
{
    public $order;
    public $order_invoice;
    public $available_in_your_account = false;

    public function __construct(OrderInvoice $order_invoice, $smarty, $bulk_mode = false)
    {
        $this->order_invoice = $order_invoice;
        $this->order = new Order((int) $order_invoice->id_order);
        $this->smarty = $smarty;

        // 兼容旧订单地址为空的情况（官方逻辑保留）
        if (!isset($this->order_invoice->shop_address) || !$this->order_invoice->shop_address) {
            $this->order_invoice->shop_address = OrderInvoice::getCurrentFormattedShopAddress((int) $this->order->id_shop);
            if (!$bulk_mode) {
                OrderInvoice::fixAllShopAddresses();
            }
        }

        $this->date = Tools::displayDate($order_invoice->date_add);

        // ? 关键：仅当非前台（即后台生成PDF时）才切换上下文语言
        // 避免干扰后台其他操作，且需确保员工登录态存在
        if (Context::getContext()->employee && $this->order->id_lang) {
            $lang = new Language((int) $this->order->id_lang);
            Context::getContext()->language = $lang;
            Context::getContext()->shop = new Shop((int) $this->order->id_shop);

            // ? 强制刷新翻译器，传入 language->locale（如 'lt-LT'）
            Context::getContext()->setTranslatorFromLocale($lang->locale);
        }

        $id_lang = Context::getContext()->language->id;
        $this->title = $order_invoice->getInvoiceNumberFormatted($id_lang);
        $this->shop = new Shop((int) $this->order->id_shop);
    }
}

✅ 2. 重写 `Context.php`（位于 `/override/classes/`）

<?php class Context extends ContextCore
{
    /**
     * 手动设置 Translator 实例，基于指定 locale 加载翻译目录
     * @param string $locale 如 'lt-LT', 'lv-LV', 'et-EE'
     */
    public function setTranslatorFromLocale($locale)
    {
        $translator = $this->getTranslatorFromLocale($locale);
        // 安全检查：确保该 locale 至少有一个翻译条目，避免 fallback 到默认语言
        if (count($translator->getCatalogue($locale)->all()) > 0) {
            $this->translator = $translator;
        } else {
            // 可选：记录警告日志（生产环境建议启用）
            PrestaShopLogger::addLog("Warning: No translations found for locale '{$locale}'", 3);
        }
    }
}

⚠️ 注意事项：

覆盖文件必须放在 /override/classes/ 和 /override/classes/pdf/ 目录下，并清除缓存（删除 /var/cache/prod/ 和 /cache/class_index.php）；

确保目标语言（如立陶宛语）已在后台「国际 → 语言」中启用，且对应 .xlf 翻译文件已部署（位于 /translations/lt-LT/）；

若使用自定义 PDF 模板（如 invoice.tpl），请确认其中所有文本均使用 {l s='...'} 语法，而非硬编码字符串；

bulk_mode 场景（批量导出发票）下，上述逻辑仍生效，但需注意性能——getTranslatorFromLocale() 是轻量级操作，无需担忧。