Docker. Как за 30 минут создать окружение для php разработки

UPD: На текущий момент (январь 2023) я использую MAMP для рабочего окружения на Mac Silicon. Это более легковесное решение, которое подходит только для macbook.
***

В этой статье пошагово расскажу как создать рабочее окружение, чтобы развернуть веб проект (lamp) на mac os / windows c помощью Docker используя https://github.com/sprintcube/docker-compose-lamp.

Для кого эта статья

• Для разработчиков, особенно для тех, кто незнаком с docker. Минимум теории, что и как работает, и сразу же получаете готовое окружение
• Для всех других специальностей, кто хочет развернуть полноценный виртуальный web сервер у себя на компьютере и почувствовать себя разработчиком

Как все будет работать в итоге

• Мы установим следующую сборку: PHP (можно выбрать 5.4 – 8.3), Apache, MySQL, phpMyAdmin. Сможем зайти из браузера на localhost и запустить ваш проект (или просто в данном случае index.php)
• Будет папка, в которой хранится ваш проект. Т.е. используете ваш любимый IDE для разработки. Со всеми файлами вы работаете из своей родной ОС (mac/windows).
• Докер сделает виртуальный контейнер, в котором запустит необходимую сборку (в нашем случае lamp) и все файлы будут синхронизированы
• Доступны конфиги php.ini, apache, дампы mysql, которые загружаются в виртуальный контейнер docker
• при желании c помощью командной строки можно зайти на виртуальный сервер (контейнер) и сделать при желании там все необходимое (подправить конфиг, запустить команду и тд).

Почему docker?

Можно конечно же установить на саму операционную систему необходимые компоненты, например – php, mysql, nginx/apache. Однако, это не совсем правильно, ввиду того, что среда разработки должна соответствовать среде исполнения вашего приложения. На хостинге это как правило linux, – поэтому и среда разработки должна быть тоже linux.

• Докер уже набрал огромную популярность, почти в любой вакансии разработчика и не важно какого указано требование – уметь пользоваться докером.
• Докер применяется как для разработки, так и для продакшена. Есть множество хостингов для ваших докер контейнеров: https://geekflare.com/docker-hosting-platforms/
• Не важно какая у вас ОС (windows, mac, linux) – установите Докер, сделайте сборку контейнеров и получите рабочее окружение.
• Создавайте под каждый свой проект – уникальное окружение со специфическими конфигурациями, легко делитесь этим окружением с другими разработчиками и им не нужно будет муторно настраивать под каждый проект уникальное окружение.

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

Мой опыт

Лет 5 назад я начал пользовался vagrant + puphpet, и это было достаточно удобное решение, но столкнувшись однажды с проблемой обновления версии php, а также с проблемой медленной синхронизации файлов mac – я решил перейти на docker. Также его использую когда нужно запустить проект на windows. Но на windows он оказался куда капризней.

Надо сказать, что я сразу не смог разобраться и настроить docker – было несколько этапов взятия. Поэтому я для себя нашел оптимальное решение, с чем и хочу поделиться.

И то я очень много в нем не знаю, docker это очень обширная тема, и разбираться в нем и изучать его можно очень долго.

Начинаем установку

1. Устанавливаем git, чтоб он был доступен из командной строки. Процесс описывать не буду, это легко гуглится.

2. Устанавливаем сам Docker desktop for mac/windows https://docs.docker.com/docker-for-mac/install/
https://docs.docker.com/docker-for-windows/install/

Затруднений при установке возникнуть не должно, делать все как описано в инструкции по этим ссылкам. Главное чтоб у вас установился Docker desktop, чтобы его иконка отображалась в строке состояния со статусом: is running

В процессе установки на своё усмотрение выделяете необходимое кол-во ядер, памяти и места на женском диске. Для windows не забудьте в настройках указать раздел жесткого диска.

3. Проверяете установился ли Докер. Когда вы установили сам клиент docker – открываете командную строку и вводите:

docker -v

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

Если все хорошо на этом шаге – то, отлично, переходим дальше!

4. Теперь мы выберем сборку контейнеров для докера и создадим папку, в которой все это будет храниться.

Вообще можно собрать конечно самому сборку и я вначале так и пытался сделать, однако столкнулся с множеством проблем, чтением мануалов. Что привело меня к поиску уже готовой сборки для веб сервера. И я такую нашел: https://github.com/sprintcube/docker-compose-lamp

В нее входят следующие компоненты:

• PHP (вы сами можете выбрать нужную вам 1 из 6 версий. начиная с 5.4 до 7.4)
• Apache
• MySQL
• phpMyAdmin
• Redis

Теперь нужно создать папку куда мы ее скачаем. У меня это – /Users/your_name/Documents/docker/lamp

lamp – это название сборки (в первую очередь для меня, чтобы не забыть)

5. Далее читаем Installation https://github.com/sprintcube/docker-compose-lamp переходим в папку и выкачиваем файлы с репозитория:

cd /Users/your_name/Documents/docker/lamp
git clone https://github.com/sprintcube/docker-compose-lamp.git .
#Дожидаемся окончания скачивания файлов.
git fetch --all
git checkout 7.4.x # здесь указываем нужную нам версию php
cp sample.env .env # смотрим для справки что содержится в этом файле
docker-compose up -d # и эта очень важная строка мы ее разберем в пункте ниже

6. Команда docker-compose up -d

Это команда обращается к пакетному менеджеру docker, скачивает и устанавливает (если еще не установлены) все компоненты которые описаны в docker-compose.yml – собирает их вместе и запускает контейнеры.

В файле docker-compose.yml – вы увидите какие именно это пакеты и как они прописаны. Обязательно откройте этот файл и ознакомьтесь с содержимым!

Первый раз процесс скачивания и установки может быть немного длительным, и в результате в командной строе должно отобразиться:

docker-compose up -d
#тут будет отображаться много строк процесса установки
Creating 5.7-mysql ... done
Creating sc-redis  ... done
Creating 7.2.x-webserver ... done
Creating sc-phpmyadmin   ... done

Поздравляю! Теперь можете заходить на localhost и отобразиться страничка, которая расположена по адресу /Users/your_name/Documents/docker/lamp/www/index.php

Разумеется, вы ее меняете, закачиваете в папку свой проект и наслаждаешь дальнейшей разработкой!

---

Дополнение. Добавляем еще неограниченное кол-во хостов с проектами

Т.к. у меня несколько проектов, а настройки веб сервера одни и теже, то вот что я делаю чтобы запускать свои сайты на виртуальных доменах.

1. нужно добавить строчки в /etc/hosts на вашей машине mac (или windows – c:\windows\system32\drivers\etc\hosts), чтоб ваша операционная система понимала по какому адресу обращаться при запросе вашего хоста.

sudo nano /etc/hosts
#добавляем строчки с вашими сайтами
127.0.0.1 site1
127.0.0.1 site2

нажимаем ctrl + o, ctrl+x (перезаписываем и сохраняем файл)

2. добавляем в файл конфига /Users/your_name/Documents/docker/lamp/config/vhosts/default.conf следующие строчки, он будет синхронизирован с контейнером Докер.

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot "/var/www/html/test1"
    ServerName test1
	<Directory "/var/www/html/test1">
		AllowOverride all
	</Directory>
</VirtualHost>

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot "/var/www/html/test2"
    ServerName test2
	<Directory "/var/www/html/test2">
		AllowOverride all
	</Directory>
</VirtualHost>

3. Чтобы наши изменения вступили в силу – перезапускаем контейнеры:

docker down
docker-compose up -d

Дополнение. Настройки окружения

В процессе разработки порой нужно менять настройки того же php.ini

Все изменения, которые вы прописываете в php.ini, прописывайте в config/php/php.ini – и далее вам нужно обновить этот конфиг (пересобрать контейнеры) уже знакомой командой:

docker down
docker-compose up -d

И запуститься ваш контейнер, но уже с примененными новыми настройками.

Во первых таким образом php.ini будет у вас под рукой, и самое удобное – можно быстро применить сделанные настройки на другом компьютере (или с кем-то поделиться настройками вашего проекта)!

Редактируем конфиг docker-compose для phpmyadmin

Указываем контейнеру phpmyadmin наш php.ini добавив строчку в volumes.

volumes: 
      - ${PHP_INI-./config/php/php.ini}:/usr/local/etc/php/conf.d/php-phpmyadmin.ini

Мой конфиг php.ini

memory_limit = 300M
post_max_size = 50M
upload_max_filesize = 40M
max_execution_time = 200

Если нужен Imagick (php-imagick)

1. Добавляем следующие строки в файл docker-compose-lamp/bin/webserver/Dockerfile

# install imagick
RUN apt-get -y install libmagickwand-dev
RUN pecl install imagick
RUN docker-php-ext-enable imagick

2. Далее пересобираем наш контейнер

docker-compose up -d # run all services
docker-compose stop webserver # stop only one. but it still running !!!
docker-compose build --no-cache webserver 
docker-compose up -d --no-deps # link webserver to other services

Подключение к контейнеру веб сервера через SSH

docker-compose exec webserver bash

Заключение

Надеюсь, эта статья помогла Вам разобраться на начальном этапе с Докер, и у вас получилось развернуть окружение. Если возникли ошибки – пишите в комментариях, я постараюсь помочь, возможно я с ними уже сталкивался.