Crear paginación con PHP y jQuery
Una paginación con PHP y jQuery sin recargar la página funciona así: el navegador pide al servidor solo los registros de la página actual, el servidor responde en JSON y jQuery pinta la tabla y el paginador. Aquí tienes un ejemplo completo: una tabla de usuarios con filtro por nombre y por email, el paginador del plugin SimplePagination y un resumen del tipo «7 – 12 de 25».
Cómo funciona una paginación con PHP y jQuery
- La página carga y le pide la página 1 a
datos.php. - PHP cuenta cuántos registros cumplen el filtro (
COUNT(*)) y devuelve en JSON solo las 6 filas de esa página (LIMITyOFFSET). - jQuery dibuja las filas y crea el paginador con el total que le ha dado el servidor.
- Al pulsar un número, se pide esa página con el mismo filtro. Al filtrar de nuevo, se vuelve a la página 1 y se crea un paginador nuevo, porque el total ha podido cambiar.
El servidor tiene que devolver el total aparte porque el paginador necesita saber cuántas páginas hay sin tener las filas delante.
Qué necesitas
- PHP con la extensión PDO para MySQL y una tabla de usuarios como esta:
CREATE TABLE usuarios (
id INT AUTO_INCREMENT PRIMARY KEY,
nombre VARCHAR(100),
email VARCHAR(100)
) CHARACTER SET utf8mb4;- jQuery y el plugin SimplePagination, que el ejemplo carga desde cdnjs (jQuery 3.7.1 y SimplePagination 1.6).
La conexión con PDO
<?php
// Conexión a MySQL con PDO. Cambia host, base, usuario y clave por los tuyos.
$pdo = new PDO(
'mysql:host=localhost;dbname=mi_base;charset=utf8mb4',
'usuario',
'clave',
array(
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
)
);El endpoint en PHP: datos.php
<?php
header('Content-Type: application/json; charset=utf-8');
require __DIR__ . '/conexion.php'; // define $pdo
const POR_PAGINA = 6;
// Convierte el texto del usuario en un patrón LIKE: escapa % y _ para que se busquen tal cual.
function patron($texto) {
$texto = is_string($texto) ? trim($texto) : '';
return '%' . str_replace(array('!', '%', '_'), array('!!', '!%', '!_'), $texto) . '%';
}
// La página debe ser un entero >= 1; cualquier otra cosa se trata como 1.
$pagina = filter_var(isset($_GET['page']) && is_string($_GET['page']) ? $_GET['page'] : 1, FILTER_VALIDATE_INT, array(
'options' => array('min_range' => 1, 'default' => 1),
));
$nombre = patron(isset($_GET['nombre']) ? $_GET['nombre'] : '');
$email = patron(isset($_GET['email']) ? $_GET['email'] : '');
$where = "nombre LIKE :nombre ESCAPE '!' AND email LIKE :email ESCAPE '!'";
try {
// 1) Total de registros que cumplen el filtro
$cuenta = $pdo->prepare("SELECT COUNT(*) FROM usuarios WHERE $where");
$cuenta->execute(array(':nombre' => $nombre, ':email' => $email));
$total = (int) $cuenta->fetchColumn();
// 2) Solo los registros de la página pedida
$sql = $pdo->prepare("SELECT nombre, email FROM usuarios WHERE $where ORDER BY nombre, id LIMIT :limite OFFSET :desde");
$sql->bindValue(':nombre', $nombre);
$sql->bindValue(':email', $email);
$sql->bindValue(':limite', POR_PAGINA, PDO::PARAM_INT);
$sql->bindValue(':desde', ($pagina - 1) * POR_PAGINA, PDO::PARAM_INT);
$sql->execute();
echo json_encode(array(
'total' => $total,
'porPagina' => POR_PAGINA,
'pagina' => $pagina,
'filas' => $sql->fetchAll(),
), JSON_UNESCAPED_UNICODE);
} catch (PDOException $e) {
http_response_code(500);
error_log($e->getMessage()); // el detalle va al log, no al navegador
echo json_encode(array('error' => 'No se pudo consultar la base de datos.'));
}Lo que conviene entender de este fichero:
- Consultas preparadas. Los valores del usuario nunca se concatenan en el SQL: van como parámetros. Es lo que evita la inyección SQL, y lo que más se rompe en los ejemplos antiguos de paginación con filtro.
%y_del usuario. En unLIKEtienen significado propio. La funciónpatron()los escapa con!para que100%busque ese texto literal y no «cualquier cosa».- La página se valida. Un entero mayor o igual que 1;
abc,0,-3,2.5o un array se tratan como la página 1. Si pides una página más allá de la última, no falla: devuelve cero filas. ORDER BY nombre, id. Sin un orden estable, la base de datos puede devolver los registros en otro orden entre una página y la siguiente, y verías filas repetidas o saltadas. Eliddesempata los nombres iguales.COUNT(*)aparte. Contar connum_rowssobre la consulta completa trae todas las filas solo para contarlas.- Solo las columnas necesarias. Aquí
nombreyemail. Nunca devuelvas contraseñas ni campos que la tabla no necesita enseñar. - Errores. Si falla la base de datos, el detalle va al log del servidor y el navegador recibe un HTTP 500 con un mensaje genérico.
Esta es la respuesta para datos.php?nombre=ana, con los datos de la prueba:
{"total":3,"porPagina":6,"pagina":1,"filas":[{"nombre":"Ana Pérez","email":"ana@ejemplo.es"},{"nombre":"Ana_Maria","email":"anam@otro.com"},{"nombre":"Diana Soto","email":"diana@ejemplo.es"}]}Con MySQL o MariaDB y el cotejamiento habitual de utf8mb4, la búsqueda no distingue mayúsculas ni tildes: oscar encuentra Óscar.
La página HTML
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8">
<title>Paginación con PHP y jQuery</title>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/simplePagination.js/1.6/simplePagination.min.css">
</head>
<body>
<form id="filtro">
<label>Nombre <input type="text" name="nombre"></label>
<label>Email <input type="text" name="email"></label>
<button type="submit">Filtrar</button>
</form>
<table id="tabla">
<thead>
<tr><th>Nombre</th><th>Email</th></tr>
</thead>
<tbody></tbody>
</table>
<p id="resumen"></p>
<div id="paginador"></div>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/simplePagination.js/1.6/jquery.simplePagination.min.js"></script>
<script src="paginacion.js"></script>
</body>
</html>El JavaScript: paginacion.js
$(function () {
var $filtro = $('#filtro');
var $cuerpo = $('#tabla tbody');
var $resumen = $('#resumen');
var $paginador = $('#paginador');
// Pide una página al servidor, enviando también los campos del filtro
function pedir(pagina) {
return $.getJSON('datos.php', $filtro.serialize() + '&page=' + pagina);
}
// Dibuja las filas y el resumen "1 - 6 de 25"
function pintar(datos) {
$cuerpo.empty();
if (datos.filas.length === 0) {
$cuerpo.append($('<tr>').append($('<td colspan="2">').text('Sin resultados')));
}
$.each(datos.filas, function (_, fila) {
// .text() escribe el valor como texto: un nombre con <script> no se ejecuta
$cuerpo.append(
$('<tr>')
.append($('<td>').text(fila.nombre))
.append($('<td>').text(fila.email))
);
});
var desde = (datos.pagina - 1) * datos.porPagina + 1;
var hasta = Math.min(datos.pagina * datos.porPagina, datos.total);
$resumen.text(datos.total ? desde + ' - ' + hasta + ' de ' + datos.total : '0 resultados');
}
// Búsqueda nueva: se pide la página 1 y se vuelve a crear el paginador con el total nuevo
function buscar() {
pedir(1).done(function (datos) {
pintar(datos);
$paginador.empty();
if (datos.total > datos.porPagina) {
$paginador.pagination({
items: datos.total,
itemsOnPage: datos.porPagina,
currentPage: 1,
prevText: '«',
nextText: '»',
cssStyle: 'light-theme',
onPageClick: function (numero, evento) {
evento.preventDefault();
pedir(numero).done(pintar);
}
});
}
}).fail(function () {
$resumen.text('No se pudieron cargar los datos.');
});
}
$filtro.on('submit', function (evento) {
evento.preventDefault();
buscar();
});
buscar();
});Tres detalles del JavaScript:
.text()y no.html(). Los valores se escriben en la tabla como texto. Si un usuario se llama<script>alert(1)</script>, se ve ese texto y no se ejecuta nada. Construir las filas concatenando HTML con datos de la base de datos es la vía clásica para un XSS.- El paginador se crea de nuevo en cada búsqueda.
$paginador.empty()y unpagination({...})nuevo con el total actualizado. Así un filtro que devuelve 10 resultados no se queda con las 5 páginas del anterior. evento.preventDefault()evita que el enlace del número de página navegue. La página solicitada llega aonPageClickcomo primer parámetro, y el filtro sale del propio formulario conserialize(), así que cada petición de página lleva el filtro actual.
Resumen «desde – hasta de total»
Antes de este ejemplo había que modificar el código del plugin (el método _draw) para mostrar el total de resultados, y esa modificación se pierde al actualizar el plugin y depende de la versión. Aquí el resumen está fuera: un párrafo #resumen que pintar() rellena con los datos que ya devuelve el servidor.
Si copiaste la versión anterior de esta entrada
La versión de 2015 concatenaba los valores del filtro dentro de la consulta (vulnerable a inyección SQL), devolvía la columna de contraseñas, construía el HTML de las filas en PHP sin escapar y necesitaba funciones que no se incluían. Si copiaste ese código, sustitúyelo por este.
Cuándo no basta
Este esquema (LIMIT con OFFSET) es el más sencillo y vale para tablas de miles de filas. En tablas muy grandes y con páginas muy lejanas, el OFFSET obliga a la base de datos a recorrer todas las filas anteriores, y entonces se pagina por la última clave vista en lugar de por número de página. No se ha medido aquí; es el límite que debes tener presente.
Fuentes: SimplePagination, sentencias preparadas en PDO (manual de PHP), filter_var (manual de PHP) y jQuery.getJSON.
Deja una respuesta