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

1833d 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

[illuminate/conditionable

The Illuminate Conditionable package.

9043.1M32](/packages/illuminate-conditionable)[codingfreaks/cf-cookiemanager

Manage cookies, scripts, and GDPR compliance on your Typo3 website with CodingFreaks Typo3 Cookie Manager. Customize cookie banners, streamline workflow, and enhance user experience. Ensure GDPR compliance and take control of cookie management with our Typo3 cookie management extension. Visit the official Typo3 Documentation page to learn more.

1625.8k](/packages/codingfreaks-cf-cookiemanager)

PHPackages © 2026

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