优雅地处理枚举翻译: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 分享