多应用

有时一个项目可能分为多个子项目，例如一个商城可能分为商城主项目、商城api接口、商城管理后台3个子项目，他们都使用相同的数据库配置。

webman允许你这样规划app目录：

  1. app
  2. ├── shop
  3. │   ├── controller
  4. │   ├── model
  5. │   └── view
  6. ├── api
  7. │   ├── controller
  8. │   └── model
  9. └── admin
  10.     ├── controller
  11.     ├── model
  12.     └── view

当访问地址 http://127.0.0.1:8787/shop/{控制器}/{方法} 时访问app/shop/controller下的控制器与方法。

当访问地址 http://127.0.0.1:8787/api/{控制器}/{方法} 时访问app/api/controller下的控制器与方法。

当访问地址 http://127.0.0.1:8787/admin/{控制器}/{方法} 时访问app/admin/controller下的控制器与方法。

在webman中，甚至可以这样规划app目录。

  1. app
  2. ├── controller
  3. ├── model
  4. ├── view
  5. │
  6. ├── api
  7. │   ├── controller
  8. │   └── model
  9. └── admin
  10.     ├── controller
  11.     ├── model
  12.     └── view

这样当地址访问 http://127.0.0.1:8787/{控制器}/{方法} 时访问的是app/controller下的控制器与方法。当路径里以api或者admin开头时访问的是相对应目录里的控制器与方法。

多应用时类的命名空间需符合psr4，例如app/api/controller/Foo.php 文件类似如下：

  1. <?php
  2. namespace app\api\controller;
  4. use support\Request;
  6. class Foo
  7. {
  9. }

多应用路由自动解析

有时候app目录结构可能更加复杂，webman无法自动解析路由，例如

  1. app
  2. └── api
  3.    ├── v1
  4.    │   ├── controller
  5.    │   ├── model
  6.    │   └── view
  7.    └── admin
  8.        └── v2
  9.            ├── controller
  10.            ├── model
  11.            └── view

这时候我们可以通过反射来自动解析路由，例如在config/route.php中填写如下代码。

  1. $dir_iterator = new \RecursiveDirectoryIterator(app_path());
  2. $iterator = new \RecursiveIteratorIterator($dir_iterator);
  3. foreach ($iterator as $file) {
  4.     // 忽略目录和非php文件
  5.     if (is_dir($file) || $file->getExtension() != 'php') {
  6.         continue;
  7.     }
  9.     $file_path = str_replace('\\', '/',$file->getPathname());
  10.     // 文件路径里不带controller的文件忽略
  11.     if (strpos($file_path, 'controller') === false) {
  12.         continue;
  13.     }
  15.     // 根据文件路径计算uri
  16.     $uri_path = strtolower(str_replace('controller/', '',substr(substr($file_path, strlen(app_path())), 0, -4)));
  17.     // 根据文件路径是被类名
  18.     $class_name = str_replace('/', '\\',substr(substr($file_path, strlen(base_path())), 0, -4));
  20.     if (!class_exists($class_name)) {
  21.         echo "Class $class_name not found, skip route for it\n";
  22.         continue;
  23.     }
  25.     // 通过反射找到这个类的所有共有方法作为action
  26.     $class = new ReflectionClass($class_name);
  27.     $methods = $class->getMethods(ReflectionMethod::IS_PUBLIC);
  29.     $route = function ($uri, $cb) {
  30.         //echo "Route $uri [{$cb[0]}, {$cb[1]}]\n";
  31.         Route::any($uri, $cb);
  32.         Route::any($uri.'/', $cb);
  33.     };
  35.     // 设置路由
  36.     foreach ($methods as $item) {
  37.         $action = $item->name;
  38.         if (in_array($action, ['__construct', '__destruct'])) {
  39.             continue;
  40.         }
  41.         // action为index时uri里末尾/index可以省略
  42.         if ($action === 'index') {
  43.             // controller也为index时可以uri里可以省略/index/index
  44.             if (substr($uri_path, -6) === '/index') {
  45.                 $route(substr($uri_path, 0, -6), [$class_name, $action]);
  46.             }
  47.             $route($uri_path, [$class_name, $action]);
  48.         }
  49.         $route($uri_path.'/'.$action, [$class_name, $action]);
  50.     }
  52. }

以上路由脚本会自动检测app下所有controller类并设置对应的路由，这样不管你的app目录层级多深多复杂，都可以通过对应的url地址访问到。

多应用中间件配置

有时候你想为不同应用配置不同的中间件，例如api应用可能需要一个跨域中间件，admin需要一个检查管理员登录的中间件，则配置config/midlleware.php可能类似下面这样：

  1. return [
  2.     // 全局中间件
  3.     '' => [
  4.         support\middleware\AuthCheck::class,
  5.     ],
  6.     // api应用中间件
  7.     'api' => [
  8.          support\middleware\AccessControl::class,
  9.      ],
  10.     // admin应用中间件
  11.     'admin' => [
  12.          support\middleware\AdminAuthCheck::class,
  13.          support\middleware\SomeOtherClass::class,
  14.     ],
  15. ];

以上中间件可能并不存在，这里仅仅是作为示例讲述如何按应用配置中间件

中间件执行顺序为 全局中间件->应用中间件。

中间件开发参考中间件章节

多应用异常处理配置

同样的，你想为不同的应用配置不同的异常处理类，例如shop应用里出现异常你可能想提供一个友好的提示页面；api应用里出现异常时你想返回的并不是一个页面，而是一个json字符串。为不同应用配置不同的异常处理类的配置文件config/exception.php类似如下：

  1. return [
  2.     'shop' => support\exception\Handler::class,
  3.     'api' => support\exception\ApiHandler::class,
  4. ];

不同于中间件，每个应用只能配置一个异常处理类。

以上异常处理类可能并不存在，这里仅仅是作为示例讲述如何按应用配置异常处理

异常处理开发参考异常处理章节