企业官网建设流程全解析

• 后端
• Web框架

Yii（读作 "Yee" 或[ji:]）是一个基于组件架构、面向高性能的 PHP 框架，专为快速开发现代 Web 应用而设计。本指南对应官方文档的"什么是 Yii"章节，系统讲解 Yii 的定位、适用场景、与同类框架的差异、版本演进以及环境要求，并结合仓库源码（composer.json、requirements.php）给出可验证的技术细节，帮助你判断它是否适合你的下一个 PHP 项目，并为后续深入阅读 Yii 2 文档打下基础。

Yii 是什么：名字含义与定位

Yii 是一个高性能、基于组件（component-based）的 PHP 框架，其设计目标是帮助开发者快速构建现代 Web 应用。官方指南对它的定位是"通用 Web 编程框架"——这意味着只要是使用 PHP 的 Web 应用开发场景，Yii 都可以胜任，而不是仅仅面向某一类特定应用。

"Yii" 这个名字在中文里意为**"简单而进化"（simple and evolutionary）**，同时也可以看作 "Yes It Is"（是的，就是这样）的缩写。这个名字本身就传达了框架的核心哲学：追求简单、不断进化。

从仓库看，Yii 2 的核心库由yiisoft/yii2这个 Composer 包提供，psr-4自动加载规则将命名空间yii\映射到框架根目录（见 composer.json），全部核心代码都放在仓库的 framework 目录下，按功能划分为base、db、web、rest、i18n、caching、validators等模块。

Yii 适合做什么：典型应用场景

得益于组件化架构和成熟的多级缓存（multi-tier caching）支持，Yii 尤其适合开发大规模、高复杂度的 Web 应用。官方指南明确列出的典型场景包括：

• 门户网站（portals）
• 论坛（forums）
• 内容管理系统（CMS）
• 电子商务项目（e-commerce）
• RESTful Web 服务（RESTful Web services）
• 以及其他各类基于 PHP 的 Web 应用

这些场景的共同特点是：数据模型复杂、访问量大、需要缓存与性能优化，而 Yii 的组件化架构正好提供了对应对这些需求的支撑。仓库中 framework/rest 目录下的控制器、路由、序列化器等组件，以及 framework/caching 目录下的多种缓存驱动（文件、Memcache、Redis 等）实现，都是这一能力的具体落地。

Yii 与其他 PHP 框架的对比

如果你已经熟悉其他 PHP 框架，可以从以下几个方面理解 Yii 的定位差异：

遵循 MVC 架构模式

与大多数 PHP 框架一样，Yii 实现了MVC（Model-View-Controller）架构模式，并鼓励基于该模式组织代码。仓库中的目录结构即是 MVC 的直接体现：framework/db 与 ActiveRecord 构成模型层，framework/web 中的 Controller 构成控制器层，而 framework/views 与 framework/widgets 构成视图层。这种模式让业务逻辑、数据访问与界面呈现各司其职，便于维护和团队协作。

简洁优雅的编码哲学

Yii 信奉"代码应当以简单而优雅的方式编写"的哲学：Yii 绝不会仅仅为了严格遵循某种设计模式而过度设计（over-design）。这一点与许多为了模式而模式的框架形成鲜明对比——Yii 优先考虑实用性与代码可读性。

全栈功能，开箱即用

Yii 是一个经过验证的全栈（full-stack）框架，内置大量成熟、可直接使用的功能，包括：

• 查询构建器（query builder）与 ActiveRecord：同时支持关系型数据库与 NoSQL 数据库（通过相应扩展）；
• RESTful API 开发支持：仓库中的 framework/rest 模块提供了 REST 控制器基类、URL 路由规则、内容协商与响应格式化等完整方案；
• 多级缓存支持：数据缓存、片段缓存、页面缓存与 HTTP 缓存等多层缓存机制；
• 以及输入验证、安全加密、国际化（i18n）、日志等配套能力。

这些功能都封装在 framework 目录的各个子模块中，无需自行组装第三方库即可投入使用。

极高的可扩展性

Yii 的几乎每一段核心代码都可以被自定义或替换。这得益于其组件化架构：开发者可以覆写（override）核心类的行为，也可以通过严格的扩展（extension）架构使用或开发可再分发的扩展包。这意味着当框架默认行为不满足需求时，你通常不需要"绕过"框架，而是可以直接在框架内优雅地扩展它。

高性能是首要目标

官方指南明确写道："高性能始终是 Yii 的首要目标（High performance is always a primary goal of Yii）。" 这体现在延迟加载（lazy loading）、缓存分层设计、以及代码组织等多个层面。注意这里描述的是框架的设计目标，实际性能表现取决于具体应用场景与部署环境，不应据此夸大任何未经测试的数据。

社区与开发团队：不是"一个人的表演"

Yii 并非"单人之作"，而是由强大的核心开发团队以及大量持续贡献的专业开发者社区共同支撑。Yii 开发团队密切关注最新的 Web 开发趋势，持续研究其他框架与项目中的最佳实践和优秀特性，并将其中最有价值的部分定期整合进框架核心，通过简单优雅的接口暴露给开发者。

仓库 composer.json 的作者列表中列出了 Qiang Xue（创始人兼项目负责人）、Alexander Makarov、Carsten Brandt 等多名核心维护者，佐证了 Yii 作为社区协作项目的属性。

Yii 的版本：1.1 与 2.0

Yii 目前有两个大版本：

2.0 版本重写时采用的技术包括：

• Composer：作为依赖管理与自动加载标准工具（见 composer.json 中的依赖声明与autoload配置）；
• PSR：遵循 PSR 系列标准（例如 PSR-4 自动加载规范，yii\命名空间直接映射到框架目录）；
• 命名空间（namespaces）：核心代码全部基于 PHP 命名空间组织，例如应用基类位于 framework/base/Application.php 的yii\base命名空间；
• Trait（特征）：利用 PHP trait 机制在多个类之间复用代码。

官方指南明确说明：本指南（guide）主要以 2.0 版本为对象。仓库根目录的 composer.json、framework/composer.json 以及 UPGRADE.md 中的迁移说明，都是围绕 2.0 版本展开的。

环境要求与预备知识

PHP 版本要求

官方指南与 composer.json 一致声明：Yii 2.0 要求 PHP 7.4.0 或更高版本，并且在最新版本的 PHP 上运行效果最佳。

composer.json 中同时还声明了以下运行时扩展依赖：

• ext-mbstring：多字节字符串处理；
• ext-ctype：字符类型检查函数；
• lib-pcre：PCRE 正则库；
• 以及ezyang/htmlpurifier、cebe/markdown等核心第三方库。

（注：仓库中的 requirements.php 对 PHP 版本的检查条件写的是>= 7.3.0，属于该检查脚本自身的判定阈值，实际安装门槛以 composer.json 声明的>=7.4.0为准。）

需求检查器（Requirement Checker）

每个 Yii 发行版都内置一个需求检查器（requirement checker），用于针对具体功能逐项检查服务器环境是否满足要求。仓库中对应实现为：

• framework/requirements/requirements.php：核心检查项清单，每个检查项包含名称、是否强制（mandatory）、判定条件、关联功能与说明；
• framework/requirements/YiiRequirementChecker.php：检查器实现类，支持链式调用checkYii()->check($requirements)->render()，也支持自定义检查条件（如"eval:$this->checkUploadMaxFileSize('5M')"形式的表达式）；
• framework/requirements/views/web/index.php 与 framework/requirements/views/console/index.php：分别提供 Web 页面与控制台两种检查结果输出视图。

从检查清单看，强制项（mandatory）包括 PHP 版本、Reflection 扩展、PCRE 扩展、SPL 扩展、Ctype 扩展、MBString 扩展；可选但推荐（非强制）的包括：

在正式部署或排查环境问题时，运行需求检查器是一个非常有价值的诊断步骤：它能将"某个功能为什么不可用"这类问题，快速定位到具体的缺失扩展上。

预备知识：OOP、命名空间与 Trait

由于 Yii 是一个纯 OOP（面向对象）框架，使用 Yii 需要具备面向对象编程的基础知识。此外，Yii 2.0 大量运用了 PHP 的最新语言特性，包括：

• 命名空间（namespaces）：Yii 核心类全部位于yii\命名空间树下，理解命名空间是阅读和引用 Yii 类的前提；
• Trait（特征）：Yii 通过 trait 在多个类之间共享行为（例如行为组件、事件相关能力），理解 trait 有助于理解框架的复用机制。

掌握这些概念，将显著降低理解 Yii 2.0 代码的门槛。

快速上手路线

读完本指南后，建议按以下路径继续探索：

1. 阅读 docs/guide/intro-yii.md（英文原版）以及 docs/guide-tr 目录下的土耳其语翻译版，对照学习；
2. 按照 安装指南 完成环境搭建，并通过需求检查器确认环境达标；
3. 通过 Hello World 入门 跑通第一个应用，再逐步深入 MVC 架构、数据库与 ActiveRecord、缓存体系 与 RESTful API 等专题。

小结

Yii 2 是一个以高性能为首要目标、组件化架构支撑、遵循 MVC 模式并强调"简单优雅"编码哲学的全栈 PHP 框架。它面向门户、CMS、电商、RESTful API 等大规模应用场景，提供了查询构建器、ActiveRecord、多级缓存、REST 支持等开箱即用的能力，同时凭借近乎完全可定制的架构和严格的扩展机制，保证了极高的可扩展性。版本方面，2.0 是采用 Composer、PSR、命名空间与 trait 等现代 PHP 技术重写的当前主力版本；运行环境要求 PHP 7.4.0 及以上，并可通过内置的需求检查器逐项验证各项功能的依赖条件。如果你已经具备 OOP 基础并熟悉 PHP 的命名空间与 trait 特性，那么 Yii 2 将是一个值得认真评估的框架选择。

• 后端
• Web框架