PHPackages                             lukaszzychal/tvmaze-client-php - 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. [HTTP & Networking](/categories/http)
4. /
5. lukaszzychal/tvmaze-client-php

ActiveLibrary[HTTP & Networking](/categories/http)

lukaszzychal/tvmaze-client-php
==============================

PSR-18 PHP client for the TVMaze API (shows, people, schedules, episodes, cast)

2.9.0(6mo ago)12MITPHPPHP ^8.2CI passing

Since Oct 13Pushed 6mo agoCompare

[ Source](https://github.com/lukaszzychal/tvmaze-client-php)[ Packagist](https://packagist.org/packages/lukaszzychal/tvmaze-client-php)[ RSS](/packages/lukaszzychal-tvmaze-client-php/feed)WikiDiscussions main Synced 1mo ago

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

TVMaze PHP Client
=================

[](#tvmaze-php-client)

[![CI](https://github.com/lukaszzychal/tvmaze-client-php/workflows/CI/badge.svg)](https://github.com/lukaszzychal/tvmaze-client-php/actions)[![Contract Tests](https://github.com/lukaszzychal/tvmaze-client-php/workflows/Scheduled%20Contract%20Tests/badge.svg)](https://github.com/lukaszzychal/tvmaze-client-php/actions)[![Code Coverage](https://camo.githubusercontent.com/05921e022774315987495e4a04754fb44be43a2762e605e9e081804342673b8d/68747470733a2f2f636f6465636f762e696f2f67682f6c756b61737a7a796368616c2f74766d617a652d636c69656e742d7068702f6272616e63682f6d61696e2f67726170682f62616467652e737667)](https://codecov.io/gh/lukaszzychal/tvmaze-client-php)[![Latest Stable Version](https://camo.githubusercontent.com/e3966672749958d885e12f1e7bc1681451484f4a178ff7eeba5c25f682546cf2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c756b61737a7a796368616c2f74766d617a652d636c69656e742d7068702e737667)](https://packagist.org/packages/lukaszzychal/tvmaze-client-php)[![Total Downloads](https://camo.githubusercontent.com/d295989a26bb89d9c070f0581c9ce838bab0b63882b8621a608dc7564277f3cc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c756b61737a7a796368616c2f74766d617a652d636c69656e742d7068702e737667)](https://packagist.org/packages/lukaszzychal/tvmaze-client-php)[![License](https://camo.githubusercontent.com/471b30affa34546568a2b71423a7ddea698e9ea51bc6ad6e1da0b968ac48514c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6c756b61737a7a796368616c2f74766d617a652d636c69656e742d7068702e737667)](https://packagist.org/packages/lukaszzychal/tvmaze-client-php)[![PHP Version](https://camo.githubusercontent.com/d69360d3c7a16fd34406eafef1e8ed0c24ff3bd6edbe23fc669e6b4a8995f796/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6c756b61737a7a796368616c2f74766d617a652d636c69656e742d7068702e737667)](https://packagist.org/packages/lukaszzychal/tvmaze-client-php)

A modern, PSR-18 compliant PHP client for the [TVMaze API](https://www.tvmaze.com/api). This library provides a clean, type-safe interface to access TV show information, episodes, cast, crew, schedules, and more.

Features
--------

[](#features)

- ✅ **PSR-18 Compliant**: Implements the HTTP Client standard
- ✅ **Type Safety**: Full PHP 8.1+ type declarations
- ✅ **Comprehensive Coverage**: All TVMaze API endpoints supported
- ✅ **Exception Handling**: Proper error handling with custom exceptions
- ✅ **Rate Limiting**: Built-in rate limit detection and handling
- ✅ **Embedding Support**: Support for embedded resources (HAL)
- ✅ **Extensive Testing**: Unit tests + contract tests against real API
- ✅ **CI/CD Pipeline**: Automated testing and quality checks
- ✅ **Code Quality**: PHPStan, PHP CS Fixer, and comprehensive linting

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

[](#installation)

```
composer require lukaszzychal/tvmaze-client-php:^2.0
```

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

[](#requirements)

- PHP 8.1 or higher
- Guzzle HTTP 7.5 or higher

Quick Start
-----------

[](#quick-start)

```