Notifications¶

Nativella\Notification shows system notifications, on the desktop and on phones.

$notification->send('Export finished', 'notes.zip is in your Downloads folder.');

send() returns as soon as the system has the notification, without waiting for the user.

Clicks¶

A notification sent with a reference tells PHP when the user clicks it, with a Nativella\Event\NotificationClicked event that carries the reference:

$notification->send('New message', 'From Alice', reference: 'message-42');

use Nativella\Event\NotificationClicked;

#[AsEventListener]
public function onClick(NotificationClicked $event): void
{
    // $event->reference === 'message-42'
    $this->window->open('main');
}

Clicks are reported on Linux only, for now. macOS and Windows show the notification, but do not report the click.

On Linux, notifications go through the desktop's notification service (org.freedesktop.Notifications, on D-Bus), which every mainstream desktop provides.

A notification from a page¶

A notification needs no page change, and a fetch() from the page is enough. new Notification(), the browser API, shows nothing in a page, so a script injected in one cannot show system notifications. Only PHP can send them.

await fetch('/reminders/42/notify', { method: 'POST' });

// POST /reminders/{id}/notify
$notification->send('Reminder', $reminder->title);

http_response_code(204);

A notification from the background¶

PHP only runs when something asks it to: a request from a page, or a native event. A reminder "in ten minutes" is a timer: $timer->after('reminder-42', 600), then the notification from the TimerFired listener.