Add php-fpm as a contrib recipe (#2487)

* Add php-fpm as a contrib recipe

* Update CHANGELOG.md

* Find the PHP-fpm version from the process

Author: lorisleiva

CHANGELOG.md

@@ -23,6 +23,7 @@
 - Added slack_channel option to Slack recipe.
 - Chatwork contrib recipe.
 - Added `release_or_current_path` option that fallbacks to the `current_path` when the `release_path` does not exist. [#2486]
+- Added `contrib/php-fpm.php` recipe that provides a task to reload PHP-fpm. [#2487]
 
 ### Changed
 - Refactored executor engine, up to 2x faster than before.
@@ -603,6 +604,7 @@
 - Fixed `DotArray` syntax in `Collection`.
 
 
+[#2487]: https://github.com/deployphp/deployer/pull/2487
 [#2486]: https://github.com/deployphp/deployer/pull/2486
 [#2425]: https://github.com/deployphp/deployer/pull/2425
 [#2423]: https://github.com/deployphp/deployer/issues/2423

contrib/php-fpm.php

@@ -0,0 +1,47 @@
+<?php
+/*
+## Installing
+
+Add to your _deploy.php_
+
+```php
+require 'contrib/php-fpm.php';
+```
+
+## Configuration
+
+- `php_fpm_version` – The PHP-fpm version. For example: `8.0`.
+- `php_fpm_service` – The full name of the PHP-fpm service. Defaults to `php{{php_fpm_version}}-fpm`.
+- `php_fpm_command` – The command to run to reload PHP-fpm. Defaults to `echo "" | sudo -S /usr/sbin/service {{php_fpm_service}} reload`.
+
+## Usage
+
+Start by explicitely providing the current version of PHP-version using the `php_fpm_version`.
+Alternatively, you may use any of the options above to configure how PHP-fpm should reload.
+
+Then, add the `php-fpm:reload` task at the end of your deployments by using the `after` method like so.
+
+```php
+set('php_fpm_version', '8.0');
+after('deploy', 'php-fpm:reload');
+```
+
+ */
+namespace Deployer;
+
+set('php_fpm_version', function () {
+    $phpFpmProcess = run("ps aux | grep php-fpm | grep 'master process'");
+
+    if (! preg_match('/^.*master process.*(\d\.\d).*$/', $phpFpmProcess, $match)) {
+        throw new \Exception('Please provide the PHP-fpm version using the `php_fpm_version` option.');
+    }
+
+    return $match[1];
+});
+set('php_fpm_service', 'php{{php_fpm_version}}-fpm');
+set('php_fpm_command', 'echo "" | sudo -S /usr/sbin/service {{php_fpm_service}} reload');
+
+desc('Reload the php-fpm service');
+task('php-fpm:reload', function () {
+    run('{{php_fpm_command}}');
+});

docs/contrib/php-fpm.md

@@ -0,0 +1,59 @@
+<!-- DO NOT EDIT THIS FILE! -->
+<!-- Instead edit contrib/php-fpm.php -->
+<!-- Then run bin/docgen -->
+
+# php-fpm
+
+[Source](/contrib/php-fpm.php)
+
+
+## Installing
+
+Add to your _deploy.php_
+
+```php
+require 'contrib/php-fpm.php';
+```
+
+## Configuration
+
+- `php_fpm_version` – The PHP-fpm version. For example: `8.0`.
+- `php_fpm_service` – The full name of the PHP-fpm service. Defaults to `php{{php_fpm_version}}-fpm`.
+- `php_fpm_command` – The command to run to reload PHP-fpm. Defaults to `echo "" | sudo -S /usr/sbin/service {{php_fpm_service}} reload`.
+
+## Usage
+
+Start by explicitely providing the current version of PHP-version using the `php_fpm_version`.
+Alternatively, you may use any of the options above to configure how PHP-fpm should reload.
+
+Then, add the `php-fpm:reload` task at the end of your deployments by using the `after` method like so.
+
+```php
+set('php_fpm_version', '8.0');
+after('deploy', 'php-fpm:reload');
+```
+
+
+
+* Config
+  * [`php_fpm_version`](#php_fpm_version)
+  * [`php_fpm_service`](#php_fpm_service)
+  * [`php_fpm_command`](#php_fpm_command)
+
+## Config
+### php_fpm_version
+[Source](https://github.com/deployphp/deployer/search?q=%22php_fpm_version%22+in%3Afile+language%3Aphp+path%3Acontrib+filename%3Aphp-fpm.php)
+
+
+
+### php_fpm_service
+[Source](https://github.com/deployphp/deployer/search?q=%22php_fpm_service%22+in%3Afile+language%3Aphp+path%3Acontrib+filename%3Aphp-fpm.php)
+
+
+
+### php_fpm_command
+[Source](https://github.com/deployphp/deployer/search?q=%22php_fpm_command%22+in%3Afile+language%3Aphp+path%3Acontrib+filename%3Aphp-fpm.php)
+
+
+
+