From 07df21aac94ca7b469cdbc15da7c7841d8a40ffa Mon Sep 17 00:00:00 2001 From: Egor Bugaev Date: Mon, 6 Jul 2026 16:47:17 +0300 Subject: [PATCH] Bump version to 0.2.4, document SQL query mode, add Russian README --- README.md | 15 ++++++++++++++ README.ru.md | 51 ++++++++++++++++++++++++++++++++++++++++++++++++ appinfo/info.xml | 2 +- 3 files changed, 67 insertions(+), 1 deletion(-) create mode 100644 README.ru.md diff --git a/README.md b/README.md index 5899c66..8028017 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # ⚠️ Deprecated ⚠️ OCCWeb terminal +*Читать на [русском](README.ru.md).* + ### A web terminal for admins to launch Nextcloud's occ commands ![occweb](https://github.com/Adphi/OCCWeb/raw/main/appinfo/screenshot.png) @@ -14,6 +16,19 @@ As nextcloudd has no native support for asynchronous operations, due to the use Place this app in **nextcloud/apps/** +## SQL query mode + +Type `sql` in the terminal to switch into SQL query mode and run raw SQL +statements directly against the Nextcloud database (admin only). Separate +statements with `;`. Use **Shift+Enter** to add a new line and **Enter** to +run the whole block in a single request — this matters for scripts like +`SET vars.x = 'value'; SELECT current_setting('vars.x');`, since every +statement in one submission runs on the same database connection/session. +Type `occ` to switch back to the normal occ-command mode. + +⚠️ There is no undo for `DELETE`/`UPDATE` statements — double check what +you are about to run, ideally against a non-critical row/user first. + ## ⚠️ Warnings ⚠️ - The application is not a real interactive terminal and does not support long running tasks. diff --git a/README.ru.md b/README.ru.md new file mode 100644 index 0000000..a5eed88 --- /dev/null +++ b/README.ru.md @@ -0,0 +1,51 @@ +# ⚠️ Устарело ⚠️ OCCWeb terminal + +*Read in [English](README.md).* + +### Веб-терминал для администраторов для запуска occ-команд Nextcloud + +![occweb](https://github.com/Adphi/OCCWeb/raw/main/appinfo/screenshot.png) + + +## ⚠️ Устарело ⚠️ + +Поскольку Nextcloud не имеет встроенной поддержки асинхронных операций +(из-за использования PHP), это приложение считается устаревшим и больше не +будет поддерживать будущие версии Nextcloud (19+). Автору не удалось найти +способ реализовать полноценную поддержку интерактивных и долгих occ-задач в +веб-терминале без введения дополнительных зависимостей (например, через +websockets), а отсутствие настоящей асинхронности может привести к серьёзным +проблемам на больших инсталляциях. +[Этот issue](https://github.com/nextcloud/server/issues/16726) объясняет, +почему разработчик решил больше не поддерживать это приложение. + + +## Установка + +Поместите это приложение в **nextcloud/apps/** + +## Режим SQL-запросов + +Введите `sql` в терминале, чтобы переключиться в режим SQL-запросов и +выполнять произвольные SQL-запросы напрямую к базе данных Nextcloud (только +для администраторов). Запросы разделяются `;`. Используйте **Shift+Enter** +для перехода на новую строку и **Enter**, чтобы отправить весь блок одним +запросом — это важно для скриптов вида +`SET vars.x = 'value'; SELECT current_setting('vars.x');`, так как все +запросы, отправленные одним блоком, выполняются в рамках одного соединения +(сессии) с базой данных. Введите `occ`, чтобы вернуться в обычный режим +occ-команд. + +⚠️ Для `DELETE`/`UPDATE` нет отмены — внимательно проверяйте, что вы +собираетесь выполнить, желательно сначала на некритичной записи/пользователе. + +## ⚠️ Предупреждения ⚠️ + +- Это приложение не является настоящим интерактивным терминалом и не + поддерживает долгие задачи. + Поэтому на крупных инсталляциях команды вроде `occ files:scan` могут + завершаться по таймауту с ошибкой. +- Не используйте `occ maintenance:mode --on`, это очевидно... + +## Планы (TODO): +См. [открытые issues](https://github.com/Adphi/occweb/issues) diff --git a/appinfo/info.xml b/appinfo/info.xml index 0c39953..cbe0333 100644 --- a/appinfo/info.xml +++ b/appinfo/info.xml @@ -5,7 +5,7 @@ OCC Web OCC Commands in a web terminal - 0.2.3 + 0.2.4 agpl Adphi OCCWeb