|
1
|
# Aplikace pro muzea - MERLOT
|
|
2
|
|
|
3
|
## Jak zprovoznit projekt
|
|
4
|
|
|
5
|
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
|
|
|
18
|
## Jak zprovoznit databázi
|
|
19
|
|
|
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
|
### SQLite databáze
|
|
24
|
|
|
25
|
1. Soubor SQLite databáze umístěte do `database\database.sqlite` (může to být i nový prázdný soubor).
|
|
26
|
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
|
|
|
29
|
### 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
|
### Výchozí uživatel
|
|
42
|
|
|
43
|
Je nadefinován výchozí (testovací) uživatel.
|
|
44
|
|
|
45
|
**Login** admin@kaplicky.com **heslo** admin
|
|
46
|
|
|
47
|
## Jak zprovoznit bootstrap a kompilaci SASS souborů
|
|
48
|
|
|
49
|
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).
|
|
50
|
2. Spusťte `composer install` (soubor pro composer už by měl být updatován) pro nainstalování balíčku `laravel/ui`.
|
|
51
|
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`.
|
|
52
|
1. Nastavením příkazu `npm run watch` se sass automaticky překompiluje při detekci změny.
|
|
53
|
|
|
54
|
## Nastavení Mailtrap účtu pro odesílání registračních zpráv
|
|
55
|
|
|
56
|
Pro správné nastavení posílání emailů je nutné poupravit soubor `.env`. Najděte v souboru sekci `MAIL_...` a nahraďte je níže uvedenými hodnotami:
|
|
57
|
|
|
58
|
```shell script
|
|
59
|
MAIL_MAILER=smtp
|
|
60
|
MAIL_HOST=smtp.mailtrap.io
|
|
61
|
MAIL_PORT=2525
|
|
62
|
MAIL_USERNAME=d1eae987fe913e
|
|
63
|
MAIL_PASSWORD=d109bc15f3dc66
|
|
64
|
MAIL_ENCRYPTION=tls
|
|
65
|
MAIL_FROM_ADDRESS=merlot@merlot.org
|
|
66
|
MAIL_FROM_NAME="${APP_NAME}"
|
|
67
|
```
|
|
68
|
|
|
69
|
Pro přístup k mail serveru je nutné se příhlásit na stránce https://mailtrap.io/ s níže přidanými přihlašovacími údaji:
|
|
70
|
|
|
71
|
email:`jnohac@students.zcu.cz`
|
|
72
|
heslo:`merlot2020Betammajl`
|
|
73
|
|
|
74
|
Následně je konkrétní mail server přístupný z Inboxu `Demo inbox`.
|
|
75
|
|