Async PHP client/server API for the telegram MTProto protocol https://docs.madelineproto.xyz

Go to file

Daniil Gentili 660e7112e5 Bugfixes		2019-12-27 12:24:01 +01:00
docs@336c4d4aa0	Document	2019-10-31 11:17:22 +01:00
examples	Multiple improvements for secret chat files, event handler, exception traces, update handling, file download	2019-12-26 15:14:27 +01:00
legacy/danog/MadelineProto/Server	Move legacy code	2019-11-02 13:49:58 +01:00
src	Bugfixes	2019-12-27 12:24:01 +01:00
tests	Trigger build properly	2019-12-26 22:43:09 +01:00
ton	Fix TL serializer bugs	2019-12-25 21:01:53 +01:00
tools	Improve tests and conversion	2019-12-26 19:17:31 +01:00
.env.example	Improve docs	2018-03-30 16:07:54 +00:00
.gitignore	Improve tests and conversion	2019-12-26 19:17:31 +01:00
.gitmodules	Rewrite pipesbot	2019-10-28 23:52:21 +01:00
.php_cs.dist	cs-fix	2019-10-29 22:00:21 +01:00
.travis.yml	Wait for packagist, first	2019-12-26 20:26:27 +01:00
bot.php	Clean up	2019-10-28 22:39:23 +01:00
CODE_OF_CONDUCT.md	Clean up	2019-10-28 22:39:23 +01:00
composer.json	Wait for packagist, first	2019-12-26 20:26:27 +01:00
CONTRIBUTING.md	Bugfixes	2017-02-13 13:27:59 +01:00
LICENSE	Reorganized code	2016-08-08 18:10:13 +02:00
README.md	Add TON docs	2019-12-22 12:57:49 +01:00

README.md

MadelineProto, a PHP MTProto telegram client

Created by Daniil Gentili

Do join the official channel, @MadelineProto and the support groups!

Now with Telegram TON blockchain integration!

Approved by Telegram!

What's this?

This library can be used to easily interact with Telegram without the bot API, just like the official apps.

It can login with a phone number (MTProto API), or with a bot token (MTProto API, no bot API involved!).

It is now fully async!

Getting started (now fully async!)

<?php

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->async(true);
$MadelineProto->loop(function () use ($MadelineProto) {
    yield $MadelineProto->start();

    $me = yield $MadelineProto->getSelf();

    $MadelineProto->logger($me);

    if (!$me['bot']) {
        yield $MadelineProto->messages->sendMessage(['peer' => '@danogentili', 'message' => "Hi!\nThanks for creating MadelineProto! <3"]);
        yield $MadelineProto->channels->joinChannel(['channel' => '@MadelineProto']);

        try {
            yield $MadelineProto->messages->importChatInvite(['hash' => 'https://t.me/joinchat/Bgrajz6K-aJKu0IpGsLpBg']);
        } catch (\danog\MadelineProto\RPCErrorException $e) {
            $MadelineProto->logger($e);
        }

        yield $MadelineProto->messages->sendMessage(['peer' => 'https://t.me/joinchat/Bgrajz6K-aJKu0IpGsLpBg', 'message' => 'Testing MadelineProto!']);
    }
    yield $MadelineProto->echo('OK, done!');
});

Try this code now! or run this code in a browser or in a console.

Tip: if you receive an error (or nothing), send us the error message and the MadelineProto.log file that was created in the same directory (if running from a browser).

Documentation

Very complex and complete examples

You can find examples for nearly every MadelineProto function in

magnaluna webradio - Multifeatured Telegram VoIP webradio
tests/testing.php - examples for making/receiving calls, making secret chats, sending secret chat messages, videos, audios, voice recordings, gifs, stickers, photos, sending normal messages, videos, audios, voice recordings, gifs, stickers, photos.
bot.php - examples for sending normal messages, downloading any media
secret_bot.php - secret chat bot
pipesbot.php - examples for creating inline bots and using other inline bots via a userbot