p3k/websub

A library for subscribing to and publishing WebSub feeds

Maintainers

Details

github.com/aaronpk/p3k-websub

Homepage

Source

Issues

Installs: 12 189

Dependents: 0

Suggesters: 0

Security: 0

Stars: 7

Watchers: 4

Forks: 4

Open Issues: 2

0.0.1 2017-05-08 15:26 UTC

Requires

Requires (Dev)

MIT 3e37fbb3e8865f159b8adaaab9569e5984bc8890

feedpubsubhubbubindiewebpubsubp3kwebsub

This package is auto-updated.

Last update: 2024-11-07 21:09:59 UTC

README

Usage

Initialize the client

$http = new p3k\HTTP('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_1) p3k-websub/0.1.0 example');
$client = new p3k\WebSub\Client($http);

Discover the hub and self URLs for a topic URL

// Returns false unless both hub and self were found
$endpoints = $client->discover($topic);

// $endpoints['hub'] 
// $endpoints['self']

Send the subscription request

$secret = p3k\random_string(32);
$id = p3k\random_string(32);
$callback = 'http://localhost:8080/subscriber.php?id='.$id;

$subscription = $client->subscribe($endpoints['hub'], $endpoints['self'], $callback, [
  'lease_seconds' => 300,
  'secret' => $secret
]);

Verify the signature

$signature = $_SERVER['HTTP_X_HUB_SIGNATURE'];
$document = file_get_contents('php://input');
$valid = p3k\WebSub\Client::verify_signature($document, $signature, $secret);

License

Copyright 2017 by Aaron Parecki

Available under the MIT license.