| 1 |
b0d8dc91
|
Petr Pícha
|
# Aplikace pro muzea - MERLOT
|
| 2 |
|
|
|
| 3 |
0edf15e2
|
Marek Lovčí
|
## Jak zprovoznit projekt
|
| 4 |
ba755e4b
|
zabran
|
|
| 5 |
fd04f103
|
zabran
|
1. Stáhněte **PHPStorm** (zdarma přes školní licenci), **PHP** (ideálně verze 7.4 a výš, minimálně verze 7.2.5) a **Composer**. Všechny tyto nainstalujte (PHP se neinstaluje).
|
| 6 |
|
|
2. Ve složce s PHP přejmenujte _php.ini-developement_ na _php.ini_ a v souboru odkomentujte všechny extension kromě _ffi_, _ftp_, _mbstring_, _exif_, _oci8_12c_, _openssl_, _pdo_firebird_, _pdo_oci_.
|
| 7 |
|
|
3. V PHPStormu aktivujte školní licenci a natahejte přes **Settings/Plugins** potřebné pluginy (např. **Laravel**).
|
| 8 |
|
|
4. V PHPStormu v **Settings/Languages & Frameworks/PHP** vyberte používanou verzi PHP. Pravděpodobně budete muset ručně vybrat celou cestu do složky v include path i k interpretu php.
|
| 9 |
|
|
5. V PHPStormu v **Settings/Languages & Frameworks/PHP/Composer** vyberte cestu ke composeru a příslušný PHP interpreter. Doporučuji cestu vybrat ručně k _composer.phar_.
|
| 10 |
|
|
6. Vytvořte libovolným způsobem místní repozitář a pullněte projekt (já používám _Sourcetree_).
|
| 11 |
|
|
7. Otevřete přes běžnou **cmd** složku projektu a spusťte následující sadu příkazů:
|
| 12 |
|
|
1. `composer install` - bude se chvíli instalovat.
|
| 13 |
|
|
2. `copy .env.example .env` (pro Linux: `cp .env.example .env`)
|
| 14 |
|
|
3. `php artisan key:generate`
|
| 15 |
|
|
8. V PHPStorm v **Run/Edit Configurations** přidejte **PHP Build-in Web Server** , jeho _document root_ je složka projektu a _use router script_ ukazuje na **server.php** ve stejné složce.
|
| 16 |
|
|
9. Spusťte projekt projekt. Na localhost by vám měl vyjet nápis **Laravel** s funkčním menu.
|
| 17 |
8e9897d4
|
zabran
|
|
| 18 |
0edf15e2
|
Marek Lovčí
|
## Jak zprovoznit databázi
|
| 19 |
8e9897d4
|
zabran
|
|
| 20 |
|
|
1. Zajistěte databázi se spojením určeným v souboru `.env`.
|
| 21 |
|
|
2. Spusťte v terminálu (PHPStorm nebo cmd ve složce projektu) příkaz `php artisan migrate`.
|
| 22 |
|
|
|
| 23 |
0edf15e2
|
Marek Lovčí
|
### SQLite databáze
|
| 24 |
41eaf441
|
Adam Mištera
|
|
| 25 |
ab1bb0fc
|
Adam Mištera
|
1. Soubor SQLite databáze umístěte do `database\database.sqlite` (může to být i nový prázdný soubor).
|
| 26 |
41eaf441
|
Adam Mištera
|
2. Pro připojení k databázi je v potřeba v souboru `.env` nastavit `DB_CONNECTION=sqlite` (ostatní nastavení pro databázi odstranit).
|
| 27 |
|
|
3. Pro **čistou** migraci spusťte příkaz `php artisan migrate:fresh`.
|
| 28 |
ab1bb0fc
|
Adam Mištera
|
|
| 29 |
0edf15e2
|
Marek Lovčí
|
### Seeding
|
| 30 |
|
|
|
| 31 |
|
|
Pro vygenerování testovacích dat stačí spustit "seed".
|
| 32 |
|
|
|
| 33 |
|
|
```shell script
|
| 34 |
|
|
php artisan db:seed
|
| 35 |
|
|
```
|
| 36 |
|
|
|
| 37 |
|
|
Případně `php artisan migrate:refresh --seed`.
|
| 38 |
|
|
|
| 39 |
|
|
Migrace dat z Mockaroo je tímto okamžikem obsolete.
|
| 40 |
|
|
|
| 41 |
|
|
## Jak zprovoznit bootstrap a kompilaci SASS souborů
|
| 42 |
ab1bb0fc
|
Adam Mištera
|
|
| 43 |
|
|
1. Ujistěte se, že v sekci **Run/Edit Configurations** máte nastavený **Document root** na složku `public` v kořenovém adresáři (jinak aplikace **nenajde** vygenerované css soubory).
|
| 44 |
|
|
2. Spusťte `composer install` (soubor pro composer už by měl být updatován) pro nainstalování balíčku `laravel/ui`.
|
| 45 |
|
|
3. Spusťte v terminálu příkaz `npm install && npm run dev`, příkaz zkompiluje všechny dostupné sass (`resources/sass`) do css souboru typicky do složky `public/css`.
|
| 46 |
|
|
1. Nastavením příkazu `npm run watch` se sass automaticky překompiluje při detekci změny.
|