Инструкция по развертыванию PHP на сервере

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

1. Полная установка PHP 8.2 с Nginx через FPM на Ubuntu 22.04

Пример демонстрирует пошаговую настройку с конфигурацией под высоконагруженный проект.

# 1. Добавление PPA и установка PHP с расширениями
sudo add-apt-repository -y ppa:ondrej/php
sudo apt update
sudo apt install -y php8.2 php8.2-cli php8.2-fpm php8.2-mysql php8.2-xml php8.2-mbstring php8.2-curl php8.2-gd php8.2-bcmath php8.2-zip php8.2-intl php8.2-opcache

# 2. Оптимизация php.ini для продакшена
sudo cp /etc/php/8.2/fpm/php.ini /etc/php/8.2/fpm/php.ini.backup
sudo sed -i 's/memory_limit = 128M/memory_limit = 256M/' /etc/php/8.2/fpm/php.ini
sudo sed -i 's/upload_max_filesize = 2M/upload_max_filesize = 50M/' /etc/php/8.2/fpm/php.ini
sudo sed -i 's/post_max_size = 8M/post_max_size = 55M/' /etc/php/8.2/fpm/php.ini
sudo sed -i 's/max_execution_time = 30/max_execution_time = 120/' /etc/php/8.2/fpm/php.ini

# 3. Настройка пула FPM (www.conf) для обработки большого количества запросов
sudo sed -i 's/pm.max_children = 5/pm.max_children = 50/' /etc/php/8.2/fpm/pool.d/www.conf
sudo sed -i 's/pm.start_servers = 2/pm.start_servers = 10/' /etc/php/8.2/fpm/pool.d/www.conf
sudo sed -i 's/pm.min_spare_servers = 1/pm.min_spare_servers = 5/' /etc/php/8.2/fpm/pool.d/www.conf
sudo sed -i 's/pm.max_spare_servers = 3/pm.max_spare_servers = 20/' /etc/php/8.2/fpm/pool.d/www.conf

# 4. Включение OPcache с рекомендуемыми параметрами
echo -e '\nopcache.enable=1\nopcache.memory_consumption=128\nopcache.interned_strings_buffer=8\nopcache.max_accelerated_files=10000\nopcache.revalidate_freq=2' | sudo tee -a /etc/php/8.2/fpm/php.ini

# 5. Перезапуск и проверка
sudo systemctl restart php8.2-fpm
sudo systemctl status php8.2-fpm

# 6. Создание тестового файла PHP
cat <<'EOF' | sudo tee /var/www/html/info.php
<?
phpinfo();
?>
EOF

# 7. Установка Nginx (если ещё не установлен)
sudo apt install -y nginx
sudo systemctl enable nginx && sudo systemctl start nginx

# 8. Настройка виртуального хоста для передачи запросов на FPM
cat <<'EOF' | sudo tee /etc/nginx/sites-available/default
server {
    listen 80 default_server;
    root /var/www/html;
    index index.php index.html;

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

sudo systemctl reload nginx

# 9. Проверка через curl
docker run --rm curlimages/curl curl -s http://localhost/info.php | head -20

HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8




 
...

Пояснение: В результате браузер отобразит страницу phpinfo, где видны версия PHP, загруженные модули, параметры OPcache и FPM.

2. Установка PHP 8.0 параллельно с PHP 7.4 на CentOS 7 через Remi репозиторий

На CentOS удобно использовать репозиторий Remi, который предоставляет несколько версий PHP в одном источнике.

# Установка EPEL и Remi репозиториев
sudo yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm

# Установка yum-utils для управления модулями
sudo yum install -y yum-utils

# Активация модуля PHP 7.4
sudo yum-config-manager --enable remi-php74
sudo yum install -y php php-cli php-fpm php-mysql php-xml php-mbstring php-curl php-gd php-zip

# Активация модуля PHP 8.0 (отключает 7.4)
sudo yum-config-manager --disable remi-php74
sudo yum-config-manager --enable remi-php80
sudo yum install -y php80-php php80-php-cli php80-php-fpm php80-php-mysqlnd php80-php-xml php80-php-mbstring php80-php-curl php80-php-gd php80-php-zip

# Теперь обе версии установлены. Переключение через альтернативы
sudo alternatives --config php
# Выбрать номер, соответствующий версии 7.4 или 8.0

There are 2 programs which provide 'php'.
  Selection    Command
-----------------------------------------------
*+ 1           /usr/bin/php
   2           /usr/bin/php80
Enter to keep the current selection[+], or type selection number: 2

Пояснение: Команда alternatives позволяет выбрать, какая версия PHP будет использоваться по умолчанию. Обе версии могут работать одновременно через разные сокеты FPM.

3. Сборка PHP 8.3 с индивидуальным профилем опций для встраивания

Пример предназначен для случая, когда PHP должен работать как встраиваемый интерпретатор внутри другого приложения (например, SAPI embed).

# Загрузка исходного кода
git clone https://github.com/php/php-src.git --branch PHP-8.3.0 --depth 1
cd php-src

# Конфигурация с включением embed SAPI и отключением некоторых модулей для уменьшения размера
./buildconf --force
./configure --prefix=/opt/php-embed \
    --enable-embed=static \
    --disable-cgi \
    --disable-fpm \
    --disable-cli \
    --without-pdo-sqlite \
    --without-sqlite3 \
    --with-config-file-path=/opt/php-embed/etc \
    --with-openssl \
    --enable-mbstring=all

make -j$(nproc)
sudo make install

После сборки в директории /opt/php-embed/lib появится статическая библиотека libphp.a, которую можно линковать с C/C++ проектом.

# Пример компиляции C программы, использующей встроенный PHP
gcc -o myapp myapp.c -I/opt/php-embed/include -L/opt/php-embed/lib -lphp -lxml2 -lssl -lcrypto -lm -ldl

4. Настройка PHP через environment variables в Docker Compose

Удобный способ конфигурирования PHP без изменения файлов - передача переменных окружения в контейнер.

# docker-compose.yml
version: '3'
services:
  php:
    image: php:8.2-fpm
    volumes:
      - ./src:/var/www/html
    environment:
      PHP_MEMORY_LIMIT: 512M
      PHP_UPLOAD_MAX_FILESIZE: 100M
      PHP_POST_MAX_SIZE: 110M
      PHP_MAX_EXECUTION_TIME: 300
      PHP_OPCACHE_ENABLE: '1'
      PHP_OPCACHE_MEMORY_CONSUMPTION: '256'

Эти переменные автоматически обрабатываются скриптом docker-php-ext-configure и записываются в php.ini.

# После запуска контейнера проверить параметры можно через exec
docker exec -it container_name php -i | grep memory_limit
memory_limit = 512M

5. Автоматизация установки PHP на Windows через Chocolatey

Для Windows разработчиков удобен менеджер пакетов Chocolatey, позволяющий установить PHP одной командой и управлять расширениями.

# Установка Chocolatey (от имени администратора)
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# Установка PHP 8.2 с популярными расширениями
choco install php --version=8.2.0 --params 'InstallDir=C:\tools\php82;Extensions=openssl,mbstring,curl,gd,pdo_mysql,mysqli'

# После установки добавить путь в PATH (обычно делает инсталлятор)
refreshenv
php -v

PHP 8.2.0 (cli) (built: Nov 30 2022 12:00:00) ( ZTS Visual C++ 2019 )
Copyright (c) The PHP Group
Zend Engine v4.2.0, Copyright (c) Zend Technologies