PHPackages                             pubvana/backups - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. pubvana/backups

ActiveFlightphp-plugin[File & Storage](/categories/file-storage)

pubvana/backups
===============

Backup and restore for Pubvana CMS (database + files)

0.1.2(2mo ago)03MITPHPPHP ^8.1

Since May 16Pushed 2mo agoCompare

[ Source](https://github.com/Pubvana-CMS/backups)[ Packagist](https://packagist.org/packages/pubvana/backups)[ Docs](https://pubvana.net)[ RSS](/packages/pubvana-backups/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (1)Dependencies (3)Versions (4)Used By (0)

[![Stable? Not Quite Yet](https://camo.githubusercontent.com/8712c441bb32fd8db507e0008c5d13e30def50064f8fcbc689fbcf5191f7d2af/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f737461626c652533462d6e6f7425323071756974652532307965742d626c75653f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/pubvana/backups)[![License](https://camo.githubusercontent.com/4f65e536a0ea907a664b2e744c853202b01d023e1b150944a97b939c358679bd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f70756276616e612f6261636b7570733f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/pubvana/backups)[![PHP Version](https://camo.githubusercontent.com/a26a04f46bf5ce02100fefd1a295cd9f33a8366acc1b50e0b8a218eebe12793d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f70756276616e612f6261636b7570733f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/pubvana/backups)[![Monthly Downloads](https://camo.githubusercontent.com/8ababae9b7efafb03d2c229e675a225912f23675b99385bca9f91ff18df808fa/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f70756276616e612f6261636b7570733f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/pubvana/backups)[![Total Downloads](https://camo.githubusercontent.com/bf9dc96d317f1c6ec3bb8d7b8b13ada39e785a1760c6915974d22b92e23192ec/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f70756276616e612f6261636b7570733f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/pubvana/backups)[![GitHub Issues](https://camo.githubusercontent.com/60947a28cacf9e8b1b6c00c6b781edb67d648e74183ed41a415004e9297b1eab/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f50756276616e612d434d532f6261636b7570733f7374796c653d666f722d7468652d6261646765)](https://github.com/Pubvana-CMS/backups/issues)[![Contributors](https://camo.githubusercontent.com/79dafa47f182b874de5e1fe9b3ae664544c6518f1ee1882787d9867a3943f782/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f50756276616e612d434d532f6261636b7570733f7374796c653d666f722d7468652d6261646765)](https://github.com/Pubvana-CMS/backups/graphs/contributors)[![Latest Release](https://camo.githubusercontent.com/d6c3ec3452554328d056010ebb36d437bb39b84374e2df22115a81ba06d6003d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f50756276616e612d434d532f6261636b7570733f7374796c653d666f722d7468652d6261646765)](https://github.com/Pubvana-CMS/backups/releases)[![Contributions Welcome](https://camo.githubusercontent.com/9db3f8b82ea88469efd296a9305fc00f40b4c9450bb6b539d42d339fa6963444/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f6e747269627574696f6e732d77656c636f6d652d626c75653f7374796c653d666f722d7468652d6261646765)](https://github.com/Pubvana-CMS/backups/pulls)

Pubvana Backups
===============

[](#pubvana-backups)

**I noticed folks downloading some of these packages. I'm super grateful, Thank You! I would like to let folks know until this notice disappears I'm doing a lot of breaking changes without worrying about them. Once versions are up around 0.5.x things should settle down.**

Backup and restore module for [Pubvana](https://pubvanacms.com) CMS.

Requirements
------------

[](#requirements)

- PHP 8.1+
- [Flight School](https://github.com/enlivenapp/flight-school) ^0.3
- [Flight Shield](https://github.com/enlivenapp/flight-shield) ^0.2
- [Flight CSRF](https://github.com/enlivenapp/flight-csrf) ^0.1

Installation
------------

[](#installation)

```
composer require pubvana/backups
```

Enable in `app/config/config.php`:

```
'plugins' => [
    'pubvana/backups' => [
        'enabled'  => true,
        'priority' => 50,
    ],
],
```

Features
--------

[](#features)

- Full-site zip backups (configurable directories + database dump)
- Restore from any backup with automatic pre/post-rollback snapshots
- Retention policy (configurable max backups, default 15)
- Protected config files never overwritten during restore
- Dual-mode database operations (mysqldump/mysql CLI with pure PHP fallback)
- File-based progress reporting for admin UI polling
- Background execution via runway CLI with synchronous fallback
- Path traversal validation on zip extraction

Flight School config
--------------------

[](#flight-school-config)

This package uses Flight School's return-array config format. `src/Config/Config.php` returns the package defaults as an array, Flight School stores that array under `pubvana.backups` on `$app`.

Service
-------

[](#service)

Mapped as `$app->backups()`. Provides:

- **Create** - full-site zip (configurable dirs + database dump), with progress callback
- **Restore** - backup current state, extract, restore files + DB, backup restored state
- **List/Delete/Download** - manage stored backups
- **Retention** - automatically removes oldest backups beyond the configured limit

Config
------

[](#config)

KeyDefaultDescription`backup_path``PROJECT_ROOT . '/backups'`Directory where backup zips are stored`max_backups``15`Maximum backups to keep`backup_dirs``['app', 'public', 'vendor', 'themes']`Directories included in the backup`protected_configs``['app/config/config.php', 'app/config/config_sample.php']`Files never overwritten during restoreCLI Commands
------------

[](#cli-commands)

```
php runway backups:create
php runway backups:create --trigger pre-update --user admin
php runway backups:restore 2026-05-15_221300-full.zip
php runway backups:restore 2026-05-15_221300-full.zip --user admin
```

License
-------

[](#license)

MIT

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance86

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

70d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3036663?v=4)[Mike W](/maintainers/enlivenapp)[@enlivenapp](https://github.com/enlivenapp)

---

Top Contributors

[![enlivenapp](https://avatars.githubusercontent.com/u/3036663?v=4)](https://github.com/enlivenapp "enlivenapp (3 commits)")

---

Tags

backupcmsrestoreflightphpPubvana

### Embed Badge

![Health badge](/badges/pubvana-backups/health.svg)

```
[![Health](https://phpackages.com/badges/pubvana-backups/health.svg)](https://phpackages.com/packages/pubvana-backups)
```

###  Alternatives

[craftcms/aws-s3

Amazon S3 integration for Craft CMS

631.5M29](/packages/craftcms-aws-s3)[weareferal/remote-backup

Backup your database and assets to a remote location

115.5k](/packages/weareferal-remote-backup)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)