CakePHP 國際化

像許多其他框架一樣，CakePHP 也支援國際化。我們需要按照以下步驟從單一語言轉到多語言。

步驟1

建立單獨的語言環境目錄資源語言環境.

步驟 2

在 srcLocale 目錄下為每種語言建立子目錄。子目錄的名稱可以是語言的兩個字母 ISO 代碼或完整的語言環境名稱，如 en_US、fr_FR 等

步驟3

在每個語言子目錄下建立單獨的 default.po 檔案。該檔案包含 msgid 和 msgstr 形式的條目，如以下程式所示。

msgid "msg"
msgstr "CakePHP Internationalization example."

這裡，msgid 是將在視圖範本檔案中使用的鍵，msgstr 是儲存翻譯的值。

步驟 4

在View範本檔案中，我們可以使用上面的msgid，如下所示，它會根據設定的locale值進行翻譯。

<?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);
         }
      }
   }
?>

在資源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 並在該目錄下建立一個 View 文件，名稱為 index.php。 複製該檔案中包含以下程式碼。

src/Template/Localizations/index.php

Form->create(NULL,array('url'=>'/locale'));
   echo $this->Form->radio("locale",
      [
         ['value'=>'en_US','text'=>'CakePHP 國際化'],
         ['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 類別來管理電子郵件相關功能。要在任何控制器中使用電子郵件功能，我們首先需要透過編寫以下行來載入電子郵件類別。

use Cake\Mailer\Email;

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

表>

語法

Syntax	From(string|array|null $email null, string|null $name null )
Parameters	String with email Name
Returns	array|$this
Description	It specifies from which email address; the email will be sent

From(string|array|null $email null, string|null $name null )

參數

• 包含電子郵件的字串

  Syntax	To(string|array|null $emailnull, string|null $namenull)
  Parameters	String with email Name
  Returns	array|$this
  Description	It specifies to whom the email will be sent

• 姓名

回傳

Syntax	Send(string|array|null $contentnull)
Parameters	String with message or array with messages.
Returns	array
Description	Send an email using the specified content, template and layout

數組|$這個

描述

它指定來自哪個電子郵件地址；電子郵件將被發送

Syntax	Subject(string|null $subjectnull)
Parameters	Subject string
Returns	array|$this
Description	Get/Set Subject

表>

語法	To(string|array|null $emailnull, string|null $namenull)
參數	包含電子郵件的字串 姓名
回傳	數組|$這個
描述	指定電子郵件將發送給誰

表>

語法	傳送（字串|陣列|null $contentnull）
參數	包含訊息的字串或包含訊息的陣列。
回傳	數組
描述	使用指定的內容、範本和佈局來發送電子郵件

表>

語法	主題（字串|null $主題null）
參數	主題字串
回傳	數組|$這個
描述	取得/設定主題

Syntax	Attachments(string|array|null $attachmentsnull)
Parameters	String with the filename or array with filenames
Returns	array|$this
Description	Add attachments to the email message

Syntax	Bcc(string|array|null $emailnull, string|null $namenull)
Parameters	String with email Name
Returns	array|$this
Description	Bcc

Syntax	cc( string|array|null $emailnull , string|null $namenull )
Parameters	String with email Name
Returns	array|$this
Description	Cc

Example

Make changes in the config/routes.php file as shown in the following program.

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();
});

Create an EmailsController.php file at src/Controller/EmailsController.php. Copy the following code in the controller file.

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');
      }
   }
?>

Create a directory Emails at src/Template and under that directory, create a View file called index.php. Copy the following code in that file.

src/Template/Emails/index.php

Email Sent.

Before we send any email, we need to configure it. In the below screenshot, you can see that there are two transports, default and Gmail. We have used Gmail transport.

You need to replace the “GMAIL USERNAME” with your Gmail username and “APP PASSWORD” with your applications password. You need to turn on 2-step verification in Gmail and create a new APP password to send email.

config/app.php

Execute the above example by visiting the following URL − http://localhost/cakephp/email

Output

Upon execution, you will receive the following output.