SpotifyApiBundle for Symfony2
, (*1)
This bundle is only a wrapper of Spotify Api for all Symfony2 developers.
You can find all API specification here, (*2)
Table of contents
-
Installing/Configuring
- API Search
- API Lookup
- Contribute
Installing/Configuring
- Use version
1.0-dev
for last updated. Alias of dev-master
.
- Use last stable version tag to stay in a stable release.
You have to add require line into you composer.json file, (*3)
``` json
"require": {
"php": ">=5.3.3",
"symfony/symfony": "2.3.*",, (*4)
"mmoreram/spotify-api-bundle": "dev-master"
}, (*5)
Then you have to use composer to update your project dependencies
```bash
$ php composer.phar update
And register the bundle in your appkernel.php file, (*6)
``` php
return array(
// ...
new Mmoreram\SpotifyApiBundle\SpotifyApiBundle(),
// ...
);, (*7)
API Search
---
You can search a simple artist name, getting an array of Artists, with a maximum of 100 results
``` php
$page = 1;
$artists = $this
->container
->get('spotify.api.search')
->findArtist('Hans Zimmer', $page);
You can also search also a simple artist name, getting only first Artist, (*8)
``` php
$artists = $this
->container
->get('spotify.api.search')
->findFirstArtist('Hans Zimmer');, (*9)
You can search a simple Album name, getting an array of Albums, with a maximum of 100 results
``` php
$page = 1;
$albums = $this
->container
->get('spotify.api.search')
->findAlbums("Pirate of the Caribbean, at world's end", $page);
You can also search also a simple artist name, getting only first Artist, (*10)
``` php
$albums = $this
->container
->get('spotify.api.search')
->findFirstAlbum("Pirate of the Caribbean, at world's end");, (*11)
You can search a simple Track name, getting an array of Tracks, with a maximum of 100 results
``` php
$page = 1;
$tracks = $this
->container
->get('spotify.api.search')
->findTracks("I don't think now is the best time", $page);
You can also search also a simple artist name, getting only first Artist, (*12)
``` php
$tracks = $this
->container
->get('spotify.api.search')
->findFirstTrack("I don't think now is the best time");, (*13)
API Lookup
---
Given an artist code, you can get all related information by using the Spitify Api Lookup service
``` php
$artist = $this
->container
->get('spotify.api.search')
->getArtist('spotify:artist:0YC192cP3KPCRWx8zr8MfZ');
Given an album code, you can also get all related information it, (*14)
``` php
$album = $this
->container
->get('spotify.api.search')
->getAlbum('spotify:album:6JoI0NEAqeJ20X6lU3Drx0');, (*15)
And given a track code, you can also get all related information about it
``` php
$track = $this
->container
->get('spotify.api.search')
->getTrack('spotify:track:5sbwYsgzeg7wsug1A1pTiO');
Contribute
All code is Symfony2 Code formatted, so every pull request must validate phpcs standards.
You should read Symfony2 coding standards and install this CodeSniffer to check all code is validated., (*16)
There is also a policy for contributing to this project. All pull request must be all explained step by step, to make us more understandable and easier to merge pull request. All new features must be tested with PHPUnit., (*17)
If you'd like to contribute, please read the Contributing Code part of the documentation. If you're submitting a pull request, please follow the guidelines in the Submitting a Patch section and use the [Pull Request Template][3]., (*18)
, (*19)