Instalace aplikace na OS Windows a IIS
Dosys 5.1.1.5
Přehled
Následující informace jsou určeny správci aplikace. Předpokládá se znalost prostředí Windows a IIS.
Příprava prostředí
IIS
Na počítači musí být nainstalována sužba Internet Information Services.
URL rewrite
Dosys vyžaduje modul pro překlad URL adres. Modul lze stáhnout zde, použijte 64 bitovou verzi. Je-li modul správně naistalován, bude ve správci IIS dostupná ikona URL Rewrite.
Odstranění PHPRC
Aby se předešlo konfliktům a nečekanému chování PHP, je třeba zbavit se proměnné prostředí PHPRC. Je to důležité proto, aby php pracovalo s konfiguračním souborem php.ini v adresáři instalace. Její přítomnost lze zjistit pomocí příkazového řádku.
SET PHPRC
Pokud je proměnná nastavena, je nutné ji odstranit ve vlastnostech počítače.
sysdm.cpl
Proměnné prostředí lze upravit v záložce Upřesnit / Proměnné prostředí. Aby se změna proměnných prostředí uplatnila, bude pravděpodobně nutné restartovat počítač.
Instalace PHP
Získání instalátoru
Dosys 5.1 vyžaduje PHP verze 8.0. Distribuční balíček PHP lze nalézt na adrese windows.php.net. Použijte verzi s nejvyšším číslem na třetí pozici. Není-li verze 8.0 k dispozici na hlavní stránce, najdete ji v sekci Archives. Pro instalaci vždy použijte 64bitovou verzi Non Thread Safe (nts).
Instalace
Soubory PHP rozbalte do adresáře c:\Program Files\PHP80. Do stejného adresáře zkopírujte i konfigurační soubor PHP (ke stažení zde). Soubor je nastaven tak, že se veškerá dočasná data PHP uchovávají ve složce C:\Windows\temp.
Konfigurace
Spustťe správce IIS.
- Na domovské stránce spusťte Mapování obslužných rutin
- V nabídce vlevo vyberte funkci Přidat mapování modulů.... Vyberte:
- Cesta požadavku: *.php
- Modul: FastCgiModule
- Spustitelný program: c:\program files\php80\php-cgi.exe
- Název: PHP80
- Na domovské stránce spusťte Výchozí dokument
- Do seznamu doplňte soubor index.php
Instalace DOSYS
Soubory z distribuce DOSYS zkopírujte do složky c:\inetpub\dochazka.
- Upravte přístupová práva ke složce c:\inetpub\dochazka tak, aby do ní mohl zapisovat IIS server (IUSR: full control).
- Upravte přístupová práva ke složce c:\inetpub\dochazka\storage tak, aby do ní mohl zapisovat scheduler. Lze nastavit i Everyone: full control.
- Zkopírujte soubor .env.example jako .env a upravte základní konfiguraci. Klíčové jsou především parametry připojení k databázi a hodnota APP_URL
Konfigurace aplikace na IIS
- Spusťte správce IIS
- Spusťte kontextové menu na Default Web Site
- Vyberte funkci Přidat aplikaci
- Alias: dochazka
- Fyzická cesta: c:\inetpub\dochazka\public
Kontrola správné verze PHP
- Vyberte v IIS nově vytvořený virtuální adresář dochazka.
- Spusťte funkci Mapování obslužných rutin
- Z nabídky Akce vpravo vyberte Zobrazit uspořádaný seznam
- Zkontrolujte, zda je PHP80 jako první. Pokud ne, použijte šipky v sekci Akce tak, aby PHP první bylo.
Naplánované úlohy
Pro činnost Dosysu jsou klíčové dvě naplánované úlohy. Jejich funkčnost lze ověřit kdykoliv ručním spuštěním.
- Scheduler - spouští naplánované úlohy. Naplánovanou úlohu je nutné spouštět v domovském adresáři aplikace (c:\inetpub\wwwroot\dochazka) pomocí následujícího příkazu. Frekvence spouštění by měla být každých 5 minut.
"c:\program files\php80\php.exe" artisan schedule:run
- Zpracování fronty - zajišťuje odesílání e-mailových zpráv. Naplánovanou úlohu je nutné spouštět v domovském adresáři aplikace (c:\inetpub\wwwroot\dochazka) pomocí následujícího příkazu. Frekvence spouštění by měla být každých 5 minut.
"c:\program files\php80\php.exe" artisan queue:work --stop-when-empty
Testování
- Na adrese http://localhost/dochazka by měla fungovat docházka.
- Adresa http://localhost/dochazka/home by neměla vracet prázdnou stránku, ne chybu.
Pokud server nereaguje, zkopírujte do adresáře c:\inetpub\wwwroot\dochazka\public soubor phpinfo.php s následujícím obsahem.
<?php phpinfo(); ?>
Na adrese http://localhost/dochazka/phpinfo.php by server měl vrátit informace o nainstalovaném PHP. Zkontrolujte verzi PHP a umístění souboru php.ini.