README

A simple Laravel Library to connect/publish/subscribe to MQTT broker

Based on bluerhinos/phpMQTT

For Example see this repo

Installation

composer require elemenx/laravel-mqtt

Features

• Name and password authentication
• Client certificate authentication
• Certificate Protection for end to end encryption
• Enable Debug mode to make it easier for debugging
• Now you can also set Client_id of your choice and if you don't want just simply don't use or set it to null
• Set QOS flag directly from config file
• Set Retain flag directly from config file
• Addition of Helper functions to make development more easy

Enable the package (Optional)

This package implements Laravel auto-discovery feature. After you install it the package provider and facade are added automatically for laravel >= 5.5.

This step is only required if you are using laravel version <5.5

To declare the provider and/or alias explicitly, then add the service provider to your config/app.php:

'providers' => [

    Elemenx\Mqtt\MqttServiceProvider::class,

];

And then add the alias to your config/app.php:

'aliases' => [

    'Mqtt' => \Elemenx\Mqtt\Facades\Mqtt::class,

];

Configuration

Publish the configuration file

php artisan vendor:publish --provider="Elemenx\Mqtt\MqttServiceProvider"

Config/mqtt.php

    'host'      => env('mqtt_host','127.0.0.1'),
    'password'  => env('mqtt_password',''),
    'username'  => env('mqtt_username',''),
    'certfile'  => env('mqtt_cert_file',''),
    'localcert' => env('mqtt_local_cert', ''),
    'localpk'   => env('mqtt_local_pk', ''),
    'port'      => env('mqtt_port','1883'),
    'debug'     => env('mqtt_debug',false) //Optional Parameter to enable debugging set it to True
    'qos'       => env('mqtt_qos', 0), // set quality of service here
    'retain'    => env('mqtt_retain', 0) // it should be 0 or 1 Whether the message should be retained.- Retain Flag

Publishing topic

use Elemenx\Mqtt\MqttClass\Mqtt;

public function sendMsgViaMqtt($topic, $message)
{
    $mqtt = new Mqtt();
    $client_id = Auth::user()->id;
    $output = $mqtt->connectAndPublish($topic, $message, $client_id);

    if ($output === true)
    {
        return "published";
    }
    
    return "Failed";
}

Publishing topic using Facade

use Mqtt;

public function sendMsgViaMqtt($topic, $message)
{
    $client_id = Auth::user()->id;
    
    $output = Mqtt::connectAndPublish($topic, $message, $client_id);

    if ($output === true)
    {
        return "published";
    }

    return "Failed";
}

Subscribing topic

use Elemenx\Mqtt\MqttClass\Mqtt;

public function subscribetoTopic($topic)
{
    $mqtt = new Mqtt();
    $client_id = Auth::user()->id;
    $mqtt->connectAndSubscribe($topic, function($topic, $msg){
        echo "Msg Received: \n";
        echo "Topic: {$topic}\n\n";
        echo "\t$msg\n\n";
    }, $client_id);
}

Subscribing topic using Facade

use Mqtt;

public function subscribetoTopic($topic)
{
    //You can also subscribe to multiple topics using the same function $topic can be array of topics e.g ['topic1', 'topic2']

    Mqtt::connectAndSubscribe($topic, function($topic, $msg){
        echo "Msg Received: \n";
        echo "Topic: {$topic}\n\n";
        echo "\t$msg\n\n";
    },$client_id);
}

Publishing topic using Helper method

public function sendMsgViaMqtt($topic, $message)
{
    $client_id = Auth::user()->id;
    
    $output = connectToPublish($topic, $message, $client_id);

    if ($output === true)
    {
        return "published";
    }

    return "Failed";
}

Subscribing topic using Helper method

//You can also subscribe to multiple topics using the same function $topic can be array of topics e.g ['topic1', 'topic2']
public function subscribetoTopic($topic)
{
    return connectToSubscribe($topic, $client_id);
}

Happy Coding...!