PHPackages                             visualappeal/php-auto-update - 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 &amp; Helpers](/categories/utility)
4. /
5. visualappeal/php-auto-update

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

visualappeal/php-auto-update
============================

Autoupdater for PHP

1.0.3(7mo ago)24136.3k↓25%68[3 issues](https://github.com/VisualAppeal/PHP-Auto-Update/issues)[1 PRs](https://github.com/VisualAppeal/PHP-Auto-Update/pulls)MITPHPPHP &gt;=7.2.0

Since Feb 14Pushed 7mo ago30 watchersCompare

[ Source](https://github.com/VisualAppeal/PHP-Auto-Update)[ Packagist](https://packagist.org/packages/visualappeal/php-auto-update)[ RSS](/packages/visualappeal-php-auto-update/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (29)Used By (0)

[![PHPUnit](https://github.com/VisualAppeal/PHP-Auto-Update/actions/workflows/phpunit.yml/badge.svg)](https://github.com/VisualAppeal/PHP-Auto-Update/actions/workflows/phpunit.yml)

With this library your users can automatically update their instance of your application to the newest version. I created it as a proof of concept and don't know if it is used somewhere. So please use this library with caution because it can potentially make your users software nonfunctional if something goes wrong.

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

[](#installation)

- Install the library via composer [visualappeal/php-auto-update](https://packagist.org/packages/visualappeal/php-auto-update)
- Create an update file/method in your application with your update routine (see `example/client/update/index.php`)
- Create a `update.json` or `update.ini` on your server (where the client should get the updates, see `example/server/update.json` or `example/server/update.ini`)

**Important: Please notice that PHP needs write permissions to update the files on the webserver**

Example
-------

[](#example)

You can start an example docker container via `docker-compose up` and see the example by visiting `http://127.0.0.1:8080/example/client/`

Client
------

[](#client)

### Caching

[](#caching)

The library supports the `desarrolla2/cache` component, and you should use it! Otherwise, the client will download the update ini/json file on every request.

Server
------

[](#server)

Your server needs at least one file which will be downloaded from the client to check for updates. This can be a json or an ini file. See `example/server/` for examples. The ini section key respectively the json key is the version. This library uses semantic versioning to compare the versions. See [semver.org](http://semver.org/) for details. The ini/json value is the absolute url to the update zip file. Since the library supports incremental updates, the zip file only need to contain the changes since the last version. The zip files do not need to be placed on the same server, they can be uploaded to S3 or another cloud storage, too.

Documentation
-------------

[](#documentation)

For the documentation see the comments in `src/AutoUpdate.php` or the example in the `example` directory.

###  Health Score

55

—

FairBetter than 98% of packages

Maintenance65

Regular maintenance activity

Popularity45

Moderate usage in the ecosystem

Community28

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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

Recently: every ~433 days

Total

27

Last Release

211d ago

Major Versions

0.15.0 → 1.0.02021-09-16

PHP version history (8 changes)0.9.0PHP &gt;= 5.3.0

0.9.3PHP &gt;= 5.5.9

0.9.7PHP &gt;= 5.6.4

0.10.1PHP &gt;= 7.0.0

0.12.0PHP &gt;= 7.1.0

0.13.0PHP ^7.3.0

0.13.1PHP ^7.2.0

0.14.0PHP &gt;=7.2.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/81e28043849dc03142de395d05318c70cb408e645ebd5a3985ab5896c30951e0?d=identicon)[thelfensdrfer](/maintainers/thelfensdrfer)

---

Top Contributors

[![fabiante](https://avatars.githubusercontent.com/u/7669818?v=4)](https://github.com/fabiante "fabiante (9 commits)")[![jitheshgopan](https://avatars.githubusercontent.com/u/1967336?v=4)](https://github.com/jitheshgopan "jitheshgopan (6 commits)")[![migliori](https://avatars.githubusercontent.com/u/7558100?v=4)](https://github.com/migliori "migliori (3 commits)")[![omarhen](https://avatars.githubusercontent.com/u/5448144?v=4)](https://github.com/omarhen "omarhen (2 commits)")[![Metallizzer](https://avatars.githubusercontent.com/u/691719?v=4)](https://github.com/Metallizzer "Metallizzer (2 commits)")[![tikky](https://avatars.githubusercontent.com/u/546755?v=4)](https://github.com/tikky "tikky (1 commits)")[![0legKolomiets](https://avatars.githubusercontent.com/u/5287629?v=4)](https://github.com/0legKolomiets "0legKolomiets (1 commits)")[![ttimot24](https://avatars.githubusercontent.com/u/10697800?v=4)](https://github.com/ttimot24 "ttimot24 (1 commits)")[![janolivermr](https://avatars.githubusercontent.com/u/11133832?v=4)](https://github.com/janolivermr "janolivermr (1 commits)")[![kieronsutton00](https://avatars.githubusercontent.com/u/16363185?v=4)](https://github.com/kieronsutton00 "kieronsutton00 (1 commits)")[![r23](https://avatars.githubusercontent.com/u/396063?v=4)](https://github.com/r23 "r23 (1 commits)")[![robinflyhigh](https://avatars.githubusercontent.com/u/275138?v=4)](https://github.com/robinflyhigh "robinflyhigh (1 commits)")

---

Tags

auto-updatephp

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/visualappeal-php-auto-update/health.svg)

```
[![Health](https://phpackages.com/badges/visualappeal-php-auto-update/health.svg)](https://phpackages.com/packages/visualappeal-php-auto-update)
```

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.4k37.3k](/packages/matomo-matomo)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[elgg/elgg

Elgg is an award-winning social networking engine, delivering the building blocks that enable businesses, schools, universities and associations to create their own fully-featured social networks and applications.

1.7k15.7k5](/packages/elgg-elgg)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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