2017 © Pedro Peláez
 

library laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

image

php-tmdb/laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  • Wednesday, May 2, 2018
  • by wtfzdotnet
  • Repository
  • 12 Watchers
  • 117 Stars
  • 6,472 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 33 Forks
  • 2 Open issues
  • 14 Versions
  • 8 % Grown

The README.md

Laravel Package for TMDB API Wrapper

License Build Status Code Coverage PHP & HHVM, (*1)

A Laravel package that provides easy access to the php-tmdb/api TMDB (The Movie Database) API wrapper. This package comes with a service provider that configures the Tmdb\Client and registers it to the IoC container. Both Laravel 5 and 4 are supported., (*2)

Latest Stable Version Latest Unstable Version Dependency Status Total Downloads, (*3)

Looking for maintainers

We are urgently looking for new mainteners of this library, we need someone that can steer this package in the right direction for the Laravel community, we do not currently have anybody on the php-tmdb team that uses laravel on a daily basis. We want the default standards to be met and unit tests to be available just to verify the part of the integration with the framework works. Send an email to php-laravel@wtfz.net if you are interested, or are willing to help out., (*4)

Installation

Install Composer, (*5)

$ curl -sS https://getcomposer.org/installer | php
$ sudo mv composer.phar /usr/local/bin/composer

Add the following to your require block in composer.json config, (*6)

"php-tmdb/laravel": "~1.0"

or just run the following command in your project:, (*7)

composer require php-tmdb/laravel

Configuration

Add to your app/config/app.php (Laravel 4) or config/app.php (Laravel <5.5) the service provider:, (*8)

'providers' => array(
    // other service providers

    'Tmdb\Laravel\TmdbServiceProvider',
)

Then publish the configuration file:, (*9)

Laravel 4

php artisan config:publish php-tmdb/laravel

Laravel 5

php artisan vendor:publish --provider="Tmdb\Laravel\TmdbServiceProviderLaravel5"

Next you can modify the generated configuration file tmdb.php accordingly., (*10)

That's all! Fire away!, (*11)

Usage

We can choose to either use the Tmdb Facade, or to use dependency injection., (*12)

Facade example

The example below shows how you can use the Tmdb facade. If you don't want to keep adding the use Tmdb\Laravel\Facades\Tmdb; statement in your files, then you can also add the facade as an alias in config/app.php file., (*13)

use Tmdb\Laravel\Facades\Tmdb; // optional for Laravel ≥5.5

class MoviesController {

    function show($id)
    {
        // returns information of a movie
        return Tmdb::getMoviesApi()->getMovie($id);
    }
}

Dependency injection example

use Tmdb\Repository\MovieRepository;

class MoviesController {

    private $movies;

    function __construct(MovieRepository $movies)
    {
        $this->movies = $movies;
    }

    function index()
    {
        // returns information of a movie
        return $this->movies->getPopular();
    }
}

Listening to events

We can easily listen to events that are dispatched using the Laravel event dispatcher that we're familiar with. The following example listens to any request that is made and logs a message., (*14)

use Log;
use Event;
use Tmdb\Event\TmdbEvents;
use Tmdb\Event\RequestEvent;

Event::listen(TmdbEvents::REQUEST, function(RequestEvent $event) {
    Log::info("A request was made to TMDB");
    // do stuff with $event
});

In Laravel 5 instead of using the Event facade we could also have used the EventServiceProvider to register our event listener., (*15)

Image helper

You can easily use the ImageHelper by using dependency injection. The following example shows how to show the poster image of the 20 most popular movies., (*16)

namespace App\Http\Controllers;

use Tmdb\Helper\ImageHelper;
use Tmdb\Repository\MovieRepository;

class WelcomeController extends Controller {

    private $movies;
    private $helper;

    public function __construct(MovieRepository $movies, ImageHelper $helper)
    {
        $this->movies = $movies;
        $this->helper = $helper;
    }

    /**
     * Show the application welcome screen to the user.
     *
     * @return Response
     */
    public function index()
    {
        $popular = $this->movies->getPopular();

        foreach ($popular as $movie)
        {
            $image = $movie->getPosterImage();
            echo ($this->helper->getHtml($image, 'w154', 260, 420));
        }
    }

}

The Configuration used by the Tmdb\Helper\ImageHelper is automatically loaded by the IoC container. If you are a Laravel 5.1 user you could also use the blade's @inject functionality,, (*17)

@inject('image', 'Tmdb\Helper\ImageHelper')

@foreach ($movies as $movie)
    {!! $image->getHtml($movie->getPosterImage(), 'w154', 260, 420) !!}
@endforeach

Registering plugins

Plugins can be registered in a service provider using the boot() method., (*18)

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Tmdb\HttpClient\Plugin\LanguageFilterPlugin;

class TmdbServiceProvider extends ServiceProvider {

    /**
     * Add a Dutch language filter to the Tmdb client
     *
     * @return void
     */
    public function boot()
    {
        $plugin = new LanguageFilterPlugin('nl');
        $client = $this->app->make('Tmdb\Client');
        $client->getHttpClient()->addSubscriber($plugin);
    }

    /**
     * Register services
     * @return void
     */
    public function register()
    {
        // register any services that you need
    }
}

For all all other interactions take a look at php-tmdb/api., (*19)

The Versions

02/05 2018

dev-master

9999999-dev

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Redeman

laravel api php wrapper tv movie tvdb tmdb tv show

02/05 2018

v1.1.2

1.1.2.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Redeman

laravel api php wrapper tv movie tvdb tmdb tv show

07/09 2017

v1.1.1

1.1.1.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Redeman

laravel api php wrapper tv movie tvdb tmdb tv show

23/12 2015

v1.1.0

1.1.0.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Redeman

laravel api php wrapper tv movie tvdb tmdb tv show

22/12 2015

v1.0.5

1.0.5.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

The Requires

 

The Development Requires

by Mark Redeman

11/10 2015

v1.0.4

1.0.4.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

The Requires

 

The Development Requires

by Mark Redeman

13/09 2015

v1.0.3

1.0.3.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

The Requires

 

The Development Requires

by Mark Redeman

16/04 2015

v1.0.2

1.0.2.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

The Requires

 

The Development Requires

by Mark Redeman

13/04 2015

v1.0.1

1.0.1.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

The Requires

 

The Development Requires

by Mark Redeman

04/04 2015

v1.0.0

1.0.0.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

The Requires

 

The Development Requires

by Mark Redeman

25/11 2014

v0.1.3

0.1.3.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

The Requires

 

The Development Requires

by Michael Roterman

24/11 2014

v0.1.2

0.1.2.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

The Requires

 

The Development Requires

by Michael Roterman

16/10 2014

v0.1.1

0.1.1.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

The Requires

 

The Development Requires

by Michael Roterman

13/09 2014

v0.1

0.1.0.0

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

  Sources   Download

The Requires

 

The Development Requires

by Michael Roterman