Dosys:Instalace: Porovnání verzí
| (Není zobrazeno 47 mezilehlých verzí od stejného uživatele.) | |||
| Řádek 1: | Řádek 1: | ||
{{DISPLAYTITLE:Instalace aplikace}} | {{DISPLAYTITLE:Instalace aplikace}} | ||
{{VERSIONINFO|Dosys| | {{VERSIONINFO|Dosys|5.1.1.5}} | ||
''UPOZORNĚNÍ: Tato stránka obsahuje informace k nejnovější verzi aplikace. Informace o verzi 4.x [[{{NAMESPACE}}:Instalace v4|najdete zde]].'' | |||
''UPOZORNĚNÍ: Následující informace jsou určeny správci aplikace.'' | ''UPOZORNĚNÍ: Následující informace jsou určeny správci aplikace.'' | ||
== Přehled == | == Přehled == | ||
DOSYS je aplikace na platformě PHP. Jako databázi používá MySQL. | DOSYS je aplikace na platformě PHP, používá framework [https://laravel.com/ Laravel]. Pro svou funkci vyžaduje modul pro přepis url adres (mod_rewrite na serveru apache, URL Rewrite na IIS). Jako databázi používá MySQL. | ||
== Runtime PHP == | == Runtime PHP == | ||
Minimální | Minimální verze PHP je 8.0. Seznam konfiguračních hodnot, jejichž požadované hodnoty se liší od standardní distribuční verze PHP. | ||
{ | {|class="wikitable" | ||
! Konfigurační proměnná || Hodnota | |||
|- | |||
| short_open_tag || On | |||
|} | |||
=== Požadované moduly PHP === | === Požadované moduly PHP === | ||
{{ | {|class="wikitable" | ||
! Modul | |||
|- | |||
| curl | |||
|- | |||
| fileinfo | |||
|- | |||
| intl | |||
|- | |||
| mbstring | |||
|- | |||
| exif | |||
|- | |||
| mysqli | |||
|- | |||
| openssl | |||
|- | |||
| pdo_mysql | |||
|- | |||
| soap | |||
|- | |||
| sockets | |||
|- | |||
| php-dom | |||
|} | |||
=== Volitelné moduly PHP === | |||
{|class="wikitable" | |||
! Modul || Použití | |||
|- | |||
| php_dbase || Export dat do mzdového systému eKaskáda. | |||
|} | |||
== Databáze MySQL == | == Databáze MySQL == | ||
Podporována je databáze MySQL a její klony (MariaDB). Minimální verze MySQL databáze je 8.0. | |||
== Instalace == | |||
Instalace se neliší od standardní Laravel aplikace. Jako domovský adresář musí být nastaven adresář ''public''. | |||
Pro správnou funkci aplikace je nutné zajistit automatické spouštění následujících úloh. Úlohy se spouštějí mimo prostředí webového serveru pomocí příkazu php(.exe). Před spuštěním je nutné zajistit, aby jako aktuální adresář byl nastaven kořenový adresář aplikace Dosys. Výstup zpracování příkazu obsahuje zajímavé diagnostické informace a je vhodné jej nasměrovat do adresáře storage/logs/scheduler nebo storage/logs/queue. | |||
* Scheduler - zajišťuje zpracování [[{{NAMESPACE}}:Naplánované úlohy|naplánovaných úloh]] Dosys. Frekvence spouštění odpovídá minimální požadované frekvenci zpracování úloh Dosys. Minimální hodnota je 1x za minutu, zpravidla postačuje spouštění 1x za pět minut. Důležité je zajistit, aby ke spuštění došlo vždy v čase, zaokrouhleném na 5 minut. | |||
<syntaxhighlight lang="sh"> | |||
php artisan scheduler:run | |||
</syntaxhighlight> | |||
* Queue - zajištuje zpracování úloh ve frontě (typicky e-mailové zprávy) a frekvence odpovídá tomu, jak rychle od vytvoření úlohy je nutné ji zpracovat. Typicky postačuje hodnota 1x za 5 minut. | |||
<syntaxhighlight lang="sh"> | |||
php artisan queue:work --stop-when-empty | |||
</syntaxhighlight> | |||
== Konfigurace aplikace == | == Konfigurace aplikace == | ||
Konfigurace aplikace je umístěna v konfiguračním souboru '' | Konfigurace aplikace je umístěna v konfiguračním souboru ''.env''. Popis jednotlivých konfiguračních hodnot najdete [[{{NAMESPACE}}:Konfigurační soubor|zde]]. Pro správnou funkci aplikace je nebytné nastavit následující konfigurační proměnné. | ||
* APP_URL | |||
* DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | |||
== Upgrade aplikace z verze 4.x == | |||
Po upgrade aplikace je nutné nastavit následující konfigurační hodnoty v souboru .env. Některé hodnoty v souboru config.php jsou duplikovány, použijte první z nich. | |||
{| class="wikitable" | |||
! Konfigurační hodnota || Hodnota z config.php | |||
|- | |||
| APP_KEY || Nastavit podle [[{{NAMESPACE}}:Konfigurační_soubor|dokumentace]]. | |||
|- | |||
| APP_URL || Hodnotu nastavit podle url aplikace (například <nowiki>https://test.astea.cz</nowiki>). | |||
|- | |||
| DB_HOST || Název serveru z konfigurační hodnoty $cfgDbServer nebo $Config['Connection']['Server'] | |||
|- | |||
| DB_PORT || Číslo portu z konfigurační hodnoty $cfgDbServer nebo $Config['Connection']['Server'] | |||
|- | |||
| DB_DATABASE || $cfgDbName nebo $Config['Connection']['Database'] | |||
|- | |||
| DB_USERNAME || $cfgDbUser nebo $Config['Connection']['User'] | |||
|- | |||
| DB_PASSWORD || $cfgDbPass nebo $Config['Connection']['Password'] | |||
|} | |||
== Odkazy == | == Odkazy == | ||
[[{{NAMESPACE}}:Instalace Windows|Instalace na OS Windows]] | |||
[[{{NAMESPACE}}:Konfigurační soubor|Konfigurační soubor]] | [[{{NAMESPACE}}:Konfigurační soubor|Konfigurační soubor]] | ||
[[{{NAMESPACE}}:Domovská stránka|Domovská stránka]] | [[{{NAMESPACE}}:Domovská stránka|Domovská stránka]] | ||
Aktuální verze z 11. 12. 2025, 14:01
Dosys 5.1.1.5
UPOZORNĚNÍ: Tato stránka obsahuje informace k nejnovější verzi aplikace. Informace o verzi 4.x najdete zde.
UPOZORNĚNÍ: Následující informace jsou určeny správci aplikace.
Přehled
DOSYS je aplikace na platformě PHP, používá framework Laravel. Pro svou funkci vyžaduje modul pro přepis url adres (mod_rewrite na serveru apache, URL Rewrite na IIS). Jako databázi používá MySQL.
Runtime PHP
Minimální verze PHP je 8.0. Seznam konfiguračních hodnot, jejichž požadované hodnoty se liší od standardní distribuční verze PHP.
| Konfigurační proměnná | Hodnota |
|---|---|
| short_open_tag | On |
Požadované moduly PHP
| Modul |
|---|
| curl |
| fileinfo |
| intl |
| mbstring |
| exif |
| mysqli |
| openssl |
| pdo_mysql |
| soap |
| sockets |
| php-dom |
Volitelné moduly PHP
| Modul | Použití |
|---|---|
| php_dbase | Export dat do mzdového systému eKaskáda. |
Databáze MySQL
Podporována je databáze MySQL a její klony (MariaDB). Minimální verze MySQL databáze je 8.0.
Instalace
Instalace se neliší od standardní Laravel aplikace. Jako domovský adresář musí být nastaven adresář public.
Pro správnou funkci aplikace je nutné zajistit automatické spouštění následujících úloh. Úlohy se spouštějí mimo prostředí webového serveru pomocí příkazu php(.exe). Před spuštěním je nutné zajistit, aby jako aktuální adresář byl nastaven kořenový adresář aplikace Dosys. Výstup zpracování příkazu obsahuje zajímavé diagnostické informace a je vhodné jej nasměrovat do adresáře storage/logs/scheduler nebo storage/logs/queue.
- Scheduler - zajišťuje zpracování naplánovaných úloh Dosys. Frekvence spouštění odpovídá minimální požadované frekvenci zpracování úloh Dosys. Minimální hodnota je 1x za minutu, zpravidla postačuje spouštění 1x za pět minut. Důležité je zajistit, aby ke spuštění došlo vždy v čase, zaokrouhleném na 5 minut.
php artisan scheduler:run
- Queue - zajištuje zpracování úloh ve frontě (typicky e-mailové zprávy) a frekvence odpovídá tomu, jak rychle od vytvoření úlohy je nutné ji zpracovat. Typicky postačuje hodnota 1x za 5 minut.
php artisan queue:work --stop-when-empty
Konfigurace aplikace
Konfigurace aplikace je umístěna v konfiguračním souboru .env. Popis jednotlivých konfiguračních hodnot najdete zde. Pro správnou funkci aplikace je nebytné nastavit následující konfigurační proměnné.
- APP_URL
- DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD
Upgrade aplikace z verze 4.x
Po upgrade aplikace je nutné nastavit následující konfigurační hodnoty v souboru .env. Některé hodnoty v souboru config.php jsou duplikovány, použijte první z nich.
| Konfigurační hodnota | Hodnota z config.php |
|---|---|
| APP_KEY | Nastavit podle dokumentace. |
| APP_URL | Hodnotu nastavit podle url aplikace (například https://test.astea.cz). |
| DB_HOST | Název serveru z konfigurační hodnoty $cfgDbServer nebo $Config['Connection']['Server'] |
| DB_PORT | Číslo portu z konfigurační hodnoty $cfgDbServer nebo $Config['Connection']['Server'] |
| DB_DATABASE | $cfgDbName nebo $Config['Connection']['Database'] |
| DB_USERNAME | $cfgDbUser nebo $Config['Connection']['User'] |
| DB_PASSWORD | $cfgDbPass nebo $Config['Connection']['Password'] |