PHPackages                             juancarlo99/pdf-pades-signature-extractor - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [PDF & Document Generation](/categories/documents)
4. /
5. juancarlo99/pdf-pades-signature-extractor

ActiveLibrary[PDF & Document Generation](/categories/documents)

juancarlo99/pdf-pades-signature-extractor
=========================================

PHP library to extract PAdES digital signature data from signed PDF files

1.0.1(3mo ago)06MITPHPPHP >=8.1CI passing

Since Dec 20Pushed 3mo agoCompare

[ Source](https://github.com/juancarlo99/pdf-pades-signature-extractor)[ Packagist](https://packagist.org/packages/juancarlo99/pdf-pades-signature-extractor)[ RSS](/packages/juancarlo99-pdf-pades-signature-extractor/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (4)Used By (0)

PDF PAdES Signature Extractor
=============================

[](#pdf-pades-signature-extractor)

[EN](#english) | [PT-BR](#portugu%C3%AAs-brasil)

---

English
-------

[](#english)

### 📄 Overview

[](#-overview)

**PDF PAdES Signature Extractor** is a PHP library designed to **extract technical data from digital signatures (PAdES)** embedded in signed PDF files.

This project was created as a **real-world, production-oriented library**, focused strictly on **data extraction**, not on legal or juridical validation.

> ⚠️ This library **does NOT validate the legal authenticity** of a digital signature.
> It only extracts technical information from the embedded X.509 certificate.

---

### ✨ Features

[](#-features)

- Detects PAdES signatures in PDF files
- Extracts PKCS#7 signature blocks
- Parses X.509 certificates
- Extracts:
    - Signer name
    - CPF or CNPJ (ICP-Brasil)
    - Certificate issuer
    - Certificate validity period
    - Basic signature metadata
    - Signing date/time (CMS SigningTime, quando disponível)
    - Cadeia de certificados X.509 (PEM)
- Built on top of OpenSSL
- Clean architecture (DTOs, Services, Exceptions)
- PSR-4 compliant

---

### ❌ What this library does NOT do

[](#-what-this-library-does-not-do)

- Certificate chain validation (ICP-Brasil)
- OCSP / CRL verification
- Timestamp Authority (TSA) validation
- Legal or juridical validation
- Signature trust evaluation

---

### 🧱 Requirements

[](#-requirements)

- PHP **8.1+**
- OpenSSL extension enabled
- PDF signed using the **PAdES** standard

---

### 📦 Installation

[](#-installation)

```
composer require juancarlo99/pdf-pades-signature-extractor
```

---

### 🚀 Basic Usage

[](#-basic-usage)

```
use Juancarlo99\PdfPadesSignatureExtractor\Extractor\PadesExtractor;

$extractor = new PadesExtractor();
$signature = $extractor->extract('signed.pdf');

echo $signature->signerName;
echo $signature->cpf;
echo $signature->issuer;
```

---

### 📄 License

[](#-license)

MIT License

### 👩‍💻 Development

[](#‍-development)

Using Docker (recommended):

```
docker compose up -d
docker compose exec app composer install
docker compose exec app vendor/bin/phpunit --no-coverage
docker compose exec app vendor/bin/phpcs --standard=phpcs.xml src tests
docker compose exec app vendor/bin/phpstan analyse -c phpstan.neon
```

Composer scripts:

```
composer test
composer lint
composer stan
```

#### Sensitive tests

[](#sensitive-tests)

Some tests depend on local sample files and are annotated with the PHPUnit group `sensitive`. These tests are excluded in GitHub CI.

- Run all tests locally: `vendor/bin/phpunit`
- Run only sensitive tests locally: `vendor/bin/phpunit --group sensitive`
- CI excludes them via `--exclude-group sensitive` in the workflow.

---

Português (Brasil)
------------------

[](#português-brasil)

### 📄 Visão Geral

[](#-visão-geral)

**PDF PAdES Signature Extractor** é uma biblioteca PHP criada para **extrair dados técnicos de assinaturas digitais PAdES** presentes em arquivos PDF assinados.

Este projeto foi desenvolvido como uma **biblioteca real e prática**, com foco exclusivo em **extração de informações**, e não em validação jurídica.

> ⚠️ Esta biblioteca **NÃO valida juridicamente** a assinatura digital.
> Ela apenas extrai dados técnicos do certificado X.509 embutido no PDF.

---

### ✨ Funcionalidades

[](#-funcionalidades)

- Detecta assinaturas PAdES em arquivos PDF
- Extrai blocos PKCS#7
- Lê certificados X.509
- Extrai:
    - Nome do assinante
    - CPF ou CNPJ (ICP-Brasil)
    - Autoridade Certificadora
    - Período de validade do certificado
- Baseada em OpenSSL
- Arquitetura limpa (DTOs, Services, Exceptions)
- Compatível com PSR-4

---

### ❌ O que esta biblioteca NÃO faz

[](#-o-que-esta-biblioteca-não-faz)

- Validação de cadeia ICP-Brasil
- Consulta OCSP ou LCR
- Validação de carimbo do tempo (TSA)
- Validação jurídica
- Verificação de confiabilidade da assinatura
- Inferir o "tipo" do certificado (A1/A3). Essa informação não existe nos padrões PDF / PAdES / CMS / X.509.

---

### 🧱 Requisitos

[](#-requisitos)

- PHP **8.1 ou superior**
- Extensão OpenSSL habilitada
- PDF assinado no padrão **PAdES**

---

### 📦 Instalação

[](#-instalação)

Via Composer:

```
composer require juancarlo99/pdf-pades-signature-extractor
```

---

### 🚀 Uso Básico

[](#-uso-básico)

```
use Juancarlo99\PdfPadesSignatureExtractor\Extractor\PadesExtractor;

$extractor = new PadesExtractor();
$assinatura = $extractor->extract('signed.pdf');

echo $assinatura->signerName;
echo $assinatura->cpf;
echo $assinatura->issuer;
// Preferencialmente usa SigningTime; caso não exista, usa notBefore do certificado
echo $assinatura->signedAt->format('c');
// Acesso opcional ao SigningTime original (DateTimeImmutable|null)
// $assinatura->signingDateTime
// Cadeia de certificados em PEM
foreach ($assinatura->certificates as $pem) {
  // ...
}

// Para múltiplas assinaturas no mesmo PDF
$todas = $extractor->extractAll('signed.pdf');
foreach ($todas as $sig) {
  // processa cada assinatura
}
```

---

### 📄 Licença

[](#-licença)

MIT License

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance78

Regular maintenance activity

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~30 days

Total

2

Last Release

113d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/711bb2aa5509723fdf8f31db89c80a5a11b48f619601022a61d7542d2ffc2ac2?d=identicon)[Juan Carlos Nunes](/maintainers/Juan%20Carlos%20Nunes)

---

Top Contributors

[![juan-nunes-gruppe](https://avatars.githubusercontent.com/u/243978465?v=4)](https://github.com/juan-nunes-gruppe "juan-nunes-gruppe (14 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/juancarlo99-pdf-pades-signature-extractor/health.svg)

```
[![Health](https://phpackages.com/badges/juancarlo99-pdf-pades-signature-extractor/health.svg)](https://phpackages.com/packages/juancarlo99-pdf-pades-signature-extractor)
```

###  Alternatives

[phpoffice/phpspreadsheet

PHPSpreadsheet - Read, Create and Write Spreadsheet documents in PHP - Spreadsheet engine

13.9k293.5M1.3k](/packages/phpoffice-phpspreadsheet)[spatie/browsershot

Convert a webpage to an image or pdf using headless Chrome

5.2k32.1M102](/packages/spatie-browsershot)[smalot/pdfparser

Pdf parser library. Can read and extract information from pdf file.

2.7k34.5M216](/packages/smalot-pdfparser)[barryvdh/laravel-snappy

Snappy PDF/Image for Laravel

2.8k24.8M48](/packages/barryvdh-laravel-snappy)[openspout/openspout

PHP Library to read and write spreadsheet files (CSV, XLSX and ODS), in a fast and scalable way

1.1k57.6M131](/packages/openspout-openspout)[setasign/tfpdf

This class is a modified version of FPDF that adds UTF-8 support. The latest version is based on FPDF 1.85.

426.1M30](/packages/setasign-tfpdf)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)