stanx/fabiang-xmpp

Library for XMPP protocol (Jabber) connections

0.8.1 2021-10-26 19:52 UTC

Requires

• php: ^7.0 || ^8.0
• psr/log: ^1.0 || ^2.0 || ^3.0

Requires (Dev)

• behat/behat: ^2.5.5
• monolog/monolog: ^1.22
• phpunit/phpunit: ^5.7.20
• satooshi/php-coveralls: ^1.0
• symfony/console: ^2.8
• symfony/dependency-injection: ^2.8
• symfony/finder: ^2.8

Suggests

• psr/log-implementation: Allows more advanced logging of the xmpp connection

BSD-2-Clause

• Fabian Grutschus

• xmpp
• jabber

README

Library for XMPP protocol connections (Jabber) for PHP.

Forked from https://github.com/tohenk/xmpp (forked from https://github.com/fabiang/xmpp)

SYSTEM REQUIREMENTS

• PHP >= 7.0
• psr/log
• (optional) psr/log-implementation - like monolog/monolog for logging

INSTALLATION

New to Composer? Read the introduction. Add the following to your composer file:

composer require stanx/fabiang-xmpp

DOCUMENTATION

This library uses an object to hold options:

use Fabiang\Xmpp\Options;
$options = new Options($address);
$options->setUsername($username)
        ->setPassword($password)
        ->setTimeout(10);

The server address must be in the format tcp://myjabber.com:5222.
If the server supports TLS the connection will automatically be encrypted.

You can also pass a PSR-2-compatible object to the options object:

$options->setLogger($logger)

The client manages the connection to the Jabber server and requires the options object:

use Fabiang\Xmpp\Client;
$client = new Client($options);
// optional connect manually
$client->connect();

For sending data you just need to pass a object that implements Fabiang\Xmpp\Protocol\ProtocolImplementationInterface:

use Fabiang\Xmpp\Protocol\Roster;
use Fabiang\Xmpp\Protocol\Presence;
use Fabiang\Xmpp\Protocol\Message;

// fetch roster list; users and their groups
$client->send(new Roster);
// set status to online
$client->send(new Presence);

// send a message to another user
$message = new Message;
$message->setMessage('test')
        ->setTo('[e-mail]');
$client->send($message);

// join a channel
$channel = new Presence;
$channel->setTo('[e-mail]')
        ->setPassword('channelpassword')
        ->setNickName('mynick');
$client->send($channel);

// send a message to the above channel
$message = new Message;
$message->setMessage('test')
        ->setTo('[e-mail]')
        ->setType(Message::TYPE_GROUPCHAT);
$client->send($message);

After all you should disconnect:

$client->disconnect();

BSD-2-Clause. See the LICENSE.