PHPackages                             aportela/musicbrainz-wrapper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. aportela/musicbrainz-wrapper

ActiveLibrary[API Development](/categories/api)

aportela/musicbrainz-wrapper
============================

Custom musicbrainz api wrapper

3.4.4(5mo ago)198AGPL-3.0-onlyPHPPHP >=8.4CI passing

Since Apr 18Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/aportela/musicbrainz-wrapper)[ Packagist](https://packagist.org/packages/aportela/musicbrainz-wrapper)[ Docs](https://github.com/aportela/musicbrainz-wrapper)[ RSS](/packages/aportela-musicbrainz-wrapper/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (8)Versions (42)Used By (0)

musicbrainz-wrapper
===================

[](#musicbrainz-wrapper)

Custom musicbrainz api wrapper

Requirements
------------

[](#requirements)

- mininum php version 8.4
- curl extension must be enabled (aportela/httprequest-wrapper)

Install (composer) dependencies:
--------------------------------

[](#install-composer-dependencies)

```
composer require aportela/musicbrainz-wrapper
```

Classes:
--------

[](#classes)

\\aportela\\MusicBrainzWrapper\\ParseHelpers\\RecordingHelper#### Description:

[](#description)

A [recording](https://wiki.musicbrainz.org/Recording) is an entity in MusicBrainz which can be linked to tracks on releases. Each track must always be associated with a single recording, but a recording can be linked to any number of tracks.

#### Properties:

[](#properties)

- mbId (string)
- title (string)
- artistCredit (array of \\aportela\\MusicBrainzWrapper\\ParseHelpers\\ArtistHelper)

\\aportela\\MusicBrainzWrapper\\ParseHelpers\\TrackHelper#### Description:

[](#description-1)

In MusicBrainz, a [track](https://wiki.musicbrainz.org/Track) is the way a recording is represented on a particular release (or, more exactly, on a particular medium). Every track has a title (see the guidelines for titles) and is credited to one or more artists. Tracks are additionally assigned MBIDs, though they cannot be the target of Relationships or other properties conventionally available to entities.

#### Properties:

[](#properties-1)

- mbId (string)
- position (int)
- number (int)
- recording (\\aportela\\MusicBrainzWrapper\\ParseHelpers\\RecordingHelper)

\\aportela\\MusicBrainzWrapper\\ParseHelpers\\MediaHelper#### Description:

[](#description-2)

In MusicBrainz terminology, a prototypical [medium](https://wiki.musicbrainz.org/Medium) is one of the physical, separate things you would get when you buy something in a record store. They are the individual CDs, vinyls, etc. contained within the packaging of an album (or any other type of release). Mediums are always included in a release, and have a position in said release (e.g. disc 1 or disc 2). They have a format, like CD, 12" vinyl or cassette (in some cases this will be unknown), and can have an optional title (e.g. disc 2: The Early Years).

#### Properties:

[](#properties-2)

- mbId (string)
- position (int)
- trackList (array of \\aportela\\MusicBrainzWrapper\\ParseHelpers\\TrackHelper)

\\aportela\\MusicBrainzWrapper\\ParseHelpers\\ReleaseHelper#### Description:

[](#description-3)

A MusicBrainz [release](https://wiki.musicbrainz.org/Release) represents the unique release (i.e. issuing) of a product containing at least one audio medium (a disc, for example, on a CD release). Each release has one or more identifying properties, such as a release date and country, a label, a barcode, a specific type of packaging or a specific cover art.

#### Properties:

[](#properties-3)

- mbId (string)
- title (string)
- year (int|null)
- coverArtArchive (object)
    - **Properties:**
        - artwork (boolean)
        - front (boolean)
        - back (boolean)
- trackList (array of \\aportela\\MusicBrainzWrapper\\ParseHelpers\\TrackHelper)
- media (array of \\aportela\\MusicBrainzWrapper\\ParseHelpers\\MediaHelper)

\\aportela\\MusicBrainzWrapper\\ParseHelpers\\ArtistHelper#### Description:

[](#description-4)

An [artist](https://wiki.musicbrainz.org/Artist) is generally a musician (or musician persona), group of musicians, or other music professional (like a producer or engineer). Occasionally, it can also be a non-musical person (like a photographer, an illustrator, or a poet whose writings are set to music), or even a fictional character.

#### Properties:

[](#properties-4)

- mbId (string)
- type (\\aportela\\MusicBrainzWrapper\\ArtistType)
- name (string)
- country (string|null)
- genres (array of string)
- relations (array of \\aportela\\MusicBrainzWrapper\\ParseHelpers\\ArtistHelper)

Code example:
-------------

[](#code-example)

```