update docs

config/global.php

@@ -28,12 +28,12 @@ $config['crash_dir'] = $config['zm_data'] . 'crash/';
 /* 对应swoole的server->set参数 */
 $config['swoole'] = [
     'log_file' => $config['crash_dir'] . 'swoole_error.log',
-    //'worker_num' => swoole_cpu_num(), //如果你只有一个 OneBot 实例连接到框架并且代码没有复杂的CPU密集计算，则可把这里改为1使用全局变量
-    'dispatch_mode' => 2, //包分配原则，见 https://wiki.swoole.com/#/server/setting?id=dispatch_mode
+    // 'worker_num' => swoole_cpu_num(), //如果你只有一个 OneBot 实例连接到框架并且代码没有复杂的CPU密集计算，则可把这里改为1使用全局变量
+    'dispatch_mode' => 2, // 包分配原则，见 https://wiki.swoole.com/#/server/setting?id=dispatch_mode
     'max_coroutine' => 300000,
     'max_wait_time' => 5,
-    //'task_worker_num' => 4,
-    //'task_enable_coroutine' => true
+    // 'task_worker_num' => 4,
+    // 'task_enable_coroutine' => true
 ];
 
 /* 一些框架与框架运行时设置的调整 */
@@ -44,13 +44,19 @@ $config['runtime'] = [
     'reload_delay_time' => 800,
     'global_middleware_binding' => [],
     'save_console_log_file' => false, // 改为目标路径，则将 Console 输出的日志保存到文件
+    'annotation_reader_ignore' => [ // 设置注解解析器忽略的注解名或命名空间，防止解析到不该解析的
+        'name' => [
+            'mixin',
+        ],
+        'namespace' => [],
+    ],
 ];
 
 /* 轻量字符串缓存，默认开启 */
 $config['light_cache'] = [
-    'size' => 512,                       //最多允许储存的条数（需要2的倍数）
-    'max_strlen' => 32768,               //单行字符串最大长度（需要2的倍数）
-    'hash_conflict_proportion' => 0.6,   //Hash冲突率（越大越好，但是需要的内存更多）
+    'size' => 512,                       // 最多允许储存的条数（需要2的倍数）
+    'max_strlen' => 32768,               // 单行字符串最大长度（需要2的倍数）
+    'hash_conflict_proportion' => 0.6,   // Hash冲突率（越大越好，但是需要的内存更多）
     'persistence_path' => $config['zm_data'] . '_cache.json',
     'auto_save_interval' => 900,
 ];
@@ -102,7 +108,7 @@ $config['http_default_code_page'] = [
 
 /* zhamao-framework在框架启动时初始化的atomic们 */
 $config['init_atomics'] = [
-    //'custom_atomic_name' => 0, //自定义添加的Atomic
+    // 'custom_atomic_name' => 0, //自定义添加的Atomic
 ];
 
 /* 终端日志显示等级（0-4） */

docs/guide/errcode.md

@@ -73,6 +73,6 @@
 | E00071 | 框架找不到对应类型的 API 调用类                              | 检查 `getExtendedAPI($name)` 传入的 `$name` 是否正确                    |
 | E00072 | 上下文无法找到                                              | 检查上下文环境，如是否处于协程环境中                             |
 | E00073 | 在类中找不到方法                                              | 检查调用对象是否存在对应的方法（method）或检查是否插入了对应的macro宏方法     |
-| E00073 | 参数非法                                              | 检查调用的参数是否正常（此处可能有多处问题，请看具体调用栈炸掉的地方）     |
+| E00074 | 参数非法                                              | 检查调用的参数是否正常（此处可能有多处问题，请看具体调用栈炸掉的地方）     |
 | E99999 | 未知错误                                                     |                                                              |
 

docs/update/build-update.md

@@ -4,6 +4,68 @@
 
 同时此处将只使用 build 版本号进行区分。
 
+## build 447 (2022-3-20)
+
+- 发布 2.7.0 正式版
+
+## build 446 (2022-3-20)
+
+- 新增 `./zhamao server` 下的 `--no-state-check` 参数，关闭“启动框架前的运行状态检查”功能
+
+## build 445 (2022-3-20)
+
+- 新增配置项 `runtime`.`annotation_reader_ignore`：支持注解解析器忽略注解的自定义
+
+## build 444 (2022-3-20)
+
+- 更改 `extra`.`exclude_annotate` 为 `zm`.`exclude-annotation-path` 项
+
+## build 443 (2022-3-20)
+
+- 修复注释空格的样式
+
+## build 442 (2022-3-20)
+
+- 修复打包模块后 `files` 的 autoload 项不能被解压和引入的 Bug
+
+## build 441 (2022-3-20)
+
+- 修复打包模块时命名空间与实际不一致的 Bug
+
+## build 440 (2022-3-20)
+
+- 新增方法宏（Macroable）
+
+## build 439 (2022-3-19)
+
+- 新增 PHP 8 Attribute 与注解同时支持的特性
+
+## build 438 (2022-3-18)
+
+- 修复 Response 类在 PHP 8.1 环境下的报错
+
+## build 437 (2022-3-17)
+
+- 修复 `ctx()` 可能会返回 null 的 Bug
+
+## build 436 (2022-3-15)
+
+- 新增 PHPStan 和 PHP CS Fixer 并优化全局代码
+
+## build 435 (2022-3-13)
+
+- 优化分离 WorkerManager 与 ProcessManager 的职责
+- 新增 Ctrl+C 一次无法停止框架时多次 Ctrl+C 后可强行杀掉所有进程的功能
+- `./zhamao server:stop` 新增参数 `--force`，使用 `SIGKILL` 强行杀掉所有进程
+- 新增 AnnotationParser 对 `autoload-dev` 项中的 `psr-4` 默认检索条件
+- 新增框架启动状态检测功能，如果已经启动了同样目录的框架，则会报错
+- 新增“强制启用轮询模式启动热更新”功能（参数 `--polling-watch`）
+- 修复与 PHP 8.1 的兼容性
+- 对 DaemonCommand 进行优化，与 ServerCommand 效果相同
+- 修复 `autoload`.`psr-4` 不存在时报错的 Bug
+- 新增框架停止时 Worker 退出回显状态码
+- 新增 inotify 判断模式，如果使用 `--watch` 检测到没有安装 inotify，则自动使用轮询模式
+
 ## build 434 (2022-1-8)
 
 - 修复框架在 PHP 8.1 下运行时的一些问题

docs/update/config.md

@@ -2,6 +2,10 @@
 
 这里将会记录各个主版本的框架升级后，涉及 `global.php` 的更新日志，你可以根据这里描述的内容与你的旧配置文件进行合并。
 
+## v2.7.0 (build 447)
+
+- 新增 `$config['runtime']` 下的 `annotation_reader_ignore` 项。
+
 ## v2.6.6 (build 434)
 
 - 新增 `$config['runtime']` 下的 `save_console_log_file` 项。

docs/update/v2.md

@@ -1,5 +1,32 @@
 # 更新日志（v2 版本）
 
+## v2.7.0（build 447）
+
+> 更新时间：2022.3.20
+
+- 优化分离 WorkerManager 与 ProcessManager 的职责
+- 新增 Ctrl+C 一次无法停止框架时多次 Ctrl+C 后可强行杀掉所有进程的功能
+- `./zhamao server:stop` 新增参数 `--force`，使用 `SIGKILL` 强行杀掉所有进程
+- 新增 AnnotationParser 对 `autoload-dev` 项中的 `psr-4` 默认检索条件
+- 新增框架启动状态检测功能，如果已经启动了同样目录的框架，则会报错
+- 新增“强制启用轮询模式启动热更新”功能（参数 `--polling-watch`）
+- 修复与 PHP 8.1 的兼容性
+- 对 DaemonCommand 进行优化，与 ServerCommand 效果相同
+- 修复 `autoload`.`psr-4` 不存在时报错的 Bug
+- 新增框架停止时 Worker 退出回显状态码
+- 新增 inotify 判断模式，如果使用 `--watch` 检测到没有安装 inotify，则自动使用轮询模式
+- 新增 PHPStan 和 PHP CS Fixer 并优化全局代码
+- 修复 `ctx()` 可能会返回 null 的 Bug
+- 修复 Response 类在 PHP 8.1 环境下的报错
+- 新增 PHP 8 Attribute 与注解同时支持的特性
+- 新增方法宏（Macroable）
+- 修复打包模块时命名空间与实际不一致的 Bug
+- 修复打包模块后 `files` 的 autoload 项不能被解压和引入的 Bug
+- 修复注释空格的样式
+- 更改 `extra`.`exclude_annotate` 为 `zm`.`exclude-annotation-path` 项
+- 新增配置项 `runtime`.`annotation_reader_ignore`：支持注解解析器忽略注解的自定义
+- 新增 `./zhamao server` 下的 `--no-state-check` 参数，关闭“启动框架前的运行状态检查”功能
+
 ## v2.6.6（build 434）
 
 > 更新时间：2022.1.8

src/ZM/Annotation/AnnotationParser.php

@@ -65,6 +65,19 @@ class AnnotationParser
         foreach ($this->path_list as $path) {
             Console::debug('parsing annotation in ' . $path[0] . ':' . $path[1]);
             $all_class = ZMUtil::getClassesPsr4($path[0], $path[1]);
+
+            $conf = ZMConfig::get('global', 'runtime')['annotation_reader_ignore'] ?? [];
+            if (isset($conf['name']) && is_array($conf['name'])) {
+                foreach ($conf['name'] as $v) {
+                    AnnotationReader::addGlobalIgnoredName($v);
+                }
+            }
+            if (isset($conf['namespace']) && is_array($conf['namespace'])) {
+                foreach ($conf['namespace'] as $v) {
+                    AnnotationReader::addGlobalIgnoredNamespace($v);
+                }
+            }
+            AnnotationReader::addGlobalIgnoredName('mixin');
             $this->reader = new DualReader(new AnnotationReader(), new AttributeReader());
             foreach ($all_class as $v) {
                 Console::debug('正在检索 ' . $v);

src/ZM/Command/RunServerCommand.php

@@ -46,6 +46,7 @@ class RunServerCommand extends Command
             new InputOption('preview', null, null, '只显示参数，不启动服务器'),
             new InputOption('force-load-module', null, InputOption::VALUE_OPTIONAL, '强制打包状态下加载模块（使用英文逗号分割多个）'),
             new InputOption('polling-watch', null, null, '强制启用轮询模式监听'),
+            new InputOption('no-state-check', null, null, '关闭启动前框架运行状态检查'),
         ]);
         $this->setDescription('Run zhamao-framework | 启动框架');
         $this->setHelp('直接运行可以启动');
@@ -60,10 +61,12 @@ class RunServerCommand extends Command
             }
         }
         $state = Framework::getProcessState(ZM_PROCESS_MASTER);
-        if (is_array($state) && posix_getsid($state['pid'] ?? -1) !== false) {
-            $output->writeln("<error>检测到已经在 pid: {$state['pid']} 进程启动了框架！</error>");
-            $output->writeln('<error>不可以同时启动两个框架！</error>');
-            return 1;
+        if (!$input->getOption('no-state-check')) {
+            if (is_array($state) && posix_getsid($state['pid'] ?? -1) !== false) {
+                $output->writeln("<error>检测到已经在 pid: {$state['pid']} 进程启动了框架！</error>");
+                $output->writeln('<error>不可以同时启动两个框架！</error>');
+                return 1;
+            }
         }
         (new Framework($input->getOptions()))->start();
         return 0;

src/ZM/ConsoleApplication.php

@@ -28,9 +28,9 @@ use ZM\Exception\InitException;
 
 class ConsoleApplication extends Application
 {
-    public const VERSION_ID = 444;
+    public const VERSION_ID = 447;
 
-    public const VERSION = '2.7.0-beta4';
+    public const VERSION = '2.7.0';
 
     private static $obj;