Skip to content

Latest commit

 

History

History
163 lines (109 loc) · 7.45 KB

README.sr-cyr.md

File metadata and controls

163 lines (109 loc) · 7.45 KB
Raw

Laravel Skeleton (basic)

Ларавел стартер пројекат, за дефинисање стандарда и брзину покретања 🚀

Прочитајте ово на другим језицима: English, Srpski

Почетак

Ове инструкције ће вам дати копију пројекта и помоћи ће вам да га покренете на локалној машини у сврси развоја и тестирања. Погледајте deployment за напомене о томе како имплементирати пројекат на живом систему.

Предуслови

  1. Composer
  2. Docker

Инсталација

Корак по корак низ примера који ће вам показати како да покренете пројекат за развој.

Прво, потребно је да креирамо пројекат и скинемо инстанцу пројекта са репозиторијума.

composer create-project cubes-doo/laravel-skeleton-basic newProjectName

Сада, ако желите да користите доцкер, прво свуците докер датотеке са нашег 'docker-compose' гит репозиторијума:

git clone https://github.com/cubes-doo/docker-compose.git docker

Следеће, треба копирати docker/.env.example у нову docker/.env датотеку

cp docker/.env.example docker/.env

Сада, нешто много узбудљивије 😁, покренућемо наш доцкер контејнер!

sudo docker/docker-start.sh

Пошто може доћи до неслагања UID-a на различитим машинама, покренућемо:

cd docker ; ./docker-usermod.sh ; cd ../

за сваки случај. Кратко објашњење: kоришћење ове команде обезбеђује да имате исте привилегије као корисник у докер контејнеру, као што би имали на својој машини.

Сада можемо покренути:

sudo docker/docker-console.sh

како бисмо ушли у докер конзолу, и онда у њој покрећемо:

composer install

у датотеци .енв у роот-у пројекта проверити да ли постоји APP_KEY и да ли има вредност (пример: 'APP_KEY=base64:Q1teAHYgmZtZ5ZFD1CJZp8yzlQuBqUeXsz3Mn++/yl3='), ако нема покренути:

php artisan key:generate

За прављење основне стрктуре базе и пуњење тест подацима, неопходним за почетак рада, покренути:

php artisan migrate --seed

и спремни сте за почетак рада на пројекту!

Тема theme коришћена на овом пројекту, развијена од стране Coderthemes, није бесплатна.Тако да овај пројекат вам неће значити без плаћене лиценце. Уколико сте један од наших колага у "Cubes"-у Cubes, позиционирајте се у public/ директоријум:

cd public

и клонирајте тему са гитлаб репозиторијума:

git clone git@gitlab.cubes.rs:web/laravel-skeleton-theme.git theme

Слободно се улогујте и истражујте! По дефаулт-у пројекат је постављен на http://localhost:7737. Уколико вам то не одговара, можете променити дати урл у датотекама docker/.env и .env .

Провера кода

Тренутнo користимо само FriendsOfPHP/PHP-CS-Fixer, као "composer"-ову зависност. Можете пронаћи правила у .php_cs.

Постоје и две команде које олакшавају проверу кода:

sudo docker/docker-php-cs-check.sh

ради "dry-run" "php-cs-fixer"-а, обавештава вас само шта треба бити промењено

и

sudo docker/docker-php-cs-fix.sh

заправо исправља код помоћу "php-cs-fixer"-a

Покретање тестова

Направили смо скрипту, која покреће тестове у оквиру докер контејнера:

sudo docker/docker-unit-test-run.sh

Ова скрипта ће изводити све изложене тестове у tests/ директоријуму.

Постављање

Додатне напомене о томе како имплементирати пројекат на живом систему

Литература

Направљено са

  • Composer - ПХП систем управљања пакетима
  • Laravel 5.8 - Коришћен "framework"
  • Docker - Контејнерска платформа

Verzionisanje

Користимо SemVer за верзионисање. За доступне верзије, погледајте тагове на репозиторијуму.

Autori

Такође погледајте листу сарадника који учествују на овом пројекту.