Paginator é um script de paginação desenvolvido em PHP para dividir resultados de consultas extensas a um banco de dados MySql, em grupos de "n" registros por página. Gera além disso, uma "barra de navegação" que contém os links às diferentes páginas (<<anterior 1 2 3 4 seguinte>>).

Nota: Como exemplo de paginação podemos ver a página de google, onde se diz que há 13,235 resultados, porém aparecem divididos em várias páginas de 20 resultados cada uma.

A característica principal deste script é sua fácil utilização, já que a forma de paginar é muito conhecida e utilizada. Por isso, não é necessário entende-lo, nem editá-lo, basta simplesmente incluí-lo depois de definir ao menos uma variável. Não obstante, todas as linhas estão comentadas devidamente, para que seja simples continuar a seqüência e saber o que faz o script em cada linha. E o melhor de tudo é que o programa ainda é gratuito.

Utilização do script

A utilização é extremamente simples. Devemos Conectar com o Banco de dados, definir uma sentença sql válida para MySql e armazenar na variável $_pagi_sql. Esta sentença SQL não deve conter a cláusula "LIMIT", pois será agregada automaticamente pelo script.

A definição desta variável é obrigatória. Pode-se criar outras variáveis para personalizar o sistema de paginação em detalhes como o número de resultados por página ou o número de links a outras páginas de resultados que aparecerão.

Logo, inclui-se o script de paginação, e se geram outras variáveis que podemos utilizar para fazer a página de resultados. $_pagi_result é o id de resultado da consulta, que podemos utilizar com alguma função tipo mysql_fetch_array(). $_pagi_navegacao que contém a barra de navegação com links às distintas páginas e $_pagi_info que armazena a informação de registros visualizados e o número de páginas, algo assim como "desde o 16 até o 30 de um total de 123".

Vamos ver um código simples que utiliza Paginator para gerenciar a paginação de resultados.

//Conexão ao banco de dados
$con = mysql_connect("localhost","seu_username","seu_password") or die (mysql_error());
mysql_select_db("tu_base",$con) or die (mysql_error());

//Sentença sql (sem limit)
$_pagi_sql = "SELECT * FROM clientes WHERE sexo='m' ORDER BY idade";

//quantidade de resultados por página (opcional, por padrão 20)
$_pagi_quantos = 10;

//Incluímos o script de paginação. Este já executa a consulta automaticamente
include("paginator.inc.php");

//Lemos e escrevemos os registros da página atual
while($row = mysql_fetch_array($_pagi_result)){
    echo $row['nome']."<br />";
}

//Incluimos a barra de navegação
echo"<p>".$_pagi_navegação."</p>";

Como podemos ver, não há maior trabalho adicional, com respeito ao que se realizara em um código sem paginar. Cabe esclarecer que o nome das variáveis que utiliza o script (internas e externas) começam todas pelo prefixo $_pagi_ para evitar conflitos por coincidências com os nomes de outras variáveis que estejam sendo utilizadas.

Para acessar a uma descrição detalhada de Paginator e baixar o script de maneira gratuita, pode-se ver sua página de início: http://jpinedo.webcindario.com/scripts/paginator/

Referência: Se quiser aprender a paginar resultados por sua própria conta, em CriarWeb.com temos publicado um artigo interessante que pode ser de grande ajuda: Paginação de resultados com PHP e MySQL.