README

Prerequisites for this fork

PHP 8.x with DOM, Json, XML, XMLWriter and ZLib support (PHP 8.1 or later recommended)
Release 2.x.x will only work with PHP >= 8.1 - typical for most source code & docker image installs in 2023 and later. Note: updating .epub files for metadata or cover requires a 64-bit platform
Release 1.x.x still works with PHP 7.4 if necessary - earlier PHP 7.x (or 5.x) versions are not supported with this fork

This package is used by mikespub/seblucas-cops and mikespub/epub-loader with the same PHP version restrictions for 1.x and 2.x releases

PHP EPub Meta (original)

This project aims to create a PHP class for reading and writing metadata included in the EPub ebook format.

It also includes a very basic web interface to edit book metadata.

Please see the issue tracker for what's missing.

Forks and pull requests welcome.

About the EPub Manager Web Interface

The manager expects your ebooks in a single flat directory (no subfolders). The location of that directory has to be configured at the top of the index.php file.

All the epubs need to be read- and writable by the webserver.

The manager also makes some assumption on how the files should be named. The format is: <Author file-as>-<Title>.epub. Commas will be replaced by __ and spaces are replaced by _.

Note that the manager will RENAME your files to that form when saving.

Using the "Lookup Book Data" link will open a dialog that searches the book at Google Books you can use the found data using the "fill in" and "replace" buttons. The former will only fill empty fields, while the latter will replace all data. Author filling is missing currently.

Installing via Composer

You can use this package in your projects with Composer. Just add these lines to your project's composer.json:

    "require": {
        "mikespub/php-epub-meta": "dev-main",
    }

mikespub / php-epub-meta

Maintainers

Details

README

Prerequisites for this fork

PHP EPub Meta (original)

About the EPub Manager Web Interface

Installing via Composer