biblys/isbn
biblys/isbn can be used to:
- validate a string against the ISBN-10, ISBN-13 and EAN-13 formats
- convert an ISBN to ISBN-10, ISBN-13, EAN-13 and GTIN-14 formats
- parse an ISBN and extract registration agency, publisher code, publication code, checksum, etc.
Installation
Install with composer:
composer require biblys/isbn:^2.3.0
Usage
Formatting
Use case: converting an EAN (9782843449499) to an ISBN-13 (978-2-84344-949-9).
<?php
use Biblys\Isbn\Isbn;
try {
$input = "9782843449499";
$isbn13 = Isbn::convertToIsbn13($input);
echo "ISBN-13: $isbn13"; // Prints ISBN-13: 978-2-84344-949-9
} catch(Exception $e) {
echo "An error occured while attempting to format ISBN $input: ".$e->getMessage();
}
All formating methods:
Isbn::convertToIsbn10Isbn::convertToIsbn13Isbn::convertToEan13Isbn::convertToGtin14
Validating
Use case: validating an incorrectly formed ISBN-13 (978-2-843-44949-9, should be 978-2-84344-949-9).
<?php
use Biblys\Isbn\Isbn;
try {
$input = "978-2-843-44949-9";
Isbn::validateAsIsbn13($input);
echo "ISBN $input is valid!";
} catch(Exception $e) { // Will throw because third hyphen is misplaced
echo "ISBN $input is invalid: ".$e->getMessage();
}
All validating methods:
Isbn::validateAsIsbn10Isbn::validateAsIbsn13Isbn::validateAsEan13Isbn::isParsable
Learn more about validating ISBNs
Development
Using Gitpod
You can start a dev environnement by clicking 
Locally
If you'd rather setup a local dev environnement, you'll need:
- PHP 7.x
- Composer
- (Optional) Docker to run tests and debug against different version of PHP
Clone this repository and run composer install to get started!
Tests
Run tests with PHPUnit:
composer install
composer test
Run tests in a docker container:
composer docker:test
Run tests in a docker container using a specific PHP version:
PHP_VERSION=7.1 composer docker:test
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
Or using a docker container:
composer docker:update-ranges
153 Jan 2, 2023
4 Oct 16, 2021
10 Aug 12, 2022
246 Jan 5, 2023
767 Jan 2, 2023
451 Dec 27, 2022
10.7k Jun 13, 2022
0 Jan 15, 2022
43 Sep 28, 2022
1.5k Dec 30, 2022
39 Oct 11, 2022
89 Nov 28, 2022
13 Apr 23, 2022
18 Dec 14, 2022
5 Oct 5, 2022
20 Nov 13, 2022
7 Dec 15, 2022
1.7k Dec 27, 2022