mrkrstphr/php-gedcom

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

1.0.1 2020-03-10 19:17 UTC

README

该项目已不再积极维护。我可能在将来重新捡起来,但现在我没有这个需求。

Build Status

要求

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

安装

安装 php-gedcom 有两种方式。

Composer

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

{
    "require": {
        "mrkrstphr/php-gedcom": "1.0.*"
    }
}

下载并 __autoload

如果您不使用 composer,您可以从 GitHub 下载源代码的存档并将其提取到您的项目中。您需要为这些文件设置一个自动加载器,除非您愿意逐个要求所有需要的文件。以下内容可能就足够了

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

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

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

用法

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

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

foreach ($gedcom->getIndi() as $individual) {
    echo $individual->getId() . ': ' . current($individual->getName())->getSurn() .
        ', ' . current($indi->$individual())->getGivn();
}