mirror of
https://github.com/deployphp/deployer.git
synced 2025-02-24 01:02:24 +01:00
76 lines
1.7 KiB
Markdown
76 lines
1.7 KiB
Markdown
<!-- DO NOT EDIT THIS FILE! -->
|
||
<!-- Instead edit contrib/php-fpm.php -->
|
||
<!-- Then run bin/docgen -->
|
||
|
||
# php-fpm
|
||
|
||
[Source](/contrib/php-fpm.php)
|
||
|
||
|
||
|
||
## Installing
|
||
|
||
:::caution
|
||
Do **not** reload php-fpm. Some user requests could fail or not complete in the
|
||
process of reloading.
|
||
|
||
Instead, configure your server [properly](https://ï.at/avoid-php-fpm-reloading). If you're using Deployer's provision
|
||
recipe, it's already configured the right way and no php-fpm reload is needed.
|
||
:::
|
||
|
||
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 `sudo systemctl reload {{php_fpm_service}}`.
|
||
|
||
## 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');
|
||
```
|
||
|
||
|
||
|
||
## Configuration
|
||
### php_fpm_version
|
||
[Source](https://github.com/deployphp/deployer/blob/master/contrib/php-fpm.php#L41)
|
||
|
||
Automatically detects by using [bin/php](/docs/recipe/common.md#bin/php).
|
||
|
||
|
||
|
||
### php_fpm_service
|
||
[Source](https://github.com/deployphp/deployer/blob/master/contrib/php-fpm.php#L45)
|
||
|
||
|
||
|
||
```php title="Default value"
|
||
'php{{php_fpm_version}}-fpm'
|
||
```
|
||
|
||
|
||
|
||
## Tasks
|
||
|
||
### php-fpm:reload
|
||
[Source](https://github.com/deployphp/deployer/blob/master/contrib/php-fpm.php#L48)
|
||
|
||
Reloads the php-fpm service.
|
||
|
||
|
||
|
||
|