CakePHP - 國際化

---

---

像許多其他框架一樣，CakePHP 也支援國際化。我們需要遵循以下步驟才能從單一語言切換到多種語言。

步驟 1

建立一個單獨的 locales 目錄 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，如下所示，它將根據 locale 的設定值進行翻譯。

<?php echo __('msg'); ?>

預設的 locale 可以透過以下行在 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 執行以上示例。https:///cakephp4/locale

輸出

執行後，您將收到以下輸出。

電子郵件

CakePHP 提供 Email 類來管理與電子郵件相關的功能。要在任何控制器中使用電子郵件功能，我們首先需要透過編寫以下行載入 Email 類。

use Cake\Mailer\Email;

Email 類提供了各種有用的方法，如下所述。

示例

按照以下程式所示對 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 的 View 檔案。將以下程式碼複製到該檔案中。

src/Template/Emails/index.php

Email Sent.

在傳送任何電子郵件之前，我們需要對其進行配置。在下圖中，您可以看到有兩個傳輸，預設和 Gmail。我們使用了 Gmail 傳輸。

您需要將“GMAIL 使用者名稱”替換為您的 Gmail 使用者名稱，並將“應用密碼”替換為您的應用程式密碼。您需要在 Gmail 中開啟 2 步驗證並建立一個新的應用密碼才能傳送電子郵件。

config/app.php

透過訪問以下 URL 執行以上示例 - https:///cakephp/email

輸出

執行後，您將收到以下輸出。