README

What is this project about

You have background tasks for your project? You want to code them in PHP? You need a simple framework to attach your tasks to?

Please try out my wrapper for your daemon tasks.

How to use it

That is quite simple, have a look at the example daemon to get an idea what you need to implement.

Integrate it via composer into project

composer require firegate666/daemon

Create your own daemon handler and daemon handler factory be implementing HandlerInterface and HandlerInterfaceFactory. Setup your own startup php script, see exampled.php

setup with start-stop-daemon

Copy your own init script to /etc/init.d/, see etc/init.d/exampled.daemon.sh.

setup with supervisor

Download and install Supervisord. On Ubuntu or similar it is quite easy to use apt-get install. Copy your supervisor configuration to /etc/supervisor/conf.d/, see etc/supervisor/conf.d/exampled.conf. Copy your own init script to /etc/init.d/, see etc/init.d/exampled.supervisor.sh.

control it

Now you can control your daemon

/etc/init.d/exampled start
/etc/init.d/exampled stop
/etc/init.d/exampled restart
/etc/init.d/exampled status    

How does this thing work

Via a command line sript you can start up the daemon, see exampled.php. Write your own handler and factory and inject them into the daemon. When the daemon starts up, he forks 4 child processes with your pre-defined handler. If one child goes down, a new one is started. Each child process has its own handler instance and starts the run loop.

If the daemon itself receives a shutdown signal (SIGTERM, SIGINT), this signal is dispatched to his children and the daemon waits for their termination before he goes down himself.

ToDos

• too many children died in short amount of time detection
• proper log messages and levels
• define guidelines for levels