laravel-liberu/php-gedcom

PHP 8.0+的GEDCOM文件解析器(读取+写入)

v2.0.6 2024-08-25 12:34 UTC

This package is auto-updated.

Last update: 2024-09-26 14:26:28 UTC


README

Latest Stable Version Tests

需求

  • php-gedcom 1.0+ 需要 PHP 8.3(或更高版本)。

安装

安装php-gedcom有两种方式。

Composer

要使用composer在你的项目中安装php-gedcom,只需将以下require行添加到你的项目的composer.json文件中

{
    "require": {
        "liberu-genealogy/php-gedcom": "2.0.*"
    }
}

下载和__autoload

如果你没有使用composer,你可以从GitHub下载源代码的存档,并将其提取到你的项目中。除非你愿意一个接一个地要求所有必需的文件,否则你需要为这些文件设置一个自动加载器。以下内容应该足够

spl_autoload_register(function ($class) {
    $pathToGedcom = __DIR__ . '/library/'; // TODO FIXME

    if (!substr(ltrim($class, '\\'), 0, 7) == 'Gedcom\\') {
        return;
    }

    $class = str_replace('\\', DIRECTORY_SEPARATOR, $class) . '.php';
    if (file_exists($pathToGedcom . $class)) {
        require_once($pathToGedcom . $class);
    }
});

用法

要解析GEDCOM文件并将其加载到PHP对象集合中,只需实例化一个新的Parser对象,并将其要解析的文件名传递给它。生成的Gedcom对象将包含在提供的GEDCOM文件中存储的所有信息

$parser = new \Gedcom\Parser();
$gedcom = $parser->parse('tmp.ged');

foreach ($gedcom->getIndi() as $individual) {
    $names = $individual->getName();
    if (!empty($names)) {
        $name = reset($names); // Get the first name object from the array
        echo $individual->getId() . ': ' . $name->getSurn() . ', ' . $name->getGivn() . PHP_EOL;
    }
}

贡献

欢迎拉取请求和问题。

许可

MIT许可(见License.md)。这意味着你必须保留版权和许可声明,或所有或该软件的实质性部分。

贡献者