API Allociné Helper is a support for using the API of AlloCiné. Find a lot of information about movies, people, tv series, etc, with the class AlloHelper. It is possible to manipulate the received data with the class AlloData (optional). And as a bonus, you can simply modify posters and photos from the Allociné server just by changing the URL with the class AlloImage.

This is just a script, you put it in your favorite directory and you do a require_once "./api-allocine-helper.php"; in your code.

Usage is very simple, however it is strongly advisable to know OOP, and the try{} catch(){} block.

First, create an AlloHelper object:

<?php
    // Include the script
    require_once "./api-allocine-helper.php";
    
    // Creat the object
    $helper = new AlloHelper;
    

For more clarity, we should define parameters before: the movie's code, and the quantity of information to get.

    $code = 27061;
    $profile = 'small';
    

Next, it's advisable to do requests in an try{} catch(){} block for handling errors.

    try
    {
        // Request sending
        $movie = $helper->movie( $code, $profile );
        
        // Print the title
        echo "Title: ", $movie->title, PHP_EOL;
        
        // Print all data
        print_r($movie->getArray());
        
    }
    catch( ErrorException $error )
    {
        // Error
        echo "Error ", $error->getCode(), ": ", $error->getMessage(), PHP_EOL;
    }
?>

List showtimes for a given cinema, run

$ php console-cinema.php

L'API Allociné Helper permette d'utilizzare il più semplice l'API d'AlloCiné. La classe AlloHelper permette di trovare le informazioni su film, stars, articoli, orari e critiche. È possibile manipolare i dati recuperati dalla classe AlloData (opzionale). La classe AlloImage permette di manipolare facilmente la dimensione dei poster e immagini su Allociné.

require_once "./api-allocine-helper.php";

L'utilizzazione è molto semplice, tuttivia, si consiglia foremente di usare la programmazione orientata ad oggetti e sapere usare i blocchi try{} catch(){}.

Un esempio per recuperare informazioni di un film

<?php
    // inlcludere la liberia
    require_once "./api-allocine-helper.php";
    
    // Creare l'oggetto
    $helper = new AlloHelper;
    

Per chiarezza, si definisce il parametro in anticipo: p.e. il codice del film e la quantità di informazioni da recuperare.

    $code = 27061;
    $profile = 'small';
    

Poi, si consiglia di effettuare la richiesta dentro blocco try{} catch(){} per gestire gli errori.

    try
    {
        // invocare la richiesta
        $movie = $helper->movie( $code, $profile );
        
        // mostra il titolo
        echo "Titre du film: ", $movie->title, PHP_EOL;
        
        // mostra tutti i dati
        print_r($movie->getArray());
        
    }
    catch( ErrorException $error )
    {
        // In caso di errore
        echo "Erreur n°", $error->getCode(), ": ", $error->getMessage(), PHP_EOL;
    }
?>

Mostrare showtimes per un dato cinema, si esegue il seguente:

$ php console-cinema.php