3.0.0

Improvements

• Now supports PHP 8.0 and above (fixes #48)
• Still support older PHP version (from 7.2)

⚠️ Breaking changes

The ability to instantiate the ISBN class has been removed.
Learn how to migrate from 2.x.

3.0.0-alpha.3

Early release of version 3.0, supporting PHP 8, removing deprecated code including release 2.6.0 from main branch.

2.6.0

This release adds an ISBN::parse public method that returns a ParsedIsbn object.

It can be used to get parts of an ISBN code. As an example, the ISBN 9791091146456 could be split with the following methods :

• ParsedIsbn->getGs1Element would return the EAN prefix "979"
• ParsedIsbn->getRegistrationGroupElement would return the French language code "10"
• ParsedIsbn->getRegistrantElement would return the "Dystopia" publisher code "91146"
• ParsedIsbn->getPublicationElement would return the "Fournaise" publication code "45"
• ParsedIsbn->getCheckDigit would return the checksum digit "979"

Full Changelog: 2.5.0...2.6.0

3.0.0-alpha.2

Early release of version 3.0, supporting PHP 8, including release 2.5.1 from main branch.

What's Changed

• Bump guzzlehttp/psr7 from 1.6.1 to 1.8.5 by @dependabot in #52
• Dependencies and range update by @clemlatz in #59

Full Changelog: 2.5.0...3.0.0-alpha.2

2.5.1

• Ranges were updated
• Dependencies were updated (fixing a guzzle security vulnerability)
• Data arrays were refactored thanks to @d--j
• Support for PHP 7.1 was dropped

3.0.0-alpha.1

Early release of version 3.0, supporting PHP 8.

2.5.0

This update adds support for the ISBN-A/DOI format. You can thank @rlueder for that!
It introduces a new method to do so:

Isbn::convertToIsbnA("9782207258040"); // returns "10.978.2207/258040"

Also, trying to validate an ISBN with an unknown range will throw an IsbnParsingException instead of a cryptic PHP Notice about array offsets. Thanks to @StefanGlaesser for pointing that out.

Isbn::convertToIsbn13("9786303025575"); // throws "Cannot find any ISBN range matching prefix 978-630"

2.4.0

The 2.4.0 update introduces a new method:

Isbn::isParsable ( string $value ) : boolean

This method returns true if the $value string can be parsed (and thus, converted into a valid ISBN-10, ISBN-13, EAN-13 or GTIN-14) and false if it cannot be.

Learn more

2.3.0

This version introduces a new public API with seven new static methods:

• Isbn::validateAsIsbn10
• Isbn::validateAsIbsn13
• Isbn::validateAsEan13
• Isbn::convertToIsbn10
• Isbn::convertToIsbn13
• Isbn::convertToEan13
• Isbn::convertToGtin14

See README for details.

This version sets as deprecated four legacy methods:

• Isbn->isValid
• Isbn->getErrors
• Isbn->validate
• Isbn->format

These methods will trigger a deprecated notice when but will be supported until the next major (3.0) release.
See Methods deprecated in 2.3.0 on how to upgrade your existing implementation.

2.2.0

• Output can now be formatted as GTIN-14 identifier (thanks to @kokoshneta)
• ISBN ranges were updated