README

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

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);
}

elemenx / laravel-mqtt

Maintainers

Details