Wallogit.com
2017 © Pedro Peláez
, (*1)
Parse, build, serialize and validate UN/EDIFACT Messages in a memory efficient way., (*2)
You will likely have to generate your own Segments, see php-edifact/edifact-mapping for XML Mappings. I have done a protype for autogeneration, it should give you a good starting point., (*3)
If you don't need validation or Segment getter you can also parse to the generic Segment., (*4)
You can add your Segments to the Factory like so:, (*5)
use Apfelfrisch\Edifact\Segment\SegmentFactory;
$segmentFactory = new SegmentFactory;
$segmentFactory->addSegment('SEQ', \My\Namespace\Segments\Seq::class);
After that you can either mark the Factory as default:, (*6)
$segmentFactory->markAsDefault();
or you inject the Factory in the Message:, (*7)
use Apfelfrisch\Edifact\Segment\SegmentFactory;
$message = Message::fromString("UNA:+.? 'SEQ+1", $segmentFactory);
If you don't need validation or Segment getter you can also parse to the generic Segement, (*8)
use Apfelfrisch\Edifact\Segments\Generic; use Apfelfrisch\Edifact\Segment\SegmentFactory; $segmentFactory = new SegmentFactory; $segmentFactory->addFallback(Generic::class); $segmentFactory->markAsDefault();
use Apfelfrisch\Edifact\Message;
$message = Message::fromString("UNA:+.? 'NAD+DP++++Musterstr.::10+City++12345+DE");
use Apfelfrisch\Edifact\Message;
$message = Message::fromFilepath('path/to/file.txt');
use Apfelfrisch\Edifact\Segments\SegmentInterface;
foreach ($message->getSegments() as $segment) {
if ($segment instanceof SegmentInterface) {
echo $segment->name();
}
}
use My\Namespace\Segments\MyNad;
foreach ($message->filterSegments(MyNad::class) as $segment) {
echo $segment->name(); // NAD
}
$message->filterSegments(MyNad::class, fn(Nad $seg): bool
=> $seg->street() === 'Musterstr.'
);
echo $message->findFirstSegment(MyNad::class)->name(); // NAD
foreach ($message->unwrap() as $partialMessage) {
echo $segment instanceof \Apfelfrisch\Edifact\Message;
}
$message->addStreamFilter('iso-to-utf8', 'convert.iconv.ISO-8859-1.UTF-8');
use Apfelfrisch\Edifact\Builder;
use Apfelfrisch\Edifact\Message;
use My\Namespace\Segments\MyUnb;
use My\Namespace\Segments\MyUnh;
$builder = new Builder;
$builder->writeSegments(
MyUnb::fromAttributes('1', '2', 'sender', '500', 'receiver', '400', new DateTime('2021-01-01 12:01:01'), 'unb-ref'),
MyUnh::fromAttributes('unh-ref', 'type', 'v-no', 'r-no', 'o-no', 'o-co')
);
$message = new Message($builder->get());
UNA and the trailing Segments (UNT and UNZ) will be added automatically. If no UNA Segment is provided, it uses the default values [UNA:+.? ']., (*9)
use Apfelfrisch\Edifact\Builder;
use Apfelfrisch\Edifact\Segment\UnaSegment;
$builder = new Builder(new UnaSegment('|', '#', ',', '!', '_', '"'));
If you replace the decimal seperator, be sure that the blueprint marks the value as numeric., (*10)
use Apfelfrisch\Edifact\Builder; use Apfelfrisch\Edifact\Segment\UnaSegment; $builder = new Builder(new UnaSegment, 'path/to/file.txt');
use Apfelfrisch\Edifact\Builder;
$builder = new Builder;
$builder->addStreamFilter('utf8-to-iso', 'convert.iconv.UTF-8.ISO-8859-1');
use Apfelfrisch\Edifact\Message;
use Apfelfrisch\Edifact\Validation\Failure;
use Apfelfrisch\Edifact\Validation\Validator;
$message = Message::fromString("UNA:+.? 'SEQ+9999", $segmentFactory);
$validator = new Validator;
if(! $validator->isValid($message)) {
foreach ($validator->getFailures() as $failure) {
echo $failure instanceof Failure;
}
}
MIT
MIT
MIT