Skip to content

php fpm #307

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
vankovap merged 1 commit into from
Jan 17, 2026
Merged

php fpm #307

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 68 additions & 4 deletions apps/docs/content/php/how-to/customize-runtime.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,17 +42,81 @@ run:
You can override PHP configuration directives by setting environment variables in your `zerops.yaml` file.

Here's an example of how to adjust PHP's `post_max_size` directive:

```yaml
zerops:
# define hostname of your service
- setup: app
# ==== how to build your application ====
# ==== how to run your application ====
run:
# REQUIRED. Sets the base technology for the build environment:
# REQUIRED. Sets the base technology for the runtime environment:
base: php-nginx@8.3

# OPTIONAL. Defines the env variables for the build environment:
# OPTIONAL. Defines the env variables for the runtime:
envVariables:
PHP_INI_post_max_size: 10M
```

:::info
After updating PHP-FPM configuration in your `zerops.yaml` file, you need to restart or reload the app for the changes to take effect.
:::

## PHP-FPM

### Default PHP-FPM configuration

PHP-FPM (FastCGI Process Manager) uses the **dynamic** process management mode by default. In this mode, the system automatically adjusts the number of PHP processes based on current load.

The default PHP-FPM configuration uses these values:

- `PHP_FPM_PM` = `dynamic`
- `PHP_FPM_PM_MAX_CHILDREN` = `20`
- `PHP_FPM_PM_START_SERVERS` = `2`
- `PHP_FPM_PM_MIN_SPARE_SERVERS` = `1`
- `PHP_FPM_PM_MAX_SPARE_SERVERS` = `3`
- `PHP_FPM_PM_MAX_SPAWN_RATE` = `32`
- `PHP_FPM_PM_MAX_REQUESTS` = `500`

### Dynamic mode

To adjust the dynamic mode settings, add the desired environment variables to the run section:
```yaml
zerops:
# define hostname of your service
- setup: app
# ==== how to run your application ====
run:
# OPTIONAL. Defines the env variables for the runtime:
envVariables:
PHP_FPM_PM_MAX_CHILDREN: 30
PHP_FPM_PM_START_SERVERS: 5
PHP_FPM_PM_MIN_SPARE_SERVERS: 2
PHP_FPM_PM_MAX_SPARE_SERVERS: 10
PHP_FPM_PM_MAX_REQUESTS: 1000
```

### Ondemand mode

The **ondemand** mode is ideal for applications with lower traffic, where processes are created only when requests arrive. To enable ondemand mode:
```yaml
zerops:
# define hostname of your service
- setup: app
# ==== how to run your application ====
run:
# OPTIONAL. Defines the env variables for the runtime:
envVariables:
PHP_FPM_PM: ondemand
PHP_FPM_PM_MAX_CHILDREN: 20
PHP_FPM_PM_PROCESS_IDLE_TIMEOUT: 60s
PHP_FPM_PM_MAX_REQUESTS: 500
```

**Available parameters for ondemand mode:**

- `PHP_FPM_PM_MAX_CHILDREN` – maximum number of child processes
- `PHP_FPM_PM_PROCESS_IDLE_TIMEOUT` – time after which idle processes are terminated (default: `60s`)
- `PHP_FPM_PM_MAX_REQUESTS` – number of requests each process handles before being recycled (default: `500`)

:::info
After updating PHP-FPM configuration in your `zerops.yaml` file, you need to restart or reload the app for the changes to take effect.
:::
58 changes: 55 additions & 3 deletions apps/docs/static/llms-full.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15646,14 +15646,66 @@ Here's an example of how to adjust PHP's `post_max_size` directive:
zerops:
# define hostname of your service
- setup: app
# ==== how to build your application ====
# ==== how to run your application ====
run:
# REQUIRED. Sets the base technology for the build environment:
# REQUIRED. Sets the base technology for the runtime environment:
base: php-nginx@8.3
# OPTIONAL. Defines the env variables for the build environment:
# OPTIONAL. Defines the env variables for the runtime:
envVariables:
PHP_INI_post_max_size: 10M
```
:::info
After updating PHP-FPM configuration in your `zerops.yaml` file, you need to restart or reload the app for the changes to take effect.
:::
## PHP-FPM
### Default PHP-FPM configuration
PHP-FPM (FastCGI Process Manager) uses the **dynamic** process management mode by default. In this mode, the system automatically adjusts the number of PHP processes based on current load.
The default PHP-FPM configuration uses these values:
- `PHP_FPM_PM` = `dynamic`
- `PHP_FPM_PM_MAX_CHILDREN` = `20`
- `PHP_FPM_PM_START_SERVERS` = `2`
- `PHP_FPM_PM_MIN_SPARE_SERVERS` = `1`
- `PHP_FPM_PM_MAX_SPARE_SERVERS` = `3`
- `PHP_FPM_PM_MAX_SPAWN_RATE` = `32`
- `PHP_FPM_PM_MAX_REQUESTS` = `500`
### Dynamic mode
To adjust the dynamic mode settings, add the desired environment variables to the run section:
```yaml
zerops:
# define hostname of your service
- setup: app
# ==== how to run your application ====
run:
# OPTIONAL. Defines the env variables for the runtime:
envVariables:
PHP_FPM_PM_MAX_CHILDREN: 30
PHP_FPM_PM_START_SERVERS: 5
PHP_FPM_PM_MIN_SPARE_SERVERS: 2
PHP_FPM_PM_MAX_SPARE_SERVERS: 10
PHP_FPM_PM_MAX_REQUESTS: 1000
```
### Ondemand mode
The **ondemand** mode is ideal for applications with lower traffic, where processes are created only when requests arrive. To enable ondemand mode:
```yaml
zerops:
# define hostname of your service
- setup: app
# ==== how to run your application ====
run:
# OPTIONAL. Defines the env variables for the runtime:
envVariables:
PHP_FPM_PM: ondemand
PHP_FPM_PM_MAX_CHILDREN: 20
PHP_FPM_PM_PROCESS_IDLE_TIMEOUT: 60s
PHP_FPM_PM_MAX_REQUESTS: 500
```
**Available parameters for ondemand mode:**
- `PHP_FPM_PM_MAX_CHILDREN` – maximum number of child processes
- `PHP_FPM_PM_PROCESS_IDLE_TIMEOUT` – time after which idle processes are terminated (default: `60s`)
- `PHP_FPM_PM_MAX_REQUESTS` – number of requests each process handles before being recycled (default: `500`)
:::info
After updating PHP-FPM configuration in your `zerops.yaml` file, you need to restart or reload the app for the changes to take effect.
:::

----------------------------------------

Expand Down
58 changes: 55 additions & 3 deletions apps/docs/static/llms-small.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15405,14 +15405,66 @@ Here's an example of how to adjust PHP's `post_max_size` directive:
zerops:
# define hostname of your service
- setup: app
# ==== how to build your application ====
# ==== how to run your application ====
run:
# REQUIRED. Sets the base technology for the build environment:
# REQUIRED. Sets the base technology for the runtime environment:
base: php-nginx@8.3
# OPTIONAL. Defines the env variables for the build environment:
# OPTIONAL. Defines the env variables for the runtime:
envVariables:
PHP_INI_post_max_size: 10M
```
:::info
After updating PHP-FPM configuration in your `zerops.yaml` file, you need to restart or reload the app for the changes to take effect.
:::
## PHP-FPM
### Default PHP-FPM configuration
PHP-FPM (FastCGI Process Manager) uses the **dynamic** process management mode by default. In this mode, the system automatically adjusts the number of PHP processes based on current load.
The default PHP-FPM configuration uses these values:
- `PHP_FPM_PM` = `dynamic`
- `PHP_FPM_PM_MAX_CHILDREN` = `20`
- `PHP_FPM_PM_START_SERVERS` = `2`
- `PHP_FPM_PM_MIN_SPARE_SERVERS` = `1`
- `PHP_FPM_PM_MAX_SPARE_SERVERS` = `3`
- `PHP_FPM_PM_MAX_SPAWN_RATE` = `32`
- `PHP_FPM_PM_MAX_REQUESTS` = `500`
### Dynamic mode
To adjust the dynamic mode settings, add the desired environment variables to the run section:
```yaml
zerops:
# define hostname of your service
- setup: app
# ==== how to run your application ====
run:
# OPTIONAL. Defines the env variables for the runtime:
envVariables:
PHP_FPM_PM_MAX_CHILDREN: 30
PHP_FPM_PM_START_SERVERS: 5
PHP_FPM_PM_MIN_SPARE_SERVERS: 2
PHP_FPM_PM_MAX_SPARE_SERVERS: 10
PHP_FPM_PM_MAX_REQUESTS: 1000
```
### Ondemand mode
The **ondemand** mode is ideal for applications with lower traffic, where processes are created only when requests arrive. To enable ondemand mode:
```yaml
zerops:
# define hostname of your service
- setup: app
# ==== how to run your application ====
run:
# OPTIONAL. Defines the env variables for the runtime:
envVariables:
PHP_FPM_PM: ondemand
PHP_FPM_PM_MAX_CHILDREN: 20
PHP_FPM_PM_PROCESS_IDLE_TIMEOUT: 60s
PHP_FPM_PM_MAX_REQUESTS: 500
```
**Available parameters for ondemand mode:**
- `PHP_FPM_PM_MAX_CHILDREN` – maximum number of child processes
- `PHP_FPM_PM_PROCESS_IDLE_TIMEOUT` – time after which idle processes are terminated (default: `60s`)
- `PHP_FPM_PM_MAX_REQUESTS` – number of requests each process handles before being recycled (default: `500`)
:::info
After updating PHP-FPM configuration in your `zerops.yaml` file, you need to restart or reload the app for the changes to take effect.
:::

----------------------------------------

Expand Down