配置指南

配置指南

Configuration Guide

环境变量配置

MyBlog 支持使用环境变量进行配置，推荐在生产环境中使用。

快速开始

  1. 复制 env.example 为 .env：

``bash cp env.example .env ``

  1. 编辑 .env 文件，修改相应的配置值
  1. 确保 .env 文件已添加到 .gitignore（已默认添加）

配置项说明

博客基本信息

BLOG_TITLE=步子哥的博客
BLOG_DESCRIPTION=笔记与思考分享
BLOG_AUTHOR=步子哥 Steper

缓存配置

# 是否启用缓存
CACHE_ENABLED=true

# 缓存类型：auto（自动探测）、file（文件缓存）、redis（Redis 缓存）、both（同时使用）
CACHE_TYPE=auto

# 缓存 TTL（秒），0 表示不基于时间失效
CACHE_TTL=3600

# 缓存目录（文件缓存使用）
CACHE_DIR=_blog/src/cache

Redis 配置

如果使用 Redis 缓存，需要配置以下项：

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=

Giscus 评论系统

GISCUS_REPO=username/repo
GISCUS_REPO_ID=your-repo-id
GISCUS_CATEGORY_ID=your-category-id
GISCUS_CATEGORY=General

获取配置值：

  1. 访问 https://giscus.app
  2. 按照向导配置
  3. 复制生成的配置值到 .env 文件

环境类型

# 生产环境
APP_ENV=production

# 开发环境
APP_ENV=development

调试模式

DEBUG=false

配置文件方式

如果不使用环境变量，可以直接在 _blog/config.php 中修改配置：

define('BLOG_TITLE', '步子哥的博客');
define('BLOG_DESCRIPTION', '笔记与思考分享');
define('BLOG_AUTHOR', '步子哥 Steper');

优先级

配置加载优先级（从高到低）：

  1. 环境变量（.env 文件）
  2. _blog/config.php 中的默认值

注意事项

  • .env 文件不应提交到版本控制系统
  • 生产环境建议使用环境变量管理敏感信息
  • 修改配置后可能需要清除缓存
← 返回目录