Korin¶
Korin reads, validates, converts and writes GEDCOM 5.5, 5.5.1, 5.5.5 and 7.0 in PHP, without losing a single tag. GEDCOM 4.0 and the 5.x drafts are read too. Every loss a conversion cannot avoid is reported.
use Korin\Gedcom\Gedcom;
$doc = Gedcom::read('family.ged'); // version and encoding detected automatically
echo $doc->version()->value; // "5.5.1"
echo $doc->encoding()->value; // "Windows-1251"
$name = $doc->find('@I1@/NAME');
echo $name?->value(); // "Анна /Коваль/"
$name?->setValue('Анна /Ковальова/');
Gedcom::write($doc, 'family.ged'); // only the changed line is rewritten
composer require korin/gedcom
PHP 8.2–8.6, 64-bit, no runtime dependencies. ext-intl and ext-mbstring are used when
present, ext-zip for GEDZIP archives.
Guides¶
- Reading files: versions, encodings, options, diagnostics of reading.
- Editing and writing: the tree, preserve and normalize modes, encodings.
- Validation: the checks, options and reports.
- Converting between versions: the loss report and policies.
- The model: individuals, families, dates, ages, names and places.
- Large files: streaming, indexed reading, file conversion.
- GEDZIP archives.
- Command line:
korin info,validate,convert,diff.
Reference¶
- Conversion rules for each pair of versions.
- Losses: the
KL*codes and policies. - Diagnostics: the
KV*codes. - Vendor dialects: mistakes of programs Korin corrects.
- API reference, generated from the source.
Project¶
- Specification: the design and the roadmap.
- Fuzzing.
- Comparison with liberu-genealogy/php-gedcom.
- Changelog, source, test corpus.
GEDCOM is a trademark of Intellectual Reserve, Inc. Korin is not affiliated with or endorsed by FamilySearch.