PHPackages                             lotharthesavior/hot-reactor - 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. lotharthesavior/hot-reactor

ActiveLibrary

lotharthesavior/hot-reactor
===========================

Hot Reload Tool.

0.0.4(2y ago)027MITPHP

Since Apr 14Pushed 2y ago1 watchersCompare

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

READMEChangelogDependencies (7)Versions (5)Used By (0)

Hot Reactor
===========

[](#hot-reactor)

Hot Reactor is Hot Reload mechanism for applications. It is built with OpenSwoole development in mind, but it reloads specific commands based on the file changes.

You can install it via composer install or download the project and arrange the `.env` file with the proper settings.

Setup
-----

[](#setup)

There are 2 ways to run the Hot Reactor:

### Option 1: run other folders

[](#option-1-run-other-folders)

To run services located in other directories:

Check the `.env` file for the settings you need to update. The following are the steps to follow:

- Step 1: update the `WORKING_DIR` environment setting, to point to the directory where the service is located. `default: /var/www/html/`
- Step 2: update the `COMMAND` environment setting, to point to the command you want to run. `default: /usr/bin/php server.php`
- Step 3: update the `OBJECTS` environment setting, to point to the files you want to watch for changes. `default: /var/www/html/|/var/www/html/features/`
- Step 4: update the `MAIN_PROCESS_NAME` environment setting, to customzie your main process name. `default: hot-reactor`
- Step 5: update `FILE_EXTENSIONS` environment setting, to specify the file extensions to watch for changes. `default: php|env`

Hot Reactor comes with a command line tool to run the Hot Reactor. You can run the following command to start the Hot Reactor:

```
php index.php -w "/path/to/your/service" -c "your-command" -o "your-objects"
```

> As in the example, you can also overwrite the `WORKING_DIR`, `COMMAND` and `OBJECTS` settings via command options.

Option 2: install hot reloaded via composer
-------------------------------------------

[](#option-2-install-hot-reloaded-via-composer)

To install Hot Reactor via composer, you can run the following command:

```
composer require lotharthesavior/hot-reactor
```

After installing the package, you can run the following command to start the Hot Reactor:

```
vendor/bin/hot-reactor -w "/path/to/your/service" -c "your-command" -o "your-objects"
```

---

> **Important**: There is a bug related to when you want to restart an app running sub processes with OpenSwoole\\Process. Then, you might need to wait for a SIGKILL at the end of the file so the app restarts gracefully. You do that by adding the following code:
>
> ```
> Co::run(function () {
>     System::waitSignal(SIGKILL, -1);
> });
> ```

---

Contributors
------------

[](#contributors)

We welcome contributions from everyone! If you're interested in helping improve Hot Reactor, please follow these steps:

1. Fork the repository on GitHub.
2. Make your changes in a branch named for the feature or fix you're working on.
3. Submit a pull request through GitHub for review.

Please make sure your contributions adhere to the following guidelines:

- Code contributions should follow the coding style already established in the project.
- Include comments in your code where necessary to explain complex or non-obvious parts.
- Update the README.md if your changes require it.
- Ensure that your code does not introduce any new bugs or security vulnerabilities.

Thank you for considering contributing to Hot Reactor!

License
-------

[](#license)

Hot Reactor is open-source software licensed under the MIT license. See the [LICENSE](LICENSE.md) file for more details.

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance31

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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

Total

4

Last Release

735d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/90c2bdf7a2fb985ab0c72c842c4f7cbff79cb172deb85c06edf0bedceb3c9498?d=identicon)[lotharthesavior](/maintainers/lotharthesavior)

---

Top Contributors

[![lotharthesavior](https://avatars.githubusercontent.com/u/1092909?v=4)](https://github.com/lotharthesavior "lotharthesavior (16 commits)")

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/lotharthesavior-hot-reactor/health.svg)

```
[![Health](https://phpackages.com/badges/lotharthesavior-hot-reactor/health.svg)](https://phpackages.com/packages/lotharthesavior-hot-reactor)
```

###  Alternatives

[behat/behat

Scenario-oriented BDD framework for PHP

4.0k96.8M1.9k](/packages/behat-behat)[laravel-zero/framework

The Laravel Zero Framework.

3371.4M368](/packages/laravel-zero-framework)[phpro/soap-client

A general purpose SoapClient library

8885.6M46](/packages/phpro-soap-client)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19462.3M1.3k](/packages/drupal-core)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)

PHPackages © 2026

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