Criando aplicativos para Facebook usando SDK do PHP

Atenção

Neste artigo vamos demonstrar como criar uma aplicação simples para o facebook usando a Graph API com o sdk do php. Vamos criar um Hello World de aplicação para facebook. Iremos presumir que a aplicação será hospedada em um servidor particular próprio.

Caso não tenha um servidor próprio, é possível configurar o aplicativo para rodar localmente no seu ambiente durante o desenvolvimento do mesmo (veremos como fazer isso mais adiante). Quando precisar publicá-lo em produção, terá que ter um servidor próprio.

Registrar conta como desenvolvedor

O primeiro passo para criar um aplicativo do facebook, é ter sua conta registrada como conta de desenvolvedor. Caso ainda não tenha criado nenhum aplicativo, esse será o seu primeiro passo. Acesso o link https://developers.facebook.com e clique no link Registrar agora!. Veja figura:

Após clicar no link, basta seguir as orientações do passo a passo:

1. Aceitar os termos de adesão
2. Informar mais detalhes sobre o seu perfil de desenvolvedor (pode pular esta etapa caso não queira informar nada)
3. Informação que sua conta agora é uma conta de desenvolvedor

Caso seja necessário o facebook irá verificar sua conta através do envio de um token para o número de um celular seu.

A partir deste ponto já estamos aptos para criar o primeiro aplicativo.

Criando um novo aplicativo

Acesso o link https://developers.facebook.com/apps/ e clique no botão + Criar Novo Aplicativo. Veja figura abaixo:

Na próxima tela informa os dados básicos do seu aplicativo:

Observações:

• Informei apenas os campos Nome do Aplicativo (Veja que informei App Inicial) e App Category (Veja que informei Aplicativos para Páginas) que já são suficientes para testar seu primeiro aplicativo. No campo nome, informe o nome apropriado do seu aplicativo, ele será utilizado dentro do ambiente de aplicativos do facebook.
• Mantenha a opção Hospedagem desabilitada, pois estamos hospedando nosso aplicativo em um servidor próprio ou até mesmo local em caso de desenvolvimento.
• Para finalizar esse processo inicial de criação do aplicativo, informe o captcha solicitado na próxima tela.

Configurando o aplicativo recém-criado

Ao finalizar a etapa anterior de criação do aplicativo, você será redirecionado para a tela de edição de configurações do aplicativo, conforme figura abaixo: (Lembre-se que você pode retornar para esta tela sempre que precisar re-configurar algum parâmetro, basta acessar https://developers.facebook.com/apps e clicar no botão Editar Aplicativo)

Observações:

• Anote o appId e secret presentes no topo da tela. Esses são os dados que identificam seu aplicativo e serão usados na programação do mesmo.
• Clique na aba Site com o Login do Facebook e informe o nome do domínio onde seu aplicativo será hospedado. Não precise informar o caminho completo onde o seu script final esta localizado. Por exemplo, tenha criado seu script php acessível no link http://www.minha-app-facebook.com.br/meuapp.php, informe apenas http://www.minha-app-facebook.com.br.
• Outro ponto a se atentar é que se você estiver utilizando uma porta de comunicação no seu domínio diferente do padrão 80, você deverá informar também a porta. Por exemplo, caso esteja na porta 8080, informe http://www.minha-app-facebook.com.br:8080
• Caso queira testar seu aplicativo no seu próprio ambiente de desenvolvimento local, basta informar o domínio no campo Site com o Login do Facebook e configurá-lo no arquivo hosts na sua estação de trabalho. Veja como fazer no exemplo do próximo passo.

Configurando ambiente local de desenvolvimento

Caso não tenha um servidor próprio e queira testar o aplicativo na sua própria estação de trabalho, configure o arquivo hosts da sua máquia conforme exemplo abaixo:

127.0.0.1    www.minha-app-facebook.com.br

Além dessa configuração no hosts, será necessário ter um ambiente configurado com no mínimo Apache e PHP. Sugiro as opções EasyPHP ou Xampp.

Criando seu aplicativo usando SDK para PHP

Antes de criarmos nosso código php, primeiro vamos baixar o sdk do facebook para PHP, no link: https://github.com/facebook/facebook-php-sdk clicando no botão Download Zip conforme figura abaixo:

Mande extrair o pacote zip dentro do diretório onde irá criar seu aplicativo ou no lugar de sua preferência. Será criado um diretório chamado facebook-php-sdk-master.

Para testar o seu aplicativo, crie um arquivo php com o conteúdo abaixo no seu servidor. Lembrando-se que você dever parametrizar o appId e secret nas linhas 7 e 8:
(O appId e Secret são obtidos na página do seu aplicativo dentro do facebook conforme vimos anteriormente)

<?php
// incluir o sdk do facebook
require 'facebook-php-sdk-master/src/facebook.php';
 
// Configure abaixo o appId e secret do seu aplicativo
$facebook = new Facebook(array(
  'appId'  => '',
  'secret' => '',
));
 
// verifica se o usuário já esta logado no aplicativo
$user = $facebook->getUser();
if ($user) { 
        try {
		// Obtem dados do profile do usuario logado
		// o app terá acesso somente os dados públicos
	        $user_profile = $facebook->api('/me');
 
	        // exibe foto do usuario 
	        echo "<img src='https://graph.facebook.com/$user/picture' />";
 
	        // printa os dados públicos do profile do usuario 
		echo "<pre>";
		print_r($user_profile);
		echo "</pre>";
 
        } catch (FacebookApiException $e) {
		// tratamento de erro
                print_r($e);
        }
} else {
        // usuario não logado, solicitar autenticação
        $loginUrl = $facebook->getLoginUrl();
        echo "<a href='$loginUrl'>Conectar no aplicativo</a><br />";
        echo "<strong><em>Voc&ecirc; n&atilde;o esta conectado..</em></strong>";
}

Para acessar seu novo aplicativo, basta usar a URL configurada no campo Site URL. (Lembre-se que ser você utilizar qualquer outro endereço que não seja o configurado no Site URL não irá conseguir acessar)

Ao acessar o aplicativo já no seu servidor, o usuário será redirecionado para o facebook para que ele possa aceitar o ingresso no aplicativo. Ao aceitar o aplicativo, ele será redirecionado de volta. O aplicativo irá exibir a foto do usuário e os dados públicos dele.

Parabéns

Parabéns por ter concluído este tutorial. Neste momento você criou o seu primeiro aplicativo para facebook usando SDK para PHP.

Indo Além

Para evoluir em seu aplicativo para facebook, aconselho a ler os artigos:

Facebook App: Requisitando permissões pela API do PHP
Facebook php sdk, postando mensagens no mural do usuário
Dicas para testar aplicativos para facebook durante o desenvolvimento

Para consultar todos artigos relacionados a facebook no meu blog:

http://www.douglaspasqua.com/category/facebook/