Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/daniel-zahariev/music-codes
Music Codes PHP library provides handy tools for codes in the music industry
https://github.com/daniel-zahariev/music-codes
code isrc music
Last synced: 17 days ago
JSON representation
Music Codes PHP library provides handy tools for codes in the music industry
- Host: GitHub
- URL: https://github.com/daniel-zahariev/music-codes
- Owner: daniel-zahariev
- License: mit
- Created: 2019-08-30T16:29:38.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-05-13T14:23:36.000Z (over 2 years ago)
- Last Synced: 2024-10-03T05:09:10.866Z (about 1 month ago)
- Topics: code, isrc, music
- Language: PHP
- Homepage:
- Size: 17.6 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
[](https://github.com/daniel-zahariev/music-codes/blob/master/COPYING)
[](https://app.travis-ci.com/github/daniel-zahariev/music-codes)
[](https://coveralls.io/github/daniel-zahariev/music-codes?branch=master)
# Music Codes
Music Codes PHP library provides handy tools for codes in the music industry
Isrc
====
**Note 1: for the country code portion of the ISRC the library only checks if it is comprised of 2 alphabetical characters**
~~**Note 2: ISRC with id 0 are not considered valid; example: `GB-A1B-11-00000`**~~
**Updated Note2: ISRCs with id 0 can now be treated as valid by calling a static method on the class prior it's general use**
Setting ISRC parts:
```php
$isrc = new Isrc();
$isrc->setCountryCode('GB');
$isrc->setIssuerCode('A1B');
$isrc->setYear(11);
$isrc->setId(3);
// Prefix is the combination of country code and issuer code
// and is now adopted as standard wording in ISRC specification
// in order to allow allocation of ranges of ISRCs
$isrc->setPrefix('GB-A1B'); // can be used with or without the dash
// will output 'Valid'
echo ($isrc->isValid() ? 'Valid' : 'Not valid') . PHP_EOL;
// By default, the ids equal to zero are not considered as valid
// so to enable this globally you should call the following method:
Isrc::treatZeroIdsAsValid(true);
$isrc = new Isrc('GB-A1B-11-00000')
// will output 'Valid'
echo ($isrc->isValid() ? 'Valid' : 'Not valid') . PHP_EOL;
```
Different formatting options:
```php
$isrc = new Isrc('GB-A1B-11-00003');
// outputs dashed ISRC: 'GB-A1B-11-00003'
echo $isrc->getIsrc(true) . PHP_EOL;
// outputs ISRC without dashes:'GBA1B1100003'
echo $isrc->getIsrc(false) . PHP_EOL;
// outputs ISRC withot dashes and prefixed: 'ISRC GBA1B1100003'
echo $isrc->getIsrc(false, true) . PHP_EOL;
```
Navigating up & down:
```php
$isrc = new Isrc('GB-A1B-11-00003');
// go one down and if it's valid output it
// outputs 'GB-A1B-11-00002'
if ($isrc->previous()) {
echo $isrc->getIsrc(true) . PHP_EOL;
}
// reset
$isrc->load('GB-A1B-11-00003');
// go one up
$isrc->next();
// go one up and if it's valid output it
// outputs 'GB-A1B-11-00004'
if ($isrc->next()) {
echo $isrc->getIsrc(true) . PHP_EOL;
}
```
ISWC
====
There are various ways to instantiate an ISWC object:
```php
$iswc = new Iswc('T-034.524.680-1'); // use either all separators
$iswc = new Iswc('T0345246801'); // or none
$iswc = Iswc::fromId('034.524.680');
$iswc = Iswc::fromId('034524680');
```
Navigating up & down:
```php
$iswc = new Iswc('T-034.524.680-1');
// Bumps up the id and auto-calculates the check digit
// the ISWC is now: T-034.524.681-2
$iswc->next();
// reset
$iswc->load('T-034.524.680-1');
// the ISWC is now: T-034.524.679-8
$iswc->previous();
```
Formatting:
```php
$iswc = new Iswc('T-034.524.680-1');
echo $iswc; // outputs 'T-034.524.680-1'
echo $iswc->getIswc(true); // outputs 'T-034.524.680-1'
echo $iswc->getIswc(false); // outputs 'T0345246801'
```
Label Code
====
There are various ways to instantiate an LabelCode object:
```php
$label_code = new LabelCode('LC-1234'); // dashes will be stripped by default
$label_code = new LabelCode('LC1234');
$label_code = LabelCode::fromParts('LC', 1234);
$label_code = LabelCode::fromParts('LC-', '1234');
```
Navigating up & down:
```php
$label_code = new LabelCode('LC-1234');
// Bumps up the id
// the Label Code is now: LC-1235
$label_code->next();
// reset
$label_code->load('LC-1234');
// the Label Code is now: LC-1233
$label_code->previous();
```
Formatting:
```php
$label_code = new LabelCode('LC-1234');
echo $label_code; // outputs 'LC1234'
echo $label_code->gecLabelCode(true); // outputs 'LC-1234'
echo $label_code->gecLabelCode(false); // outputs 'LC1234'
```
Changelog
=========
**v1.3.1**
- add method `treatZeroIdsAsValid` to Isrc class to enable validation of ISRC codes where the id is 0
- add param to `isValid` method in Isrc class to enable revalidation on demand
License
=======
MIT License
See [COPYING](COPYING) to see the full text.