chemaclass/edifact-parser

An EDIFACT file parser to extract the values from any defined segment

5.1.0 2025-04-30 10:44 UTC

Requires

• php: >=8.0
• ext-json: *
• sabas/edifact: ^1.2

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.57
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^9.6
• symfony/var-dumper: ^5.4
• vimeo/psalm: ^4.30

MIT

• Jose M Valera Reales

• php
• parser
• edi
• edifact
• edifile
• un-edifact

README

EDIFACT stands for Electronic Data Interchange For Administration, Commerce, and Transport.

This package provides a robust and extensible PHP parser to read, interpret, and extract data from EDIFACT-formatted files.

🔍 Not sure what EDIFACT is? Learn more here

📚 EDIFACT Format Overview

• A file is composed of multiple segments—each begins with a tag (e.g., UNH, NAD).
• Each segment contains structured data relevant to that tag.
• A message typically starts with a UNH segment and ends with a UNT segment.
• A transaction is a list of such messages within a file.

👉 Read more about segments here

💾 Installation

Install via Composer:

composer require chemaclass/edifact-parser

🧪 Examples

🔎 Usage example

<?php declare(strict_types=1);

use EdifactParser\EdifactParser;

require dirname(__DIR__) . '/vendor/autoload.php';

$fileContent = <<<EDI
...
NAD+CN+++Person Name+Street Nr 2+City2++12345+DE'
...
EDI;

$parserResult = EdifactParser::createWithDefaultSegments()->parse($fileContent);
$firstMessage = $parserResult->transactionMessages()[0];

$nadSegment = $firstMessage->segmentByTagAndSubId('NAD', 'CN');
$personName = $nadSegment->rawValues()[4]; // 'Person Name'

📂 More Examples

• example/printing-segments.php — Print all parsed segments line by line.
• example/extracting-data.php — Extract values from specific segments.

🤝 Contributing

We welcome contributions of all kinds—bug fixes, ideas, and improvements.

• 🐛 Report issues
• 🔧 Submit a pull request

📋 See the contributing guide to get started.