fusonic / opengraph
PHP library for consuming and publishing Open Graph resources.
Installs: 259 231
Dependents: 3
Suggesters: 0
Security: 0
Stars: 98
Watchers: 8
Forks: 39
Open Issues: 2
Requires
- php: ^7.4|^8.0
- ext-dom: *
- psr/http-client: ^1.0
- psr/http-factory: ^1.0
- symfony/css-selector: ^3.0|^4.0|^5.0|^6.0
- symfony/dom-crawler: ^3.0|^4.0|^5.0|^6.0
Requires (Dev)
- nyholm/psr7: ^1.2
- phpunit/phpunit: ^9.0
- symfony/http-client: ^6.0
Suggests
- nyholm/psr7: ^1.2
- symfony/http-client: ^5.0
This package is auto-updated.
Last update: 2024-10-26 11:10:11 UTC
README
A simple library to read Open Graph data from the web and generate HTML code to publish your own Open Graph objects. A fallback mode enables you to read data from websites that do not implement the Open Graph protocol.
Using this library you can easily retrieve stuff like meta data, video information from YouTube or Vimeo or image information from Flickr without using site-specific APIs since they all implement the Open Graph protocol.
See ogp.me for information on the Open Graph protocol.
Requirements
- PHP 7.4+
- fusonic/linq
- symfony/css-selector
- symfony/dom-crawler
- psr/http-client, psr/http-factory and compatible implementation such as guzzle/guzzle
Installation
The most flexible installation method is using Composer:
composer require fusonic/opengraph
Install composer and run install command:
curl -s http://getcomposer.org/installer | php
php composer.phar install
Once installed, include vendor/autoload.php in your script.
require "vendor/autoload.php";
Usage
Retrieve Open Graph data from a URL
use Fusonic\OpenGraph\Consumer; $consumer = new Consumer($httpClient, $httpRequestFactory); $object = $consumer->loadUrl("http://www.youtube.com/watch?v=P422jZg50X4"); // Basic information of the object echo "Title: " . $object->title; // Getting started with Facebook Open Graph echo "Site name: " . $object->siteName; // YouTube echo "Description: " . $object->description; // Originally recorded at the Facebook World ... echo "Canonical URL: " . $object->url; // http://www.youtube.com/watch?v=P422jZg50X4 // Images $image = $object->images[0]; echo "Image[0] URL: " . $image->url; // https://i1.ytimg.com/vi/P422jZg50X4/maxresdefault.jpg echo "Image[0] height: " . $image->height; // null (May return height in pixels on other pages) echo "Image[0] width: " . $image->width; // null (May return width in pixels on other pages) // Videos $video = $object->videos[0]; echo "Video URL: " . $video->url; // http://www.youtube.com/v/P422jZg50X4?version=3&autohide=1 echo "Video height: " . $video->height; // 1080 echo "Video width: " . $video->width; // 1920 echo "Video type: " . $video->type; // application/x-shockwave-flash
There are some more properties but these are the basic and most commonly used ones.
Publish own Open Graph data
use Fusonic\OpenGraph\Elements\Image; use Fusonic\OpenGraph\Elements\Video; use Fusonic\OpenGraph\Publisher; use Fusonic\OpenGraph\Objects\Website; $publisher = new Publisher(); $object = new Website(); // Basic information of the object $object->title = "Getting started with Facebook Open Graph"; $object->siteName = "YouTube"; $object->description = "Originally recorded at the Facebook World ..." $object->url = "http://www.youtube.com/watch?v=P422jZg50X4"; // Images $image = new Image("https://i1.ytimg.com/vi/P422jZg50X4/maxresdefault.jpg"); $object->images[] = $image; // Videos $video = new Video("http://www.youtube.com/v/P422jZg50X4?version=3&autohide=1"); $video->height = 1080; $video->width = 1920; $video->type = "application/x-shockwave-flash"; $object->videos[] = $video; // Generate HTML code echo $publisher->generateHtml($object); // <meta property="og:description" // content="Originally recorded at the Facebook World ..."> // <meta property="og:image:url" // content="https://i1.ytimg.com/vi/P422jZg50X4/maxresdefault.jpg"> // <meta property="og:site_name" // content="YouTube"> // <meta property="og:type" // content="website"> // <meta property="og:url" // content="http://www.youtube.com/watch?v=P422jZg50X4"> // <meta property="og:video:url" // content="http://www.youtube.com/v/P422jZg50X4?version=3&autohide=1"> // <meta property="og:video:height" // content="1080"> // <meta property="og:video:type" // content="application/x-shockwave-flash"> // <meta property="og:video:width" // content="1920">
HTML code is formatted just for displaying purposes. You may choose between HTML5/XHTML output using the $publisher->doctype
property.
Running tests
You can run the test suite by running phpunit
from the command line.
FAQ
I don't get any information from a webpage, but Facebook shows information for the same URL. What do I do wrong?
It seems that some pages (like Twitter) only publish OpenGraph information if Facebook's user agent string facebookexternalhit/1.1
is used (see #28). So you should configure your PSR-18 client to use this user agent string:
$client = new Psr18Client(new NativeHttpClient([ "headers" => [ "User-Agent" => "facebookexternalhit/1.1" ] ]));
License
This library is licensed under the MIT license.