项目简介
这是一个基于 PHP 的文档托管项目,形象地被称为“书架”,可在单一站点上存放大量文档。不过最初代码编写不够规范,前后端交错,调用关系复杂,使用体验和可读性都欠佳,后续有待完善。
项目的主要特性和功能
- 多文档托管:支持上传并托管多种格式的文档。
- 基础访问控制:能对文档的访问权限进行基本限制。
- 全文搜索:提供简单的全文搜索功能,方便查找特定文档。
- 动态页面生成:借助 PHP 和模板引擎动态生成包含头部、页脚和导航菜单的 HTML 页面。
- Markdown 解析:可将 Markdown 文档解析为 HTML 并进行基本的高亮和格式化。
安装使用步骤
环境要求
- Web 服务器:需支持
.htaccess
的 Web 服务器,若使用 Apache,要启用rewrite
模块并设置网站根目录的AllowOverride All
;使用其他服务器,需自行转换.htaccess
规则。 - PHP 版本:PHP 8.1 及以上,同时安装
xml
(可能叫dom
)、mbstring
、fileinfo
模块。 - Composer:使用 Composer 工具安装项目依赖,也可将其直接安装在网站根目录。
- PHP 配置:在
php.ini
中把display_errors
和display_startup_errors
设置为Off
,或关闭E_WARNING
及以下日志;将open_basedir
配置为仅包含 ph-bookshelf 本身的目录,防止路径攻击。
安装步骤
- 下载或复制本项目的源码文件。
- 将文件拖入 PHP 站点根目录。
使用说明
按照上述环境要求,像普通 PHP 网站一样进行安装。若需更详细的安装教程,可查看 ph-bookshelf Wiki。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】