MokoConsulting/MokoSuiteBackup
1
0
Fork 0
Code Issues 8 Pull Requests Packages Releases 5 Wiki Activity

feat: Stepped restore engine for large sites (AJAX-based) #62

New Issue
Closed
opened 2026-06-21 16:50:20 +00:00 by jmiller · 0 comments
jmiller commented 2026-06-21 16:50:20 +00:00
Owner
Copy Link
Copy Source

Summary

The current RestoreEngine runs synchronously, which can time out on shared hosting with large backup archives. Add a SteppedRestoreEngine (mirroring the existing SteppedBackupEngine pattern) that breaks restore into AJAX steps:

  1. Extract — extract archive to staging (can be chunked for large archives)
  2. Files — copy files from staging to Joomla root in batches
  3. Database — import SQL statements in batches (e.g., 500 statements per step)
  4. Config — restore configuration.php
  5. Cleanup — remove staging directory

UI

  • Reuse the progress modal pattern from stepped backups
  • Show phase, progress %, and current operation

Why

Sites with 10,000+ files or large databases timeout during synchronous restore on shared hosting (30s/60s PHP execution limits).

Files

  • src/Engine/SteppedRestoreEngine.php (new)
  • src/Controller/AjaxController.php — add restoreInit() and restoreStep() methods
  • tmpl/backups/default.php — update restore modal to use AJAX steps
## Summary The current `RestoreEngine` runs synchronously, which can time out on shared hosting with large backup archives. Add a `SteppedRestoreEngine` (mirroring the existing `SteppedBackupEngine` pattern) that breaks restore into AJAX steps: 1. **Extract** — extract archive to staging (can be chunked for large archives) 2. **Files** — copy files from staging to Joomla root in batches 3. **Database** — import SQL statements in batches (e.g., 500 statements per step) 4. **Config** — restore configuration.php 5. **Cleanup** — remove staging directory ## UI - Reuse the progress modal pattern from stepped backups - Show phase, progress %, and current operation ## Why Sites with 10,000+ files or large databases timeout during synchronous restore on shared hosting (30s/60s PHP execution limits). ## Files - `src/Engine/SteppedRestoreEngine.php` (new) - `src/Controller/AjaxController.php` — add `restoreInit()` and `restoreStep()` methods - `tmpl/backups/default.php` — update restore modal to use AJAX steps
jmiller added the component: enginecomponent: admin labels 2026-06-21 16:50:20 +00:00
Sign in to join this conversation.
Labels
Clear labels
component: admin
Admin UI and views
 component: api
REST API
 component: engine
Backup/restore engine
 component: remote
Remote storage (FTP/GDrive)
 component: scheduler
Scheduled tasks
No labels component: admin component: engine
Priority Medium
Type Feature
Milestone
No items
No Milestone
Assignees
Clear assignees
jmiller (Jonathan Miller)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuiteBackup#62
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?