后端Web框架【免费下载链接】yii2Yii 2: The Fast, Secure and Professional PHP Framework项目地址https://gitcode.com/gh_mirrors/yi/yii2点击查看免费下载Yii 2 框架基于经典的模型-视图-控制器MVC架构模式组织应用但其完整应用结构远不止 MVC 三层入口脚本Entry Scripts、应用Applications、应用组件Application Components、模块Modules、过滤器Filters与小部件Widgets共同构成了一个完整、可扩展的应用体系。本文以 structure-overview.md 为骨架结合框架源码逐层拆解 Yii 2 的静态应用结构帮助你建立对应用全局地图的清晰认知并为后续阅读 MVC 各层、路由、缓存与 REST 开发文档打下基础。Yii 应用的静态结构入口脚本启动应用应用聚合模块、应用组件与控制器控制器再协调模型、视图、过滤器完成请求处理图源docs/guide/images/application-structure.pngMVC 模式应用组织的基石Yii 应用按照 模型-视图-控制器MVC 架构模式进行组织三者各司其职模型Models代表数据、业务逻辑与规则。模型是应用处理数据的核心对象通常通过继承yii\base\Model或其子类创建。视图Views模型在输出端的呈现形式。视图负责把模型数据渲染成用户可见的 HTML 或其他格式。控制器Controllers接收输入并将输入转化为对模型和视图的命令。控制器是请求处理流程的调度中心。三者的协作关系在框架源码中有明确体现控制器在 actionView() 中通过Post::findOne($id)加载模型再调用$this-render(view, [model $model])将模型注入视图在 actionCreate() 中则先$model-load(Yii::$app-request-post())接收用户输入、$model-save()保存数据成功后重定向、失败则渲染表单视图。这一控制器取数→模型处理→视图呈现的闭环正是 MVC 在 Yii 2 中的标准落地形态。设计取向Yii 官方推荐胖模型、瘦控制器Fat Models, Thin Controllers。模型是业务数据、规则与逻辑的集中地而控制器应当保持精简每个 action 只包含少量协调性代码。六大核心实体MVC 之外的架构部件除了 MVC 三要素Yii 应用还包含以下六类核心实体它们共同支撑起完整的应用骨架实体作用关键类 / 文档入口脚本Entry Scripts用户可直接访问的 PHP 脚本负责启动一次请求处理周期yii\web\Application、structure-entry-scripts.md应用Applications全局可访问的对象管理应用组件并协调它们完成请求yii\base\Application、structure-applications.md应用组件Application Components注册在应用上的对象为处理请求提供各类服务yii\base\Application::$components、structure-application-components.md模块Modules自包含的软件单元内部拥有完整的 MVC 结构应用可由多个模块组成yii\base\Module、structure-modules.md过滤器Filters在控制器处理每个请求前后被调用的代码yii\base\ActionFilter、structure-filters.md小部件Widgets可嵌入视图的对象可能包含控制器逻辑可在不同视图中复用yii\base\Widget、structure-widgets.md如上图所示这些实体之间存在清晰的层级与包含关系入口脚本 1:1 关联应用应用可以聚合 0..n 个模块、0..n 个应用组件且必须包含至少 1 个控制器控制器包含过滤器、视图与模型视图内部又可以嵌入小部件并注册资源包Asset Bundles。下面逐一深入。入口脚本请求周期的起点入口脚本是应用引导bootstrapping过程的第一步。无论 Web 应用还是控制台应用都只有一个入口脚本最终用户通过请求入口脚本来实例化应用对象并把请求转交给它。Web 应用入口脚本必须存放在 Web 可访问目录下通常命名为index.php控制台应用入口脚本通常存放在应用根目录下、命名为yii无.php后缀并设置为可执行以便通过./yii route [arguments] [options]运行控制台命令。入口脚本的核心工作可归纳为六步定义全局常量注册 Composer 自动加载器引入Yii类文件加载应用配置创建并配置应用实例调用yii\base\Application::run()处理传入请求。Basic 项目模板的 Web 入口脚本完整代码如下?php defined(YII_DEBUG) or define(YII_DEBUG, true); defined(YII_ENV) or define(YII_ENV, dev); // register Composer autoloader require __DIR__ . /../vendor/autoload.php; // include Yii class file require __DIR__ . /../vendor/yiisoft/yii2/Yii.php; // load application configuration $config require __DIR__ . /../config/web.php; // create, configure and run application (new yii\web\Application($config))-run();控制台入口脚本与之类似但以#!/usr/bin/env php开头、使用yii\console\Application并通过exit($exitCode)把运行退出码返回给操作系统#!/usr/bin/env php ?php defined(YII_DEBUG) or define(YII_DEBUG, true); defined(YII_ENV) or define(YII_ENV, dev); // register Composer autoloader require __DIR__ . /vendor/autoload.php; // include Yii class file require __DIR__ . /vendor/yiisoft/yii2/Yii.php; // load application configuration $config require __DIR__ . /config/console.php; $application new yii\console\Application($config); $exitCode $application-run(); exit($exitCode);全局常量调试与环境的开关入口脚本是定义全局常量的最佳位置。Yii 支持以下三个关键常量常量含义默认值YII_DEBUG是否处于调试模式开启后保留更多日志信息异常时展示详细调用栈仅建议开发环境开启falseYII_ENV应用运行环境如dev/prod详见 ConfigurationsprodYII_ENABLE_ERROR_HANDLER是否启用 Yii 内置的错误处理器true定义常量时常用defined(YII_DEBUG) or define(YII_DEBUG, true);这种简洁写法等价于if (!defined(YII_DEBUG)) { define(YII_DEBUG, true); }。常量定义必须放在入口脚本最开头以便在引入其他 PHP 文件时生效。应用Application全局协调者每个 Yii 应用系统包含唯一一个应用对象它在入口脚本中被创建并可通过\Yii::$app表达式全局访问。Yii 提供两种应用类型处理 Web 请求的 yii\web\Application 和处理控制台命令的 yii\console\Application。应用配置一切初始化的源头入口脚本创建应用时会加载一份配置并应用到应用对象上。由于应用配置通常非常复杂一般保存在配置文件中如web.phprequire __DIR__ . /../vendor/autoload.php; require __DIR__ . /../vendor/yiisoft/yii2/Yii.php; // load application configuration $config require __DIR__ . /../config/web.php; // instantiate and configure the application (new yii\web\Application($config))-run();必配属性id 与 basePath任何应用都至少需要配置两个属性id应用的唯一标识主要用于程序内部使用推荐仅使用字母数字字符以保证最佳互操作性。basePath应用根目录包含全部受保护源码models、views、controllers等 MVC 子目录。可配置为目录路径或路径别名对应目录必须存在否则抛出异常路径会经realpath()规范化。Yii 会基于它预定义app别名并由此推导出运行目录等其它重要路径如app/runtime。重要属性速览除必配属性外以下属性在不同应用间差异较大通常需要显式配置属性作用典型配置aliases以数组形式定义路径别名aliases [name1 path/to/path1]bootstrap指定应在引导过程中运行的组件列表bootstrap [log, debug]catchAllWeb 专用让一个指定控制器动作接管所有请求常用于维护模式catchAll [offline/notice, param1 value1]components注册应用组件最重要的属性components [cache [class yii\caching\FileCache]]controllerMap将控制器 ID 映射到任意控制器类突破命名约定限制controllerMap [account app\controllers\UserController]controllerNamespace控制器类所在默认命名空间默认app\controllerscontrollerNamespace app\controllerslanguage应用向用户展示内容所用的语言默认enlanguage zh-CNmodules应用包含的模块列表modules [booking app\modules\booking\BookingModule]name应用名称用于展示无需唯一name My Appparams全局可访问的应用参数数组params [thumbnail.size [128, 128]]sourceLanguage应用代码书写语言默认en-USsourceLanguage en-UStimeZone设置 PHP 运行时默认时区等价于date_default_timezone_set()timeZone America/Los_Angelesversion应用版本号默认1.0version 2.0.0另有按约定即可、通常无需改动但可打破约定的实用属性charset默认UTF-8、defaultRouteWeb 默认site控制台默认help、extensions默认取自vendor/yiisoft/extensions.php、layout默认main、layoutPath默认app/views/layouts、runtimePath默认app/runtime必须可写且需防止终端用户访问、viewPath默认app/views、vendorPath默认app/vendor、以及控制台专用的enableCoreCommands默认true。bootstrap 属性的底层实现bootstrap属性值得特别关注。从 Application::bootstrap() 源码可以看到其完整执行逻辑首先加载vendor/yiisoft/extensions.php中声明的扩展别名并实例化扩展引导类然后遍历$this-bootstrap列表——每个条目可以是应用组件 ID、模块 ID、类名、配置数组或匿名函数。条目解析后若组件类实现了 BootstrapInterface其bootstrap($app)方法会被调用若使用匿名函数且返回值为假如不返回实例则该条目被跳过。官方对bootstrap的使用有明确警告放太多组件会拖慢应用性能因为每个请求都要运行同一批组件应谨慎使用。Basic 模板在开发环境下把debug与gii模块加入 bootstrap 就是典型场景if (YII_ENV_DEV) { // configuration adjustments for dev environment $config[bootstrap][] debug; $config[modules][debug] yii\debug\Module; $config[bootstrap][] gii; $config[modules][gii] yii\gii\Module; }应用生命周期一次请求的完整旅程应用在响应一次请求时会经历如下生命周期对应 Application::run() 的实现流程入口脚本将应用配置作为数组加载入口脚本创建应用实例先调用preInit()配置高优先级属性如basePath随后注册错误处理器、配置应用属性再调用init()init()内部进一步调用bootstrap()运行引导组件入口脚本调用run()运行应用触发EVENT_BEFORE_REQUEST事件处理请求把请求解析为路由及参数按路由创建模块、控制器与动作对象并执行动作触发EVENT_AFTER_REQUEST事件向终端用户发送响应入口脚本接收退出状态码完成请求处理。与之配套应用在生命周期中会触发四个可挂接的事件EVENT_BEFORE_REQUEST、EVENT_AFTER_REQUEST、EVENT_BEFORE_ACTION、EVENT_AFTER_ACTION。前两者分别在应用处理请求前后触发后两者在每次执行控制器动作前后触发可通过 ActionEvent::isValid 置为false来终止动作执行beforeAction场景或通过ActionEvent::result读取/修改动作结果afterAction场景。事件按应用 → 模块 → 控制器顺序触发beforeAction而afterAction按相反顺序触发。应用组件可插拔的服务仓库应用本质上是服务定位器Service Locator承载着一组提供不同服务的应用组件。例如urlManager负责把 Web 请求路由到正确的控制器db组件提供数据库服务。每个应用组件都有唯一 ID可通过\Yii::$app-componentID访问例如\Yii::$app-db获取数据库连接、\Yii::$app-cache获取主缓存。组件在首次访问时才被实例化后续访问返回同一实例惰性加载。应用组件可以是任意对象通过配置components属性注册支持类名、配置数组、匿名函数三种写法[ components [ // register cache component using a class name cache yii\caching\ApcCache, // register db component using a configuration array db [ class yii\db\Connection, dsn mysql:hostlocalhost;dbnamedemo, username root, password , ], // register search component using an anonymous function search function () { return new app\components\SolrService; }, ], ]注意应用组件如同全局变量注册过多会让代码难以测试和维护。很多场景下创建局部组件按需使用即可。核心应用组件清单Yii 预定义了一组 ID 固定、带默认配置的核心应用组件正因它们的存在Yii 应用才能处理用户请求组件 ID类职责assetManageryii\web\AssetManager管理资源包与资源发布见 Assetsdbyii\db\Connection数据库连接配置时须同时指定类与dsn等必需属性见 Database Access ObjectserrorHandleryii\web\ErrorHandler处理 PHP 错误与异常见 Handling Errorsformatteryii\i18n\Formatter向用户展示数据时的格式化数字千分位、日期长格式等见 Data Formattingi18nyii\i18n\I18N消息翻译与格式化见 Internationalizationlogyii\log\Dispatcher管理日志目标见 Loggingmaileryii\swiftmailer\Mailer邮件撰写与发送见 Mailingresponseyii\web\Response表示发送给用户的响应见 Responsesrequestyii\web\Request表示接收到的用户请求见 Requestssessionyii\web\Session会话信息仅 Web 应用可用见 Sessions and CookiesurlManageryii\web\UrlManagerURL 解析与创建见 Routing and URL Creationuseryii\web\User用户认证信息仅 Web 应用可用见 Authenticationviewyii\web\View视图渲染见 Views模块Modules自包含的迷你应用模块是自包含的软件单元内部包含模型、视图、控制器及其它支撑组件常被视为迷你应用。与应用的差别在于模块不能独立部署必须寄居于应用之中。目录结构与模块类模块组织为一个目录即模块的basePath内部结构与应用类似forum/ Module.php the module class file controllers/ containing controller class files DefaultController.php the default controller class file models/ containing model class files views/ containing controller view and layout files layouts/ containing layout view files default/ containing view files for DefaultController index.php the index view file每个模块必须有唯一的模块类继承yii\base\Module位于模块basePath根目录下且可自动加载。模块被访问时创建唯一实例用于在模块代码间共享数据与组件namespace app\modules\forum; class Module extends \yii\base\Module { public function init() { parent::init(); $this-params[foo] bar; // ... other initialization code ... } }若init()初始化代码较多可用\Yii::configure($this, require __DIR__ . /config.php)从配置文件加载配置内容与应用配置结构类似可含components与params。在模块中组织 MVC控制器按惯例放在模块类命名空间的controllers子命名空间下如app\modules\forum\controllers\PostController文件位于模块basePath/controllers目录。可通过配置 Module::controllerNamespace 自定义命名空间外的控制器可用controllerMap接入与应用级用法一致。视图放在模块basePath/views目录下控制器渲染的视图位于views/ControllerID。模块可设置自己的layout默认放在views/layouts未配置则沿用应用的布局。控制台命令模块可在控制台模式下暴露命令。做法是在模块init()中检测Yii::$app instanceof \yii\console\Application时把controllerNamespace指向命令命名空间如app\modules\forum\commands之后即可用yii module_id/command/sub_command调用。使用、访问与嵌套在应用配置中列出模块即可启用[ modules [ forum [ class app\modules\forum\Module, // ... other configurations for the module ... ], ], ]模块内控制器的路由以模块 ID 开头forum/post/index表示forum模块中post控制器的index动作路由只含模块 ID 时由Module::defaultRoute默认default决定因此路由forum表示该模块的default控制器。模块 URL 规则应在urlManager解析请求parseRequest()之前、即引导阶段添加init()中无效因为模块初始化晚于路由处理并建议用yii\web\GroupUrlRule包裹。获取模块实例有三种方式MyModuleClass::getInstance()当前请求的模块实例、\Yii::$app-getModule(forum)已知模块 ID、\Yii::$app-controller-module当前控制器所属模块。拿到实例后可访问其参数与组件如$module-params[maxPostCount]。模块支持无限层级嵌套子模块声明在父模块的modules属性中嵌套模块内控制器的路由需包含所有祖先模块 ID如forum/admin/dashboard/index。自 2.0.13 起模块支持服务定位器的树遍历模块开发者应优先使用$module-get(db)而非Yii::$app-get(db)这样模块使用者可以为模块指定独立的组件配置例如为模块配置带module_表前缀的独立db组件。最佳实践模块最适合大型应用中可按功能组划分的场景每个功能组由专人/团队开发维护用户管理、评论管理等通用功能也可做成模块以便跨项目复用。过滤器Filters动作前后的钩子过滤器是在控制器动作运行前后执行的对象。例如访问控制过滤器在动作前检查当前用户是否有权访问内容压缩过滤器在动作后压缩响应内容再发送。过滤器由前置过滤pre-filter与后置过滤post-filter组成。使用过滤器过滤器本质上是特殊形态的行为Behaviors因此用法与行为一致——在控制器中重写behaviors()方法声明public function behaviors() { return [ [ class yii\filters\HttpCache, only [index, view], lastModified function ($action, $params) { $q new \yii\db\Query(); return $q-from(user)-max(updated_at); }, ], ]; }默认情况下控制器声明的过滤器作用于该控制器所有动作可用only限定、except排除。过滤器也可声明在模块或应用中此时作用于其下全部控制器动作注意此时only/except中应使用路由而非动作 ID。多个过滤器叠加时按如下顺序执行前置阶段按应用 → 模块 → 控制器顺序应用任一过滤器取消执行则其后过滤器含后置不再运行动作通过前置过滤后执行后置阶段按控制器 → 模块 → 应用的逆序应用。创建自定义过滤器继承yii\base\ActionFilter并重写beforeAction()和/或afterAction()即可。beforeAction()返回false将跳过后续过滤器并取消动作执行。下面的例子记录动作执行耗时namespace app\components; use Yii; use yii\base\ActionFilter; class ActionTimeFilter extends ActionFilter { private $_startTime; public function beforeAction($action) { $this-_startTime microtime(true); return parent::beforeAction($action); } public function afterAction($action, $result) { $time microtime(true) - $this-_startTime; Yii::debug(Action {$action-uniqueId} spent $time second.); return parent::afterAction($action, $result); } }内置核心过滤器Yii 在yii\filters命名空间下提供了丰富的内置过滤器实现类可在 framework/filters/ 目录中查阅AccessControl基于规则集合的简单访问控制按顺序匹配第一条规则决定允许/拒绝规则可用roles如表示已认证用户、IP、动作等方法匹配。无规则匹配时默认拒绝访问。认证方法过滤器yii\filters\auth命名空间如HttpBasicAuth、HttpBearerAuth、QueryParamAuth等常用于 RESTful API 认证需身份类实现findIdentityByAccessToken()。ContentNegotiator支持响应格式协商与应用语言协商通过GET参数和Accept头决定也可作为引导组件在应用生命周期早期生效见 structure-applications.md。HttpCache利用Last-Modified与ETag头实现客户端缓存。PageCache服务端整页缓存支持duration时长、dependency依赖如基于DbDependency的 SQL 变更检测与variations如按语言缓存不同版本。RateLimiter基于漏桶算法的限流器主要用于 RESTful API。VerbFilter校验请求的 HTTP 方法是否允许不允许时抛出 405 异常。Cors跨域资源共享过滤器应放在认证/授权过滤器之前以保证 CORS 头始终发送可通过cors属性按动作精细调优Origin、Access-Control-Request-Method、Access-Control-Request-Headers、Access-Control-Allow-Credentials、Access-Control-Max-Age默认 86400等头。小部件Widgets视图中的可复用积木小部件是可嵌入视图的对象可能包含控制器逻辑能在不同视图中复用是构建视图的积木。Yii 内置了大量实用小部件实现类位于 framework/widgets/例如ActiveForm与ActiveField生成带模型绑定与验证的表单Breadcrumbs面包屑导航LinkPager/ListView/GridView分页与数据列表/表格展示Menu菜单DetailView单条记录的键值展示Block/ContentDecorator/FragmentCache视图内容装饰与片段缓存。小部件的使用方式以表单为例见 structure-views.md?php $form ActiveForm::begin(); ? ? $form-field($model, username) ? ? $form-field($model, password)-passwordInput() ? ? Html::submitButton(Login) ? ?php ActiveForm::end(); ?小部件通常继承yii\base\Widget通过init()初始化属性、run()渲染输出。自定义小部件时可调用$this-render()渲染关联视图视图默认放在小部件类文件所在目录的views子目录下。一张图看懂整体架构回顾开篇的静态结构图与以上各节可以总结出 Yii 2 应用结构的两条主线启动链入口脚本index.php→ 加载配置 → 创建应用实例 → 引导组件/模块 → 解析路由 → 创建控制器与动作 → 执行动作 → 发送响应。组合链应用聚合模块与应用组件控制器包含过滤器、模型与视图视图内嵌小部件并注册资源包Asset Bundles。过滤器贯穿请求前/后小部件复用视图逻辑资源包统一管理 CSS/JS。进阶阅读路线本文是结构系列的总览以下文档可帮助你把各个部件落到实际编码中MVC 三件套Models属性、场景、校验、批量赋值、数据导出、Views渲染、布局、嵌套布局、块、Controllers动作、路由、动作参数、控制器生命周期运行时基础Runtime Routing、Requests、Responses、Runtime Bootstrapping组件机制Components、Service Locator、Configurations、Behaviors实战延伸Widgets、Assets、Extensions、RESTful Web Services。动手验证建议在本地完成 Start Installation 后打开 Basic 模板的web/index.php对照本文入口脚本一节、config/web.php对照应用配置与bootstrap一节再用 Gii 生成一个 CRUD 并跟踪其控制器、模型、视图与过滤器声明即可把本文的静态结构图转化为切身的运行时体验。赞分享后端Web框架【免费下载链接】yii2Yii 2: The Fast, Secure and Professional PHP Framework项目地址https://gitcode.com/gh_mirrors/yi/yii2点击查看免费下载相关推荐Yii 2 应用结构全景解析从 MVC 骨架到入口脚本、应用组件、模块与过滤器Yii 2 应用结构全景解析从 MVC 骨架到入口脚本、应用组件、模块与过滤器 本文以 Yii 2 官方指南的应用结构总览章节为骨架系统梳理 Yii 2后端Web框架Yii 2 应用结构详解从 MVC 架构到六大核心组成实体Yii 2 应用结构详解从 MVC 架构到六大核心组成实体 Yii 2 框架将整个应用按照经典的 model view controllerMVC架构模式后端Web框架Yii 2 应用结构全景MVC 架构与六大核心组成实体详解Yii 2 应用结构全景MVC 架构与六大核心组成实体详解 本文基于 Yii 2 官方指南的《应用结构总览》 docs/guide pl/structure后端Web框架上一篇LEDE项目常见问题解决方案下一篇Leptonica 项目常见问题解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
后端Web框架【免费下载链接】yii2Yii 2: The Fast, Secure and Professional PHP Framework项目地址https://gitcode.com/gh_mirrors/yi/yii2点击查看免费下载Yii 2 框架基于经典的模型-视图-控制器MVC架构模式组织应用但其完整应用结构远不止 MVC 三层入口脚本Entry Scripts、应用Applications、应用组件Application Components、模块Modules、过滤器Filters与小部件Widgets共同构成了一个完整、可扩展的应用体系。本文以 structure-overview.md 为骨架结合框架源码逐层拆解 Yii 2 的静态应用结构帮助你建立对应用全局地图的清晰认知并为后续阅读 MVC 各层、路由、缓存与 REST 开发文档打下基础。Yii 应用的静态结构入口脚本启动应用应用聚合模块、应用组件与控制器控制器再协调模型、视图、过滤器完成请求处理图源docs/guide/images/application-structure.pngMVC 模式应用组织的基石Yii 应用按照 模型-视图-控制器MVC 架构模式进行组织三者各司其职模型Models代表数据、业务逻辑与规则。模型是应用处理数据的核心对象通常通过继承yii\base\Model或其子类创建。视图Views模型在输出端的呈现形式。视图负责把模型数据渲染成用户可见的 HTML 或其他格式。控制器Controllers接收输入并将输入转化为对模型和视图的命令。控制器是请求处理流程的调度中心。三者的协作关系在框架源码中有明确体现控制器在 actionView() 中通过Post::findOne($id)加载模型再调用$this-render(view, [model $model])将模型注入视图在 actionCreate() 中则先$model-load(Yii::$app-request-post())接收用户输入、$model-save()保存数据成功后重定向、失败则渲染表单视图。这一控制器取数→模型处理→视图呈现的闭环正是 MVC 在 Yii 2 中的标准落地形态。设计取向Yii 官方推荐胖模型、瘦控制器Fat Models, Thin Controllers。模型是业务数据、规则与逻辑的集中地而控制器应当保持精简每个 action 只包含少量协调性代码。六大核心实体MVC 之外的架构部件除了 MVC 三要素Yii 应用还包含以下六类核心实体它们共同支撑起完整的应用骨架实体作用关键类 / 文档入口脚本Entry Scripts用户可直接访问的 PHP 脚本负责启动一次请求处理周期yii\web\Application、structure-entry-scripts.md应用Applications全局可访问的对象管理应用组件并协调它们完成请求yii\base\Application、structure-applications.md应用组件Application Components注册在应用上的对象为处理请求提供各类服务yii\base\Application::$components、structure-application-components.md模块Modules自包含的软件单元内部拥有完整的 MVC 结构应用可由多个模块组成yii\base\Module、structure-modules.md过滤器Filters在控制器处理每个请求前后被调用的代码yii\base\ActionFilter、structure-filters.md小部件Widgets可嵌入视图的对象可能包含控制器逻辑可在不同视图中复用yii\base\Widget、structure-widgets.md如上图所示这些实体之间存在清晰的层级与包含关系入口脚本 1:1 关联应用应用可以聚合 0..n 个模块、0..n 个应用组件且必须包含至少 1 个控制器控制器包含过滤器、视图与模型视图内部又可以嵌入小部件并注册资源包Asset Bundles。下面逐一深入。入口脚本请求周期的起点入口脚本是应用引导bootstrapping过程的第一步。无论 Web 应用还是控制台应用都只有一个入口脚本最终用户通过请求入口脚本来实例化应用对象并把请求转交给它。Web 应用入口脚本必须存放在 Web 可访问目录下通常命名为index.php控制台应用入口脚本通常存放在应用根目录下、命名为yii无.php后缀并设置为可执行以便通过./yii route [arguments] [options]运行控制台命令。入口脚本的核心工作可归纳为六步定义全局常量注册 Composer 自动加载器引入Yii类文件加载应用配置创建并配置应用实例调用yii\base\Application::run()处理传入请求。Basic 项目模板的 Web 入口脚本完整代码如下?php defined(YII_DEBUG) or define(YII_DEBUG, true); defined(YII_ENV) or define(YII_ENV, dev); // register Composer autoloader require __DIR__ . /../vendor/autoload.php; // include Yii class file require __DIR__ . /../vendor/yiisoft/yii2/Yii.php; // load application configuration $config require __DIR__ . /../config/web.php; // create, configure and run application (new yii\web\Application($config))-run();控制台入口脚本与之类似但以#!/usr/bin/env php开头、使用yii\console\Application并通过exit($exitCode)把运行退出码返回给操作系统#!/usr/bin/env php ?php defined(YII_DEBUG) or define(YII_DEBUG, true); defined(YII_ENV) or define(YII_ENV, dev); // register Composer autoloader require __DIR__ . /vendor/autoload.php; // include Yii class file require __DIR__ . /vendor/yiisoft/yii2/Yii.php; // load application configuration $config require __DIR__ . /config/console.php; $application new yii\console\Application($config); $exitCode $application-run(); exit($exitCode);全局常量调试与环境的开关入口脚本是定义全局常量的最佳位置。Yii 支持以下三个关键常量常量含义默认值YII_DEBUG是否处于调试模式开启后保留更多日志信息异常时展示详细调用栈仅建议开发环境开启falseYII_ENV应用运行环境如dev/prod详见 ConfigurationsprodYII_ENABLE_ERROR_HANDLER是否启用 Yii 内置的错误处理器true定义常量时常用defined(YII_DEBUG) or define(YII_DEBUG, true);这种简洁写法等价于if (!defined(YII_DEBUG)) { define(YII_DEBUG, true); }。常量定义必须放在入口脚本最开头以便在引入其他 PHP 文件时生效。应用Application全局协调者每个 Yii 应用系统包含唯一一个应用对象它在入口脚本中被创建并可通过\Yii::$app表达式全局访问。Yii 提供两种应用类型处理 Web 请求的 yii\web\Application 和处理控制台命令的 yii\console\Application。应用配置一切初始化的源头入口脚本创建应用时会加载一份配置并应用到应用对象上。由于应用配置通常非常复杂一般保存在配置文件中如web.phprequire __DIR__ . /../vendor/autoload.php; require __DIR__ . /../vendor/yiisoft/yii2/Yii.php; // load application configuration $config require __DIR__ . /../config/web.php; // instantiate and configure the application (new yii\web\Application($config))-run();必配属性id 与 basePath任何应用都至少需要配置两个属性id应用的唯一标识主要用于程序内部使用推荐仅使用字母数字字符以保证最佳互操作性。basePath应用根目录包含全部受保护源码models、views、controllers等 MVC 子目录。可配置为目录路径或路径别名对应目录必须存在否则抛出异常路径会经realpath()规范化。Yii 会基于它预定义app别名并由此推导出运行目录等其它重要路径如app/runtime。重要属性速览除必配属性外以下属性在不同应用间差异较大通常需要显式配置属性作用典型配置aliases以数组形式定义路径别名aliases [name1 path/to/path1]bootstrap指定应在引导过程中运行的组件列表bootstrap [log, debug]catchAllWeb 专用让一个指定控制器动作接管所有请求常用于维护模式catchAll [offline/notice, param1 value1]components注册应用组件最重要的属性components [cache [class yii\caching\FileCache]]controllerMap将控制器 ID 映射到任意控制器类突破命名约定限制controllerMap [account app\controllers\UserController]controllerNamespace控制器类所在默认命名空间默认app\controllerscontrollerNamespace app\controllerslanguage应用向用户展示内容所用的语言默认enlanguage zh-CNmodules应用包含的模块列表modules [booking app\modules\booking\BookingModule]name应用名称用于展示无需唯一name My Appparams全局可访问的应用参数数组params [thumbnail.size [128, 128]]sourceLanguage应用代码书写语言默认en-USsourceLanguage en-UStimeZone设置 PHP 运行时默认时区等价于date_default_timezone_set()timeZone America/Los_Angelesversion应用版本号默认1.0version 2.0.0另有按约定即可、通常无需改动但可打破约定的实用属性charset默认UTF-8、defaultRouteWeb 默认site控制台默认help、extensions默认取自vendor/yiisoft/extensions.php、layout默认main、layoutPath默认app/views/layouts、runtimePath默认app/runtime必须可写且需防止终端用户访问、viewPath默认app/views、vendorPath默认app/vendor、以及控制台专用的enableCoreCommands默认true。bootstrap 属性的底层实现bootstrap属性值得特别关注。从 Application::bootstrap() 源码可以看到其完整执行逻辑首先加载vendor/yiisoft/extensions.php中声明的扩展别名并实例化扩展引导类然后遍历$this-bootstrap列表——每个条目可以是应用组件 ID、模块 ID、类名、配置数组或匿名函数。条目解析后若组件类实现了 BootstrapInterface其bootstrap($app)方法会被调用若使用匿名函数且返回值为假如不返回实例则该条目被跳过。官方对bootstrap的使用有明确警告放太多组件会拖慢应用性能因为每个请求都要运行同一批组件应谨慎使用。Basic 模板在开发环境下把debug与gii模块加入 bootstrap 就是典型场景if (YII_ENV_DEV) { // configuration adjustments for dev environment $config[bootstrap][] debug; $config[modules][debug] yii\debug\Module; $config[bootstrap][] gii; $config[modules][gii] yii\gii\Module; }应用生命周期一次请求的完整旅程应用在响应一次请求时会经历如下生命周期对应 Application::run() 的实现流程入口脚本将应用配置作为数组加载入口脚本创建应用实例先调用preInit()配置高优先级属性如basePath随后注册错误处理器、配置应用属性再调用init()init()内部进一步调用bootstrap()运行引导组件入口脚本调用run()运行应用触发EVENT_BEFORE_REQUEST事件处理请求把请求解析为路由及参数按路由创建模块、控制器与动作对象并执行动作触发EVENT_AFTER_REQUEST事件向终端用户发送响应入口脚本接收退出状态码完成请求处理。与之配套应用在生命周期中会触发四个可挂接的事件EVENT_BEFORE_REQUEST、EVENT_AFTER_REQUEST、EVENT_BEFORE_ACTION、EVENT_AFTER_ACTION。前两者分别在应用处理请求前后触发后两者在每次执行控制器动作前后触发可通过 ActionEvent::isValid 置为false来终止动作执行beforeAction场景或通过ActionEvent::result读取/修改动作结果afterAction场景。事件按应用 → 模块 → 控制器顺序触发beforeAction而afterAction按相反顺序触发。应用组件可插拔的服务仓库应用本质上是服务定位器Service Locator承载着一组提供不同服务的应用组件。例如urlManager负责把 Web 请求路由到正确的控制器db组件提供数据库服务。每个应用组件都有唯一 ID可通过\Yii::$app-componentID访问例如\Yii::$app-db获取数据库连接、\Yii::$app-cache获取主缓存。组件在首次访问时才被实例化后续访问返回同一实例惰性加载。应用组件可以是任意对象通过配置components属性注册支持类名、配置数组、匿名函数三种写法[ components [ // register cache component using a class name cache yii\caching\ApcCache, // register db component using a configuration array db [ class yii\db\Connection, dsn mysql:hostlocalhost;dbnamedemo, username root, password , ], // register search component using an anonymous function search function () { return new app\components\SolrService; }, ], ]注意应用组件如同全局变量注册过多会让代码难以测试和维护。很多场景下创建局部组件按需使用即可。核心应用组件清单Yii 预定义了一组 ID 固定、带默认配置的核心应用组件正因它们的存在Yii 应用才能处理用户请求组件 ID类职责assetManageryii\web\AssetManager管理资源包与资源发布见 Assetsdbyii\db\Connection数据库连接配置时须同时指定类与dsn等必需属性见 Database Access ObjectserrorHandleryii\web\ErrorHandler处理 PHP 错误与异常见 Handling Errorsformatteryii\i18n\Formatter向用户展示数据时的格式化数字千分位、日期长格式等见 Data Formattingi18nyii\i18n\I18N消息翻译与格式化见 Internationalizationlogyii\log\Dispatcher管理日志目标见 Loggingmaileryii\swiftmailer\Mailer邮件撰写与发送见 Mailingresponseyii\web\Response表示发送给用户的响应见 Responsesrequestyii\web\Request表示接收到的用户请求见 Requestssessionyii\web\Session会话信息仅 Web 应用可用见 Sessions and CookiesurlManageryii\web\UrlManagerURL 解析与创建见 Routing and URL Creationuseryii\web\User用户认证信息仅 Web 应用可用见 Authenticationviewyii\web\View视图渲染见 Views模块Modules自包含的迷你应用模块是自包含的软件单元内部包含模型、视图、控制器及其它支撑组件常被视为迷你应用。与应用的差别在于模块不能独立部署必须寄居于应用之中。目录结构与模块类模块组织为一个目录即模块的basePath内部结构与应用类似forum/ Module.php the module class file controllers/ containing controller class files DefaultController.php the default controller class file models/ containing model class files views/ containing controller view and layout files layouts/ containing layout view files default/ containing view files for DefaultController index.php the index view file每个模块必须有唯一的模块类继承yii\base\Module位于模块basePath根目录下且可自动加载。模块被访问时创建唯一实例用于在模块代码间共享数据与组件namespace app\modules\forum; class Module extends \yii\base\Module { public function init() { parent::init(); $this-params[foo] bar; // ... other initialization code ... } }若init()初始化代码较多可用\Yii::configure($this, require __DIR__ . /config.php)从配置文件加载配置内容与应用配置结构类似可含components与params。在模块中组织 MVC控制器按惯例放在模块类命名空间的controllers子命名空间下如app\modules\forum\controllers\PostController文件位于模块basePath/controllers目录。可通过配置 Module::controllerNamespace 自定义命名空间外的控制器可用controllerMap接入与应用级用法一致。视图放在模块basePath/views目录下控制器渲染的视图位于views/ControllerID。模块可设置自己的layout默认放在views/layouts未配置则沿用应用的布局。控制台命令模块可在控制台模式下暴露命令。做法是在模块init()中检测Yii::$app instanceof \yii\console\Application时把controllerNamespace指向命令命名空间如app\modules\forum\commands之后即可用yii module_id/command/sub_command调用。使用、访问与嵌套在应用配置中列出模块即可启用[ modules [ forum [ class app\modules\forum\Module, // ... other configurations for the module ... ], ], ]模块内控制器的路由以模块 ID 开头forum/post/index表示forum模块中post控制器的index动作路由只含模块 ID 时由Module::defaultRoute默认default决定因此路由forum表示该模块的default控制器。模块 URL 规则应在urlManager解析请求parseRequest()之前、即引导阶段添加init()中无效因为模块初始化晚于路由处理并建议用yii\web\GroupUrlRule包裹。获取模块实例有三种方式MyModuleClass::getInstance()当前请求的模块实例、\Yii::$app-getModule(forum)已知模块 ID、\Yii::$app-controller-module当前控制器所属模块。拿到实例后可访问其参数与组件如$module-params[maxPostCount]。模块支持无限层级嵌套子模块声明在父模块的modules属性中嵌套模块内控制器的路由需包含所有祖先模块 ID如forum/admin/dashboard/index。自 2.0.13 起模块支持服务定位器的树遍历模块开发者应优先使用$module-get(db)而非Yii::$app-get(db)这样模块使用者可以为模块指定独立的组件配置例如为模块配置带module_表前缀的独立db组件。最佳实践模块最适合大型应用中可按功能组划分的场景每个功能组由专人/团队开发维护用户管理、评论管理等通用功能也可做成模块以便跨项目复用。过滤器Filters动作前后的钩子过滤器是在控制器动作运行前后执行的对象。例如访问控制过滤器在动作前检查当前用户是否有权访问内容压缩过滤器在动作后压缩响应内容再发送。过滤器由前置过滤pre-filter与后置过滤post-filter组成。使用过滤器过滤器本质上是特殊形态的行为Behaviors因此用法与行为一致——在控制器中重写behaviors()方法声明public function behaviors() { return [ [ class yii\filters\HttpCache, only [index, view], lastModified function ($action, $params) { $q new \yii\db\Query(); return $q-from(user)-max(updated_at); }, ], ]; }默认情况下控制器声明的过滤器作用于该控制器所有动作可用only限定、except排除。过滤器也可声明在模块或应用中此时作用于其下全部控制器动作注意此时only/except中应使用路由而非动作 ID。多个过滤器叠加时按如下顺序执行前置阶段按应用 → 模块 → 控制器顺序应用任一过滤器取消执行则其后过滤器含后置不再运行动作通过前置过滤后执行后置阶段按控制器 → 模块 → 应用的逆序应用。创建自定义过滤器继承yii\base\ActionFilter并重写beforeAction()和/或afterAction()即可。beforeAction()返回false将跳过后续过滤器并取消动作执行。下面的例子记录动作执行耗时namespace app\components; use Yii; use yii\base\ActionFilter; class ActionTimeFilter extends ActionFilter { private $_startTime; public function beforeAction($action) { $this-_startTime microtime(true); return parent::beforeAction($action); } public function afterAction($action, $result) { $time microtime(true) - $this-_startTime; Yii::debug(Action {$action-uniqueId} spent $time second.); return parent::afterAction($action, $result); } }内置核心过滤器Yii 在yii\filters命名空间下提供了丰富的内置过滤器实现类可在 framework/filters/ 目录中查阅AccessControl基于规则集合的简单访问控制按顺序匹配第一条规则决定允许/拒绝规则可用roles如表示已认证用户、IP、动作等方法匹配。无规则匹配时默认拒绝访问。认证方法过滤器yii\filters\auth命名空间如HttpBasicAuth、HttpBearerAuth、QueryParamAuth等常用于 RESTful API 认证需身份类实现findIdentityByAccessToken()。ContentNegotiator支持响应格式协商与应用语言协商通过GET参数和Accept头决定也可作为引导组件在应用生命周期早期生效见 structure-applications.md。HttpCache利用Last-Modified与ETag头实现客户端缓存。PageCache服务端整页缓存支持duration时长、dependency依赖如基于DbDependency的 SQL 变更检测与variations如按语言缓存不同版本。RateLimiter基于漏桶算法的限流器主要用于 RESTful API。VerbFilter校验请求的 HTTP 方法是否允许不允许时抛出 405 异常。Cors跨域资源共享过滤器应放在认证/授权过滤器之前以保证 CORS 头始终发送可通过cors属性按动作精细调优Origin、Access-Control-Request-Method、Access-Control-Request-Headers、Access-Control-Allow-Credentials、Access-Control-Max-Age默认 86400等头。小部件Widgets视图中的可复用积木小部件是可嵌入视图的对象可能包含控制器逻辑能在不同视图中复用是构建视图的积木。Yii 内置了大量实用小部件实现类位于 framework/widgets/例如ActiveForm与ActiveField生成带模型绑定与验证的表单Breadcrumbs面包屑导航LinkPager/ListView/GridView分页与数据列表/表格展示Menu菜单DetailView单条记录的键值展示Block/ContentDecorator/FragmentCache视图内容装饰与片段缓存。小部件的使用方式以表单为例见 structure-views.md?php $form ActiveForm::begin(); ? ? $form-field($model, username) ? ? $form-field($model, password)-passwordInput() ? ? Html::submitButton(Login) ? ?php ActiveForm::end(); ?小部件通常继承yii\base\Widget通过init()初始化属性、run()渲染输出。自定义小部件时可调用$this-render()渲染关联视图视图默认放在小部件类文件所在目录的views子目录下。一张图看懂整体架构回顾开篇的静态结构图与以上各节可以总结出 Yii 2 应用结构的两条主线启动链入口脚本index.php→ 加载配置 → 创建应用实例 → 引导组件/模块 → 解析路由 → 创建控制器与动作 → 执行动作 → 发送响应。组合链应用聚合模块与应用组件控制器包含过滤器、模型与视图视图内嵌小部件并注册资源包Asset Bundles。过滤器贯穿请求前/后小部件复用视图逻辑资源包统一管理 CSS/JS。进阶阅读路线本文是结构系列的总览以下文档可帮助你把各个部件落到实际编码中MVC 三件套Models属性、场景、校验、批量赋值、数据导出、Views渲染、布局、嵌套布局、块、Controllers动作、路由、动作参数、控制器生命周期运行时基础Runtime Routing、Requests、Responses、Runtime Bootstrapping组件机制Components、Service Locator、Configurations、Behaviors实战延伸Widgets、Assets、Extensions、RESTful Web Services。动手验证建议在本地完成 Start Installation 后打开 Basic 模板的web/index.php对照本文入口脚本一节、config/web.php对照应用配置与bootstrap一节再用 Gii 生成一个 CRUD 并跟踪其控制器、模型、视图与过滤器声明即可把本文的静态结构图转化为切身的运行时体验。赞分享后端Web框架【免费下载链接】yii2Yii 2: The Fast, Secure and Professional PHP Framework项目地址https://gitcode.com/gh_mirrors/yi/yii2点击查看免费下载相关推荐Yii 2 应用结构全景解析从 MVC 骨架到入口脚本、应用组件、模块与过滤器Yii 2 应用结构全景解析从 MVC 骨架到入口脚本、应用组件、模块与过滤器 本文以 Yii 2 官方指南的应用结构总览章节为骨架系统梳理 Yii 2后端Web框架Yii 2 应用结构详解从 MVC 架构到六大核心组成实体Yii 2 应用结构详解从 MVC 架构到六大核心组成实体 Yii 2 框架将整个应用按照经典的 model view controllerMVC架构模式后端Web框架Yii 2 应用结构全景MVC 架构与六大核心组成实体详解Yii 2 应用结构全景MVC 架构与六大核心组成实体详解 本文基于 Yii 2 官方指南的《应用结构总览》 docs/guide pl/structure后端Web框架上一篇LEDE项目常见问题解决方案下一篇Leptonica 项目常见问题解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
