jbarbin/googlebooksbundle

A basic Symfony bundle provide a simple way to use Google Books API.

dev-master 2018-02-09 21:55 UTC

Requires

• php: >=5.6.0
• guzzlehttp/guzzle: >=6.0.0

GPL-3.0

• Jonathan Barbin

• symfony
• api
• bundle
• books
• Google Books

README

A basic Symfony bundle provide a simple way to use Google Books API.

Installation

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

$ composer require jbarbin/googlebooksbundle

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...

            new JBarbin\GoogleBooksBundle\JBarbinGoogleBooksBundle(),
        );

        // ...
    }

    // ...
}

Step 3: Configure your Google API Key

First at all, you need to create an api key on google developer console on https://console.developers.google.com. You have to activate Google Books API on your project and create an api key.

# app/services.yml


parameters:
    // ...
    jbarbin_googlebooks.google_api_key: ???????????????????????????

Usage

Search books by title or/and author

// Use statement
use JBarbin\GoogleBooksBundle\GoogleAPI\Query;

// ...

$googleAPI = $this->get('jbarbin_googlebooks_api');
$api_key = $this->container->getParameter('jbarbin_googlebooks.google_api_key');
$query = new Query($api_key);

// Search by title
$query->setTitle('book title');

// Search by author
$query->setTitle('book author');

// Get results
$books = $googleAPI->searchBook($query);