Старт PHP-демона: systemd unit и альтернативы

Расширенные примеры настройки PHP службы

Пример 1: Детальная конфигурация пула PHP-FPM

Файл /etc/php/8.1/fpm/pool.d/www.conf может содержать множество параметров для точной настройки. Ниже показаны ключевые директивы с пояснениями.

; Пример конфигурации пула для высоконагруженного сайта
[www]
user = www-data
group = www-data
listen = /run/php/php8.1-fpm.sock
; Использование сокета вместо TCP для производительности
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
; Динамическое управление процессами
pm = dynamic
pm.max_children = 100
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 30
; Ограничение времени выполнения запроса
request_terminate_timeout = 300
; Максимальное количество запросов до перезапуска процесса
pm.max_requests = 1000

После изменения конфигурации проверяется синтаксис и перезагружается служба:

sudo php-fpm8.1 -t
sudo systemctl reload php8.1-fpm

Результат проверки статуса пулов:

$ sudo systemctl status php8.1-fpm
● php8.1-fpm.service - PHP 8.1 FastCGI Process Manager
     Loaded: loaded (/lib/systemd/system/php8.1-fpm.service; enabled; vendor preset: enabled)
     Active: active (running) since ...
       Docs: man:php-fpm8.1(8)
   Main PID: 12345 (php-fpm8.1)
     Status: "Processes active: 3, idle: 7, Requests: 23456, slow: 0, Traffic: 0.00req/s"
     Tasks: 12 (limit: 2345)
     Memory: 48.3M
     CGroup: /system.slice/php8.1-fpm.service
             ├─12345 php-fpm: master process (/etc/php/8.1/fpm/php-fpm.conf)
             ├─12346 php-fpm: pool www
             ├─12347 php-fpm: pool www
             └─12348 php-fpm: pool www

Пример 2: Systemd unit для встроенного сервера с PHP.ini и роутером

Для более гибкого запуска встроенного сервера можно указать путь к php.ini и файл-роутер (router.php).

[Unit]
Description=PHP Built-in Server for App
After=network.target

[Service]
Type=simple
User=deploy
ExecStart=/usr/bin/php -c /etc/php/8.1/cli/php.ini -S 0.0.0.0:8080 -t /var/www/app /var/www/app/router.php
Restart=always
RestartSec=5
StandardOutput=append:/var/log/php-builtin/access.log
StandardError=append:/var/log/php-builtin/error.log

[Install]
WantedBy=multi-user.target

Создание файла роутера router.php:

<?
$uri = $_SERVER['REQUEST_URI'];
if (file_exists(__DIR__ . $uri) && !is_dir(__DIR__ . $uri)) {
    return false; // отдавать статические файлы напрямую
}
require __DIR__ . '/index.php';

Запуск и проверка:

sudo systemctl start php-builtin
curl http://localhost:8080/
sudo systemctl status php-builtin

● php-builtin.service - PHP Built-in Server for App
     Loaded: loaded (/etc/systemd/system/php-builtin.service; enabled; vendor preset: enabled)
     Active: active (running) since ...
   Main PID: 23456 (php)
     Tasks: 1 (limit: 12345)
     Memory: 12.3M
     CGroup: /system.slice/php-builtin.service
             └─23456 /usr/bin/php -c /etc/php/8.1/cli/php.ini -S 0.0.0.0:8080 -t /var/www/app /var/www/app/router.php

Пример 3: Supervisor для нескольких воркеров Laravel с разными параметрами

В конфигурации supervisor можно задать несколько программ с различными настройками.

[program:laravel-queue-high]
command=php /var/www/app/artisan queue:work --queue=high --sleep=3 --tries=3
process_name=%(program_name)s_%(process_num)s
numprocs=2
autostart=true
autorestart=true
user=forge
stdout_logfile=/var/log/supervisor/queue-high.log

[program:laravel-queue-low]
command=php /var/www/app/artisan queue:work --queue=low --sleep=5 --tries=5
process_name=%(program_name)s_%(process_num)s
numprocs=1
autostart=true
autorestart=true
user=forge
stdout_logfile=/var/log/supervisor/queue-low.log

Перезагрузка конфигурации и проверка статуса:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status

laravel-queue-high:laravel-queue-high_00   RUNNING   pid 34567, uptime 0:02:34
laravel-queue-high:laravel-queue-high_01   RUNNING   pid 34568, uptime 0:02:34
laravel-queue-low:laravel-queue-low_00     RUNNING   pid 34569, uptime 0:02:34

Пример 4: Docker Compose стек с PHP-FPM, Nginx, Redis

Полноценный стек для веб-приложения включает nginx как фронтенд и php-fpm для обработки скриптов, а также redis для кеширования.

version: '3.8'
services:
  php-fpm:
    build:
      context: .
      dockerfile: Dockerfile.php
    volumes:
      - ./src:/var/www/html
    environment:
      - REDIS_HOST=redis
    depends_on:
      - redis
    restart: unless-stopped

  nginx:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - ./src:/var/www/html
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - php-fpm
    restart: unless-stopped

  redis:
    image: redis:alpine
    restart: unless-stopped

volumes:
  src:

Dockerfile.php:

FROM php:8.1-fpm
RUN docker-php-ext-install pdo_mysql redis
WORKDIR /var/www/html

Запуск стека и проверка:

docker-compose up -d
docker-compose ps

  Name                 Command               State     Ports
--------------------------------------------------------------
app_nginx_1   /docker-entrypoint.sh ngin ...   Up      0.0.0.0:8080->80/tcp
app_php-fpm_1  docker-php-entrypoint php ...   Up      9000/tcp
app_redis_1   docker-entrypoint.sh redis ...   Up      6379/tcp

Пример 5: Init.d скрипт для PHP-FPM (устаревший, для справки)

На старых системах (Debian 7, CentOS 6) использовались скрипты в /etc/init.d/. Ниже приведён сокращённый пример скрипта php-fpm.

#!/bin/sh
### BEGIN INIT INFO
# Provides:          php-fpm
# Required-Start:    $remote_fs $network
# Required-Stop:     $remote_fs $network
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: PHP FastCGI Process Manager
# Description:       PHP-FPM is a PHP FastCGI implementation
### END INIT INFO

NAME=php-fpm
DAEMON=/usr/sbin/php-fpm

case "$1" in
  start)
    echo -n "Starting $NAME: "
    $DAEMON && echo "OK" || echo "FAIL"
    ;;
  stop)
    echo -n "Stopping $NAME: "
    killall $NAME && echo "OK" || echo "FAIL"
    ;;
  restart)
    $0 stop
    sleep 2
    $0 start
    ;;
  status)
    status_of_proc $DAEMON $NAME
    ;;
  *)
    echo "Usage: $0 {start|stop|restart|status}"
    exit 1
    ;;
esac
exit 0

Использование: service php-fpm start. При ошибках следует проверять наличие исполняемого файла и права на его запуск.