Проверка структурной доступности в NextPDF Connect (Pro)

Кратко

Запустите анализ структурной доступности в NextPDF Connect. Используйте check_accessibility; он проверяется через поставщика инструментов Pro, который регистрирует new CheckAccessibilityTool() под протокольным именем check_accessibility. Описание инструмента задаёт область применения: он анализирует структурную доступность PDF — заголовки, таблицы, изображения и индикаторы порядка чтения. Он возвращает индикаторы и рекомендации по устранению. Он не подтверждает соответствие Portable Document Format/Universal Accessibility (PDF/UA) или Web Content Accessibility Guidelines (WCAG). Соответствие определяет средство проверки, например veraPDF или средство тестирования PDF/UA. check_accessibility — это инструмент уровня Pro. NextPDF проверяет его через class_exists() при загрузке и регистрирует только тогда, когда установлен пакет Pro.

Установка

composer require nextpdf/server
composer require nextpdf/pro

Привяжите транспорт, затем подтвердите наличие инструмента через diagnostic.capabilities.

Концептуальный обзор

Доступная структура зависит от двух факторов: логического дерева структуры, состоящего из структурных элементов (ISO 32000-2 §14.7), и объявленного языка документа, заданного через запись Lang в каталоге (ISO 32000-2 §14.9; PDF/UA-2 §8.4.4). check_accessibility проверяет эти структурные индикаторы и возвращает результаты с указанием серьёзности и рекомендациями по устранению. Любую числовую оценку или значение pass/fail в отчёте рассматривайте как сводку индикаторов, а не как сертификацию. Используйте отчёт для приоритизации.

Поверхность API

Инструмент	Уровень	Роль	Уровень риска
`create_pdf`, `add_text`	Core (базовый)	Создание содержимого для проверки	Безопасно / Внимание
`check_accessibility`	Pro (профессиональный)	Анализ структурной доступности	Безопасно
`output_pdf`	Core (базовый)	Отрисовка и возврат PDF	Требуется подтверждение / Review (base64)

Имена инструментов совпадают с протокольными именами из реестра. Каталог инструментов — официальный каталог. Установленный уровень определяет, какие инструменты доступны.

Пример кода — быстрый старт

create_pdf → добавьте содержимое с помощью add_text.
check_accessibility с указанием document_id.
Изучите результаты: серьёзность, индикатор, затронутую страницу и подсказку по устранению.
При необходимости используйте output_pdf (base64) для ручной проверки вместе с отчётом.

Пример кода — продакшен

Рассматривайте отчёт как исходные данные для приоритизации, а не как вердикт. Сопоставьте каждый результат с конкретным исправлением: включите тегированный вывод, задайте язык документа и добавьте структуру заголовков. Используйте внешнее средство проверки как контрольный барьер соответствия. Авторитетным считайте именно его вердикт, а не оценку данного инструмента. Запускайте проверку до вызова output_pdf с destroy: true, иначе проверка не увидит документ.

Граничные случаи и подводные камни

Нет содержимого. Пустой документ возвращает результат о том, что содержимого нет, а не сертификацию.
Большой документ. Тайм-аут ограничивает анализ; разбивайте большие входные данные на части или диапазоны.
Уничтоженный сеанс. Запускайте проверку до того, как операция вывода уничтожит сеанс.
Зашифрованный исходный документ. Укажите пароль.
Pro отсутствует. Если установлен только Core, check_accessibility не регистрируется.

Производительность

Тайм-аут из бюджета ограничивает анализ. Профиль — semantic: отчёт формируется структурным анализом, поэтому сравнивайте результаты, а не побайтовый вывод.

Замечания по безопасности

Отчёт описывает структуру, а не секреты в содержимом. Анализируемый документ всё же может быть конфиденциальным, поэтому держите его в пределах своей границы доверия. Во время анализа запись в файловую систему не выполняется.

Соответствие

Утверждение	Спецификация	Раздел
Логическая структура — это дерево структурных элементов.	ISO 32000-2	§14.7
Язык документа объявляется через запись `Lang`.	ISO 32000-2	§14.9
Для доступной разработки нужно указать естественный язык.	PDF/UA-2	§8.4.4

check_accessibility сообщает о структурных индикаторах, которые поддерживают доступную разработку. Он не заявляет о соответствии PDF/UA или WCAG. Соответствие определяет независимое средство проверки.

Коммерческий контекст

check_accessibility — это инструмент уровня Pro. NextPDF регистрирует его только тогда, когда пакет Pro разрешается при загрузке сервера.

Сопоставление с PDF/UA-2

Структурные индикаторы, которые проверяет этот инструмент, соответствуют требованиям PDF/UA-2 к разработке: тегированное дерево структуры (ISO 32000-2 §14.7) и объявленный язык документа (PDF/UA-2 §8.4.4). Инструмент сообщает, присутствуют ли эти индикаторы. Соответствие PDF/UA-2 определяет средство проверки PDF/UA, а не отчёт инструмента.

Тег → перекрёстная ссылка на ISO 32000-2 §14

Результаты по заголовкам и таблицам относятся к элементам логической структуры в дереве структуры ISO 32000-2 §14.7. Результат по языку соответствует записи Lang из §14.9. Инструмент сообщает, присутствуют ли эти структурные опорные точки. Он не проверяет каждое правило для тегов §14; это задача средства проверки.

Сопоставление с WCAG 2.2

Результаты по контрастности и порядку чтения относятся к критериям успеха WCAG, таким как контрастность и осмысленная последовательность. Инструмент сообщает значения индикаторов, например измеренный коэффициент контрастности. Заявление о соответствии WCAG требует полной оценки по WCAG; этот инструмент её не выполняет и не заявляет о соответствии.

Доступность транспортов

Транспорт	Доступен	Примечания
MCP (stdio) — стандартный ввод-вывод	Да (Pro)	Отчёт возвращается как результат работы инструмента.
REST	Да (Pro)	Отчёт возвращается в теле ответа.
gRPC	Да (Pro)	Унарный вызов; отчёт находится в сообщении ответа.

Уровень риска HITL

check_accessibility относится к категории “Безопасно” (анализ только для чтения) и никогда не блокирует операции. Вывод output_pdf в файл требует подтверждения (Approval Required), а режим base64 относится к Review (уровни риска HITL).

JSON-конверт барьера подтверждения

Анализ никогда не блокирует операции:

{ "allowed": true }