pandopia / calcul-dpe-php

v0.1.46 2026-10-18 06:35 UTC

Requires

• php: ^8.2
• ext-dom: *
• ext-gd: *
• ext-libxml: *
• ext-mbstring: *
• chillerlan/php-qrcode: ^5.0
• setasign/fpdi: ^2.6
• tecnickcom/tcpdf: ^6.10

Requires (Dev)

• phpunit/phpunit: ^10.5

MIT

Published on Packagist.org on 2026-10-18 06:35 UTC

README

Librairie et CLI PHP pour calculer un DPE 3CL-2021 a partir d'un XML ADEME.

Installation

composer install
composer dump-autoload

Utilisation en librairie

composer require pandopia/calcul-dpe-php

<?php

use CalculDpePHP\CalculDpePHP;

$xml = file_get_contents('dpe.xml');

$calculatedXml = CalculDpePHP::calculate($xml);

$energy = CalculDpePHP::calculate($xml, ['energieOnly' => true]);
// $energy->epConso5UsagesM2
// $energy->classeBilanDpe
// $energy->emissionGes5UsagesM2
// $energy->classeEmissionGes

Utilisation en CLI

php bin/calcul-dpe /chemin/vers/input.xml [/chemin/vers/output.xml]

Rapport PDF du DPE

Genere le rapport PDF d'un DPE a partir de son XML ADEME valide (avec ses resultats <sortie>), sur le fond du modele officiel du ministere en vigueur a sa date d'etablissement : editions du 1er janvier 2023, du 1er juillet 2024 et du 1er septembre 2025 (seule cette derniere porte le QR code), pour maison, appartement, appartement a partir de l'immeuble et immeuble. Les DPE etablis avant 2023 levent UnsupportedTemplateException.

<?php

use CalculDpePHP\CalculDpePHP;
use CalculDpePHP\Dto\DiagnostiqueurRapport;
use CalculDpePHP\Dto\DonneesRapportPdf;

$pdf = CalculDpePHP::genererPdf(file_get_contents('dpe.xml'), new DonneesRapportPdf(
    photo: DonneesRapportPdf::image('photo.jpg'),        // JPEG ou PNG
    logo: DonneesRapportPdf::image('logo.png'),
    signature: DonneesRapportPdf::image('signature.png'),
    numeroDpe: '2674E1068548B',                          // si absent du XML
    nomProprietaire: 'Nom du proprietaire',              // remplace le XML s'il est renseigne
    adresseProprietaire: '1 rue X 75000 Paris',
    diagnostiqueur: new DiagnostiqueurRapport(
        entreprise: 'Entreprise', adresse: '37 rue Y 75008 PARIS', nom: 'Prenom Nom',
        telephone: '01 00 00 00 00', email: '[e-mail]',
        numeroCertification: 'C0000', organismeCertification: 'Organisme',
        adresseOrganismeCertification: 'Adresse de l\'organisme',
    ),
    explicationsPersonnalisees: 'Ecarts consommations estimees / reelles (annexe)',
    commentaires: 'Commentaires sous les travaux (p.5)',
));
file_put_contents('dpe.pdf', $pdf);

Tous les champs de DonneesRapportPdf sont facultatifs. Les donnees du XML sont utilisees quand un champ n'est pas renseigne ; les XML de l'observatoire ADEME n'ont pas les donnees personnelles (proprietaire, diagnostiqueur).

Sans numero ADEME (ni dans le XML, ni dans le DTO : calcul prealable, simulation), la page 1 porte en diagonale « DOCUMENT NON OFFICIEL – DPE non enregistre aupres de l'ADEME – sans valeur reglementaire », le numero est « non attribue » et le QR code est remplace par une mention.

En CLI :

php bin/dpe-pdf dpe.xml dpe.pdf --photo=photo.jpg --logo=logo.png --signature=sig.png --numero-dpe=2674E1068548B

php bin/dpe-pdf sans argument liste toutes les options (proprietaire, diagnostiqueur, organisme, explications, commentaires, lien du guide). Preparation des modeles officiels et choix techniques : resources/pdf/README.md.

Outil de preparation des fixtures XML

php bin/process-xml /chemin/vers/fichier.xml

Le script :

• sauvegarde l'original dans resources/XML/verif
• sauvegarde une copie nettoyee dans resources/XML/input en supprimant <donnee_intermediaire> et <sortie>

Rapport de conformité

Compare la sortie du moteur aux jeux de tests, balise par balise, et ecrit reports/official-tests.json et reports/official-tests.md :

php bin/official-test-report

Options utiles :

php bin/official-test-report --list-corpora
php bin/official-test-report --tolerance=reglementaire
php bin/official-test-report --filter=2657E --famille="Génération chauffage" --top=30

Profils de tolerance : strict (0,1 %, defaut), reglementaire (1 %), repo (reprend tests/tolerances.php).

Jeux de tests

Les autotests et cas tests de la procedure officielle d'evaluation CSTB ne sont pas diffuses publiquement. La conformite est mesuree contre les DPE opposables de l'observatoire ADEME. Provenance, licence et limites : resources/XML/official/README.md.

Construire un jeu stratifie (4 perimetres CSTB x 2 regimes du coefficient EP electricite) :

php bin/fetch-official-corpus --build=ademe-2026-09 --per-stratum=15