darkfriend/schema-org-parser

Parse schema.org microdata from HTML documents with ease. PHP Implementation of W3C Microdata to JSON Specification.

1.0.0 2022-08-17 11:10 UTC

Requires

• php: >=7.0
• ext-dom: *
• ext-libxml: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.8
• pestphp/pest: ^1.21
• phpstan/phpstan: ^1.5

Suggests

• ext-json: Needed to convert results to JSON

MIT

• Yusuf Kandemir
• Darkfriend

• json
• parser
• schema
• W3C
• microdata
• schema.org
• WHATWG

README

It`s fork from yusufkandemir/microdata-parser for support php7.

This package aims to implement W3C Microdata to JSON Specification.

microdata-parser extracts microdata from documents.

Installation

Via Composer

$ composer require darkfriend/schema-org-parser

Usage

PHP

use Darkfriend\SchemaOrgParser\Microdata;

$microdata = Microdata::fromHTMLFile('source.html')->toJSON();
/* Other sources:
     fromHTML()        // from HTML string
     fromDOMDocument() // from DOMDocument object
   Other output methods:
     toArray()  // to Associtive PHP Array
     toObject() // to PHP Object (stdClass)
*/

Source as HTML

<!-- source.html -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="http://shop.example.com/test_product.jpg" />
  <a itemprop="url" href="http://shop.example.com/test_product">
    <span itemprop="name">Test Product</span>
  </a>
</div>

Result as JSON

{
  "items": [
    {
      "type": [ "http://schema.org/Product" ],
      "properties": {
        "image": [ "http://shop.example.com/test_product.jpg" ],
        "url": [ "http://shop.example.com/test_product" ],
        "name": [ "Test Product" ]
      }
    }
  ]
}

Testing

$ composer test

Contributing

Please see CONTRIBUTING for details.

Credits

• Yusuf Kandemir
• Darkfriend
• All Contributors

License

The MIT License (MIT). Please see License File for more information.