Igor Escobar

Olá pessoal!

[php]

$easter = ‘Páscoa’;
echo sprinf("Feliz %s ! astrasado =(" , $Easter);

[/php]

Semana passada falei um pouco sobre o meu novo projeto open-source, o Bitly-PHP. Para quem ainda não sabe, o Bitly-PHP é uma nova forma de você interagir com a API RESTful do Bitly. A library permite que você encurte, descubra a url longa, receba informações e estatísticas completas sobre um link encurtado.

Sobre a versão 1.2

Depois do dia em que lancei a primeira versão do Bitly-PHP. Comecei a ouvir a comunidade PHP. Abri tópicos em listas e pedindo por sugestões. O feedback da comunidade foi muito bom. As pessoas realmente gostaram do que viram e o resultado foi isso que estamos vendo agora. A versão 1.2 do Bitly-PHP.

O que mudou?

Para os que estão utilizando desde primeira versão, não se preocupe. Se você baixar a nova versão o seu código continuará funcionando. Todas as alterações foram levando em conta as pessoas que já estavam utilizando.

Na versão 1.0 para você encurtar uma url você podia fazer da seguinte forma:

[php]
<?php
$bitlyphp = new Bitly();
$bitlyphp->login = ‘<your_login>’;
$bitlyphp->api_key = ‘<your_api_key>’;
$bitlyphp->url = ‘http://blog.igorescobar.com&#8217;;
$bitlyphp->shorten();
echo $bitlyphp->getData()->shortUrl; // Imprime a url encurtada.
?>
[/php]

Na versão 1.2 você pode reduzir estas linhas para duas.

[php]
<?php
$bitlyphp = new Bitly( ‘<your_login>’, ‘<your_api_key>’);
echo $bitlyphp->shorten(‘http://blog.igorescobar.com&#8217;); // Imprime a url encurtada.
?>
[/php]

Mais prático, não?

As parâmetros mais básicos e obvios foram encapsulados dentro do próprio método reduzindo o tempo gasto para o usuário que queria fazer algo que não fuga do simples “encurtar urls”.

Mas o método:

[php]
print_r( $bitlyphp->getData() );
[/php]

Continua valendo caso você queira acessar um dado mais específico.

O que mais mudou?

• Agora Bitly-PHP está também, disponível no PHP Classes.
• Todos os comentários dentro da library do Bitly-PHP foram re-escritos em inglês.
• Todos os exemplos dados na Wiki do Bitly-PHP foram re-escritos e simplificados para as alterações que vieram com a versão 1.2.
• 2 bugs foram corrigidos.

Sobre o Bitly-PHP

Nos últimos dias tenho trabalhado em uma library em PHP (claro) para abstrair as funcionalidades da API RESTful do Bit.ly . Se chama Bitly-PHP. Toda a library foi desenvolvida utilizando PHP5, Orientação a Objetos, Naming Convention e cURL (se não tiver ele usa uma função alternativa).

Download e Documentação

Você pode fazer o download da library direto na pagina do Bitly-PHP no GitHub. Todos os outros exemplos de uso da library você encontra direto no Wiki do Bitly-PHP.

Se você tem o git na sua máquina você pode executar o comando:

[php]git clone git://github.com/igorescobar/Bitly-PHP.git[/php]

Encurtando URLs

O primeiro que você deve fazer é incluir a arquivo que contém a library do Bitly-PHP:
[php]
include_once("Bitly-PHP/bitly.php");
[/php]

Depois é muito simples. Você só precisa instanciar o objeto do Bitly PHP, informar a URL que quer encurtar, invocar o método responsável por encurtar as URLs, o shorten.

[php]
include_once("Bitly-PHP/bitly.php");
$bitly = new Bitly();
$bitly->url = ‘http://www.google.com/&#8217;;
$bitly->shorten();
[/php]

O Bitly-PHP possuí um método responsável por acessar os dados que a API do Bit.ly retorna chamado getData().

[php]
include_once("Bitly-PHP/bitly.php");
$bitly = new Bitly();
$bitly->url = ‘http://www.google.com/&#8217;;
$bitly->shorten();
$bitly->getData()->shortUrl; // Saída: http://bit.ly/b6R4Uf
[/php]

Se você não sabe qual o nome do parametro que você quer chamar, chame o metodo debug():

[php]
include_once("Bitly-PHP/bitly.php");
$bitly = new Bitly();
$bitly->url = ‘http://www.google.com/&#8217;;
$bitly->shorten();
$bitly->debug();
[/php]

O debug vai mostrar:

[php]
{
"errorCode": 0,
"errorMessage": "",
"results": {
"http://www.google.com/&quot;: {
"hash": "2V6CFi",
"shortCNAMEUrl": "http://bit.ly/b6R4Uf&quot;,
"shortKeywordUrl": "",
"shortUrl": "http://bit.ly/b6R4Uf&quot;,
"userHash": "b6R4Uf"
}
},
"statusCode": "OK"
}
[/php]

É isso!

[]’s