algolia / php-dom-parser
A simple tool to turn DOM into Algolia search friendly record objects.
Installs: 1 018
Dependents: 0
Suggesters: 0
Security: 0
Stars: 17
Watchers: 73
Forks: 7
Open Issues: 1
Requires
- php: >=5.6
Requires (Dev)
- phpunit/phpunit: >=5.0.10
- yoast/phpunit-polyfills: ^1.0
This package is not auto-updated.
Last update: 2024-10-24 20:48:03 UTC
README
A simple tool to turn DOM into Algolia search friendly record objects.
It has been built with Wordpress articles indexing in mind, but the tool is now abstracted enough to be re-used on other type of projects.
For now the parsed DOM will result in the minimum possible number of records, meaning that if a node has at least one child, it will never have a record on its own. If we need such a behaviour, we could easily add it.
Requirements
This lib needs mbstring
PHP extension to be enabled. Also make sure mbregex
is NOT disabled.
Installation
$ composer require algolia/php-dom-parser
Examples
Simple usage
Here is a simple example where we grab the content of an article of Algolia's blog and parse it to obtain the records.
$article = file_get_contents('https://blog.algolia.com/how-we-re-invented-our-office-space-in-paris/'); $parser = new \Algolia\DOMParser(); // Exclude content by CSS selectors. $parser->setExcludeSelectors(array( 'pre', '.entry-meta', 'div.rp4wp-related-posts' )); // Only parse what is inside a given CSS selectors. // If there are multiple nodes matching, they will all be parsed. $parser->setRootSelector('article.post'); // Define your attributes sibling. $parser->setAttributeSelectors( array( 'title1' => 'h1', 'title2' => 'h2', 'title3' => 'h3', 'title4' => 'h4', 'title5' => 'h5', 'title6' => 'h6', 'content' => 'p, ul, ol, dl, table', ) ); // Add some attributes that will be part of every record. $parser->setSharedAttributes(array( 'url' => 'http://www.example.com', 'visits' => 1933, )); // Turn the DOM into Algolia search friendly records. $records = $parser->parse($article); var_dump($records);
You will find some example of scripts / outputs in the examples folder so that you don't have to run anything to give feedback.
Little CLI
dynamic.php
is a little cli for dynamically fetching the dom of some url.
You can optionally pass a root selector as second argument.
This script was mainly built for testing in the early stages, and we have no intention to develop it further for now.
$ php examples/dynamic.php https://blog.algolia.com/inside-the-algolia-engine-part-2-the-indexing-challenge-of-instant-search/ article.post
Dev
Test the code.
vendor/bin/phpunit
Contributing
Please do contribute:
- if you have an idea, a question or just want to say hi: create an issue
- if you have a bug fix: create a PR
Please ensure the tests passes and also please run php-cs-fixer to ensure the code styles remain consistent.