log

type Field = zapcore.Field

type Level = zapcore.Level

type Logger interface {
	// Debug 日志
	Debug(msg string, fields ...Field)
	Debugf(format string, v ...interface{})
	Debugw(msg string, keysAndValues ...interface{})

	// Info 日志
	Info(msg string, fields ...Field)
	Infof(format string, v ...interface{})
	Infow(msg string, keysAndValues ...interface{})

	// Warn 日志
	Warn(msg string, fields ...Field)
	Warnf(format string, v ...interface{})
	Warnw(msg string, keysAndValues ...interface{})

	// Error 日志
	Error(msg string, fields ...Field)
	Errorf(format string, v ...interface{})
	Errorw(msg string, keysAndValues ...interface{})

	// Panic 日志
	Panic(msg string, fields ...Field)
	Panicf(format string, v ...interface{})
	Panicw(msg string, keysAndValues ...interface{})

	// Fatal 日志
	Fatal(msg string, fields ...Field)
	Fatalf(format string, v ...interface{})
	Fatalw(msg string, keysAndValues ...interface{})

	// WithValues 向 logger 添加一些上下文的 key-value 对。
	WithValues(keysAndValues ...interface{}) Logger

	// WithName 向 logger 的名称添加一个新元素，建议名称段仅包含字母、数字和连字符
	WithName(name string) Logger

	// WithContext 返回设置了日志值的 context 副本
	WithContext(ctx context.Context) context.Context

	// Flush 调用底层 Core 的 Sync 方法，刷新所有缓冲的日志条目，应用程序应注意在退出之前调用 Sync
	Flush()
}

type Options struct {
	// Logger 的名字
	Name string `json:"name" mapstructure:"name"`
	// 是否是开发模式。如果是开发模式，会对 WarnLevel 以上进行堆栈跟踪；
	//               非开发模式，会对 PanicLevel 以上进行堆栈跟踪。
	Development bool `json:"development" mapstructure:"development"`
	// 日志级别，优先级从低到高依次为：Debug, Info, Warn, Error, Dpanic, Panic, Fatal
	Level string `json:"level" mapstructure:"level"`
	// 是否开启颜色输出，true，是；false，否
	EnableColor bool `json:"enable-color" mapstructure:"enable-color"`
	// 是否开启 caller，如果开启会在日志中显示调用日志所在的文件、函数和行号
	DisableCaller bool `json:"disable-caller" mapstructure:"disable-caller"`
	// 是否在 WarnLevel（开发模式） 或 PanicLevel（非开发模式） 及以上级别禁止打印堆栈信息
	DisableStacktrace bool `json:"disable-stacktrace" mapstructure:"disable-stacktrace"`
	// 支持的日志输出格式，支持 Console 和 JSON 两种
	Format string `json:"format" mapstructure:"format"`
	// 支持输出到多个输出，用逗号分开。支持输出到标准输出（stdout）和文件
	OutputPaths []string `json:"output-paths" mapstructure:"output-paths"`
	// zap 内部 (非业务) 错误日志输出路径，多个输出，用逗号分开
	ErrorOutputPaths []string `json:"error-output-paths" mapstructure:"error-output-paths"`
	// MaxSize 是日志文件轮转之前的最大大小（MB）。默认为 100MB。
	MaxSize int `json:"maxsize" mapstructure:"maxsize"`
	// MaxAge 是根据文件名中编码的时间戳保留旧日志文件的最大天数。
	MaxAge int `json:"maxage" mapstructure:"maxage"`
	// MaxBackups 是要保留的旧日志文件的最大数量。
	MaxBackups int `json:"maxbackups" mapstructure:"maxbackups"`
	// Compress 确定是否应使用 gzip 压缩轮转的日志文件。
	Compress bool `json:"compress" mapstructure:"compress"`
	// Port 用于指定动态修改日志输出级别端口，默认为 0 （不开启）。
	Port int `json:"port" mapstructure:"port"`
}