Je suis moi même tombé dans le piège et ai mis pas mal de temps avant de m’en rendre compte mais il faut bien faire attention à la version du SDK Facebook utilisée , et donc de certaines méthodes au risque de voir son application ne plus fonctionner, celui-ci ayant été mis à jour récemment ( PHP SDK 3.1.1).

Rentrons dès à présent dans le vif du sujet!

Facebook Connect

1 ère étape : Enregistrer son application

Pour commencer, vous devez enregistrer une application sur Facebook developers pour bénéficier des APIs de Facebook. Vous obtiendrez alors un app Id et un app Secret.
Pensez à configurer l’app Domain en renseignant le champ url de la partie site web. Il correspond au domaine de votre site ( ex : http://www.votresite.com ).

Application facebook

2 ème étape : Récupérer le PHP SDK

Téléchargez le PHP SDK. Ce SDK permet un accès simple à la fois, au dernier graph API ainsi qu’à l’ancienne API.

3 ème étape : Intégrer Facebook Connect

Tout d’abord initialisons notre objet Facebook :

require '../src/facebook.php';

//Remplacer les x par l’app Id et app Secret
$facebook = new Facebook(array(
  'appId'  => 'xxxxxxxxxx',
  'secret' => 'xxxxxxxxxxxxxxxxxxxxxxxxxxxx',
));

Récupérons l’ID de l’utilisateur :

// Obtenir le User ID
$user = $facebook->getUser();

Si un User Id est retourné par Facebook, cela signifie qu’un utilisateur est conecté sur Facebook. Toutefois cela ne signifie pas qu’un jeton d’accès est valide.
A noter qu’un jeton d’accès est invalide si l’utilisateur est déconnecté.

if ($user) {
  try {
    $user_profile = $facebook->api('/me');
  } catch (FacebookApiException $e) {
    error_log($e);
    $user = null;
  }
}

Selon que vous soyez connecté ou non, vous aurez besoin de l’adresse de login et celle de logout:

// URL de Login ou de logout
if ($user) {
  $logoutUrl = $facebook->getLogoutUrl();
} else {
  $loginUrl = $facebook->getLoginUrl();
}

Autorisation et permission facebook

A noter que l’on peut obtenir tout un tas d’informations intéressantes de l’utilisateur en envoyant des paramètres à notre fonction de getLoginUrl qui nous permettra notamment de récupérer l’email de l’utilisateur, la date de naissance, sa position etc… Bien sur cela dépendra de l’autorisation d’accès donnée par l’utilisateur  à votre application.

Il est possible également de fournir une adresse spécifique de retour avec le paramètre redirect_uri.

$param = array( 'redirect_uri' => 'adresse de retour',
                'scope' => 'email,user_birthday,user_location,user_about_me,user_hometown',);
$loginUrl = $facebook->getLoginUrl($param);

Lien que vous pouvez afficher maintenant sur votre espace de  connexion / déconnexion :

<?php if ($user): ?>
    <a href="<?php echo $logoutUrl; ?>">Déconnexion</a>
<?php else: ?>
      <div>
        <a href="<?php echo $loginUrl; ?>">Connexion avec Facebook</a>
      </div>
<?php endif ?>

Maintenant que nous pouvons identifier qu’un utilisateur est connecté ou non, vous pouvez afficher toutes les informations concernant l’utilisateur :

<?php if ($user): ?>
      <img src="https://graph.facebook.com/<?php echo $user; ?>/picture">
      <h3>Votre Objet utilisateur (/me)</h3>
      <pre><?php print_r($user_profile); ?></pre>
<?php else: ?>
      <strong><em>Vous n'êtes pas connecté</em></strong>
<?php endif ?>

En espérant que ce tutoriel vous aidera à implémenter plus facilement « Facebook Connect » via le PHP SDK 3.x.