nelmio/NelmioApiDocBundle

📄 Tự động sinh tài liệu API REST từ PHP attributes

NelmioApiDocBundle sinh tài liệu API dựa trên attributes, không cần viết tay spec.

NelmioApiDocBundle là bundle Symfony phổ biến (2.3k sao) sinh tài liệu API REST tự động từ PHP 8 attributes. Dành cho dự án Symfony cần tài liệu OpenAPI chuẩn, tích hợp sẵn Redoc và Swagger UI.

✨ Điểm nổi bật

• PHP 8 attributes: Thay thế hoàn toàn annotations, cú pháp hiện đại, type-safe.
• OpenAPI 3.0+: Sinh spec chuẩn, hỗ trợ đầy đủ schema và validation.
• Redoc + Swagger UI: Giao diện tài liệu tương tác, cấu hình qua YAML.
• Symfony 6.4+: Tích hợp sâu với routing, serialization và validation.
• Cấu hình linh hoạt: Tùy chỉnh model, filters, security qua config.
• MIT license: Dự án nguồn mở, dễ dàng extend.

💡 Vì sao đáng chú ý

Không giống công cụ sinh docs thủ công, NelmioApiDocBundle đồng bộ code và tài liệu — thay đổi attribute là docs tự cập nhật. Phù hợp team cần tài liệu chuẩn OpenAPI để test contract, generate client SDK, hoặc expose API cho bên thứ ba.

#PHP #Symfony #OpenAPI #Swagger #RESTAPI #TiniX