biblys/isbn

A PHP library to convert and validate ISBNs & EANs

2.1.0 2019-04-18 00:00 UTC

README

Build Status

This package can be used to:

  • validate an ISBN code
  • convert codes between ISBN-10, ISBN-13 and EAN (without hyphens) formats
  • calculate the checksum digit
  • show the registration agency (country or language)

Installation

Install with composer:

composer require biblys/isbn:^2.1.0

Usage

Use case: converting an EAN (9782843449499) to an ISBN-13 (978-2-84344-949-9).

<?php

use Biblys\Isbn\Isbn as Isbn;

$isbn = new Isbn('9782843449499');

$isbn = new Isbn($ean);

try {
    $isbn->validate();
    $isbn13 = $isbn->format("ISBN-13");
    echo "ISBN-13: $isbn13";
} catch(Exception $e) {
    echo "An error occured while parsing $ean: ".$e->getMessage();
}

Test

Run tests with PHPUnit:

composer install
composer test

Run tests in a docker container:

composer docker

ISBN ranges update

New ISBN ranges may be added from time to time by the International ISBN Agency. Whenever it happens, this library must be updated. If a range update is necessary, please open an issue on Github. You can also open a pull request after updating the ranges your self with the following commands:

composer install
composer run update-ranges

Changelog

2.1.0 (2019-04-18)

  • Added a validate method that throws an Exception on ISBN validation errors
  • Fixed [#9] Improve error output
  • Added composer scripts to run tests and update ranges in a Docker container
  • Updated ISBN ranges

2.0.8 (2019-02-07)

  • Fixed #7: ISBNs with invalid product code or country code are considered valid
  • Added PHP versions 7.1 & 7.2 to travis config file

2.0.7 (2019-02-01)

  • Attempts to format an invalid ISBN will now throw an Exception
  • Fixed considering ISBNs with an invalid product code as valid
  • Updated ISBN ranges

2.0.6 (2017-11-22)

  • Fixed #6: Error when validating ISBN-10 with X as a checksum digit

2.0.5 (2017-11-07)

  • Update ISBN ranges

2.0.4 (2017-06-29)

  • Fixed error when no rule is found (eg. for ISBN 9790706801940)

2.0.3 (2016-07-06)

  • Added 978-99978 range for Mongolia

2.0.2 (2016-04-12)

  • Fixed #3: Bug in the 978-613 range
  • Added a composer script to update ISBN ranges from isbn-international.org

2.0.1 (2016-03-01)

  • Fixed #2: added LICENSE file and copyright information
  • Added Travis configuration file

2.0.0 (2016-03-01)

  • Revamped library as a Composer package

1.1.0 (2015-08-21)

  • Fixed #1: ISBN-10 checksum character calculation
  • Added phpunit tests
  • Updated ISBN XML ranges file

1.0.1 (2014-04-21)

  • EAN-13 checksum character calculation bug fix

1.0.0 (2014-04-19)

  • First release