Changelog

All notable changes to php-ebook will be documented in this file.

v2.6.9 - 2024-07-28

Add duration_human_readable for getExtras() method for audiobooks.

Works with kiwilan/php-audio v3.0.08.

v2.6.8 - 2024-07-28

Fix missing genres crash for audiobooks.

v2.6.7 - 2024-07-16

Fix CbamTemplate::class pages count, if PageCount is not set, then use getArchive()->getCount() from Ebook::class.

v2.6.6 - 2024-07-16

Hotfix PR #91 for issue #71 by @basitcodeenv, thanks!

v2.6.5 - 2024-07-15

Fix issue #71 with PR #89 by @basitcodeenv, thanks!

v2.6.4 - 2024-07-11

MetaTitle::class with getSeriesSlug(), addExtension parameter is now as false by default, to avoid split series between .cbz and .cbr or .m4b and .mp3 files.

v2.6.3 - 2024-07-10

Fix version

v2.6.20 - 2024-07-10

Now CBAM (ComicInfo.xml) with a Series but without Number will have default Number as 0.

v2.6.1 - 2024-07-10

Refactor MetaTitle::class

getSeriesSlugSimple(), getSlugSimple() are deprecated
getSlug() have now multiple parameters to customize the slug: removeDeterminers, addSeries, addVolume, addAuthor, addYear, addExtension, addLanguage (all are true by default)
getSeriesSlug() have now multiple parameters to customize the slug: removeDeterminers, addAuthor, addExtension, addLanguage (removeDeterminers, addExtension, addLanguage are true by default, addAuthor is false by default)

v2.6.0 - 2024-06-23

BREAKING CHANGES

Remove getDescriptionHtml() method from Ebook class.
Remove limit parameter from getDescription() method in Ebook class.
getDescription() method in Ebook class now returns raw description without any formatting.

FEATURES

To access to advanced book description, you can use getDescriptionAdvanced() method with BookDescription class.

getDescription() method now returns raw description without any formatting.
toHtml() method formats the description to HTML.
toString() method formats the description to plain text.
toStringMultiline() method formats the description to plain text with new lines.

All methods have limit parameter to limit the length of the description.

BUGFIXES

Improve audiobook parsing with safe array extraction.

MISC

Remove many utilities method from EbookModule class, now BookDescription class is responsible for parsing book description.
limitLength() method is now into EbookUtils class.

v2.5.13 - 2024-06-16

AudiobookModule::class: fix parsing of audiobook with volume 0.

v2.5.12 - 2024-06-01

MetaTitle::class: clear docs

v2.5.11 - 2024-05-26

EbookUtils::class fix parseStringWithSeperator() method.

v2.5.10 - 2024-05-26

MetaTitle::class : now native slugifier is fixed, float volume works now, volume use 000 padding.
Allow authors with ,, ; and & in the name for .opf, .pdf, .mobi and audiobooks.

v2.5.0 - 2024-05-22

MetaTitle::class: fromData() method volume parameter is now string|int|float|null instead of string|int|null.

v2.4.9 - 2024-05-22

New feature with volume numbers as floats.

Ebook::class: now getVolume() returns int|float|null instead of int|null
ComicMeta::class: new property number (int|float|null), volume and storyArcNumber are now int|float|null instead of int|null

v2.4.8 - 2024-05-15

For audiobooks, specifications are now based on audiobookshelf specifications.

ID3 Tag (case-insensitive)	eBook
`artist` / `album-artist`	Authors*
`album` / `title`	Title
`subtitle`	Extra property `subtitle`
`publisher`	Publisher
`year`	Publish Year
`composer`	Extra property `narrators`
`description`	Description
`genre`	Tags**
`series` / `mvnm`	Series
`series-part` / `mvin`	Volume
`language` / `lang`	Language
`isbn`	Identifiers `isbn`
`asin` / `audible_asin`	Identifiers `asin`
Overdrive MediaMarkers	Extra property `chapters`

- Authors naming as well as multiple authors separated by ,, ;, & or and.
** Tags can include multiple tags separated by /, //, or ;. e.g. "Science Fiction/Fiction/Fantasy"

v2.3.8 - 2024-03-06

OpfItem::class method getMeta() is now deprecated. Use getMetaItems() instead.
OpfItem::class method getMetaItems() will now return an array of BookMeta::class objects.
OpfItem::class method getMetaItem(string $key) will now return BookMeta::class object or null.

v2.3.7 - 2024-02-05

MetaTitle::class: add fromData() static method to generate a MetaTitle object from a raw data and rename make() to fromEbook().

v2.3.6 - 2024-02-04

Audiobook: add language, tags will be splitted by ; or ,
MetaTitle: now language slug will be added just after series if series exists, and before author if not to help for sorting with series in different languages

v2.3.5 - 2024-01-29

Ebook class: add getCreatedAt() method to get the file modified date, add getSize() method to get the file size and getSizeHumanReadable() method to get the file size in human readable format
AudiobookModule: add all audio metadata to getExtras() method, remove comment from getDescription() method (now available into getExtras() method)

v2.3.4 - 2024-01-28

Remove year from MetaTitle getSeriesSlug() to avoid duplicate series.
Move namespace Tools to Models

v2.3.3 - 2024-01-28

Refactor determiners for MetaTitle.

v2.3.2 - 2024-01-27

Fix version.

v2.3.12 - 2024-01-27

In MetaTitle, add series before title for getSlug().

v2.3.11 - 2024-01-27

In MetaTitle, move year after author.

v2.3.1 - 2024-01-27

Deprecated some MetaTitle methods getSlugSort(), getSlugUnique(), getSerieSlug(), getSerieSlugSort(), getSerieSlugUnique(), getSlugSortWithSerie(), getUniqueFilename(). Now only getSlug(), getSlugSimple(), getSeriesSlug(), getSeriesSlugSimple() are available.

Slug have to be unique, so default slug take some metadata to be unique, like in this example:

An EPUB with title La pâle lumière des ténèbres with main author Pierre Bottero, series A comme Association, volume 1, language fr and published in 1980 will have the slug pale-lumiere-des-tenebres-a-comme-association-01-1980-pierre-bottero-epub-fr.

You can use getSlugSimple() to have a simple slug, like pale-lumiere-des-tenebres.

For series, you can use getSeriesSlug() to have a slug with series name, like a-comme-association-1980-pierre-bottero-epub-fr.

And getSeriesSlugSimple() to have a simple slug with series name, like a-comme-association.

v2.3.0 - 2024-01-22

Drop kiwilan/php-audio dependency.

Audiobooks are cool, but I suppose many users don't need it. So I think it's better to drop kiwilan/php-audio dependency, you have to install kiwilan/php-audio manually. If you scan audiobooks without kiwilan/php-audio installed, you will get an error message.

v2.2.01 - 2023-12-06

Update dependencies (drop symfony/process dependency)

EbookMetadata is now EbookParser for consistency
- Method getMetadata is now getParser
- Method hasMetadata is now hasParser
BookIdentifier can use now autoDetect to detect identifier scheme from value, you can disable this feature by passing false as third argument

v2.2.0 - 2023-09-24

Breaking changes

All Metadata internal classes have been renamed to Module
Some internal parser classes, have been moved into Parser namespace
All getContent() methods have been renamed to getContents() (old methods are deprecated)

New features

MOBI and derivatives support (.azw, .azw3, .kf8, .kfx, .mobi, .prc) with cover
FB2 support (.fb2) with cover and series
Improve BookIdentifier scheme detection

Misc

Fixing EPUB volume 0 issue
Add more tests with samples
Update dependencies
Improve documentation

v2.1.02 - 2023-08-30

Better handle of PDF, parser works even if metadata are not present
- Add more tests on PDF, update kiwilan/php-archive with patch for PDF
- Thanks to @SergioMendolia for PR #48

v2.1.01 - 2023-08-29

avoids crashing when trying to read metadata while archive is null, by @SergioMendolia in #45

v2.1.0 - 2023-08-28

Add some improvements for description parsing (remove extra spaces, remove newlines, etc.)
Add EbookCreator::class with create() method into Ebook::class that allows to create ebook from Ebook instance
- Some methods allow to set content to ebook: addFromString(), addFile(), addDirectory()

v2.0.20 - 2023-08-28

add descriptionHtml() method to Ebook::class, which can contains description with html tags if it is available, html is sanitized, original description is still available via description() method with plain text
add getBasename() method to Ebook::class, which returns basename of ebook file, getFilename() now return real filename of ebook file
add isValid(string $path) static method to Ebook::class, which checks if ebook file is valid, thanks to @SergioMendolia: #38
fix <dc:creator> empty tag in opf file, thanks to @SergioMendolia: #39
Bugfixes

2.0.12 - 2023-08-10

fix OpfMetadata dcRights() parse array to string

2.0.11 - 2023-08-10

add Epub property isBadFile to check if the file is corrupted, eBook file will be read but not parsed if it is corrupted, it's possible to know if file is valid with isBadFile() method or with hasMetadata() method
fix some problems with OPF parsing to be more flexible

2.0.1 - 2023-08-10

add opf:metadata support for OPF files

2.0.0 - 2023-08-08

BREAKING CHANGES

All simple getters have now get prefix. For example, getTitle() instead of title(), getPublisher() instead of publisher(), etc. It concerns all simple getters of EpubMetadata, EpubChapter, EpubHtml, NcxMetadata, EpubContainer, OpfMetadata, Ebook, BookIdentifier, EbookCover, EbookMetadata, AudiobookMetadata, BookAuthor, CbaMetadata, CbamMetadata, MetaTitle classes.

Why? All these classes have some methods like setters or actions. To be consistent and clear, all simple getters have now get prefix.

Bugfixes

BookContributor and BookIdentifier can be more flexible with mixed types

1.3.54 - 2023-07-23

EbookCover content method fix

1.3.53 - 2023-07-07

bump kiwilan/php-archive 1.5.12

1.3.52 - 2023-07-07

bump kiwilan/php-archive to 1.5.11

1.3.51 - 2023-07-06

bumpp kiwilan/php-archive

1.3.41 - 2023-06-28

chore: kiwilan/php-xml-reader to 0.2.31

1.3.4 - 2023-06-28

BREAKING CHANGE: extrasExtract() is now extra()
chore: kiwilan/php-xml-reader to 0.2.30

1.3.35 - 2023-06-27

chore: update kiwilan/php-xml-reader to 0.2.22

1.3.34 - 2023-06-22

MetaTitle improve uniqueFilename

1.3.33 - 2023-06-22

MetaTitle fix uniqueFilename() with series

1.3.32 - 2023-06-22

limit length fix bug

1.3.31 - 2023-06-22

improve toArray() for EpubMetadata
add limit option to copyright and description

1.3.30 - 2023-06-20

Fix some kiwilan/php-xml-reader parsing error

1.3.20 - 2023-06-20

Update dependency kiwilan/php-xml-reader

1.3.10 - 2023-06-19

OpfMetadata::class fix only one tag

1.3.0 - 2023-06-19

Use kiwilan/php-xml-reader instead of XmlReader::class

1.2.0 - 2023-06-16

BREAKING CHANGE

BookIdentifier::class => content is now value and type is now scheme

FEATURE

Add EPUB chapters support

1.1.0 - 2023-06-16

Add partial .mobi support
For EbookMetadata::class all methods with has prefix use is prefix now
Add uniqueFilename method to MetaTitle::class
improve documentation
add tests

1.0.12 - 2023-06-15

MetaTitle add uniqueFilename

1.0.11 - 2023-06-14

OpfMetadata fix cover parser to keep only pictures

1.0.10 - 2023-06-14

EpubMetadata::class fix parseFiles method

1.0.01 - 2023-06-14

add extrasExtract method in Ebook::class

1.0.0 - 2023-06-13