mm_statics 1.9.4 → 1.9.6

package/lib/config.tpl.json

@@ -0,0 +1,31 @@
+{
+	// 路由路径，注意：这里是泛路径，相当于/*
+	// 注册域, 即本资源注册到 require('mm_xxx').admin 的哪个域
+	"scope": "${scope || 'os'}",
+	// 所属应用
+	"app": "${app || 'os'}",
+	// 所属插件, 应用级资源为空
+	"plugin": "${plugin || ''}",
+	"path": "${path || '/${name}'}",
+
+	// 名称, 由中英文和下“_”组成, 用于修改或卸载 例如: demo
+	"name": "${name || 'static'}",
+	// 标题, 用于查询时
+	"title": "${title || 'static资源'}",
+	// 状态 0未启用，1启用
+	"state": 1,
+	// 资源缓存寿命，单位：秒
+	"max_age": 0,
+	// 是否恒久不变，一般资源文件可能变化，所以这里一般是false
+	"immutable": false,
+	// 是否使用brotli压缩方式
+	"brotli": true,
+	// 是否启用gzip压缩方式
+	"gzip": true,
+	// 是否限制访问指定拓展名的文件，多个
+	"extensions": null,
+	// 是否转换JS、vue代码为amd标准，true的情况下会把es6和commonJS都转成amd格式
+	"convert_amd": false,
+	// 调用脚本文件，如果请求改路由情况会调用改脚本文件 ./static.js
+	"main": ""
+}

package/lib/manager.js

@@ -1,5 +1,6 @@
 const Manager = require("mm_machine").Manager;
 const Static = require("./static");
+const StaticHandle = require("./static_handle");
 const { URLSearchParams } = require('url');
 
 /**
@@ -37,7 +38,13 @@ class StaticManager extends Manager {
      * 资源清单文件名（update 扫描目录时使用）
      * @type {string}
      */
-    filename: "static.json"
+    filename: "static.json",
+    /**
+     * 忽略的请求路径（管理器级，命中后不再遍历任何驱动），
+     * 支持 * 通配，如 ['/api*', '/apis*']；驱动级 ignore 可再各自补充
+     * @type {Array<string|RegExp>}
+     */
+    ignore: []
   };
 
   /**
@@ -69,6 +76,10 @@ class StaticManager extends Manager {
    */
   async run(params, ctx, options) {
     var path = this._requestPath(params, ctx);
+    // 管理器级忽略：命中即视为未命中，跳过全部驱动的匹配（接口类请求不再空跑一圈）
+    if (StaticHandle.isIgnored(path, this.config.ignore)) {
+      return false;
+    }
     var infos = this._getInfos();
     var len = infos.length;
     if (path.indexOf(".") !== -1) {

package/lib/script.tpl.js

@@ -0,0 +1,31 @@
+
+module.exports = {
+  /**
+   * 执行前
+   * @param {object} params 请求参数
+   * @param {object} ctx 请求上下文
+   * @param {object} options 运行选项
+   */
+  async before(params, ctx, options) { },
+
+  /**
+   * 执行（服务式调用，不接收 next）
+   * @param {object} params 请求参数
+   * @param {object} ctx 请求上下文
+   * @param {object} options 运行选项
+   * @returns {Promise<string>} 命中返回物理文件路径，未命中返回空串
+   */
+  async main(params, ctx, options) {
+    return await this.run(params, ctx, options);
+  },
+
+  /**
+   * 执行后
+   * @param {object} params 请求参数
+   * @param {object} ctx 请求上下文
+   * @param {object} options 运行选项
+   */
+  async after(params, ctx, options) {
+
+  }
+};

package/lib/static.js

@@ -31,6 +31,8 @@ class Static extends Item {
     'gzip': true,
     // 允许访问的拓展名
     'extensions': null,
+    // 忽略的请求路径（本驱动不参与的路径），支持 * 通配，如 ['/api*']
+    'ignore': null,
     // 是否将ES6转换AMD
     'convert_amd': true,
     // 主程序文件 - 默认为空

package/lib/static_handle.js

@@ -10,6 +10,79 @@ const { marked } = require('marked');
 
 var vueCompiler = new VueSFCCompiler();
 
+/**
+ * 通配规则编译缓存（规则串 -> 正则），避免热路径上重复构造正则
+ * @type {Map<string, RegExp>}
+ */
+var rule_cache = new Map();
+
+/**
+ * 将忽略规则编译为正则（支持 * 通配，等价于任意字符）
+ * @param {string} rule 规则串，如 /api*、*.map、/apis*
+ * @returns {RegExp} 匹配整个路径的正则
+ */
+function _compileRule(rule) {
+  var re = rule_cache.get(rule);
+  if (re) {
+    return re;
+  }
+  // 先转义正则元字符，再把 * 还原为通配
+  var escaped = rule.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*');
+  re = new RegExp('^' + escaped + '$');
+  rule_cache.set(rule, re);
+  return re;
+}
+
+/**
+ * 判断请求路径是否命中忽略规则
+ *
+ * 规则形态（可传单个规则、逗号分隔字符串或数组，数组元素可为字符串或正则）：
+ *  - 前缀通配：/api* ，忽略 /api、/api/user 等
+ *  - 后缀通配：*.map ，忽略所有 .map 文件
+ *  - 包含通配：*manage* ，忽略路径中含 manage 的请求
+ *  - 无通配：/api ，按「路径段前缀」匹配，忽略 /api 与 /api/xxx，但不影响 /apixyz
+ * @param {string} target 请求路径
+ * @param {string|Array<string|RegExp>} rules 忽略规则
+ * @returns {boolean} 命中返回 true
+ */
+function isIgnored(target, rules) {
+  if (!rules || !target) {
+    return false;
+  }
+  var list = Array.isArray(rules) ? rules : String(rules).split(',');
+  for (var i = 0; i < list.length; i++) {
+    var raw = list[i];
+    if (!raw) {
+      continue;
+    }
+    if (raw instanceof RegExp) {
+      if (raw.test(target)) {
+        return true;
+      }
+      continue;
+    }
+    var rule = String(raw).trim();
+    if (!rule) {
+      continue;
+    }
+    if (rule.indexOf('*') === -1) {
+      // 无通配：精确或路径段前缀
+      if (target === rule) {
+        return true;
+      }
+      var prefix = rule.endsWith('/') ? rule : rule + '/';
+      if (target.startsWith(prefix)) {
+        return true;
+      }
+      continue;
+    }
+    if (_compileRule(rule).test(target)) {
+      return true;
+    }
+  }
+  return false;
+}
+
 /**
  * 静态文件处理类
  */
@@ -56,7 +129,9 @@ class StaticHandle {
     // 是否开启文件监听
     watch: false,
     // 监听的文件扩展名
-    watch_files: ['.js', '.css', '.html', '.vue', '.json', '.md']
+    watch_files: ['.js', '.css', '.html', '.vue', '.json', '.md'],
+    // 忽略的请求路径（不参与静态匹配），支持 * 通配，如 ['/api*', '/apis*', '*.map']
+    ignore: []
   };
 
   /**
@@ -633,9 +708,72 @@ StaticHandle.prototype._getHeaders = function (file_type) {
     case 'swf':
       headers['content-type'] = 'application/x-shockwave-flash';
       break;
-    default:
+    case 'jpg':
+    case 'jpeg':
+      headers['content-type'] = 'image/jpeg';
+      break;
+    case 'png':
+      headers['content-type'] = 'image/png';
+      break;
+    case 'gif':
+      headers['content-type'] = 'image/gif';
+      break;
+    case 'webp':
+      headers['content-type'] = 'image/webp';
+      break;
+    case 'avif':
+      headers['content-type'] = 'image/avif';
+      break;
+    case 'bmp':
+      headers['content-type'] = 'image/bmp';
+      break;
+    case 'svg':
+      headers['content-type'] = 'image/svg+xml';
+      break;
+    case 'ico':
+      headers['content-type'] = 'image/x-icon';
+      break;
+    case 'mp4':
+      headers['content-type'] = 'video/mp4';
+      break;
+    case 'webm':
+      headers['content-type'] = 'video/webm';
+      break;
+    case 'mov':
+      headers['content-type'] = 'video/quicktime';
+      break;
+    case 'woff':
+      headers['content-type'] = 'font/woff';
+      break;
+    case 'woff2':
+      headers['content-type'] = 'font/woff2';
+      break;
+    case 'ttf':
+      headers['content-type'] = 'font/ttf';
+      break;
+    case 'otf':
+      headers['content-type'] = 'font/otf';
+      break;
+    case 'eot':
+      headers['content-type'] = 'application/vnd.ms-fontobject';
+      break;
+    case 'pdf':
+      headers['content-type'] = 'application/pdf';
+      break;
+    case 'json':
+      headers['content-type'] = 'application/json; charset=utf-8';
+      break;
+    case 'txt':
       headers['content-type'] = 'text/plain; charset=utf-8';
       break;
+    case 'xml':
+      headers['content-type'] = 'application/xml; charset=utf-8';
+      break;
+    default:
+      // 二进制兜底改为 application/octet-stream：text/plain 会诱导浏览器按文本
+      // 处理未知类型（开启 nosniff 的部署下图片/字体直接拒载）
+      headers['content-type'] = 'application/octet-stream';
+      break;
   }
   return headers;
 };
@@ -829,6 +967,10 @@ StaticHandle.prototype.main = async function (params, ctx, options) {
   if (!this._isReadable(this._requestMethod(params, ctx))) {
     return '';
   }
+  // 命中忽略规则（如 /api*）直接放行，由事件链处理，不做静态匹配
+  if (this._isIgnored(p)) {
+    return '';
+  }
   // 无扩展名的路径交给目录分支与后续事件处理
   if (p.indexOf('.') === -1) {
     return '';
@@ -857,6 +999,15 @@ StaticHandle.prototype.main = async function (params, ctx, options) {
   }
 };
 
+/**
+ * 判断请求路径是否命中本驱动的忽略规则
+ * @param {string} path 请求路径
+ * @returns {boolean} 命中返回 true
+ */
+StaticHandle.prototype._isIgnored = function (path) {
+  return isIgnored(path, this.config.ignore);
+};
+
 /**
  * 关闭文件监听器
  */
@@ -867,4 +1018,6 @@ StaticHandle.prototype.closeWatcher = function () {
   }
 };
 
-module.exports = StaticHandle;
+module.exports = StaticHandle;
+// 忽略规则匹配函数，供静态管理器（manager.js）复用
+module.exports.isIgnored = isIgnored;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_statics",
-    "version": "1.9.4",
+    "version": "1.9.6",
     "description": "这是超级美眉statics函数模块，用于web服务端statics缓存",
     "main": "index.js",
     "scripts": {
@@ -36,12 +36,14 @@
     },
     "homepage": "https://gitee.com/qiuwenwu91/mm_statics#readme",
     "files": [
+        "eslint.config.js",
         "index.js",
-        "lib/vue_compiler.js",
+        "lib/config.tpl.json",
+        "lib/manager.js",
+        "lib/script.tpl.js",
         "lib/static.js",
         "lib/static_handle.js",
-        "lib/manager.js",
-        "eslint.config.js",
+        "lib/vue_compiler.js",
         "static/"
     ],
     "dependencies": {
@@ -53,7 +55,7 @@
         "mm_corejs": "^1.1.5",
         "mm_es6_to_amd": "^1.5.9",
         "mm_helper": "^1.0.0",
-        "mm_machine": "^3.5.4",
+        "mm_machine": "^3.6.0",
         "prettier": "^3.9.10"
     },
     "devDependencies": {
@@ -61,7 +63,6 @@
         "eslint-plugin-jsdoc": "^65.3.4",
         "koa": "^3.2.1",
         "mm_eslint": "^1.7.7",
-        "mm_expand": "^2.5.4",
         "mocha": "^12.0.3",
         "supertest": "^7.3.1"
     }