Vérifier l’accessibilité structurelle avec NextPDF Connect (Pro)

En un coup d’œil

Lance une analyse d’accessibilité structurelle avec NextPDF Connect. L’outil s’appelle check_accessibility ; il est revalidé auprès du fournisseur d’outils Pro, qui enregistre new CheckAccessibilityTool() sous le nom de protocole check_accessibility. Sa description en délimite la portée : il analyse l’accessibilité structurelle d’un PDF — titres, tableaux, images et indicateurs d’ordre de lecture. Il remonte des indicateurs et des pistes de correction. Il ne certifie pas la conformité PDF/UA ou WCAG. Cette détermination revient à un vérificateur de conformité — par exemple veraPDF ou un outil de test PDF/UA — et non à cet outil. check_accessibility est un outil de niveau Pro. NextPDF le sonde avec class_exists() au démarrage et ne l’enregistre que lorsque le paquet Pro est installé.

Installation

composer require nextpdf/server
composer require nextpdf/pro

Lie un transport. Vérifie ensuite la présence de l’outil avec diagnostic.capabilities.

Vue d’ensemble conceptuelle

Une structure accessible repose sur deux éléments : un arbre de structure logique composé d’éléments de structure (ISO 32000-2 §14.7) et une langue du document déclarée, définie via l’entrée Lang du catalogue (ISO 32000-2 §14.9 ; PDF/UA-2 §8.4.4). check_accessibility inspecte ces indicateurs structurels et renvoie un rapport de constats, chacun assorti d’une gravité et de conseils de correction. Tout score numérique ou résultat pass/fail figurant dans le rapport est un résumé d’indicateurs, pas une certification : interprète-le comme un signal de triage.

Surface de l’API

Outil	Niveau	Rôle	Niveau de risque
`create_pdf`, `add_text`	Core	Construire le contenu à inspecter	Sûr / Prudence
`check_accessibility`	Pro	Analyse d’accessibilité structurelle	Sûr
`output_pdf`	Core	Effectuer le rendu et renvoyer le PDF	Approbation requise / Revue (base64)

Les noms d’outils sont les noms de protocole du registre. Le catalogue d’outils fait foi. Les outils disponibles dépendent du niveau installé.

Exemple de code — Démarrage rapide

create_pdf → ajoute du contenu avec add_text.
check_accessibility avec le document_id.
Lis les constats : la gravité, l’indicateur, la page concernée et la piste de correction.
Facultativement, output_pdf (base64) pour une revue manuelle en complément du rapport.

Exemple de code — Production

Considère le rapport comme une donnée de triage, pas comme un verdict. Associe chaque constat à une correction concrète : activer la sortie balisée, définir la langue du document, ajouter une structure de titres. Pour une barrière de conformité, exécute un vérificateur externe et considère son verdict comme faisant autorité — et non le score de cet outil. Exécute la vérification avant output_pdf avec destroy: true ; sinon, elle ne peut pas voir le document.

Cas limites & pièges

Aucun contenu. Un document vierge produit un constat d’absence de contenu, pas une certification.
Document volumineux. L’analyse est bornée par un délai d’expiration ; découpe les entrées volumineuses ou limite-les à une plage.
Session détruite. Exécute la vérification avant que la sortie ne détruise la session.
Source chiffrée. Fournis le mot de passe.
Pro absent. Avec Core seul, check_accessibility n’est pas enregistré.

Performance

Le délai d’expiration prévu au budget borne l’analyse. Le profil est semantic : le rapport est une sortie d’analyse structurelle, donc une comparaison pertinente porte sur les constats, pas sur la sortie en octets.

Notes de sécurité

Le rapport décrit la structure, pas les secrets du contenu. Le document analysé peut malgré tout être sensible ; garde-le donc à l’intérieur de ta frontière de confiance. Le chemin d’analyse n’écrit rien sur le système de fichiers.

Conformité

Affirmation	Spécification	Clause
La structure logique est un arbre d’éléments de structure.	ISO 32000-2	§14.7
La langue du document est déclarée via l’entrée `Lang`.	ISO 32000-2	§14.9
La langue naturelle doit être spécifiée pour une création accessible.	PDF/UA-2	§8.4.4

check_accessibility signale des indicateurs structurels qui soutiennent une création accessible. Il ne revendique pas la conformité PDF/UA ou WCAG : c’est un vérificateur indépendant qui la détermine.

Contexte commercial

check_accessibility est un outil de niveau Pro, enregistré uniquement lorsque le paquet Pro se résout au démarrage du serveur.

Correspondance PDF/UA-2

Les indicateurs structurels que l’outil inspecte correspondent aux besoins de création PDF/UA-2 : un arbre de structure balisé (ISO 32000-2 §14.7) et une langue de document déclarée (PDF/UA-2 §8.4.4). L’outil signale si ces indicateurs sont présents ou absents. C’est un vérificateur PDF/UA qui détermine la conformité PDF/UA-2, pas le rapport de l’outil.

Correspondance balise → ISO 32000-2 §14

Les constats sur les titres et les tableaux correspondent aux éléments de structure logique de l’arbre de structure ISO 32000-2 §14.7. Le constat sur la langue correspond à l’entrée Lang du §14.9. L’outil indique si ces repères structurels sont présents. Il ne valide pas chaque règle de balisage du §14 : c’est le travail d’un vérificateur.

Correspondance WCAG 2.2

Les constats sur le contraste et l’ordre de lecture se rapportent aux critères de succès WCAG, par exemple le contraste et la séquence significative. L’outil signale des valeurs d’indicateurs, par exemple un rapport de contraste mesuré. Une revendication de conformité WCAG exige une évaluation WCAG complète, ce que cet outil ne fait pas et ne revendique pas.

Disponibilité par transport

Transport	Disponible	Notes
MCP (stdio)	Oui (Pro)	Le rapport est un résultat d’outil.
REST	Oui (Pro)	Le rapport est le corps de la réponse.
gRPC	Oui (Pro)	Unaire ; rapport dans le message de réponse.

Niveau de risque HITL

check_accessibility est Sûr (analyse en lecture seule) et ne déclenche jamais de barrière. output_pdf vers un fichier exige une Approbation requise, et le mode base64 relève de la Revue (niveaux de risque HITL).

Enveloppe JSON de la barrière de confirmation

L’analyse ne déclenche jamais de barrière :

{ "allowed": true }