vo1ce-x / pop-it-mvc

dev-main 2026-04-24 11:29 UTC

Requires

• php: ^8.0.2
• ext-pdo: *
• illuminate/database: ^9.0
• illuminate/events: ^9.0
• nikic/fast-route: ^1.3
• vo1ce-x/collection: dev-main

Requires (Dev)

• phpunit/phpunit: ^9.6

MIT

• Daniil Kiryakov

Published on Packagist.org on 2026-04-24 11:29 UTC

README

Окружение использует или содержит следующие компоненты:

• Docker - контейнеризация приложений
• Docker Compose - управление контейнерами
• Apache + PHP - контейнер с веб-сервером Apache и php
• Mariadb 10.7 - контейнер с СУБД Mariadb 10.7
• Phpmyadmin - контейнер с Phpmyadmin

1. Установка

Примечание: для работы окружения нужен установленный docker и docker compose

Склонировать репозиторий

git clone https://github.com/jurapro/web-base

2. Настройка

Скопировать файл .env.example в .env и заполнить его:

1. PROJECT_NAME - название проекта. По-умолчанию project;
2. USER - логин пользователя под которым будет запущен веб-сервер в контейнере с php. Если пустой, то логин текущий логин ползователя или user (зависит от операционной системы). Также такой пользователь будет создан для доступа к базе данных в контейнере с mariadb;
3. PASSWORD - пароль пользователя внутри контейнера с php. По-умолчанию password;
4. WEB_PORT - порт для веб-сервера. По-умолчанию 8080;
5. DB_DRIVER - драйвер БД. По-умолчанию mysql;
6. DB_HOST - хост БД. Для БД на хост-машине из Docker используй host.docker.internal;
7. DB_PORT - внешний порт MariaDB на хост-машине. По-умолчанию 3036;
8. DB_CONTAINER_PORT - внутренний порт MariaDB внутри docker-сети. По-умолчанию 3306;
9. DB_DATABASE - имя базы данных;
10. DB_USERNAME - пользователь БД;
11. DB_PASSWORD - пароль БД;
12. DB_AUTO_SETUP - если true, проект добавляет демо-учётки [e-mail] и [e-mail] с паролем telephony123; рабочая схема таблиц создаётся автоматически в любом случае;
13. DB_ROOT_PASSWORD - пароль root для контейнера MariaDB;
14. WEB_PORT_PHPMYADMIN - порт для phpmyadmin. По-умолчанию 8081.

Контейнеры php и phpmyadmin всегда подключаются к MariaDB по внутреннему адресу db:3306, поэтому данные, которые видны в phpMyAdmin на http://localhost:8081, и данные приложения совпадают.

3. Запуск и остановка

Для запуска окружения необходимо в директории с docker-compose.yml выполнить командц docker compose up -d.

Для остановки окружения необходимо в директории с docker-compose.yml выполнить командц docker compose down.

4. Тесты

Для phpunit в PHP должны быть доступны расширения dom, json, libxml, mbstring, xml, xmlwriter.

В этом проекте проще всего запускать тесты в контейнере:

docker compose exec php ./vendor/bin/phpunit

Если запускаешь тесты локально, установи эти расширения в свой PHP-интерпретатор. Иначе phpunit завершится ошибкой проверки platform requirements.