https://github.com/oliverlorenz/phpmqttclient

a mqtt client library for php
https://github.com/oliverlorenz/phpmqttclient

mqtt mqtt-client php

Last synced: about 5 hours ago
JSON representation

a mqtt client library for php

• Host: GitHub
• URL: https://github.com/oliverlorenz/phpmqttclient
• Owner: oliverlorenz
• License: lgpl-3.0
• Created: 2015-05-06T20:24:10.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2019-10-01T05:20:21.000Z (over 5 years ago)
• Last Synced: 2025-01-22T03:16:14.783Z (about 5 hours ago)
• Topics: mqtt, mqtt-client, php
• Language: PHP
• Size: 147 KB
• Stars: 37
• Watchers: 10
• Forks: 17
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# PHP MQTT Client

phpMqttClient is an MQTT client library for PHP. Its based on the reactPHP socket-client and added the MQTT protocol

specific functions. I hope its a better starting point that the existing PHP MQTT libraries. 

[![Build Status](https://travis-ci.org/oliverlorenz/phpMqttClient.svg?branch=master)](https://travis-ci.org/oliverlorenz/phpMqttClient) 

[![Code Climate](https://codeclimate.com/github/oliverlorenz/phpMqttClient/badges/gpa.svg)](https://codeclimate.com/github/oliverlorenz/phpMqttClient) 

[![Test Coverage](https://codeclimate.com/github/oliverlorenz/phpMqttClient/badges/coverage.svg)](https://codeclimate.com/github/oliverlorenz/phpMqttClient/coverage)

## Goal

Goal of this project is easy to use MQTT client for PHP in a modern architecture without using any php modules.

Currently, only protocol version 4 (mqtt 3.1.1) is implemented.

* Protocol specifications: http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/csprd02/mqtt-v3.1.1-csprd02.html

## Example publish

```php

$config = require 'config.php';

$connector = ClientFactory::createClient(new Version4());

$p = $connector->create($config['server'], $config['port'], $config['options']);

$p->then(function(Stream $stream) use ($connector) {

    return $connector->publish($stream, 'a/b', 'example message');

});

$connector->getLoop()->run();

```

## Example subscribe

```php

$config = require 'config.php';

$connector = ClientFactory::createClient(new Version4());

$p = $connector->create($config['server'], $config['port'], $config['options']);

$p->then(function(\React\Stream\Stream $stream) use ($connector) {

    $stream->on(Publish::EVENT, function(Publish $message) {

        print_r($message);

    });

    

    $connector->subscribe($stream, 'a/b', 0);

    $connector->subscribe($stream, 'a/c', 0);

});

$connector->getLoop()->run();

```

## Notice - (May 12th, 2015)

This is library is not stable currently. Its an early state, but I am working on it. I will add more features if I need them. If you need features: please give feedback or contribute to get this library running.

Currently works:

* connect (clean session, no other connect flags)

* disconnect

* publish

* subscribe

## Run tests

    ./vendor/bin/phpunit -c ./tests/phpunit.xml ./tests

## Troubleshooting

### Why does the connect to localhost:1883 not work?

The answer is simple: In the example is the DNS 8.8.8.8 configured. Your local server is not visible for them, so you can't connect.