最近我正在開發一個新的管理后臺,其中大量使用了枚舉類來表示各種狀態,例如任務狀態、訂單狀態等等。一開始,我直接在頁面上顯示枚舉的數值,例如 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 在線學習地址:學習地址。