Async PHP client/server API for the telegram MTProto protocol https://docs.madelineproto.xyz
Go to file
Daniil Gentili 92717a2d05
MUUUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA BUUURN SNAKES BUUURN MUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA cough
2019-10-29 22:41:31 +01:00
docs@9f21080a29 MUUUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA BUUURN SNAKES BUUURN MUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA cough 2019-10-29 22:41:31 +01:00
examples MUUUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA BUUURN SNAKES BUUURN MUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA cough 2019-10-29 22:41:31 +01:00
src MUUUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA BUUURN SNAKES BUUURN MUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA cough 2019-10-29 22:41:31 +01:00
tests MUUUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA BUUURN SNAKES BUUURN MUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA cough 2019-10-29 22:41:31 +01:00
tools MUUUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA BUUURN SNAKES BUUURN MUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA cough 2019-10-29 22:41:31 +01:00
.env.example Improve docs 2018-03-30 16:07:54 +00:00
.gitignore cs-fix 2019-09-02 17:08:36 +02: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 Remove abstract static methods in PHP 5.6 2019-06-20 18:34:05 +02:00
CODE_OF_CONDUCT.md Clean up 2019-10-28 22:39:23 +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 MUUUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA BUUURN SNAKES BUUURN MUAAHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA cough 2019-10-29 22:41:31 +01:00
bot.php Clean up 2019-10-28 22:39:23 +01:00
composer.json Use psr-4 2019-10-29 20:53:51 +01:00

README.md

MadelineProto, a PHP MTProto telegram client

Created by Daniil Gentili

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

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