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

# Recherche sur un seul champ
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 paginationFlask-SQLAlchemyFastAPI (SQLAlchemy natif)
Obtenir les données de la page actuelle.paginate(page, per_page).items.offset(skip).limit(per_page).all()
Total des enregistrementspagination.totalquery.count()
Nombre total de pagespagination.pagesCalculer manuellement math.ceil(total / per_page)

Formule de calcul de pagination

Exemple

import math
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

# Chemin du fichier : routers/posts.py (étend la route index)
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

<!-- Ajouter la navigation de pagination sous la liste des articles dans index.html -->
{% 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