psa-orderform/update-server

PHP Update Server

This folder can be deployed as the central update server.

Release ZIPs can be managed through manage.php:

1. Copy config.sample.php to config.php.
2. Change UPDATE_SERVER_PASSWORD.
3. Set UPDATE_SERVER_PACKAGE_PREFIX to the project/package name.
4. Open index.php or manage.php, log in with the configured password, and upload a ZIP with a vX.Y.Z version.

The management UI stores the ZIP under packages/, calculates SHA-256 and size, and updates manifest.json.

Manual release management is also possible:

1. Put the package under packages/, for example packages/my-app-v1.3.3.zip.
2. Calculate its SHA-256 checksum and byte size.
3. Edit manifest.json and set latest to the version clients should install.

Example release entry:

{
    "latest": "v1.3.3",
    "releases": {
        "v1.3.3": {
            "version": "v1.3.3",
            "package": "packages/my-app-v1.3.3.zip",
            "sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
            "size": 123456,
            "published_at": "2026-06-23T00:00:00+00:00"
        }
    }
}

Clients should use manifest.php, not manifest.json, as their UPDATE_MANIFEST_URL.

The server code is intentionally project-agnostic. To reuse it in another PHP project, copy this folder, keep includes/update-server.php with the public PHP files, and adjust only config.php.