socialconnect/instagram

Awesome SDK to work with Instagram social network

0.1 2015-07-09 10:22 UTC

Requires

• php: >=5.4
• ext-json: *
• socialconnect/common: ~0.3.2
• squizlabs/php_codesniffer: ~2.3.3

Requires (Dev)

• phpunit/phpunit: ~4.5

MIT

• Dmitry Patsura

README

Awesome SDK to work with Instagram social network

Available methods:

• searchUser
• getUser
• getUserFeed
• getUserMediaRecent
• getUserMediaLiked
• getMediaLikes
• removeMediaLike
• getUserFollows
• getUserFollowedBy
• getMedia
• getMediaPopular

Authentication

This library is SDK, see OAuth provider in socialconnect/auth project.

Installation

Add a requirement to your composer.json:

{
    "require": {
        "socialconnect/instagram": "~0.1"
    }
}

Run the composer installer:

php composer.phar install

How to use

First you need to create service:

// Your Instagram Application's settings
$appId = 'appId';
$appSecret = 'secret';

$instagramClient = new \SocialConnect\Instagram\Client($appId, $appSecret);
$instagramClient->setHttpClient(new \SocialConnect\Common\Http\Client\Curl());

Get user with specified $id:

$instagramClient = $instagramClient->getUser(715473058);
var_dump($user);

Get self information:

$instagramClient = $instagramClient->getUser();
var_dump($user);

Customs methods

$parameters = [];
$result = $instagramClient->request('method/CustomMethod', $parameters);
if ($result) {
    var_dump($result);
}

Custom entities

class MyUserEntitiy extends \SocialConnect\Instagram\Entity\User {
    public function myOwnMethod()
    {
        //do something
    }
}

$instagramClient->getEntityUser(new MyUserEntitiy());
$user = $instagramClient->getUser(1);

if ($user) {
    $instagramClient->myOwnMethod();
}

License

This project is open-sourced software licensed under the MIT License. See the LICENSE file for more information.