Pokročilá konfigurace instalace

Lizmap za proxy serverem/reverzním proxy serverem

Někdy se může stát, že některé adresy URL v Lizmapě nebudou odpovídat vašim představám. Například se v nich používá protokol „http“ místo protokolu „https“. Nebo může obsahovat nežádoucí port ( http://mydomain:5468/ místo http://mydomain/ ). Nebo url nemusí obsahovat skutečný název domény.

Ve většině případů je to způsobeno tím, že webový server nebo PHP-fpm je za hlavním webovým serverem (který funguje jako proxy nebo reverzní proxy), a pak jsou parametry prostředí zadané PHP nebo backendovým webovým serverem Lizmapu chybné.

Můžete Lizmapu nařídit, aby vynutil HTTPS, použil správnou doménu nebo správný port.

V souboru localconfig.ini můžete použít tyto konfigurační parametry.

Vynucení použití portu 80 (true) nebo 8080 například u protokolu http:

forceHTTPPort = true
# or
forceHTTPPort = 8080

Vynucení použití portu 443 (true) nebo 8443 například s protokolem https:

forceHTTPSPort = true
# or
forceHTTPSPort = 8443

Zadání názvu domény aplikace Lizmap, pokud jej Lizmap nedokáže odhadnout:

domainName = www.example.com

Pokud cesta URL backendového webového serveru neodpovídá cestě URL frontálního webového serveru (např.: proxy server přesměruje URL jako http://example.com/index.php na váš webový server http://backend.example.com/foo/bar/index.php, musíte uvést „veřejnou“ cestu URL (basePath) a backendovou cestu URL (backendBasePath):

[urlengine]
basePath= /
backendBasePath = /foo/bar

Pokud reverzní proxy server přesměruje požadavek HTTPS na HTTP, musíte deaktivovat kontrolu HTTPS:

[urlengine]
checkHttpsOnParsing = off

Počínaje verzí Lizmap 3.0.18 a 3.1.6 můžete určit, aby všechny generované adresy URL používaly protokol HTTPS, pokud Lizmap neví, jaký protokol používají požadavky na reverzní proxy server:

[urlengine]
checkHttpsOnParsing = off
forceProxyProtocol = https

Použití proměnných prostředí

Pokud jsou některá pověření nebo parametry dostupné v proměnných prostředí, můžete je uvést do souborů localconfig.ini.php nebo profiles.ini.php. Ujistěte se, že jsou proměnné prostředí dostupné procesu PHP-FPM nebo procesu APACHE/NGINX.

Do těchto souborů zadejte syntaxi ${VARIABLE_NAME}.

Například pro označení pověření postgresql uložených do těchto proměnných :

LIZMAP_PGSQL_HOST=localhost
LIZMAP_PGSQL_DATABASE=lizmap
LIZMAP_PGSQL_LOGIN=admin
LIZMAP_PGSQL_PASSWORD="Sup3Rp4ssw0rd!"

Tuto konfiguraci zapíšete do souboru profiles.ini.php:

[jdb:jauth]
driver="pgsql"
database=${LIZMAP_PGSQL_DATABASE}
host=${LIZMAP_PGSQL_HOST}
user=${LIZMAP_PGSQL_LOGIN}
password=${LIZMAP_PGSQL_PASSWORD}