優雅地處理枚舉翻譯:Hostnet Entity Translation Bundle 的實踐

最近我正在開發一個新的管理后臺,其中大量使用了枚舉類來表示各種狀態,例如任務狀態、訂單狀態等等。一開始,我直接在頁面上顯示枚舉的數值,例如 1 代表“進行中”,2 代表“已完成”。這種做法顯然不夠友好,用戶難以理解這些數字的含義。更糟糕的是,當我們需要支持多語言時,這種方式會變得更加復雜和難以維護。

為了解決這個問題,我嘗試了多種方法,例如自己編寫翻譯函數,或者使用數據庫映射。但這些方法都比較繁瑣,而且難以擴展。最后,我找到了 Hostnet Entity Translation Bundle,它完美地解決了我的問題。

Hostnet Entity Translation Bundle 是一個 symfony Bundle,它可以自動將枚舉值翻譯成人類可讀的字符串。它的使用非常簡單,首先,你需要通過 composer 安裝它:

composer require hostnet/entity-translation-bundle

安裝完成后,你需要在你的 AppKernel 中注冊這個 Bundle,確保它在 FrameworkBundle 之后注冊:

class AppKernel extends Kernel{    public function registerBundles()    {        $bundles = [            // ...            new SymfonyBundleFrameworkBundleFrameworkBundle(),            new HostnetBundleEntityTranslationBundleHostnetEntityTranslationBundle(),            // ...        ];        return $bundles;    }}

接下來,你需要在你的資源文件夾下創建 translations 文件夾,并在其中添加一個 enum.en.yml 文件(或者其他語言文件)。在這個文件中,你可以定義枚舉值的翻譯。例如,假設我們有一個 OrderStatus 枚舉類:

<?phpnamespace AppEntity;final class OrderStatus{    const PENDING = 1;    const PROCESSING = 2;    const COMPLETED = 3;}

那么,你的 enum.en.yml 文件可以這樣寫:

app:    entity:        order_status:            pending: "Pending"            processing: "Processing"            completed: "Completed"

這樣,你就可以在你的 Twig 模板中使用 trans 過濾器來翻譯枚舉值了:

{{ constant('AppEntityOrderStatus::PROCESSING') | trans([], 'AppEntityOrderStatus') }}

這段代碼將會輸出 “Processing”。 當然,你也可以在控制器中直接使用 Symfony 的翻譯器:

use SymfonyContractsTranslationTranslatorInterface;// ...public function myAction(TranslatorInterface $translator){    $status = $translator->trans(OrderStatus::COMPLETED, [], OrderStatus::class);    // ...}

通過 Hostnet Entity Translation Bundle,我成功地將枚舉值翻譯成易于理解的文本,極大地提升了用戶體驗。而且,由于它支持多語言,我只需要添加新的語言文件即可支持新的語言,而無需修改大量的代碼。這使得我的代碼更加簡潔、易于維護和擴展。 這整個過程,讓我深刻體會到 Composer 的便捷性,它能快速、高效地引入外部庫,并輕松管理項目依賴。 如果你也遇到類似的問題,強烈推薦你嘗試一下 Hostnet Entity Translation Bundle,相信它能給你帶來驚喜。 順便一提,想更深入學習 Composer 的使用方法,可以參考這個 Composer 在線學習地址:學習地址

? 版權聲明
THE END
喜歡就支持一下吧
點贊14 分享