PHPackages                             chronoarc/marvel - 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. chronoarc/marvel

AbandonedArchivedLibrary[API Development](/categories/api)

chronoarc/marvel
================

A PHP wrapper for Marvel's API

0.0.1(1y ago)011MITPHPPHP &gt;=8.2

Since Jan 7Pushed 6mo ago1 watchersCompare

[ Source](https://github.com/fakeheal/marvel-sdk)[ Packagist](https://packagist.org/packages/chronoarc/marvel)[ RSS](/packages/chronoarc-marvel/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

Unfortunately, this project will remain unfinished. 😿

> The Marvel Developer Portal has Sunset as of Wednesday, October 29, 2025. As such, we are no longer accepting new sign-ups for a Marvel Comics API key.

---

🦸 Marvel PHP SDK
================

[](#-marvel-php-sdk)

[![Tests](https://github.com/fakeheal/marvel-sdk/actions/workflows/php.yml/badge.svg)](https://github.com/fakeheal/marvel-sdk/actions/workflows/php.yml)[![Packagist Version](https://camo.githubusercontent.com/c5e531bd0daac5afe9283966a95ecd79ac338fdd59d9114f17f84f0441ff7126/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6368726f6e6f6172632f6d617276656c)](https://camo.githubusercontent.com/c5e531bd0daac5afe9283966a95ecd79ac338fdd59d9114f17f84f0441ff7126/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6368726f6e6f6172632f6d617276656c)[![Packagist Downloads](https://camo.githubusercontent.com/3a7a5f41a5c5789c71eb3e41b95161515ec1f684cbd923c2789328ebe84e8236/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6368726f6e6f6172632f6d617276656c)](https://camo.githubusercontent.com/3a7a5f41a5c5789c71eb3e41b95161515ec1f684cbd923c2789328ebe84e8236/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6368726f6e6f6172632f6d617276656c)

Welcome to the **Marvel PHP SDK**, a lightweight and easy-to-use SDK designed to interact with the [Marvel API](https://developer.marvel.com/), built on top of the robust [Saloon](https://docs.saloon.dev)library.

🚧 Progress
----------

[](#-progress)

- Use enums for query parameters:
    - Comic:
        - `OrderBy` in query params
        - `Format` in query params and dto
        - `FormatType` in query params
    - Character
    - Events
    - Stories
    - Creators
    - Series
- Convert all dates to `DateTime` objects
- Tests
- Submit to Packagist

🚀 Getting Started
-----------------

[](#-getting-started)

### Installation

[](#installation)

You can install the SDK via Composer:

```
composer require chronoarc/marvel
```

### Usage

[](#usage)

```
require 'vendor/autoload.php';

$publicKey = 'your-public-key-here';
$privateKey = 'your-private-key-here';

$marvel = new  Chronoarc\Marvel\Marvel($publicKey, $privateKey);

$superhero = ['name' => 'Spider-Man (Peter Parker)', 'id' => 1009610];

$characters = $marvel->characters()->search(name: $superhero['name']);
$characters->dto(); // Chronoarc\Marvel\Dto\CharacterDataWrapper

$character = $marvel->characters()->getCharacter($superhero['id']);
$character->dto(); // Chronoarc\Marvel\Dto\CharacterDataWrapper

$characterSeries = $marvel->characters()->getCharacterSeries($superhero['id']);
$characterSeries->dto(); // Chronoarc\Marvel\Dto\SeriesDataWrapper

$characterComics = $marvel->characters()->getCharacterComics($superhero['id']);
$characterComics->dto(); // Chronoarc\Marvel\Dto\ComicDataWrapper

$characterEvents = $marvel->characters()->getCharacterEvents($superhero['id']);
$characterEvents->dto(); // Chronoarc\Marvel\Dto\EventDataWrapper

$characterStories = $marvel->characters()->getCharacterStories($superhero['id']);
$characterStories->dto(); // Chronoarc\Marvel\Dto\StoryDataWrapper
```

### Advanced

[](#advanced)

Additionally, you can use the provided enums for query parameters:

```
use Chronoarc\Marvel\Enums\Comic\OrderBy;
use Chronoarc\Marvel\Enums\Comic\Format;

...

/** @var ComicDataWrapper $comics */
$comics = $this->connector->comics()->search(
  format: Format::comic,
  orderBy: [OrderBy::titleAsc],
)->dto();
```

**Note**: DTOs also have enums for their properties, so you can use them to access the data in a more predictable way.

🤝 Contributions Welcome
-----------------------

[](#-contributions-welcome)

Your feedback and contributions are highly appreciated! Whether it’s submitting an issue, suggesting improvements, or adding new features, every bit helps make this SDK better for everyone.

---

Feel free to fork the repository, make pull requests, or just share ideas! Let's make this SDK awesome together.

📝 License
---------

[](#-license)

MIT

ChronoArc
---------

[](#chronoarc)

[![ChronoArc](./chronoarc.png)](./chronoarc.png)

This SDK is made for ChronoArc, an app I am trying to build an app that lets you create reading guides, subscribe to already created guides, and track your progress towards reading a specific guide.

There's another SDK that uses Comicvine API, which is also part of the ChronoArc project. You can check it out at [chronoarc/comicvine-sdk](https://github.com/fakeheal/comicvine-sdk).

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance57

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~2 days

Total

2

Last Release

493d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f925a697449ab18af5a1d0b8aa406703b229ccc70bfd6e8216486fbba8ecee29?d=identicon)[fakeheal](/maintainers/fakeheal)

---

Top Contributors

[![fakeheal](https://avatars.githubusercontent.com/u/1038697?v=4)](https://github.com/fakeheal "fakeheal (27 commits)")

---

Tags

marvelmarvel-apiphpsdkphpsdkmarvel

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/chronoarc-marvel/health.svg)

```
[![Health](https://phpackages.com/badges/chronoarc-marvel/health.svg)](https://phpackages.com/packages/chronoarc-marvel)
```

###  Alternatives

[manamine/php-eos-rpc-sdk

PHP SDK for the EOS RPC API

187.5k](/packages/manamine-php-eos-rpc-sdk)

PHPackages © 2026

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