PHPackages                             stephan-strate/php-cover-art-archive-api - 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. stephan-strate/php-cover-art-archive-api

ActiveLibrary[API Development](/categories/api)

stephan-strate/php-cover-art-archive-api
========================================

PHP wrapper for CoverArtArchive api. Supports object-oriented access using repositories and factories.

v1.0.3(3y ago)11741[5 PRs](https://github.com/stephan-strate/php-cover-art-archive-api/pulls)MITPHPPHP ^7.4 || ^8.0

Since Nov 7Pushed 3y ago1 watchersCompare

[ Source](https://github.com/stephan-strate/php-cover-art-archive-api)[ Packagist](https://packagist.org/packages/stephan-strate/php-cover-art-archive-api)[ Docs](https://github.com/stephan-strate/php-cover-art-archive-api)[ GitHub Sponsors](https://github.com/stephan-strate)[ RSS](/packages/stephan-strate-php-cover-art-archive-api/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (7)Dependencies (13)Versions (13)Used By (0)

[![CoverArtArchive](https://raw.githubusercontent.com/metabrainz/metabrainz-logos/master/logos/Cover%20Art%20Archive/PNG/CoverArtArchive_logo_mini.png)](https://raw.githubusercontent.com/metabrainz/metabrainz-logos/master/logos/Cover%20Art%20Archive/PNG/CoverArtArchive_logo_mini.png)

[CoverArtArchive](https://coverartarchive.org/) API Wrapper
===========================================================

[](#coverartarchive-api-wrapper)

CoverArtArchive is a joint project between the [Internet Archive](https://archive.org/) and [MusicBrainz](https://musicbrainz.org/). Goal of this project is to make cover art images available to everyone.

Using this api wrapper, you can retrieve cover art images using the [release MBID](https://musicbrainz.org/doc/MusicBrainz_Identifier) of MusicBrainz.

Recommended to use together with [stephan-strate/php-music-brainz-api](https://github.com/stephan-strate/php-music-brainz-api).

Inspired by [php-github-api](https://github.com/KnpLabs/php-github-api) and [php-tmdb](https://github.com/php-tmdb/api).

Installation
------------

[](#installation)

Using composer:

```
$ composer require stephan-strate/php-cover-art-archive-api php-http/guzzle7-adapter:^1.0 http-interop/http-factory-guzzle:^1.0

```

Why `php-http/guzzle7-adapter:^1.0`? This library is decoupled from any http client using [HTTPlug](http://httplug.io/).

Usage
-----

[](#usage)

First you want to create the client:

```
$client = new \CoverArtArchive\Client();
```

Using this client, you can retrieve all other objects/apis.

### Repository

[](#repository)

The repository implementation takes the decoded json response and maps it to a matching model. This is the preferred way of using the library.

```
$repository = new \CoverArtArchive\Repository\ReleaseGroupRepository($client);
$repository->coverArt('19e6209b-2ddc-30b8-9273-484bd075fe7b');
```

#### Images

[](#images)

As the CoverArtArchive serves, as the name implies, images. Therefore the repository can also return image resources.

```
$repository = new \CoverArtArchive\Repository\ReleaseRepository($client);
$image = $repository->coverArtFront('7416e707-94b5-3810-b6b8-4229ab2182ec');

// outputs the image to the user
if ($image !== false) {
    header('Content-Type: image/png');
    imagepng($image);
    imagedestroy($image);
}
```

### Api

[](#api)

The api implementation returns the raw json response of the endpoint. You might want to use the repository implementation instead to get the parsed objects.

```
$release = $client->release();
$release->coverArt('7416e707-94b5-3810-b6b8-4229ab2182ec');
```

Contributing
------------

[](#contributing)

Help & Donate
-----------------

[](#help--donate)

I am very curious about projects that use my libraries. Please drop me a short message about what you use the library for. You can find my contact information on my profile (LinkedIn, E-mail).

If this project saved you time and money or you just appreciate what I am doing, please consider sponsoring me 😊

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 70.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~106 days

Recently: every ~138 days

Total

7

Last Release

1381d ago

Major Versions

v0.0.3-alpha → v1.0.02021-02-14

PHP version history (2 changes)v0.0.1-alphaPHP ^7.0

v1.0.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/95c6bea4d86f01f74afc3462e6d72fdbc9348f34e345fc4b7ffb355c1d5b7837?d=identicon)[stephan-strate](/maintainers/stephan-strate)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (97 commits)")[![stephan-strate](https://avatars.githubusercontent.com/u/19595615?v=4)](https://github.com/stephan-strate "stephan-strate (40 commits)")

---

Tags

api-clientapi-wrappercover-art-archivephpphpapilibrarycoverart

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/stephan-strate-php-cover-art-archive-api/health.svg)

```
[![Health](https://phpackages.com/badges/stephan-strate-php-cover-art-archive-api/health.svg)](https://phpackages.com/packages/stephan-strate-php-cover-art-archive-api)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[apigee/apigee-client-php

Client library for connecting to the Apigee Edge API.

27558.7k3](/packages/apigee-apigee-client-php)[paddlehq/paddle-php-sdk

Paddle's PHP SDK for Paddle Billing.

53301.7k](/packages/paddlehq-paddle-php-sdk)[dhope0000/lxd

PHP-based API wrapper for LXD REST API.

136.2k](/packages/dhope0000-lxd)[brd6/notion-sdk-php

Notion SDK for PHP

5918.0k](/packages/brd6-notion-sdk-php)[darthsoup/php-whmcs-api

WHMCS API client for PHP

2317.3k4](/packages/darthsoup-php-whmcs-api)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)