在 Yii 2 高级项目模板中，实现 RESTFUL WEB 服务时，消息目录(messages)中配置的最佳实践

作者：

在

Web应用开发, Yii 2, PHP 7.1, PHP, Yii, 编程语言, Web框架

Post Views: 103

1、之前的实现如下，公共目录中的配置文件，\common\config\main.php，国际化配置如下：



    'components' => [
        'i18n' => [
            'translations' => [
                'common/*' => [
                    'class' => 'yii\i18n\PhpMessageSource',
                    'forceTranslation' => true,
                    'basePath' => '@common/messages',
                    'fileMap' => [
                        'common/app' => 'app.php',
                        'common/error' => 'error.php',
                        'common/success' => 'success.php',
                    ],
                ],
                'model/*' => [
                    'class' => 'yii\i18n\PhpMessageSource',
                    'forceTranslation' => true,
                    'basePath' => '@common/messages',
                ],
                '*' => [
                    'class' => 'yii\i18n\PhpMessageSource',
                    'forceTranslation' => true,
                    'basePath' => '@app/messages',
                    'fileMap' => [
                        'app' => 'app.php',
                        'error' => 'error.php',
                        'success' => 'success.php',
                    ],
                ],
            ],
        ],
    ],

2、公共目录中的消息目录(messages)中的文件如下： \common\messages\zh-CN\error.php

<pre class="wp-block-syntaxhighlighter-code">

<?php
return [
    20000 => 'error',
    201001 => '框架服务控制台HTTP请求失败，状态码：{status_code}',
    201002 => '框架服务控制台HTTP请求失败：{first_error}',
    201003 => '框架服务控制台HTTP请求失败：{message}',
    201004 => '框架服务接口HTTP请求失败，状态码：{status_code}',
    201005 => '框架服务接口HTTP请求失败：{first_error}',
];


</pre>

\common\messages\zh-CN\error.php

<pre class="wp-block-syntaxhighlighter-code">

<?php
return [
    10000 => 'success',
];


</pre>

3、接口应用中的消息目录(messages)中的文件如下： \api\messages\zh-CN\error.php

<pre class="wp-block-syntaxhighlighter-code">

<?php
return [
    20000 => 'error',
    224001 => '日志列表为空',
    224002 => '日志ID：{id}，不存在',
    224003 => '数据过滤器验证失败：{first_error}',
    224004 => '用户ID：{id}，的状态为已禁用',
    224005 => '页面列表为空',
    224006 => '页面ID：{id}，不存在',
    224007 => '页面ID：{id}，的状态为已删除',
    224008 => '页面ID：{id}，的状态为已禁用',
    224009 => '页面ID：{id}，的状态为草稿',
    226001 => '用户列表为空',
    226002 => '用户ID：{id}，不存在',
    226003 => '用户ID：{id}，的状态为已删除',
    226004 => '数据验证失败：{first_error}',
];


</pre>

\api\messages\zh-CN\success.php

<pre class="wp-block-syntaxhighlighter-code">

<?php
return [
    10000 => 'success',
    124001 => '获取日志列表成功',
    124002 => '获取日志详情成功',
    124003 => '获取页面列表成功',
    124004 => '获取页面详情成功',
    124005 => '创建页面成功',
    124006 => '更新页面成功',
    124007 => '删除页面成功',
    126001 => '获取用户列表成功',
    126002 => '获取用户详情成功',
    126003 => '创建用户成功',
    126004 => '更新用户成功',
    126005 => '删除用户成功',
];


</pre>

4、公共目录中的 Yii::t() 方法实现如下：



	throw new ServerErrorHttpException(Yii::t('common/error', Yii::t('common/error', Yii::t('common/error', '201001'), ['status_code' => $response->getStatusCode()])), 201001);

5、接口应用中的 Yii::t() 方法实现如下：



	return ['code' => 226004, 'message' => Yii::t('error', Yii::t('error', Yii::t('error', '226004'), ['first_error' => $firstError]))];

6、之前的实现存在的问题如下： (1)公共目录中的 Yii::t() 方法实现 Yii::t(‘common/error’ 有所冗余，期待 Yii::t(‘error’ 的实现 (2)接口应用中如果要包含公共目录中的要翻译的消息，Yii::t() 方法必须实现 Yii::t(‘common/error’，要包含接口应用中的要翻译的消息，Yii::t() 方法必须实现 Yii::t(‘error’，需要明确得知要翻译的消息的位置，存在很大的出错可能性，且实现不够纯粹，有所混杂 7、基于存在的问题，解决方案调整如下，公共目录中的配置文件，i18n 应用组件配置的调整(消息类别：删除 common/*)，\common\config\main.php，国际化配置如下：



    'components' => [
        'i18n' => [
            'translations' => [
                'model/*' => [
                    'class' => 'yii\i18n\PhpMessageSource',
                    'forceTranslation' => true,
                    'basePath' => '@common/messages',
                ],
                '*' => [
                    'class' => 'yii\i18n\PhpMessageSource',
                    'forceTranslation' => true,
                    'basePath' => '@app/messages',
                    'fileMap' => [
                        'app' => 'app.php',
                        'error' => 'error.php',
                        'success' => 'success.php',
                    ],
                ],
            ],
        ],
    ],

8、公共目录中的消息目录(messages)中的文件不做调整，保持原样 9、接口应用中的消息目录(messages)中的文件如下： \api\messages\zh-CN\error.php

<pre class="wp-block-syntaxhighlighter-code">

<?php
$commonMessages = require __DIR__ . '/../../../common/messages/zh-CN/error.php';
$messages = [
    224001 => '日志列表为空',
    224002 => '日志ID：{id}，不存在',
    224003 => '数据过滤器验证失败：{first_error}',
    224004 => '用户ID：{id}，的状态为已禁用',
    224005 => '页面列表为空',
    224006 => '页面ID：{id}，不存在',
    224007 => '页面ID：{id}，的状态为已删除',
    224008 => '页面ID：{id}，的状态为已禁用',
    224009 => '页面ID：{id}，的状态为草稿',
    226001 => '用户列表为空',
    226002 => '用户ID：{id}，不存在',
    226003 => '用户ID：{id}，的状态为已删除',
    226004 => '数据验证失败：{first_error}',
];
return $commonMessages + $messages;


</pre>

\api\messages\zh-CN\success.php

<pre class="wp-block-syntaxhighlighter-code">

<?php
$commonMessages = require __DIR__ . '/../../../common/messages/zh-CN/success.php';
$messages = [
    124001 => '获取日志列表成功',
    124002 => '获取日志详情成功',
    124003 => '获取页面列表成功',
    124004 => '获取页面详情成功',
    124005 => '创建页面成功',
    124006 => '更新页面成功',
    124007 => '删除页面成功',
    126001 => '获取用户列表成功',
    126002 => '获取用户详情成功',
    126003 => '创建用户成功',
    126004 => '更新用户成功',
    126005 => '删除用户成功',
];
return $commonMessages + $messages;


</pre>

10、公共目录中的 Yii::t() 方法实现如下：



	throw new ServerErrorHttpException(Yii::t('error', Yii::t('error', Yii::t('error', '201001'), ['status_code' => $response->getStatusCode()])), 201001);

11、接口应用中的 Yii::t() 方法实现如下：



	return ['code' => 226004, 'message' => Yii::t('error', Yii::t('error', Yii::t('error', '226004'), ['first_error' => $firstError]))];

12、之前的实现存在的问题，已经得到解决，如下： (1)公共目录中的 Yii::t() 方法实现 Yii::t(‘error’，仅需要保证对应的 code 存在于公共目录中的消息目录(messages)中 (2)接口应用中如果要包含公共目录中的要翻译的消息，Yii::t() 方法必须实现 Yii::t(‘error’，要包含接口应用中的要翻译的消息，Yii::t() 方法必须实现 Yii::t(‘error’，无需明确得知要翻译的消息的位置，公共目录与接口应用中的消息目录(messages)皆可使用 (3)存在的一个小问题，如果公共目录中与接口应用中皆存在一个同样的 code，此时接口应用中的值不会覆盖公共目录中的值，原因在于接口应用中消息文件未使用 array_merge 方法，因为数组索引为数字，如果使用 array_merge 方法，数字键名将会被重新编号，索引会从 0 开始，因此，保留原有数组并只想新的数组附加到后面，用 + 运算符，附加的话，在两个数组中存在相同的键名时，第一个数组中的同键名的元素将会被保留，第二个数组中的元素将会被忽略

PHP / Laravel / Yii2 老项目维护与长期技术支持

如果你的 PHP / Laravel / Yii2 项目已经上线，但遇到原开发离职、Bug 长期无人修复、接口不稳定、性能下降、代码难以接手等问题，可以联系我做一次远程技术排查。

适合以下情况：
✅ 老旧 PHP 系统无人维护
✅ Laravel / Yii2 项目 Bug 修复
✅ 后台管理系统小功能迭代
✅ RESTful API 接口排查
✅ MySQL / Redis / Nginx 性能问题
✅ 长期远程兼职维护

可先从一次小问题开始：
✅ 线上报错排查
✅ 接口异常分析
✅ 慢查询与性能瓶颈定位
✅ 代码结构初步评估
✅ 部署环境与日志检查

如需咨询，请联系我，并注明：PHP 维护咨询。

联系方式：
Telegram：@shuijingwan
微信：13980074657
邮箱：shuijingwanwq@gmail.com

translations Yii::t Yii 2 PhpMessageSource I18N RESTful messages message Yii 2 高级项目模板 RESTFUL WEB

发表回复取消回复

这个站点使用 Akismet 来减少垃圾评论。了解你的评论数据如何被处理。

在 Yii 2 高级项目模板中，实现 RESTFUL WEB 服务时，消息目录(messages)中配置的最佳实践

评论

发表回复 取消回复

更多文章

GLM-5.2 整篇翻译再次出现 Protected Token 校验失败：从尾部 Token 丢失到 Plaintext 结构重排的完整排查记录

ThinkPad T570 在 Ubuntu 下 Type-C 转 VGA 无法识别副屏：从 BIOS、UCSI 到 Thunderbolt 的完整排查记录

Ubuntu ThinkPad T570 挂起后黑屏：最终关闭自动挂起与合盖挂起，避免频繁强制关机

每天批量处理 20 篇 Mixed WordPress 历史文章：Classic 转 Gutenberg、SyntaxHighlighter 迁移、摘要补全与英文覆盖翻译完整 SOP

发表回复取消回复