cops Download - cops Quellcode herunterladen

cops

Andere Kategorien

1.1.3 - 20190624

Herunterladen

COPS

COPS steht für Calibre OPDS (und HTML) PHP Server.

Weitere Einzelheiten finden Sie unter: Zuhause von COPS.

Vergessen Sie nicht, das Wiki zu überprüfen.

Warum ?

Meiner Meinung nach ist Calibre ein wunderbares Tool, aber es ist zu groß und weist zu viele Abhängigkeiten auf, um für seinen Content-Server verwendet zu werden.

Das ist der Hauptgrund, warum ich diesen OPDS-Server codiert habe. Ich brauchte ein einfaches Tool, das auf einem kleinen Server (in meinem Fall Seagate Dockstar) installiert werden konnte.

Ich dachte zunächst an Calibre2OPDS, aber da es eine statische Datei generiert, war keine Suche möglich.

Später habe ich einen einfachen HTML-Katalog hinzugefügt, der auf meinem Kobo nutzbar sein sollte.

Die Hauptvorteile von COPS sind also:

Es sind keine vielen Abhängigkeiten erforderlich.
Es ist nicht viel CPU oder RAM erforderlich.
Nicht viel Code.
Suche ist verfügbar.
Es hat Spaß gemacht, zu programmieren.

Wenn Sie den OPDS-Feed verwenden möchten, vergessen Sie nicht, am Ende Ihrer URL „feed.php“ anzugeben.

Sie müssen lediglich Ihr Calibre-Verzeichnis auf die von Ihnen bevorzugte Weise mit Ihrem COPS-Server synchronisieren (Dropbox, Bt Sync, Syncthing, ein mit Nextcloud freigegebenes Verzeichnis verwenden, ...).

Voraussetzungen

PHP 5.3, 5.4, 5.5, 5.6, 7.X oder hhvm mit GD-Bildverarbeitung, Libxml, Intl, Json und SQLite3-Unterstützung (PHP 5.6 oder höher empfohlen).
Ein Webserver mit PHP-Unterstützung. Ich habe mit verschiedenen Versionen von Nginx und Apache getestet. Andere Leute berichteten, dass es mit Apache und Cherokee funktioniert. Sie können auch den eingebetteten PHP-Server verwenden (https://github.com/seblucas/cops/wiki/Howto---PhpEmbeddedServer).
Der Pfad zu einer Kaliberbibliothek (metadata.db, Format- und Coverdateien).

Auf jedem Debian-basierten Linux können Sie Folgendes verwenden: apt-get install php5-gd php5-sqlite php5-json php5-intl

Wenn Sie Debian Stretch verwenden: apt-get install php7.0-gd php7.0-sqlite3 php7.0-json php7.0-intl php7.0-xml php7.0-mbstring php7.0-zip

Auf Centos müssen Sie möglicherweise Folgendes hinzufügen: yum install php-xml

Installieren Sie ein Release (einfachster Weg)

Extrahieren Sie die ZIP-Datei, die Sie von der Release-Seite erhalten haben, in einen Ordner im Webspace (sichtbar für den Webserver).
Wenn Sie eine Erstinstallation durchführen, kopieren Sie config_local.php.example nach config_local.php
Bearbeiten Sie config_local.php entsprechend Ihrer Konfiguration.
Fügen Sie bei Bedarf weitere Konfigurationselemente aus config_default.php hinzu

Wenn Sie Docker mögen, können Sie auch diesen Multiarch-Docker-Container von linuxserver.io ausprobieren. Er verfügt über Builds für x64, armhf und arm64.

Von Quellen installieren

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

Danach können Sie ab dem zweiten Schritt die vorherige Anleitung verwenden.

Beachten Sie, dass Sie statt des Klonens auch den neuesten Master als ZIP-Datei erhalten können

Beachten Sie, dass Sie, wenn Ihre PHP-Version niedriger als 5.6 ist, möglicherweise composer.lock entfernen müssen, bevor Sie mit der letzten Zeile beginnen.

Wo soll ich mein Calibre-Verzeichnis ablegen?

Lange Rede, kurzer Sinn: IMMER außerhalb des COPS-Verzeichnisses, insbesondere wenn COPS auf einem VPS/Server installiert ist. Wenn Sie meinen Rat befolgen, sind Ihre Daten sicher.

Wenn Sie Ihr Calibre-Verzeichnis in Ihrem Webverzeichnis ablegen und Nginx verwenden möchten, müssen Sie /etc/nginx/mime.types bearbeiten, um diese Zeilen hinzuzufügen:

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

Bekannte Probleme

Nicht viel, bis auf die schlechte Qualität des Codes (erstes PHP-Projekt überhaupt) ;)

Offene Probleme finden Sie unter https://github.com/seblucas/cops/issues

Brauche Hilfe

Bitte lesen Sie https://github.com/seblucas/cops/wiki und überprüfen Sie die FAQ.

Mitwirken

Wie Sie hier sehen konnten, schätze ich jeden Beitrag und es sind im Laufe der Zeit viele dazugekommen. Seien Sie also nicht schüchtern und reichen Sie Ihre Pull-Anfragen ein.

Hinweis für Übersetzer: Bitte verwenden Sie lieber Transifex, anstatt eine PR zu erstellen.

Ich habe nur eine Grenze (ich habe vielleicht mehr, aber diese ist die schlechtere): Das Ziel von COPS ist es, eine Alternative zum Content-Server von Calibre bereitzustellen und Calibre nicht vollständig zu ersetzen. Daher lehne ich jede PR ab, die Änderungen am Datenbankinhalt vornimmt.

Credits

Die Handhabung von Locale-Nachrichten ist von https://www.mind-it.info/2010/02/22/a-simple-approach-to-localization-in-php inspiriert
Die Funktion str_format stammt von http://tmont.com/blargh/2010/1/string-format-in-php
Alle Symbole stammen von Font Awesome: https://github.com/FortAwesome/Font-Awesome
Der inoffizielle OPDS-Validator: http://opds-validator.appspot.com/
Vielen Dank an alle Tester, Übersetzer und Mitwirkenden.
Von Freepik erstellte Feed-Symbole von der Flaticon-Website, lizenziert unter Creative Commons BY 3.0 http://www.flaticon.com und http://www.freepik.com
Ein großes Dankeschön an Jetbrains für die Unterstützung von COPS durch die Bereitstellung einer Reihe kostenloser Lizenzen für ihre Produkte seit mehreren Jahren!
Dieses Projekt wurde mit BrowserStack getestet.

Verwendete externe Bibliotheken:

JQuery: http://jquery.com/
Magnific Popup: http://dimsemenov.com/plugins/magnific-popup/
PHP-epub-meta: https://github.com/splitbrain/php-epub-meta mit einigen Änderungen von mir (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