Как настроить Docker Compose для PHP, Nginx и PostgreSQL

Для быстрого развертывания среды разработки с использованием PHP, Nginx и PostgreSQL, создайте файл docker-compose.yml. В этом файле определите три сервиса: web для Nginx, app для PHP и db для PostgreSQL. Укажите базовые образы, порты и зависимости между сервисами.

Настройте Nginx так, чтобы он проксировал запросы к PHP-приложению. В конфигурации Nginx добавьте блок location, который передает запросы на обработку в сервис app. Убедитесь, что конфигурационный файл Nginx монтируется в контейнер через volumes.

Для PHP-приложения используйте образ с предустановленными расширениями, такими как pdo_pgsql и mbstring. Настройте volumes для синхронизации кода приложения между хостом и контейнером. Это позволит вносить изменения в реальном времени.

PostgreSQL настройте с использованием переменных окружения для указания пользователя, пароля и базы данных. Добавьте volume для хранения данных, чтобы они сохранялись после перезапуска контейнера. Убедитесь, что сервис app зависит от db, чтобы база данных была готова к использованию до запуска приложения.

После настройки файла выполните команду docker-compose up -d, чтобы запустить все сервисы. Проверьте работу приложения, открыв его в браузере. Если возникнут ошибки, используйте docker-compose logs для диагностики.

Создание файла Docker Compose

Создайте файл docker-compose.yml в корне вашего проекта. Этот файл будет содержать конфигурацию для запуска PHP, Nginx и PostgreSQL. Используйте текстовый редактор, например, VS Code или Nano, чтобы начать работу.

Определите версию Docker Compose в начале файла. Укажите version: '3.8', чтобы использовать актуальные возможности. Затем добавьте секцию services, где будут описаны все необходимые сервисы.

Для PHP создайте сервис с именем php. Используйте образ php:8.2-fpm для работы с PHP-FPM. Добавьте параметр volumes, чтобы связать папку с вашим кодом внутри контейнера. Например:

php:
image: php:8.2-fpm
volumes:
- ./app:/var/www/html

Настройте сервис для Nginx. Укажите образ nginx:latest и свяжите конфигурационные файлы через volumes. Добавьте порт 80 для доступа к веб-серверу:

nginx:
image: nginx:latest
ports:
- "80:80"
volumes:
- ./app:/var/www/html
- ./nginx.conf:/etc/nginx/conf.d/default.conf

Для PostgreSQL используйте образ postgres:15. Укажите переменные окружения для настройки базы данных, такие как POSTGRES_USER, POSTGRES_PASSWORD и POSTGRES_DB. Добавьте том для сохранения данных:

postgres:
image: postgres:15
environment:
POSTGRES_USER: user
POSTGRES_PASSWORD: password
POSTGRES_DB: app_db
volumes:
- postgres_data:/var/lib/postgresql/data

В конце файла добавьте секцию volumes для управления томами. Например:

volumes:
postgres_data:

Сохраните файл и запустите контейнеры командой docker-compose up -d. Проверьте, что все сервисы работают корректно, и настройте приложение для взаимодействия с базой данных и веб-сервером.

Определение необходимых сервисов

Для запуска проекта на PHP с использованием Nginx и PostgreSQL в Docker Compose потребуется три основных сервиса. Каждый из них выполняет свою роль, обеспечивая корректную работу приложения.

PHP: Обрабатывает логику приложения. Используйте официальный образ PHP с нужной версией, например php:8.2-fpm. Добавьте необходимые расширения, такие как pdo_pgsql для работы с PostgreSQL.
Nginx: Выступает в роли веб-сервера, обслуживающего статические файлы и проксирующего запросы к PHP-FPM. Возьмите образ nginx:latest и настройте конфигурацию для работы с PHP.
PostgreSQL: Хранит данные приложения. Используйте образ postgres:15 и задайте переменные окружения для настройки базы данных, такие как POSTGRES_USER и POSTGRES_PASSWORD.

Дополнительно можно добавить сервис phpMyAdmin или pgAdmin для удобного управления базой данных. Например, используйте образ phpmyadmin/phpmyadmin или dpage/pgadmin4.

Каждый сервис должен быть описан в файле docker-compose.yml с указанием контейнера, портов, томов и зависимостей. Например, PHP-FPM должен зависеть от PostgreSQL, чтобы база данных была готова к работе перед запуском приложения.

Проверьте, что все сервисы корректно взаимодействуют друг с другом. Для этого настройте сеть в Docker Compose, чтобы контейнеры могли обмениваться данными по именам сервисов.

Обзор, какие сервисы вам понадобятся для работы с PHP, Nginx и PostgreSQL.

Для запуска проекта на PHP, Nginx и PostgreSQL потребуется настроить три основных сервиса в Docker Compose. Каждый из них выполняет свою роль и взаимодействует с другими для полноценной работы приложения.

PHP: Основной сервис для выполнения PHP-кода. Используйте образ, например, php:8.2-fpm, чтобы обеспечить поддержку последних версий PHP. Убедитесь, что в контейнере установлены необходимые расширения, такие как pdo_pgsql для работы с PostgreSQL.
Nginx: Веб-сервер, который будет обрабатывать HTTP-запросы и передавать их PHP через FastCGI. Выберите образ, например, nginx:latest, и настройте конфигурацию для работы с PHP-FPM.
PostgreSQL: База данных для хранения и управления данными. Используйте образ postgres:15, чтобы получить стабильную версию СУБД. Настройте переменные окружения, такие как POSTGRES_USER и POSTGRES_PASSWORD, для доступа к базе.

Дополнительно может потребоваться:

Composer: Установите его в контейнер с PHP для управления зависимостями проекта.
Node.js: Если проект использует фронтенд-инструменты, добавьте контейнер с Node.js для сборки статических файлов.
Adminer или pgAdmin: Инструменты для удобного управления базой данных через веб-интерфейс.

Настройте сеть Docker Compose, чтобы контейнеры могли взаимодействовать друг с другом. Убедитесь, что PHP и Nginx имеют доступ к PostgreSQL через корректно настроенные переменные окружения и сетевые параметры.

Создание структуры проекта

Создайте корневую папку проекта, например, my_project. Внутри нее разместите следующие директории: app для PHP-кода, nginx для конфигурации веб-сервера, db для скриптов базы данных и docker для файлов Docker Compose.

В директории nginx создайте файл default.conf. Укажите в нем конфигурацию для обработки PHP-запросов. Например, настройте сервер на прослушивание порта 80 и передачу PHP-запросов в контейнер с PHP-FPM.

В папке db добавьте SQL-скрипты для инициализации базы данных, если это необходимо. Например, создайте файл init.sql для создания таблиц и заполнения их тестовыми данными.

В директории docker разместите файл docker-compose.yml. В нем опишите контейнеры для PHP, Nginx и PostgreSQL, указав зависимости и параметры запуска. Убедитесь, что контейнеры корректно взаимодействуют через сеть и используют общие ресурсы.

Такая структура обеспечивает удобное управление проектом и упрощает масштабирование. Каждый компонент изолирован, что облегчает отладку и внесение изменений.

Шаги по созданию папок и организации файлов для Docker Compose.

Создайте корневую папку для проекта, например, my_project. Внутри неё разместите все необходимые директории и файлы для работы с Docker Compose.

Создайте папку app для хранения PHP-кода. Внутри неё добавьте файл index.php для тестирования работы сервера. Также создайте папку src для основного кода приложения, если это требуется.

Создайте папку nginx для конфигурации веб-сервера. Внутри неё добавьте файл default.conf, где пропишите настройки для обработки запросов к PHP.

Добавьте папку db для хранения данных PostgreSQL. Внутри неё создайте файл init.sql, если требуется инициализировать базу данных при запуске контейнера.

В корне проекта создайте файл docker-compose.yml. В нём пропишите конфигурацию для контейнеров PHP, Nginx и PostgreSQL, указав пути к созданным папкам и файлам.

Добавьте файл .env в корень проекта для хранения переменных окружения, таких как логины, пароли и порты. Это упростит управление настройками.

Проверьте структуру проекта: она должна включать корневую папку с файлом docker-compose.yml, а также папки app, nginx и db. Это обеспечит удобство работы и поддержки проекта.

Написание docker-compose.yml

Создайте файл docker-compose.yml в корневой директории вашего проекта. Начните с определения версии Compose, чтобы обеспечить совместимость. Укажите version: '3.8' в начале файла.

Добавьте сервис для PHP, используя образ php:8.2-fpm. Укажите том для монтирования кода вашего проекта в контейнер, например ./:/var/www/html. Это позволит синхронизировать изменения в реальном времени. Настройте рабочую директорию с помощью working_dir: /var/www/html.

Для Nginx используйте образ nginx:1.25. Создайте конфигурационный файл Nginx и смонтируйте его в контейнер через ./nginx.conf:/etc/nginx/nginx.conf. Добавьте зависимость от PHP-сервиса с помощью depends_on: - php, чтобы Nginx запускался только после готовности PHP.

Настройте PostgreSQL, указав образ postgres:15. Определите переменные окружения для базы данных: POSTGRES_USER, POSTGRES_PASSWORD и POSTGRES_DB. Эти данные потребуются для подключения приложения к базе данных.

Добавьте сеть для взаимодействия между сервисами. Используйте параметр networks на уровне сервисов и определите общую сеть, например app-network. Это обеспечит связь между PHP, Nginx и PostgreSQL.

Пример конфигурации:


version: '3.8'
services:
php:
image: php:8.2-fpm
volumes:
- ./:/var/www/html
working_dir: /var/www/html
networks:
- app-network
nginx:
image: nginx:1.25
ports:
- "80:80"
volumes:
- ./:/var/www/html
- ./nginx.conf:/etc/nginx/nginx.conf
depends_on:
- php
networks:
- app-network
postgres:
image: postgres:15
environment:
POSTGRES_USER: user
POSTGRES_PASSWORD: password
POSTGRES_DB: app_db
networks:
- app-network
networks:
app-network:
driver: bridge

После создания файла запустите контейнеры командой docker-compose up -d. Проверьте работоспособность, открыв приложение в браузере или подключившись к базе данных через psql.

Подробное руководство по написанию основного файла конфигурации Docker Compose.

Создайте файл docker-compose.yml в корне вашего проекта. Этот файл будет содержать конфигурацию для всех сервисов: PHP, Nginx и PostgreSQL. Начните с указания версии Docker Compose, например version: '3.8', чтобы обеспечить совместимость с последними функциями.

Определите сервисы в секции services. Для PHP используйте образ, например php:8.2-fpm. Укажите том для монтирования вашего проекта в контейнер, чтобы изменения в коде сразу применялись. Пример:

php:
image: php:8.2-fpm
volumes:
- ./:/var/www/html

Для Nginx выберите образ, например nginx:latest, и настройте порты для доступа к веб-серверу. Добавьте конфигурацию для работы с PHP-FPM:

nginx:
image: nginx:latest
ports:
- "80:80"
volumes:
- ./:/var/www/html
- ./nginx.conf:/etc/nginx/conf.d/default.conf
depends_on:
- php

Для PostgreSQL используйте образ postgres:latest. Укажите переменные окружения для настройки базы данных, такие как POSTGRES_USER, POSTGRES_PASSWORD и POSTGRES_DB:

db:
image: postgres:latest
environment:
POSTGRES_USER: user
POSTGRES_PASSWORD: password
POSTGRES_DB: mydb
ports:
- "5432:5432"

Добавьте сеть для связи между контейнерами. Это упростит взаимодействие сервисов:

networks:
app-network:
driver: bridge

Подключите каждый сервис к этой сети, добавив секцию networks в их конфигурацию. Например:

php:
networks:
- app-network

Итоговый файл docker-compose.yml может выглядеть так:

version: '3.8'
services:
php:
image: php:8.2-fpm
volumes:
- ./:/var/www/html
networks:
- app-network
nginx:
image: nginx:latest
ports:
- "80:80"
volumes:
- ./:/var/www/html
- ./nginx.conf:/etc/nginx/conf.d/default.conf
depends_on:
- php
networks:
- app-network
db:
image: postgres:latest
environment:
POSTGRES_USER: user
POSTGRES_PASSWORD: password
POSTGRES_DB: mydb
ports:
- "5432:5432"
networks:
- app-network
networks:
app-network:
driver: bridge

Сохраните файл и запустите контейнеры командой docker-compose up -d. Проверьте, что все сервисы работают корректно, открыв ваш проект в браузере.

Настройка конфигураций для каждого сервиса

Для PHP создайте файл Dockerfile в корне проекта. Укажите базовый образ, например, php:8.2-fpm, и добавьте необходимые расширения:

FROM php:8.2-fpm
RUN docker-php-ext-install pdo_pgsql pdo_mysql
COPY . /var/www/html
WORKDIR /var/www/html

Для Nginx настройте конфигурационный файл nginx.conf. Определите корневую директорию и настройте обработку PHP-запросов:

server {
listen 80;
server_name localhost;
root /var/www/html/public;
index index.php;
location / {
try_files $uri /index.php$is_args$args;
}
location ~ .php$ {
include fastcgi_params;
fastcgi_pass php:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}

Для PostgreSQL используйте стандартный образ postgres:15 в docker-compose.yml. Добавьте переменные окружения для настройки базы данных:

services:
db:
image: postgres:15
environment:
POSTGRES_USER: user
POSTGRES_PASSWORD: password
POSTGRES_DB: app_db
volumes:
- postgres_data:/var/lib/postgresql/data

Объедините все сервисы в docker-compose.yml. Укажите зависимости и настройте сеть:

version: '3.8'
services:
php:
build: .
volumes:
- .:/var/www/html
depends_on:
- db
nginx:
image: nginx:latest
ports:
- "8080:80"
volumes:
- ./nginx.conf:/etc/nginx/conf.d/default.conf
depends_on:
- php
db:
image: postgres:15
environment:
POSTGRES_USER: user
POSTGRES_PASSWORD: password
POSTGRES_DB: app_db
volumes:
- postgres_data:/var/lib/postgresql/data
volumes:
postgres_data:

Проверьте корректность конфигураций, запустив контейнеры командой docker-compose up. Если все настроено верно, приложение будет доступно по адресу http://localhost:8080.

Конфигурация PHP и его зависимостей

Настройте PHP, установив необходимые расширения для работы с PostgreSQL и Nginx. В Dockerfile добавьте строку для установки зависимостей, например: RUN docker-php-ext-install pdo_pgsql pgsql opcache. Это обеспечит поддержку работы с базой данных и улучшит производительность.

Создайте файл php.ini для настройки параметров PHP. Укажите нужные значения для memory_limit, upload_max_filesize и post_max_size, чтобы адаптировать их под требования вашего проекта. Например, memory_limit = 256M и upload_max_filesize = 64M.

Для оптимизации работы с Nginx включите FastCGI кэширование. Добавьте в конфигурацию Nginx параметры fastcgi_cache_path и fastcgi_cache_key, чтобы ускорить обработку запросов. Это особенно полезно для высоконагруженных проектов.

Проверьте, что все зависимости корректно установлены и настроены. Запустите контейнер и выполните команду php -m, чтобы убедиться, что все расширения активны. Если что-то отсутствует, добавьте соответствующие строки в Dockerfile и пересоберите образ.

Как добавить необходимые расширения и настройки для PHP в Docker.

Для установки расширений PHP в Docker, используйте команду docker-php-ext-install в Dockerfile. Например, чтобы добавить расширения для работы с PostgreSQL, выполните:

RUN docker-php-ext-install pdo_pgsql pgsql

Если вам нужно установить расширения, которые не входят в стандартный набор, например gd или intl, добавьте зависимости и команды для их установки:

Установите необходимые библиотеки: RUN apt-get update && apt-get install -y libpng-dev libicu-dev
Добавьте расширения: RUN docker-php-ext-install gd intl

Для настройки PHP создайте файл php.ini и скопируйте его в контейнер. Например, чтобы увеличить лимит памяти и включить отображение ошибок, добавьте в файл следующие параметры:

memory_limit = 512M
display_errors = On
error_reporting = E_ALL

Затем в Dockerfile добавьте команду для копирования файла:

COPY php.ini /usr/local/etc/php/conf.d/custom.ini

Если требуется настроить часовой пояс, используйте переменную окружения в docker-compose.yml:

environment:
- TZ=Europe/Moscow
- PHP_INI_DATE_TIMEZONE=Europe/Moscow

Для работы с Composer добавьте его установку в Dockerfile:

RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

Эти шаги помогут настроить PHP для работы с вашим проектом, обеспечив необходимую функциональность и производительность.