PHPackages                             rimote/updater - 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. [DevOps & Deployment](/categories/devops)
4. /
5. rimote/updater

ActiveLibrary[DevOps & Deployment](/categories/devops)

rimote/updater
==============

Update utility that can be called by a deployment script, able to perform installation specific configuration, database updates and/or rollbacks.

v0.1-alpha(12y ago)311PHP

Since Apr 3Pushed 12y ago1 watchersCompare

[ Source](https://github.com/EnnioWolsink/updater)[ Packagist](https://packagist.org/packages/rimote/updater)[ RSS](/packages/rimote-updater/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

Updater
=======

[](#updater)

PHP command line utility that can be called by a deployment script, able to perform installation specific configuration, database updates and/or rollbacks.

It performs the following tasks:

- Perform database operations using PDO, required to update and/or rollback the database of a project's installation to a newer version

In the future the following tasks will be supported:

- Process custom PHP update scripts
- Rollback/update multiple versions in a chain
- Surgical rollback by keeping track of the individual steps in an update that failed

Config
------

[](#config)

### Update packages

[](#update-packages)

Updater expects you to provide a version number as well as a path to a local directory with update packages. Each update package is a subdirectory containing a credentials file, as well as SQL schemas for updating and/or rollbacking the database.

For example:

```
updates
 |
 \--- 1.2.0
 |      |
 |      \--- db_credentials.php
 |      \--- db_changes.sql
 |      \--- db_rollback.sql
 \--- 1.2.1
 |     |
 |     \--- db_credentials.php
 |     \--- db_changes.sql
 |     \--- db_rollback.sql
etc...

```

The SQL files must contain fully formed SQL commands that PHP's PDO::query() method can execute independently, one at a time.

The db\_credentials.php needs to return an array like so:

```
return array(
    'dsn' => 'mysql:dbname=database_name;host=hostname',
    'username' => 'username',
    'password' => 'password'
);

```

### Install PHP composer

[](#install-php-composer)

You can download Composer using:

```
$ curl -s https://getcomposer.org/installer | php

```

This will install a composer.phar script in the current directory. This file can be added to .gitignore, so you can keep it locally.

Usage
-----

[](#usage)

Run the app from the command line using `app/console`. Use the following to see a list of commands:

```
$ app/console list

```

### Run update

[](#run-update)

```
$ app/console update

```

### Perform rollback

[](#perform-rollback)

```
$ app/console rollback

```

Developer Guide
---------------

[](#developer-guide)

### Dependencies

[](#dependencies)

This project requires PHP 5.3+. All external libraries can be installed using Composer:

```
$ php composer.phar install # Install all dependencies to your machine

```

Remember to periodically run the following command to update vendor software:

```
$ php composer.phar update

```

### Tests

[](#tests)

Run the tests using PHPUnit:

```
$ phpunit

```

Generate code coverage HTML:

```
$ phpunit --coverage-html ./phpunit-reports

```

Troubleshooting
---------------

[](#troubleshooting)

Updated whenever problems and solutions arise.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

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

Unknown

Total

1

Last Release

4419d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/09899d79e75c30d9b7692fc119b2e800aea745cbb7724540adc1644ff7a7ec60?d=identicon)[EnnioWolsink](/maintainers/EnnioWolsink)

### Embed Badge

![Health badge](/badges/rimote-updater/health.svg)

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

###  Alternatives

[wsdltophp/packagegenerator

Generate hierarchical PHP classes based on a WSDL

4351.9M19](/packages/wsdltophp-packagegenerator)[shopware/deployment-helper

Shopware deployment tools

19305.3k5](/packages/shopware-deployment-helper)[drevops/git-artifact

Package artifact from your codebase in CI and push it to a separate git repo.

2133.2k](/packages/drevops-git-artifact)[benjam1/symfttpd

PHP webserver

151.7k](/packages/benjam1-symfttpd)

PHPackages © 2026

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