Выбор порта для PHP сервера: практическое руководство

Расширенные примеры настройки порта PHP сервера

Пример 1: Встроенный сервер с файлом-роутером

Можно запустить сервер с PHP-скриптом, который обрабатывает все запросы (роутер). Пример router.php:

// router.php
$uri = $_SERVER['REQUEST_URI'];
if ($uri === '/api') {
    http_response_code(200);
    echo 'API endpoint';
} else {
    return false; // передать обработку статическим файлам
}

Запуск:

php -S localhost:8000 router.php

Результат: при обращении к http://localhost:8000/api сервер вернёт API endpoint, а для остальных путей будет искать файл в текущей директории.

$ curl http://localhost:8000/api
API endpoint

Пример 2: Динамический выбор свободного порта с помощью скрипта

Бывает необходимо запустить сервер на случайном свободном порту. Скрипт findport.php находит порт и запускает сервер:

// findport.php
$basePort = 8000;
$maxAttempts = 10;
for ($port = $basePort; $port < $basePort + $maxAttempts; $port++) {
    $socket = @fsockopen('127.0.0.1', $port, $errno, $errstr, 1);
    if (!$socket) {
        echo "Starting server on port $port\n";
        exec("php -S localhost:$port");
        break;
    }
    fclose($socket);
}

Запуск: php findport.php. Результат - сервер стартует на первом свободном порту, начиная с 8000.

Starting server on port 8000

Пример 3: Настройка PHP-FPM на нестандартный порт и проверка

Предположим, нужно изменить порт FPM на 9001. Файл /etc/php/8.2/fpm/pool.d/www.conf содержит строку:

listen = 127.0.0.1:9001

Перезапуск и проверка:

sudo systemctl restart php8.2-fpm
netstat -tlnp | grep php

tcp  0  0 127.0.0.1:9001  0.0.0.0:*  LISTEN  12345/php-fpm

Если порт не появился, проверяют логи FPM: tail -f /var/log/php8.2-fpm.log.

Пример 4: Использование unix-сокета в nginx

Конфигурация nginx при использовании unix-сокета вместо TCP порта:

server {
    listen 80;
    server_name example.com;
    root /var/www/example;

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

Перезагрузка nginx: sudo systemctl reload nginx. Ошибка соединения обычно проявляется кодом 502 Bad Gateway и записью в логе ошибок nginx.

Пример 5: Запуск встроенного сервера в фоне и его остановка

Чтобы сервер работал после закрытия терминала, используют запуск в фоне:

php -S 0.0.0.0:8080 > /dev/null 2>&1 &

Запомнить PID: echo $! сохраняют в переменной. Остановка по PID:

kill PID

Можно использовать pkill -f 'php -S' для остановки всех процессов.

Пример 6: Проверка занятости порта из PHP

Скрипт проверяет, свободен ли порт:

$port = 8080;
$connection = @fsockopen('127.0.0.1', $port, $errno, $errstr, 1);
if (is_resource($connection)) {
    echo "Порт $port занят.";
    fclose($connection);
} else {
    echo "Порт $port свободен.";
}

Порт 8080 свободен.