PHPackages                             xltrace/upgrade - 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. [Utility & Helpers](/categories/utility)
4. /
5. xltrace/upgrade

ActiveLibrary[Utility & Helpers](/categories/utility)

xltrace/upgrade
===============

rudementairy upgrade script

v0.7.2(5y ago)03apache-2.0PHPPHP ^5.2 || ^7.0 || ^8.0

Since Apr 25Pushed 5y ago1 watchersCompare

[ Source](https://github.com/xltrace/upgrade)[ Packagist](https://packagist.org/packages/xltrace/upgrade)[ RSS](/packages/xltrace-upgrade/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (10)Used By (0)

Hades Upgrade
=============

[](#hades-upgrade)

This script is meant to be a single file upgrader. Able to reconstruct the relevant configuration of the application.

```
$ php -f upgrade.php upgrade.json

```

upgrade.json
------------

[](#upgradejson)

Each file postfixed with `upgrade.json` can be accepted by the script to run.

```
{
	".": "https://path.to/somewhere/raw/",
	"upgrade.php": true
}
```

`.` can refer to a raw collection like one github provides, or any other repository. You can include files and directories.

shortalias of instructionsdescription`true``{"create":true,"clear":true}`file or map will be completely replaced`null``{"create":true,"clear":false}`file or map will be created if not yet exists`false``{"delete":true}`file or map (and all its contents) will be removed*target*`{"move":"*target*"}`file or map will be renamed to *target*Within the instructions you could include other functional flags: `mtime`, `chmod`, `user`, `group`. The file `composer.phar` can be combined with the flags: `upgrade` (for self-upgrade), `update` (for (re-)install).

NOTE: the above *target*, `user`, `group` is not yet implemented!

\\XLtrace\\Hades\\upgrade($file)
--------------------------------

[](#xltracehadesupgradefile)

This method allows to execute a particular upgrade-request.

\\XLtrace\\Hades\\composer($action)
-----------------------------------

[](#xltracehadescomposeraction)

This method enables a wrapper-function to **composer.phar**. The actions *install* and *self-update* have been tested. Other actions are experimental!

\\XLtrace\\Hades\\backup($file=NULL, $mode=TRUE)
------------------------------------------------

[](#xltracehadesbackupfilenull-modetrue)

This method creates an zip-archive to save (a selection of) the application-directory. When no $file is given, it will return the raw data of the zip-archive.

$file$modedescriptionresult*filename*- / `TRUE`sets the filename, and (default) `$mode=TRUE``{"file":"`*filename*`","all":true}``{...}`-assumes the input is a welformed configuration array, to set as $mode`TRUE`selects all files: `{"all":true}``{"all":true,"select":[`...`]}``NULL`selects all upgradable files: `{"upgradable":true}``{"upgradable":true,"select":[`...`]}``FALSE`selects all non-upgradable files: `{"upgradable":false}``{"upgradable":false,"select":[`...`]}`With `$mode = \XLtrace\Hades\backup_conf()` — called by backup — you improve the configuration of the backup-method, into an **array**.

flagtypedescriptionfileuripath to the zip-fileall`TRUE`shortcut to select all filesupgradableboolshortcut to select the (non-)upgradable files, based upon the `*upgrade.json`-filesbyuripath to the `*upgrade.json` file, used to populate the select-arrayselectstringfixes the forgotten setting of *by*selectarraya list of files to include in the archivedebug`TRUE`adds flags to debug the shortcut *upgradable*: `upgrade.json` + `upgrade-files`ignorearraya list of files/maps to ignore the search. By default `.git/` and `vendor/` is ignored

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 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 ~2 days

Total

9

Last Release

1830d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16780798?v=4)[XLtrace](/maintainers/xltrace)[@xltrace](https://github.com/xltrace)

---

Top Contributors

[![sentfanwyaerda](https://avatars.githubusercontent.com/u/3115395?v=4)](https://github.com/sentfanwyaerda "sentfanwyaerda (19 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/xltrace-upgrade/health.svg)

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

###  Alternatives

[league/iso3166

ISO 3166-1 PHP Library

69536.3M116](/packages/league-iso3166)[typo3-themes/themes

TYPO3 THEMES

3642.6k2](/packages/typo3-themes-themes)[jfcherng-roundcube/cloudview

A Roundcube plugin which lets you view documents with cloud viewer.

101.1k](/packages/jfcherng-roundcube-cloudview)

PHPackages © 2026

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