Расширенные примеры использования встроенного сервера

Пример 1. Роутер для простого MVC с контроллерами и 404

Создайте файл router.php:

<?php
$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

// Маршруты
$routes = [
    '/' => 'home',
    '/about' => 'about',
    '/contact' => 'contact',
];

if (isset($routes[$uri])) {
    $controller = $routes[$uri];
    // Имитация вызова контроллера
    echo "<h1>Страница: $controller</h1>";
} elseif (file_exists(__DIR__ . $uri)) {
    return false;
} else {
    http_response_code(404);
    echo "<h1>404 - Страница не найдена</h1>";
}
?>

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

php -S localhost:8000 router.php

Откройте http://localhost:8000 - увидите заголовок "Страница: home".
Откройте http://localhost:8000/about - "Страница: about".
Откройте http://localhost:8000/unknown - код 404.

Результат в браузере:
http://localhost:8000/ -> "
Страница: home
"
http://localhost:8000/about -> "
Страница: about
"
http://localhost:8000/unknown -> код 404, "
404 - Страница не найдена
"

Пример 2. Запуск сервера с разными портами в одной сессии

Можно запустить несколько экземпляров сервера на разных портах:

php -S localhost:8000 -t /project1 &
php -S localhost:8001 -t /project2 &
php -S localhost:8002 -t /project3 &

На Linux/Mac используйте команды по очереди с &. На Windows - откройте три разных окна PowerShell или используйте start /B.

Каждый сервер будет обслуживать свой проект. Проверьте:
http://localhost:8000, http://localhost:8001, http://localhost:8002

Пример 3. Использование встроенного сервера для тестирования API с POST-запросами

Создайте api.php:

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $json = file_get_contents('php://input');
    $data = json_decode($json, true);
    $response = ['status' => 'ok', 'received' => $data];
    header('Content-Type: application/json');
    echo json_encode($response);
} else {
    http_response_code(405);
    echo json_encode(['error' => 'Метод не поддерживается']);
}
?>

Запустите сервер с роутером (или просто обратитесь к api.php):

php -S localhost:8000

Отправьте POST-запрос через curl:

curl -X POST http://localhost:8000/api.php -H "Content-Type: application/json" -d '{"user":"test"}'

Результат от сервера:
{"status":"ok","received":{"user":"test"}}

Пример 4. Передача переменных окружения для настройки сервера

Запуск с определённой переменной окружения:

APP_ENV=development php -S localhost:8000

В файле index.php:

<?php
$env = getenv('APP_ENV') ?: 'production';
echo "Режим окружения: $env";
?>

Результат: Режим окружения: development.

На Windows можно задать через set APP_ENV=development && php -S localhost:8000.

Пример 5. Обработка статических файлов с fallback на роутер

Создайте файл router.php, возвращающий false, если файл существует, иначе - index.php:

<?php
$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$filePath = __DIR__ . $uri;
if ($uri !== '/' && file_exists($filePath) && !is_dir($filePath)) {
    return false; // сервер отдаст статику сам
}
require 'index.php';
?>

В index.php:

<?php
$route = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
echo "Маршрут: $route";
?>

Теперь любые несуществующие пути будут обработаны через index.php, а существующие файлы (CSS, JS, картинки) будут отданы напрямую.

http://localhost:8000/style.css (если файл существует) - отдаст CSS.
http://localhost:8000/test - отобразит "Маршрут: /test".

Пример 6. Запуск с отображением всех ошибок и детальным логированием

Чтобы видеть все ошибки в консоли сервера, запустите с флагом -d:

php -d display_errors=1 -d error_reporting=E_ALL -S localhost:8000

Также можно перенаправить логи в файл:

php -S localhost:8000 > server.log 2>&1 &

Просмотреть логи:

tail -f server.log

В консоли будут выводиться все запросы и ошибки в реальном времени.