CakePHP - 国际化
与许多其他框架一样,CakePHP 也支持国际化。我们需要按照以下步骤从单一语言过渡到多种语言。
步骤 1
创建单独的语言环境目录 resources\locales。
步骤 2
在 src\Locale 目录下为每种语言创建子目录。子目录的名称可以是语言的两个字母 ISO 代码或完整的语言环境名称,如 en_US、fr_FR 等。
步骤 3
在每个语言子目录下创建单独的 default.po 文件。该文件包含msgid和msgstr形式的条目,如下面的程序所示。
msgid "msg" msgstr "CakePHP Internationalization example."
这里,msgid是将在视图模板文件中使用的键,msgstr是存储翻译的值。
步骤 4
在视图模板文件中,我们可以使用上面的msgid,如下所示,它将根据语言环境的设置值进行翻译。
<?php echo __('msg'); ?>
可以通过以下行在 config/app.php 文件中设置默认语言环境。
'defaultLocale' => env('APP_DEFAULT_LOCALE', 'en_US')
要在运行时更改本地,我们可以使用以下行。
use Cake\I18n\I18n;
I18n::locale('de_DE');
示例
按照以下程序所示在 config/routes.php 文件中进行更改。
config/routes.php
<?php
use Cake\Http\Middleware\CsrfProtectionMiddleware;
use Cake\Routing\Route\DashedRoute;
use Cake\Routing\RouteBuilder;
$routes->setRouteClass(DashedRoute::class);
$routes->scope('/', function (RouteBuilder $builder) {
$builder->registerMiddleware('csrf', new CsrfProtectionMiddleware([
'httpOnly' => true,
]));
$builder->applyMiddleware('csrf');
//$builder->connect('/pages',
['controller'=>'Pages','action'=>'display', 'home']);
$builder->connect('locale',
['controller'=>'Localizations','action'=>'index']);
$builder->fallbacks();
});
在 src/Controller/LocalizationsController.php 处创建一个 LocalizationsController.php 文件。将以下代码复制到控制器文件中。
src/Controller/LocalizationsController.php
<?php
namespace App\Controller;
use App\Controller\AppController;
use Cake\I18n\I18n;
class LocalizationsController extends AppController {
public function index() {
if($this->request->is('post')) {
$locale = $this->request->getData('locale');
I18n::setLocale($locale);
}
}
}
?>
在 resources\locales 中创建一个 locales 目录。在 locales 目录下创建 3 个目录,分别名为 en_US、fr_FR、de_DE。在每个目录下创建一个名为 default.po 的文件。将以下代码复制到相应的文件中。
resources/locales/en_US/default.po
msgid "msg" msgstr "CakePHP Internationalization example."
resources/locales/fr_FR/default.po
msgid "msg" msgstr "Exemple CakePHP internationalisation."
resources/locales/de_DE/default.po
msgid "msg" msgstr "CakePHP Internationalisierung Beispiel."
在 src/Template 创建一个目录 Localizations,并在该目录下创建一个名为 index.php 的 View 文件。将以下代码复制到该文件中。
src/Template/Localizations/index.php
<?php
echo $this->Form->create(NULL,array('url'=>'/locale'));
echo $this->Form->radio("locale",
[
['value'=>'en_US','text'=>'English'],
['value'=>'de_DE','text'=>'German'],
['value'=>'fr_FR','text'=>'French'],
]
);
echo $this->Form->button('Change Language');
echo $this->Form->end();
?>
<?php echo __('msg'); ?>
通过访问以下 URL 执行上述示例。http://localhost/cakephp4/locale
输出
执行后,您将收到以下输出。
电子邮件
CakePHP 提供 Email 类来管理电子邮件相关功能。要在任何控制器中使用电子邮件功能,我们首先需要通过编写以下行来加载 Email 类。
use Cake\Mailer\Email;
Email 类提供了各种有用的方法,如下所述。
| 语法 | From(string|array|null $email null, string|null $name null ) |
|---|---|
| 参数 |
|
| 返回 | array|$this |
| 说明 | 指定从哪个电子邮件地址发送电子邮件 |
| 语法 | To(string|array|null $emailnull, string|null $namenull) |
|---|---|
| 参数 |
|
| 返回 | array|$this |
| 说明 | 指定电子邮件将发送给谁 |
| 语法 | Send(string|array|null $contentnull) |
|---|---|
| 参数 |
|
| 返回 | array |
| 说明 | 使用指定的内容、模板和布局发送电子邮件 |
| 语法 | Subject(string|null $subjectnull) |
|---|---|
| 参数 |
|
| 返回 | array|$this |
| 描述 | 获取/设置主题 |
| 语法 | Attachments(string|array|null $attachmentsnull) |
|---|---|
| 参数 |
|
| 返回 | array|$this |
| 说明 | 将附件添加到电子邮件消息 |
| Syntax | Bcc(string|array|null $emailnull, string|null $namenull) |
|---|---|
| 参数 |
|
| 返回 | array|$this |
| 描述 | 密送 |
| 语法 | cc( string|array|null $emailnull , string|null $namenull ) |
|---|---|
| 参数 |
|
| 返回 | array|$this |
| 说明 | Cc |
示例
在 config/routes.php 文件中进行更改,如下所示程序。
config/routes.php
<?php
use Cake\Http\Middleware\CsrfProtectionMiddleware;
use Cake\Routing\Route\DashedRoute;
use Cake\Routing\RouteBuilder;
$routes->setRouteClass(DashedRoute::class);
$routes->scope('/', function (RouteBuilder $builder) {
$builder->registerMiddleware('csrf', new CsrfProtectionMiddleware([
'httpOnly' => true,
]));
$builder->applyMiddleware('csrf');
//$builder->connect('/pages',['controller'=>'Pages','action'=>'display', 'home']);
$builder->connect('/email',['controller'=>'Emails','action'=>'index']);
$builder->fallbacks();
});
在 src/Controller/EmailsController.php 处创建一个 EmailsController.php 文件。将以下代码复制到控制器文件中。
src/Controller/EmailsController.php
<?php
namespace App\Controller;
use App\Controller\AppController;
use Cake\Mailer\Email;
class EmailsController extends AppController{
public function index(){
$email = new Email('default');
$email->to('abc@gmail.com')
->subject('About')
->send('My message');
}
}
?>
在 src/Template 创建一个目录 Emails,并在该目录下创建一个名为 index.php 的视图文件。将以下代码复制到该文件中。
src/Template/Emails/index.php
电子邮件已发送。
在发送任何电子邮件之前,我们需要对其进行配置。在下面的屏幕截图中,您可以看到有两种传输方式,默认和 Gmail。我们使用了 Gmail 传输方式。
您需要将"GMAIL USERNAME"替换为您的 Gmail 用户名,将"APP PASSWORD"替换为您的应用程序密码。您需要在 Gmail 中开启两步验证,并创建新的 APP 密码才能发送电子邮件。
config/app.php
访问以下网址执行上述示例 − http://localhost/cakephp/email
输出
执行后,您将收到以下输出。

