源码地址:https://gitee.com/shuyugit/pafish-php
pafish(纸鱼博客)
轻量、独立部署的 PHP 博客 CMS,适合个人博客、内容站和小型团队站点。只需要 PHP 和 MySQL。
官网 · 使用文档 · 应用商店 · Gitee · GitHub
发行包自带默认主题、Sitemap 插件和 AI Foundation 插件;其他主题与插件在应用商店安装。
快速开始
- 从官网下载页下载发行包
pafish-php-vX.Y.Z.zip。 - 解压到网站根目录,确保根目录能看到
index.php、app/、public/。 - 访问
https://你的域名/install.php,填写数据库和管理员信息。 - 安装完成后删除
install.php,访问https://你的域名/admin/登录后台。
不要用仓库页的「下载 ZIP」部署。源码包不含
vendor/,装完首页会 500。请认准发行版里的同名 zip,并用附带的.sha256校验。
详细步骤、伪静态和目录权限见安装说明;宝塔用户见宝塔面板部署。
能做什么
- 写作:默认 Markdown 编辑器,也支持通过编辑器插件切换富文本格式;另有草稿、定时发布、置顶、密码文章、独立页面、微语、分类和标签。
- 阅读:评论和楼中楼、点赞收藏、搜索、归档、RSS、sitemap、亮暗模式。
- 运营:媒体库、评论审核、导航菜单、友情链接、侧边栏组件、SMTP 邮件。
- 管理:用户和角色、数据备份、内容迁移、在线更新、开放 API、手机管理 App。
- 扩展:主题、插件和应用商店。
正文格式与编辑器
默认编辑器保存 Markdown,渲染器使用仓库内置的 Parsedown 1.7.4 / Parsedown Extra 0.8.1 实现,不依赖后台临时下载第三方编辑器。Markdown 中的标准 HTML 会经过核心 HTML 白名单净化后渲染,危险标签和属性会被移除。
富文本编辑器以插件形式接入。插件声明 format: html 后,核心会保存正文格式并在保存时用 HTMLPurifier 白名单净化 HTML;停用或更换插件不会改变已经保存的正文。启用 HTML 富文本编辑器后,已有 Markdown 文章会先按 Markdown 渲染到编辑器中,编辑并保存后转为 HTML;已有 HTML 正文继续使用源码编辑器或 HTML 编辑器编辑。插件开发契约见编辑器插件说明。
环境要求
| 项目 | 要求 |
|---|---|
| PHP | 8.1+,启用 pdo、pdo_mysql、gd、zip、mbstring、intl、curl、openssl、json、fileinfo |
| MySQL | 5.7.6+,推荐 8.0 |
| Web 服务 | Nginx 或 Apache |
安装前请确认 post_max_size >= 16M、upload_max_filesize >= 12M。发行包已包含 Composer 依赖,生产环境不需要执行 Composer。
部署
- 普通主机 / 宝塔:按安装说明上传发行包,访问
install.php安装。 - Docker:见 DOCKER.md。GHCR 镜像可直接运行;首次发布前或需要从当前源码运行时,用
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build本地构建。 - 伪静态:Nginx 和 Apache 规则见安装说明的伪静态部分。
- 定时发布:建议每分钟执行
php /路径/cron.php;不配置也能用,前台访问会低频补发。 - 在线更新:后台「系统更新」从 Gitee 检查新版本,备份和恢复使用纯 PHP,不依赖
exec()、mysqldump或mysql命令。
文档
普通使用不需要看开发文档。
扩展订单
插件或主题可用扩展上下文创建、读取和更新自己命名空间中的订单:
$orderId = $ctx->createOrder('resource', 'item-42', '12.50', 'wechat');
$order = $ctx->getOrder($orderId);
// 支付回调完成签名和金额校验后再更新订单
$ctx->updateOrder($orderId, [
'status' => 'paid',
'pay_price' => '12.50',
'out_trade_no' => $gatewayTradeNumber,
]);
订单状态由核心限制为 pending、paid、failed、cancelled 和 refunded。订单保存在共享表中,但插件和主题之间相互隔离;核心只记录订单,不代替扩展接入或验证支付网关回调。
常见问题
- 首页 500,提示
vendor/autoload.php缺失:用了源码包,换发行包。 - 文章地址 404:伪静态没生效,见安装说明。
- 图片上传失败:检查上传限制和
public/uploads/权限。 - 中文搜索没有结果:确认 MySQL 5.7.6+ 和全文索引。
更多见常见问题。






还没有评论,来抢沙发吧。