From 8b7ce0656014e26038fb1da5d79ece84e4592ba9 Mon Sep 17 00:00:00 2001 From: Maciej Sobaczewski Date: Thu, 23 May 2024 04:51:20 +0200 Subject: [PATCH] Sync some more files with EN --- features/connection-handling.xml | 10 ++-- features/persistent-connections.xml | 31 ++++------ language/control-structures/elseif.xml | 22 +++---- language/predefined/arrayaccess.xml | 54 ++++++++--------- .../classobj/functions/get-object-vars.xml | 34 +++-------- .../classobj/functions/is-subclass-of.xml | 59 ++++--------------- reference/curl/setup.xml | 8 ++- reference/ftp/functions/ftp-login.xml | 4 +- .../json/functions/json-last-error-msg.xml | 11 ++-- reference/json/setup.xml | 9 ++- reference/mail/functions/ezmlm-hash.xml | 6 +- .../misc/functions/connection-aborted.xml | 7 ++- .../misc/functions/connection-status.xml | 5 +- reference/misc/ini.xml | 10 +--- 14 files changed, 103 insertions(+), 167 deletions(-) diff --git a/features/connection-handling.xml b/features/connection-handling.xml index b5f4cada..74ab0dff 100644 --- a/features/connection-handling.xml +++ b/features/connection-handling.xml @@ -1,5 +1,5 @@ - + @@ -19,7 +19,7 @@ Kiedy skrypt PHP się wykonuje, aktywny jest stan NORMAL. Jeśli klient się rozłączy, stan przechodzi w ABORTED. - Zwykle ma to miejsce gdy użytkownik naciśnie przycisk STOP w + Zwykle ma to miejsce, gdy użytkownik naciśnie przycisk STOP w przeglądarce. Jeśli przekroczony zostanie narzucony limit czasu (patrz set_time_limit), stan zmienia się na TIMEOUT. @@ -27,8 +27,8 @@ Możesz zdecydować czy po rozłączeniu klienta praca skryptu ma zostać - przerwana. Czasem przydatne jest by skrypty działały do końca, nawet - gdy braknie przeglądarki do której można wysyłać dane. Domyślnie, + przerwana. Czasem przydatne jest, by skrypty działały do końca, nawet + gdy braknie przeglądarki, do której można wysyłać dane. Domyślnie, po rozłączeniu się klienta, działanie skryptu jest przerywane. To zachowanie można zmienić dzięki opcji ignore_user_abort w &php.ini;, jak również dyrektywie Apache &httpd.conf; php_value ignore_user_abort @@ -39,7 +39,7 @@ wciśnie przycisk STOP i przy kolejnej próbie wysłania wyniku PHP wykryje przerwanie połączenia, zostanie wykonana funkcja zamykająca. Będzie ona również wywoływana przy normalnym zakończeniu pracy skryptu, - zatem, by wykonać inne czynności gdy klient się rozłączy, można + zatem, by wykonać inne czynności, gdy klient się rozłączy, można użyć funkcji connection_aborted. Zwraca ona &true; jeśli połączenie zostało przerwane. diff --git a/features/persistent-connections.xml b/features/persistent-connections.xml index c0d92391..2b493c53 100644 --- a/features/persistent-connections.xml +++ b/features/persistent-connections.xml @@ -1,5 +1,5 @@ - + @@ -17,7 +17,7 @@ Ludzie niezbyt dobrze znający zasady działania serwerów mogą czasem brać stałe połączenia za coś, czym te nie są. Stałe połączenia nie stwarzają możliwości otwarcia połączenia dla - konkretnego użytkonika, nie pozwalają na skuteczne + konkretnego użytkownika, nie pozwalają na skuteczne stworzenie systemu transakcji, i nie robią wielu innych rzeczy. Powiedzmy to jasno, stałe połączenia nie oferują nic ponad to, co robią 'zwykłe' połączenia. @@ -26,8 +26,8 @@ Dlaczego? - Jest to związane z zasadą działania serwerów. Są trzy sposoby na - które serwer może wykorzystac PHP do generowania stron. + Jest to związane z zasadą działania serwerów. Są trzy sposoby, na + które serwer może wykorzystać PHP do generowania stron. Pierwsza metoda to wykorzystanie PHP jako "wrappera" CGI. Przy wywołaniu @@ -51,7 +51,7 @@ Ostatnia metoda to wykorzystanie PHP jako wtyczki (plug-in) do - serwera wielowątkowego. Obecnie PHP4 zawiera obsługę mechanizmów + serwera wielowątkowego. Obecnie PHP zawiera obsługę mechanizmów ISAPI, WSAPI i NSAPI (w Windows), które umożliwiają uruchomienie PHP jako wtyczki do wielowątkowych serwerów takich jak Netscape FastTrack (iPlanet), Microsoft Internet Information Server (IIS) i O'Reilly WebSite @@ -63,15 +63,15 @@ mogą być przydatne? - Odpowiedź jest niezwykle prosta -- wydajność. Stałe połączenia + Odpowiedź jest niezwykle prosta - wydajność. Stałe połączenia sprawdzają się w przypadku, gdy koszt nawiązania połączenia z SQL - serwerem jest wysoki. To czy koszt jest duży czy nie zależy od wielu - czynników. Na przykład od typu bazy danych, od tego czy znajduje się + serwerem jest wysoki. To czy koszt jest duży, czy nie zależy od wielu + czynników. Na przykład od typu bazy danych, od tego, czy znajduje się ona na tym samym serwerze, od obciążenia maszyny, która obsługuje serwer - SQL, itd. Jeśli zatem koszt połączenia jest wysoki, stałe połączenia + SQL itd. Jeśli zatem koszt połączenia jest wysoki, stałe połączenia znacznie pomagają. Sprawiają, że proces potomny łączy się z serwerem SQL tylko raz podczas swojego życia, zamiast otwierać połączenie za każdym - razem gdy zażąda tego skrypt. Oznacza to, że każdy proces potomny, który + razem, gdy zażąda tego skrypt. Oznacza to, że każdy proces potomny, który nawiązał stałe połączenie, będzie posiadał własne połączenie z serwerem bazy danych. Dla przykładu, jeżeli 20 procesów potomnych uruchomi skrypt, który ustanowi stałe połączenie z serwerem SQL, będziesz mieć 20 różnych @@ -90,7 +90,7 @@ - Istnieje kilka zagrożeń, które należy brać pod uwagę decydując się na + Istnieje kilka zagrożeń, które należy brać pod uwagę, decydując się na używanie stałych połączeń. Jednym z nich jest sytuacja, w której skrypt blokujący tabelę, z jakiegokolwiek powodu nie może zdjąć blokady. Wtedy kolejne skrypty korzystające z tego samego połączenia będą zablokowane i @@ -112,14 +112,9 @@ jego wydajność! - Zobacz także fbsql_pconnect, - ibase_pconnect, ifx_pconnect, - ingres_pconnect, - msql_pconnect, mssql_pconnect, - mysql_pconnect, ociplogon, + Zobacz także ibase_pconnect, ociplogon, odbc_pconnect, oci_pconnect, - pfsockopen, pg_pconnect i - sybase_pconnect. + pfsockopen i pg_pconnect. diff --git a/language/control-structures/elseif.xml b/language/control-structures/elseif.xml index dee6bd84..289822f2 100644 --- a/language/control-structures/elseif.xml +++ b/language/control-structures/elseif.xml @@ -1,9 +1,9 @@ - + - <literal>elseif</literal>/<literal>else if</literal> + elseif/else if elseif, jak sama nazwa wskazuje, jest kombinacją @@ -13,7 +13,7 @@ if przyjmuje wartość &false;. Jednakże, w odróżnieniu od else, to alternatywne wyrażenie zostanie - wykonane tylko jeżeli wyrażenie warunkowe elseif + wykonane tylko, jeżeli wyrażenie warunkowe elseif otrzyma wartość &true;. Przykładowo, poniższy kod wyświetli a jest większe niż b, a jest równe b @@ -39,11 +39,10 @@ if ($a > $b) { if. Zostanie wykonane pierwsze wyrażenie elseif (jeżeli jakiekolwiek w ogóle), które przyjmuje wartość &true;. W PHP możesz także użyć zapisu - 'else if' (dwa słowa) i zachowanie będzie identyczne - jak przy 'elseif' (jednym słowie). Znaczenie syntaktyczne - obu z nich, różni się (jeżeli znasz C, to tutaj występuje to samo - zachowanie), ale istotne jest to, że oba w rezultacie zachowają się - tak samo. + else if (dwa słowa) i zachowanie będzie identyczne, + jak przy elseif (jednym słowie). Znaczenie składniowe + obu z nich delikatnie się różni (zachowanie jak w C), ale istotne + jest to, że oba w rezultacie zachowają się tak samo. Wyrażenie elseif jest wykonywane tylko jeżeli @@ -58,9 +57,10 @@ if ($a > $b) { Zauważ, że elseif i else if zostaną uznane za jednakowe, jeżeli zostaną użyte nawiasy klamrowe, jak w powyższym przykładzie. Jeśli użyjesz dwukropka do zdefiniowana - warunków if/elseif, nie możesz - rozdzielać else if na dwa słowa albo PHP napotka - błąd parsowania. + warunków if/elseif, to + elseif musi być użyte jako jedno słowo, PHP + zgłosi błąd parsowania, jeśli else if + będzie rozbite na dwa słowa. diff --git a/language/predefined/arrayaccess.xml b/language/predefined/arrayaccess.xml index 666a715a..770b7185 100644 --- a/language/predefined/arrayaccess.xml +++ b/language/predefined/arrayaccess.xml @@ -1,5 +1,5 @@ - + @@ -21,43 +21,36 @@
&reftitle.interfacesynopsis; - - - ArrayAccess + + + + ArrayAccess + - - - - ArrayAccess - - - - &Methods; - + + + - +
+ &reftitle.examples; Podstawowe użycie container = array( - "raz" => 1, - "dwa" => 2, - "trzy" => 3, - ); - } - - public function offsetSet($offset, $value) { +class Obj implements ArrayAccess { + public $container = [ + "raz" => 1, + "dwa" => 2, + "trzy" => 3, + ]; + + public function offsetSet($offset, $value): void { if (is_null($offset)) { $this->container[] = $value; } else { @@ -65,20 +58,20 @@ class obj implements ArrayAccess { } } - public function offsetExists($offset) { + public function offsetExists($offset): bool { return isset($this->container[$offset]); } - public function offsetUnset($offset) { + public function offsetUnset($offset): void { unset($this->container[$offset]); } - public function offsetGet($offset) { + public function offsetGet($offset): mixed { return isset($this->container[$offset]) ? $this->container[$offset] : null; } } -$obj = new obj; +$obj = new Obj; var_dump(isset($obj["dwa"])); var_dump($obj["dwa"]); @@ -126,7 +119,6 @@ obj Object &language.predefined.arrayaccess.offsetunset; - + @@ -36,32 +36,7 @@ &reftitle.returnvalues; Zwraca tablicę asocjacyjną zdefiniowanych właściwości niestatycznych, - które posiada dany obiekt w danym zasięgu. Jeżeli właściwość - nie ma przypisanej wartości, zostanie zwrócona z &null; jako wartością. - - - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.3.0 - - Funkcja zwraca &null; jeżeli - obiekt nie jest obiektem. Poprzednio zwracane było &false;. - - - - - + które posiada dany obiekt w danym zasięgu. @@ -116,6 +91,11 @@ array(4) { + + + Niezainicjalizowane wartości są traktowane jako niedostepne i w związku z tym nie są zawarte w zwracanej tablicy. + + &reftitle.seealso; diff --git a/reference/classobj/functions/is-subclass-of.xml b/reference/classobj/functions/is-subclass-of.xml index 6175b0ef..d1e2a980 100644 --- a/reference/classobj/functions/is-subclass-of.xml +++ b/reference/classobj/functions/is-subclass-of.xml @@ -1,5 +1,5 @@ - + @@ -10,13 +10,13 @@ &reftitle.description; boolis_subclass_of - mixedobiekt - stringnazwa_klasy + mixedobject_or_class + stringclass boolallow_string&true; - Sprawdza czy podana klasa jest jednym - z rodziców obiektu lub implementuje go. + Sprawdza czy podany object_or_class ma klasę + class jako jednego ze swoich rodziców lub czy go implementuje. @@ -24,7 +24,7 @@ - obiekt + object_or_class Nazwa klasy lub instancja obiektu. Nie jest generowany błąd jeśli klasa nie istnieje. @@ -32,7 +32,7 @@ - nazwa_klasy + class Nazwa klasy. @@ -54,46 +54,9 @@ &reftitle.returnvalues; - Funkcja zwraca &true; jeżeli podany obiekt, - należy do klasy, która jest podklasą tej podanej jako - nazwa_klasy, w przeciwnym wypadku zwraca &false;. - - - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.3.9 - - Dodano parametr allow_string - - - - 5.3.7 - - Parametr nazwa_klasy działa z - interfejsami - - - - 5.0.3 - - Możesz określić argument obiekt jako string - (nazwę klasy) - - - - - + Funkcja zwraca &true; jeżeli podany object_or_class, + należy do klasy, która jest podklasą + class, w przeciwnym wypadku zwraca &false;. @@ -134,7 +97,6 @@ if (is_subclass_of($WF, 'WidgetFactory')) { } -// działa dopiero od PHP 5.0.3 if (is_subclass_of('WidgetFactory_Child', 'WidgetFactory')) { echo "tak, WidgetFactory_Child jest klasą potomną WidgetFactory\n"; } else { @@ -223,7 +185,6 @@ Tak, MyClass jest klasą potomną MyInterface - + @@ -12,6 +12,8 @@ Aby użyć funkcji cURL w PHP, musisz zainstalować paczkę libcurl. PHP wymaga wersji 7.10.5 lub późniejszej. + Od PHP 7.3.0 wymagana jest wersja 7.15.5 lub nowsza. + Od PHP 8.0.0 wymagana jest wersja 7.29.0 lub nowsza.
@@ -28,8 +30,8 @@
&reftitle.resources; - To rozszerzenie definiuje dwa typy zasobów: uchwyt cURL i uchwyt - cURL multi. + Przed PHP 8.0.0 to rozszerzenie definiowało trzy typy zasobów: uchwyt curl, uchwyt curl_multi + i uchwyt curl_share.
diff --git a/reference/ftp/functions/ftp-login.xml b/reference/ftp/functions/ftp-login.xml index 039b5fde..7c6ece9d 100644 --- a/reference/ftp/functions/ftp-login.xml +++ b/reference/ftp/functions/ftp-login.xml @@ -1,5 +1,5 @@ - + @@ -13,7 +13,7 @@ boolftp_login FTP\Connectionftp stringusername - stringpassword + #[\SensitiveParameter]stringpassword Loguje się w ramach podanego połączenia FTP. diff --git a/reference/json/functions/json-last-error-msg.xml b/reference/json/functions/json-last-error-msg.xml index 29789b39..feb9d2d6 100644 --- a/reference/json/functions/json-last-error-msg.xml +++ b/reference/json/functions/json-last-error-msg.xml @@ -1,7 +1,6 @@ - + - json_last_error_msg @@ -12,10 +11,11 @@ &reftitle.description; stringjson_last_error_msg - + - + Zwraca ciąg znaków błędu dla ostatniego wywołania json_encode lub json_decode, + które nie używało JSON_THROW_ON_ERROR. @@ -28,7 +28,7 @@ &reftitle.returnvalues; - Zwraca wiadomość w wypadku powodzenia, łańcuch "No Error" jeżeli + Zwraca wiadomość w wypadku powodzenia lub łańcuch "No Error" jeżeli żaden błąd nie wystąpił, &return.falseforfailure;. @@ -43,7 +43,6 @@ - + @@ -13,8 +13,11 @@
&reftitle.install; - Od PHP 5.2.0 JSON jest rozszerzeniem standardowym i domyślnie - skompilowanym z PHP. + To rozszerzenie jest dołączone i domyślnie wkompilowane + w PHP. + + + Od PHP 8.0.0 rozszerzenie JSON jest jednym z głównych rozszerzeń, więc jest zawsze włączone. &pecl.info; diff --git a/reference/mail/functions/ezmlm-hash.xml b/reference/mail/functions/ezmlm-hash.xml index 07cfbbbc..c00d35f0 100644 --- a/reference/mail/functions/ezmlm-hash.xml +++ b/reference/mail/functions/ezmlm-hash.xml @@ -1,5 +1,5 @@ - + @@ -7,6 +7,10 @@ ezmlm_hash Oblicza wartość hash potrzebną dla EZMLM + + + &warn.deprecated.function-7-4-0.removed-8-0-0; + &reftitle.description; diff --git a/reference/misc/functions/connection-aborted.xml b/reference/misc/functions/connection-aborted.xml index b6ac398b..772cecc9 100644 --- a/reference/misc/functions/connection-aborted.xml +++ b/reference/misc/functions/connection-aborted.xml @@ -1,5 +1,5 @@ - + @@ -18,6 +18,11 @@ + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; diff --git a/reference/misc/functions/connection-status.xml b/reference/misc/functions/connection-status.xml index afc816f9..76c3a545 100644 --- a/reference/misc/functions/connection-status.xml +++ b/reference/misc/functions/connection-status.xml @@ -1,5 +1,5 @@ - + @@ -22,7 +22,8 @@ &reftitle.returnvalues; Zwraca pole bitowe statusu połączenia, które może być użyte ze stałymi - CONNECTION_XXX, aby określić status połączenia. + CONNECTION_*, + aby określić status połączenia. diff --git a/reference/misc/ini.xml b/reference/misc/ini.xml index d0cdb9bf..c72950c4 100644 --- a/reference/misc/ini.xml +++ b/reference/misc/ini.xml @@ -1,5 +1,5 @@ - +
&reftitle.runtime; @@ -41,12 +41,6 @@ INI_ALL - - highlight.bg - "#FFFFFF" - INI_ALL - Usunięto w PHP 5.4.0. - highlight.default "#0000BB" @@ -79,7 +73,7 @@ ignore_user_abort - boolean + bool