bakalarska_praca/README.md

Admin panel k bakalárskej práci

Webové rozhranie pripravené v PHP frameworku Laravel. K fungovaniu aplikácie je potrebný SQL server, v našom prípade je to riešené pomocou mariadb. Odporúčam použiť server Nginx, pretože poskytuje vyššiu rýchlosť ako napríklad Apache web server. Ďalej je potrebné mať nainštalované php-fpm Postup konfigurácie je písaný pre operačný systém GNU/Linux.

Konfiguráciu NGINX

Pre inštaláciu Nginx použijeme následujúce príkazy.

Debian, Ubuntu:

# apt install nginx php-fpm mariadb composer

Arch Linux:

# pacman -Sy nginx php-fpm mariadb composer

Fedora:

# dnf install nginx php-fpm mariadb composer

V priečinku /etc/nginx/sites-available vytvoríme súbor pre našu webstránku napr. bakalarka_web. Do súboru vložíme následujúcu konfiguráciu:

server {
    server_name {nazov_servera};
    root {korenovy_priecinok_webu};

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    listen 443 ssl; # managed by Certbot
    ssl_certificate /etc/letsencrypt/live/valerjakubco.xyz/fullchain.pem; # managed by Certbot
    ssl_certificate_key /etc/letsencrypt/live/valerjakubco.xyz/privkey.pem; # managed by Certbot
    include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot

}

server {
    if ($host = valerjakubco.xyz) {
        return 301 https://$host$request_uri;
    } # managed by Certbot


    listen 80;
    server_name valerjakubco.xyz;
    return 404; # managed by Certbot


}

Na miesta nazov_servera doplníme názov servera alebo teda doménu nášho servera, ak nejakú máme. Namiesto korenovy_priecinok_webu doplníme celú cestu k priečinku v ktorom sa nachádza náš web. Pomocou príkazu nastavíme majiteľa a skupinu na www-data, to je základný názov pre Nginx používateľa.

Konfigurácia databázy

Databázový server je nainštalovaný po spustení úvodných príkazov. Ďalšia konfigurácia nie je potrebná

Konfigurácia webového rozhrania

Po naklonovaní repozitára do cieľového priečinku spustíme inštaláciu modulov pomocou príkazu:

$ composer install

Po úspešnom nainštalovaní potrebných súborov môžeme spustiť migráciu databázy pomocou pripravených migrations. To spustíme pomocou príkazu:

$ php artisan migrate

Ak by tento príkaz nezbehol správne môžeme tabuľky vytvoriť manuálne pomocou priloženého dumpu zo štruktúry databázy s názvom structure_dump.sql v tomto repozitári. Môžeme použiť príkaz mysql dostupný v baličku mariadb

$ mysql -u{nazov_pouzivatela} -p

Následne vytvoríme databázu z názvom bakalarka pomocou príkazu:

CREATE DATABASE bakalarka;

A naimportujeme štruktúru pomocou príkazu:

source structure_dump.sql;

Konfigurácia HTTPS

Ak chceme server používať so zabezpečeným HTTP protokolom, potrebujeme k tomu utilitu certbot, ktorá pomocou utility Let's encrypt vytvorí a nastaví certifikáty pre Nginx. Debian, Ubuntu:

# apt install python3-certbot-nginx

Arch Linux:

# pacman -Sy python3-certbot-nginx

Fedora:

# dnf install python3-certbot-nginx

Pomocou príkazu:

# certbot --nginx

Certbot ma interaktívnu konfiguráciu, takže po spustení pokračovať podľa inštrukcií na obrazovke.