2025年12月31日，PHP 生态圈迎来重磅消息——历经多年深耕打磨，Yii3 框架正式发布！

作为传承 Yii 家族高性能、易用性基因的新一代产品，Yii3 不仅修复了前代版本的核心痛点，更以模块化架构、生态兼容、标准先行的全新姿态，为 PHP 开发者带来了革命性的开发体验。

为什么需要 Yii3？那些被解决的核心痛点

Yii 1.1 和 2.0 曾是无数 PHP 项目的首选框架，但在技术快速迭代的今天，前代版本逐渐暴露出一些局限：

  • Yii 2.0 生态封闭，整合通用 PHP 包困难重重；
  • 部分"魔法特性"导致行为不透明，违背标准 PHP 实践；
  • 受限于向下兼容，无法充分适配现代 PHP 特性与标准；
  • 内置服务定位器等反模式，长期影响项目的可测试性与可维护性。

Yii3 的诞生，正是为了突破这些局限，在保留 Yii 核心优势的同时，打造更符合现代开发需求的框架生态。

Yii3 核心亮点：重新定义 PHP 开发体验

1. 模块化架构：按需组合，告别臃肿

不同于 Yii 1.1 和 2.0 的单体框架设计，Yii3 构建了由 130 多个官方包组成的生态系统。这些包可独立使用于任何 PHP 项目，也可通过应用模板快速组合成完整框架，真正实现"按需安装"：

  • Web 模板：适用于传统服务端渲染应用；
  • API 模板：专为接口开发优化；
  • Console 模板：用于命令行工具与后台任务。

模板默认仅包含路由、配置、依赖注入等核心能力，数据库连接等扩展功能可按需添加，彻底摆脱冗余代码负担。

2. 全生态兼容：打破壁垒，自由选型

与 Yii 2.0 那样专注于 Yii 专用扩展不同，我们让该框架能够很好地兼容 Packagist 上的任何 PHP 包，无论是兼容 PSR 的、Symfony 的包，还是通用的 PHP 代码。容器可以配置这些任意一个。

Yii3拥抱了整个PHP生态系统，而不是重新发明轮子。它能无缝集成任何 PHP 库。没有供应商锁定。没有专有API。只是现代PHP标准，让你能够利用整个生态系统的创新。

3. 一流依赖注入（DI）容器：简洁高效，可调试无魔法

DI 容器是 Yii3 的核心中枢，负责整合所有组件并自动解析依赖，用法简洁且完全透明：

return [
   // Interface to class mapping
   EngineInterface::class => EngineMarkOne::class,

   // Detailed configuration
   MyServiceInterface::class => [
       'class' => MyService::class,
       '__construct()' => [42],
       'setDiscount()' => [10],
   ],

   // Factory closures
   'api' => static fn(ApiConfig $config) => new ApiClient($config),
];

// Dependencies are automatically injected based on type hints
final readonly class MyController
{
   public function __construct(
       private CacheInterface $cache
   ) {}
}

容器运行速度极快，支持实时调试，可通过 XDebug 逐步跟踪配置执行过程，彻底告别"魔法行为"带来的调试难题。

4. 灵活配置：兼容多场景，支持环境隔离

Yii3 延续了 Yii 2.0 的配置理念，并进一步优化：

  • 支持多环境配置、配置覆盖，适配复杂项目需求；
  • 默认区分 Web/API 与 Console 配置，同时保留公共配置共享；
  • 配置分为 DI 容器映射与参数设置两部分，结构清晰。

示例配置如下：

'yiisoft/view' => [
    'basePath' => null,
    'parameters' => [
        'assetManager' => Reference::to(AssetManager::class),
        'applicationParams' => Reference::to(ApplicationParams::class),
        'aliases' => Reference::to(Aliases::class),
        'urlGenerator' => Reference::to(UrlGeneratorInterface::class),
        'currentRoute' => Reference::to(CurrentRoute::class),
    ],
],

'yiisoft/yii-view-renderer' => [
    'viewPath' => null,
    'layout' => '@src/Web/Shared/Layout/Main/layout.php',
    'injections' => [
        Reference::to(CsrfViewInjection::class),
    ],
],

5. 强化安全：全方位守护应用安全

安全始终是 Yii 框架的核心考量，Yii3 内置完善的安全机制：

  • 访问控制抽象、RBAC 权限管理、JWT 认证；
  • 用户系统抽象、代理链与请求头处理中间件；
  • 第三方登录客户端、CSRF 保护工具；
  • 专属安全指南与标准化响应流程。

6. 数据库能力：强大灵活，自由选择

Yii3 将 Yii 2.0 优秀的数据库抽象层独立为 yiisoft/db 包，包含：

  • 数据库访问、 schema 管理与强大的查询构建器；
  • 更简洁明确的 Active Record 实现；
  • 迁移、数据库缓存等配套工具。

同时支持 Cycle ORM、Doctrine、PDO 或原生驱动，开发者可根据项目需求自由选择数据库解决方案。查询示例：

$posts = $connection
    ->select(['id', 'title', 'created_at'])
    ->from('{{%posts}}')
    ->where(['status' => 'published'])
    ->andWhere(['>', 'views', 1000])
    ->orderBy(['created_at' => SORT_DESC])
    ->limit(10)
    ->all();

7. 性能优化：Worker 模式大幅提升响应速度

针对传统 PHP 服务器"每次请求初始化"的性能瓶颈，Yii3 支持与 RoadRunner、Swoole、FrankenPHP 配合运行在 Worker 模式下：框架仅初始化一次，即可处理多个请求周期，响应速度大幅提升。框架组件均设计为无状态或可重置状态，有效避免内存泄漏与状态污染。

8. 完善工具链：覆盖全开发流程

Yii3 提供了从开发、测试到部署的完整工具支持：

  • 数据抽象与管理：yiisoft/data 包支持数据格式化、分页、排序，配套网格组件可快速构建管理后台；
  • 缓存增强：内置缓存击穿防护，支持 APCu、Redis、Memcached 等多种 PSR-16 兼容缓存后端；
  • 表单与验证：基于属性的强大验证器，支持从 HTTP 或其他来源填充表单数据；
  • 国际化：内置 ICU 格式化的消息翻译，支持视图层与路由国际化；
  • 测试友好：依赖倒置设计简化单元测试，提供 PSR 兼容的测试工具集，无需启动 HTTP 服务器即可进行 API 测试；
  • 友好错误处理：详细的错误上下文、高亮报错代码、可折叠框架栈追踪，开发模式下提供错误原因与修复建议。

品质保障：高标准铸就稳定基石

Yii3 全量包均遵循严格的质量标准：

  • 近 100% 测试覆盖率，严格的 Psalm/PhpStan 类型检查；
  • 接近 100% 变异测试分数，确保代码逻辑健壮；
  • 所有代码变更均公开评审，保证代码质量；
  • 遵循 SemVer 版本规范，补丁版本不破坏兼容性，次要版本新增功能向下兼容。

写在最后

Yii3 核心团队表示，框架将在未来持续优化：

  • 完善文档，补充缺失内容；
  • 发布队列、调试面板、Gii 等更多配套工具；
  • 收集社区反馈，持续修复与改进；
  • 优化官方网站体验。

历经多年沉淀，Yii3 不仅是一次版本升级，更是 PHP 框架设计理念的革新。它以模块化、标准化、生态兼容为核心，既保留了 Yii 家族的易用性与高性能，又解决了前代版本的痛点，为 PHP 项目提供了可支撑未来 10 年以上发展的稳定基石。