1 |
b0d8dc91
|
Petr Pícha
|
# Aplikace pro muzea - MERLOT
|
2 |
|
|
|
3 |
e765fd91
|
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 |
e765fd91
|
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 |
e765fd91
|
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 |
e765fd91
|
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 |
75508baf
|
Marek Lovčí
|
### Výchozí uživatel
|
42 |
|
|
|
43 |
|
|
Je nadefinován výchozí (testovací) uživatel.
|
44 |
|
|
|
45 |
|
|
**Login** admin@kaplicky.com **heslo** admin
|
46 |
|
|
|
47 |
e765fd91
|
Marek Lovčí
|
## Jak zprovoznit bootstrap a kompilaci SASS souborů
|
48 |
ab1bb0fc
|
Adam Mištera
|
|
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 |
75508baf
|
Marek Lovčí
|
|
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`.
|