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

ActiveLibrary

breuls/tmdb-library
===================

PHP wrapper classes for TMDB (TheMovieDatabase) API v3.

1.0(12y ago)01.5kPHP

Since Feb 22Pushed 7y ago1 watchersCompare

[ Source](https://github.com/Breuls/tmdb-library)[ Packagist](https://packagist.org/packages/breuls/tmdb-library)[ RSS](/packages/breuls-tmdb-library/feed)WikiDiscussions 1.0 Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)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

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~1669 days

Total

2

Last Release

2789d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6364c4564d715c729971baa827648629d3ee735123dfa1ed52ff20746ff2f427?d=identicon)[Breuls](/maintainers/Breuls)

---

Top Contributors

[![kriboogh](https://avatars.githubusercontent.com/u/1898759?v=4)](https://github.com/kriboogh "kriboogh (14 commits)")[![TheFrozenFire](https://avatars.githubusercontent.com/u/948014?v=4)](https://github.com/TheFrozenFire "TheFrozenFire (8 commits)")[![Breuls](https://avatars.githubusercontent.com/u/1822037?v=4)](https://github.com/Breuls "Breuls (3 commits)")[![Jasrags](https://avatars.githubusercontent.com/u/131606?v=4)](https://github.com/Jasrags "Jasrags (3 commits)")[![shnhrrsn](https://avatars.githubusercontent.com/u/42901?v=4)](https://github.com/shnhrrsn "shnhrrsn (1 commits)")

---

Tags

phptmdb-api

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

PHPackages © 2026

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