ControllerException

     /**

     *检查路由配置的有效性

     *验证控制器类是否存在、是否继承自基础控制器类

     *验证动作方法是否存在、返回类型是否正确、参数数量是否匹配

     *

     *@throws ControllerException 当控制器或动作方法配置无效时抛出异常

      */

     public function checkSelf(): void

     {

         $controllerName = ucfirst($this->controller);

         $controllerClazz = "app\\controller\\{$this->module}\\{$controllerName}";

         // 检查控制器是否存在且继承自Controller

         if (!class_exists($controllerClazz)) {

         }

         if (!is_subclass_of($controllerClazz, Controller::class)) {

             throw new ControllerException("Controller must extends Controller: $controllerClazz", $this);

         }

         try {

             $reflection = new ReflectionMethod($controllerClazz, $this->action);

             // 检查返回类型

             $returnType = $reflection->getReturnType();

             if ($returnType == null || $returnType->getName() != Response::class) {

                 throw new ControllerException("Action return type must be Response: $controllerClazz::{$this->action}", $this);

             }

             // 只检查参数数量

     *框架启动时的钩子方法

      */

     protected function onFrameworkStart()

     {

     }

     /**

     *处理路由

     *@throws ControllerException

      */

     private function handleRouting(): RouteObject

     {

         $route = Route::getInstance()->dispatch($_SERVER['REQUEST_URI'], $_SERVER['REQUEST_METHOD']);

         $this->onRoute($route);

         EventManager::trigger("route.handler", $route);

         return $route;

     }

     /**

     *获取App实例

     *如果存在自定义的Application类并实现了App接口，则返回自定义Application实例

     *否则返回默认App实例

     *

     *@return App 返回应用程序实例

      */

     public static function getInstance(): App

     {

         return Context::instance()->getOrCreateInstance("App", function () {

             $applicationClazz = "app\\Application";

             if (class_exists($applicationClazz) && is_subclass_of($applicationClazz, App::class)) {

     ];

     /**

     *启动应用程序

     *处理整个应用程序的生命周期，包括：

     *1. 框架初始化

     *2. 路由处理

     *3. 请求处理

     *4. 异常处理

     *5. 应用程序终止

      */

     public function start(): void

     {

         try {

             $this->initializeFramework();

             $this->processRequest($route);

         } catch (AppExitException $exception) {

             $this->handleAppExit($exception);

         } catch (ControllerException $exception) {

             $this->handleControllerException($exception);

         } catch (Throwable|Error $exception) {

             $this->handleGeneralException($exception);

         } finally {

             $this->finalizeApplication();

         }

     }

     /**

     *初始化框架

      */

 $loader = new Loader();

 // 初始化应用程序上下文

 $context = new Context($loader);

 if ($context->isDebug()) {

     if (function_exists('opcache_reset')) {

         opcache_reset(); // 清空所有已缓存的脚本

     }

 }

 // 加载助手函数

 include_once "helper.php";

 $context->init();

 // 获取应用程序实例并启动

 // 清理上下文对象

 $context->destroy();

 $context = null;

<?php

 namespace app;

 if(file_exists(__DIR__ . '/../vendor/autoload.php')){

     require __DIR__ . '/../vendor/autoload.php';

 }