ampache/modules/Tmdb/Api/Genres.php

<?php
/**
 * This file is part of the Tmdb PHP API created by Michael Roterman.
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @package Tmdb
 * @author Michael Roterman <michael@wtfz.net>
 * @copyright (c) 2013, Michael Roterman
 * @version 0.0.1
 */
namespace Tmdb\Api;

/**
 * Class Genres
 * @package Tmdb\Api
 * @see http://docs.themoviedb.apiary.io/#genres
 */
class Genres extends AbstractApi
{
    /**
     * Get the list of genres, and return one by id
     *
     * @param  integer $id
     * @param  array   $parameters
     * @param  array   $headers
     * @return mixed
     */
    public function getGenre($id, array $parameters = array(), array $headers = array())
    {
        $response = $this->getGenres($parameters, $headers);

        if (array_key_exists('genres', $response)) {
            return $this->extractGenreByIdFromResponse($id, $response['genres']);
        }

        return null;
    }

    /**
     * Get the list of genres.
     *
     * @param  array $parameters
     * @param  array $headers
     * @return mixed
     */
    public function getGenres(array $parameters = array(), array $headers = array())
    {
        return $this->get('genre/list', $parameters, $headers);
    }

    /**
     * Get the list of movies for a particular genre by id. By default, only movies with 10 or more votes are included.
     *
     * @param $genre_id
     * @param  array $parameters
     * @param  array $headers
     * @return mixed
     */
    public function getMovies($genre_id, array $parameters = array(), array $headers = array())
    {
        return $this->get('genre/' . $genre_id . '/movies', $parameters, $headers);
    }

    /**
     * @param  integer $id
     * @param  array   $data
     * @return mixed
     */
    private function extractGenreByIdFromResponse($id, array $data = array())
    {
        foreach ($data as $genre) {
            if ($id == $genre['id']) {
                return $genre;
            }
        }

        return null;
    }
}