Download the PHP package mikespub/seblucas-cops without Composer

On this page you can find all versions of the php package mikespub/seblucas-cops. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package seblucas-cops

COPS for PHP 8.x

Breaking changes for 3.x release (PHP >= 8.2)

For everyone

Less common

Prerequisites for this fork

User support issues remain available at https://github.com/seblucas/cops/issues - please use it if you need help with COPS in general. For the 2.x and 3.x versions please report any new issues at https://github.com/mikespub-org/seblucas-cops/issues

Pull requests should be against the latest source code at https://github.com/mikespub-org/seblucas-cops/pulls - thanks for any contributions :-)

See https://github.com/seblucas/cops from @seblucas

Installation of this fork

Same options as original:

  1. Release package

  2. Source code

  3. Docker image

    • use latest linuxserver/cops image from linuxserver.io - see setup and usage there
    • or use docker-compose-dev.yaml) as starting point - not optimized for size/performance
  4. Home Assistant Add-on

The rest of the installation process is very similar to the original below. But if you install from source, just use your regular composer 2.x - you don't need to download an old composer 1.x version or install global asset plugins anymore :-)

Notice: for a first-time installation, you need to copy http://.../checkconfig.php

COPS (original)

COPS stands for Calibre OPDS (and HTML) Php Server.

See : COPS's home for more details.

Don't forget to check the Wiki.

Why ?

In my opinion Calibre is a marvelous tool but is too big and has too much dependencies to be used for its content server.

That's the main reason why I coded this OPDS server. I needed a simple tool to be installed on a small server (Seagate Dockstar in my case).

I initially thought of Calibre2OPDS but as it generate static file no search was possible.

Later I added an simple HTML catalog that should be usable on my Kobo.

So COPS's main advantages are :

  • No need for many dependencies.
  • No need for a lot of CPU or RAM.
  • Not much code.
  • Search is available.
  • It was fun to code.

If you want to use the OPDS feed don't forget to specify feed.php at the end of your URL.

You just have to sync your Calibre directory to your COPS server the way you prefer (Dropbox, Bt Sync, Syncthing, use a directory shared with Nextcloud, ...).

Prerequisites (outdated)

  1. PHP 5.3, 5.4, 5.5, 5.6, 7.X or hhvm with GD image processing, Libxml, Intl, Json & SQLite3 support (PHP 5.6 or later recommended).
  2. A web server with PHP support. I tested with various version of Nginx and Apache. Other people reported it working with Apache and Cherokee. You can also use PHP embedded server (https://github.com/seblucas/cops/wiki/Howto---PhpEmbeddedServer)
  3. The path to a calibre library (metadata.db, format, & cover files).

On any Debian based Linux you can use : apt-get install php5-gd php5-sqlite php5-json php5-intl

If you use 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

On Centos you may have to add : yum install php-xml

Install a release (Easiest way)

  1. Extract the zip file you got from the release page to a folder in web space (visible to the web server).
  2. If you're doing a first-time install, copy config/local.php.example to config/local.php (this differs from the original project)
  3. Edit config/local.php to match your config.
  4. If needed add other configuration item from config/default.php

If you like Docker, you can also try this multiarch docker container from linuxserver.io It has builds for x64 and arm64.

Install from sources

After that you can use the previous how-to starting at the second step.

Note that instead of cloning you can also get latest master as zip

Note that if your PHP version is lower that 5.6, then you may have to remove composer.lock before starting the last line.

Where to put my Calibre directory ?

Long story short : ALWAYS outside of COPS's directory especially if COPS is installed on a VPS / Server. If you follow my advice then your data will be safe.

If you choose to put your Calibre directory inside your web directory and use Nginx then you will have to edit /etc/nginx/mime.types to add these lines :

Known problems

Not a lot, except for the bad quality of the code (first PHP project ever) ;)

Please see https://github.com/seblucas/cops/issues for open issues

Need help

Please read https://github.com/seblucas/cops/wiki and check the FAQ.

Contributing

As you could see here, I appreciate every contributions and there were a lot over time. So don't be shy and submit your Pull Requests.

Note to translators : please prefer using Transifex instead of doing a PR.

I only have one limit (I may have more but that one is the worse) : COPS' goal is to provide an alternative to Calibre's content server and not to replace Calibre entirely. So I will refuse any PR making changes to the database content.

Credits

External libraries used :

Copyright & License

COPS - 2012-2019 (c) Sébastien Lucas

See LICENSE and file headers for license info

All versions of seblucas-cops with dependencies

PHP Build Version
Package Version
Requires php Version >=8.2
ext-dom Version *
ext-gd Version *
ext-intl Version *
ext-json Version *
ext-mbstring Version *
ext-pdo_sqlite Version *
ext-xml Version *
ext-zip Version *
ext-zlib Version *
mikespub/epubjs-reader Version ^2024.10
mikespub/php-epub-meta Version ^3.3
nikic/fast-route Version 2.0.0-beta1
npm-asset/bootstrap Version ^3.4
npm-asset/dot Version ^1.1
npm-asset/jquery Version ^3.7
npm-asset/js-cookie Version ^3.0
npm-asset/lru-fast Version ^0.2
npm-asset/magnific-popup Version ^1.2
npm-asset/normalize.css Version ^8.0
npm-asset/corejs-typeahead Version ^1.3
npm-asset/twig Version ^1.17
phpmailer/phpmailer Version ^6.9
twig/twig Version ^3.14
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package mikespub/seblucas-cops contains the following files

Loading the files please wait ....