Library for integration of Facebook PHP SDK v5+ with CodeIgniter 3+

Version: 3.0.0

This library is meant to help you to use the Facebook PHP SDK in a simpler way with CodeIgniter. It is however not at a "can do everything" type of library. If you required highly advanced integrations with the Facebook PHP SDK I recommend you read up on the documentation and use the Facebook PHP SDK directly.

• PHP 5.4+
• CodeIgniter 3
• CodeIgniter session library
• Facebook PHP SDK v5
• Composer

Facebook Canvas and Page Tab support is experimental as I have not been able to test or confirm it working. If you test it, please report back if you had success or failure.

It is very important that you follow the installation steps closely to get the library and Facebook SDK to work

1. Download the library files and add the files to your CodeIgniter installation. Only the library, config and composer.json files are required.
2. In your CodeIgniter /application/config/config.php file, set $config['composer_autoload'] to TRUE. Read more
3. In your CodeIgniter /application/config/config.php file, configure the Session Variables section. Read more
4. Update the facebook.php config file in /application/config/facebook.php with your Facebook App details.
5. Install the Facebook PHP SDK by navigating to your applications folder in the terminal and run Composer with composer install. Read more
6. Autoload the library in application/config/autoload.php or load it in needed controllers with $this->load->library('facebook');.
7. Enjoy!

The library download includes a sample controller and views. The example code might not be the best or most beautiful code, but it is there to help you get started quicker.

Check if user is authenticated. Returns access token object if user is, else empty.

$this->facebook->is_authenticated();

Get login url. This method will only return a URL when using the redirect (web) login method.

$this->facebook->login_url();

Check if user is logged. This method will only return a URL when using the redirect (web) login method.

$this->facebook->logout_url();

Should only be used on the logout redirect url location. This method will unset the Facebook token cookie set by this library only. This method can not be used to log out a user!

$this->facebook->destroy_session();

Main method to do Graph requests. Should support all, or at least most of the avaialble Facebook Graph methods.

All methods has not been tested, please submit an issue report if you encounter any issues

This method returns an array on both success or failure.

Short exampel to get user information and print it out.

$user = $this->facebook->request('get', '/me');
if (!isset($user['error']))
{
    print_r($user);
}

• Facebook Graph API documentation can be found here.
• List of Facebook Graph API Error codes can be found here.

Upload a image or video file to a users profile.

This method only support upload to a users profile. Upload to a page is not possible at this moment.

Short exampel to upload a file from the server.

$this->facebook->user_upload_request('/path/to/file.jpg', ['message' => 'This is a test upload']);

• Facebook Graph API documentation can be found here.
• List of Facebook Graph API Error codes can be found here.

Add a request to the batch pool to be sent later in batch request.

$this->facebook->add_to_batch_pool('user-profile', 'get', '/me');

Add a request to the batch pool to be sent later in batch request.

$this->facebook->remove_from_batch_pool('user-profile');

Send the batch pool requests.

Example on how batch requests works in the Facebook documentation.

$this->facebook->send_batch_pool();

$this->facebook->add_to_batch_pool('user-profile', 'get', '/me');
$this->facebook->remove_from_batch_pool('user-email');
$responses = $this->facebook->send_batch_pool();

foreach ($responses as $key => $data)
{
	print_r($key);
	print_r($data);
}

If you want to work directly with the Facebook\Facebook service class, you can do so. The object() method will return the full object of new Facebook\Facebook service class that you can use however you would like.

The library will still take care of the loading of the SDK and load configured login helper.

Documentation for Facebook\Facebook service class can be found here and full SDK reference list here.

$fb = $this->facebook->object();

// Get user info
$response = $fb->get('/me');
$user     = $response->getDecodedBody();

print_r($user);