Update readme and composer file

Author: luzrain

README.md

@@ -1,14 +1,11 @@
 # PhpRunner runtime for symfony applications
 ![PHP >=8.2](https://img.shields.io/badge/PHP->=8.2-777bb3.svg?style=flat)
-![Symfony ^6.4|^7.0](https://img.shields.io/badge/Symfony-^7.0-374151.svg?style=flat)
+![Symfony ^7.0](https://img.shields.io/badge/Symfony-^7.0-374151.svg?style=flat)
 [![Version](https://img.shields.io/github/v/tag/luzrain/phprunner-bundle?label=Version&filter=v*.*.*&sort=semver&color=374151)](../../releases)
 [![Tests Status](https://img.shields.io/github/actions/workflow/status/luzrain/phprunner-bundle/tests.yaml?label=Tests&branch=master)](../../actions/workflows/tests.yaml)
 
 This bundle provides a [PhpRunner](https://github.com/luzrain/phprunner) integration with Symfony framework to run your application in a highly efficient event-loop based runtime.  
 
-> [!NOTE]  
-> This tool is in development now
-
 ## Getting started
 ### Install composer packages
 ```bash
@@ -38,16 +35,9 @@ $ bin/console config:dump-reference phprunner
 
 phprunner:
   servers:
-    - name: 'Symfony webserver'
+    - name: 'Webserver'
       listen: http://0.0.0.0:80
       processes: 4
-
-  reload_strategy:
-    exception:
-      active: true
-
-    file_monitor:
-      active: true
 ```
 
 ### Start application
@@ -58,18 +48,24 @@ $ APP_RUNTIME=Luzrain\\PhpRunnerBundle\\Runtime php public/index.php start
 \* For better performance, install the _php-uv_ extension.
 
 ## Reload strategies
-Because of the asynchronous nature of the server, the workers reuse loaded resources on each request. This means that in some cases we need to restart workers.  
-For example, after an exception is thrown, to prevent services from being in an unrecoverable state. Or every time you change the code in the IDE.  
-There are a few restart strategies that are implemented and can be enabled or disabled depending on the environment.
-
-- **exception**  
-  Reload worker each time that an exception is thrown during the request handling.
-- **max_requests**  
-  Reload worker on every N request to prevent memory leaks.
-- **file_monitor**  
-  Reload all workers each time you change the files**.
-- **always**  
-  Reload worker after each request.
+Because of the asynchronous nature of the server, the workers reuse loaded resources on each request.
+This means that in some cases we need to restart workers.
+For example, after an exception is thrown, to prevent services from being in an unrecoverable state.
+Or every time you change the code in the IDE in dev environment.  
+The bundle provides several restart strategies that can be configured depending on what you need.
+
+- **on_exception**  
+  Reload worker each time that an exception is thrown during the worker lifetime.
+- **on_each_request**  
+  Reload worker after each http request. This strategy is for debug purposes.
+- **on_ttl_limit**  
+  Reload worker after TTL lifiteme will be reached. Can be used to prevent memory leaks.
+- **on_requests_limit**  
+  Reload worker on every N request.
+- **on_memory_limit**  
+  Reload worker after memory usage exceeds threshold value.
+- **on_file_change**  
+  Reload all workers each time that monitored files are changed. **  
 
 ** It is highly recommended to install the _php-inotify_ extension for file monitoring. Without it, monitoring will work in polling mode, which can be very cpu and disk intensive for large projects.
 
@@ -78,60 +74,63 @@ See all available options for each strategy in the command output.
 $ bin/console config:dump-reference phprunner reload_strategy
 ```
 
+```yaml
+# config/packages/phprunner.yaml
+
+phprunner:
+  reload_strategy:
+    on_exception:
+      active: true
+
+    on_file_change:
+      active: true
+```
+
 ## Scheduler
-Periodic tasks can be configured with attributes or with tags in configuration files.  
-Schedule string can be formatted in several ways:
+Periodic tasks can schedule the execution of external programs as well as internal Symfony application commands.  
+To run a Symfony command, simply type the command name without any prefixes.  
+Schedule string can be formatted in several ways:  
 - An integer to define the frequency as a number of seconds. Example: _60_
-- An ISO8601 datetime format. Example: _2023-08-01T01:00:00+08:00_
+- An ISO8601 datetime format. Example: _2024-02-14T018:00:00+08:00_
 - An ISO8601 duration format. Example: _PT1M_
 - A relative date format as supported by DateInterval. Example: _1 minutes_
 - A cron expression**. Example: _*/1 * * * *_
 
 ** Note that you need to install the [dragonmantank/cron-expression](https://github.com/dragonmantank/cron-expression) package if you want to use cron expressions as schedule strings
 
-```php
-<?php
+```yaml
+# config/packages/phprunner.yaml
 
-use Luzrain\PhpRunnerBundle\Attribute\AsTask;
-
-/**
- * Attribute parameters
- * name: Task name
- * schedule: Task schedule in any format
- * method: method to call, __invoke by default
- * jitter: Maximum jitter in seconds that adds a random time offset to the schedule. Use to prevent multiple tasks from running at the same time
- */
-#[AsTask(name: 'My scheduled task', schedule: '1 minutes')]
-final class TaskService
-{
-    public function __invoke()
-    {
-        // ...
-    }
-}
+phprunner:
+  tasks:
+    # Runs external program every 15 seconds
+    - name: 'Task 1'
+      schedule: '15 second'
+      command: '/bin/external-program'
+
+    # Runs symfony command as a task every minute
+    - name: 'Task 2'
+      schedule: '*/1 * * * *'
+      command: 'app:my-task-command'
 ```
 
 ## Supervisor
-Supervisor can be configured with attributes or with tags in configuration files.  
-Processes are kept alive and wake up if one of them dies.
+Supervisor can keep processes alive and wake up when one of them dies.  
+It can also work with both external commands and internal Symfony commands.  
+To run a Symfony command, simply type the command name without any prefixes.  
 
-```php
-<?php
+```yaml
+# config/packages/phprunner.yaml
 
-use Luzrain\PhpRunnerBundle\Attribute\AsProcess;
-
-/**
- * Attribute parameters
- * name: Process name
- * processes: number of processes
- * method: method to call, __invoke by default
- */
-#[AsProcess(name: 'My worker', processes: 1)]
-final class ProcessService
-{
-    public function __invoke()
-    {
-        // ...
-    }
-}
+phprunner:
+  processes:
+    # Runs external program
+    - name: 'External process'
+      command: '/bin/external-program'
+      count: 1
+
+    # Runs symfony command
+    - name: 'Symfony command process'
+      command: 'messenger:consume queue --time-limit=600'
+      count: 4
 ```

composer.json

@@ -12,10 +12,10 @@
     }
   ],
   "require": {
-    "php": "^8.2",
+    "php": ">=8.2",
     "ext-pcntl": "*",
     "ext-posix": "*",
-    "luzrain/phprunner": "dev-master",
+    "luzrain/phprunner": "^0.1",
     "psr/http-factory": "^1.0",
     "symfony/config": "^7.0",
     "symfony/dependency-injection": "^7.0",
@@ -32,7 +32,6 @@
     "vimeo/psalm": "^5.21"
   },
   "suggest": {
-    "ext-uv": "For better performance",
     "ext-inotify": "For effective file monitoring",
     "dragonmantank/cron-expression": "For parse cron expressions"
   },

src/config/configuration.php

@@ -141,7 +141,7 @@
                                 ->defaultFalse()
                                 ->end()
                             ->integerNode('ttl')
-                                ->info('TTL in seconds after which the worker is reloaded')
+                                ->info('TTL in seconds')
                                 ->isRequired()
                                 ->end()
                             ->end()
@@ -155,7 +155,7 @@
                                 ->defaultFalse()
                                 ->end()
                             ->integerNode('requests')
-                                ->info('Maximum number of requests after which the worker is reloaded')
+                                ->info('Maximum number of requests')
                                 ->isRequired()
                                 ->end()
                             ->integerNode('dispersion')
@@ -165,21 +165,22 @@
                             ->end()
                         ->end()
                     ->arrayNode('on_memory_limit')
-                        ->info('Reload worker after memory consumption would increase N')
+                        ->info('Reload worker after memory usage exceeds threshold value')
                         ->addDefaultsIfNotSet()
                         ->children()
                             ->booleanNode('active')
                                 ->info('Is strategy active')
                                 ->defaultFalse()
                                 ->end()
                             ->integerNode('memory')
-                                ->info('Memory in bytes after increase that the worker is reloaded')
+                                ->info('Threshold memory consumption in bytes')
+                                ->min(1024)
                                 ->isRequired()
                                 ->end()
                             ->end()
                         ->end()
                     ->arrayNode('on_file_change')
-                        ->info('Reload all workers each time that files is change')
+                        ->info('Reload all workers each time that monitored files are changed')
                         ->addDefaultsIfNotSet()
                         ->children()
                             ->booleanNode('active')
@@ -195,7 +196,7 @@
                                 ])
                                 ->end()
                             ->arrayNode('file_pattern')
-                                ->info('Monitored file patterns')
+                                ->info('Monitored files patterns')
                                 ->prototype('scalar')->end()
                                 ->defaultValue([
                                     '*.php',