diff --git a/reference/fpm/book.xml b/reference/fpm/book.xml new file mode 100644 index 00000000..4c032cc1 --- /dev/null +++ b/reference/fpm/book.xml @@ -0,0 +1,40 @@ + + + + + + FastCGI Process Manager + + + &reftitle.intro; + &fpm.intro; + + Ten moduł SAPI jest dołączony do PHP. + + + + &reference.fpm.setup; + &reference.fpm.observability; + &reference.fpm.reference; + + + diff --git a/reference/fpm/functions/fastcgi-finish-request.xml b/reference/fpm/functions/fastcgi-finish-request.xml new file mode 100644 index 00000000..fc7f5055 --- /dev/null +++ b/reference/fpm/functions/fastcgi-finish-request.xml @@ -0,0 +1,54 @@ + + + + + + fastcgi_finish_request + Wysyła wszystkie dane odpowiedzi do klienta + + + + &reftitle.description; + + boolfastcgi_finish_request + + + + Ta funkcja wysyła wszystkie dane odpowiedzi do klienta i kończy żądanie. + Pozwala to na wykonywanie czasochłonnych zadań bez utrzymywania otwartego + połączenia z klientem. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.success; + + + + diff --git a/reference/fpm/functions/fpm-get-status.xml b/reference/fpm/functions/fpm-get-status.xml new file mode 100644 index 00000000..61413f7e --- /dev/null +++ b/reference/fpm/functions/fpm-get-status.xml @@ -0,0 +1,58 @@ + + + + + + fpm_get_status + Zwraca bieżący status puli FPM + + + + &reftitle.description; + + arrayfalsefpm_get_status + + + + Ta funkcja zwraca pełny bieżący status puli FPM jako tablicę asocjacyjną. Zawsze zwraca + pełny status, w tym informacje o statusie poszczególnych procesów. Więcej szczegółów + znajduje się w przewodniku po stronie statusu FPM. + + + Należy pamiętać, że ta funkcja będzie zdefiniowana tylko wtedy, gdy FPM jest używany do + obsługi skryptu. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Tablica asocjacyjna zawierająca pełny status puli FPM,&return.falseforfailure;. + + + + diff --git a/reference/fpm/observability.xml b/reference/fpm/observability.xml new file mode 100644 index 00000000..ccacd431 --- /dev/null +++ b/reference/fpm/observability.xml @@ -0,0 +1,31 @@ + + + + + + Obserwowalność + + &reference.fpm.status; + + + + diff --git a/reference/fpm/reference.xml b/reference/fpm/reference.xml new file mode 100644 index 00000000..37ef4d72 --- /dev/null +++ b/reference/fpm/reference.xml @@ -0,0 +1,31 @@ + + + + + + FPM &Functions; + + &reference.fpm.entities.functions; + + + + diff --git a/reference/fpm/setup.xml b/reference/fpm/setup.xml new file mode 100644 index 00000000..e1ea12d0 --- /dev/null +++ b/reference/fpm/setup.xml @@ -0,0 +1,33 @@ + + + + + &reftitle.setup; + + + Informacje na temat instalacji i konfiguracji FPM można znaleźć w + sekcji dotyczącej instalacji i konfiguracji + podręcznika PHP. + + + + diff --git a/reference/fpm/status.xml b/reference/fpm/status.xml new file mode 100644 index 00000000..a141219d --- /dev/null +++ b/reference/fpm/status.xml @@ -0,0 +1,325 @@ + + + + + Strona statusu + + + Ta strona zawiera informacje o konfiguracji i zawartości strony statusu FPM. Zobacz także + fpm_get_status. + + + + Konfiguracja + + + Stronę statusu FPM można włączyć ustawiając parametr konfiguracyjny + pm.status_path w konfiguracji puli FPM. + + + + + Ze względów bezpieczeństwa strona statusu FPM powinna być ograniczona tylko do żądań + wewnętrznych lub znanych adresów IP klientów, ponieważ strona ujawnia adresy URL żądań + i informacje o dostępnych zasobach. + + + + + W zależności od konfiguracji serwera WWW może być konieczne skonfigurowanie go tak, aby + zezwalał na żądania bezpośrednio do tej ścieżki, omijając wszelkie skrypty PHP. Przykład + konfiguracji dla Apache z FPM nasłuchującym na UDS i pm.status_path + ustawionym na /fpm-status wyglądałby tak: + + + + + + Require local + ProxyPass "unix:/var/run/php-fpm.sock|fcgi://localhost/" + +]]> + + + + + Po przeładowaniu lub ponownym uruchomieniu zarówno FPM, jak i serwera WWW, strona statusu + będzie dostępna z przeglądarki (o ile żądanie pochodzi z dozwolonego adresu IP, jeśli + skonfigurowano ograniczenie IP). + + + + + Parametry zapytania + + + Format wyjścia strony statusu można zmienić, określając jeden z następujących parametrów + zapytania: + + + + html + json + openmetrics + xml + + + + Dodatkowe informacje można również uzyskać za pomocą parametru zapytania full. + + + + Przykładowe adresy URL strony statusu: + + + + + https://localhost/fpm-status + - Skrócone wyjście w domyślnym formacie tekstowym + + + https://localhost/fpm-status?full + - Pełne wyjście w domyślnym formacie tekstowym + + + https://localhost/fpm-status?json + - Skrócone wyjście w formacie JSON + + + https://localhost/fpm-status?html&full + - Pełne wyjście w formacie HTML + + + + + + Wyświetlane informacje + + + Wartości daty/czasu używają formatu znacznika czasu Unix w wyjściu JSON i XML, w przeciwnym + razie używają formatu dającego następujący przykładowy wynik daty + "03/Jun/2021:07:21:46 +0100". + + + + Informacje podstawowe - Zawsze wyświetlane na stronie statusu + + + + Parametr + Opis + + + + + pool + Nazwa puli procesów FPM. + + + proccess manager + Typ menedżera procesów - static, dynamic lub ondemand. + + + start time + Data/czas ostatniego uruchomienia puli procesów. + + + start since + Czas w sekundach od ostatniego uruchomienia puli procesów. + + + accepted conn + Całkowita liczba zaakceptowanych połączeń. + + + listen queue + Liczba żądań (backlog) aktualnie oczekujących na wolny proces. + + + max listen queue + Maksymalna liczba żądań widzianych w kolejce nasłuchiwania w dowolnym momencie. + + + listen queue len + Maksymalny dozwolony rozmiar kolejki nasłuchiwania. + + + idle processes + Liczba procesów, które są obecnie bezczynne (oczekujące na żądania). + + + active processes + Liczba procesów, które aktualnie przetwarzają żądania. + + + total processes + Bieżąca całkowita liczba procesów. + + + max active processes + Maksymalna liczba jednocześnie aktywnych procesów. + + + max children reached + + Czy maksymalna liczba procesów została kiedykolwiek osiągnięta? Jeśli tak, wyświetlana + wartość jest większa lub równa 1, w przeciwnym razie wartość wynosi + 0. + + + + slow requests + + Całkowita liczba żądań, które przekroczyły skonfigurowany + request_slowlog_timeout. + + + + memory peak + + Szczytowe zużycie pamięci od momentu uruchomienia FPM. + + + + +
+ + + Informacje o poszczególnych procesach - wyświetlane tylko w trybie wyjścia <literal>full</literal> + + + + Parametr + Opis + + + + + pid + Systemowy PID procesu. + + + state + Stan procesu - Idle, Running, ... + + + start time + Data/czas uruchomienia procesu. + + + start since + Liczba sekund od uruchomienia procesu. + + + requests + Całkowita liczba obsłużonych żądań. + + + request duration + Całkowity czas w mikrosekundach spędzony na obsłudze ostatniego żądania. + + + request method + Metoda HTTP ostatniego obsłużonego żądania. + + + request uri + + URI ostatniego obsłużonego żądania (po przetworzeniu przez serwer WWW, może to być + zawsze /index.php jeśli używany jest wzorzec przekierowania front + controller). + + + + content length + Długość treści żądania, w bajtach, ostatniego żądania. + + + user + Użytkownik HTTP (PHP_AUTH_USER) ostatniego żądania. + + + script + + Pełna ścieżka skryptu wykonanego przez ostatnie żądanie. Będzie to + '-' jeśli nie dotyczy (np. żądania strony statusu). + + + + last request cpu + + Procentowe zużycie CPU ostatniego żądania. Będzie wynosić 0, jeśli proces nie jest + bezczynny, ponieważ obliczenie jest wykonywane po zakończeniu przetwarzania żądania. + Wartość może przekroczyć 100%, ponieważ metryka informuje, jaki procent całkowitego + czasu CPU został wykorzystany w ostatnim żądaniu - uwzględnia procesy na wszystkich + rdzeniach, podczas gdy 100% dotyczy tylko jednego rdzenia. + + + + last request memory + + Maksymalna ilość pamięci zużyta przez ostatnie żądanie. Będzie wynosić 0, jeśli proces + nie jest bezczynny, ponieważ obliczenie jest wykonywane po zakończeniu przetwarzania + żądania. + + + + +
+ + + + Wszystkie wartości są specyficzne dla puli i są resetowane po ponownym uruchomieniu FPM. + + + + + + Wyjście w formacie OpenMetrics używa różnych typów parametrów, aby lepiej pasować do + formatu OpenMetrics. Parametry i opisy ich wartości są zawarte w wyjściu formatu + OpenMetrics. + + +
+ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.1.0 + Dodano format openmetrics. + + + + + +
+ diff --git a/reference/fpm/versions.xml b/reference/fpm/versions.xml new file mode 100644 index 00000000..0624d228 --- /dev/null +++ b/reference/fpm/versions.xml @@ -0,0 +1,32 @@ + + + + + + + + + + +