README

PHP 8.x 的分支

自 v3.0.x 以来更新的框架

BicBucStriim 现在运行在 Slim 4 框架上，使用 Nikic FastRoute、PSR-15 中间件、PHP-DI 容器和 Nyholm PSR-7 包。

注意：从 v1.x 到 v3.x 的跳跃是为了避免与上方其他分支的 2.x 标签重叠，这些分支都已暂停，除非有人有兴趣进一步工作...

自 v1.7.x 以来新的代码结构

大部分位于 index.php 内的遗留代码都被拆分并移动到 config 和 src 目录下，其中 config/settings.php 包含配置设置，而 config/routes.php 通过分组添加了到不同 src/Actions 的路由。没有功能上的变化，但这应该会比一个包含所有内容的巨大文件更容易进行代码维护 :-)

config/
├── bootstrap.php
├── config.php
├── constants.php
├── langs.php
├── middleware.php
├── routes.php
└── settings.php
index.php
src
├── Actions
│   ├── admin.php
│   ├── default.php
│   ├── main.php
│   ├── metadata.php
│   └── opds.php
├── AppData
│   ├── bicbucstriim.php
│   ├── calibre_thing.php
│   └── ...
├── Calibre
│   ├── calibre.php
│   └── ...
├── Middleware
│   ├── caching_middleware.php
│   └── ...
├── Session
│   ├── ...
│   └── session_factory.php
├── Traits
│   ├── app_trait.php
│   └── ...
├── app.php
├── ...
└── view.php

介绍（原文）

BicBucStriim 提供书籍和数字书籍的流媒体服务。它填补了当前网络附加存储（NAS）设备功能的空白，这些设备可以访问音乐、视频和照片，但不能访问书籍。BicBucStriim 填补了这一空白，并提供了基于网页的电子书收藏访问。

当我在 Synology DS 512+ 网络附加存储设备上购买存储我的媒体时，我创建了 BicBucStriim。像 Synology DS 这样的网络附加存储设备通常包含媒体服务器，可以发布音频、视频和照片，这样您就可以从所有类型的设备（电视、智能手机、笔记本电脑等）在家中访问您的媒体，这非常方便。不幸的是，电子书没有这样的东西。因此，创建了 BicBucStriim。

BicBucStriim 是一个简单的 PHP 应用程序，它运行在 NAS 提供的 Apache/PHP 环境中。它假设您使用 Calibre 管理您的电子书收藏。应用程序读取 Calibre 数据并以 HTML 形式发布它。要访问电子书目录，只需将您的电子书阅读器指向您的 NAS，选择您的一本电子书并下载它。

功能 & 问题

在主页上显示您图书馆的最新标题
有浏览书籍标题、作者、标签和系列的分区
可以下载或通过电子邮件发送个别书籍
可以添加您最喜欢的作者的信息（链接、图片）
全局搜索
支持荷兰语、英语、法语、德语、加利西亚语、意大利语
适用于移动客户端
提供基于登录的访问控制
用户可以按书籍语言和/或标签进行限制
提供 OPDS 书籍目录，适用于 Stanza 等阅读应用程序
提供用于配置的行政 GUI
不支持 Calibre 的虚拟图书馆
仅支持简单的自定义列

安装

有三种安装选项

下载安装存档。这些都是稳定版本，具有较小的占用空间，删除了不必要的文件。
直接从 Github 通过克隆一个发布标签进行安装。这些也是稳定版本，但包含存储库中的所有文件。
冒险克隆/fork Github 主分支。请注意，该分支通常包含一个处于开发中的版本，可能运行缓慢或部分损坏。

简单的方法假设 BicBucStriim 位于您的设备网页根目录下方，并且可以像 http://<your ip>/bbs/ 一样访问

解压以下位于您的NAS网络服务器根目录下的下载压缩包（例如，Synology设备上的"/volume1/web"）。
将新创建的目录（例如，BicBucStriim-1.2.0.zip）重命名为“bbs”。
"data"目录及其内容必须对所有用户可写。根据您的解压方法，这可能是默认设置。但是，如果您遇到访问错误，请使用终端进行更正：chmod -R ga+w data。
BicBucStriim现在应该可以工作了，打开您的网页浏览器，导航到http://<您的NAS地址>/bbs/
使用默认登录admin/admin以管理员身份登录（请记住之后更改密码）。
全新安装的BicBucStriim应用将显示管理员部分，在那里您将需要告诉应用您的Calibre图书馆的位置。其他一切都是可选的。请查看一下。
OPDS目录在http://.../bbs/opds/提供

升级

版本1.2的数据库结构与早期版本不兼容，因此现有用户应从全新安装开始。然而，如果您有很多书籍并且不想为它们重新生成所有缩略图

备份旧的BicBucStriim安装，例如mv bbs bbs.old
安装新版本并运行它
应该有一个新目录：bbs/data/titles
将缩略图文件（thumb_*.png）从旧data目录复制到bbs/data/titles
如果复制后存在访问错误，请使用chmod -R ga+w bbs/data/titles更正权限

之后，缩略图应该再次出现。

故障排除

如果您遇到问题，请使用安装测试来检查您的环境。通过导航到http://<NAS地址>/bbs/installcheck.php来调用此测试。此测试检查了用户在过去遇到的一些问题。

要求

BicBucStriim通过网络服务器发布Calibre图书馆，因此它需要在您的机器上预先安装一些模块。所需的模块是NAS常见的模块，但是您应该首先检查您的设备是否支持它们

Apache网络服务器和PHP 8.0+，包括对sodium和sqlite3的支持
可选：如果安装了PHP模块intl（php-intl），则可以显示书籍语言

如果您无法/不想使用Apache：已知BicBucStriim也与其他网络服务器一起工作。请查看维基以获取其他配置信息。

许可证

BicBucStriim本身受MIT许可证许可，有关所用库的许可证，请参阅NOTICE文件。

(MIT许可证)

特此授予任何获得此软件及其相关文档文件（“软件”）副本的任何人免费处理该软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利，并允许获得该软件的人这样做，但受以下条件限制

mikespub / rvolz-bicbucstriim

维护者

详细信息