cookyii/project

Base application for Cookyii CMF

Installs: 42

Dependents: 0

Suggesters: 0

Security: 0

Stars: 4

Watchers: 2

Forks: 1

Open Issues: 0

Type:yii2-extension

This package is not auto-updated.

Last update: 2024-10-26 18:33:16 UTC


README

cookyii/project это каркас приложения Yii 2 оптимизированный под средние и большие проекты, которые состоят из нескольких приложений (как правило - админа + публичный сайт, но могут добавляться и другие виды. Например rest, erp, crm, мобильное приложение и тд).

Каркас включает базовые функции для работы cms, а также предоставляет инфраструктуру для работы готовых модулей, реализующий ту или иную функциональность.

Yii2

Структура директорий

На данный момент в шаблоне представлено три приложения - frontend, backend и crm. Это всего лишь пример набора приложений. Можно смело удалять любые приложения, либо создавать свои собственные.

conf.d/                 файлы конфигурации для окружения (например nginx или rabbitmq)
common/                 общие компоненты для всех приложений
frontend-app/           код приложения frontend
frontend-assets/        ресурсы для приложения frontend
frontend-modules/       модули приложения frontend
backend-app/            код приложения backend
backend-assets/         ресурсы для приложения backend
backend-modules/        модули приложения backend
crm-app/                код приложения crm
crm-assets/             ресурсы для приложения crm
crm-modules/            модули приложения crm
messages/               переводы языковых строк для всех приложений
resources/              модели ActiveRecord для всех приложений
vendor/                 пакеты сторонних разработчиков

Структура директорий внутри проиложения

frontend-assets/        исходники ресурсов, которые будут опубликованны в публичной части приложения
frontend-app/
    assets/             бандлы с ресурсами приложения
    components/         компоненты приложения
    config/             конфигурация приложения
    controllers/        контроллеры приложения
    tests/              автоматические тесты приложения
    views/              представления (view) приложения
    web/                публичная часть приложения, доступная из веба
    widgets/            виджеты приложения

Структура директорий внутри модуля

frontend-modules/
    ModuleName/
        assets/             ресурсы и бандлы для модуля
        commands/           контроллеры команд для выполнения в терминале (cli)
        components/         компоненты модуля
        controllers/        контроллеры модуля
        views/              представления (view) модуля
        widgets/            виджеты модуля

Системные требования

Установка (first deploy)

  1. В консоли выполните команду

    composer create-project --prefer-dist --stability=dev cookyii/project new-project
  2. Перейдите в директорию new-project и запустите процес инсталяции с помощью команды ./build install. Скрипт задаст несколько вопросов и выполнит следующие действия:

    • Создаст новую схему в базе данных (install/database)
    • Создаст нового пользователя в базе данных и даст ему права на доступ к новой схеме (install/mysqlUserName)
    • Скопирует файл .env.dist.php в .env.php и заполнит некоторые поля автоматически.
  3. Проверьте, что в созданном файле конфигурации .env.php заполнены все необходимые поля.

  4. (опционально) Скопируйте файлы ~/*-app/.credentials.dist.php в ~/*-app/.credentials.php (в директориях приложений), заполнить необходимые данные.

  5. Соберите билд с помощью команды ./build (для продакшена ./build prod).

  6. Создайте нового пользователя - администратора с помощью команды ./yii account/add

  7. (опционально) Если Вам не нужны приложения crm и backend, Вы можете удалить директории crm-app, crm-assets, crm-modules, backend-app, backend-assets и backend-modules. Аналогично, если Вам нужно какое-то дополнительное приложение (например rest), Вы можете создать схожие директории.

  8. Настройте виртуальные хосты для Ваших приложений, например:

    new-project.com     ->  .../frontend-app/web
    backend.new-project.com ->  .../backend-app/web
    crm.new-project.com     ->  .../crm-app/web
    

Вот и всё, восемь простых шагов =)

После всех этих манипуляций, Ваш новый сайт должен быть доступен по адресу new-project.com.

Обновление проекта (deploy)

  1. Обновите кодовую базу проекта из Вашего репозитория (например git pull).
  2. Соберите билд с помощью команды ./build (для продакшена ./build prod).

Настройка

Вы можете изменять любые настройки в директориях ./common/config/, ./frontend-app/config/, ./backend-app/config/, ./crm-app/config/, ./console-app/config/ и в конфигурации билда проекта.

Доступные команды ./build

  • ./build install - запустить процесс установки.
  • ./build или ./build dev - собрать проект для dev площадки.
  • ./build demo - собрать проект для demo площадки.
  • ./build prod - собрать проект для продакшена.

Дополнительно доступны следующие команды (они выполняются в рамках set/* команд, и сюда добавлены только для справки):

  • ./build map - показать список всех команд.
  • ./build self/update - обновить библиотеку сборки build.phar.
  • ./build clear - удалить все временные файлы и логи во всех приложениях.
  • ./build clear/* - удалить все временные файлы и логи в конкретном приложении.
  • ./build composer - установить composer зависимости из composer.lock.
  • ./build composer/update - скачать новые версии composer зависимостей и обновить composer.lock.
  • ./build composer/install - скачать новые версии composer зафиксированные в composer.lock.
  • ./build composer/install-prod - скачать новые версии composer зафиксированные в composer.lock без require-dev.
  • ./build composer/selfupdate - обновить composer.
  • ./build composer/update-fxp - обновить плагин fxp/composer-asset-plugin.
  • ./build npm/install - установить зависимости npm.
  • ./build npm/update - обновить зависимости npm.
  • ./build bower/install - установить зависимости bower.
  • ./build bower/update - обновить зависимости bower.
  • ./build migrate - выполнить все новые миграции для всех приложений.
  • ./build migrate/* - выполнить все новые миграции для конкретного приложения.
  • ./build rbac - обновить правила rbac для всех приложений.
  • ./build rbac/* - обновить правила rbac для конкретного приложения.
  • ./build less - скомпилировать less для всех приложений.
  • ./build less/* - скомпилировать less для конкретного приложения.