Получить дополнительную информацию о требованиях к серверу и установке приложения можно на официальном сайте фреймворка.
Расположенный в корне файл ".env" является основным конфигом приложения.
Для редактирования его содержимого подходит любой текстовый редактор.
| Ключ | Описание |
|---|---|
| APP_NAME | Название приложения |
| APP_VERSION | Версия приложения |
| APP_ENV | Режим работы |
| APP_KEY | Секретный ключ приложения |
| APP_DEBUG | Отладка ошибок |
| APP_SHOW_MODE | Режим демонстрации |
| APP_URL | URL адрес приложения |
| APP_LOCALE | Язык приложения по умолчанию |
| CACHE_TIME | Время кеширования в секундах |
| EXCHANGER_URL | URL адрес обменника |
| EXCHANGER_DASHBOARD_API_TOKEN | Секретный ключ API панели управления |
| EXCHANGER_PRIVATE_API_TOKEN | Секретный ключ приватного API |
| EXCHANGER_WEBHOOKS_SECRET_KEY | Секретный ключ веб-хука |
| TELEGRAM_BOT_TOKEN | Секретный ключ Telegram бота |
| TELEGRAM_BOT_BANLIST | Заблокированные пользователи (через запятую) |
| TELEGRAM_BOT_LOG | Логирование диалогов |
Прежде чем начинать настройку, необходимо зарегистрировать бота и получить его уникальный токен. Для этого в Telegram существует специальный бот "BotFather", при помощи которого меняются настройки у существующих ботов и создаются новые.
Напишите команду /newbot, чтобы создать нового бота. Бот спросит у вас название нового бота и предложит придумать его логин на латинице. Логин должен состоять из букв латинского алфавита, подчёркиваний и цифр и быть длиной от 5 до 32 символов. Также логин обязательно должен заканчиваться на "bot", например: "exchanger_bot" или "ExchangerBot".
По завершению регистрации вы получите токен, который нужно указать в файле конфигураций приложения.
Перейдите в панель управления, в раздел "Настройки приложения" — "Настройка API панели управления". Выпустите секретный ключ и активируйте API.
Перейдите в панель управления, в раздел "Настройки приложения" — "Настройка приватного API". Выпустите секретный ключ и активируйте API.
Перейдите в панель управления, в раздел "Настройки приложения" — "Настройка веб-хуков". Выпустите секретный ключ и активируйте API.
Используя командную строку на сервере и интерфейс Artisan, выполните команду для установки URL обработчика веб-хуков. Убедитесь при этом что вы находитесь в корневой директории приложения.
Команда:
php artisan set-webhook-url
Если на хостинге нет доступа к командной строке, вы можете использовать URL адрес ./setup, убедитесь что во время перехода по нему, значение параметра APP_DEBUG в файле конфигураций установлено на true, после успешной настройки значение необходимо изменить на false.
Директория с языковыми файлами расположена по пути /resources/lang, каждый каталог содержит ряд языковых файлов:
| Файл | Описание |
|---|---|
| buttons.php | Текст кнопок |
| commands.php | Описание команд |
| keyboards.php | Текст главного меню |
| languages.php | Языки |
| messages.php | Текст сообщений |
| words.php | Прочие слова |
Для добавления дополнительной локализации достаточно скопировать один из существующих каталогов, а так же внести изменения в языковый файл languages.php для всех языковых файлов.
Для удаления языка достаточно удалить каталог.
Отключение команд может быть произведено в файле по пути /config/telegram.php, при помощи комментирования с использованием двойного слеша.
Пример отключенной команды:
'commands' => [
...
// App\Commands\SoftwareCommand::class,
...
];