第六章 框架启动与运行机制
框架启动与运行机制是 WangStruct Framework 从程序结构进入实际运行的关键环节。前面几章已经确定了框架的总体架构、目录组织方式以及核心对象与接口规范,本章进一步解决这些程序如何被加载、初始化、组织和执行的问题。
一个能够实际使用的开发框架,不能只有目录结构、类定义和接口说明,还必须具备完整的启动入口和运行流程。开发者建立应用程序后,需要有一个明确的入口文件,使系统能够按照既定顺序加载运行环境、读取配置、初始化核心对象、注册组件、加载应用,并最终执行用户请求。
WangStruct Framework 的启动机制应当保持结构清晰、执行顺序明确和功能边界稳定。框架启动程序只负责建立运行环境和组织程序调用,不应将具体应用业务直接写入启动文件。不同应用可以使用相同的框架启动机制,但根据各自的配置加载不同的组件、服务和应用程序。
本章先建立语言无关的启动与运行流程,再以 PHP 作为参考实现,说明启动文件、核心类和应用调用之间的实际关系。示例代码用于说明一种可实现的工程组织方式,不代表已有工程文件已经完成部署或测试。
6.1 框架启动机制的设计目标
WangStruct Framework 的启动机制首先需要解决程序从哪里开始运行、需要加载哪些基础资源、如何形成运行环境,以及如何将外部请求交给具体应用处理等问题。
在普通程序中,开发者可能直接通过一个主程序文件调用其他程序。但随着框架功能增加,如果所有初始化、配置读取、组件加载和业务执行都集中在同一个入口文件中,程序会逐渐失去清晰的结构。
因此,框架需要建立独立的启动机制,将程序启动、环境初始化、对象注册和应用执行分为不同阶段。
启动机制应当满足以下要求。
第一,入口统一。 无论应用是 Web 系统、智能服务程序还是其他类型的应用,都应当有明确的启动入口。不同运行环境可以设置不同入口,但最终应当进入统一的框架运行机制。
第二,初始化有序。 配置、基础服务、核心对象和功能组件应当按照依赖关系初始化,避免尚未加载的对象被提前调用。
第三,应用独立。 框架负责提供运行环境,具体应用负责处理自己的功能。启动程序不应当包含大量应用业务代码。
第四,运行方式开放。 框架既要支持用户通过浏览器提交请求,也应当支持命令行任务、后台服务、外部程序调用以及后续的智能运行任务。
第五,运行过程可控。 框架需要明确启动失败、组件加载失败、请求执行失败和正常停止等状态,不能把所有执行过程简单处理为成功或失败。
6.2 框架启动与运行的总体流程
WangStruct Framework 的启动流程可以划分为启动入口、环境加载、配置初始化、核心对象初始化、组件注册、应用加载、请求调度、程序执行和结果返回九个阶段。
这些阶段构成框架的基本运行链条。
WangStruct Framework 启动与运行流程
-
启动入口
接收 Web、命令行或其他运行环境的启动请求
-
环境加载
识别运行环境,加载必要的基础程序
-
配置初始化
读取框架配置、应用配置和运行参数
-
核心对象初始化
建立框架运行对象和对象管理机制
-
组件注册
注册当前应用需要使用的组件和服务
-
应用加载
加载应用定义、运行配置和功能入口
-
请求调度
识别请求类型,确定对应的应用处理程序
-
程序执行
调用应用对象、服务对象和组件对象完成处理
-
结果返回
整理执行结果,返回调用方并完成必要的资源清理
运行结束
上述流程不是要求每一种应用都必须执行完全相同的操作。例如,命令行任务可能不需要加载 Web 路由,后台运行程序也可能不需要按照单次请求的方式处理任务。
因此,框架应当建立统一的启动基础,并根据运行环境选择相应的调度方式。
6.3 启动入口设计
启动入口是框架运行的起点。
在 Web 应用中,浏览器请求通常首先进入 Web 服务器,再由服务器将请求交给 PHP 等运行环境处理。在命令行应用中,启动入口则由用户或系统直接执行。
WangStruct Framework 应当将启动入口与具体应用处理程序分离。
6.3.1 Web 启动入口
以 PHP 参考实现为例,可以将 Web 入口设置为:
public/
index.php
浏览器访问应用时,Web 服务器将请求交给 index.php。
入口文件不直接处理用户业务,而是负责加载框架启动程序,并将请求交给框架运行对象。
示例:
<?php
require dirname(__DIR__) . '/bootstrap.php';
$application = WangStruct\Core\Framework::create();
$response = $application->handle(
WangStruct\Http\Request::fromGlobals()
);
$response->send();
这段代码展示了入口文件的基本职责:
-
加载框架启动程序。
-
创建框架运行对象。
-
将当前 Web 请求转换为框架能够处理的请求对象。
-
调用框架处理方法。
-
将处理结果发送给浏览器。
其中,Framework::create()、Request::fromGlobals()、handle() 和 send() 是本章拟定的参考接口名称,后续需要按照正式接口契约实现,不能将其误认为现有程序已经具备的方法。
6.3.2 命令行启动入口
除了 Web 应用,框架还应当支持命令行启动。
例如:
bin/
console.php
命令行入口可以用于执行系统初始化、数据处理、任务调度、组件检查和后台维护等操作。
示例:
<?php
require dirname(__DIR__) . '/bootstrap.php';
$application = WangStruct\Core\Framework::create();
$application->runCommand(
$argv
);
Web 入口与命令行入口的区别在于请求来源和结果输出方式,而不是必须使用两套完全独立的框架核心。
两者可以共享环境加载、配置读取、核心对象初始化和组件注册机制,然后进入各自对应的运行调度程序。
6.3.3 其他运行入口
随着框架应用范围扩大,还可以增加其他启动方式,例如:
-
后台服务入口。
-
定时任务入口。
-
消息队列消费者入口。
-
外部设备通信入口。
-
智能任务运行入口。
这些入口应当遵循统一的初始化规范,但不必强制经过 Web 请求和路由处理过程。
对于需要长期运行的后台服务,还需要增加运行状态监控、任务循环、异常恢复和优雅停止机制。这些功能应由相应的运行管理模块实现,而不是全部放进公共入口文件。
6.4 环境加载机制
环境加载是启动程序执行的第一个基础阶段。
框架需要在正式初始化之前识别当前运行环境,并加载必要的基础程序。
环境信息可能包括:
-
当前运行模式。
-
程序运行目录。
-
当前语言运行环境。
-
框架版本与应用版本。
-
配置文件位置。
-
日志和运行数据目录。
-
当前运行入口类型。
例如,一个应用可能存在开发、测试和生产三种运行环境。不同环境可以使用不同的数据库连接、日志级别和错误显示方式,但不能因此改变应用本身的核心业务逻辑。
6.4.1 环境变量
环境变量可以用于保存部署环境相关的配置,例如数据库连接参数、运行模式和外部服务地址。
这些信息不应直接写入公共启动程序,也不应将密钥和密码放入公开访问的程序目录。
框架可以通过统一环境读取接口获取相关配置,再交给配置管理模块处理。
6.4.2 基础程序加载
环境识别之后,需要加载框架运行所依赖的基础程序。
以 PHP 为例,可能包括:
-
自动加载程序。
-
基础函数文件。
-
配置读取程序。
-
核心类定义。
-
必要的运行环境检查。
其中,自动加载程序负责根据命名空间或类名查找对应文件,环境检查负责判断当前 PHP 版本、必要扩展和文件权限是否满足运行要求。
基础程序加载应当尽量精简,不应在启动阶段无条件加载所有应用文件和全部扩展。
6.4.3 环境加载示例
可以将环境加载集中在 bootstrap.php 中:
<?php
define('WANGSTRUCT_ROOT', __DIR__);
require WANGSTRUCT_ROOT . '/vendor/autoload.php';
$environment = getenv('WANGSTRUCT_ENV');
if (!$environment) {
$environment = 'production';
}
该示例假定 PHP 参考实现使用 Composer 自动加载,并且已经安装相关依赖。
实际开发时还需要对环境名称进行校验,并确定环境变量缺失时的处理策略。对于生产环境,不应通过简单设置默认值掩盖重要配置缺失的问题。
6.5 配置读取与初始化
配置系统负责为框架和应用提供运行所需要的参数。
配置不仅包括数据库连接信息,还可能涉及组件加载、服务注册、路由定义、应用入口和运行限制等内容。
框架应当将配置管理与具体功能实现分离。
6.5.1 配置文件组织
结合第四章的目录设计,可以采用如下配置组织方式:
config/
framework.php
environment.php
components.php
services.php
applications.php
routes.php
各配置文件可以按照功能职责组织:
| 配置文件 | 主要职责 |
|---|---|
| framework.php | 框架基础运行参数 |
| environment.php | 环境相关设置 |
| components.php | 组件注册与加载配置 |
| services.php | 服务注册配置 |
| applications.php | 应用加载配置 |
| routes.php | Web 路由配置 |
这是一种参考组织方式,不要求所有应用必须使用全部配置文件。对于不需要路由的命令行程序,可以不加载 routes.php。
6.5.2 配置加载顺序
配置读取应当遵循明确的优先级。
例如:
-
框架默认配置。
-
当前运行环境配置。
-
应用自身配置。
-
经授权的运行时配置。
后加载的配置是否可以覆盖前面的配置,应当由配置项的覆盖规则决定。涉及安全限制和不可覆盖参数的配置,不应允许普通应用通过任意覆盖改变其含义。
6.5.3 配置管理对象
框架可以建立统一的配置管理对象,对外提供读取配置、检查配置和获取配置集合等能力。
PHP 参考接口可以设计为:
<?php
namespace WangStruct\Core;
class ConfigManager
{
protected $config = array();
public function load($name, array $data)
{
$this->config[$name] = $data;
}
public function get($name, $default = null)
{
return isset($this->config[$name])
? $this->config[$name]
: $default;
}
}
这段代码只是一个简化的配置管理示例。它展示了配置加载和读取的基本方式,不包含配置文件解析、配置覆盖、安全校验和嵌套路径读取等完整功能。
实际实现应当根据最终配置契约补充这些能力。
6.6 核心对象初始化
完成环境和配置加载之后,框架进入核心对象初始化阶段。
这一阶段的主要任务是创建框架运行所需要的基础对象,并建立它们之间的调用关系。
核心对象初始化不能简单地理解为一次性创建所有类的实例。框架应当根据对象依赖和生命周期,确定哪些对象需要在启动时创建,哪些对象可以在第一次使用时创建。
6.6.1 框架运行对象
框架可以设置一个统一的运行对象,负责组织启动、组件注册、应用加载和请求处理等流程。
例如:
<?php
namespace WangStruct\Core;
class Framework
{
protected $config;
protected $registry;
protected $components;
protected $services;
public function __construct(
$config,
$registry,
$components,
$services
) {
$this->config = $config;
$this->registry = $registry;
$this->components = $components;
$this->services = $services;
}
}
这里通过构造参数传入运行所需对象,而不是在类内部随意创建所有依赖对象。
这种方式能够让不同实现更容易替换,也便于进行单独测试。
6.6.2 对象注册管理
框架需要能够根据名称识别和管理对象。
例如,应用需要使用某个数据处理服务时,可以通过注册管理对象获取对应服务,而不必在每个调用位置重复创建服务实例。
对象注册管理可以负责:
-
注册对象或对象创建规则。
-
根据名称查找对象。
-
检查重复注册。
-
注销对象。
-
管理必要的生命周期信息。
但对象注册管理不应成为所有业务对象的统一存储空间。只有需要被框架管理和共享调用的对象,才需要进入相应注册范围。
6.6.3 初始化依赖顺序
核心对象之间可能存在依赖关系。
例如,组件管理器需要对象注册机制,服务管理器需要能够获取组件,应用调度器则需要调用服务。
因此,初始化顺序应当根据依赖关系安排,而不是单纯按照文件名或目录顺序加载。
一种可能的初始化顺序是:
配置管理
↓
对象注册管理
↓
组件管理
↓
服务管理
↓
应用管理
↓
运行调度
这是基本依赖关系示意。实际系统中,如果某个服务不依赖组件,也可以独立初始化;如果存在循环依赖,则需要通过接口和初始化阶段重新组织依赖。
6.7 组件注册与加载
组件注册是框架将功能模块纳入运行环境的重要环节。
组件文件存在于磁盘中,并不意味着组件已经能够被应用调用。框架还需要识别组件、读取组件配置、建立对象实例,并将其注册到相应管理机制中。
6.7.1 组件注册信息
每个组件至少需要有能够识别自身的基本信息,例如:
-
组件名称。
-
组件标识。
-
组件版本。
-
接口契约版本。
-
组件入口或实现位置。
-
运行依赖。
-
必要的配置参数。
这些信息可以通过配置文件、组件描述文件或程序注册代码提供。
例如:
{
"name": "DataProcessor",
"version": "1.0.0",
"contract": "component-v1",
"entry": "WangStruct\\Components\\DataProcessor"
}
这是 PHP 参考实现中的组件描述示例。其他语言可以使用不同的模块标识方式,但应保持组件名称、版本和接口契约等基本信息的一致性。
6.7.2 组件加载过程
组件加载可以分为以下几个步骤:
-
读取组件注册信息。
-
检查组件是否存在。
-
检查组件版本和接口契约。
-
加载组件实现。
-
创建组件对象或建立调用引用。
-
注册组件。
-
执行必要的初始化。
-
标记组件当前运行状态。
如果某个组件无法加载,框架应当根据组件是否属于必需依赖决定是否继续启动。
例如,某个应用必须使用的数据处理组件加载失败时,应当阻止该应用进入正常运行状态;某个非必要扩展加载失败时,可以记录错误并允许其他不依赖该扩展的应用继续运行。
6.7.3 组件注册示例
以 PHP 参考实现为例,可以设计如下组件注册方法:
<?php
namespace WangStruct\Core;
class ComponentManager
{
protected $components = array();
public function register($name, $component)
{
if (empty($name)) {
throw new \InvalidArgumentException(
'Component name is required.'
);
}
if (isset($this->components[$name])) {
throw new \RuntimeException(
'Component already registered.'
);
}
$this->components[$name] = $component;
return true;
}
public function get($name)
{
if (!isset($this->components[$name])) {
throw new \RuntimeException(
'Component not found.'
);
}
return $this->components[$name];
}
}
该代码展示了最基本的组件注册与查询方式,尚未包含接口检查、自动实例化、生命周期管理和组件卸载等完整功能。
需要注意,组件注册对象应当符合框架正式定义的组件契约。不能仅因为一个对象被放入数组,就认为它已经成为可正常运行的框架组件。
6.8 路由加载与请求调度
路由加载主要用于 Web 应用。它负责将外部请求地址和请求方法映射到相应的应用处理程序。
请求调度则是更广泛的概念。命令行任务、消息队列任务和智能运行任务也需要调度,但它们不一定使用 URL 路由。
因此,WangStruct Framework 应当区分路由和调度:
-
路由负责识别 Web 请求对应的处理入口。
-
调度负责根据请求类型、任务类型和运行规则选择实际执行程序。
6.8.1 Web 路由定义
例如,应用可以定义:
<?php
return array(
array(
'method' => 'GET',
'path' => '/products',
'handler' => 'ProductController@index'
),
array(
'method' => 'POST',
'path' => '/products',
'handler' => 'ProductController@create'
)
);
该配置表示:
-
GET 请求
/products时调用商品列表处理方法。 -
POST 请求
/products时调用商品创建处理方法。
这只是一个路由配置示例,尚未定义完整的路由匹配器、参数提取、请求过滤和权限处理机制。
6.8.2 路由加载
启动过程中,框架根据当前应用配置读取路由定义,并交给路由管理对象处理。
路由管理对象应当完成:
-
路由配置读取。
-
路由规则检查。
-
路由注册。
-
请求方法匹配。
-
请求路径匹配。
-
动态路径参数提取。
-
处理程序识别。
路由系统不应直接执行所有业务逻辑,而应将匹配结果交给对应的控制器、服务或应用处理程序。
6.8.3 请求调度
请求调度是请求进入应用之后的程序组织过程。
以 Web 请求为例:
浏览器请求
↓
Web 入口
↓
请求对象
↓
路由匹配
↓
处理程序识别
↓
应用控制器
↓
应用服务
↓
功能组件
↓
处理结果
对于命令行任务,则可能是:
命令行参数
↓
命令解析
↓
任务识别
↓
任务调度
↓
应用服务
↓
处理结果
两种运行方式共享核心对象、配置和组件管理机制,但采用不同的请求识别和调度程序。
6.9 应用加载与运行
应用加载是框架启动与具体业务执行之间的连接环节。
框架可以运行多个不同类型的应用,但不应当在启动时将所有应用的程序全部加载并执行。
应用管理机制应当根据当前入口和运行配置,识别需要启动的应用,并建立对应的运行对象。
6.9.1 应用定义
一个应用需要具有基本的识别信息,例如:
-
应用名称。
-
应用标识。
-
应用版本。
-
应用入口。
-
运行模式。
-
所依赖的服务和组件。
这些信息可以由配置文件或应用自身的定义文件提供。
6.9.2 应用加载过程
应用加载可以按照以下顺序进行:
首先,读取应用定义信息,检查应用是否存在以及是否符合当前框架版本要求。
然后,检查应用依赖的组件和服务是否已经注册。如果缺少必需依赖,则不能将应用标记为正常运行。
接下来,创建应用运行对象,加载应用所需的处理程序和配置。
最后,将应用注册到应用管理机制,并交给相应的调度程序执行。
应用加载并不意味着立即执行全部应用功能。应用只有在接收到相应请求或任务时,才进入具体的处理过程。
6.9.3 应用执行示例
以一个商品信息应用为例,用户访问 /products 时,框架的执行过程可以表示为:
用户访问 /products
↓
Web 请求进入框架
↓
路由管理器匹配 GET /products
↓
找到 ProductController@index
↓
调用商品应用处理程序
↓
调用商品查询服务
↓
调用数据存储组件
↓
取得商品数据
↓
组织响应结果
↓
返回浏览器
这个例子主要用于说明框架启动机制如何连接到实际应用。商品查询本身属于应用功能,不应当写入框架核心类。
6.10 请求处理与结果返回
框架接收到请求后,需要将请求信息转换为应用能够处理的统一形式。
对于 Web 请求,通常需要识别请求方法、路径、查询参数、请求头和请求主体。对于命令行任务,则需要识别命令名称和参数。对于消息队列任务,需要解析消息内容及其来源。
不同请求类型可以采用不同的请求对象,但应当具有清晰的输入和输出约定。
6.10.1 请求对象
在 PHP 参考实现中,可以设计请求对象:
<?php
namespace WangStruct\Http;
class Request
{
protected $method;
protected $path;
protected $parameters;
public function __construct(
$method,
$path,
array $parameters = array()
) {
$this->method = $method;
$this->path = $path;
$this->parameters = $parameters;
}
public function getMethod()
{
return $this->method;
}
public function getPath()
{
return $this->path;
}
public function getParameters()
{
return $this->parameters;
}
}
该对象负责保存请求的基本信息,不负责执行具体业务。
真实 Web 请求还需要处理请求主体、文件上传、请求头、编码、安全过滤和参数类型转换等内容。实际开发时应根据确定的 HTTP 接口规范补充。
6.10.2 处理结果对象
应用程序执行之后,框架需要组织结果,并根据请求类型将结果交给相应输出程序。
对于 Web 请求,结果可能是 HTML、JSON 或文件内容;对于命令行任务,结果可能是文本、状态代码或任务执行报告;对于后台服务,结果也可能被写入消息队列或运行记录。
因此,框架不应将所有结果都强制转换成网页内容。
可以为 Web 参考实现设计一个响应对象:
<?php
namespace WangStruct\Http;
class Response
{
protected $statusCode;
protected $content;
public function __construct(
$content = '',
$statusCode = 200
) {
$this->content = $content;
$this->statusCode = $statusCode;
}
public function send()
{
http_response_code($this->statusCode);
echo $this->content;
}
}
该代码只是最小响应对象示例,真实实现还应处理响应头、字符编码、输出缓冲和重复发送等问题。
6.10.3 结果返回与资源清理
程序执行完成后,框架需要将结果交给正确的输出通道。
与此同时,还应根据对象生命周期和资源管理规则完成必要清理,例如关闭临时文件、释放数据库事务、结束临时任务上下文和记录运行状态。
但不能简单地在每次请求结束时销毁全部对象。对于需要长期共享的服务和组件,应由框架的生命周期管理机制决定是否保留。
6.11 框架主运行程序的组织
前面分别介绍了启动入口、环境加载、配置初始化、组件注册、路由加载和应用执行。实际工程中,需要通过一个主运行程序将这些阶段组织起来。
主运行程序不应当直接包含每一个具体功能的实现,而应当负责调用相应管理对象。
以 PHP 参考实现为例,可以将框架运行对象设计为:
<?php
namespace WangStruct\Core;
class Framework
{
protected $config;
protected $components;
protected $application;
public function __construct(
$config,
$components,
$application
) {
$this->config = $config;
$this->components = $components;
$this->application = $application;
}
public function handle($request)
{
return $this->application->handle($request);
}
public function getComponent($name)
{
return $this->components->get($name);
}
}
这里的 Framework 负责保存必要的运行对象,并提供统一的请求处理入口。
它没有直接负责读取配置文件、扫描组件目录、解析路由和查询数据库。这些工作应由各自的管理对象完成。
这样做的好处是,框架运行对象不会因为新增一种组件或一种应用功能而无限增加方法。
6.11.1 启动程序组织
在上述设计基础上,可以将 bootstrap.php 作为启动程序:
<?php
define('WANGSTRUCT_ROOT', __DIR__);
require WANGSTRUCT_ROOT . '/vendor/autoload.php';
$config = require WANGSTRUCT_ROOT . '/config/framework.php';
$configManager = new WangStruct\Core\ConfigManager();
$configManager->load('framework', $config);
$registry = new WangStruct\Core\ObjectRegistry();
$componentManager = new WangStruct\Core\ComponentManager();
$serviceManager = new WangStruct\Core\ServiceManager();
$applicationManager = new WangStruct\Core\ApplicationManager();
$framework = new WangStruct\Core\Framework(
$configManager,
$componentManager,
$applicationManager
);
这段代码展示了启动程序如何加载配置并创建核心对象。
其中 ObjectRegistry、ServiceManager 和 ApplicationManager 等类仍然属于拟定的参考设计,必须在实际工程中定义并实现。示例也尚未展示组件注册、应用加载和启动失败处理,不能直接作为完整的生产环境启动程序使用。
在正式实现中,应当进一步将对象创建过程交给专门的启动协调程序,使初始化顺序、依赖关系和异常处理能够得到统一控制。
6.12 不同运行模式的组织
WangStruct Framework 的运行目标不应仅限于 Web 网站。
对于开放式智能系统开发,框架还需要能够承载不同类型的运行任务。例如,智能服务程序可能需要持续接收请求,设备控制程序可能需要长期监听状态,智能个体可能需要根据需求动态创建任务和组织能力。
因此,框架需要将公共启动机制与具体运行模式分开。
6.12.1 Web 运行模式
Web 模式以 HTTP 请求为主要输入,通常采用请求进入、路由匹配、应用处理和响应返回的方式运行。
适合管理系统、服务平台、数据管理应用和 Web 智能服务等场景。
6.12.2 命令行运行模式
命令行模式通过参数或命令名称启动任务,不需要浏览器和 Web 路由。
适合数据处理、批量计算、定时执行和系统维护。
6.12.3 后台服务运行模式
后台服务通常需要持续运行,能够不断接收外部消息或执行任务。
这类运行模式需要增加进程管理、运行状态监控、异常恢复和停止机制。
6.12.4 智能任务运行模式
智能任务运行模式用于承载需求识别、知识组织、能力调用、执行反馈等需要持续协作的任务。
与传统单次请求不同,这类任务可能具有多个执行阶段,并且需要保留任务状态和执行上下文。
例如:
接收需求
↓
识别任务内容
↓
组织所需知识与结构
↓
匹配或创建所需能力
↓
执行任务
↓
接收反馈
↓
形成处理结果
这里的智能任务流程属于应用运行层的组织方式。框架启动机制负责为其提供运行环境、对象管理、服务调用和任务调度基础,不应把具体智能理论流程固定写死在框架核心中。
不同智能应用可以根据自己的需求定义不同的任务执行方式。
6.13 启动异常与运行状态管理
框架启动过程中,并不是所有操作都一定能够成功。
例如,配置文件不存在、必要组件加载失败、应用依赖缺失或运行环境不符合要求,都可能导致启动失败。
因此,框架需要区分启动状态与请求执行状态。
启动状态可以初步划分为:
| 状态 | 含义 |
|---|---|
| 未启动 | 尚未执行启动程序 |
| 初始化中 | 正在加载环境和核心对象 |
| 已就绪 | 必需运行资源已经准备完成 |
| 部分就绪 | 非必要模块加载失败,但允许有限运行 |
| 启动失败 | 关键依赖或必要初始化失败 |
| 已停止 | 框架已按要求停止运行 |
请求执行状态则可以包括等待、执行中、执行完成和执行失败等状态。
这些状态不应只保存在日志中,还需要在框架运行对象中形成可查询的状态信息。
对于必须依赖某个组件的应用,如果该组件初始化失败,框架不能仍然将应用报告为正常运行。
对于非必要扩展,则可以根据应用依赖关系决定是否允许继续启动。
在长期运行的智能任务和设备控制环境中,还需要进一步区分任务失败、通信中断、执行超时和设备状态异常,避免将这些情况全部归类为普通程序异常。
6.14 启动与运行机制的工程验证
启动机制必须通过实际运行验证,才能确认程序能够按照设计流程工作。
仅仅编写 index.php 和 bootstrap.php,并不能证明框架已经能够启动。
在 WangStruct Framework 的开发过程中,应当按照由简单到复杂的方式进行验证。
首先,验证启动入口能否正确加载启动程序,以及基础类能否正常自动加载。
其次,验证配置读取是否正确,缺失配置和错误配置是否能够被识别。
然后,验证核心对象能否按照依赖顺序创建,注册管理器能否正常注册和查询对象。
接下来,验证组件能否加载、注册、调用和替换。
在此基础上,再验证应用加载、路由匹配、请求调度和结果返回。
最后,验证不同运行模式以及异常情况下的处理能力。
建议建立以下基本测试范围:
| 测试项目 | 验证内容 |
|---|---|
| 启动入口测试 | 能否正确进入框架启动程序 |
| 环境加载测试 | 能否识别当前运行环境 |
| 配置读取测试 | 能否正确读取和校验配置 |
| 核心对象测试 | 核心对象能否正确初始化 |
| 组件注册测试 | 组件能否注册、查询和注销 |
| 应用加载测试 | 应用及其依赖能否正确加载 |
| 路由测试 | 请求是否能够匹配正确处理程序 |
| 请求执行测试 | 应用能否完成实际处理 |
| 结果返回测试 | 返回内容和状态是否符合约定 |
| 异常测试 | 启动失败和运行失败能否正确处理 |
| 兼容测试 | 不同语言实现是否遵循相同契约 |
实际开发时,每个测试都应记录测试环境、输入条件、预期结果和实际结果。没有执行过的测试不能标记为通过。
6.15 本章小结
本章建立了 WangStruct Framework 的启动与运行机制设计,明确了启动入口、环境加载、配置初始化、核心对象初始化、组件注册、路由加载、应用调度、请求执行和结果返回之间的关系。
框架启动机制的核心任务是建立稳定的运行环境,并将外部请求或运行任务交给正确的应用处理程序。它不负责替代应用业务,也不应将所有智能功能固定在框架启动程序中。
通过统一启动入口和分层运行机制,开发者可以在相同的框架基础上开发 Web 应用、命令行程序、后台服务和智能任务系统。不同语言的实现也可以遵循相同的启动阶段和运行契约,采用各自成熟的程序加载与执行方式。
本章的代码属于 PHP 参考实现示例,尚未构成完整可运行的 WangStruct Framework。后续工程开发需要进一步确定核心类、启动协调程序、组件注册接口、路由接口和应用调度接口的正式定义,并按照实际文件检查、代码实现、语法验证和运行测试的流程逐项完成。