PHPackages katsana/minions-server - 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 & Helpers](/categories/utility) 4. / 5. katsana/minions-server ActiveLibrary[Utility & Helpers](/categories/utility) katsana/minions-server ====================== Minions Component Server using ReactPHP v1.1.2(5y ago)321.0k↓33.3%1[1 issues](https://github.com/katsana/minions-server/issues)MITPHP Since Jan 25Pushed 3mo ago3 watchersCompare [ Source](https://github.com/katsana/minions-server)[ Packagist](https://packagist.org/packages/katsana/minions-server)[ RSS](/packages/katsana-minions-server/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (5)Dependencies (10)Versions (7)Used By (0) Minions Component Server using ReactPHP ======================================= [](#minions-component-server-using-reactphp) [![Build Status](https://camo.githubusercontent.com/dd2c4af0cecbc7ffcc10f8fbe3a5364b088deb7e44f7951effa6a5f7598b9689/68747470733a2f2f7472617669732d63692e6f72672f6b617473616e612f6d696e696f6e732d7365727665722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/katsana/minions-server)[![Latest Stable Version](https://camo.githubusercontent.com/9f50ce30330ca77e8b88722fd894022b4f68072d4eeac81a30c25baf0e33667b/68747470733a2f2f706f7365722e707567782e6f72672f6b617473616e612f6d696e696f6e732d7365727665722f762f737461626c65)](https://packagist.org/packages/katsana/minions-server)[![Total Downloads](https://camo.githubusercontent.com/96d9472b017a093c36d0eddab0c11c6c6a6790e2e7b0e9f631c13ff3c9387bbf/68747470733a2f2f706f7365722e707567782e6f72672f6b617473616e612f6d696e696f6e732d7365727665722f646f776e6c6f616473)](https://packagist.org/packages/katsana/minions-server)[![Latest Unstable Version](https://camo.githubusercontent.com/0df7d9106530984a53331a7af5c6a90fe1f4442da498205727b0f2d1ea534332/68747470733a2f2f706f7365722e707567782e6f72672f6b617473616e612f6d696e696f6e732d7365727665722f762f756e737461626c65)](https://packagist.org/packages/katsana/minions-server)[![License](https://camo.githubusercontent.com/0a5a6fc0e1b572dc54e4ea49b45511978bc350e4f63db13933a89a70fc9a82ee/68747470733a2f2f706f7365722e707567782e6f72672f6b617473616e612f6d696e696f6e732d7365727665722f6c6963656e7365)](https://packagist.org/packages/katsana/minions-server)[![Coverage Status](https://camo.githubusercontent.com/61e8ed072370c6f8c45e22df1a8bc477ff1f6333e5681a50e461cf2dd2c8dba9/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6b617473616e612f6d696e696f6e732d7365727665722f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/katsana/minions-server?branch=master) - [Installation](#installation) - [Usages](#usages) - [Configurations](#configurations) - [Keeping the socket server running with supervisord](#keeping-the-socket-server-running-with-supervisord) Installation ------------ [](#installation) Minions can be installed via composer: ``` composer require "katsana/minions-server=^1.0" ``` Please ensure that you already install **Minions** and go through the [installation and setup documentation](https://github.com/katsana/minions). Usages ------ [](#usages) **Minion Server** will run the RPC Server using ReactPHP running from Artisan command. You can start the RPC server by issuing the artisan command: ``` php artisan minions:serve ``` ### Configurations [](#configurations) You can export the default `minions-server.php` to your project directory via the following command: ``` php artisan vendor:publish --provider="Minions\Server\MinionsServiceProvider" --tag="config" ``` #### Using a different port [](#using-a-different-port) The default port of the RPC server is `8085`. You may set a different port by updating the environment file (or `config/minions.php`). ``` MINION_SERVER_PORT=8081 ``` #### Restricting the listening host [](#restricting-the-listening-host) By default, the RPC server will listen on `127.0.0.1` and will **only** allow incoming connections from local networks. If you want to expose this, you set a different host updating the environment file (or `config/minions.php`). ``` MINION_SERVER_HOST='0.0.0.0' ``` ### Keeping the socket server running with supervisord [](#keeping-the-socket-server-running-with-supervisord) The `minions:serve` daemon needs to always be running in order to accept connections. This is a prime use case for `supervisor`, a task runner on Linux. First, make sure `supervisor` is installed. ``` # On Debian / Ubuntu apt install supervisor # On Red Hat / CentOS yum install supervisor systemctl enable supervisor ``` Once installed, add a new process that supervisor needs to keep running. You place your configurations in the `/etc/supervisor/conf.d` (Debian/Ubuntu) or `/etc/supervisord.d` (Red Hat/CentOS) directory. Within that directory, create a new file called `minions.conf`. ``` [program:minion] command=/usr/bin/php /home/project/artisan minions:serve numprocs=1 autostart=true autorestart=true ``` Once created, instruct `supervisor` to reload it's configuration files (without impacting the already running `supervisor` jobs). ``` supervisorctl update supervisorctl start minion ``` Your RPC server should now be running (you can verify this with `supervisorctl status`). If it were to crash, `supervisor` will automatically restart it. Please note that, by default, `supervisor` will force a maximum number of open files onto all the processes that it manages. This is configured by the `minfds` parameter in `supervisord.conf`. If you want to increase the maximum number of open files, you may do so in `/etc/supervisor/supervisord.conf` (Debian/Ubuntu) or `/etc/supervisord.conf` (Red Hat/CentOS): ``` [supervisord] minfds=10240; (min. avail startup file descriptors;default 1024) ``` After changing this setting, you'll need to restart the `supervisor` process (which in turn will restart all your processes that it manages). ### Health Score 40 — FairBetter than 88% of packages Maintenance46 Moderate activity, may be stable Popularity28 Limited adoption so far Community13 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 94.6% 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 ~362 days Recently: every ~442 days Total 6 Last Release 491d ago Major Versions v1.1.2 → 3.x-dev2025-01-13 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/172966?v=4)[Mior Muhammad Zaki](/maintainers/crynobone)[@crynobone](https://github.com/crynobone) --- Top Contributors [![crynobone](https://avatars.githubusercontent.com/u/172966?v=4)](https://github.com/crynobone "crynobone (35 commits)")[![aneip](https://avatars.githubusercontent.com/u/4075733?v=4)](https://github.com/aneip "aneip (1 commits)")[![maxerism](https://avatars.githubusercontent.com/u/17924164?v=4)](https://github.com/maxerism "maxerism (1 commits)") --- Tags json-rpcjson-rpc-serverjson-rpc2laravel ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/katsana-minions-server/health.svg) ``` [![Health](https://phpackages.com/badges/katsana-minions-server/health.svg)](https://phpackages.com/packages/katsana-minions-server) ``` ### Alternatives [react/react ReactPHP: Event-driven, non-blocking I/O with PHP. 9.1k3.6M63](/packages/react-react)[yajra/laravel-datatables-buttons Laravel DataTables Buttons Plugin. 2629.1M54](/packages/yajra-laravel-datatables-buttons)[clue/docker-react Async, event-driven access to the Docker Engine API, built on top of ReactPHP. 113154.9k1](/packages/clue-docker-react)[clue/reactphp-eventsource Instant real-time updates. Lightweight EventSource client receiving live messages via HTML5 Server-Sent Events (SSE). Fast stream processing built on top of ReactPHP's event-driven architecture. 5818.5k3](/packages/clue-reactphp-eventsource)[interaction-design-foundation/laravel-geoip Support for multiple Geographical Location services. 17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[tehwave/laravel-achievements Simple, elegant Achievements the Laravel way 7012.8k](/packages/tehwave-laravel-achievements) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)