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)
参数	Subject 字符串
返回	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