danog/madelineproto

Async PHP client API for the telegram MTProto protocol.

Maintainers

Details

github.com/danog/MadelineProto

Homepage

Source

Issues

Fund package maintenance!
danog

Installs: 691 154

Dependents: 22

Suggesters: 0

Security: 0

Stars: 2 919

Watchers: 167

Forks: 677

Open Issues: 19

8.4.1 2024-12-18 16:01 UTC

Requires

Requires (Dev)

Suggests

  • ext-bcmath: Install the bcmath extension to speed up authorization
  • ext-ffi: Install the primemodule and FFI extensions to speed up MadelineProto (https://prime.madelineproto.xyz)
  • ext-gmp: Install the gmp extension to speed up authorization
  • ext-openssl: Install the openssl extension for faster crypto
  • ext-pdo: Install the pdo extension to store session data on MySQL
  • ext-primemodule: Install the primemodule and FFI extensions to speed up MadelineProto (https://prime.madelineproto.xyz)
  • ext-uv: Install the uv extension to greatly speed up MadelineProto!

Conflicts

AGPL-3.0-only 1536b4f75d5464a90f88912d98576f86f63494f5

  • Daniil Gentili <daniil.woop@daniil.it>

phpclientaudiovideofilesprotocolMessengerbytestelegrammtprotostickersGB

This package is auto-updated.

Last update: 2024-12-22 22:19:22 UTC

README

Created by Daniil Gentili

#StandWithUkraine 🇺🇦

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

// PHP 8.2+ is required.

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->start();

$me = $MadelineProto->getSelf();

$MadelineProto->logger($me);

if (!$me['bot']) {
    $MadelineProto->messages->sendMessage(peer: '@stickeroptimizerbot', message: "/start");

    $MadelineProto->channels->joinChannel(channel: '@MadelineProto');

    try {
        $MadelineProto->messages->importChatInvite(hash: 'https://t.me/+Por5orOjwgccnt2w');
    } catch (\danog\MadelineProto\RPCErrorException $e) {
        $MadelineProto->logger($e);
    }
}
$MadelineProto->echo('OK, done!');

Try running 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).

Made with MadelineProto

The following open source projects were created using MadelineProto: you can directly install them, or explore the source code as direct examples on how to use MadelineProto's many features!

  • magnaluna webradio - Multifeatured Telegram VoIP webradio
  • simpleBot.php - Extremely basic example
  • tgstories_dl_bot.php - Source code of @tgstories_dl_bot - Bot to download any Telegram Story!
  • downloadRenameBot.php - Download files by URL and rename Telegram files using this async parallelized bot!
  • secret_bot.php - Secret chat bot!
  • pipesbot.php - Creating inline bots and using other inline bots via a userbot!
  • bot.php - Examples for how to use filters, updates, get download links for any file, Telegram Stories and much more!
  • TelegramApiServer - Fast, simple, async php telegram api server: an HTTP JSON API for MadelineProto (for use in languages other than PHP, if using PHP use directly MadelineProto)

Want to add your own open-source project to this list? Click here!

Some of MadelineProto's core components are also available as separate, standalone libraries:

Documentation