在本部分，我们将深入探讨 Yii 框架在实际开发中的应用，包括如何构建 RESTful API、集成第三方服务、进行单元测试与调试、支持国际化与本地化等内容。这些技能对于开发更复杂、更高效的 Web 应用至关重要。

---

1. RESTful API 开发

1.1 构建 RESTful 控制器

Yii 提供了强大的支持来开发 RESTful API。通过继承 yii\rest\ActiveController，你可以轻松地创建一个符合 RESTful 规范的 API 控制器。

创建 RESTful 控制器：

namespace app\controllers;

use yii\rest\ActiveController;

class PostController extends ActiveController
{
    public $modelClass = 'app\models\Post';  // 指定模型类
}

此时，PostController 自动支持基本的 CRUD 操作，如 GET、POST、PUT、DELETE 请求。

URL 路由配置：
在 config/web.php 中配置 URL 规则来访问该控制器：

'components' => [
    'urlManager' => [
        'enablePrettyUrl' => true,
        'rules' => [
            'GET posts' => 'post/index',       // 获取所有文章
            'GET post/<id:\d+>' => 'post/view', // 获取单篇文章
            'POST post' => 'post/create',      // 创建文章
            'PUT post/<id:\d+>' => 'post/update', // 更新文章
            'DELETE post/<id:\d+>' => 'post/delete', // 删除文章
        ],
    ],
],

1.2 返回 JSON 数据

Yii 默认返回的数据是 JSON 格式。当你使用 ActiveController 时，Yii 会自动将数据转换为 JSON 格式。你可以使用 $this->asJson() 方法来显式返回 JSON 数据：

public function actionIndex()
{
    $data = Post::find()->all();
    return $this->asJson($data);  // 返回 JSON 格式的数据
}

1.3 API 身份认证（如 JWT 或 OAuth2）

安全性是 RESTful API 开发中的一个重要方面。Yii 提供了多种身份认证方式，常见的包括 JWT（JSON Web Token）和 OAuth2。

使用 JWT 认证：

1. 安装 firebase/php-jwt 库：

   composer require firebase/php-jwt

2. 配置 JWT 认证：
   在 components 中设置 JWT 身份验证：

   'components' => [
       'user' => [
           'identityClass' => 'app\models\User',
           'enableAutoLogin' => false,
       ],
       'authManager' => [
           'class' => 'yii\rbac\DbManager',  // 或其他 RBAC 实现
       ],
   ],

3. 在控制器中实现 JWT 认证逻辑：

   use \Firebase\JWT\JWT;

   class ApiController extends yii\rest\Controller
   {
       public function actionLogin()
       {
           $data = Yii::$app->request->post();
           // 验证用户登录信息
           // ...

           // 生成 JWT
           $key = "secret_key";
           $payload = [
               'user_id' => $user->id,
               'exp' => time() + 3600,  // 设置过期时间
           ];
           $jwt = JWT::encode($payload, $key);
           return $this->asJson(['token' => $jwt]);
       }
   }

1.4 第三方服务集成

在现代 Web 开发中，集成第三方服务是一个常见的需求。以下是一些常见的集成方式。

1.5 第三方登录（如 Google、Facebook）

使用第三方登录可以让用户通过已有的社交账号快速登录应用。Yii 支持通过扩展如 yii2-authclient 来集成社交登录功能。

安装 yii2-authclient 扩展：

composer require yiisoft/yii2-authclient

配置第三方认证：
在 config/web.php 中配置：

'components' => [
    'authClientCollection' => [
        'class' => 'yii\authclient\Collection',
        'clients' => [
            'google' => [
                'class' => 'yii\authclient\clients\Google',
                'clientId' => 'your-client-id',
                'clientSecret' => 'your-client-secret',
            ],
            'facebook' => [
                'class' => 'yii\authclient\clients\Facebook',
                'clientId' => 'your-client-id',
                'clientSecret' => 'your-client-secret',
            ],
        ],
    ],
],

然后可以通过如下方式获取用户的 Google 或 Facebook 信息：

public function actionLoginWithGoogle()
{
    $client = Yii::$app->authClientCollection->getClient('google');
    $userAttributes = $client->getUserAttributes();
    // 获取用户信息后登录
}

1.6 使用邮件服务（如 SMTP 或 SendGrid）

Yii 提供了内建的邮件发送功能，支持 SMTP 和其他邮件服务如 SendGrid。

配置 SMTP 邮件服务：
在 config/web.php 中配置邮件组件：

'components' => [
    'mailer' => [
        'class' => 'yii\swiftmailer\Mailer',
        'transport' => [
            'class' => 'Swift_SmtpTransport',
            'host' => 'smtp.example.com',
            'username' => 'user@example.com',
            'password' => 'password',
            'port' => '587',
            'encryption' => 'tls',
        ],
    ],
],

发送邮件：

Yii::$app->mailer->compose()
    ->setFrom('from@example.com')
    ->setTo('to@example.com')
    ->setSubject('Test email')
    ->setTextBody('This is a test email.')
    ->send();

1.7 第三方支付集成（如支付宝、PayPal）

集成第三方支付可以通过 SDK 或 API 进行。以下是支付宝和 PayPal 支付的基本集成方法。

PayPal 集成：
使用 PayPal 的 SDK 或直接调用 REST API 来处理支付。

composer require paypal/rest-api-sdk-php

支付宝集成：
支付宝提供了多种 SDK，可以通过配置 API 密钥来进行支付请求。

---

2. 单元测试与调试

2.1 使用 Yii 提供的测试框架

Yii 提供了内建的测试框架，基于 PHPUnit。你可以用它来编写单元测试、功能测试和性能测试。

创建测试用例：

php yii gii/test

编写单元测试：

class PostTest extends \yii\codeception\TestCase
{
    public function testCreatePost()
    {
        $post = new Post(['title' => 'Test Post']);
        $this->assertTrue($post->save());
    }
}

2.2 PHPUnit 测试的配置

确保你已经安装 PHPUnit，并在 phpunit.xml 文件中配置测试环境。

<phpunit bootstrap="tests/_bootstrap.php">
    <testsuites>
        <testsuite name="application tests">
            <directory>tests</directory>
        </testsuite>
    </testsuites>
</phpunit>

2.3 调试工具与日志记录

Yii 提供了丰富的调试工具，包括 Yii::debug(), Yii::info() 和 Yii::error()。你可以在应用中添加日志记录和调试信息。

调试信息输出：

Yii::debug('This is a debug message.');
Yii::info('This is an info message.');
Yii::error('This is an error message.');

查看调试面板：
在开发模式下，Yii 会自动显示调试面板，展示请求、数据库查询、缓存等信息。

---

3. 国际化与本地化

3.1 多语言支持

Yii 提供了强大的国际化（i18n）和本地化（l10n）支持，可以帮助你为应用提供多语言版本。你可以为不同语言创建消息文件，并在应用中动态切换语言。

配置语言支持：
在 config/web.php 中配置应用支持的语言：

'language' => 'en-US',  // 默认语言
'sourceLanguage' => 'en-US',  // 原始语言
'components' => [
    'i18n' => [
        'translations' => [
            '*' => [
                'class' => 'yii\i18n\PhpMessageSource',
                'basePath' => '@app/messages',
            ],
        ],
    ],
],

3.2 翻译功能

在视图文件中使用 Yii::t() 函数进行文本翻译：

echo Yii::t('app', 'Hello World');

翻译文件结构：
在 messages 目录

下，为不同语言创建相应的翻译文件（如 messages/en-US/app.php）。

3.3 日期、时间与货币的本地化

Yii 还提供了日期、时间和货币的本地化支持，允许你根据不同地区格式化数据。

格式化日期：

echo Yii::$app->formatter->asDate('2025-01-23', 'long');

格式化货币：

echo Yii::$app->formatter->asCurrency(1000);

---

通过掌握这些进阶技能，你将能够开发更复杂的 Web 应用程序，并且能有效地进行国际化、集成第三方服务、优化性能等操作。