suk-ws / ph-bookshelf

一个简单简洁(?)的文档书架实现。

ph-Bookshelf

一个可以在单一站点上放一大堆文档的文档托管项目——我们把它称之为书架。

因为 web 相关的东西 Sukazyo 最熟悉的就是 php 了所以就用 php 写的。 但是写出来的代码还是十分离谱的不易读的：各种调用交错在一起，前后端也交错在一起

而且也并不好用，不好用到几乎没办法写教程...那种...至少现在如此。

有时间的话会补充的（en

安装

下载/clone此仓库的内容，然后拖进 php 站点根目录即可。

web-server 环境要求

• 支援 .htaccess 的 Webserver
  • 如果使用 Apache:
    • 启用模块 rewrite
      • 为网站根目录设置 AllowOverride All
  • 使用其它 Webserver，可以自行查询如何将 .htaccess 规则转换为你所使用的网站配置并写进你的网站配置当中
• PHP 版本 8.1 以上
  • PHP 模块 xml (也可能叫做 dom)
  • PHP 模块 mbstring
  • PHP 模块 fileinfo
  • composer 工具以安装项目依赖 (也可以将 compose 工具直接安装在网站根目录)
  • 在 php.ini 中设置 display_errors 以及 display_startup_errors 为 Off (或者关闭 E_WARNING 及以下 log) (这是由于最开始写代码极不上心导致很多地方都会有可能报出 warn，输出在屏幕上会导致很糟糕的使用体验)
  • 在网站的 php.ini 或者其它任何地方 php 配置 open_basedir 为只有 ph-bookshelf 本身的目录，以避免路径攻击。

使用

可以根据 [#web-server 环境要求] 就像普通 php 网站那样自行安装。

如果想要更详细的安装教程，可以尝试阅读（还在更新中的）ph-bookshelf Wiki

开源许可

MIT License.

ph-bookshelf's Issues

标题栏通过方向键进行定位和选取