PHPackages                             shineit/mqtt-laravel-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. shineit/mqtt-laravel-client

ActiveLibrary[Utility & Helpers](/categories/utility)

shineit/mqtt-laravel-client
===========================

An MQTT client library for Laravel.

01PHP

Since Jun 4Pushed 5y agoCompare

[ Source](https://github.com/shineit/mqtt-laravel-client)[ Packagist](https://packagist.org/packages/shineit/mqtt-laravel-client)[ RSS](/packages/shineit-mqtt-laravel-client/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependenciesVersions (1)Used By (0)

php-mqtt/laravel-client
=======================

[](#php-mqttlaravel-client)

**⚠️ Work in progress - use at own risk! ⚠️**

`php-mqtt/laravel-client` was created by, and is maintained by [Namoshek](https://github.com/namoshek). It is a Laravel wrapper for the [`php-mqtt/client`](https://github.com/php-mqtt/client) package and allows you to connect to an MQTT broker where you can publish messages and subscribe to topics.

Installation
------------

[](#installation)

```
composer require php-mqtt/laravel-client
```

The package will register itself through Laravel auto discovery of packages. Registered will be the service provider as well as an `MQTT` facade.

After installing the package, you should publish the configuration file using

```
php artisan vendor:publish --provider="PhpMqtt\Client\MqttClientServiceProvider"
```

and change the configuration in `config/mqtt-client.php` according to your needs.

Configuration
-------------

[](#configuration)

The package allows you to configure multiple named connections. An initial example can be found in the published configuration file. Except for the `host` parameter, all configuration options are entirely optional and come with the defaults provided to the `env()` helper in the example configuration file (no default means `null`).

An example configuration of two connections, where one is meant for sharing public data and one for private data, could look like the following:

```
'default_connection' => 'private',

'connections' => [
    'private' => [
        'host' => 'mqtt.example.com',
        'port' => 1883,
    ],
    'public' => [
        'host' => 'test.mosquitto.org',
        'port' => 1883,
    ],
],
```

In this example, the private connection is the default one.

Usage
-----

[](#usage)

### Publish (QoS level 0)

[](#publish-qos-level-0)

Publishing a message with QoS level 0 is quite easy and can be done in a single command:

```
use PhpMqtt\Client\Facades\MQTT;

MQTT::publish('some/topic', 'Hello World!');
```

If needed, the connection name can be passed as third parameter:

```
use PhpMqtt\Client\Facades\MQTT;

MQTT::publish('some/topic', 'Hello World!', 'public');
```

Using `MQTT::publish($topic, $message)` will implicitly call `MQTT::connection()`, but the connection will not be closed after usage. If you want to close the connection manually because your script does not need the connection any more, you can call `MQTT:close()` (optionally with the connection name as a parameter). Please also note that using `MQTT::publish($topic, $message)` will always use QoS level 0. If you need a different QoS level, then please follow the instructions below.

### Publish (QoS level 1 & 2)

[](#publish-qos-level-1--2)

Different to QoS level 0, we need to run an event loop in order for QoS 1 and 2 to work. This is because with a one-off command we cannot guarantee that a message reaches it's target. The event loop will ensure a published message gets sent again if no acknowledgment is returned by the broker within a grace period (in case of QoS level 1). Also handled by the event loop will be the release of packages in case of QoS level 2.

```
use PhpMqtt\Client\Facades\MQTT;

$mqtt = MQTT::connection();
$mqtt->publish('some/topic', 'foo', 1);
$mqtt->publish('some/other/topic', 'bar', 2);
$mqtt->loop(true);
```

In order to escape the loop, you can call `$mqtt->interrupt()` which will exit the loop during the next iteration. The method can for example be called in a registered signal handler:

```
pcntl_signal(SIGINT, function (int $signal, $info) use ($mqtt) {
    $mqtt->interrupt();
});
```

### Subscribe

[](#subscribe)

Very similar to publishing with QoS level 1 and 2, subscribing requires to run an event loop. But before running the loop, topics need to be subscribed to:

```
use PhpMqtt\Client\Facades\MQTT;

$mqtt = MQTT::connection();
$mqtt->subscribe('some/topic', function (string $topic, string $message) {
    echo sprintf('Received QoS level 1 message on topic [%s]: %s', $topic, $message);
}, 1);
$mqtt->loop(true);
```

Features
--------

[](#features)

This library allows you to use all the features provided by [`php-mqtt/client`](https://github.com/php-mqtt/client).

License
-------

[](#license)

`php-mqtt/laravel-client` is open-sourced software licensed under the [MIT license](LICENSE.md).

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity1

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 85.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/9107717?v=4)[appdev](/maintainers/appdev)[@appdev](https://github.com/appdev)

---

Top Contributors

[![Namoshek](https://avatars.githubusercontent.com/u/8877609?v=4)](https://github.com/Namoshek "Namoshek (6 commits)")[![shineit](https://avatars.githubusercontent.com/u/230854?v=4)](https://github.com/shineit "shineit (1 commits)")

### Embed Badge

![Health badge](/badges/shineit-mqtt-laravel-client/health.svg)

```
[![Health](https://phpackages.com/badges/shineit-mqtt-laravel-client/health.svg)](https://phpackages.com/packages/shineit-mqtt-laravel-client)
```

###  Alternatives

[bvipul/generator

To create a whole module with all related files like model, controller, repository, routes, views etc with a simple GUI.

2030.5k](/packages/bvipul-generator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)