Skip to content

Усталёўка для распрацоўшчыкаў

Jump to bottom Edit New page
Alies Lapatsin edited this page Mar 26, 2021 · 1 revision

Тэхнічныя патрабаванні да распрацоўкі

  • Apache (rewrite _mod on, for virtual host directory too: AllowOverride All )
  • Адна з БД (поўны спіс падтрымліваемых СКБД)
    • MySQL >= 5.5 (дэфолтавы варыянт)
    • PostgreSQL
    • MSSQL Server
  • PHP >= 7.1.3 (разам з ext-pdo, ext-curl, ext-json, ext-mbstring, ext-dom)
  • Дадаткова для тэстаў:
    • PHP extension ext-zip
    • SQLite
  • На базе фрэймворка Laravel 5.8
  • Composer
  • Node версія >= 12.0

Як зрабіць свой унёсак

Як ставіць віджэт (кліентскую частку) Doika

Усталёўка

1. Робім свой форк і сцягваем яго да сябе

  1. Заходзім у рэпазіторый https://github.com/diglabby/doika і ствараем для сябе fork
  2. Дадаем змесціва fork рэпазіторыя ў корань вашага сайта з дапамогай git clone. Пераключаемся на dev branch, з дапамогай git checkout (напрыклад, git checkout dev)

Далей ёсць некалькі варыянтаў як паставіць Дойку, праз Docker - самы просты, мы катэгарычна раім яго.

2.a. Праз Docker

  1. Усталяваць Docker https://www.docker.com/get-started
  2. З дырэкторыі копіі вашага форка запускаем паслядоўна каманды (альтэрнтаўына можаце усталяваць уручную: лакальнаня усталёўка Doika праз Docker):
    • make build (для Linux, MacOS) ці makefile.bat build (для Windows).
    • make start (для Linux, MacOS) ці makefile.bat start (для Windows).
    • make install (для Linux, MacOS) ці makefile.bat install (для Windows).
  3. Праект дасяжны на адрэсе http://127.0.0.1:8080 праз браўзер.

2.b. На Linux

  1. Заходзім у рэпазіторый https://github.com/diglabby/doika.git і ствараем для сябе fork
  2. Дадаем змесціва fork рэпазіторыя ў корань вашага сайта з дапамогай git clone(git clone https://github.com/diglabby/doika.git). Пераключаемся на dev branch, з дапамогай git checkout (напрыклад, git checkout develop)
  3. Неабходна вызначыць групу і карыстальніка для ўсіх файлаў модуля камандай: sudo chown -R www-data:www-data .
  4. З тэрмінала запусціць каманду sudo composer install. Вы павінны запусціць з карнявой дырэкторыі doika (часта узнікаемая праблема пры ўсталёўцы).
  5. З тэрмінала запусціць каманду sudo npm install. Вы павінны запусціць з карнявой дырэкторыі doika (Тут магчыма вырашэнне папулярнага бага https://stackoverflow.com/a/52658196)
  6. Выконваем зборку фронтэнда sudo npm run dev (нават лепей sudo npm run watch)
  7. Рыхтуем канфіг файл. Для гэтага ў тэчцы doika ствараем копію файла .env.example і надаем яму імя .env (падказка: выканаць каманду cp .env.example .env)
  8. Рыхтуем пустую Mysql базу.
  9. Дадаем у файл .env свае дадзеныя, для падключэння к базе, створанай на папярэднім кроку DB_DATABASE={назва_базы} DB_USERNAME={лагін_для_падключэння} DB_PASSWORD={пароль}
  10. Разгортваем базу дадзеных камандай php artisan migrate.
  11. Пасля дадаем зыходныя дадзеныя камандай php artisan db:seed
  12. Генерым ключ для laravel: зайсцi у папку doika праз i выканаць sudo php artisan key:generate
  13. Усталяваная версія павінна запускацца на Вашым лакальным хасце са шляхам http://[host-name]/doika/doika/dashboard/login

2.c. На Windows (Open Server)

  1. Адкрыць налады Open Server(min PREMIUM edition), укладка дамены, ручное кіраванне, напісаць імя дамена, на прыклад doika, папка дамена выбраць localhost
  2. Адкрыць укладку сервер, налады выкарыстання зменнай Path выбраць Свой Path + Win Path, паставіць каўку ў чэк-боксе запускаць сервер ў агрэсіўным рэжыме
  3. Адкрыць ўкладку модулі, выбраць Apache 7.2, PHP 7.2, MySQL 5.7, захоўваем, запускаем сервер
  4. Заходзім у рэпазіторый https://github.com/diglabby/doika.git і ствараем для сябе fork. Націскаем clone or download і капіруем адрас
  5. Запускаем кансоль git из Open Server (мае закладкі - Git-CMD). З кансолі заходзім у тэчку localhost (напрыклад, cd d:\OSPanel\domains\localhost {шлях да тэчцы localhost}) і клоніруем туды праект пры дапамозе git clone (git clone https://github.com/diglabby/doika.git)
  6. Заходзім з кансолі ў тэчку doika (каманда cd doika) і пры дапамозе гіт пераключаемся на develop branch (git checkout develop)
  7. З тэрмінала запусціць каманду composer install. Вы павінны запусціць з карнявой дырэкторыі doika
  8. З тэрмінала запусціць каманду npm install. Вы павінны запусціць з карнявой дырэкторыі doika
  9. Выконваем зборку фронтэнда npm run dev. Вы павінны запусціць з карнявой дырэкторыі doika
  10. Рыхтуем пустую Mysql базу. Адкрываем PhpMyAdmin (127.0.0.1/openserver/phpmyadmin/index.php), ствараем новую БД.
  11. Рыхтуем канфіг файл. Для гэтага ў тэчцы doika ствараем копію файла .env.example і надаем яму імя .env
  12. Дадаем у файл .env свае дадзеныя, для падключэння к базе, створанай на папярэднім кроку DB_DATABASE={назва_базы} DB_USERNAME=root (калі не мянялі) DB_PASSWORD= (пуста калі не устонаўлівалі пароль)
  13. Разгортваем базу дадзеных камандай php artisan migrate. Вы павінны запусціць з карнявой дырэкторыі doika
  14. Пасля дадаем зыходныя дадзеныя камандай php artisan db:seed. Вы павінны запусціць з карнявой дырэкторыі doika
  15. Генерым ключ для laravel камандай php artisan key:generate. Вы павінны запусціць з карнявой дырэкторыі doika
  16. Усталяваная версія павінна запускацца на Вашым лакальным хасце са шляхам http://[host-name]/doika/doika/dashboard/login

Дадзеныя старонкі закліканы значна палегчыць працу з кодам праекта doika распрацоўшчыку. Можаце іх рэдагаваць і дапаўняць - гэта знізіць колькасць складаных сітуацый пры распрацоўцы.

Clone this wiki locally