KeyboardButtonRequestChat
extends TelegramObject
in package
This object defines the criteria used to request a suitable chat. Information about the selected chat will be shared with the bot when the corresponding button is pressed. The bot will be granted requested rights in the chat if appropriate.. Source: https://core.telegram.org/bots/api#keyboardbuttonrequestchat
Table of Contents
Properties
- $bot : Bot|null
- $botAdministratorRights : ChatAdministratorRights|null
- $botIsMember : bool|null
- $chatHasUsername : bool|null
- $chatIsChannel : bool
- $chatIsCreated : bool|null
- $chatIsForum : bool|null
- $requestId : int
- $requestPhoto : bool|null
- $requestTitle : bool|null
- $requestUsername : bool|null
- $userAdministratorRights : ChatAdministratorRights|null
Methods
- __construct() : mixed
- as_() : static
- Alias of withBot() for grep-translating aiogram code that uses obj.as_(bot).
- withBot() : static
- Returns a clone of $this with $bot rebound recursively. Walks every public property; nested `BotContextController` instances are rebound via their own `withBot`, arrays (including nested arrays of arbitrary depth — e.g.
Properties
$bot read-only
public
Bot|null
$bot
= null
$botAdministratorRights read-only
public
ChatAdministratorRights|null
$botAdministratorRights
= null
$botIsMember read-only
public
bool|null
$botIsMember
= null
$chatHasUsername read-only
public
bool|null
$chatHasUsername
= null
$chatIsChannel read-only
public
bool
$chatIsChannel
$chatIsCreated read-only
public
bool|null
$chatIsCreated
= null
$chatIsForum read-only
public
bool|null
$chatIsForum
= null
$requestId read-only
public
int
$requestId
$requestPhoto read-only
public
bool|null
$requestPhoto
= null
$requestTitle read-only
public
bool|null
$requestTitle
= null
$requestUsername read-only
public
bool|null
$requestUsername
= null
$userAdministratorRights read-only
public
ChatAdministratorRights|null
$userAdministratorRights
= null
Methods
__construct()
public
__construct(int $requestId, bool $chatIsChannel[, bool|null $chatIsForum = null ][, bool|null $chatHasUsername = null ][, bool|null $chatIsCreated = null ][, ChatAdministratorRights|null $userAdministratorRights = null ][, ChatAdministratorRights|null $botAdministratorRights = null ][, bool|null $botIsMember = null ][, bool|null $requestTitle = null ][, bool|null $requestUsername = null ][, bool|null $requestPhoto = null ][, Bot|null $bot = null ]) : mixed
Parameters
- $requestId : int
- $chatIsChannel : bool
- $chatIsForum : bool|null = null
- $chatHasUsername : bool|null = null
- $chatIsCreated : bool|null = null
- $userAdministratorRights : ChatAdministratorRights|null = null
- $botAdministratorRights : ChatAdministratorRights|null = null
- $botIsMember : bool|null = null
- $requestTitle : bool|null = null
- $requestUsername : bool|null = null
- $requestPhoto : bool|null = null
- $bot : Bot|null = null
as_()
Alias of withBot() for grep-translating aiogram code that uses obj.as_(bot).
public
as_(Bot|null $bot) : static
IMPORTANT: behaves DIFFERENTLY from upstream — upstream mutates self.bot in place and returns self. The PHP port can't mutate readonly, so this returns a clone. Callers must reassign: $msg = $msg->as($bot).
Parameters
- $bot : Bot|null
Return values
staticwithBot()
Returns a clone of $this with $bot rebound recursively. Walks every public property; nested `BotContextController` instances are rebound via their own `withBot`, arrays (including nested arrays of arbitrary depth — e.g.
public
withBot(Bot|null $bot) : static
list<list<KeyboardButton>>) are walked element-wise. Plain values
(scalars, DateTime, enums, InputFile etc.) pass through untouched.
Mirrors upstream pydantic model_validate(context={"bot": bot}) (aiogram
ContextController.as_/model_dump_json+model_validate).
Scope note: PHP 8.5 treats public readonly as effectively
public protected(set) readonly for clone-with — only code running with
a scope in the property's declaring class hierarchy (declaring class plus
its ancestors and descendants) can use clone($obj, ['x' => ...]) against
it. Because this method lives on BotContextController and every
TelegramObject/TelegramMethod subclass extends it, the walker's
clone($this, [...]) call legally rewrites subclass-declared readonly
slots like Message::$chat. External callers cannot use the same syntax
— they must funnel through this method.
Parameters
- $bot : Bot|null