PHPackages                             mediadevils/tmdb-library - 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. mediadevils/tmdb-library

ActiveLibrary[API Development](/categories/api)

mediadevils/tmdb-library
========================

PHP wrapper classes for TMDB (TheMovieDatabase) API v3.

1.0.x-dev(13y ago)177[1 PRs](https://github.com/MediaDevils/tmdb-library/pulls)

Since May 13Compare

[ Source](https://github.com/MediaDevils/tmdb-library)[ Packagist](https://packagist.org/packages/mediadevils/tmdb-library)[ RSS](/packages/mediadevils-tmdb-library/feed)WikiDiscussions Synced today

READMEChangelogDependencies (1)Versions (1)Used By (0)

TMDB4PHP
========

[](#tmdb4php)

PHP wrapper classes for TMDB (TheMovieDatabase) API v3.

Thanks to:
Calibrate ([www.calibrate.be](http://www.calibrate.be))

Requirements:
-------------

[](#requirements)

- PHP 5.3+
- Curl
- TMDB Api-key

Basic usage:
------------

[](#basic-usage)

```
require_once('vendor/autoload.php');

$db = TMDB\Client::getInstance('');
$db->adult = true;  // return adult content
$db->paged = false; // merges all paged results into a single result automatically

$title = 'The Matrix';
$year = '1999';

$results = $db->search('movie', array('query'=>$title, 'year'=>$year));

$movie = reset($results);
$images = $movie->posters('300');
```

TMDB\\Client contains the API wrapper for querying TMDB. Results are transformed into the helper objects automatically.
For example searching for 'movie' will result in a array of Movie objects.

More info will come soon.

Assets
------

[](#assets)

Several objects are defined for the 'assets' TMDB uses. These include:

- Movie
- Person
- Company
- Collection
- Genre

You can create a new asset and have it filled in with information automatically by passing in the id in the constructor.

For example:

```
$movie = new Movie(10);
```

Will load a movie object with the info for a movie with tmdb id 10;

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

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

Unknown

Total

1

Last Release

4795d ago

### Community

Maintainers

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

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mediadevils-tmdb-library/health.svg)

```
[![Health](https://phpackages.com/badges/mediadevils-tmdb-library/health.svg)](https://phpackages.com/packages/mediadevils-tmdb-library)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

94452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

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