PHP MQTT with RabbitMQ and LavinMQ

We recommend php-mqtt/client, a maintained MQTT client for PHP.

composer require php-mqtt/client

Publish and subscribe

Set MQTT_HOST, MQTT_PORT, MQTT_USERNAME and MQTT_PASSWORD to the MQTT details on your instance’s details page in the CloudAMQP console. Port 8883 uses TLS. Without them, the examples connect to a local broker.

Save the publisher as publisher.php:

<?php

require __DIR__ . '/vendor/autoload.php';

use PhpMqtt\Client\ConnectionSettings;
use PhpMqtt\Client\MqttClient;

$port = (int) (getenv('MQTT_PORT') ?: 1883);
$client = new MqttClient(getenv('MQTT_HOST') ?: 'localhost', $port, null, MqttClient::MQTT_3_1_1);
$client->connect((new ConnectionSettings())
    ->setUsername(getenv('MQTT_USERNAME') ?: 'guest')
    ->setPassword(getenv('MQTT_PASSWORD') ?: 'guest')
    ->setUseTls($port === 8883));

// QoS 1, and the loop runs until the broker has sent its PUBACK
$client->publish('hello', 'Hello world!', MqttClient::QOS_AT_LEAST_ONCE);
$client->loop(true, true);
echo " [x] Sent 'Hello world!'\n";
$client->disconnect();

Save the subscriber as worker.php:

<?php

require __DIR__ . '/vendor/autoload.php';

use PhpMqtt\Client\ConnectionSettings;
use PhpMqtt\Client\MqttClient;

$port = (int) (getenv('MQTT_PORT') ?: 1883);
$client = new MqttClient(getenv('MQTT_HOST') ?: 'localhost', $port, null, MqttClient::MQTT_3_1_1);
$client->connect((new ConnectionSettings())
    ->setUsername(getenv('MQTT_USERNAME') ?: 'guest')
    ->setPassword(getenv('MQTT_PASSWORD') ?: 'guest')
    ->setUseTls($port === 8883));

// php-mqtt/client acks each QoS 1 message before calling the handler
$client->subscribe('hello', function (string $topic, string $message) {
    echo " [x] Received '$message'\n";
}, MqttClient::QOS_AT_LEAST_ONCE);
echo " [*] Waiting for messages. To exit press CTRL+C\n";
$client->loop();

Run php worker.php in one terminal and php publisher.php in another.

A runnable example is in php/php-mqtt-client in cloudamqp/examples.

Good to know

  • Put the vhost in the username, as vhost:user. MQTT has no vhost of its own, and the console shows the username that way.
  • setUseTls(true) verifies the server certificate and hostname.
  • Run the loop. loop() sends and receives messages: the publisher runs it until the broker has sent its PUBACK, and the worker runs it for good.
  • Messages are acked before the handler runs, so a message is lost if the handler fails. php-mqtt/client acks each QoS 1 message as it arrives.
  • Reconnecting is off by default. Turn it on with setReconnectAutomatically(true) on the ConnectionSettings.
Was this page helpful?

Thanks for your feedback!