Download the PHP package jeffersongoncalves/laravel-zero-self-update without Composer

laravel-zero-self-update

Reusable self-update service and base command for Laravel Zero CLIs that are distributed as a single-file PHAR via GitHub Releases.

Most Laravel Zero PHAR tools end up shipping the exact same self-update logic: read the current version, hit the GitHub "latest release" API, compare versions, download the .phar asset, back up the running PHAR and atomically swap it in. This package extracts that logic into one well-tested service (PharUpdater) plus an abstract self-update command base, so each CLI only has to declare its repository, asset name and version.

Installation

Requires PHP ^8.2, guzzlehttp/guzzle ^7.10 and illuminate/console ^11|^12.

Usage

Base command

In your Laravel Zero app, create a command that extends the base and implements the three abstract methods. Override currentVersion() to read your app version from config.

That gives you a self-update command:

Self-update only runs when the app is executed as a PHAR; otherwise it tells the user to update via Git or Composer.

Service directly

You can also use PharUpdater on its own:

A custom Guzzle Client can be injected as the last constructor argument (handy for testing or proxies).

Public classes

PharUpdater methods

• getCurrentVersion(): string
• isRunningAsPhar(): bool
• getLatestRelease(): array{tag: string, url: string}
• isUpdateAvailable(string $current, string $latest): bool
• download(string $url): string
• replacePhar(string $tempFile): void
• isValidPhar(string $path): bool

Testing

License

MIT. See LICENSE.