cops Télécharger - cops Téléchargement du code source

cops

Autres catégories

1.1.3 - 20190624

Télécharger

FLIC

COPS signifie Caliber OPDS (et HTML) Php Server.

Voir : Accueil du COPS pour plus de détails.

N'oubliez pas de consulter le Wiki.

Pourquoi ?

À mon avis, Calibre est un outil merveilleux mais il est trop gros et comporte trop de dépendances pour être utilisé pour son serveur de contenu.

C'est la principale raison pour laquelle j'ai codé ce serveur OPDS. J'avais besoin d'un outil simple à installer sur un petit serveur (Seagate Dockstar dans mon cas).

J'ai d'abord pensé à Calibre2OPDS mais comme il génère un fichier statique, aucune recherche n'était possible.

Plus tard, j'ai ajouté un simple catalogue HTML qui devrait être utilisable sur ma Kobo.

Les principaux avantages de COPS sont donc :

Pas besoin de nombreuses dépendances.
Pas besoin de beaucoup de CPU ou de RAM.
Pas beaucoup de code.
La recherche est disponible.
C'était amusant de coder.

Si vous souhaitez utiliser le flux OPDS n'oubliez pas de préciser feed.php à la fin de votre URL.

Il vous suffit de synchroniser votre répertoire Caliber avec votre serveur COPS comme vous préférez (Dropbox, Bt Sync, Syncthing, utiliser un répertoire partagé avec Nextcloud, ...).

Conditions préalables

PHP 5.3, 5.4, 5.5, 5.6, 7.X ou hhvm avec traitement d'image GD, prise en charge Libxml, Intl, Json et SQLite3 (PHP 5.6 ou version ultérieure recommandée).
Un serveur Web avec support PHP. J'ai testé avec différentes versions de Nginx et Apache. D'autres personnes ont signalé qu'il fonctionnait avec Apache et Cherokee. Vous pouvez également utiliser le serveur intégré PHP (https://github.com/seblucas/cops/wiki/Howto---PhpEmbeddedServer)
Le chemin d'accès à une bibliothèque calibre (metadata.db, format et fichiers de couverture).

Sur n'importe quel Linux basé sur Debian, vous pouvez utiliser : apt-get install php5-gd php5-sqlite php5-json php5-intl

Si vous utilisez 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

Sur Centos vous devrez peut-être ajouter : yum install php-xml

Installer une version (moyen le plus simple)

Extrayez le fichier zip que vous avez obtenu de la page de publication dans un dossier de l'espace Web (visible par le serveur Web).
Si vous effectuez une première installation, copiez config_local.php.example dans config_local.php.
Modifiez config_local.php pour qu'il corresponde à votre configuration.
Si nécessaire, ajoutez un autre élément de configuration à partir de config_default.php

Si vous aimez Docker, vous pouvez également essayer ce conteneur Docker multiarch de linuxserver.io. Il contient des versions pour x64, armhf et arm64.

Installer à partir des sources

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

Après cela, vous pouvez utiliser la procédure précédente en commençant par la deuxième étape.

Notez qu'au lieu de cloner, vous pouvez également obtenir le dernier master au format zip.

Notez que si votre version de PHP est inférieure à 5.6, vous devrez peut-être supprimer composer.lock avant de commencer la dernière ligne.

Où mettre mon répertoire Calibre ?

Pour faire court : TOUJOURS en dehors du répertoire COPS surtout si COPS est installé sur un VPS/Serveur. Si vous suivez mes conseils, vos données seront en sécurité.

Si vous choisissez de placer votre répertoire Calibre dans votre répertoire Web et d'utiliser Nginx alors vous devrez éditer /etc/nginx/mime.types pour ajouter ces lignes :

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

Problèmes connus

Pas grand chose, hormis la mauvaise qualité du code (premier projet PHP jamais réalisé) ;)

Veuillez consulter https://github.com/seblucas/cops/issues pour les problèmes ouverts

Besoin d'aide

Veuillez lire https://github.com/seblucas/cops/wiki et consulter la FAQ.

Contribuer

Comme vous avez pu le voir ici, j'apprécie chaque contribution et il y en a eu beaucoup au fil du temps. Alors ne soyez pas timide et soumettez vos Pull Requests.

Note aux traducteurs : veuillez préférer utiliser Transifex plutôt que de faire un PR.

Je n'ai qu'une seule limite (j'en ai peut-être plus mais celle-là est la pire) : le but de COPS est de proposer une alternative au serveur de contenu de Calibre et non de remplacer entièrement Calibre. Je refuserai donc tout PR apportant des modifications au contenu de la base de données.

Crédits

La gestion des messages locaux est inspirée de https://www.mind-it.info/2010/02/22/a-simple-approach-to-localization-in-php
La fonction str_format provient de http://tmont.com/blargh/2010/1/string-format-in-php
Toutes les icônes proviennent de Font Awesome : https://github.com/FortAwesome/Font-Awesome
Le validateur non officiel OPDS : http://opds-validator.appspot.com/
Merci à tous les testeurs, traducteurs et contributeurs.
Icônes de flux créées par Freepik à partir du site Web Flaticon sous licence Creative Commons BY 3.0 http://www.flaticon.com et http://www.freepik.com
Un grand merci à Jetbrains pour avoir soutenu COPS en fournissant un ensemble de licences gratuites pour leurs produits depuis plusieurs années maintenant !
Ce projet est testé avec BrowserStack.

Bibliothèques externes utilisées :

JQuery : http://jquery.com/
Magnifique Popup : http://dimsemenov.com/plugins/magnific-popup/
Php-epub-meta : https://github.com/splitbrain/php-epub-meta avec quelques modifications de ma part (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