Download the PHP package furqansiddiqui/telegram without Composer
On this page you can find all versions of the php package furqansiddiqui/telegram. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package telegram
Telegram Package
Allow your users to connect Telegram with your app and receive notifications;
Prerequisites
- PHP 7.0+
- furqansiddiqui/http-client >= 0.2.1
Installation
composer require furqansiddiqui/telegram
Integrating Telegram
Get Telegram instance by passing your telegram bot API key to constructor
Setting up a web hook
Custom Handlers
Create a handler class that extends AbstractHandler with each method for every command you wish to respond to.
- Any user sent message that doesn't start with leading slash "/" is considered a chat message and will be handled in "chat" method.
- All user messages starting with leading slash "/" are commands, and have individual methods as per their names.
- Your custom handler class must have "start" and "help" methods.
- Ideally, You should associate "chat_id" param with users in your DB.
- On start command, you should generate a temp. authentication code and send it to telegram chat asking them to enter this code at your website after proper authentication as a user.
- Once user enters this code at your website, you can safely associate "chat_id" param associated with this temp. code with your user.
- How you generate/store and secure this code is entirely up to you.
- You should name your methods in "camelCase", i.e. when user enters command "/get_balance", handler will look for and call "getBalance" method if available.
- Any word followed by a command (after a leading slash "/") will be considered as param.
- All parameters are stored in "params" prop as indexed array.
- All non-command messages can be handled with in "chat" method. See
BasicHandlerclass for an example.
Listening
- You should use secret tokens in your web hook URL as well as cross-check data received from Telegram web hook server for security. This has to be done entirely at your own end. Calling listen/handle method assumes you have already successfully validated this request.
Refer to class BasicHandler for better understanding on writing your own custom handler.
Sending a Message
Use sendMessage method to send a message to specific user or chat.
If you have associated a "chat_id" param with one of your users, retrieve this value to send a notification/message to that specific user at any time.
NOTE: This method is ideal for Non-interactive messaging, i.e. User had previously subscribed to your bot via "start" or any other custom command and now you can send alerts/notification to this user.
For interactive messaging, You can use sendReply method in your custom handler as a quicker way around.
