Локальная разработка на PHP: инструменты и конфигурации

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

1. Встроенный сервер с роутером и обработкой ошибок

Создадим router.php, который эмулирует mod_rewrite: все запросы, кроме существующих файлов, направляются на index.php.

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

# Запуск с роутером
php -S localhost:8000 router.php

При запросе http://localhost:8000/some/path сервер не ищет файл, а передаёт управление index.php, который может разобрать URL.

2. Docker: PHP-FPM + Nginx с поддержкой мультисайтов

Файловая структура:

project/
  docker-compose.yml
  nginx/
    default.conf
  app/
    site1/
      index.php
    site2/
      index.php

docker-compose.yml:

version: '3.8'
services:
  nginx:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - ./app:/var/www/html
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
  php:
    image: php:8.2-fpm-alpine
    volumes:
      - ./app:/var/www/html
    working_dir: /var/www/html

nginx/default.conf:

server {
    listen 80;
    server_name localhost;

    root /var/www/html;

    location /site1/ {
        try_files $uri $uri/ /site1/index.php$is_args$args;
    }

    location /site2/ {
        try_files $uri $uri/ /site2/index.php$is_args$args;
    }

    location ~ \.php$ {
        fastcgi_pass php:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Запуск: docker-compose up -d. Теперь http://localhost:8080/site1/ использует свой index.php.

3. phpbrew: установка расширения Xdebug для конкретной версии

# Установка Xdebug для текущей используемой версии PHP (например, 8.3)
phpbrew ext install xdebug 3.3.2

# Проверка
php -m | grep xdebug

xdebug

Для включения Xdebug в php.ini (найденном через php --ini) добавить:

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes

phpbrew также позволяет создать алиас (символическую ссылку) для версии:

phpbrew alias 8.3.12 project-php
# Теперь можно использовать command: phpbrew use project-php

4. Компиляция PHP с поддержкой SQLite3 и GD

./configure --prefix=/usr/local/php8.3 \
  --with-pdo-sqlite \
  --with-gd --with-freetype-dir=/usr/include/freetype2 \
  --enable-gd-jis-conv \
  --with-zlib
make -j$(nproc)
sudo make install

# Проверка расширений
/usr/local/php8.3/bin/php -m | grep -E 'sqlite|gd'

gd
pdo_sqlite
sqlite3

Если freetype не найден, установите libfreetype6-dev и передайте правильный путь (обычно /usr/include/freetype2).

5. Встроенный сервер с HTTPS через самоподписанный сертификат

# Генерация самоподписанного сертификата
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes -subj "/CN=localhost"

# Запуск HTTPS сервера
php -S localhost:8443 -c php.ini -t /path/to/project --cert cert.pem --key key.pem

В браузере - предупреждение о недоверенном сертификате, но для локальной разработки это приемлемо.

Результат каждого примера: вы получите работающее локальное PHP-окружение, адаптированное под конкретные задачи. Выбор метода зависит от уровня изоляции, требуемой кастомизации и простоты воспроизведения.