PHPackages                             platinum-place/php-dgii-xml-signer - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. platinum-place/php-dgii-xml-signer

ActiveLibrary[Parsing & Serialization](/categories/parsing)

platinum-place/php-dgii-xml-signer
==================================

Firmador XML para el uso del API de la DGII (Dirección General de Impuestos Internos) de República Dominicana

v1.0.2(2mo ago)21033MITPHPPHP ^8.1

Since Feb 10Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/platinum-place/php-dgii-xml-signer)[ Packagist](https://packagist.org/packages/platinum-place/php-dgii-xml-signer)[ RSS](/packages/platinum-place-php-dgii-xml-signer/feed)WikiDiscussions main Synced 1mo ago

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

PHP DGII XML Signer
===================

[](#php-dgii-xml-signer)

Una librería en PHP para firmar documentos XML con firma digital conforme a los requerimientos de la **Dirección General de Impuestos Internos (DGII)** de República Dominicana para el sistema de **Comprobantes Fiscales Electrónicos (e-CF)**.

Descripción
-----------

[](#descripción)

Este paquete proporciona las herramientas necesarias para firmar digitalmente documentos XML utilizando certificados digitales válidos, cumpliendo con las especificaciones técnicas establecidas por la DGII para la facturación electrónica en República Dominicana.

Características
---------------

[](#características)

- ✅ Firma digital de documentos XML según estándares XMLDSig
- ✅ Compatible con certificados digitales emitidos por entidades certificadoras autorizadas
- ✅ Cumple con las especificaciones técnicas de la DGII
- ✅ Soporte para Comprobantes Fiscales Electrónicos (e-CF)
- ✅ Validación de estructura XML antes del firmado
- ✅ Fácil integración en aplicaciones PHP existentes

Requisitos
----------

[](#requisitos)

- PHP 8.1 o superior
- Extensión OpenSSL habilitada
- Extensión XMLWriter habilitada
- Extensión DOMDocument habilitada
- Certificado digital válido emitido por una entidad certificadora autorizada

Aclaraciones
------------

[](#aclaraciones)

Aunque la documentación de la DGII explica cómo utilizar la librería **XMLDSIG** para leer los certificados, y esta aplicación está basada en esa documentación, destaco que, por lo menos para mí, hay una parte de la documentación que no está del todo clara.

A continuación, muestro algunos casos:

### Caso 1: Cambiar la clase `XmlSigner.php` (o hacer una copia de la misma con los cambios de lugar)

[](#caso-1-cambiar-la-clase-xmlsignerphp-o-hacer-una-copia-de-la-misma-con-los-cambios-de-lugar)

Uno de estos casos se encuentra en la parte sobre la siguiente línea de código:

```
$canonicalData = $element->C14N(true, false);
```

Debería cambiarse a:

```
$canonicalData = $element->C14N(false, false);
```

Si bien la documentación explica que se debe cambiar esta línea, no menciona que también es necesario realizar el mismo cambio en otra parte del archivo:

```
$c14nSignedInfo = $signedInfoElement->C14N(true, false);
```

Debería cambiarse a:

```
$c14nSignedInfo = $signedInfoElement->C14N();
```

Este cambio debe realizarse específicamente en la línea 179 del archivo original.

### Caso 2: Error al leer el certificado

[](#caso-2-error-al-leer-el-certificado)

La documentación menciona que la librería fue probada en PHP versiones 8.1.12 y 8.1.13, si utilizas el paquete en una version mas reciente, como 8.4 o 8.5, la validación falla debido a que el cifrado RC2-40-CBC utilizado en los archivos .p12 cambió en las versiones más recientes de OpenSSL, que normalmente vienen con PHP 8.2 en adelante.

Para solucionarlo, debemos modificar el archivo `openssl.cnf` para que admita el cifrado que necesitamos, cambiando la configuración por defecto al modo "legacy".

#### Habilitar cifrado "legacy"

[](#habilitar-cifrado-legacy)

1. Edita el archivo `openssl.cnf` con el siguiente comando:

    ```
    sudo nano /etc/ssl/openssl.cnf
    ```
2. Busca la sección \[default\_sect\] y cámbiarla a:

    ```
     [default_sect]
     activate = 1
    ```
3. Luego, busca la sección \[legacy\_sect\] y cámbiarla a:

    ```
     [legacy_sect]
     activate = 1
    ```
4. Por último, busca la sección \[provider\_sect\] y cámbiarla a:

    ```
     [provider_sect]
     default = default_sect
     legacy = legacy_sect
    ```
5. Finalmente, guardar los cambios, salir del archivo y reiniciar el entorno.

Instalación
-----------

[](#instalación)

### Vía Composer (Recomendado)

[](#vía-composer-recomendado)

```
composer require platinum-place/php-dgii-xml-signer
```

### Instalación Manual

[](#instalación-manual)

```
git clone https://github.com/platinum-place/php-dgii-xml-signer.git
cd php-dgii-xml-signer
composer install
```

Uso Básico
----------

[](#uso-básico)

```