PHPackages                             mikespub/php-epub-meta - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. mikespub/php-epub-meta

ActiveLibrary[Utility & Helpers](/categories/utility)

mikespub/php-epub-meta
======================

Reading and writing metadata included in the EPub ebook format

4.1.1(2mo ago)52.3k—0%3MITPHPPHP >=8.4

Since Sep 9Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/mikespub-org/php-epub-meta)[ Packagist](https://packagist.org/packages/mikespub/php-epub-meta)[ Docs](https://github.com/mikespub-org/php-epub-meta)[ RSS](/packages/mikespub-php-epub-meta/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (41)Used By (3)

PHP EPub Meta
=============

[](#php-epub-meta)

Prerequisites for this fork
---------------------------

[](#prerequisites-for-this-fork)

- PHP 8.x with DOM, Json, XML, Zip and ZLib support (PHP 8.4 or later recommended)
- Release 4.x.x will only work with PHP >= 8.4 - typical for most source code & docker image installs in 2025 and later. *Note: updating .epub files for metadata or cover requires a 64-bit platform*
- Release 3.x.x will only work with PHP >= 8.2 - typical for most source code & docker image installs in 2024 and later. *Note: updating .epub files for metadata or cover requires a 64-bit platform*
- 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](https://packagist.org/packages/mikespub/seblucas-cops) and [mikespub/epub-loader](https://packagist.org/packages/mikespub/epub-loader) with the same PHP version restrictions for 1.x, 2.x, 3.x and 4.x releases

Installation
------------

[](#installation)

You can use this package in your projects with [Composer](https://getcomposer.org/).

```
$ composer require mikespub/php-epub-meta
```

Using PHP EPub Meta
-------------------

[](#using-php-epub-meta)

This package provides the `SebLucas\EPubMeta\EPub` class to read and write metadata for your EPub files.

```
use SebLucas\EPubMeta\EPub;

$file = 'test/data/test.epub';
$epub = new EPub($file);

$title = $epub->getTitle();
// ...
```

The web interface is **disabled** by default when mikespub/php-epub-meta is included as vendor package. You can integrate it in your own application by having a look at the minimal code in [app/index.php](https://github.com/mikespub-org/php-epub-meta/blob/main/app/index.php)

PHP EPub Meta (original)
------------------------

[](#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 Metadata Web Interface
-------------------------------------

[](#about-the-epub-metadata-web-interface)

The web app expects your ebooks in a single flat directory or in subfolders. The location of that directory has to be configured at the top of the `app/index.php`file.

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

The web app also makes some assumption on how the files should be named. The format is: `-.epub`. Commas will be replaced by `__` and spaces are replaced by `_`.

Note that the web app can **RENAME** your files to that form when saving too.

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.

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance85

Actively maintained with recent releases

Popularity25

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 78.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~23 days

Total

40

Last Release

79d ago

Major Versions

1.5.0 → 2.0.02023-09-09

1.5.2 → 2.0.12023-09-10

1.5.3 → 2.0.22023-09-10

2.x-dev → 3.0.02024-09-05

3.x-dev → 4.0.02025-11-27

PHP version history (4 changes)2.0.0PHP >=8.1

1.5.1PHP >=7.4

3.0.0PHP >=8.2

4.0.0PHP >=8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1447115?v=4)[Mike's Pub](/maintainers/mikespub)[@mikespub](https://github.com/mikespub)

---

Top Contributors

[![mikespub](https://avatars.githubusercontent.com/u/1447115?v=4)](https://github.com/mikespub "mikespub (90 commits)")[![seblucas](https://avatars.githubusercontent.com/u/437682?v=4)](https://github.com/seblucas "seblucas (19 commits)")[![marsender](https://avatars.githubusercontent.com/u/279979?v=4)](https://github.com/marsender "marsender (3 commits)")[![mbirth](https://avatars.githubusercontent.com/u/130302?v=4)](https://github.com/mbirth "mbirth (2 commits)")[![sbdomo](https://avatars.githubusercontent.com/u/2596665?v=4)](https://github.com/sbdomo "sbdomo (1 commits)")

---

Tags

ebookepubmetadatametadataebookepub

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mikespub-php-epub-meta/health.svg)

```
[![Health](https://phpackages.com/badges/mikespub-php-epub-meta/health.svg)](https://phpackages.com/packages/mikespub-php-epub-meta)
```

###  Alternatives

[minime/annotations

The KISS PHP annotations library

229378.6k37](/packages/minime-annotations)[mhor/php-mediainfo

PHP wrapper around the mediainfo command

120574.8k7](/packages/mhor-php-mediainfo)[honeystone/laravel-seo

SEO metadata and JSON-LD package for Laravel.

34744.1k](/packages/honeystone-laravel-seo)[spiral/attributes

PHP attributes reader

233.6M45](/packages/spiral-attributes)[thomas-schulz/symfony-meta

PhpStorm meta data for expected arguments completion in symfony projects.

8957.0k](/packages/thomas-schulz-symfony-meta)[phpexiftool/exiftool

Exiftool is a library for reading, writing and editing meta information. This package is not PHP, but required for the main PHP driver : PHP Exiftool

30376.0k7](/packages/phpexiftool-exiftool)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)