egg
Version:
A web application framework for Node.js
372 lines (371 loc) • 12.5 kB
JavaScript
import { defineConfigFactory } from "../lib/define.js";
import "../index.js";
import { pathToFileURL } from "node:url";
import path from "node:path";
//#region src/config/config.default.ts
/**
* The configuration of egg application, can be access by `app.config`
* @class Config
* @since 1.0.0
*/
const factory = defineConfigFactory((appInfo) => {
const config = {
/**
* The environment of egg
* @member {String} Config#env
* @see {appInfo#env}
* @since 1.0.0
*/
env: appInfo.env,
/**
* The name of the application
* @member {String} Config#name
* @see {appInfo#name}
* @since 1.0.0
*/
name: appInfo.name,
/**
* The key that signing cookies. It can contain multiple keys separated by `,`.
* @member {String} Config#keys
* @see https://eggjs.org/core/cookie-and-session#cookie-secret-key
* @default
* @since 1.0.0
*/
keys: "",
/**
* default cookie options
*
* @member Config#cookies
* @property {String} sameSite - SameSite property, defaults is ''
* @property {Boolean} httpOnly - httpOnly property, defaults is true
*/
cookies: {},
/**
* Whether application deployed after a reverse proxy,
* when true proxy header fields will be trusted
* @member {Boolean} Config#proxy
* @default
* @since 1.0.0
*/
proxy: false,
/**
*
* max ips read from proxy ip header, default to 0 (means infinity)
* to prevent users from forging client ip addresses via x-forwarded-for
* @see https://github.com/koajs/koa/blob/master/docs/api/request.md#requestips
* @member {Integer} Config#maxIpsCount
* @default
* @since 2.25.0
*/
maxIpsCount: 0,
/**
* please use maxIpsCount instead
* @member {Integer} Config#maxProxyCount
* @default
* @since 2.21.0
* @deprecated
*/
maxProxyCount: 0,
/**
* Detect request's protocol from specified headers, not case-sensitive.
* Only worked when config.proxy set to true.
* @member {String} Config#protocolHeaders
* @default
* @since 1.0.0
*/
protocolHeaders: "x-forwarded-proto",
/**
* Detect request' ip from specified headers, not case-sensitive.
* Only worked when config.proxy set to true.
* @member {String} Config#ipHeaders
* @default
* @since 1.0.0
*/
ipHeaders: "x-forwarded-for",
/**
* Detect request' host from specified headers, not case-sensitive.
* Only worked when config.proxy set to true.
* @member {String} Config#hostHeaders
* @default
* @since 1.0.0
*/
hostHeaders: "",
/**
* package.json
* @member {Object} Config#pkg
* @see {appInfo#pkg}
* @since 1.0.0
*/
pkg: appInfo.pkg,
/**
* The current directory of the application
* @member {String} Config#baseDir
* @see {appInfo#baseDir}
* @since 1.0.0
*/
baseDir: appInfo.baseDir,
/**
* The current HOME directory
* @member {String} Config#HOME
* @see {appInfo#HOME}
* @since 1.0.0
*/
HOME: appInfo.HOME,
/**
* The directory of server running. You can find `application_config.json` under it that is dumped from `app.config`.
* @member {String} Config#rundir
* @default
* @since 1.0.0
*/
rundir: path.join(appInfo.baseDir, "run"),
/**
* dump config
*
* It will ignore special keys when dumpConfig
*
* @member Config#dump
* @property {Set} ignore - keys to ignore
*/
dump: {
ignore: /* @__PURE__ */ new Set([
"pass",
"pwd",
"passd",
"passwd",
"password",
"keys",
"masterKey",
"accessKey",
/secret/i
]),
timing: { slowBootActionMinDuration: 5e3 }
},
/**
* configurations are confused to users
* {
* [unexpectedKey]: [expectedKey],
* }
* @member Config#confusedConfigurations
* @type {Object}
*/
confusedConfigurations: {
bodyparser: "bodyParser",
notFound: "notfound",
sitefile: "siteFile",
middlewares: "middleware",
httpClient: "httpclient"
}
};
/**
* The options of `notfound` middleware
*
* It will return page or json depend on negotiation when 404,
* If pageUrl is set, it will redirect to the page.
*
* @member Config#notfound
* @property {String} pageUrl - the 404 page url
*/
config.notfound = {
enable: true,
pageUrl: ""
};
/**
* The option of `siteFile` middleware
*
* You can map some files using this options, it will response immediately when matching.
*
* @member {Object} Config#siteFile - key is path, and value is url or buffer.
* @property {String} cacheControl - files cache control, default is `public, max-age=2592000`
* @example
* ```ts
* // specific app's favicon, => '/favicon.ico': 'https://eggjs.org/favicon.png',
* config.siteFile = {
* '/favicon.ico': 'https://eggjs.org/favicon.png',
* };
* ```
*/
config.siteFile = {
enable: true,
"/favicon.ico": pathToFileURL(path.join(import.meta.dirname, "favicon.png")),
cacheControl: "public, max-age=2592000"
};
/**
* The options of `bodyParser` middleware
*
* @member Config#bodyParser
* @property {Boolean} enable - enable bodyParser or not, default is true
* @property {String | RegExp | Function | Array} ignore - won't parse request body when url path hit ignore pattern, can not set `ignore` when `match` presented
* @property {String | RegExp | Function | Array} match - will parse request body only when url path hit match pattern
* @property {String} encoding - body's encoding type，default is utf8
* @property {String} formLimit - limit of the urlencoded body. If the body ends up being larger than this limit, a 413 error code is returned. Default is 1mb
* @property {String} jsonLimit - limit of the json body, default is 1mb
* @property {String} textLimit - limit of the text body, default is 1mb
* @property {Boolean} strict - when set to true, JSON parser will only accept arrays and objects. Default is true
* @property {Number} queryString.arrayLimit - urlencoded body array's max length, default is 100
* @property {Number} queryString.depth - urlencoded body object's max depth, default is 5
* @property {Number} queryString.parameterLimit - urlencoded body maximum parameters, default is 1000
*/
config.bodyParser = {
enable: true,
encoding: "utf8",
formLimit: "1mb",
jsonLimit: "1mb",
textLimit: "1mb",
strict: true,
queryString: {
arrayLimit: 100,
depth: 5,
parameterLimit: 1e3
},
onProtoPoisoning: "error",
onerror(err, ctx) {
err.message = `${err.message}, check bodyParser config`;
if (ctx.status === 404) {
ctx.status = 400;
if (!err.status) err.status = 400;
}
throw err;
}
};
/**
* logger options
* @member Config#logger
* @property {String} dir - directory of log files
* @property {String} encoding - log file encoding, defaults to utf8
* @property {String} level - default log level, could be: DEBUG, INFO, WARN, ERROR or NONE, defaults to INFO in production
* @property {String} consoleLevel - log level of stdout, defaults to INFO in local serverEnv, defaults to WARN in unittest, defaults to NONE elsewise
* @property {Boolean} disableConsoleAfterReady - disable logger console after app ready. defaults to `false` on local and unittest env, others is `true`.
* @property {Boolean} outputJSON - log as JSON or not, defaults to false
* @property {Boolean} buffer - if enabled, flush logs to disk at a certain frequency to improve performance, defaults to true
* @property {String} errorLogName - file name of errorLogger
* @property {String} coreLogName - file name of coreLogger
* @property {String} agentLogName - file name of agent worker log
* @property {Object} coreLogger - custom config of coreLogger
* @property {Boolean} allowDebugAtProd - allow debug log at prod, defaults to false
* @property {Boolean} enableFastContextLogger - using the app logger instead of EggContextLogger, defaults to true
*/
config.logger = {
dir: path.join(appInfo.root, "logs", appInfo.name),
encoding: "utf8",
env: appInfo.env,
level: "INFO",
consoleLevel: "INFO",
disableConsoleAfterReady: appInfo.env !== "local" && appInfo.env !== "unittest",
outputJSON: false,
buffer: true,
appLogName: `${appInfo.name}-web.log`,
coreLogName: "egg-web.log",
agentLogName: "egg-agent.log",
errorLogName: "common-error.log",
coreLogger: {},
allowDebugAtProd: false,
enableFastContextLogger: true
};
/**
* The option for httpclient
* @member Config#httpclient
* @property {Boolean} enableDNSCache - Enable DNS lookup from local cache or not, default is false.
* @property {Boolean} dnsCacheLookupInterval - minimum interval of DNS query on the same hostname (default 10s).
*
* @property {Number} request.timeout - httpclient request default timeout, default is 5000 ms.
*
* @property {Boolean} httpAgent.keepAlive - Enable http agent keepalive or not, default is true
* @property {Number} httpAgent.freeSocketTimeout - http agent socket keepalive max free time, default is 4000 ms.
* @property {Number} httpAgent.maxSockets - http agent max socket number of one host, default is `Number.MAX_SAFE_INTEGER` @ses https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER
* @property {Number} httpAgent.maxFreeSockets - http agent max free socket number of one host, default is 256.
*
* @property {Boolean} httpsAgent.keepAlive - Enable https agent keepalive or not, default is true
* @property {Number} httpsAgent.freeSocketTimeout - https agent socket keepalive max free time, default is 4000 ms.
* @property {Number} httpsAgent.maxSockets - https agent max socket number of one host, default is `Number.MAX_SAFE_INTEGER` @ses https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER
* @property {Number} httpsAgent.maxFreeSockets - https agent max free socket number of one host, default is 256.
* @property {Boolean} useHttpClientNext - use urllib@3 HttpClient
*/
config.httpclient = { request: { timeout: 5e3 } };
/**
* The options of `meta` middleware
*
* @member Config#meta
* @property {Boolean} enable - enable meta or not, default is `true`
* @property {Boolean} logging - enable logging start request, default is `false`
*/
config.meta = {
enable: true,
logging: false
};
/**
* core enable middlewares
* @member {Array} Config#middleware
*/
config.coreMiddleware = [
"meta",
"siteFile",
"notfound",
"bodyParser",
"overrideMethod"
];
/**
* emit `startTimeout` if worker don't ready after `workerStartTimeout` ms
* @member {Number} Config.workerStartTimeout
*/
config.workerStartTimeout = 6e5;
/**
* server timeout in milliseconds, default to 0 (no timeout).
*
* for special request, just use `ctx.req.setTimeout(ms)`
*
* @member {Number} Config#serverTimeout
* @see https://nodejs.org/api/http.html#http_server_timeout
*/
config.serverTimeout = null;
/**
* The options of cluster
* @member {Object} Config#cluster
* @property {Object} listen - listen options, see {@link https://nodejs.org/api/http.html#http_server_listen_port_hostname_backlog_callback}
* @property {String} listen.path - set a unix sock path when server listen
* @property {Number} listen.port - set a port when server listen
* @property {String} listen.hostname - set a hostname binding server when server listen
* @property {Boolean} listen.reusePort - enable SO_REUSEPORT socket option, default is `false`.
* Only available on Linux 3.9+, DragonFlyBSD 3.6+, FreeBSD 12.0+, Solaris 11.4, and AIX 7.2.5+.
*/
config.cluster = { listen: {
path: "",
port: 7001,
hostname: "",
reusePort: false
} };
/**
* @property {Number} responseTimeout - response timeout, default is 60000
*/
config.clusterClient = {
maxWaitTime: 6e4,
responseTimeout: 6e4
};
/**
* This function / async function will be called when a client error occurred and return the response.
*
* The arguments are `err`, `socket` and `application` which indicate current client error object, current socket
* object and the application object.
*
* The response to be returned should include properties below:
*
* @member {Function} Config#onClientError
* @property [body] {String|Buffer} - the response body
* @property [status] {Number} - the response status code
* @property [headers] {Object} - the response header key-value pairs
*
* @example
* exports.onClientError = async (err, socket, app) => {
* return {
* body: 'error',
* status: 400,
* headers: {
* 'powered-by': 'Egg.js',
* }
* };
* }
*/
config.onClientError = void 0;
return config;
});
//#endregion
export { factory as default };