一个单入口实现思路做的轻量博客：

• 主程序集中在 index.php
• 安装流程集中在 install.php
• SQLite 存储

• 首页文章列表
• 文章详情页
• 文章评论列表、访客/登录用户评论表单与评论回复
• 独立页面
• 归档页
• 标签聚合页
• RSS 输出
• 管理员登录
• 后台文章管理
• 后台评论审核、未读通知与删除管理
• 草稿、发布、定时发布
• 站点基础设置
• 可扩展前台主题、主题资源与 action/filter 钩子
• 可启停插件、插件 action/filter 钩子与后台插件管理
• 内置可选的英文界面语言插件
• 内置可启停的 AI 辅助、邮件通知与 S3 附件上传插件，配置分别独立保存
• 独立主题管理，可预览并切换前台主题
• 后台自动检查 GitHub Release 并一键更新程序
• 可选伪静态 URL
• 基础 Markdown 渲染
• 网易云音乐、哔哩哔哩、YouTube 和豆瓣媒体链接自动解析

在文章或独立页面中把受支持的媒体链接单独放在一段，发布后会自动转换：

• 网易云音乐单曲、歌单和专辑链接转换为播放器
• 哔哩哔哩和 YouTube 链接转换为响应式视频播放器
• 豆瓣电影、音乐或图书的 subject 链接转换为资料跳转卡片

链接必须使用完整的 http:// 或 https:// 地址。链接与其他文字写在同一段时会保留为普通链接。

• PHP 8.0+
• pdo_sqlite 扩展
• fileinfo 扩展
• 使用 S3 上传时需要 curl 扩展
• Apache / Nginx / Caddy / PHP 内置服务器

1. 只上传 installer.php 到准备安装博客的空目录。
2. 在浏览器访问 installer.php。
3. 环境检查通过后，点击“下载并部署”。安装器会从官方 GitHub Release 下载最新稳定版。
4. 部署完成后继续初始化站点，并从服务器删除 installer.php。

安装器要求 PHP 8.0+、curl、zip、pdo_sqlite 和 fileinfo 扩展。它不会覆盖目录中的同名文件，写入失败时会回滚本次已创建的程序文件。

1. 把项目放到 Web 根目录或子目录。
2. 确保 data/ 和 cache/ 可写。
3. 访问 install.php。
4. 选择中文或 English 安装提示，填写站点信息和管理员账号。安装器会自动创建 Hello World 作为第一篇文章。
5. 安装完成后进入后台继续配置。

index.php      主入口
install.php    安装页
installer.php  单文件自动部署器
index.css      前后台样式
index.js       前台交互
.htaccess      Apache 重写和目录保护
data/          SQLite、安装锁、配置
cache/         设置缓存
uploads/       本地上传文件及可选的 S3 备份
themes/        自定义前台主题
plugins/       功能插件与语言插件

• settings 表保存站点基础设置。
• cache/settings.php 是站点基础设置缓存，用于减少常规页面读取数据库。
• ai_settings 表保存 AI 接口、模型、提示词和 API Key，不写入缓存文件。
• mail_settings 表保存 SMTP 主机、账号、密码、发件人和通知收件人，不写入缓存文件。
• s3_settings 表保存 S3 Endpoint、Bucket、访问密钥和上传选项，不写入缓存文件。
• 后台保存站点基础设置会刷新 cache/settings.php。
• 后台保存 AI、邮件通知或 S3 设置只更新对应独立数据表。

• 每个主题放在 themes/<主题目录>/，并提供 theme.json。
• 可通过 style.css 覆盖前台样式，通过 functions.php 注册 action/filter 钩子，也可用 layout.php 接管完整前台布局。
• 后台“主题管理”可预览并启用主题；无效或被删除的主题会回退到内置主题。
• 主题开发接口与完整钩子列表见 themes/README.md。
• 一键更新只覆盖程序发布文件，不会清空额外的自定义主题目录。

• 每个插件放在 plugins/<插件目录>/，并提供 plugin.json 和 plugin.php。
• 后台“插件管理”可以启用、停用和设置插件；内置功能插件不再占用独立侧边栏入口。
• 插件可使用带优先级的 action/filter 扩展请求、文章保存、评论创建、后台菜单和最终 HTML 输出。
• 项目内置 ai-assistant、email-notifications 和 s3-storage 功能插件，新安装默认启用，可分别停用。
• 项目内置 english-language 与 russian-language 插件，启用后会将前台、登录页和后台系统界面翻译为对应语言，不修改数据库中的文章内容；语言插件之间互斥。
• 插件开发接口与完整钩子列表见 plugins/README.md。
• 插件 PHP 是服务器端可信代码，只安装来源可信的插件。

启用 s3-storage 插件并在后台“S3 存储”中开启后：

• 新附件会通过 AWS Signature V4 上传到 S3 或兼容服务。
• 对象键格式为“路径前缀/年份/随机文件名”。
• 可填写包含协议的完整 CDN 域名；附件 URL 会使用该域名拼接对象键，留空时使用 Endpoint 生成地址。
• MinIO 等需要 Path-style 地址的服务可开启对应选项。
• 开启“在本地保留上传备份”时，同一文件也会写入 uploads/年份/；关闭时不在站点目录落盘。
• S3 上传失败时不会插入附件链接；启用本地备份时，本次失败产生的本地文件也会删除。

启用 email-notifications 插件后，可选择使用 SMTP；关闭 SMTP 时会尝试服务器 PHP mail()：

• 忘记密码邮件会优先通过 SMTP 发送。
• 新评论提交成功后，如站点设置里开启“新评论显示后台提醒”，会发送新评论通知邮件。
• 通知收件邮箱优先使用邮件通知设置中的收件邮箱；留空时使用第一个管理员邮箱。
• SMTP 发送失败不会阻止评论提交。
• 密码重置仍会在 cache/password-reset-*.txt 写入兜底链接。

如果本机有 PHP：

php -S 127.0.0.1:8000

然后访问：

http://127.0.0.1:8000/install.php

后台开启后，公开页面和主要管理页面会使用这类路径：

• /
• /page/2
• /archives
• /tags
• /tag/php
• /archive/your-slug
• /about
• /rss.xml
• /login
• /admin
• /write
• /edit/12

Apache 已可直接使用仓库里的 .htaccess。

如果你用 Nginx，可以参考：

location ^~ /data/ { deny all; }
location ^~ /cache/ { deny all; }
location ~* ^/themes/.+\.(?:php|json)$ { deny all; }
location ~* ^/plugins/.+\.(?:php|json|md)$ { deny all; }

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass unix:/run/php/php-fpm.sock;
}

• data/ 和 cache/ 不应该被公网直接访问
• ai_settings、mail_settings 和 s3_settings 中包含后端密钥类配置，请只通过后台修改
• 如果要重装，先删除 data/install.lock
• 更新程序后如涉及数据库结构变更，请先登录后台，再访问 update.php 执行升级
• 一键更新会保留 data/、cache/、uploads/、用户自建主题和插件，递归合并发布包中的 themes/ 与 plugins/，并将被覆盖的程序、主题与插件文件备份到 cache/update-backup-*。升级后若检测到内置主题或插件缺失，会自动再次读取当前 Release 补齐文件

https://github.com/jkjoy/Simple-PHP-Blog

Welcome to WordPress. This is your first post. Edit or delete it, then start writing!