cops

慢性阻塞性肺病

COPS 代表 Calibre OPDS（和 HTML）Php 服务器。

请参阅：COPS 主页了解更多详细信息。

不要忘记查看维基百科。

为什么 ？

在我看来，Calibre 是一个很棒的工具，但它太大了，并且对其内容服务器有太多依赖项。

这就是我编写这个 OPDS 服务器的主要原因。我需要在小型服务器上安装一个简单的工具（在我的例子中是 Seagate Dockstar）。

我最初想到了 Calibre2OPDS，但由于它生成静态文件，因此无法进行搜索。

后来我添加了一个简单的 HTML 目录，应该可以在我的 Kobo 上使用。

所以COPS的主要优点是：

• 不需要很多依赖。
• 不需要大量的 CPU 或 RAM。
• 代码不多。
• 可以进行搜索。
• 编码很有趣。

如果您想使用 OPDS feed，请不要忘记在 URL 末尾指定 feed.php。

您只需按照您喜欢的方式将 Calibre 目录同步到 COPS 服务器（Dropbox、Bt Sync、Syncthing、使用与 Nextcloud 共享的目录...）。

先决条件

1. PHP 5.3、5.4、5.5、5.6、7.X 或 hhvm，支持 GD 图像处理、Libxml、Intl、Json 和 SQLite3（推荐使用 PHP 5.6 或更高版本）。
2. 支持 PHP 的 Web 服务器。我用不同版本的 Nginx 和 Apache 进行了测试。其他人报告说它与 Apache 和 Cherokee 一起工作。您还可以使用 PHP 嵌入式服务器 (https://github.com/seblucas/cops/wiki/Howto---PhpEmbeddedServer)
3. calibre 库的路径（metadata.db、格式和封面文件）。

在任何基于 Debian 的 Linux 上，您可以使用： apt-get install php5-gd php5-sqlite php5-json php5-intl

如果您使用 Debian Stretch ： apt-get install php7.0-gd php7.0-sqlite3 php7.0-json php7.0-intl php7.0-xml php7.0-mbstring php7.0-zip

在 Centos 上你可能需要添加： yum install php-xml

安装版本（最简单的方法）

1. 将您从发布页面获得的 zip 文件解压缩到 Web 空间中的文件夹（Web 服务器可见）。
2. 如果您是首次安装，请将 config_local.php.example 复制到 config_local.php
3. 编辑 config_local.php 以匹配您的配置。
4. 如果需要，请从 config_default.php 添加其他配置项

如果您喜欢 Docker，您还可以尝试来自 linuxserver.io 的多架构 docker 容器，它具有针对 x64、armhf 和 arm64 的构建。

从源安装

git clone https://github.com/seblucas/cops.git # or download lastest zip see below
cd cops
wget https://getcomposer.org/composer.phar
php composer.phar global require " fxp/composer-asset-plugin:~1.1 "
php composer.phar install --no-dev --optimize-autoloader

之后，您可以从第二步开始使用之前的操作方法。

请注意，除了克隆之外，您还可以获得 zip 形式的最新主版本

请注意，如果您的 PHP 版本低于 5.6，那么您可能必须在开始最后一行之前删除composer.lock 。

我的 Calibre 目录应该放在哪里？

长话短说：始终位于 COPS 目录之外，尤其是当 COPS 安装在 VPS/服务器上时。如果您遵循我的建议，那么您的数据将是安全的。

如果您选择将 Calibre 目录放在 Web 目录中并使用 Nginx，则必须编辑 /etc/nginx/mime.types 以添加以下行：

 application/epub+zip epub;
application/x-mobipocket-ebook mobi prc azw;

已知问题

不是很多，除了代码质量很差（第一个 PHP 项目）；）

请参阅 https://github.com/seblucas/cops/issues 了解未解决的问题

需要帮助

请阅读 https://github.com/seblucas/cops/wiki 并查看常见问题解答。

贡献

正如您在这里所看到的，我感谢每一个贡献，并且随着时间的推移，我做出了很多贡献。因此，不要害羞并提交您的 Pull 请求。

译者请注意：请优先使用 Transifex，而不是进行 PR。

我只有一个限制（我可能有更多，但那个更糟糕）：COPS 的目标是提供 Calibre 内容服务器的替代方案，而不是完全取代 Calibre。所以我会拒绝任何对数据库内容进行更改的 PR。

制作人员

• 区域设置消息处理的灵感来自 https://www.mind-it.info/2010/02/22/a-simple-approach-to-localization-in-php
• str_format 函数来自http://tmont.com/blargh/2010/1/string-format-in-php
• 所有图标均来自 Font Awesome ：https://github.com/FortAwesome/Font-Awesome
• 非官方 OPDS 验证器：http://opds-validator.appspot.com/
• 感谢所有测试人员、翻译人员和贡献者。
• 由 Freepik 从 Flaticon 网站制作的 Feed 图标，获得知识共享 BY 3.0 http://www.flaticon.com 和 http://www.freepik.com 许可
• 非常感谢 Jetbrains 多年来对 COPS 的支持，为其产品提供了一套免费许可证！
• 该项目使用 BrowserStack 进行测试。

使用的外部库：

• jQuery：http://jquery.com/
• 华丽的弹出窗口：http://dimsemenov.com/plugins/magnific-popup/
• Php-epub-meta ：https://github.com/splitbrain/php-epub-meta，我进行了一些修改（https://github.com/seblucas/php-epub-meta）
• TbsZip：http://www.tinybutstrong.com/apps/tbszip/tbszip_help.html
• DoT.js：http://olado.github.io/doT/index.html
• PHPMailer：https://github.com/PHPMailer/PHPMailer
• js-lru ：https://github.com/rsms/js-lru

版权与许可

COPS - 2012-2019 (c) 塞巴斯蒂安·卢卡斯

请参阅复制和文件头以获取许可证信息