README

从网页获取微数据！

安装

您可以使用 Composer 或克隆此仓库来安装此库。

使用 Composer，只需将以下行添加到您的 composer.json 文件中，然后运行 composer update

{
    "require": {
        "malenki/microdata": "dev-master"
    }
}

通过克隆此仓库，只需执行 git clone https://github.com/malenkiki/microdata.git。

使用库进行编码

使用此库，您将获得微数据的 树形对象。

您可以从给定的 URL 或给定的 字符串内容 获取微数据

use \Malenki\Microdata;
$md = new Microdata('http://www.some-url.com/path/page.html');
//or
$md = new Microdata($some_content, Microdata::AS_STRING);
var_dump($md->extract());

在字符串上下文中，打印 JSON 微数据树

use \Malenki\Microdata;
$md = new Microdata('http://www.some-url.com/path/page.html');
print($md);

您可以获取找到的类型数量的统计数据

use \Malenki\Microdata;
$md = new Microdata('http://www.some-url.com/path/page.html');
var_dump($md->getAllTypeCount());

现在，您可以使用 www.schema.org 上定义的模式检查微数据，这些模式从网站或您存储在文件系统上的 JSON 文件中获取。

use \Malenki\Microdata;
$md = new Microdata('http://www.some-url.com/path/page.html');
$md->availableChecking(); // no arg: it takes JSON from official website
//or
$md->availableChecking('all.json'); // arg: it takes JSON from file system
print($md); // If errors found, they will be present into the returned JSON

使用 CLI 应用程序

此库还包含一个小型的 CLI 应用程序。

其使用很简单。如果您不知道如何使用它，只需执行 bin/microdata --help 或阅读以下说明。

要从 URL 获取微数据，请执行

$ bin/microdata 'http://some.url/path/'

与之前相同，但获取 JSON

$ bin/microdata --json 'http://some.url/path/'

您还可以请求检查（仅限 schema.org 上定义的模式）

$ bin/microdata --check 'http://some.url/path/'

与之前相同，但使用本地文件系统上的 JSON 模式

$ bin/microdata --check --check-file foo.json 'http://some.url/path/'

您甚至可以使用管道或标准输入

$ echo '<p itemscope itemtype="http://schema.org/Product"><span itemprop="name">Truc</span></p>' | bin/microdata --pipe

要求

您必须安装 PHP 5.3+ 并加载 DOM 扩展。

感谢

此库基于 Philip Jägenstedt 和 Lin Clark 的工作。