This project is still in early stages of development. I am still writing most of the API endpoints and the API is under constant change so I do not recommend to use it on production yet.
QStash is an HTTP based messaging and scheduling solution for serverless and edge runtimes.
QStash is the message broker between your serverless apps. You send an HTTP request to QStash, that includes a destination, a payload and optional settings. We durably store your message and will deliver it to the destination API via HTTP. In case the destination is not ready to receive the message, we will retry the message later, to guarantee at-least-once delivery.
You can install the package via composer:
composer require heyjorgedev/qstash-phpGo to Upstash Console and copy the QSTASH_TOKEN.
use HeyJorgeDev\QStash\QStash;
use HeyJorgeDev\QStash\ValueObjects\Message;
use HeyJorgeDev\QStash\ValueObjects\Url;
$client = QStash::client('QSTASH_TOKEN');
$message = $client->publish(
Message::to(new Url('https://my-api...'))
->withBody([
'hello' => 'world',
])
]);
// to know if the request was successful:
echo $message->isSuccessful()
// to get the message
echo $message->getData();
// to get the message id
echo $message->getData()->id;When receiving a message from QStash, you should verify the signature. We have a class to help you with that:
use HeyJorgeDev\QStash\QStash;
$receiver = QStash::receiver([
'QSTASH_CURRENT_SIGNING_KEY',
'QSTASH_NEXT_SIGNING_KEY',
]);
$result = $receiver->verify(
body: $request->getBody(),
signature: $request->getHeader('Upstash-Signature'),
url: $request->getUri(),
);
echo $result; // true or falsecomposer testPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.