Установка
Это руководство проведёт вас через процесс установки Imhotep на вашу локальную машину или сервер. Мы рассмотрим как классическую установку через Composer, так и быстрый старт с помощью Docker, который сделает окружение готовым к работе за несколько минут.
Предварительные требования
Перед началом установки убедитесь, что ваша система соответствует следующим требованиям:
- PHP >= 8.2
- PHP Extension: MbString, Gd, Curl
- Composer
- Для Docker-установки: Docker Desktop или Docker Compose
Установка через Composer
Создание нового проекта
composer create-project imhotep/imhotep example-appПримечание: Убедитесь, что PHP и Composer установлены. Для пользователей macOS можно использовать Homebrew brew install php composer:
Запуск локального сервера
После создания проекта, вы можете запустить локальный сервер разработки Imhotep, выполнив команду php server в корневом каталоге проекта:
cd example-app && php serverПосле успешного запуска локального сервера в консоли появится информация об успешном запуске и ссылка на ваше приложение, например:
> PHP 8.X.X Development Server (http://127.0.0.1:8000) startedУстановка с использованием Docker
Docker позволяет запустить Imhotep в изолированном окружении без ручной настройки PHP и зависимостей.
Общие шаги для всех ОС
1. Установите Docker Desktop.
2. Создайте приложение (замените example-app на имя вашего проекта):
curl -s "https://install.imhotep.dev/example-app" | bashИмя проекта должно содержать только латинские буквы, цифры, дефисы и подчеркивания.
3. Запустите окружение:
cd example-app
./vendor/bin/docker up4. Выполните миграции базы данных:
./vendor/bin/docker imhotep migrate5. Откройте приложение в браузере: http://localhost
Особенности для разных операционных систем
macOS
- Просто установите Docker Desktop
- Дополнительных настроек не требуется
Windows
- Установите WSL2 (Windows Subsystem for Linux 2)
- Настройте Docker Desktop для работы с WSL2
- Используйте терминал WSL для выполнения команд
Linux
- Установите Docker Desktop или Docker Compose
- При использовании Docker Desktop выполните
docker context use default
Выбор сервисов Docker
При развертывании нового приложения Imhotep, вы можете использовать переменную with в строке запроса для выбора необходимых для установки сервисов:
# Установка с MySQL и Redis
curl -s "https://install.imhotep.dev/example-app?with=mysql,redis" | bash
# Установка с PostgreSQL
curl -s "https://install.imhotep.dev/example-app?with=postgres" | bashДоступные сервисы: mysql, postgres, redis, memcached
По умолчанию: устанавливаются mariadb и redis
Для опытных пользователей: вы можете напрямую редактировать файл docker-compose.yml для тонкой настройки окружения.
Что дальше?
После создания первого Imhotep проекта, рекомендуем ознакомиться с основными принципами работы: