Recherche par mot-clé et pagination
Dans ce chapitre, vous apprendrez à implémenter une recherche combinée avec SQLAlchemy et à utiliser offset/limit pour la pagination.
recherche insensible à la casse avec ilike
Exemple
posts = db.query(Post).filter(Post.title.ilike(f'%{keyword}%')).all()
# Recherche combinée multi-champs (relation OU)
from sqlalchemy import or_
posts = db.query(Post).filter(
or_(
Post.title.ilike(f'%{keyword}%'),
Post.summary.ilike(f'%{keyword}%')
)
).all()
pagination offset/limit
Flask-SQLAlchemy fournit un moyen pratique.paginate()méthode.
FastAPI utilise SQLAlchemy natif, donc vous devez utiliseroffset + limitImplémenter manuellement la pagination.
| Méthode de pagination | Flask-SQLAlchemy | FastAPI (SQLAlchemy natif) |
|---|---|---|
| Obtenir les données de la page actuelle | .paginate(page, per_page).items | .offset(skip).limit(per_page).all() |
| Total des enregistrements | pagination.total | query.count() |
| Nombre total de pages | pagination.pages | Calculer manuellement math.ceil(total / per_page) |
Formule de calcul de pagination
Exemple
from fastapi import Query
def get_pagination(page: int = 1, size: int = 6):
"""
Calculer les paramètres de pagination
page: numéro de la page actuelle (à partir de 1)
size: nombre d'éléments par page
"""
skip = (page - 1) * size # Nombre d'enregistrements ignorés
return skip, size
# Exemple d'utilisation
skip, limit = get_pagination(page=2, size=6)
# skip = 6, limit = 6 → ignorer les 6 premiers, obtenir les éléments 7-12
Vue complète de recherche + pagination
Exemple
from sqlalchemy import or_
from math import ceil
from fastapi import APIRouter, Depends, Request, Requête
@router.get("/", name="index")
def index(
request: Request,
category: str | None = Query(None),
q: str | None = Query(None, description=“Mots-clés de recherche”),
page: int = Query(1, ge=1, description="Numéro de page"),
size: int = Query(6, ge=1, le=50, description="Éléments par page"),
db: Session = Depends(get_db)
):
"""Accueil : filtrage par catégorie + recherche par mot-clé + pagination"""
posts_query = db.query(Post).order_by(Post.created_at.desc())
# Filtre de catégorie
if category:
posts_query = posts_query.join(Category).filter(Category.slug == category)
# Recherche par mot-clé
if q:
keyword = f'%{q.strip()}%'
posts_query = posts_query.filter(
or_(
Post.title.ilike(keyword),
Post.summary.ilike(keyword)
)
)
# Pagination
total = posts_query.count()
total_pages = ceil(total / size)
skip = (page - 1) * size
posts = posts_query.offset(skip).limit(size).all()
return templates.TemplateResponse("index.html", {
"request": request,
"posts": posts,
"categories": db.query(Category).all(),
"category_slug": category or "",
"keyword": q ou "",
"page": page,
"total_pages": total_pages,
"total": total
})
Query(1, ge=1)ingeest l'abréviation de supérieur ou égal. Les paramètres de requête de FastAPI prennent en charge toutes les contraintes numériques : ge, le, gt, lt. Si un utilisateur passe page=0, FastAPI renvoie automatiquement une erreur 422.
Navigation de pagination dans les modèles
Exemple
{% if total_pages > 1 %}
<div class="pagination">
{% if page > 1 %}
<a href="/?page={{ page - 1 }}&category={{ category_slug }}&q={{ keyword }}">← Page précédente</a>
{% endif %}
<span class="page-info">Page {{ page }} / {{ total_pages }} pages</span>
{% if page < total_pages %}
<a href="/?page={{ page + 1 }}&category={{ category_slug }}&q={{ keyword }}">Page suivante →</a>
{% endif %}
</div>
{% endif %}
Résumé du chapitre
Dans ce chapitre, vous avez implémenté des fonctionnalités pratiques pour la page de liste : recherche insensible à la casse avec ilike, recherche combinée multi-champs avec or_(), pagination manuelle par offset/limit (remplaçant paginate de Flask), et Query() pour contraindre les plages de paramètres de requête.
La recherche + le filtrage par catégorie + la pagination peuvent être combinés dans n'importe quel ordre, et les conditions ne seront pas perdues.
autres extensions