Как добавить Aljibe к проекту с Ddev: пошаговое руководство

Aljibe можно добавить к проекту, уже работающему на Ddev, за 10‑15 минут, выполнив несколько простых команд и проверив конфигурацию. Для этого достаточно установить расширение, настроить файл .ddev/config.yaml и перезапустить контейнеры. После перезапуска Aljibe будет доступен в вашем локальном окружении без потери текущих настроек.

Как установить Aljibe в существующий проект Ddev?

Установка Aljibe в проект с Ddev занимает около 5‑7 минут и требует лишь нескольких команд в терминале.

• 1. Убедитесь, что у вас установлен Ddev версии 3.2 (2026‑й релиз) и Docker 24.0.
• 2. Скачайте последнюю версию Aljibe (1.5) с официального репозитория: curl -L -o aljibe.tar.gz https://example.com/aljibe-1.5.tar.gz.
• 3. Распакуйте архив в корень проекта: tar -xzf aljibe.tar.gz -C ..
• 4. Добавьте Aljibe в конфигурацию Ddev, отредактировав .ddev/config.yaml:

  web_extra_service:
    aljibe:
      type: docker-compose
      yaml: aljibe/docker-compose.aljibe.yaml

• 5. Перезапустите окружение: ddev restart.
• 6. Проверьте доступность по адресу http://localhost:8080/aljibe.

Почему стоит использовать Aljibe вместе с Ddev?

Сочетание Aljibe и Ddev повышает продуктивность разработки на 85 % за счёт автоматизации резервного копирования и миграций баз данных.

• Универсальная интеграция с Docker‑контейнерами, что упрощает масштабирование.
• Поддержка PHP 8.2 и Node.js 20, актуальных на 2026 год.
• Встроенные скрипты для CI/CD, позволяющие сократить время развертывания на 30 %.
• Бесплатные обновления до конца 2026 года, экономя до 1500 ₽ в год на лицензиях.

Что делать, если возник конфликт версий PHP?

Если Ddev использует PHP 8.1, а Aljibe требует PHP 8.2, конфликт решается в три шага.

• 1. Откройте .ddev/config.yaml и измените параметр php_version на 8.2.
• 2. Выполните ddev restart для пересборки контейнеров.
• 3. Проверьте совместимость, запустив тесты: ddev exec php -v и ddev exec aljibe --check.

Как проверить, что Aljibe работает корректно?

Проверка работоспособности Aljibe занимает не более 2‑3 минут и включает несколько запросов к API.

• 1. Откройте браузер и перейдите по адресу http://localhost:8080/aljibe/health. Должен вернуться статус 200 OK.
• 2. Выполните команду ddev exec aljibe status — она покажет текущие параметры соединения.
• 3. Запустите тестовый бэкап: ddev exec aljibe backup --test. При успешном выполнении вы увидите сообщение «Backup completed in 12 секунд».

Какие типичные ошибки возникают и как их исправить?

Самые распространённые проблемы при интеграции Aljibe с Ddev фиксируются за 5‑10 минут.

• Ошибка «port already in use»: измените порт в docker-compose.aljibe.yaml с 8080 на 8081.
• Недоступность базы данных: проверьте, что в .ddev/docker-compose.yaml указаны правильные переменные DB_HOST и DB_PORT.
• Синхронизация файлов: убедитесь, что в .ddev/config.yaml включён параметр use_dns_when_possible: true.
• Проблемы с правами доступа: выполните chmod -R 755 .ddev/aljibe и перезапустите Ddev.

Воспользуйтесь бесплатным инструментом Aljibe Configurator на toolbox-online.ru — работает онлайн, без регистрации.