Страница телеграм канала MadelineProto | Official Channel
MadelineProto | Official Channel
5938 подписчиков
Official MadelineProto channel. Italian Channel: @MadelineProtoIta Group: @pwrtelegramgroup
Входит в категории:
06.09.2021 21:09
Fixed a bug in the madeline.php build, that prevented the IPC server from starting.
Also improved the integration tests to prevent this from happening again.
Now MadelineProto really has a built-in IPC server, this means:
Very fast startup for small scripts: ~0.02 seconds, before was 1-5 seconds :D
05.09.2021 22:09
The Phabel commands can be used if you have a bot/library, and you want to use PHP 8 features or await in your code.
MadelineProto is already transpiled using Phabel, you dont need to run those commands to use it :)
05.09.2021 22:09
MadelineProto was d!
MadelineProto 6 introduces ultra-fast startup with a built-in IPC server, PHP transpilation using phabel.io, MySQL/Postgres/redis database support to reduce RAM usage, and new, IDE-friendly settings.
The main event:
- MadelineProto is now transpiled using phabel.io!
Phabel.io is a PHP transpiler that allows native usage of PHP 8+ features in projects and libraries, while allowing maintainers to publish a version targeting lower versions of php.
Async await syntax is also supported!
Usage:
composer require - dev phabel/phabel
You can now publish your packagist package, and it will be automatically transpiled to any PHP version supported by phabel.
After git tagging a new release, just run:
vendor/bin/phabel publish
Your PHP 7 users can now install your PHP 8 library
All your dependencies will also be transpiled to the correct PHP version.
Supported PHP versions:
Syntax/feature support:
- 8.0+
- async/await syntax
Target:
- 7.1+
- 5.6, 7.0 in final testing stage.
- 5.4, 5.5 support coming soon!
- Now MadelineProto has a built-in IPC server, this means:
Very fast startup for small scripts: ~0.02 seconds, before was 1-5 seconds
To use this IPC server, just use MadelineProto normally:
$API = new danogMadelineProtoAPI(session.madeline);
$API->start();
$API->messages->sendMessage([peer => $_POST[peer], message => $_POST[message]]);
This is useful for small sendMessage.php scripts, to be called from outside; for maximum performance in bots use an async event handler.
- New IDE-friendly settings API!
- Async MySQL/Postgres/redis integration:
Use a database to reduce memory usage to 1-5 MB even for thousands of groups!
See here for examples and documentation.
Native database integration in the event handler is also now supported!
Other brand-new features in MadelineProto 6:
- New PHP API documentation
- d Telegram API to layer 131
- d tg-file-decoder library
- New localization keys for all UI elements
- New settings for custom HTML, Javascript and CSS in login page templates
- New PSR logger API
- New session conversion API
Coming up soon: **** **IP implementation ;)
Internal improvements:
- Many, many bugfixes, stability fixes and performance improvements
- RPC requests are containerized by default, when possible
- Complete refactoring of MTProto message subsystem
- Added a periodic garbage collector
- Implemented native PHP prime factorization (C++ factorization is still recommended using prime.madelineproto.xyz)
31.12.2020 22:12
The pony behind MadelineProto officially wishes everyone a very happy 2021, with lots of interesting new APIs, languages and juicy CS theory.
As a new years present, Ive actually finished the composer integration in phabel, and stabilized the transpiler API to fully integrate it in the next release of MadelineProto.
30.09.2020 21:09
All main MadelineProto 6 features are ready, release coming as soon as I finish the phabel transpiler ;)
23.08.2020 19:08
While we all wait for MadelineProto 6, here are a few really neat fully async plugin sources for MadelineProto:
realGuys/MadelineProtoPluginSystem - A simple to use yet powerful async plugin MadelineProto source base
MohsenJS/MadelineProtoPluginSystem - A MadelineProto plugin system with support for patterns and conversations
Feel free to ping me in the groups if you have developed anything else based on MadelineProto, I will publish it on this channel!
20.05.2020 15:05
PSA: please DO NOT remove the madeline.phar.version and madeline.phar files in your sources.
This will greatly slow down your source on each startup, and it has already caused me some issues due to excessive composer install reports.
Please, remove all unlink(madeline.phar); unlink(madeline.phar.version); codes from your sources.
15.03.2020 22:03
On the importance of logging.
For a programmer, programming without logs is like driving with closed eyes: at any moment you could crash against a wall, and you wouldnt even see it coming.
Many times I see MadelineProto users asking me for help, saying that their "bots dont work" or "it worked yesterday", often blaming me for their mistakes.
This is precisely why you need logging: with logging, you can figure out exactly what went wrong in your (or my!) code, and fix the error immediately.
MadelineProto now allows automatic error reporting with full logs and exception traces as soon as the script crashes (automatically recovering the bot from any errors).
It is enabled if you use getReportPeers + startAndLoop: it is a very useful feature for devs, and can help you to find and fix problems before they are noticed by your users.
Resources:
- Error reporting
- Logging
- Exceptions
15.03.2020 22:03
Among other new features, the onStart async method can be used to execute methods on bot startup (instead of calling $MadelineProto->loop() outside of the bot).
15.03.2020 22:03
MadelineProto 5.1 introduces one especially useful feature: native error reporting.
Native error reporting greatly simplifies the development process of MadelineProto bots.
Simply by specifying the username of the bot admin, all errors raised by the bot (or MadelineProto itself!) are automatically reported to the admin, along with the logfile.
Starting with this version of MadelineProto, doing unlink(MadelineProto.log); will crash MadelineProto.
If you need to reduce the size of the logfile, change $settings[logger][max_size] (minimum 100kb = 100*1000).
Here is an example source for MadelineProto 5.1:
<?php
if (!file_exists(madeline.php)) {
copy(https://phar.madelineproto.xyz/madeline.php, madeline.php);
}
include madeline.php;
use danogMadelineProtoEventHandler;
use danogMadelineProtoTools;
use danogMadelineProtoAPI;
use danogMadelineProtoLogger;
use danogMadelineProtoRPCErrorException;
/**
* Event handler class.
*/
class MyEventHandler extends EventHandler
{
/**
* @var int|string Username or ID of bot admin
*/
const ADMIN = "danogentili"; // Change this
/**
* Get peer(s) where to report errors
*
* @return int|string|array
*/
public function getReportPeers()
{
return [self::ADMIN];
}
/**
* Called on startup, can contain async calls for initialization of the bot
*
* @return void
*/
public function onStart()
{
}
/**
* Handle s from supergroups and channels
*
* @param array $
*
* @return void
*/
public function onNewChannelMessage(array $): Generator
{
return $this->onNewMessage($);
}
/**
* Handle s from users.
*
* @param array $
*
* @return Generator
*/
public function onNewMessage(array $): Generator
{
if ($[message][_] === messageEmpty || $[message][out] ?? false) {
return;
}
$res = json_encode($, JSON_PRETTY_PRINT);
try {
yield $this->messages->sendMessage([peer => $, message => "
$res", reply_to_msg_id => $[message][id] ?? null, parse_mode => HTML]);
if (isset($[message][media]) && $[message][media][_] !== messageMediaGame) {
yield $this->messages->sendMedia([peer => $, message => $[message][message], media => $]);
}
} catch (RPCErrorException $e) {
$this->report("Surfaced: $e");
} catch (Exception $e) {
if (stripos($e->getMessage(), invalid constructor given) === false) {
$this->report("Surfaced: $e");
}
}
}
}
$settings = [];
$MadelineProto = new API(bot.madeline, $settings);
$MadelineProto->startAndLoop(MyEventHandler::class);
The new startAndLoop method automatically initializes MadelineProto, enables async, logs in the user/bot, initializes error reporting, catches and reports all errors surfacing from the event loop to the peers returned by the getReportPeers method.
It also contributes to slashing boilerplate, removing all the $MadelineProto->loop() stuff that cluttered even simple codebases.
15.03.2020 20:03
> What is AMPHP (https://amphp.org)?
Amp is a non-blocking concurrency framework for PHP providing primitives to manage concurrency such as an event loop, promises, and asynchronous iterators.
> OK, in simpler words?
AMPHP is a high-performance, parallelized PHP library that allows you to write extremely fast, efficient programs that work in parallel using green threads.
> * b r a i n m e l t *
Y E S
———
MadelineProto is not written in PHP: MadelineProto is written using AMPHP.
What this means is that when you using MadelineProto (and async is enabled), all incoming messages are handled in parallel, each in a separate thread, even on webhosts.
This allow your bots to always be responsive, even while executing complex tasks.
However, it is vital that you also use AMPHP (not PHP!) when writing your bot.
What this means is that the following PHP functions and extensions cannot be used in MadelineProto bots (otherwise, all the benefits of AMPHP would be nullified): instead, you must use the correct AMPHP library (automatically included in madeline.php).
file_get_contents
amphp/file for files, amphp/http-client and $MadelineProto->fileGetContents for URLs
curl, guzzle
amphp/http-client is async, much faster than other libraries, and also supports HTTP/2!
mysqli, PDO, sqlite
amphp/mysql supports both MySQL and SQLite backends, and is fully async!
You can also use amphp/postgres and amphp/redis for PostgreSQL and Redis!
php-fpm
amphp/http-server is a high-performance async HTTP/2 server, that can be interfaced with MadelineProto to create file download servers!
include, require
Dont use this function very often, and most importantly, dont use it inside of the event handler code.
You should use it only once on bot startup, or else when reloading the bot (plugin source coming soon!)
———
In short, AMPHP is an awesome framework for using async PHP in 2020: you can join the official Telegram support group @amphpchat if you have any questions or suggestions on what else to add to AMPHP!
15.03.2020 19:03
I will also be posting MadelineProto and AMPHP tips on @MadelineProto more regularly, starting very soon.