Criando aplicativos para Facebook usando SDK do PHP

Atenção

O script utilizado neste artigo utiliza o SDK do facebook versão 3, que se encontra depreciado. Para novos aplicativos é recomendado utilizar a versão 5 do SDK. Você pode acessar uma versão mais atual deste artigo clicando aqui. (Artigo atualizado com a versão mais nova do SDK). Este artigo será mantido como forma de histórico apenas.

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:

criando-aplicativos-facebook1

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:

criando-aplicativos-facebook2

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

criando-aplicativos-facebook3

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)

criando-aplicativos-facebook4

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:

criando-aplicativos-facebook5

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/

Comments

  1. By Accácio Jasson Franklin

    Reply

  2. Reply

    • By pasquati

      Reply

      • By .

        Reply

      • By Marcelo Oliveira

        Reply

        • By Douglas V. Pasqua

          Reply

  3. By felipe

    Reply

    • By pasquati

      Reply

  4. By Adiel

    Reply

    • By pasquati

      Reply

  5. By Tiago

    Reply

    • By pasquati

      Reply

  6. Reply

    • By pasquati

      Reply

  7. Reply

    • Reply

      • By pasquati

        Reply

  8. By Wilson

    Reply

    • By pasquati

      Reply

  9. By Adriano

    Reply

    • By pasquati

      Reply

  10. By Vinicius Alves

    Reply

    • By pasquati

      Reply

  11. Reply

    • By pasquati

      Reply

  12. By Laercio

    Reply

  13. By João Paulo

    Reply

    • By Douglas V. Pasqua

      Reply

  14. By Joel Germano

    Reply

    • By Douglas V. Pasqua

      Reply

      • By Joel Germano

        Reply

        • By Douglas V. Pasqua

          Reply

  15. Reply

  16. By Fausto

    Reply

    • By Douglas V. Pasqua

      Reply

      • By Fausto

        Reply

        • By Douglas V. Pasqua

          Reply

          • By Fausto

          • By Fausto

          • By Douglas V. Pasqua

          • By Fausto

  17. By Pablo

    Reply

    • By Douglas V. Pasqua

      Reply

  18. By Felipe

    Reply

  19. By Roberio Cavalcante

    Reply

    • By Douglas V. Pasqua

      Reply

  20. Reply

    • By Douglas V. Pasqua

      Reply

  21. By Geovane Krüger

    Reply

    • By Douglas V. Pasqua

      Reply

      • By Geovane Krüger

        Reply

        • By Douglas V. Pasqua

          Reply

  22. By Emilio Caveari

    Reply

    • By Douglas V. Pasqua

      Reply

  23. By Paulo César

    Reply

    • By Paulo César

      Reply

  24. Reply

    • By Douglas V. Pasqua

      Reply

  25. Reply

    • By Douglas V. Pasqua

      Reply

  26. By Lucas

    Reply

  27. By André

    Reply

    • By Douglas V. Pasqua

      Reply

  28. By Edmundo

    Reply

    • By Douglas V. Pasqua

      Reply

  29. By Pedro

    Reply

  30. By Robério

    Reply

    • By Douglas V. Pasqua

      Reply

  31. Reply

    • By Douglas V. Pasqua

      Reply

  32. Reply

    • By Douglas V. Pasqua

      Reply

  33. By Fabio

    Reply

    • By Douglas V. Pasqua

      Reply

  34. By Rodolfo

    Reply

    • By Douglas V. Pasqua

      Reply

  35. Reply

    • By Douglas V. Pasqua

      Reply

  36. Reply

    • By Douglas V. Pasqua

      Reply

      • Reply

Deixe um comentário

Follow

Get every new post on this blog delivered to your Inbox.

Join other followers: