PHP Класс Longman\TelegramBot\Telegram

Автор: Avtandil Kikabidze ([email protected])
Показать файл Открыть проект Примеры использования класса

Защищенные свойства (Protected)

Свойство Тип Описание
$admins_list array Admins list
$api_key string Telegram API key
$bot_name string Telegram Bot name
$botan_enabled boolean Botan.io integration
$commands_config array Commands config
$commands_paths array Custom commands paths
$download_path string Download path
$input string Raw request data (json) for webhook methods
$last_command_response Longman\TelegramBot\Entities\ServerResponse ServerResponse of the last Command execution
$mysql_enabled boolean MySQL integration
$pdo PDO PDO object
$update Longman\TelegramBot\Entities\Update Current Update object
$upload_path string Upload path
$version string Version

Открытые методы

Метод Описание
__construct ( string $api_key, string $bot_name ) Telegram constructor.
addCommandsPath ( string $path, boolean $before = true ) : Telegram Add a single custom commands path
addCommandsPaths ( array $paths, boolean $before = true ) : Telegram Add multiple custom commands paths
enableAdmin ( integer $admin_id ) : Telegram Enable a single Admin account
enableAdmins ( array $admin_ids ) : Telegram Enable a list of Admin Accounts
enableBotan ( $token ) : Telegram Enable Botan.io integration
enableExternalMySql ( PD\PDO $external_pdo_connection, string $table_prefix = null ) : Telegram Initialize Database external connection
enableMySql ( array $credential, string $table_prefix = null, string $encoding = 'utf8mb4' ) : Telegram Initialize Database connection
executeCommand ( string $command ) : mixed Execute /command
getAdminList ( ) : array Get list of admins
getApiKey ( ) : string Get API key
getBotName ( ) : string Get Bot name
getCommandConfig ( string $command ) : array Get command config
getCommandObject ( string $command ) : Command | null Get an object instance of the passed command
getCommandsList ( ) : array Get commands list
getCustomInput ( ) : string Get custom input string for debug purposes
getDownloadPath ( ) : string Get custom download path
getLastCommandResponse ( ) : ServerResponse Get the ServerResponse of the last Command execution
getUploadPath ( ) : string Get custom upload path
getVersion ( ) : string Get Version
handle ( ) : boolean Handle bot request from webhook
handleGetUpdates ( integer | null $limit = null, integer | null $timeout = null ) : ServerResponse Handle getUpdates method
isAdmin ( integer | null $user_id = null ) : boolean Check if the passed user is an admin
isDbEnabled ( ) : boolean Check if user required the db connection
processUpdate ( Update $update ) : ServerResponse Process bot Update request
setCommandConfig ( string $command, array $config ) : Telegram Set command config
setCustomInput ( string $input ) : Telegram Set custom input string for debug purposes
setDownloadPath ( string $path ) : Telegram Set custom download path
setUploadPath ( string $path ) : Telegram Set custom upload path
setWebHook ( string $url, string | null $path_certificate = null ) : ServerResponse Set Webhook for bot
unsetWebHook ( ) : mixed Unset Webhook for bot

Защищенные методы

Метод Описание
sanitizeCommand ( string $command ) : string Sanitize Command
ucfirstUnicode ( string $str, string $encoding = 'UTF-8' ) : string Replace function ucfirst for UTF-8 characters in the class definition and commands
ucwordsUnicode ( string $str, string $encoding = 'UTF-8' ) : string Replace function ucwords for UTF-8 characters in the class definition and commands

Приватные методы

Метод Описание
getCommandFromType ( string $type ) : string Get the command name from the command type

Описание методов

__construct() публичный Метод

Telegram constructor.
public __construct ( string $api_key, string $bot_name )
$api_key string
$bot_name string

addCommandsPath() публичный Метод

Add a single custom commands path
public addCommandsPath ( string $path, boolean $before = true ) : Telegram
$path string Custom commands path to add
$before boolean If the path should be prepended or appended to the list
Результат Telegram

addCommandsPaths() публичный Метод

Add multiple custom commands paths
public addCommandsPaths ( array $paths, boolean $before = true ) : Telegram
$paths array Custom commands paths to add
$before boolean If the paths should be prepended or appended to the list
Результат Telegram

enableAdmin() публичный Метод

Enable a single Admin account
public enableAdmin ( integer $admin_id ) : Telegram
$admin_id integer Single admin id
Результат Telegram

enableAdmins() публичный Метод

Enable a list of Admin Accounts
public enableAdmins ( array $admin_ids ) : Telegram
$admin_ids array List of admin ids
Результат Telegram

enableBotan() публичный Метод

Enable Botan.io integration
public enableBotan ( $token ) : Telegram
$token
Результат Telegram

enableExternalMySql() публичный Метод

Initialize Database external connection
public enableExternalMySql ( PD\PDO $external_pdo_connection, string $table_prefix = null ) : Telegram
$external_pdo_connection PD\PDO PDO database object
$table_prefix string
Результат Telegram

enableMySql() публичный Метод

Initialize Database connection
public enableMySql ( array $credential, string $table_prefix = null, string $encoding = 'utf8mb4' ) : Telegram
$credential array
$table_prefix string
$encoding string
Результат Telegram

executeCommand() публичный Метод

Execute /command
public executeCommand ( string $command ) : mixed
$command string
Результат mixed

getAdminList() публичный Метод

Get list of admins
public getAdminList ( ) : array
Результат array

getApiKey() публичный Метод

Get API key
public getApiKey ( ) : string
Результат string

getBotName() публичный Метод

Get Bot name
public getBotName ( ) : string
Результат string

getCommandConfig() публичный Метод

Get command config
public getCommandConfig ( string $command ) : array
$command string
Результат array

getCommandObject() публичный Метод

Get an object instance of the passed command
public getCommandObject ( string $command ) : Command | null
$command string
Результат Longman\TelegramBot\Commands\Command | null

getCommandsList() публичный Метод

Get commands list
public getCommandsList ( ) : array
Результат array $commands

getCustomInput() публичный Метод

Get custom input string for debug purposes
public getCustomInput ( ) : string
Результат string

getDownloadPath() публичный Метод

Get custom download path
public getDownloadPath ( ) : string
Результат string

getLastCommandResponse() публичный Метод

Get the ServerResponse of the last Command execution
public getLastCommandResponse ( ) : ServerResponse
Результат Longman\TelegramBot\Entities\ServerResponse

getUploadPath() публичный Метод

Get custom upload path
public getUploadPath ( ) : string
Результат string

getVersion() публичный Метод

Get Version
public getVersion ( ) : string
Результат string

handle() публичный Метод

Handle bot request from webhook
public handle ( ) : boolean
Результат boolean

handleGetUpdates() публичный Метод

Handle getUpdates method
public handleGetUpdates ( integer | null $limit = null, integer | null $timeout = null ) : ServerResponse
$limit integer | null
$timeout integer | null
Результат Longman\TelegramBot\Entities\ServerResponse

isAdmin() публичный Метод

If no user id is passed, the current update is checked for a valid message sender.
public isAdmin ( integer | null $user_id = null ) : boolean
$user_id integer | null
Результат boolean

isDbEnabled() публичный Метод

Check if user required the db connection
public isDbEnabled ( ) : boolean
Результат boolean

processUpdate() публичный Метод

Process bot Update request
public processUpdate ( Update $update ) : ServerResponse
$update Longman\TelegramBot\Entities\Update
Результат Longman\TelegramBot\Entities\ServerResponse

sanitizeCommand() защищенный Метод

Sanitize Command
protected sanitizeCommand ( string $command ) : string
$command string
Результат string

setCommandConfig() публичный Метод

Provide further variables to a particular commands. For example you can add the channel name at the command /sendtochannel Or you can add the api key for external service.
public setCommandConfig ( string $command, array $config ) : Telegram
$command string
$config array
Результат Telegram

setCustomInput() публичный Метод

Set custom input string for debug purposes
public setCustomInput ( string $input ) : Telegram
$input string (json format)
Результат Telegram

setDownloadPath() публичный Метод

Set custom download path
public setDownloadPath ( string $path ) : Telegram
$path string Custom download path
Результат Telegram

setUploadPath() публичный Метод

Set custom upload path
public setUploadPath ( string $path ) : Telegram
$path string Custom upload path
Результат Telegram

setWebHook() публичный Метод

Set Webhook for bot
public setWebHook ( string $url, string | null $path_certificate = null ) : ServerResponse
$url string
$path_certificate string | null
Результат Longman\TelegramBot\Entities\ServerResponse

ucfirstUnicode() защищенный Метод

Replace function ucfirst for UTF-8 characters in the class definition and commands
protected ucfirstUnicode ( string $str, string $encoding = 'UTF-8' ) : string
$str string
$encoding string (default = 'UTF-8')
Результат string

ucwordsUnicode() защищенный Метод

Replace function ucwords for UTF-8 characters in the class definition and commands
protected ucwordsUnicode ( string $str, string $encoding = 'UTF-8' ) : string
$str string
$encoding string (default = 'UTF-8')
Результат string

unsetWebHook() публичный Метод

Unset Webhook for bot
public unsetWebHook ( ) : mixed
Результат mixed

Описание свойств

$admins_list защищенное свойство

Admins list
protected array $admins_list
Результат array

$api_key защищенное свойство

Telegram API key
protected string $api_key
Результат string

$bot_name защищенное свойство

Telegram Bot name
protected string $bot_name
Результат string

$botan_enabled защищенное свойство

Botan.io integration
protected bool $botan_enabled
Результат boolean

$commands_config защищенное свойство

Commands config
protected array $commands_config
Результат array

$commands_paths защищенное свойство

Custom commands paths
protected array $commands_paths
Результат array

$download_path защищенное свойство

Download path
protected string $download_path
Результат string

$input защищенное свойство

Raw request data (json) for webhook methods
protected string $input
Результат string

$last_command_response защищенное свойство

ServerResponse of the last Command execution
protected ServerResponse,Longman\TelegramBot\Entities $last_command_response
Результат Longman\TelegramBot\Entities\ServerResponse

$mysql_enabled защищенное свойство

MySQL integration
protected bool $mysql_enabled
Результат boolean

$pdo защищенное свойство

PDO object
protected PDO $pdo
Результат PDO

$update защищенное свойство

Current Update object
protected Update,Longman\TelegramBot\Entities $update
Результат Longman\TelegramBot\Entities\Update

$upload_path защищенное свойство

Upload path
protected string $upload_path
Результат string

$version защищенное свойство

Version
protected string $version
Результат string