PHPackages                             oh/instagram-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. oh/instagram-bundle

ActiveSymfony-bundle[API Development](/categories/api)

oh/instagram-bundle
===================

Use Instaphp by sesser (Randy) as a Symfony2 service

25.4k2PHP

Since May 27Pushed 10y ago1 watchersCompare

[ Source](https://github.com/ollieLtd/OhInstagramBundle)[ Packagist](https://packagist.org/packages/oh/instagram-bundle)[ RSS](/packages/oh-instagram-bundle/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependenciesVersions (1)Used By (0)

OhInstagramBundle
=================

[](#ohinstagrambundle)

Uses [Instaphp](https://github.com/sesser/Instaphp) by [sesser](https://github.com/sesser) as a Symfony2 service

Installation
------------

[](#installation)

Install this bundle as usual by adding to composer.json:

```
"oh/instagram-bundle": "dev-master"

```

After installing above module you need to update your composer

```
run the command “php composer.phar update”

```

Register the bundle in `app/AppKernel.php`:

```
// app/AppKernel.php
public function registerBundles()
{
    return array(
        // ...
        new Oh\InstagramBundle\OhInstagramBundle(),
    );
}

```

Add the following line to `app/config/config.yml`:

```
imports:
	- { resource: @OhInstagramBundle/Resources/config/services.yml }

```

Add the following config to your parameters.yml:

```
instagram_api_client_id: YOUR_API_ID
instagram_api_client_secret: YOUR_API_SECRET
instagram_timeout: 30
instagram_connect_timeout: 8

```

And if you're OK with the provided routes, add these to `app/config/routing.yml`

```
OhInstagramBundle:
    resource: "@OhInstagramBundle/Resources/config/routing.yml"
    prefix:   /

```

Usage (Controller)
------------------

[](#usage-controller)

```
//finding a user
$query = "snoopdogg";

$api = $this->get('instaphp');

$response = $api->Users->Find($query);

$userInfo = $response->data[0];

// getting all the pages of results
do {
    $pages[] = $response->data;
while($response = $response->getNextPage());

```

You can also test if a user is logged in.

```
//is a user logged in?
$loggedIn = $this->get('instaphp_token_handler')->isLoggedIn();

```

Usage (Twig)
------------

[](#usage-twig)

Theres a login button included in the views. Just implement this line in your Twig template

```
{{ render(controller('OhInstagramBundle:Instagram:instagramLoginStatus')) }}

```

You should set up your Instagram API account to callback to the "OhInstagramBundle\_callback" route, which you can set yourself, or use the ones provided - "/instaphp/callback".

Instagram Auth Token
--------------------

[](#instagram-auth-token)

There are 2 TokenHandlers included.

1. CookieToken - The Instagram auth code is stored in a cookie

    ```
    services:
        instaphp_token_handler:
            class:            Oh\InstagramBundle\TokenHandler\CookieToken

    ```
2. UserToken - The Instagram auth code is stored in the User Entity. The methods setInstagramAuthCode() and getInstagramAuthCode() must be implemented on your User. When the login call is returned from Instagram, the code is set and the user is persisted and flushed in the Handler.

    ```
    services:
        instaphp_token_handler:
            class:            Oh\InstagramBundle\TokenHandler\UserToken
            arguments:        [@security.context, @doctrine.orm.default_entity_manager]

    ```
3. Both - This will look to see if the user can be retrieved from the context and if it can't it will store the auth code in a cookie.

    ```
    services:
        instaphp_user_token_handler:
            class:            Oh\InstagramBundle\TokenHandler\UserToken
            arguments:        [@security.context, @doctrine.orm.default_entity_manager]
        instaphp_cookie_token_handler:
            class:            Oh\InstagramBundle\TokenHandler\CookieToken
        instaphp_token_handler:
            class:            Oh\InstagramBundle\TokenHandler\TokenManager
            arguments:        [@instaphp_user_token_handler, @instaphp_cookie_token_handler]

    ```

You can also implement your own TokenHandlerInterface to store the auth code somewhere else, like the session etc.

Tests
-----

[](#tests)

@todo

Credits
-------

[](#credits)

- Ollie Harridge (ollietb) as the author.
- Randy (sesser) for writing the Instaphp script \[\]

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 82.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/c292a6c56c272b9c31da4a195de55521accd66989e84cd7e0767423a6743a275?d=identicon)[ollietb](/maintainers/ollietb)

---

Top Contributors

[![ollietb](https://avatars.githubusercontent.com/u/342090?v=4)](https://github.com/ollietb "ollietb (28 commits)")[![rmasters](https://avatars.githubusercontent.com/u/34284?v=4)](https://github.com/rmasters "rmasters (4 commits)")[![ramireddy558](https://avatars.githubusercontent.com/u/7223426?v=4)](https://github.com/ramireddy558 "ramireddy558 (2 commits)")

### Embed Badge

![Health badge](/badges/oh-instagram-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/oh-instagram-bundle/health.svg)](https://phpackages.com/packages/oh-instagram-bundle)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)