Download the PHP package thesis/hot-reload without Composer
On this page you can find all versions of the php package thesis/hot-reload. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package hot-reload
Thesis Hot Reload
Watches files for changes and automatically restarts a command.
Useful for development servers, workers, or any long-running PHP tasks.
Supports debouncing to avoid redundant restarts when multiple files change at once.
Installation
Requires PHP 8.4+.
Usage
Options
| Option | Description | Default |
|---|---|---|
--path |
Paths to watch (repeatable) | src |
--ext |
File extensions to watch (repeatable; if none, all are watched) | none |
--exclude |
Patterns to exclude (repeatable, e.g. *.generated.php) |
none |
--debounce |
Delay in seconds before restarting after a change | 0.1 |
--term-timeout |
Seconds to wait for the process to exit after SIGTERM before sending SIGKILL |
3 |
--forward-signal |
Signals to forward to the process (repeatable, e.g. SIGUSR1 or 10) |
none |
Exit code
vendor/bin/hot-reload returns the exit code of the watched command if it terminated on its own, or 0 when stopped
via SIGINT or SIGTERM.
Examples
PHP API
You can use hotReload() directly in PHP instead of the bin script:
$termination is cancelled when files change or when hotReload() itself is cancelled — subscribe to it to stop the
task gracefully.
TransparentProcess
Use TransparentProcess::start() to run an external command with full TTY transparency:
- stdin/stdout/stderr are inherited
- specified signals are forwarded
- the process is terminated gracefully via
SIGTERM SIGKILLis dispatched after a timeout.
See bin/hot-reload for a real-world usage example.
Roadmap
- [ ] inotify-based change detector for Linux (event-driven, no polling)
License
MIT
All versions of hot-reload with dependencies
ext-pcntl Version *
amphp/amp Version ^3.0
revolt/event-loop Version ^1.0
symfony/console Version ^7.0 || ^8.0
thesis/exceptionally Version ^0.3.0