Wytyczne techniczne dla serwera pod Oprogramowanie KSI

Instrukcja dla administratora systemu – wymagania, konfiguracja i dostęp na potrzeby instalacji serwisu produkcyjnego i testowego.

Ważne

W przypadku instalacji Oprogramowania na serwerze klienta, KSI nie konfiguruje systemu.

Pracownicy KSI nie korzystają z konta root w celu zmiany konfiguracji serwera. Wszystkie czynności administracyjne wykonuje administrator klienta zgodnie z poniższymi wytycznymi.

Serwer ogólnie

Serwer VPS lub dedykowany.
SYSTEM: zalecany Debian.
RAM: min. 8 GB.
CPU: min. 2 rdzenie.
Dysk SSD: min. 40 GB.

Produkcja/test: rekomendowane oddzielne katalogi i jedna baza (z możliwością utworzenia kopii – patrz sekcja MySQL).
Backup: regularne kopie zapasowe katalogów public_html/swpb2/ i public_html/swpb2-test/ oraz bazy danych.

Serwer SSH

Dostęp do SSH z zewnątrz (np. port 22/tcp).
Utworzony użytkownik (lub użytkownicy) z możliwością logowania do konsoli SSH.
Możliwość przesyłania plików przez SSH (SFTP).
Użytkownik powinien mieć dostęp do katalogów strony WWW:
- (...)public_html/swpb2/
- (...)public_html/swpb2-test/

Serwer WWW – Apache 2+

Włączona obsługa .htaccess, w tym moduły: mod_rewrite, mod_headers, mod_dir, mod_mime.
W konfiguracji vhosta włącz nadpisywanie i odpowiednie opcje (w przeciwnym razie reguły z .htaccess będą ignorowane):

<Directory /var/www/html>
  AllowOverride All        # lub precyzyjniej: AllowOverride FileInfo Options Indexes
  Options FollowSymLinks
  Require all granted
</Directory>

Wskazówka: gdzie dodać blok <Directory>?

Najczęściej w pliku vhosta (np. /etc/apache2/sites-available/example.conf) lub globalnie w /etc/apache2/apache2.conf. Po zmianach wykonaj a2enmod rewrite oraz systemctl reload apache2.

Obsługa domen

Domena	Docelowy katalog
https://domena-klienta.pl	`(...)public_html/swpb2/`
https://www.domena-klienta.pl	`(...)public_html/swpb2/`
https://test-domena-klienta.pl	`(...)public_html/swpb2-test/`

MySQL / Percona

Zainstalowany klient: mysql-client.
Możliwość tworzenia funkcji niedeterministycznych.
Możliwość ustawiania konfiguracji globalnej, np.:

-- Przykłady (wykonywane jako użytkownik z uprawnieniami SUPER/SESSION_VARIABLES_ADMIN):
SET GLOBAL sql_mode = (SELECT REPLACE(@@sql_mode,'ONLY_FULL_GROUP_BY',''));
SET @@sql_mode = '';
SET GLOBAL log_bin_trust_function_creators = 1;

Aby wartości nie znikały po restarcie, dodaj do globalnej konfiguracji MySQL (np. mysqld.cnf):

[mysqld]
# Wyłączenie ONLY_FULL_GROUP_BY w sql_mode
sql_mode = ''
# Umożliwia tworzenie funkcji i procedur przy włączonym binlogu
log_bin_trust_function_creators = 1

Utworzony użytkownik i baza danych na potrzeby strony WWW (jedna baza dla testu i produkcji; na własne potrzeby można utrzymywać kopie oddzielnie).
Dostęp do bazy z zewnątrz z dostępu korzyta API oraz usługi powiązane z CRM.

PHP w wersji 7.4 – 8.2

Wymagane rozszerzenia

php-curl (usługi i zasoby zewnętrzne)
php-mysql (mysqli)
php-xml
php-iconv
php-common
php-mbstring
php-gd

Wydajność i pamięć

Jeśli serwer korzysta z PHP-FPM, umożliwij konfigurację wysokiej wartości pm.max_children. Przy pustym cache każda strona może generować miniatury wielu zdjęć (nawet kilkudziesięciu na podstronę).
Przeznacz dla PHP ok. 1 GB pamięci RAM – niektórzy operatorzy dostarczają zdjęcia o rozdzielczości nawet 10000 × 4000 px. Rozpakowane zdjęcie może zajmować ok. 160 MB, co jest potrzebne do konwersji i przygotowania miniaturek.

Uwagi

Wymagany swobodny dostęp (bez VPN i innych ograniczeń) na czas wdrożenia do:

SSH (port 22/tcp)
MySQL (port 3306/tcp)
Podgląd stron na skonfigurowanych domenach

Dodatkowe moduły przez usługi

Jeśli planujesz korzystać z:

Statystyk UDDS (lokalne zliczanie i tworzenie statystyk ruchu do UDDS), lub
ConsentManagera (https://turserwis.pl/self-hosted-consent-manager/)

wtedy konieczne będzie dodanie w PHP obsługi SQLite (przez PDO).

KSI