Télégramme - bot | Menu complet

Tôt ou tard, dans la vie d'un développeur de bots de télégrammes, il est clair que tout est mortellement nécessaire pour créer des menus plus ou moins complets pour les bots.

Depuis:

A) C'est pratique
B) Pratique pour la personnalisation *

Personne, bien sûr, n'a annulé "/ team", mais

Essence de la tâche

À première vue - la tâche est simple, mais peu importe comment. Tout le problème est dans l' API elle - même , à savoir dans l'objet Update .

Un peu plus de détails: en utilisant la méthode getUpdate - vous obtenez un objet Update, c'est logique! Donc, cet objet contient beaucoup de choses utiles, y compris des informations sur le message, mais seulement sur la dernière. C'est le hic

Sur la base de ce qui précède, la conclusion n'est pas si agréable: le traitement des demandes par webhook, sans stocker de données supplémentaires, ne brille pas pour nous ...

Eh bien, on se lave et on se met au travail.

Écrire un code d'apprentissage

Dans leur pratique, spécialement pour cette tâche, une petite classe a été développée.

NOUVEAU! Maintenant sur github )

Si vous ne pouvez pas attendre, vous pouvez immédiatement vous rendre au référentiel, il y a une excursion là-bas.

Continuez

La classe crée une demande de demande

Un peu sur la structure: Le menu est parcouru en créant une demande de demande . Vous le créez au bon endroit, et au prochain appel de l' utilisateur , bam, et il est dans le «menu».

Je suis d'accord, le concept, après cela, n'est pas devenu compréhensible ... Je vais essayer de clarifier. Pour comprendre, vous devez aller à un certain niveau d'abstraction, c'est-à-dire imaginer que la structure entière du bot se compose de différents menus entre lesquels l'utilisateur bascule (vous pouvez faire une analogie avec l'activité Android). Lorsque le bot est activé, l'utilisateur se trouve dans le "menu initial", à partir duquel il peut aller, par exemple, dans le menu "Paramètres", "Informations", etc.



Et donc, la structure du bot change un peu, en bref:

Vérifiez d'abord si la demande existe:

OUI) Exécutez le gestionnaire de requêtes
NON) Nous restons dans le "menu initial", nous vérifions la réponse de l'utilisateur avec les commandes disponibles.

* Ceci est une version très simplifiée, à cause de cela, elle frappe la barre. Avec des exemples, cela deviendra plus facile.

Continuons ..?

Commençons par l'installation. Nous allons utiliser un compser pour l'installer (créer "composer.json", puis copier les lignes ci-dessous, en savoir plus dans off.docs)

{ "require" : { "s0d3s/tg-long-req": ">=1" } } 

et connectez

 include_once('path/to/autoload.php'); use TgLongReq\TgLongReq; 

OU connectez-vous manuellement (téléchargez dans le dossier du projet)

 include_once('TgLongReq.php'); use TgLongReq\TgLongReq; 

CRÉER UN OBJET

 function SOMTH($tg_res, $long_req_obj, $tab_key){ echo "EveryForEveryone"; return; } $BOT_FUNC_ASSO_TAB = arrray("ECHO_SOMETHING" => "SOMTH"); // -      ,  -  -\  $tgreq = new TgLongReq ( $usr_id, //(STR) -id  $BOT_FUNC_ASSO_TAB, //(ARRAY) $BOT_req_dir , //[OPT](STR) $tapi, //[OPT](ANY*) $result //[OPT](ANY**) ); // *  ,    $this->tg_api // **  ,      

FAIRE UNE DEMANDE, VÉRIFIER LA DISPONIBILITÉ ET COMMENCER LE TRAITEMENT

 $tgreq -> ReqCreate('SOMTH');//  if($tgreq -> ReqCheck()){ // ,   ,       $tgreq -> ReqHand();// ,   } 

CACHÉ ET OBTENIR DES DONNÉES DE TEMPS

enregistrer:

 $tgreq -> SaveToTemp('HiHabr');//  ,    json- 

restaurer:

 $tgreq -> GetFromTemp(false);//  -    ,    // ,    SaveToTemp() 

RÉSULTAT DE LA FONCTION

Il convient de noter que chaque fonction [à l'exception de GetFromTemp (), GetError (), ReqCheck () et du constructeur], renvoie un tableau:

 /*$function_result = array( 'func_res' =>   'error' =>true,    'err_discript' => ,     ); */ 

ERREURS

Chaque fonction [à l'exception de GetFromTemp (), GetError (), ReqCheck () et le constructeur] définit une erreur en cas d'échec, qui peut être vérifiée avec:

 $error_arr = $tgreq -> GetError(); /*$error_arr = array( 'error' =>true,    'err_discript' => ,     ); */ 

Tous réunis, partez!

Nous supposerons que vous êtes peu familiarisé avec l'écriture de robots télégrammes, sinon -% article %, lisez jusqu'à l'article " Écriture du code bot " - le premier lien dans Google sur un sujet, vous pouvez rechercher par vous-même, l'essentiel est de savoir comment créer un bot dans tg lui-même, et configurer lui à votre serveur. Si c'est intéressant, j'écrirai un article sur la façon de configurer un webhook pour fonctionner avec un serveur local (~ NOUVEAU! Solution pour contourner le "problème" avec https).

Nous réaliserons cet exemple. Nous divisons l'espace en deux fichiers «botmain.php» (menu principal et traitement) et «varfunc.php» (fonctions de traitement des requêtes). Pour faciliter l'exemple, nous utiliserons telegram-bot-sdk (un projet bien conçu et bien conçu, pratique pour les petits projets, grâce au créateur;).

En général, la liste :


Ensuite, dans le dossier du projet, ouvrez la console et ...

 >composer install ... 

UPD : Dans le cadre de Habr, le code source devient illisible, sans modification globale. Pour cette raison, si vous êtes intéressé par des exemples, je vous suggère de passer à github.

Original | Version simplifiée .

Conclusion

En fin de compte, je peux seulement dire que ce n'est pas la seule solution possible à ce problème, mais du point de vue de l'optimalité pour ME, c'est un favori.