language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: sobak Status: wip -->
<!-- $Revision$ -->
<!-- CREDITS: leszek, adi, cyb0org, joeaccord -->
<!-- TODO: Nieliczne sekcje opisane przez "TODO DOKOŃCZYĆ" nie są faktycznie przetłumaczone na j. polski. Pomoc mile widziana -->
<!ENTITY installation.enabled.disable 'To rozszerzenie jest domyślnie włączone. Można je wyłączyć, używając następującej opcji
podczas kompilacji: '>

<!-- Not used in EN anymore -->
<!ENTITY changelog.randomseed '<row xmlns="http://docbook.org/ns/docbook"><entry>4.2.0</entry><entry>Generator liczb losowych
jest inicjowany automatycznie.</entry></row>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja została
<emphasis>ZDEPRECJONOWANA</emphasis> w PHP 5.3.0. Używanie tej funkcji
jest stanowczo odradzane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja
<emphasis>ZDEPRECJONOWANA</emphasis> w PHP 5.3.0. Używanie tej funkcji
jest stanowczo odradzane.</simpara></warning>'>

<!-- Cautions -->
<!ENTITY caution.cryptographically-insecure '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Ta funkcja nie generuje wartości bezpiecznych kryptograficznie, w związku z tym <emphasis>nie powinna</emphasis>
  być używana w celach kryptograficznych, ani w innych celach które wymagają aby zwrócona wartość była niemożliwa do odgadnięcia.
 </para>
 <para>
  Jeśli potrzebujesz wartości bezpiecznych kryptograficznie, możesz skorzystać z klasy <classname>Random\Randomizer</classname>
  z silnikiem <classname>Random\Engine\Secure</classname>. Dla prostszych przypadków funkcje <function>random_int</function>
  oraz <function>random_bytes</function> dostarczają wygodne i bezpieczne <acronym>API</acronym>, które wykorzystuje
  <acronym>CSPRNG</acronym> systemu operacyjnego.
 </para>
</caution>'>

<!ENTITY caution.mt19937-tiny-seed '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Jako iż silnik Mt19937 (“Mersenne Twister”) wspiera tylko pojedynczą 32-bitową liczbę całkowitą jako
  ziarno (seed), to liczba możliwych losowych sekwencji jest ograniczona do raptem 2<superscript>32</superscript>
  (tj. 4,294,967,296), pomimo iż Mt19937 teoretycznie gwarantuje ich 2<superscript>19937</superscript>-1.
 </para>
 <para>
  Niezależnie czy ziarno zostanie podane wprost lub wygenerowane niejawnie, duplikaty pojawią się
  znacznie wcześniej. Zduplikowane ziarna spodziewane są z prawdopodobieństwem 50&#37; po mniej niż
  80,000 losowo wygenerowanych ziarnach, zgodnie z paradoksem dni urodzin. Prawdopodobieństwo 10&#37;
  na zduplikowane ziarno zdarza się już losowym wygenerowaniu około 30,000 ziaren.
 </para>
 <para>
  To wszystko powoduje, że Mt19937 nie nadaje się do aplikacji, w których zduplikowane sekwencje nie powinny się zdarzać
  z więcej niż pomijalnym prawdopodobieństwem. Jeśli potrzebujesz reprodukowalnego seedowania, to zarówno
  silniki <classname>Random\Engine\Xoshiro256StarStar</classname> jak i <classname>Random\Engine\PcgOneseq128XslRr64</classname>
  wspierają dużo większe ziarna, które nie powinny tak łatwo mieć kolizji. Jeśli reprodukowalność
  nie jest wymagana, to silnik <classname>Random\Engine\Secure</classname> zapewnia losowość
  bezpieczną kryptograficznie.
 </para>
</caution>'>

<!-- Notes -->

<!ENTITY note.bin-safe '<note xmlns="http://docbook.org/ns/docbook"><simpara>Tę funkcję można stosować dla danych binarnych.</simpara></note>'>

<!ENTITY note.clearstatcache '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Wyniki działania tej funkcji są
buforowane. Zobacz opis funkcji <function xmlns="http://docbook.org/ns/docbook">clearstatcache</function> aby uzyskać
więcej informacji.</simpara></note>'>

<!ENTITY note.context-support '<para xmlns="http://docbook.org/ns/docbook"><link linkend="language.types.resource">Zasób</link> dla
<link linkend="stream.contexts">kontekstu</link>.</para>'>

<!ENTITY note.exec-bg '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Jeśli za pomocą
tej funkcji uruchamiany jest program mający działać w tle, należy upewnić się, że standardowe wyjście tego programu jest
przekierowane do pliku lub innego strumienia wyjściowego. W przeciwnym
przypadku PHP zawiesi działanie aż do zakończenia działania
wykonywanego programu.</para></note>'>

<!ENTITY note.exec-bypass-shell '<note xmlns="http://docbook.org/ns/docbook"><para>W systemie Windows <function>exec</function>
najpierw uruchomi cmd.exe aby wykonać komendę. Jeśli chcesz wykonać zewnętrzny program bez uruchamiania cmd.exe
użyj funkcji <function>proc_open</function> z opcją <parameter>bypass_shell</parameter>.</para></note>'>

<!ENTITY note.extractto-windows '<note xmlns="http://docbook.org/ns/docbook"><para>System plików NTFS z Windowsa
nie wspiera niektórych znaków w nazwach plików, dokładniej <literal>&lt;|&gt;*?":</literal>. Nie są też wspierane nazwy plików
kończące się kropką. W przeciwieństwie do niektórych programów rozpakowujących, ta metoda nie zamienia tych znaków
na podkreślniki, lecz kończy się niepowodzeniem przy próbie wypakowania takich plików.</para></note>'>

<!ENTITY note.func-callback '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Zamiast nazwy funkcji może zostać
przekazana tablica zawierająca referencję do obiektu i nazwę metody
</simpara></note>'>

<!ENTITY note.func-callback-exceptions '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Wywołania zwrotne zdefiniowane
za pomocą takich funkcji jak <function xmlns="http://docbook.org/ns/docbook">call_user_func</function> i <function xmlns="http://docbook.org/ns/docbook">call_user_func_array</function> nie zostaną
aktywowane jeśli w poprzednim wywołaniu zostanie wygenerowany nieobsłużony wyjątek.</para></note>'>

<!ENTITY note.funcbyref '<note xmlns="http://docbook.org/ns/docbook"><para>Jeśli argumenty są przekazane przez referencję,
wszystkie zmiany na argumentach będą miały odzwierciedlenie w wartościach zwracanych przez tę funkcję. Od PHP 7
aktualne wartości zostaną zwrócone także jeśli argumenty są przekazane poprzez wartość.</para></note>'>

<!ENTITY note.funcnoparam '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Jako że działanie tej funkcji zależy od
aktualnego zasięgu, nie może ona być użyta jako parametr funkcji w wersjach przed PHP 5.3.0.
Jeśli konieczne jest przekazanie tej wartości, należy przypisać wynik działania tej
funkcji do zmiennej, a następnie przekazać tę zmienną jako parametr.</para></note>'>

<!ENTITY note.func-named-params '<note xmlns="http://docbook.org/ns/docbook"><para>Począwszy od PHP 8.0.0 rodzina funkcji func_*()
zakłada, że argumenty zostały przekazane pozycyjnie,
a brakujące argumenty są zamieniane na ich wartości domyślne.
Ta funkcja ignoruje zbieranie nieznanych nazwanych argumentów wariadycznych.
Nieznane nazwane argumenty, które są zbierane mogą być odczytane tylko przez parametr wariadyczny.</para></note>'>

<!ENTITY note.line-endings '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Jeśli PHP niewłaściwie
rozpoznaje znaki końca linii podczas odczytu plików stworzonych
lub znajdujących się na komputerach Macintosh, problem może
rozwiązać włączenie dyrektywy konfiguracyjnej
 <link xmlns="http://docbook.org/ns/docbook" linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link>
.</simpara></note>'>

<!ENTITY note.no-remote '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja nie będzie działać na
<link xmlns="http://docbook.org/ns/docbook" linkend="features.remote-files">zdalnych plikach</link>, ponieważ
przetwarzany plik musi być dostępny w systemie plików serwera.
</simpara></note>'>

<!ENTITY note.not-bin-safe '<warning xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja nie jest (jeszcze)
bezpieczna dla danych binarnych!</simpara></warning>'>

<!ENTITY note.no-key-association '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook"> Ta funkcja przypisuje nowe
klucze dla elementów argumentu <parameter xmlns="http://docbook.org/ns/docbook">tablica</parameter>. Wszystkie
istniejące klucze zostaną usunięte.</simpara></note>'>

<!ENTITY note.no-windows '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja nie jest dostępna na
platformie Windows.</simpara></note>'>

<!ENTITY note.no-windows.extension '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">To rozszerzenie nie jest
dostępne na platformie Windows.</simpara></note>'>

<!ENTITY note.no-zts '<note xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
niedostępna w interpreterach PHP skompilowanych z włączonym ZTS (Zend Thread Safety). Aby sprawdzić czy Twoja kopia została skompilowana z włączonym ZTS enabled, użyj <command>php -i</command> lub sprawdź wbudowaną stałą <constant>PHP_ZTS</constant>.</simpara></note>'>

<!ENTITY note.randomseed '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Nie ma potrzeby
inicjalizować generatora liczb losowych funkcją <function xmlns="http://docbook.org/ns/docbook">srand</function> lub
<function xmlns="http://docbook.org/ns/docbook">mt_srand</function>, ponieważ dzieje się to automatycznie.
</simpara></note>'>

<!ENTITY note.is-superglobal '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">To jest zmienna "superglobalna" lub
automatycznie ustawiona na globalną. To po prostu oznacza, że jest dostępna
w każdym miejscu skryptu. Nie jest konieczne użycie
<command>global $zmienna;</command> aby mieć do niej dostęp w funkcjach i metodach.
</para></note>'>

<!ENTITY note.uses-ob '<note xmlns="http://docbook.org/ns/docbook"><para>Stosując parametr <parameter>return</parameter>, ta funkcja używa wewnętrznie buforowania
wyjścia, więc nie może być użyta wewnątrz funkcji callback podanej w wywołaniu
<function xmlns="http://docbook.org/ns/docbook">ob_start</function>.</para></note>'>

<!ENTITY note.uses-ob-php70 '<note xmlns="http://docbook.org/ns/docbook"><para>Gdy użyty jest parametr <parameter>return</parameter>,
ta funkcja używała wewnętrznie buforowania wyjścia przed PHP 7.1.0, więc nie mogła być użyta wewnątrz funkcji callback podanej w wywołaniu
<function>ob_start</function> callback function.</para></note>'>

<!ENTITY note.filesystem-time-res '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Proszę zauważyć, że informacja
o czasie dostępu może się różnić w zależności od systemu plików.</para></note>'>

<!ENTITY note.uses-autoload '<note xmlns="http://docbook.org/ns/docbook">
<para xmlns="http://docbook.org/ns/docbook">Using this function will use any registered
<link xmlns="http://docbook.org/ns/docbook" linkend="language.oop5.autoload">autoloaders</link> if the class is not already known.</para></note>'>

<!ENTITY note.network.header.sapi '<note xmlns="http://docbook.org/ns/docbook">
   <para>
    Nagłówki będą dostępne i zwracane tylko jeśli stosowane jest SAPI które je obsługuje.
   </para>
  </note>
'>

<!ENTITY note.sigchild '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Jeśli PHP zostało skompilowane z --enable-sigchild, wartość zwracana przez tą funkcję jest nieokreślona.
 </para>
</note>
'>

<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Jeśli dwa elementy zostaną uznane za identyczne, zachowują one swoją oryginalną kolejność.
  Przed PHP 8.0.0 ich kolejność względem siebie w posortowanej tablicy była nieokreślona.
 </para>
</note>
'>

<!ENTITY note.reset-index "<note xmlns='http://docbook.org/ns/docbook'>
 <para>
    Resetuje wewnętrzny wskaźnik tablicy do pierwszego elementu.
 </para>
</note>
">

<!ENTITY note.resource-migration-8.0-dead-function '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Ta funkcja nic nie robi. Przed PHP 8.0.0 ta funkcja była używana do zamykania zasobu.
 </para>
</note>
'>

<!-- Tips -->

<!ENTITY tip.fopen-wrapper '<tip xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Jeśli włączona jest dyrektywa
konfiguracyjna <link xmlns="http://docbook.org/ns/docbook" linkend="ini.allow-url-fopen">fopen wrappers</link>,
możliwe jest podanie jako nazwy pliku adresu URL. Zobacz opis funkcji
<function xmlns="http://docbook.org/ns/docbook">fopen</function> aby dowiedzieć się jak przekazać nazwę pliku, oraz
<link xmlns="http://docbook.org/ns/docbook" linkend="ini.allow-url-fopen">fopen wrappers</link> aby uzyskać listę
obsługiwanych protokołów.
</simpara></tip>'>

<!ENTITY tip.fopen-wrapper.stat '<tip xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Od PHP 5.0.0 ta funkcja
może być użyta także z <emphasis xmlns="http://docbook.org/ns/docbook">niektórymi</emphasis> nakładkami URL. Zobacz
<xref xmlns="http://docbook.org/ns/docbook" linkend="wrappers"/> aby dowiedzieć się które obsługują
funkcjonalność z rodziny <function xmlns="http://docbook.org/ns/docbook">stat</function>.</simpara></tip>'>

<!ENTITY tip.ob-capture '<tip xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ze wszystkim, co wysyła dane bezpośrednio
do przeglądarki, możesz używać <link xmlns="http://docbook.org/ns/docbook" linkend="book.outcontrol">funkcji kontroli
wyjścia</link> aby przejąć wyjście tej funkcji i zapisać je w zmiennej
tekstowej (na przykład).</simpara></tip>'>

<!ENTITY tip.userlandnaming '<tip xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Zobacz
także <xref xmlns="http://docbook.org/ns/docbook" linkend="userlandnaming" />.</simpara></tip>'>

<!-- Warnings -->

<!ENTITY warn.escapeshell '<warning xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Jeśli planowane jest przekazanie
danych pochodzących od użytkownika do tej funkcji, powinno sie skorzystać z
funkcji <function xmlns="http://docbook.org/ns/docbook">escapeshellarg</function> lub <function xmlns="http://docbook.org/ns/docbook">escapeshellcmd</function>
aby mieć pewność, że użytkownicy nie mogą uruchomić dowolnych poleceń systemowych.
</para></warning>'>

<!ENTITY warn.experimental '<warning xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ten moduł jest w stadium
<emphasis xmlns="http://docbook.org/ns/docbook">EKSPERYMENTALNYM</emphasis>. Oznacza to, że zachowanie tych funkcji,
ich nazw, w zasadzie wszystko udokumentowane tutaj może zostać zmienione w
przyszłych wersjach PHP bez wcześniejszego uprzedzenia. Używaj tego modułu na
własne ryzyko.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta opcja jest
<emphasis xmlns="http://docbook.org/ns/docbook">PRZESTARZAŁA</emphasis> od PHP 5.3.0. Używanie tej opcji
nie jest zalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 5.3.0 i została <emphasis>USUNIĘTA</emphasis>
w PHP 5.4.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 5.3.0 i została <emphasis>USUNIĘTA</emphasis>
w PHP 5.4.0.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 5.5.0. Używanie tej opcji nie jest zalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 5.6.0. Używanie tej opcji nie jest zalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.0.0. Używanie tej opcji nie jest zalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.1.0. Używanie tej opcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.1.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-0-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.0.0 i
<emphasis>USUNIĘTA</emphasis> od PHP 8.0.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0.removed-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.1.0 i
<emphasis>USUNIĘTA</emphasis> od PHP 7.2.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.2.0. Używanie tej opcji
nie jest zalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.2.0 i <emphasis>USUNIĘTA</emphasis> od PHP 8.0.0. Używanie tej opcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.2.0. Używanie tej funkcji
nie jest zalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.2.0 i <emphasis>USUNIĘTA</emphasis> od PHP 8.0.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.3.0. Używanie tej opcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.3.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.3.0 i <emphasis>USUNIĘTA</emphasis> od PHP 8.0.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.4.0. Używanie tej opcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.4.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 7.4.0 i <emphasis>USUNIĘTA</emphasis> od PHP 8.0.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.feature.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Ta opcja została <emphasis>USUNIĘTA</emphasis> w PHP 8.0.0.</simpara>
</warning>'>

<!ENTITY warn.deprecated.function-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 8.0.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 8.1.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 8.2.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 8.3.0. Używanie tej opcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 8.3.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-8-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 8.4.0. Używanie tej opcji
jest niezalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 8.4.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>'>

<!ENTITY removed.php.future 'Ta przestarzała funkcja <emphasis xmlns="http://docbook.org/ns/docbook">zostanie</emphasis>
na pewno w przyszłości <emphasis xmlns="http://docbook.org/ns/docbook">usunięta</emphasis>.'>

<!ENTITY warn.deprecated.function.removed-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja jest
<emphasis xmlns="http://docbook.org/ns/docbook">PRZESTARZAŁA</emphasis> i zostanie <emphasis xmlns="http://docbook.org/ns/docbook">USUNIĘTA</emphasis>
od PHP 5.3.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function.removed-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> i <emphasis>USUNIĘTA</emphasis> w PHP 5.5.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara xmlns="http://docbook.org/ns/docbook">Ten alias funkcji jest <emphasis xmlns="http://docbook.org/ns/docbook">PRZESTARZAŁY</emphasis> od PHP 5.3.0.
Używanie tego aliasu nie jest zalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Ta funkcja jest <emphasis>PRZESTARZAŁA</emphasis> od PHP 5.4.0.
Używanie tej funkcji nie jest zalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Ten alias jest <emphasis>PRZESTARZAŁY</emphasis> od PHP 5.4.0.
Używanie tego aliasu nie jest zalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-5-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Ta funkcja jest <emphasis>PRZESTARZAŁA</emphasis> od PHP 5.5.0.
Używanie tej funkcji nie jest zalecane.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
<emphasis>PRZESTARZAŁA</emphasis> od PHP 5.5.0 i <emphasis>USUNIĘTA</emphasis> od PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja została uznana za
<emphasis>PRZESTARZAŁĄ</emphasis> w PHP 5.5.0 i została <emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-4-1-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja została uznana za
<emphasis>PRZESTARZAŁĄ</emphasis> w PHP 4.1.0 i zostala <emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja została uznana za
<emphasis>PRZESTARZAŁĄ</emphasis> w PHP 5.3.0 i <emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ten alias został uznany za
<emphasis>PRZESTARZAŁY</emphasis> w PHP 5.3.0 i został <emphasis>USUNIĘTY</emphasis> w PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja została uznana za
<emphasis>PRZESTARZAŁĄ</emphasis> w PHP 5.6.0 i została
<emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.removed.function-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja została
<emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.removed.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>USUNIĘTA</emphasis> od PHP 7.4.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-2-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ten alias jest
<emphasis>PRZESTARZAŁY</emphasis> od PHP 7.2.0 i <emphasis>USUNIĘTY</emphasis> od PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-4-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ten alias jest
<emphasis>PRZESTARZAŁY</emphasis> od PHP 7.4.0 i <emphasis>USUNIĘTY</emphasis> od PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ten alias jest
<emphasis>PRZESTARZAŁY</emphasis> od PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.removed.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ten alias jest
<emphasis>USUNIĘTY</emphasis> od PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.experimental.func '<warning
xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja jest w stadium
<emphasis xmlns="http://docbook.org/ns/docbook">EKSPERYMENTALNYM</emphasis>. Oznacza to, że zachowanie funkcji, jej
nazwa, w zasadzie wszystko udokumentowane tutaj może zostać zmienione w
przyszłych wersjach PHP bez wcześniejszego uprzedzenia. Używaj tej funkcji na
własne ryzyko.</simpara></warning>'>

<!ENTITY warn.imaprecodeyaz '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Rozszerzenia <link
linkend="book.imap">IMAP</link>, <link linkend="ref.recode">recode</link> i
<link linkend="book.yaz">YAZ</link>
nie mogą być używane razem. Dzieje się tak z powodu współdzielenia tych samych oznaczeń
wewnętrznych. Notatka: problem nie dotyczy Yaz 2.0 i nowszych wersji.</simpara></warning>'>

<!ENTITY warn.install.cgi '<warning xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">
Używając instalacji CGI, serwer jest podatny na wiele potencjalnych ataków.
Sposoby obrony przed nimi zostały opisane w rozdziale o <link xmlns="http://docbook.org/ns/docbook"
linkend="security.cgi-bin">bezpieczeństwie instalacji CGI</link>.
</para></warning>'>

<!ENTITY warn.passwordhashing '<warning xmlns="http://docbook.org/ns/docbook">
 <para>
  Stosowanie tej funkcji do zabezpieczania haseł nie jest zalecane
  ze względu na wysoką wydajność algorytmu skrótu. Zobacz
  <link linkend="faq.passwords.fasthash">FAQ o hashowaniu haseł</link>
  aby poznać szczegóły i najlepsze praktyki.
 </para>
</warning>
'>

<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Nawiązując połączenie przez SSL, serwer
Microsoft IIS narusza reguły protokołu przez zamknięcie połączenia bez
wysłania wskaźnika <literal xmlns="http://docbook.org/ns/docbook">close_notify</literal>. Po przesłaniu całości danych
PHP zgłosi to jako "SSL: Fatal Protocol Error". Aby obejść ten błąd, wystarczy obniżyć
poziom raportowania błędów <link xmlns="http://docbook.org/ns/docbook" linkend="ini.error-reporting">error_reporting</link>,
tak aby nie były wyświetlane ostrzeżenia.
PHP sam wykrywa błąd serwera IIS przy otwieraniu
strumienia <literal xmlns="http://docbook.org/ns/docbook">https://</literal> i za pomocą nakładki i pomijają ostrzeżenia.
Używając funkcji <function xmlns="http://docbook.org/ns/docbook">fsockopen</function> do otwarcia gniazda
<literal xmlns="http://docbook.org/ns/docbook">ssl://</literal> programista sam musi zadbać o wyłączenie
ostrzeżeń.</para></warning>'>

<!ENTITY warn.undocumented.class '
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Ta klasa jest obecnie nieudokumentowana; dostępna jest jedynie lista jej właściwości
  i metod.
 </simpara>
</warning>
'>

<!ENTITY warn.undocumented.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja jest obecnie
nieudokumentowana, dostępna jest jedynie lista jej argumentów.
</simpara></warning>'>


<!-- Deprecation and removal warnings designed for use with a list of
     alternatives. See en/reference/regex/functions/ereg.xml and
     en/reference/regex/reference.xml for examples of these in action. -->

<!ENTITY warn.deprecated.function.4-1-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Ta funkcja została uznana za <emphasis>PRZESTARZAŁĄ</emphasis> w PHP 4.1.0 i
 <emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternatywy dla tej funkcji obejmują:
</para>
'>

<!ENTITY warn.deprecated.feature.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Ta opcja została uznana za <emphasis>PRZESTARZAŁĄ</emphasis> w PHP 5.3.0 i
 <emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternatywy dla tej opcji obejmują:
</para>
'>

<!ENTITY warn.deprecated.function.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Ta funkcja została uznana za <emphasis>PRZESTARZAŁĄ</emphasis> w PHP 5.3.0 i
 <emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternatywy dla tej funkcji obejmują:
</para>
'>

<!ENTITY warn.deprecated.function.5-5-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Ta funkcja została uznana za <emphasis>PRZESTARZAŁĄ</emphasis> w PHP 5.5.0 i
 <emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternatywy dla tej funkcji obejmują:
</para>
'>

<!ENTITY warn.removed.feature.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Ta opcja została <emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternatywy dla tej opcji obejmują:
</para>
'>

<!ENTITY warn.removed.function.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Ta funkcja została <emphasis>USUNIĘTA</emphasis> w PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternatywy dla tej funkcji obejmują:
</para>
'>

<!ENTITY warn.deprecated.feature.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Ta opcja jest <emphasis>PRZESTARZAŁA</emphasis> od PHP 7.1.0 i
 <emphasis>USUNIĘTA</emphasis> od PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternatywy dla tej opcji obejmują:
</para>
'>

<!ENTITY warn.deprecated.function.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Ta funkcja jest <emphasis>PRZESTARZAŁA</emphasis> od PHP 7.1.0 i
 <emphasis>USUNIĘTA</emphasis> od PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternatywy dla tej funkcji obejmują:
</para>
'>

<!ENTITY warn.deprecated.function-8-1-0.alternatives '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
<emphasis>PRZESTARZAŁA</emphasis> as of PHP 8.1.0. Używanie tej funkcji
jest niezalecane.</simpara></warning>
<para xmlns="http://docbook.org/ns/docbook">
  Alternatywy dla tej funkcji obejmują:
</para>
'>


<!-- Misc -->

<!ENTITY version.exists.asof 'Istnieje od PHP '>

<!ENTITY version.trunk.changelog 'Zmiany w przyszłości'>

<!ENTITY no.function.parameters '<para xmlns="http://docbook.org/ns/docbook">Ta funkcja nie posiada parametrów.</para>'>

<!ENTITY example.outputs '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład wyświetli:</para>'>

<!ENTITY example.outputs.5 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 5 wyświetli:</para>'>

<!ENTITY example.outputs.53 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 5.3 wyświetli:</para>'>

<!ENTITY example.outputs.54 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 5.4 wyświetli:</para>'>

<!ENTITY example.outputs.55 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 5.5 wyświetli:</para>'>

<!ENTITY example.outputs.56 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 5.6 wyświetli:</para>'>

<!ENTITY example.outputs.7 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 7 wyświetli:</para>'>

<!ENTITY example.outputs.70 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 7.0 wyświetli:</para>'>

<!ENTITY example.outputs.71 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 7.1 wyświetli:</para>'>

<!ENTITY example.outputs.72 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 7.2 wyświetli:</para>'>

<!ENTITY example.outputs.73 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 7.3 wyświetli:</para>'>

<!ENTITY example.outputs.8 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8 wyświetli:</para>'>

<!ENTITY example.outputs.8.similar '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8 wyświetli coś podobnego do:</para>'>

<!ENTITY example.outputs.80 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.0 wyświetli:</para>'>

<!ENTITY example.outputs.81 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.1 wyświetli:</para>'>

<!ENTITY example.outputs.82 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.2 wyświetli:</para>'>

<!ENTITY example.outputs.82.similar '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.2 wyświetli coś podobnego do:</para>'>

<!ENTITY example.outputs.83 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.3 wyświetli:</para>'>

<!ENTITY example.outputs.83.similar '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.3 wyświetli coś podobnego do:</para>'>

<!ENTITY example.outputs.84 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.4 wyświetli:</para>'>

<!ENTITY example.outputs.84.similar '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.4 wyświetli coś podobnego do:</para>'>

<!ENTITY example.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">Wyświetla następujący przykład na systemach 32 bitowych:</para>'>

<!ENTITY example.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">Wyświetla następujący przykład na systemach 64 bitowych:</para>'>

<!ENTITY example.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład wyświetli coś
podobnego do:</para>'>

<!ENTITY examples.outputs '<para xmlns="http://docbook.org/ns/docbook">Powyższe przykłady wyświetlą:</para>'>

<!ENTITY examples.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">Wyświetla następujące przykłady na systemach 32 bitowych:</para>'>

<!ENTITY examples.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">Wyświetla następujące przykłady na systemach 64 bitowych:</para>'>

<!ENTITY examples.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">Powyższe przykłady wyświetlą coś
podobnego do:</para>'>

<!ENTITY array.resetspointer '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja
zresetuje (zobacz <function xmlns="http://docbook.org/ns/docbook">reset</function>) wskaźnik <type>tablicy</type> wejściowej po swoim
wykonaniu.</simpara></note>'>

<!ENTITY array.changelog.by-ref '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Jeśli <parameter>callback</parameter> będzie funkcją, której parametr ma być przekazany
  przez referencję, to zostanie wyemitowany <constant>E_WARNING</constant>.
 </entry>
</row>'>

<!ENTITY array.changelog.require-only-one '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
  Ta funkcja może teraz zostać wywołana z tylko jednym parametrem.
  Wcześniej były wymagane przynajmniej dwa parametry.
  </entry>
</row>'>

<!ENTITY seealso.array.sorting '<link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">porównanie funkcji sortujących tablice</link>'>

<!ENTITY sort.flags.parameter '<varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>flags</parameter></term>
  <listitem>
   <para>
    Opcjonalny drugi parametr <parameter>flags</parameter> może być użyty do
    zmiany zachowania sortowania przy pomocy tych wartości:
   </para>
   <para>
    Flagi typu sortowania:
    <itemizedlist>
     <listitem>
      <simpara><constant>SORT_REGULAR</constant> - porównuj elementy normalnie;
      szczegóły zostały opisane w sekcji <link linkend="language.operators.comparison">operatory porównania</link></simpara>
     </listitem>
     <listitem>
      <simpara><constant>SORT_NUMERIC</constant> - porównuj elementy jako liczby</simpara>
     </listitem>
     <listitem>
      <simpara><constant>SORT_STRING</constant> - porównuj elementy jako ciągi tekstowe</simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_LOCALE_STRING</constant> - porównuj elementy jako ciągi
       tekstowe, uwzględniając ustawienia regionalne (locale). Ustawienia regionalne
       mogą być zmienione przy użyciu <function>setlocale</function>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_NATURAL</constant> - porównuj elementy jako ciągi tekstowe
       przy użyciu "sortowania naturalnego", tak jak <function>natsort</function>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_FLAG_CASE</constant> - może być połączona
       (operacja bitowa OR) z
       <constant>SORT_STRING</constant> lub
       <constant>SORT_NATURAL</constant> aby posortować ciągi znaków bez uwzględnienia wielkości znaków
      </simpara>
     </listitem>
    </itemizedlist>
   </para>
  </listitem>
 </varlistentry>
'>

<!ENTITY sort.callback.description '<para xmlns="http://docbook.org/ns/docbook">
 &return.callbacksort;
</para>
&callback.cmp;
<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Zwrócenie wartości <emphasis>innej niż liczba całkowita</emphasis> z funkcji
  porównującej, na przykład <type>float</type>, będzie skutkowało wewnętrznym zrzutowaniem
  wartości zwróconej przez funkcję na <type>int</type>. Wartości takie jak
  <literal>0.99</literal> i <literal>0.1</literal> będą więc obie zrzutowane
  na liczbę całkowitą <literal>0</literal>, przez co w porównaniu będą uznane za identyczne.
 </para>
</caution>'>

<!ENTITY sort.callback.description.presort '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Funkcja sortująca musi być w stanie obsłużyć każdą z wartości tablicy, w dowolnej kolejności,
  niezależnie w jakiej kolejności elementy były zdefiniowane oryginalnie.
  Wynika to z faktu że każda z tablic jest najpierw sortowana przed ich porównaniem do reszty tablic.

  Na przykład:
  <programlisting role="php">
<![CDATA[
<?php
$arrayA = ["string", 1];
$arrayB = [["value" => 1]];
// $item1 oraz $item2 mogą mieć zawartość "string", 1 lub ["value" => 1]
$compareFunc = static function ($item1, $item2) {
    $value1 = is_string($item1) ? strlen($item1) : (is_array($item1) ? $item1["value"] : $item1);
    $value2 = is_string($item2) ? strlen($item2) : (is_array($item2) ? $item2["value"] : $item2);
    return $value1 <=> $value2;
};
?>
]]>
  </programlisting>
 </para>
</caution>'>

<!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook">Jeśli użyty zostanie typ
<type>int</type>, wartość zostanie liczona w bajtach. Można także użyć
notacji skrótowej opisanej w <link xmlns="http://docbook.org/ns/docbook"
linkend="faq.using.shorthandbytes">FAQ</link>.</simpara>'>

<!ENTITY info.deprecated.alias 'Dla zachowania zgodności z poprzednimi wersjami PHP
możliwe jest używanie aliasów: '>

<!ENTITY info.function.alias 'Ta funkcja jest aliasem dla: '>

<!ENTITY info.method.alias 'Ta metoda jest aliasem dla: '>

<!ENTITY info.function.alias.deprecated '<simpara xmlns="http://docbook.org/ns/docbook">Ten alias jest nie zalecany i
istnieje tylko dla zachowania kompatybilności wstecznej. Zaleca się nie
używanie tego aliasu, jako że może on zostać usunięty w przyszłości z PHP.</simpara>'>

<!ENTITY ext.windows.path.dll 'Aby poprawnie działało rozszerzenie, pliki
<acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> muszą znajdować się w miejscu wskazanym przez <envar xmlns="http://docbook.org/ns/docbook">PATH</envar> systemu
Windows. Aby uzyskać więcej informacji zobacz <acronym xmlns="http://docbook.org/ns/docbook">FAQ</acronym> zatytułowane "<link xmlns="http://docbook.org/ns/docbook"
linkend="faq.installation.addtopath">Jak mam dodać mój katalog PHP do PATH
w Windows</link>". Chociaż skopiowanie plików DLL z folderu PHP do systemowego
katalogu Windows także zadziała (ponieważ katalog systemowy jest domyślnie
w <envar xmlns="http://docbook.org/ns/docbook">PATH</envar> systemu), ale nie jest to wymagane.
<emphasis xmlns="http://docbook.org/ns/docbook">To rozszerzenie wymaga następujących plików znajdujących się w
<envar xmlns="http://docbook.org/ns/docbook">PATH</envar>:</emphasis> '>

<!ENTITY manual.migration.seealso 'Zobacz także instrukcję migracji na nowsze wersje PHP'>

<!ENTITY style.oop 'Styl obiektowy'>
<!ENTITY style.procedural 'Styl proceduralny'>

<!ENTITY match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</link>'>

<!ENTITY parameter.context 'Opis <link xmlns="http://docbook.org/ns/docbook" linkend="context">kontekstów</link>
podano w części podręcznika poświęconej <literal xmlns="http://docbook.org/ns/docbook">kontekstom</literal>.'>

<!ENTITY parameter.use_include_path 'Gdy jest ustawiony na &true; to nazwa pliku jest szukana
wewnątrz katalogów określonych za pomocą <link xmlns="http://docbook.org/ns/docbook" linkend="ini.include-path">include_path</link>'>

<!-- Returns -->

<!ENTITY return.type.true '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Typem zwracanym przez tę funkcję jest teraz &true;, wcześniej był to <type>bool</type>.
 </entry>
</row>'>

<!ENTITY return.falseforfailure ' lub &false; w przypadku niepowodzenia'>
<!ENTITY return.falseforfailure.style.procedural '&style.procedural; zwraca &false; w przypadku niepowodzenia.'>

<!ENTITY return.success 'Zwraca &true; w przypadku powodzenia, &false; w przeciwnym razie.'>

<!ENTITY return.nullorfalse 'Zwraca &null; w wypadku powodzenia&return.falseforfailure;.'>

<!ENTITY return.void 'Nie jest zwracana żadna wartość.'>

<!ENTITY return.true.always 'Zawsze zwraca &true;.'>

<!ENTITY return.callbacksort 'Funkcja porównująca musi zwrócić liczbę całkowitą mniejszą, równą lub większą
od zera jeśli pierwszy argument jest uważany za odpowiednio mniejszy, równy lub większy od drugiego.
Przed PHP 7.0.0 ta liczba musiała być z zakresu -2147483648 do 2147483647.'>

<!ENTITY return.falseproblem '<warning xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja może
zwrócić Boolean &false;, ale może też zwrócić wartość innego typu niż Boolean, która oznacza
wartość &false;. Aby uzyskać więcej informacji proszę zapoznać się z rozdziałem <link xmlns="http://docbook.org/ns/docbook"
linkend="language.types.boolean">Typy logiczne</link>.
Można używać operatora <link xmlns="http://docbook.org/ns/docbook" linkend="language.operators.comparison">===
</link> do testowania zwracanych wartości przez tę
funkcję.</simpara></warning>'>

<!-- Standard -->
<!ENTITY standard.changelog.calling-on-objects '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Wywoływanie tej funkcji na obiektach jest uznane za przestarzałe.
  Zamiast tego możesz skonwertować obiekt na tablicę używając <function>get_mangled_object_vars</function> lub użyć metod
  dostarczonych przez klasę, która implementuje <interfacename>Iterator</interfacename>, jak np. <classname>ArrayIterator</classname>
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>7.4.0</entry>
 <entry>
  Instancje klas <link xmlns="http://docbook.org/ns/docbook" linkend="book.spl">SPL</link> są teraz traktowane jak puste obiekty, które nie mają właściwości. Wcześniej wywoływana była metoda z interfejsu <interfacename>Iterator</interfacename>, o nazwie takiej jak nazwa tej funkcji.
 </entry>
</row>
'>

<!ENTITY standard.changelog.binary-safe-string-comparison '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Ta funkcja nie gwarantuje już zwrócenia
  <code>strlen($string1) - strlen($string2)</code> gdy długości ciągów znaków
  nie są równe, ale może teraz zwrócić <literal>-1</literal> lub
  <literal>1</literal>.
 </entry>
</row>
'>

<!-- FileInfo -->
<!ENTITY fileinfo.parameters.finfo '<para xmlns="http://docbook.org/ns/docbook">Instancja klasy <classname>finfo</classname> zwrócona przez <function>finfo_open</function>.</para>'>
<!ENTITY fileinfo.changelog.finfo-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>finfo</parameter> oczekuje teraz instancji klasy <classname>finfo</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!-- OpenSSL -->
<!ENTITY openssl.param.x509 '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>x509</parameter></term>
 <listitem>
  <para>
   Zobacz <link linkend="openssl.certparams">Parametry Klucza/Certyfikatu</link>, aby zapoznać się z prawidłowymi wartościami.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY openssl.param.csr '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>csr</parameter></term>
 <listitem>
  <para>
   Zobacz <link linkend="openssl.certparams">parametry CSR</link> aby poznać listę poprawnych wartości.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY openssl.param.key '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>key</parameter></term>
 <listitem>
  <para>
   Zobacz <link linkend="openssl.certparams">parametry Klucza Publicznego/Prywatnego</link> aby poznać listę poprawnych wartości.
  </para>
 </listitem>
</varlistentry>'>

<!-- Image (GD) Notes -->
<!ENTITY note.config.t1lib '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja jest dostępna tylko jeśli
PHP zostało skompilowane z dyrektywą <option
role="configure">--enable-t1lib</option>.</simpara></note>'>

<!ENTITY note.freetype '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja jest dostępna tylko jeśli
PHP zostało skompilowane z obsługą FreeType (<option role="configure">--with-freetype-dir=DIR</option>)
</simpara></note>'>

<!ENTITY note.gd.notrequired '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Ta funkcja nie wymaga dostępu do biblioteki GD.</para></note>'>

<!ENTITY note.gd.interpolation '<note xmlns="http://docbook.org/ns/docbook"><para>Na działanie tej funkcji wpływa metoda interpolacji ustawiana przez  <function>imagesetinterpolation</function>.</para></note>'>

<!ENTITY gd.image.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>image</parameter></term><listitem><para>Obiekt klasy <classname>GdImage</classname> zwrócony przez jedną z funkcji tworzących obrazy,
taką jak <function>imagecreatetruecolor</function>.</para></listitem></varlistentry>'>

<!ENTITY gd.font.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>font</parameter></term><listitem><para>Czcionka. Może przyjąć 1, 2, 3, 4, 5 dla wbudowanych
czcionek w kodowaniu latin2 (gdzie większy numer odpowiada większej czcionce) lub obiekt klasy <classname>GdFont</classname>
zwrócony przez <function>imageloadfont</function>.</para></listitem></varlistentry>'>

<!ENTITY gd.changelog.gdfont-instance '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.1.0</entry>
  <entry>
  Parametr <parameter>font</parameter> przyjmuje teraz zarówno obiekt klasy <classname>GdFont</classname>
  oraz typ &integer;; wcześniej akceptowany był tylko typ &integer;.
  </entry>
</row>'>

<!ENTITY gd.ttf.fontfile "
    <varlistentry xmlns='http://docbook.org/ns/docbook'>
     <term><parameter>fontfile</parameter></term>
     <listitem>
      <para>
       Ścieżka do fonta TrueType, którego chcesz użyć.
      </para>
      <para>
       W zależności od tego której wersji biblioteki GD używa PHP, <emphasis>gdy
       <parameter>fontfile</parameter> nie zaczyna się od znaku <literal>/</literal>,
       wtedy do nazwy pliku zostanie dodane rozszerzenie <literal>.ttf</literal></emphasis>
       a biblioteka GD będzie szukać pliku o tej nazwie w swojej globalnej ścieżce dla fontów.
      </para>
      <para>
       Gdy używana jest biblioteka GD w wersji niższej niż 2.0.18, to znakiem 'separacji ścieżek' dla różnych plików czcionek
       jest znak <literal>spacji</literal>, a nie średnik.
       Nieświadome skorzystanie z tej funkcjonalności będzie skutkować ostrzeżeniem:
       <literal>Warning: Could not find/open font</literal>. Jeśli używasz wersji dotkniętej tym problemem,
       to jedynym rozwiązaniem jest przeniesienie pliku do ścieżki nie zawierającej spacji.
      </para>
      <para>
       W wielu wypadkach, gdy plik czcionki znajduje się w tym samym katalogu co skrypt, który go wykorzystuje,
       użycie następującej sztuczki pozwoli uniknąć jakichkolwiek problemów z dołączaniem czcionek.
       <programlisting role='php'>
<![CDATA[
<?php
// Ustaw zmienną środowiskową dla GD
putenv('GDFONTPATH=' . realpath('.'));

// Nazwa czcionki, której chcemy użyć (zwróć uwagę na brak rozszerzenia .ttf)
$font = 'SomeFont';
?>
]]>
       </programlisting>
      </para>
      <note>
       <para>
        Dyrektywa <link linkend='ini.open-basedir'>open_basedir</link>
        <emphasis>nie ma</emphasis> wpływu na <parameter>fontfile</parameter>.
       </para>
      </note>
     </listitem>
    </varlistentry>
">

<!ENTITY gd.return.identifier 'Zwraca identyfikator zasobu obrazu w przypadku powodzenia lub &false; w przypadku błędów.'>

<!ENTITY gd.return.trueonerror '<caution xmlns="http://docbook.org/ns/docbook"><simpara>Jednakże, jeśli libgd nie jest w stanie zwrócić obrazka, ta funkcja zwraca &true;.</simpara></caution>'>

<!ENTITY gd.identifier.color "Identyfikator koloru stworzony z użyciem <function xmlns='http://docbook.org/ns/docbook'>imagecolorallocate</function>.">

<!ENTITY gd.value.red 'Wartość składowa czerwonego.'>

<!ENTITY gd.value.green 'Wartość składowa zielonego.'>

<!ENTITY gd.value.blue 'Wartość składowa niebieskiego.'>

<!ENTITY gd.source.height 'Wysokość źródła.'>

<!ENTITY gd.source.width 'Szerokość źródła.'>

<!ENTITY gd.image.path 'Ścieżka lub otwarty zasób (który jest automatycznie zamykany gdy ta funkcja zwraca wartość) do miejsca gdzie zapisać plik. Jeśli nie jest ustawiona lub ma wartość &null;, obraz zostanie przesłany bezpośrednio na wyjście.'>

<!ENTITY gd.image.new 'Tworzy nowy obraz z pliku lub URL'>

<!ENTITY gd.image.source 'Zasób obrazu źródłowego.'>

<!ENTITY gd.image.destination 'Zasób obrazu wynikowego.'>

<!ENTITY gd.image.output 'Wysłanie obrazu do przeglądarki lub zapis do pliku'>

<!ENTITY gd.image.colors 'Jeśli tworzony jest obraz z pliku, zwracane są indeksy kolorów użyte tylko w obrazie. Kolory będące tylko w palecie nie są zwracane.'>

<!ENTITY gd.font.size 'Rozmiar czcionki, określony w punktach.'>

<!ENTITY gd.constants.types '<simpara xmlns="http://docbook.org/ns/docbook">
    Używana jako wartość zwracana przez <function>imagetypes</function>
</simpara>'>

<!ENTITY gd.constants.color '<simpara xmlns="http://docbook.org/ns/docbook">
    Specjalna operacja na kolorze, która może być użyta zamiast koloru zaalokowanego przez
    <function>imagecolorallocate</function> lub
    <function>imagecolorallocatealpha</function>.
</simpara>'>

<!ENTITY gd.constants.affine '<simpara xmlns="http://docbook.org/ns/docbook">
    Typ przekształcenia aficznego używany przez funkcję <function>imageaffinematrixget</function>.
</simpara>'>

<!ENTITY gd.constants.arc '<simpara xmlns="http://docbook.org/ns/docbook">
    Stała stylu używana przez funkcję <function>imagefilledarc</function>.
</simpara>'>

<!ENTITY gd.constants.gd2 '<simpara xmlns="http://docbook.org/ns/docbook">
    Stała typu używana przez funkcję <function>imagegd2</function>.
</simpara>'>

<!ENTITY gd.constants.effect '<simpara xmlns="http://docbook.org/ns/docbook">
    Efekt łączenia alfa używany przez funkcję <function>imagelayereffect</function>.
</simpara>'>

<!ENTITY gd.constants.filter '<simpara xmlns="http://docbook.org/ns/docbook">
    Specjalny filtr GD używany przez funkcję <function>imagefilter</function>.
</simpara>'>

<!ENTITY gd.constants.type '<simpara xmlns="http://docbook.org/ns/docbook">
    Stała typu obrazu używana przez funkcje<function>image_type_to_mime_type</function>
    i <function>image_type_to_extension</function>.
</simpara>'>

<!ENTITY gd.constants.png-filter '<simpara xmlns="http://docbook.org/ns/docbook">
    Specjalny filtr PNG używany przez funkcję  <function>imagepng</function>.
</simpara>'>

<!ENTITY gd.constants.flip '<simpara xmlns="http://docbook.org/ns/docbook">
    Używane razem z <function>imageflip</function>, dostępne od PHP 5.5.0.
</simpara>'>

<!ENTITY gd.constants.interpolation '<simpara xmlns="http://docbook.org/ns/docbook">
    Używane razem z <function>imagesetinterpolation</function>, dostępne od PHP 5.5.0.
</simpara>'>

<!ENTITY gd.changlog.t1lib '<row xmlns="http://docbook.org/ns/docbook">
    <entry>7.0.0</entry><entry>Z PHP usunięto wsparcie T1Lib, a więc i ta funkcja została usunięta.</entry>
</row>'>

<!ENTITY gd.deprecated.gd-formats '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Formaty obrazów GD
i GD2 są własnościowymi formatami libgd. Powinno się je traktować jako
<emphasis>przestarzałe</emphasis> i używać ich tylko w celu testowania i rozwoju
oprogramowania.</simpara></warning>'>

<!ENTITY gd.changelog.image-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>image</parameter> oczekuje obiektu klasy <classname>GdImage</classname>;
  wcześniej oczekiwany był poprawny <link linkend="language.types.resource">zasób</link> <literal>gd</literal>.
 </entry>
</row>'>

<!-- CSV -->
<!ENTITY warning.csv.escape-parameter '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><simpara>
 Gdy parametr <parameter>escape</parameter> jest ustawiony na dowolną wartość inną niż pusty ciąg znaków,
 (<literal>""</literal>), to wynikiem może być CSV, który nie jest zgodny z
 <link xlink:href="&url.rfc;4180">RFC 4180</link> lub taki, który nie przetrwa
 przetworzenia przez funkcje obsługi CSV w PHP. Domyślną wartością parametru <parameter>escape</parameter> jest
 <literal>"\\"</literal>, tak więc zaleca się aby jawnie ustawić go na pusty ciąg znaków.
 Domyślna wartość zmieni się w przyszłości, ale nie wcześniej niż w PHP 9.0.
</simpara></warning>'>

<!-- DBM notes -->

<!ENTITY dbm.dbm-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>dbm_identifier</parameter></term><listitem><para>Identyfikator połączenia DBM,
zwrócony przez <function>dbmopen</function>.</para></listitem></varlistentry>'>

<!-- JSON notes -->

<!ENTITY json.implementation.superset '
 <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <para>
   PHP implementuje nadzbiór JSON tak jak określono oryginalnie w
   <link xlink:href="&url.rfc;7159">RFC 7159</link>.
  </para>
 </note>
'>

<!-- cURL notes -->

<!ENTITY curl.ch.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>handle</parameter>
</term><listitem><para>Uchwyt cURL zwrócony przez
<function>curl_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.mh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>multi_handle</parameter>
</term><listitem><para>Wielokrotny uchwyt cURL zwrócony przez
<function>curl_multi_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.sh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>share_handle</parameter>
</term><listitem><para>Współdzielony uchwyt cURL zwrócony przez
<function>curl_share_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.changelog.handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>handle</parameter> oczekuje teraz obiektu klasy <classname>CurlHandle</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!ENTITY curl.changelog.multi-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>multi_handle</parameter> oczekuje teraz obiektu klasy <classname>CurlMultiHandle</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!ENTITY curl.changelog.share-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>share_handle</parameter> oczekuje teraz obiektu klasy <classname>CurlShareHandle</classname>
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!-- dba notes -->
<!ENTITY dba.parameter.dba 'Obiekt <classname xmlns="http://docbook.org/ns/docbook">Dba\Connection</classname> zwracany przez <function xmlns="http://docbook.org/ns/docbook">dba_open</function> lub <function xmlns="http://docbook.org/ns/docbook">dba_popen</function>.'>
<!ENTITY dba.changelog.dba-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Parametr <parameter>dba</parameter> przyjmuje teraz obiekt klasy <classname>Dba\Connection</classname>,
  wcześniej oczekiwany był poprawny <link linkend="language.types.resource">zasób</link> <literal>dba</literal>.
 </entry>
</row>'>

<!-- dbase notes -->

<!ENTITY dbase.type-conversion '<para xmlns="http://docbook.org/ns/docbook">
   Każde pole jest konwertowane na odpowiadający typ PHP, z wyjątkiem:
   <itemizedlist>
    <listitem>
     <simpara>
      Dat, które pozostają ciągami znaków.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Wartości DateTime są konwertowane na ciągi znaków.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Liczby stałe spoza zakresu
      <constant>PHP_INT_MIN</constant>..<constant>PHP_INT_MAX</constant> są
      zwracane jako ciąg znaków.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Przed dbase 7.0.0, typy logiczne (<literal>L</literal>) były konwertowane na <literal>1</literal> lub
      <literal>0</literal>.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>'>

<!-- enchant entities -->

<!ENTITY enchant.param.broker '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>broker</parameter></term>
     <listitem>
      <para>
       Broker Enchant zwrócony przez <function>enchant_broker_init</function>.
      </para>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.param.dictionary '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>dictionary</parameter></term>
     <listitem>
      <para>
       Słownik Enchant zwrócony przez <function>enchant_broker_request_dict</function>
       lub <function>enchant_broker_request_pwl_dict</function>.
      </para>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.changelog.broker-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>broker</parameter> oczekuje obiektu klasy <classname>EnchantBroker</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!ENTITY enchant.changelog.dictionary-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>dictionary</parameter> oczekuje teraz obiektu klasy <classname>EnchantDictionary</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!-- IMAP notes -->

<!ENTITY imap.changelog.imap-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>imap</parameter> oczekuje teraz obiektu klasy <classname>IMAP\Connection</classname>;
  wcześniej oczekiwany był poprawny <link linkend="language.types.resource">zasób</link> <literal>imap</literal>.
 </entry>
</row>'>

<!ENTITY imap.imap-parameter.imap '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>imap</parameter></term><listitem><para>Instancja <classname>IMAP\Connection</classname>.</para></listitem></varlistentry>'>

<!-- Deprecated -->
<!ENTITY imap.imap-stream.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>imap_stream</parameter></term><listitem><para>Strumień IMAP zwrócony przez
<function>imap_open</function>.</para></listitem></varlistentry>'>

<!ENTITY imap.pattern '<para xmlns="http://docbook.org/ns/docbook">Określa gdzie w hierarchii skrzynki rozpocząć
wyszukiwanie.</para><para xmlns="http://docbook.org/ns/docbook">Istnieją dwa specjalne znaki, które możesz
przekazać jako część argumentu <parameter xmlns="http://docbook.org/ns/docbook">pattern</parameter>:
&apos;<literal xmlns="http://docbook.org/ns/docbook">*</literal>&apos; i &apos;<literal xmlns="http://docbook.org/ns/docbook">&#37;</literal>&apos;.
&apos;<literal xmlns="http://docbook.org/ns/docbook">*</literal>&apos; oznacza zwrócenie wszystkich skrzynek. Jeżeli jako argument
<parameter xmlns="http://docbook.org/ns/docbook">pattern</parameter> ustawiony na &apos;<literal xmlns="http://docbook.org/ns/docbook">*</literal>&apos; zwróci
pełną hierarchię skrzynki mailowej.
&apos;<literal xmlns="http://docbook.org/ns/docbook">&#37;</literal>&apos;
oznacza zwrócenie tylko obecnego poziomu.
&apos;<literal xmlns="http://docbook.org/ns/docbook">&#37;</literal>&apos; jako parametr <parameter xmlns="http://docbook.org/ns/docbook">pattern</parameter>
zwróci tylko skrzynki mailowe najwyższego
poziomu; &apos;<literal xmlns="http://docbook.org/ns/docbook">~/mail/&#37;</literal>&apos; na <literal xmlns="http://docbook.org/ns/docbook">UW_IMAPD</literal> zwróci każdą skrzynkę w katalogu <filename xmlns="http://docbook.org/ns/docbook">~/mail</filename>, ale nie w jego podkatalogach.</para>'>

<!ENTITY imap.mailboxname.insecure '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
Przekazywanie niezaufanych danych do tego parametru jest <emphasis>niebezpieczne</emphasis>, chyba że dyrektywa
<link linkend="ini.imap.enable-insecure-rsh">imap.enable_insecure_rsh</link> jest wyłączona.
</simpara></warning>'>

<!-- intl notes -->

<!ENTITY intl.parameter.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">Instancja <classname>IntlCalendar</classname>.</para>'>

<!ENTITY intl.error.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">W wypadku błędu zwracane jest także &false;. Aby wykryć wystąpienie błędu użyj <function>intl_get_error_code</function>, lub ustaw Intl tak, aby rzucało <link linkend="ini.intl.use-exceptions">wyjątki</link>.</para>'>

<!ENTITY intl.codepoint.parameter '<para xmlns="http://docbook.org/ns/docbook">Wartość typu <type>int</type> dla punktu kodowego (np. <literal>0x2603</literal> dla <emphasis>U+2603 SNOWMAN</emphasis>) lub znak zakodowany jako <type>string</type> UTF-8 (np. <literal>"\u{2603}"</literal>)</para>'>

<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">Zwróconym typem będzie <type>int</type>, chyba że codepoint przekazano jako łańcuch znaków UTF-8 - w tym wypadku zwrócony zostanie <type>string</type>.</para>'>

<!ENTITY intl.codepoint.example 'Testowanie różnych punktów kodowych'>

<!ENTITY intl.locale-len.return '<para xmlns="http://docbook.org/ns/docbook">Zwraca &null; gdy długość podanego <parameter>locale</parameter> przekracza <constant>INTL_MAX_LOCALE_LEN</constant>.</para>'>

<!ENTITY intl.property.parameter '<para xmlns="http://docbook.org/ns/docbook">Właściwość Unicodu do znalezienia (zobacz stałe <literal>IntlChar::PROPERTY_*</literal>).</para>'>

<!ENTITY intl.property.example 'Testowanie różnych właściwości'>

<!-- LDAP notes -->

<!ENTITY ldap.parameter.ldap 'Instancja klasy <classname xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname>, zwracana przez <function xmlns="http://docbook.org/ns/docbook">ldap_connect</function>.'>

<!ENTITY ldap.parameter.result 'Instancja klasy <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, zwracana przez <function xmlns="http://docbook.org/ns/docbook">ldap_list</function> lub <function xmlns="http://docbook.org/ns/docbook">ldap_search</function>.'>

<!ENTITY ldap.parameter.entry 'Instancja klasy <classname xmlns="http://docbook.org/ns/docbook">LDAP\ResultEntry</classname>.'>

<!-- TODO: Translate "LDAP controls" eventually -->
<!ENTITY ldap.warn.control-paged '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Ta funkcja jest <emphasis>PRZESTARZAŁA</emphasis> od PHP 7.4.0 i <emphasis>REMOVED</emphasis> od PHP 8.0.0.
  Zamiast niej powinien być użyty parametr <parameter>controls</parameter> funkcji <function>ldap_search</function>.
  Zobacz też <link linkend="ldap.controls">LDAP Controls</link> aby dowiedzieć się więcej.
 </simpara>
</warning>'>

<!ENTITY ldap.changelog.controls-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>controls</parameter> dopuszcza teraz &null;, wcześniej jego wartością domyślną było <literal>[]</literal>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.ldap-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>ldap</parameter> oczekuje obiektu klasy <classname>LDAP\Connection</classname>;
  wcześniej oczekiwany był poprawny <link linkend="language.types.resource">zasób</link> <literal>ldap link</literal>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>entry</parameter> oczekuje obiektu klasy <classname>LDAP\ResultEntry</classname>;
  wcześniej oczekiwany był poprawny <link linkend="language.types.resource">zasób</link> <literal>ldap result entry</literal>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>result</parameter> oczekuje obiektu klasy <classname>LDAP\Result</classname>;
  wcześniej oczekiwany był poprawny <link linkend="language.types.resource">zasób</link> <literal>ldap result</literal>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Zwraca obiekt klasy <classname>LDAP\Result</classname>;
  wcześniej zwracany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Zwraca obiekt klasy <classname>LDAP\ResultEntry</classname>;
  wcześniej zwracany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!ENTITY ldap.return-result 'Zwraca obiekt klasy <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>&return.falseforfailure;.'>
<!ENTITY ldap.return-result-array 'Zwraca obiekt klasy <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, tablicę obiektów <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>&return.falseforfailure;.'>

<!ENTITY ldap.return-result-array-info '<para xmlns="http://docbook.org/ns/docbook">Można też wykonać wyszukiwania równoległe. W tym wypadku pierwszym argumentem powinna być tablica
obiektów <classname>LDAP\Connection</classname>, a nie pojedynczy obiekt.
Jeśli nie wszystkie wyszukania powinny używać tego samego filtru lub bazowego DN, to zamiast tego można przekazać tablicę bazowych DN i/lub tablicę filtrów jako argumenty.
Tablice te muszą być tej samej długości co tablica z obiektami <classname>LDAP\Connection</classname>,
ponieważ pierwsze wpisy tablic są wykorzystywane do wykonania jednego wyszukiwania, drugie wpisy dla wykonania drugiego i tak dalej.
Kiedy wykonywane jest wyszukiwanie równoległe, zwracana jest tablica obiektów <classname>LDAP\Result</classname>, chyba że wystąpił błąd, wtedy zwracane jest &false;.</para>'>

<!-- mbstring notes -->

<!ENTITY note.mbstring.encoding.internal '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Wewnętrzne kodowanie lub
kodowanie znaków określone przez <function xmlns="http://docbook.org/ns/docbook">mb_regex_encoding</function>
zostanie użyte jako kodowanie znaków dla tej funkcji.</para></note>'>

<!ENTITY note.mbstring.encoding.current '<note xmlns="http://docbook.org/ns/docbook"><para>Dla tej funkcji zostanie
domyślnie użyte kodowanie znaków określone przez <function>mb_regex_encoding</function>.</para></note>'>

<!ENTITY mbstring.encoding.parameter '<para xmlns="http://docbook.org/ns/docbook">Parametr <parameter xmlns="http://docbook.org/ns/docbook">encoding</parameter>
określa kodowanie znaków. Jeśli nie jest podany lub został ustawiony na &null;, to zostanie użyta wewnętrzna wartość
kodowania znaków.</para>'>

<!ENTITY mbstring.warning.e-modifier '<warning xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Nigdy nie należy używać modyfikatora <literal xmlns="http://docbook.org/ns/docbook">e</literal> na niesprawdzonych danych wejściowych. Znaki unikowe nie są dodawane automatycznie (podobnie jak w <function xmlns="http://docbook.org/ns/docbook">preg_replace</function>). Nie zwracanie uwagi na to często powoduje, że aplikacje są podatne na zdalne wywoływania szkodliwego kodu.</para></warning>'>

<!ENTITY mbstring.changelog.encoding-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>encoding</parameter> dopuszcza teraz &null;.
 </entry>
</row>'>

<!ENTITY mbstring.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>needle</parameter> dopuszcza teraz też pusty ciąg znaków.
 </entry>
</row>'>

<!-- mcrypt notes -->

<!ENTITY mcrypt.parameter.cipher '<para xmlns="http://docbook.org/ns/docbook">Jedna ze stałych <constant>MCRYPT_szyfr</constant>, lub nazwa algorytmu jako ciąg znaków.</para>'>

<!ENTITY mcrypt.parameter.iv '<para xmlns="http://docbook.org/ns/docbook">Stosowany dla inicjalizacji trybów CBC, CFB, OFB, oraz - przy niektórych algorytmach - trybu STREAM. Nie podając IV, jeśli algorytm tego wymaga, spowoduje wygenerowanie ostrzeżenia i użycie IV ze wszystkimi bajtami ustawionymi na  "<literal>\0</literal>".</para>'>

<!ENTITY mcrypt.parameter.iv.strict '<para xmlns="http://docbook.org/ns/docbook">Stosowany dla inicjalizacji trybów CBC, CFB, OFB, oraz - przy niektórych algorytmach - trybu STREAM. Nie podając IV, jeśli algorytm tego wymaga, spowoduje wygenerowanie ostrzeżenia i zwrócenie &false; przez funkcję.</para>'>

<!ENTITY mcrypt.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">Jedna ze stałych <constant>MCRYPT_MODE_nazwatrybu</constant>, lub jeden z następujących ciągów znaków: "ecb", "cbc", "cfb", "ofb", "nofb" lub "stream".</para>'>

<!-- MCVE notes -->

<!ENTITY mcve.conn.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>conn</parameter></term><listitem><para>Zasób MCVE_CONN zwrócony przez
<function>m_initengine</function>.</para></listitem></varlistentry>'>

<!-- memcached notes -->

<!ENTITY memcached.note.delete-time '<note xmlns="http://docbook.org/ns/docbook"><simpara>
       Począwszy od memcached 1.3.0 (wydany w 2009 roku) ta opcja nie jest już
       wspierana. Przekazanie parametru <parameter>time</parameter> o wartości innej niż zero spowoduje
       że usunięcie się nie powiedzie. <methodname>Memcached::getResultCode</methodname>
       zwróci <constant>MEMCACHED_INVALID_ARGUMENTS</constant>.
      </simpara></note>
'>

<!ENTITY memcached.parameter.expiration 'Czas wygaśnięcia, domyślnie 0. Zobacz <link xmlns="http://docbook.org/ns/docbook"
 linkend="memcached.expiration">Czasy wygaśnięcia</link>, aby dowiedzieć się wiecej.'>

<!ENTITY memcached.parameter.server_key 'Klucz identyfikujący serwer, na którym dane będą zapisywane lub z którego będą odczytywane. Zamiast stosowania funkcji skrótu na samym kluczu elementu, stosujemy ją na kluczu serwera decydując z którym serwerem memcached się łączyć. Pozwala to na grupowanie powiązanych ze sobą elementów na jednym serwerze pozwalając na zwiększenie wydajności przy wielokrotnych operacjach.'>

<!ENTITY memcached.parameter.items 'Tablica, para kluczy/wartości do przechowywania na serwerze.'>

<!ENTITY memcached.parameter.key 'Klucz określający przechowywaną wartość.'>

<!ENTITY memcached.parameter.value 'Wartość do przechowania.'>

<!ENTITY memcached.result.getresultcode 'Użyj <methodname xmlns="http://docbook.org/ns/docbook">Memcached::getResultCode</methodname>, jeśli to konieczne.'>

<!ENTITY memcached.result.delete-multi '<para xmlns="http://docbook.org/ns/docbook">
   Zwraca tablicę indeksowaną kluczami <parameter>keys</parameter>. Każdy z elementów
   ma wartość &true; jeśli odpowiadający mu klucz został skasowany lub jedną ze
   stałych <constant>Memcached::RES_<replaceable>*</replaceable></constant>, jeśli odpowiadające elementowi usunięcie
   nie powiodło się.
   </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Metoda <methodname>Memcached::getResultCode</methodname> zwróci
   kod wyniku dla ostatniej wykonanej operacji usunięcia, tj. operacji
   usunięcia ostatniego elementu tablicy <parameter>keys</parameter>.
  </para>
'>

<!-- password notes -->

<!ENTITY password.parameter.algo '<link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">Stała algorytmu hasła</link> wyznaczająca algorytm stosowany przy generowaniu skrótu hasła.'>

<!ENTITY password.parameter.hash 'Skrót wygenerowany przez <function xmlns="http://docbook.org/ns/docbook">password_hash</function>.'>

<!ENTITY password.parameter.options 'Tablica asocjacyjna zawierająca opcje. Zobacz <link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">stałe algorytmów haseł</link>, aby poznać opcje wspierane przez każdy z algorytmów.'>

<!ENTITY password.parameter.password 'Hasło użytkownika.'>

<!-- pspell notes -->

<!ENTITY pspell.changelog.pspell-dictionary '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>dictionary</parameter> oczekuje teraz obiektu klasy <classname>PSpell\Dictionary</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!ENTITY pspell.changelog.pspell-config '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>config</parameter> oczekuje teraz obiektu klasy <classname>PSpell\Config</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!ENTITY pspell.parameter.pspell-dictionary '<para xmlns="http://docbook.org/ns/docbook">Instancja <classname>PSpell\Dictionary</classname>.</para>'>

<!ENTITY pspell.parameter.pspell-config '<para xmlns="http://docbook.org/ns/docbook">Instancja <classname>PSpell\Config</classname>.</para>'>

<!-- RNP -->

<!ENTITY rnp.parameter.ffi-description 'Obiekt FFI zwrócony przez rnp_ffi_create.'>

<!ENTITY rnp.parameter.key-format 'Format klucza danych (GPG, KBX, G10).'>

<!ENTITY rnp.parameter.loadsave-flags 'Zobacz opisy flag RNP_LOAD_SAVE_*.'>

<!-- socket entities -->

<!ENTITY sockets.changelog.socket-param '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
   Parametr <parameter>socket</parameter> jest teraz obiektem klasy <classname>Socket</classname>;
   wcześniej był to <link linkend="language.types.resource">zasób</link>.
  </entry>
 </row>'>

<!ENTITY sockets.changelog.address-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>address</parameter> jest teraz obiektem klasy <classname>AddressInfo</classname>;
  wcześniej był to <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!-- geaman notes -->

<!ENTITY gearman.parameter.host 'Nazwa hosta serwera roboczego.'>

<!ENTITY gearman.parameter.port 'Port serwera roboczego.'>

<!ENTITY gearman.parameter.functionname 'Zarejestrowana funkcja, którą ma wykonać worker'>

<!ENTITY gearman.parameter.workload 'Zserializowane dane do przetworzenia'>

<!ENTITY gearman.parameter.data 'Dodatkowe dane, które mogą być potrzebne do zakończenia zadania'>

<!ENTITY gearman.parameter.context 'Kontekst aplikacji do skojarzenia z zadaniem'>

<!ENTITY gearman.parameter.unique 'Unikalny identyfikator konkretnego zadania'>

<!ENTITY gearman.parameter.jobhandle 'Uchwyt zadania przypisany przez serwer Gearman'>

<!ENTITY gearman.parameter.callback '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>callback</parameter></term>
 <listitem>
  <para>
   Funkcja lub metoda do wywołania,
   Powinna zwrócić poprawną <link linkend="gearman.constants">wartość zwracaną dla Gearman</link>.
  </para>
  <para>
   Jeżeli nie znaleziono wyrażenia return, to domyślnie zostanie użyte <constant>GEARMAN_SUCCESS</constant>.
  </para>
  <methodsynopsis>
   <type>int</type><methodname><replaceable>callback</replaceable></methodname>
   <methodparam><type>GearmanTask</type><parameter>task</parameter></methodparam>
   <methodparam><type>mixed</type><parameter>context</parameter></methodparam>
  </methodsynopsis>
  <variablelist>
   <varlistentry>
    <term><parameter>task</parameter></term>
    <listitem>
     <para>
      Zadanie, dla którego wykonywana jest ta funkcja zwrotna.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>context</parameter></term>
    <listitem>
     <para>
      Cokolwiek co zostało przekazane do <methodname>GearmanClient::addTask</methodname> (lub odpowiednika) jako parametr <parameter>context</parameter>.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </listitem>
</varlistentry>'>

<!ENTITY gearman.note.callback '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Funkcja zwrotna zostanie wykonana tylko dla zadań, które zostaną dodane (np. używając <methodname>GearmanClient::addTask</methodname>)
  po wywołaniu tej metody.
 </para>
</note>'>

<!-- Date and time entities -->
<!ENTITY date.timezone.intro.title '<title xmlns="http://docbook.org/ns/docbook">Lista obsługiwanych stref czasowych</title>'>

<!ENTITY date.timezone.intro "<para xmlns='http://docbook.org/ns/docbook'>
Tutaj znajdziesz kompletną listę stref czasowych obsługiwanych przez PHP, co
oznacza, że mogą być użyte np. w <function>date_default_timezone_set</function>.
<caution><simpara>Zachowanie stref czasowych niewymienionych tutaj jest niezdefiniowane.</simpara></caution>
</para><note xmlns='http://docbook.org/ns/docbook'><simpara>Najnowsza wersja bazy danych stref czasowych może być
zainstalowana przez PECL <link xmlns='http://docbook.org/ns/docbook' xlink:href='&url.pecl.package.get;timezonedb' xmlns:xlink='http://www.w3.org/1999/xlink'>timezonedb</link>.
</simpara></note>">

<!ENTITY date.timezone.bc '<simpara xmlns="http://docbook.org/ns/docbook">Proszę nie używać żadnej ze stref czasowych podanych tutaj
(za wyjątkiem UTC), istnieją one wyłącznie dla kompatybilności wstecznej i mogą zachowywać się nieprawidłowo.
Ponadto, te strefy czasowe mogą zostać usunięte z bazy stref czasowych IANA w dowolnym momencie.
</simpara>'>

<!ENTITY date.timezone.posix-signs '<simpara xmlns="http://docbook.org/ns/docbook">
 Jeśli zignorujesz powyższe ostrzeżenie, zauważ proszę iż baza stref czasowych IANA,
 która jest używana przez PHP, korzysta ze znaków w stylu POSIX, co oznacza że strefy
 czasowe w stylu <literal>Etc/GMT+n</literal> i
 <literal>Etc/GMT-n</literal> są wycofywane z użytku.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Przykładowo strefa czasowa 8 godzin do przodu względem GMT, która jest używana (między
 innymi) w Chinach i Zachodniej Australii w tej bazie została zapisana jako
 <literal>Etc/GMT-8</literal>, a nie
 <literal>Etc/GMT+8</literal> jak można by się spodziewać.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Dlatego właśnie zalecane jest użycie prawidłowej strefy czasowej dla danej
 lokalizacji, jak na przykład <literal>Asia/Shanghai</literal> lub
 <literal>Australia/Perth</literal>, w wypadkach opisanych powyżej.
</simpara>'>

<!ENTITY date.timezone.abbrev-volatile '<simpara xmlns="http://docbook.org/ns/docbook">
Przedstawione skróty stref czasowych powinny być traktowane jako bardzo zmienne, mogą się
na przykład różnić między każdym wydaniem bazy stref czasowych i nie powinno się na nich polegać.
Zaleca się całkowicie unikać używania skrótów stref czasowych.
</simpara>'>

<!ENTITY date.timezone.errors.description '<para xmlns="http://docbook.org/ns/docbook">
Każde wywołanie do funkcji date/time spowoduje wygenerowanie <constant>E_WARNING</constant>
jeśli strefa czasowa jest nieprawidłowa. Patrz także <function>date_default_timezone_set</function></para>'>

<!ENTITY date.timezone.errors.changelog '<row xmlns="http://docbook.org/ns/docbook" ><entry xmlns="http://docbook.org/ns/docbook" >5.1.0</entry><entry xmlns="http://docbook.org/ns/docbook" ><para xmlns="http://docbook.org/ns/docbook">
Teraz generuje błędy strefy czasowej o poziomie <constant>E_STRICT</constant> i
<constant>E_NOTICE</constant>.
</para></entry></row>'>

<!ENTITY date.timestamp.description '
<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>timestamp</parameter></term><listitem><para>
Opcjonalny parametr uniksowy znacznik czasu <parameter>timestamp</parameter> jest typu
<type>int</type> i domyślnie jest ustawiony na bieżący czas lokalny jeśli
<parameter>timestamp</parameter> nie został podany. Innymi słowy,
domyślnie to wartość funkcji <function>time</function>.
</para></listitem></varlistentry>'>

<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Tylko styl proceduralny: Obiekt <classname>DateTime</classname>
zwracany przez <function>date_create</function></para></listitem></varlistentry>'>

<!ENTITY date.datetime.description.modified '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Tylko styl proceduralny: Obiekt <classname>DateTime</classname>
zwracany przez <function>date_create</function>.
Funkcja modyfikuje ten obiekt.</para></listitem></varlistentry>'>

<!ENTITY date.datetimezone.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>object</parameter></term><listitem><para>Tylko styl proceduralny: Obiekt <classname>DateTimeZone</classname>
zwracany przez <function>timezone_open</function></para></listitem></varlistentry>'>

<!ENTITY date.datetime.return.modifiedobjectorfalseforfailure 'Zwraca zmodyfikowany obiekt <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname>&return.falseforfailure;.'>
<!ENTITY date.datetime.return.modifiedobject 'Zwraca zmodyfikowany obiekt <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname>.'>
<!ENTITY date.datetimeimmutable.return.modifiedobjectorfalseforfailure 'Zwraca nowy obiekt <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> ze zmodyfikowanymi danymi&return.falseforfailure;.'>
<!ENTITY date.datetimeimmutable.return.modifiedobject 'Zwraca nowy obiekt <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> ze zmodyfikowanymi danymi.'>

<!ENTITY date.timezone.dbversion 'Ta lista jest oparta o wersję bazy danych stref czasowych'>

<!ENTITY date.timezone.africa 'Afryka'>
<!ENTITY date.timezone.america 'Ameryka'>
<!ENTITY date.timezone.antarctica 'Antarktyda'>
<!ENTITY date.timezone.arctic 'Arktyka'>
<!ENTITY date.timezone.asia 'Azja'>
<!ENTITY date.timezone.atlantic 'Ocean Atlantycki'>
<!ENTITY date.timezone.australia 'Australia'>
<!ENTITY date.timezone.europe 'Europa'>
<!ENTITY date.timezone.indian 'Ocean Indyjski'>
<!ENTITY date.timezone.pacific 'Ocean Spokojny'>
<!ENTITY date.timezone.others 'Inne'>
<!ENTITY date.timezone.abbreviations 'Skróty'>

<!ENTITY date.formats 'Prawidłowe formaty są wyjaśnione pod adresem <link xmlns="http://docbook.org/ns/docbook" linkend="datetime.formats">Formaty daty i czasu</link>.'>
<!ENTITY date.formats.parameter 'Łańcuch daty/czasu. &date.formats;'>

<!-- DomXml Notes -->
<!ENTITY node.inserted 'Ten węzeł nie pojawi się w dokumencie dopóki nie
zostanie wstawiony, np. funkcją <function xmlns="http://docbook.org/ns/docbook">domnode_append_child</function>.'>

<!-- Dom Notes -->
<!ENTITY dom.node.inserted 'Ten węzeł nie pojawi się w dokumencie dopóki nie
zostanie wstawiony, np. metodą <link xmlns="http://docbook.org/ns/docbook"
linkend="domnode.appendchild">DOMNode::appendChild()</link>.'>

<!ENTITY dom.malformederror '<para xmlns="http://docbook.org/ns/docbook">Podczas gdy nieprawidłowy kod HTML powinien zostać załadowany poprawnie, ta funkcja może wygenerować błąd poziomu <constant>E_WARNING</constant> po napotkaniu nieprawidłowej składni. Do poprawnej obsługi tych błędów można zastosować <link linkend="function.libxml-use-internal-errors">funkcje obsługi błędów biblioteki libxml</link>.</para>'>
<!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>Rozszerzenie DOM używa kodowania UTF-8. Skorzystaj z <function>mb_convert_encoding</function>, <methodname>UConverter::transcode</methodname> lub <function>iconv</function> aby obsłużyć inne kodowania.</para></note>'>
<!ENTITY dom.note.modern.utf8 '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Rozszerzenie DOM używa kodowania UTF-8 podczas pracy z metodami lub właściwościami.
  Metody parsera automatycznie wykrywają kodowanie lub pozwalają wywołującemu na określenie kodowania.
 </simpara>
</note>'>
<!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para>Jeśli użyte zostanie <function>json_encode</function> na obiekcie <classname>DOMDocument</classname>, to wynik będzie taki, jak gdyby zakodowano pusty obiekt.</para></note>'>
<!ENTITY dom.domdocument.html5 '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Użyj <classname>Dom\HTMLDocument</classname> zamiast <classname>DOMDocument</classname>,
  aby sparsować i przetworzyć nowoczesny HTML.
 </simpara>
 <simpara>
  Ta funkcja parsuje podane wejście przy użyciu parsera HTML 4. Reguły parsowania
  HTML, których używają nowoczesne przeglądarki, są inne. Zależnie
  od podanego wejścia może to skutkować inną strukturą DOM. W związku z tym
  ta funkcja nie może być bezpiecznie użyta do oczyszczania HTML.
 </simpara>
 <simpara>
  Zachowanie podczas parsowania HTML może zależeć od użytej wersji biblioteki
  <literal>libxml</literal>, w szczególności jeśli chodzi o
  przypadki brzegowe i obsługę błędów.
  Aby skorzystać z parsowania zgodnego ze specyfikacją HTML 5,
  użyj metod <methodname>Dom\HTMLDocument::createFromString</methodname> lub
  <methodname>Dom\HTMLDocument::createFromFile</methodname> dodanych w PHP 8.4.
</simpara>
 <simpara>
  Przykładowo, niektóre elementy HTML niejawnie zamykają element rodzica
  po ich napotkaniu. Reguły dla automatycznego zamykania elementów rodzica
  różnią się między HTML 4 a HTML 5, a zatem wynikowa struktura DOM, którą
  reprezentuje <classname>DOMDocument</classname> może być inna niż struktura DOM
  widziana przez przeglądarkę, potencjalnie pozwalając atakującemu na
  popsucie wynikowego HTML.
 </simpara>
</warning>'>
<!ENTITY dom.tokenlist.errors '<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
   Rzuca <exceptionname>ValueError</exceptionname> jeśli
   token zawiera jakiekolwiek bajty null.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Rzuca <exceptionname>Dom\DOMException</exceptionname> z kodem
   <constant>Dom\SYNTAX_ERR</constant> jeśli token jest pustym stringiem.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Rzuca <exceptionname>Dom\DOMException</exceptionname> z kodem
   <constant>Dom\INVALID_CHARACTER_ERR</constant> jeśli token zawiera jakiekolwiek
   białe znaki ASCII.
  </simpara>
 </listitem>
</itemizedlist>'>

<!-- Dom Examples -->
<!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">Poniższe przykłady stosują <filename>book.xml</filename> który zawiera poniższe dane:</para>
<programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
<!-- Warning: The CDATA markup here is a little tricky. Please DO NOT BREAK it! -->
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE books [
  <!ELEMENT books   (book+)>
  <!ELEMENT book    (title, author+, xhtml:blurb?)>
  <!ELEMENT title   (#PCDATA)>
  <!ELEMENT blurb   (#PCDATA)>
  <!ELEMENT author  (#PCDATA)>
  <!ATTLIST books   xmlns        CDATA  #IMPLIED>
  <!ATTLIST books   xmlns:xhtml  CDATA  #IMPLIED>
  <!ATTLIST book    id           ID     #IMPLIED>
  <!ATTLIST author  email        CDATA  #IMPLIED>
]>
<?xml-stylesheet type="text/xsl" href="style.xsl"?>
<books xmlns="http://books.php/" xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <book id="php-basics">
    <title>PHP Basics</title>
    <author email="jim.smith@basics.php">Jim Smith</author>
    <author email="jane.smith@basics.php">Jane Smith</author>
    <xhtml:blurb><![CDATA[
<p><em>PHP Basics</em> provides an introduction to PHP.</p>
]]]]><![CDATA[></xhtml:blurb>
  </book>
  <book id="php-advanced">
    <title>PHP Advanced Programming</title>
    <author email="jon.doe@advanced.php">Jon Doe</author>
  </book>
</books>
]]></programlisting>'>

<!-- Dom entities -->
<!ENTITY dom.parameter.options '<para xmlns="http://docbook.org/ns/docbook">
  <link linkend="language.operators.bitwise">Bitowe <literal>OR</literal></link>
  dla <link linkend="libxml.constants">stałych opcji libxml</link>.
</para>'>

<!ENTITY dom.parameter.compliant.options '&dom.parameter.options;
 <simpara xmlns="http://docbook.org/ns/docbook">
  Można też przekazać <constant>Dom\HTML_NO_DEFAULT_NS</constant>,
  aby wyłączyć użycie przestrzeni nazw HTML i tagu template.
  Powinno się z tego korzystać tylko jeśli rozumie się skutki.
</simpara>'>

<!ENTITY dom.parameter.compliant.encoding '<simpara xmlns="http://docbook.org/ns/docbook">
 Kodowanie, w którym został stworzony dokument.
 Jeśli nie zostało podane, to zostanie podjęta próba określenia najbardziej prawdopodobnego kodowania.
</simpara>'>

<!ENTITY dom.parser.compliant.note.whitespace '<refsect1 role="notes" xmlns="http://docbook.org/ns/docbook">
 &reftitle.notes;
 <note>
  <simpara>
   Białe znaki w znacznikach <literal>html</literal> i <literal>head</literal>
   nie są uznawane za znaczące i mogą stracić ich formatowanie.
  </simpara>
 </note>
</refsect1>'>

<!ENTITY dom.parameters.register_node_ns '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>registerNodeNS</parameter></term>
 <listitem>
  <para>
   Określa czy prefiksy przestrzeni nazw węzłu kontekstu powinny być automatycznie zarejestrowane w obiekcie <classname>DOMXPath</classname>.
   Można z tego skorzystać aby uniknąć konieczności wywoływania <methodname>DOMXPath::registerNamespace</methodname> ręcznie dla każdej z przestrzeni nazw.
   W wypadku wystąpienia konfliktu prefiksów przestrzeni nazw, zarejestrowana zostanie tylko prefiks najbliższego potomka.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.parameters.serialize.options '<simpara xmlns="http://docbook.org/ns/docbook">
 Dodatkowe opcje.
 Opcje <constant>LIBXML_NOEMPTYTAG</constant>
 i <constant>LIBXML_NOXMLDECL</constant> są obsługiwane.
 Przed PHP 8.3.0 obsługiwana była tylko opcja
 <constant>LIBXML_NOEMPTYTAG</constant>
</simpara>'>

<!ENTITY dom.errors.hierarchy.parent '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
    Zgłaszany kiedy rodzic jest typu, który nie pozwala na dzieci
    typu przekazanego jako jeden z <parameter>nodes</parameter> lub jeśli węzeł do
    umieszczenia jest jednym z rodziców obecnego węzła, lub jest tym samym węzłem.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.hierarchy.self '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
    Zgłaszany kiedy rodzic jest typu, który nie pozwala na dzieci
    typu przekazanego jako jeden z <parameter>nodes</parameter> lub jeśli węzeł do
    umieszczenia jest tym samym węzłem.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.wrong_document '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
  <listitem>
  <para>
    Zgłaszany jeśli jeden z węzłów przekazanych jako <parameter>nodes</parameter> został utworzony w innym
    dokumencie niż tym, który utworzył ten węzeł.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.compliant.wrong_document '<listitem xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Rzuca <exceptionname>Dom\DOMException</exceptionname> z kodem
  <constant>Dom\WRONG_DOCUMENT_ERR</constant> jeśli <parameter>node</parameter>
  pochodzi z innego dokumentu.
 </simpara>
</listitem>'>

<!ENTITY dom.errors.compliant.common '<listitem xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Rzuca <exceptionname>ValueError</exceptionname> jeśli
  <parameter>options</parameter> zawiera niepoprawne opcje.
 </simpara>
</listitem>
<listitem>
 <simpara>
  Rzuca <exceptionname>ValueError</exceptionname> jeśli
  <parameter>overrideEncoding</parameter> jest nieznanym kodowaniem.
 </simpara>
</listitem>'>

<!ENTITY dom.changelog.previous_hierarchy_exception 'Poprzednio rzucany był wyjątek
 <classname xmlns="http://docbook.org/ns/docbook">DOMException</classname> z kodem
 <constant xmlns="http://docbook.org/ns/docbook">DOM_HIERARCHY_REQUEST_ERR</constant>.'>

<!ENTITY dom.c14n.xpath_array '<listitem xmlns="http://docbook.org/ns/docbook">
  <para>
   Tablica wyrażem XPath za pomocą której zostaną przefiltrowane węzły.
   Każdy z elementów tablicy jest tablicą asocjacyjną z:
   <itemizedlist>
    <listitem>
     <simpara>
      Wymaganym kluczem <literal>query</literal> zawierającym wyrażenie XPath jako ciąg znaków.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Opcjonalnym kluczem <literal>namespaces</literal> zawierającym tablicę, która mapuje prefiksy przestrzeni nazw (klucze) do URI przestrzeni nazw (wartości).
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </listitem>'>

<!-- FileSystem entities -->

<!ENTITY fs.emits.warning.on.failure '<para xmlns="http://docbook.org/ns/docbook">
 W przypadku niepowodzenia jest emitowany <constant>E_WARNING</constant>.
 </para>'>


<!ENTITY fs.validfp.all '<para xmlns="http://docbook.org/ns/docbook">Wskaźnik na plik musi być poprawny i musi
wskazywać na plik pomyślnie otwarty przez funkcję <function xmlns="http://docbook.org/ns/docbook">fopen</function>
lub <function xmlns="http://docbook.org/ns/docbook">fsockopen</function> (a jednocześnie nie zamknięty jeszcze przez
<function xmlns="http://docbook.org/ns/docbook">fclose</function>).</para>'>

<!ENTITY fs.file.pointer '<para xmlns="http://docbook.org/ns/docbook">Wskaźnik do systemu plików typu <type>resource</type>
jest zazwyczaj tworzony poprzez funkcję <function xmlns="http://docbook.org/ns/docbook">fopen</function>.</para>'>

<!ENTITY fs.file.32bit '<note xmlns="http://docbook.org/ns/docbook"><simpara>
    Ponieważ typ integer stosowany w PHP zawiera bit znaku a wiele platform stosuje 32-bitowe liczby całkowite,
    niektóre funkcje obsługi systemów plików mogą zwracać nieprzewidzane wyniki dla plików większych niż 2GB.
   </simpara></note>'>

<!ENTITY ini.scanner.typed '<para xmlns="http://docbook.org/ns/docbook">
    Od PHP 5.6.1 można też użyć <constant>INI_SCANNER_TYPED</constant>.
    W tym trybie typy boolean, null oraz integer są  zachowywane, kiedy jest to możliwe.
    Wartości tekstowe <literal>"true"</literal>, <literal>"on"</literal> oraz <literal>"yes"</literal>
    są konwertowane do &true;. <literal>"false"</literal>, <literal>"off"</literal>, <literal>"no"</literal>
    i <literal>"none"</literal> są uznawane za &false;. <literal>"null"</literal> jest konwertowane do &null;
    w tym trybie. Ponadto, jeśli jest to możliwe, wszystkie ciągi numeryczne są konwertowane do typu integer.
   </para>'>

<!-- GNUPG -->
<!ENTITY gnupg.identifier '<para xmlns="http://docbook.org/ns/docbook">Identyfikator gnupg, do wywołania funkcji
<function xmlns="http://docbook.org/ns/docbook">gnupg_init</function> lub <classname xmlns="http://docbook.org/ns/docbook">gnupg</classname>.</para>'>

<!ENTITY gnupg.fingerprint '<para xmlns="http://docbook.org/ns/docbook">Odcisk klucza.</para>'>

<!-- HaruDoc -->
<!ENTITY haru.error '<para xmlns="http://docbook.org/ns/docbook">Zgłasza wyjątek <classname xmlns="http://docbook.org/ns/docbook">HaruException</classname> gdy wystąpi błąd.</para>'>

<!-- ODBC -->
<!ENTITY odbc.connection.id '<para xmlns="http://docbook.org/ns/docbook">Obiekt połączenia ODBC.
Zobacz opis funkcji <function xmlns="http://docbook.org/ns/docbook">odbc_connect</function> aby poznać szczegóły.</para>'>

<!ENTITY odbc.result.object 'Obiekt wyniku ODBC'>

<!ENTITY odbc.result.object-return 'Zwraca obiekt wyniku ODBC '>

<!ENTITY odbc.result.object-return-falseforfailure '&odbc.result.object-return;&return.falseforfailure;.'>

<!ENTITY odbc.parameter.catalog 'Katalog (&apos;qualifier&apos; w terminologii ODBC 2).'>

<!ENTITY odbc.parameter.schema 'Schemat (&apos;owner&apos; w terminologii ODBC 2).'>

<!ENTITY odbc.parameter.search 'Ten parametr przyjmuje również następujące wzorce wyszukiwania:
<literal xmlns="http://docbook.org/ns/docbook">&#x25;</literal> - dopasowanie oznacza brak znaków lub dowolną ilość znaków,
oraz <literal xmlns="http://docbook.org/ns/docbook">_</literal> - dopasowanie oznacza jeden znak.'>

<!ENTITY odbc.result.driver-specific 'Sterowniki mogą zgłosić dodatkowe kolumny.'>

<!ENTITY odbc.changelog.connection-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  <parameter>odbc</parameter> oczekuje teraz instancji <classname>Odbc\Connection</classname>,
  wcześniej oczekiwany byl typ <type>resource</type>.
 </entry>
</row>'>

<!ENTITY odbc.changelog.connection-return '&odbc.changelog.connection-param;
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   Ta funkcja zwraca teraz instancję <classname>Odbc\Connection</classname>,
   wcześniej zwracany był typ <type>resource</type>.
  </entry>
 </row>'>

<!ENTITY odbc.changelog.credential-params '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   <parameter>user</parameter> i <parameter>password</parameter> dopuszczają teraz null,
   są teraz też opcjonalne a ich wartość domyślna to &null;.
  </entry>
 </row>
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   Wcześniej użycie pustego ciągu dla parametru <parameter>password</parameter> nie uwzględniało
   <literal>pwd</literal> w wygenerowanym ciągu połączenia dla <parameter>dsn</parameter>.
   Teraz generowany ciąg zawiera <literal>pwd</literal>, którego wartością jest pusty ciąg znaków.
   Aby przywrócić poprzednie zachowanie, parametr <parameter>password</parameter> można teraz ustawić na &null;.
  </entry>
 </row>
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   Wcześniej jeśli <parameter>dsn</parameter> zawierał <literal>uid</literal> lub <literal>pwd</literal>
   to parametry <parameter>user</parameter> i <parameter>password</parameter> były ignorowane.
   Teraz <parameter>user</parameter> jest ignorowany tylko jeśli <parameter>dsn</parameter> zawiera
   <literal>uid</literal>, a <parameter>password</parameter>  jest ignorowany tylko jeśli
   <parameter>dsn</parameter> zawiera <literal>pwd</literal>.
  </entry>
 </row>'>

<!ENTITY odbc.changelog.result-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  <parameter>statement</parameter> oczekuje teraz instancji <classname>Odbc\Result</classname>,
  wcześniej oczekiwany był typ <type>resource</type>.
 </entry>
</row>'>

<!ENTITY odbc.changelog.result-return '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Ta funkcja zwraca teraz instancję <classname>Odbc\Result</classname>,
  wcześniej zwracany był typ <type>resource</type>.
 </entry>
</row>'>

<!-- OAUTH -->
<!ENTITY oauth.callback.error 'Zgłasza błąd <constant xmlns="http://docbook.org/ns/docbook">E_ERROR</constant>
jeśli funkcja zwrotna nie może zostać wywołana, lub gdy nie jest określona.'>

<!ENTITY oauth.changelog.error.null 'Poprzednio zwrócony &null; w przypadku niepowodzenia, w miejsce &false;.'>

<!-- Oracle -->
<!ENTITY oci.db "<para xmlns='http://docbook.org/ns/docbook' xmlns:xlink='http://www.w3.org/1999/xlink'>Zawiera
<literal>instację Oracle</literal>, z którą ma połączyć. Może to być
<link xmlns='http://docbook.org/ns/docbook' xlink:href='&url.oracle.oic.connect;'>łańcuch Easy Connect
</link> lub nazwa połączenia z
pliku <filename>tnsnames.ora</filename>, lub tego pliku dla lokalnej instancji Oracle.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Jeżeli nie określono lub ustawiono na &null;, PHP użyje
zmiennych środowiskowych takich jak <constant>TWO_TASK</constant> (pod Linuksem)
lub <constant>LOCAL</constant> (pod Windowsem)
oraz <constant>ORACLE_SID</constant>, aby określić
<literal>instację Oracle</literal>, z którą ma połączyć.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
Aby użyć metody nazewnictwa Easy Connect, PHP musi być połączony z bibliotekami klienckimi Oracle
10<emphasis>g</emphasis> lub nowszymi. Łańcuch znaków Easy Connect dla Oracle
10<emphasis>g</emphasis> ma postać:
<emphasis>[//]nazwa_hosta[:port][/usługa]</emphasis>. Od Oracle
11<emphasis>g</emphasis> składnią jest:
<emphasis>[//]nazwa_hosta[:port][/usługa][:typ_serweru][/nazwa_instancji]</emphasis>.
Dodatkowe opcje zostały wprowadzone wraz z Oracle 19c, w tym obsługa timeoutu i keep-alive.
Skorzystaj z dokumentacji Oracle aby dowiedzieć się więcej. Nazwy usług można znaleźć uruchamiając narzędzie Oracle
<literal>lsnrctl status</literal> na maszynie serwera baz
danych.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
Plik <filename>tnsnames.ora</filename> może znajdować się w ścieżce wyszukiwania Oracle Net,
która zawiera <filename>/your/path/to/instantclient/network/admin</filename>, <filename>$ORACLE_HOME/network/admin</filename>
i <filename>/etc</filename>.  Alternatywnie możesz ustawić <literal>TNS_ADMIN</literal> tak,
aby <filename>$TNS_ADMIN/tnsnames.ora</filename> był odczytywany. Upewnij się, że
daemon ma prawo odczytu z tego pliku.
</para>">

<!ENTITY oci.charset "<para xmlns='http://docbook.org/ns/docbook'>Określa
zestaw znaków używany przez biblioteki Oracle Client. Zestaw znaków
nie musi być zgodny z tym używanym przez bazę danych. Jeżeli
nie jest zgodny, Oracle zrobi co w jego mocy aby skonwertować dane do i z
zestawu znaków bazy danych. Zależnie od zestawów znaków, może nie dać to
wyników nadających się do użycia. Konwersja dodaje także pewien narzut czasowy.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Jeżeli nie określono, biblioteki
Oracle Client określają zestaw znaków na podstawie
zmiennej środowiskowej <constant>NLS_LANG</constant>.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Przekazanie tego parametru
może skrócić czas potrzebny na połączenie.
</para>">

<!ENTITY oci.sessionmode '<para xmlns="http://docbook.org/ns/docbook">Ten
parametr jest dostępny od wersji PHP 5 (PECL OCI8 1.1) i przyjmuje
następujące wartości: <constant>OCI_DEFAULT</constant>,
<constant>OCI_SYSOPER</constant> oraz <constant>OCI_SYSDBA</constant>.
Jeżeli <constant>OCI_SYSOPER</constant> lub
<constant>OCI_SYSDBA</constant> zostały określone, ta funkcja spróbuje
nawiązać uprzywilejowane połączenie używając zewnętrznych danych autoryzacyjnych.
Połączenia uprzywilejowane są domyślnie wyłączone. Aby je włączyć, musisz
ustawić <link xmlns="http://docbook.org/ns/docbook" linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
na <literal xmlns="http://docbook.org/ns/docbook">On</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
PHP 5.3 (PECL OCI8 1.3.4) wprowadziło tryb
<constant>OCI_CRED_EXT</constant>. Mówi on Oracle, aby użyć
autentykacji zewnętrznej lub systemu operacyjnego, która musi być skonfigurowana w
bazie danych. Flaga <constant>OCI_CRED_EXT</constant> może być użyta tylko
z nazwą użytkownika &quot;/&quot; i pustym hasłem.
<link xmlns="http://docbook.org/ns/docbook" linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
może być ustawiony na <literal xmlns="http://docbook.org/ns/docbook">On</literal> lub <literal xmlns="http://docbook.org/ns/docbook">Off</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> może być połączony z trybami
<constant>OCI_SYSOPER</constant> lub
<constant>OCI_SYSDBA</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> nie jest wspierane na Windows, ze
względów bezpieczeństwa.
</para>'>

<!ENTITY oci.datatypes '<para xmlns="http://docbook.org/ns/docbook">Aby dowiedzieć się więcej o mapowaniu danych wykonywanym
przez rozszerzenie OCI8, zobacz <link xmlns="http://docbook.org/ns/docbook" linkend="oci8.datatypes">bazy danych
wspierane przez sterownik</link></para>'>

<!ENTITY oci.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Identyfikator połączenia Oracle,
zwrócony przez <function xmlns="http://docbook.org/ns/docbook">oci_connect</function>, <function xmlns="http://docbook.org/ns/docbook">oci_pconnect</function>,
lub <function xmlns="http://docbook.org/ns/docbook">oci_new_connect</function>.</para>'>

<!ENTITY oci.availability.note.10g '<note xmlns="http://docbook.org/ns/docbook"><title>Wymóg wersji Oracle</title>
<para xmlns="http://docbook.org/ns/docbook">Ta funkcja jest dostępna gdy PHP jest połączony z bibliotekami Oracle Database
w wersji 10<emphasis>g</emphasis> lub nowszej.</para></note>'>

<!ENTITY oci.clientinfo.tip '<tip xmlns="http://docbook.org/ns/docbook"><title>Wydajność</title><para xmlns="http://docbook.org/ns/docbook">W starszych wersjach
OCI8 lub Oracle Database, informacja kliencka może być ustawiona przy użyciu paczki
<literal xmlns="http://docbook.org/ns/docbook">DBMS_APPLICATION_INFO</literal> Oracle. Jest to mniej wydajne niż
użycie <function xmlns="http://docbook.org/ns/docbook">oci_set_client_info</function>.</para></tip>'>

<!-- //// TODO DOKOŃCZYĆ //// -->
<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook"><title>Roundtrip Gotcha</title>
<para xmlns="http://docbook.org/ns/docbook">Some but not all OCI8 functions cause roundtrips.  Roundtrips to the
database may not occur with queries when result caching is enabled.
</para></caution>'>

<!ENTITY oci.use.setprefetch '<para xmlns="http://docbook.org/ns/docbook">Przy
zapytaniach, które zwracają wiele wierszy, można znacznie poprawić
wydajność
zwiększając <link xmlns="http://docbook.org/ns/docbook" linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link>
lub używając <function xmlns="http://docbook.org/ns/docbook">oci_set_prefetch</function>.
</para>'>

<!ENTITY oci.arg.statement.id
"<para xmlns='http://docbook.org/ns/docbook'>Poprawny identyfikator wyrażenia OCI8
utworzony przez <function xmlns='http://docbook.org/ns/docbook'>oci_parse</function> i wykonany
przez <function xmlns='http://docbook.org/ns/docbook'>oci_execute</function>, albo identyfikator wyrażenia
<literal xmlns='http://docbook.org/ns/docbook'>REF CURSOR</literal>.</para>">

<!-- PCNTL Notes -->
<!ENTITY pcntl.parameter.status '<para xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">status</parameter>
jest parametrem podawanym do prawidłowego
wywołania funkcji <function xmlns="http://docbook.org/ns/docbook">pcntl_waitpid</function>.</para>'>

<!-- PS Notes -->
<!ENTITY ps.note.visible '<para xmlns="http://docbook.org/ns/docbook">Notatki nie będą widoczne ani podczas przeglądania
dokumentu, ani na wydruku. Notatki będą widoczne jeśli dokument zostanie
przekonwertowany do formatu PDF za pomocą Acrobat Distiller™ lub Ghostview.</para>'>

<!ENTITY note.open-basedir.func '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Ta funkcja podlega restrykcjom <link xmlns="http://docbook.org/ns/docbook"
linkend="ini.open-basedir">open_basedir</link>.</para></note>'>

<!ENTITY note.language-construct '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ponieważ jest to element
składni języka a nie funkcja, nie może być on wywoływany używając
<link xmlns="http://docbook.org/ns/docbook" linkend="functions.variable-functions">zmiennych funkcji</link>,
ani <link linkend="functions.named-arguments">nazwanych argumentów</link>.</simpara>
</note>'>

<!-- Common pieces in partintro-sections -->
<!ENTITY no.config '<para xmlns="http://docbook.org/ns/docbook">To rozszerzenie nie definiuje posiada żadnych
dyrektyw konfiguracyjnych w pliku &php.ini;.</para>'>
<!ENTITY no.resource '<para xmlns="http://docbook.org/ns/docbook">To rozszerzenie nie posiada żadnych rodzajów zasobów.</para>'>
<!ENTITY no.constants '<para xmlns="http://docbook.org/ns/docbook">To rozszerzenie nie posiada żadnych stałych.</para>'>
<!ENTITY no.requirement '<para xmlns="http://docbook.org/ns/docbook">Do zbudowania tego rozszerzenia nie są wymagane
żadne zewnętrzne biblioteki.</para>'>
<!ENTITY no.install '<para xmlns="http://docbook.org/ns/docbook">By używać tych funkcji, nie trzeba niczego instalować.
Są one częścią jądra PHP.</para>'>

<!-- Used in every chapter that has directive descriptions -->
<!ENTITY ini.descriptions.title '<para xmlns="http://docbook.org/ns/docbook">Oto krótkie wyjaśnienie dyrektyw
konfiguracji.</para>'>

<!-- Common pieces for reference part BEGIN-->

<!-- Used in reference/$extname/ini.xml -->
<!ENTITY extension.runtime '<simpara xmlns="http://docbook.org/ns/docbook">
Na działanie tych funkcji wpływają ustawienia zawarte w pliku
&php.ini;.</simpara>'>

<!ENTITY ini.php.constants 'Szczegóły i definicje dotyczące działania
INI_* znajdują się w rozdziale <xref xmlns="http://docbook.org/ns/docbook" linkend="configuration.changes.modes"/>.'>


<!-- Used in reference/$extname/constants.xml -->
<!ENTITY extension.constants '<simpara xmlns="http://docbook.org/ns/docbook">
Poniższe stałe są zdefiniowane w tym rozszerzeniu i stają się dostępne, gdy
rozszerzenie jest dokompilowane z PHP, lub załadowane dynamicznie przy starcie.
</simpara>'>

<!-- For STANDARD Constants used in reference/$extname/constants.xml -->
<!ENTITY extension.constants.core '<simpara xmlns="http://docbook.org/ns/docbook">
Poniższe stałe są częścią jądra PHP a więc są zawsze widoczne.
</simpara>'>

<!-- Used in reference/$extname/classes.xml -->
<!ENTITY extension.classes '<simpara xmlns="http://docbook.org/ns/docbook">
Poniższe stałe zdefiniowane są w tym rozszerzeniu, a więc będą widoczne tylko
jeśli rozszerzenie to będzie skompilowane z PHP lub załadowane dynamicznie w
trakcie pracy.
</simpara>'>

<!-- PDO entities -->
<!ENTITY pdo.driver-constants '<simpara xmlns="http://docbook.org/ns/docbook">
Poniższe stałe są definiowane przez ten sterownik, i będą dostępne tylko, gdy
to rozszerzenie będzie skompilowane z PHP lub załadowane dynamicznie przy
starcie. Dodatkowo, te specyficzne dla sterownika stałe powinny być używane
tylko przy użyciu tego konkretnego sterownika. Używanie atrybutów bazy MySQL
przy użyciu sterownika PostgreSQL może prowadzić do nieprzewidzianego zachowania.
Jeśli skrypt korzysta z wielu sterowników, do pobrania atrybutu
<constant>PDO::ATTR_DRIVER_NAME</constant>, zawierającego
nazwę sterownika, można zastosować funkcję
<function xmlns="http://docbook.org/ns/docbook">PDO::getAttribute</function>.</simpara>'>

<!ENTITY pdo.errors.exception-not-errmode '<note xmlns="http://docbook.org/ns/docbook"><simpara>Rzucany jest wyjątek, gdy atrybut <constant>PDO::ATTR_ERRMODE</constant> nie jest ustawiony na <constant>PDO::ERRMODE_EXCEPTION</constant>.</simpara></note>'>

<!-- PDO errors -->

<!ENTITY pdo.errors '<para xmlns="http://docbook.org/ns/docbook">
Emituje błąd o poziomie <constant>E_WARNING</constant>, jeśli atrybut <constant>PDO::ATTR_ERRMODE</constant> jest ustawiony
na <constant>PDO::ERRMODE_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Rzuca wyjątek <classname>PDOException</classname>, jeśli atrybut <constant>PDO::ATTR_ERRMODE</constant>
jest ustawiony na <constant>PDO::ERRMODE_EXCEPTION</constant>.
</para>'>

<!-- PECL entities -->
<!ENTITY pecl.moved 'To rozszerzenie &link.pecl; nie jest dołączane do PHP.'>

<!ENTITY pecl.bundled 'To rozszerzenie &link.pecl; jest rozprowadzane z PHP.'>

<!ENTITY pecl.info 'Informacje na temat instalacji tego rozszerzenia PECL można
znaleźć w podręczniku w rozdziale zatytułowanym
<link xmlns="http://docbook.org/ns/docbook" linkend="install.pecl">Instalacja rozszerzeń PECL</link>.
Dodatkowe informacje, takie jak nowe wersje, pliki do
pobrania, pliki źródłowe, informacje o opiekunach czy rejestr zmian, można
znaleźć tutaj: '>

<!ENTITY pecl.info.dead 'Uznaje się, że to rozszerzenie jest nieprowadzone i nieużywane. Jednakże kod źródłowy tego
rozszerzenia jest nadal dostępny w repozytorium <acronym xmlns="http://docbook.org/ns/docbook">SVN</acronym>
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>: '>

<!ENTITY pecl.info.dead.git 'Uznaje się, że to rozszerzenie jest nieprowadzone i nieużywane. Jednakże kod źródłowy tego
rozszerzenia jest nadal dostępny w repozytorium <acronym xmlns="http://docbook.org/ns/docbook">GIT</acronym>
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>: '>

<!ENTITY pecl.windows.download 'Plik <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> dla tego rozszerzenia
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> jest obecnie niedostępny. Zobacz także sekcję
<link xmlns="http://docbook.org/ns/docbook" linkend="install.windows.building">budowanie dla Windows</link>.'>

<!ENTITY pecl.windows.download.avail 'Pliki binarne dla Windows (pliki <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>)
dla tego rozszerzenia <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> są dostępne na stronie PECL.'>

<!ENTITY pecl.windows.download.unbundled '&pecl.windows.download;'>

<!ENTITY pecl.moved-ver 'To rozszerzenie zostało przeniesione do repozytorium &link.pecl;
i nie jest rozprowadzane z PHP od PHP '>

<!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>To rozszerzenie <emphasis>nie jest już utrzymywane</emphasis>.</simpara>
</warning>'>

<!-- PGSQL entities -->

<!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Instancja <classname>PgSql\Connection</classname>.</para>'>

<!ENTITY pgsql.parameter.connection-with-unspecified-default '<para xmlns="http://docbook.org/ns/docbook">Instancja <classname>PgSql\Connection</classname>.
Jeśli parametr <parameter>connection</parameter> nie został określony, to używane jest domyślne połączenie.
Domyślnym połączeniem jest ostatnie połączenie wykonane przez funkcje <function>pg_connect</function>
lub <function>pg_pconnect</function>.
<warning><simpara>Od PHP 8.1.0 użycie domyślnego połączenia jest uznane za przestarzałe.</simpara></warning></para>'>

<!ENTITY pgsql.parameter.connection-with-nullable-default '<para xmlns="http://docbook.org/ns/docbook">Instancja <classname>PgSql\Connection</classname>.
Jeśli parametr <parameter>connection</parameter> został ustawiony na &null;, to używane jest domyślne połączenie.
Domyślnym połączeniem jest ostatnie połączenie wykonane przez funkcje <function>pg_connect</function>
lub <function>pg_pconnect</function>.
<warning><simpara>Od PHP 8.1.0 użycie domyślnego połączenia jest uznane za przestarzałe.</simpara></warning></para>'>

<!ENTITY pgsql.parameter.result '<para xmlns="http://docbook.org/ns/docbook">Obiekt klasy <classname>PgSql\Result</classname> zwrócony przez <function>pg_query</function>,
<function>pg_query_params</function>, <function>pg_execute</function> i inne.</para>'>

<!ENTITY pgsql.parameter.lob '<para xmlns="http://docbook.org/ns/docbook">Obiekt klasy <classname>PgSql\Lob</classname> zwrócony przez <function>pg_lo_open</function>.</para>'>

<!ENTITY pgsql.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">
Opcjonalny parametr, który steruje tym, jak indeksowana jest zwrócona tablica.
<parameter>mode</parameter> jest stałą i może przyjąć następujące wartości:
<constant>PGSQL_ASSOC</constant>, <constant>PGSQL_NUM</constant> i <constant>PGSQL_BOTH</constant>.
Jeśli użyte jest <constant>PGSQL_NUM</constant>, funkcja zwróci tablicę z indeksami numerycznymi,
używając <constant>PGSQL_ASSOC</constant> zwróci jedynie indeksy asocjacyjne,
u używając <constant>PGSQL_BOTH</constant> zwróci zarówno indeksy numeryczne jak i asocjacyjne.</para>'>

<!ENTITY pgsql.changelog.connection-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>connection</parameter> oczekuje teraz obiektu klasy <classname>PgSql\Connection</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>result</parameter> oczekuje teraz obiektu klasy <classname>PgSql\Result</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.lob-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>lob</parameter> oczekuje teraz obiektu klasy <classname>PgSql\Lob</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Zwraca obiekt klasy <classname>PgSql\Result</classname>;
  wcześniej zwracany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!-- Common pieces for reference part END -->


<!ENTITY windows.builtin '<simpara xmlns="http://docbook.org/ns/docbook"><literal xmlns="http://docbook.org/ns/docbook">PHP</literal> w wersji dla systemów
Windows posiada wbudowaną obsługę dla tego rozszerzenia. Nie trzeba ładować
żadnych dodatkowych rozszerzeń, aby używać tych funkcji.</simpara>'>

<!-- These are here as helpers for manual consistency and brievety-->
<!ENTITY safemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.safe-mode">tryb bezpieczny</link>'>

<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">tryb bezpieczny SQL</link>'>

<!-- CTYPE Notes -->
<!ENTITY note.ctype.parameter.integer '<note xmlns="http://docbook.org/ns/docbook"><para>
Jeśli podana zostanie zmienna typu <type>int</type> o wartości z zakresu -128 i 255 włącznie, jest ona interpretowana
jako wartość ASCII dla pojedynczego znaku (do ujemnych wartości dodaje się liczbę 256 aby przejść do zakresu wartości
występujących w rozszerzonej tablicy ASCII). Każda inna zmienna całkowita jest interpretowana jako ciąg znakowy zwierający
cyfry dziesiętne liczby całkowitej.</para></note>'>

<!ENTITY note.ctype.parameter.non-string '<warning xmlns="http://docbook.org/ns/docbook"><para>
Od PHP 8.1.0 przekazanie argumentu inny niż ciąg znaków jest przestarzałe.
W przyszłości ten argument będzie interpretowany jako ciąg znaków a nie codepoint ASCII.
W zależności od oczekiwanego zachowania, ten argument powinien być albo zrzutowany na typ &string;
lub powinno się użyć jawnego wywołania <function>chr</function>.</para></warning>'>

<!ENTITY ctype.result.empty-string 'Gdy wywołana z pustym ciągiem znaków, wynikiem zawsze będzie &false;.'>

<!-- FTP Notes -->
<!ENTITY ftp.changelog.ftp-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Parametr <parameter>ftp</parameter> oczekuje obiektu klasy <classname>FTP\Connection</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>
<!ENTITY ftp.parameter.ftp '<para xmlns="http://docbook.org/ns/docbook">Obiekt klasy <classname>FTP\Connection</classname>.</para>'>

<!-- GMP Notes -->
<!ENTITY gmp.return 'Obiekt klasy <classname xmlns="http://docbook.org/ns/docbook">GMP</classname>.'>
<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">
 Obiekt klasy <classname>GMP</classname> liczba całkowita (&integer;)
 lub ciąg znaków, który może być zinterpretowany jako liczba (wedle tej samej logiki
 jak ciąg znaków przekazany do <function>gmp_init</function> z automatycznym
 wykrywaniem podstawy, tj. gdy parametr <parameter>base</parameter> jest ustawiony na 0).
</para>'>

<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><para>Tylko styl proceduralny: Obiekt klasy <classname>mysqli_result</classname>
zwrócony przez <function>mysqli_query</function>, <function>mysqli_store_result</function>,
<function>mysqli_use_result</function> lub <function>mysqli_stmt_get_result</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.link.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>mysql</parameter></term><listitem><para>Tylko styl proceduralny: Obiekt klasy <classname>mysqli</classname>
zwrócony przez <function>mysqli_connect</function> lub <function xmlns="http://docbook.org/ns/docbook">mysqli_init</function>
</para></listitem></varlistentry>'>
<!ENTITY mysqli.stmt.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
stmt</parameter></term><listitem><para>Tylko styl proceduralny: Obiekt klasy <classname>mysqli_stmt</classname>
zwrócony przez <function>mysqli_stmt_init</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.available.mysqlnd 'Dostępna tylko z <link xmlns="http://docbook.org/ns/docbook"
linkend="book.mysqlnd">mysqlnd</link>.'>
<!ENTITY mysqli.charset.note '<note xmlns="http://docbook.org/ns/docbook">
<para>MySQLnd zawsze przyjmuje domyślne kodowanie znaków serwera. To kodowanie jest przesyłane podczas połączenia
hand-shake/authentication, którego używa mysqlnd.</para><para>Libmysql używa domyślnego kodowania znaków ustawionego w pliku
<filename>my.cnf</filename> lub przez jawne wywołanie funkcji <function>mysqli_options</function> przed
wywołaniem <function>mysqli_real_connect</function>, ale po wywołaniu <function>mysqli_init</function>.</para></note>'>
<!ENTITY mysqli.integer.overflow.as.string.note '<note xmlns="http://docbook.org/ns/docbook">
<para>Jeśli liczba wierszy jest większa niż <constant>PHP_INT_MAX</constant>,
to liczba zostanie zwrócona jako &string;.</para></note>'>
<!ENTITY mysqli.sqlinjection.warning '<warning xmlns="http://docbook.org/ns/docbook">
<title>Ostrzeżenie bezpieczeństwa: SQL injection</title><para>Jeżeli zapytanie zawiera jakiekolwiek zmienne
wejście, to powinno się używać <link linkend="mysqli.quickstart.prepared-statements">parametryzowanych
zapytań przygotowanych (prepared statements)</link>. Alternatywnie,
dane muszą zostać poprawnie sformatowane i wszystkie ciągi znaków muszą zostać przepuszczone
przez funkcję
<function>mysqli_real_escape_string</function>.</para></warning>'>
<!ENTITY mysqli.conditionalexception '<para xmlns="http://docbook.org/ns/docbook">
Jeśli włączone jest raportowanie błędów mysqli (<constant>MYSQLI_REPORT_ERROR</constant>) i żądana operacja nie powiedzie się,
generowane jest ostrzeżenie. Jeśli dodatkowo tryb jest ustawiony na <constant>MYSQLI_REPORT_STRICT</constant>,
to zamiast tego rzucany jest wyjątek <classname>mysqli_sql_exception</classname>.</para>'>

<!-- Notes for PCRE -->
<!ENTITY pcre.pattern.warning '<para xmlns="http://docbook.org/ns/docbook">
Jeśli wzorzec wyrażenia regularnego nie kompiluje się do poprawnego wyrażenia regularnego, emitowany jest <constant>E_WARNING</constant>.
</para>'>

<!-- Notes for SAPI/Apache -->
<!ENTITY apache.req.module '<simpara xmlns="http://docbook.org/ns/docbook">Funkcja ta jest dostępna tylko jeśli PHP
jest zainstalowane jako moduł serwera Apache.
</simpara>'>

<!-- Notes for SAPI/FPM -->
<!ENTITY fpm.intro '<para xmlns="http://docbook.org/ns/docbook">FPM (FastCGI Process Manager) jest
główną implementacją FastCGI dla PHP zawierającą pewne opcje przydatne (głównie) dla stron pracujących pod dużym obciążeniem.
</para>'>

<!-- SimpleXML Notes -->
<!ENTITY simplexml.iteration '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">W SimpleXML wprowadzono zasadę
dodawania pól iteracyjnych dla większości metod. Nie mogą być one przeglądane
przez <function xmlns="http://docbook.org/ns/docbook">var_dump</function> ani przez nic innego co bada obiekty.
</simpara></note>'>

<!-- SQLite Notes -->
<!ENTITY sqlite.case-fold '<para xmlns="http://docbook.org/ns/docbook">Wielkość liter w nazwach kolumn zwróconych przez
<constant>SQLITE_ASSOC</constant> i <constant>SQLITE_BOTH</constant> zostaną
przetworzone zależnie od ustawienia opcji konfiguracji
<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link>.</para>'>

<!ENTITY sqlite.decode-bin '<para xmlns="http://docbook.org/ns/docbook">Gdy parametr <parameter xmlns="http://docbook.org/ns/docbook">decode_binary</parameter>
zostanie ustawiony na &true; (domyślnie), PHP zdekoduje kodowanie binarne,
któremu zostały poddane dane, jeśli były kodowane przy użyciu funkcji
<function xmlns="http://docbook.org/ns/docbook">sqlite_escape_string</function>. Zazwyczaj należy pozostawić domyślną
wartość tego parametru, chyba że baza jest współużytkowana przez różne
aplikacje.</para>'>

<!ENTITY sqlite.no-unbuffered '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Ta funkcja nie może być używana z
niebuforowanymi wynikami.</para></note>'>

<!ENTITY sqlite.param-compat '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Obsługiwane są dwie alternatywne
składnie, dla zachowania kompatybilności z rozszerzeniami dla innych baz danych
(takich jak MySQL). Preferowana jest pierwsza, gdzie
<parameter xmlns="http://docbook.org/ns/docbook">dbhandle</parameter> jest pierwszym parametrem
funkcji.</simpara></note>'>

<!ENTITY sqlite.result-type '<para xmlns="http://docbook.org/ns/docbook">Opcjonalny parametr <parameter xmlns="http://docbook.org/ns/docbook">result_type</parameter>
przyjmuje wartości stałych i określa jak indeksowane będą zwracane wartości.
Używając <constant>SQLITE_ASSOC</constant> zwrócone zostaną tylko indeksy
asocjacyjne (nazwy pól), podczas gdy <constant>SQLITE_NUM</constant> zwróci
tylko indeksy numeryczne (numery pól). <constant>SQLITE_BOTH</constant> zwróci
i indeksy asocjacyjne i numeryczne.  <constant>SQLITE_BOTH</constant> jest
domyślną wartością dla tej funkcji.</para>'>

<!-- Database Notes -->
<!ENTITY database.field-case '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Nazwy pól zwracane przez tą
funkcję <emphasis xmlns="http://docbook.org/ns/docbook">rozróżniają wielkość znaków</emphasis>.</simpara></note>'>

<!ENTITY database.fetch-null '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja ustala wartość pól NULL
na &null;.</simpara></note>'>

<!-- MySQL Notes -->
<!-- The mysql.*.description entities are used in the parameters refsect1 -->
<!ENTITY mysql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>Połączenie MySQL.
Jeśli identyfikator połączenia nie zostanie podany, użyte zostanie ostatnie
połączenie otwarte przez <function>mysql_connect</function>. Jeśli połączenie
takie nie zostanie znalezione, funkcja spróbuje nawiązać połączenie tak, jakby
wywołana została funkcja <function>mysql_connect</function> bez argumentów.
Jeśli żadne połączenie nie zostanie znalezione lub nawiązane, wygenerowany
zostanie błąd poziomu <constant>E_WARNING</constant>.</para></listitem>
</varlistentry>'>

<!ENTITY mysql.linkid-noreopen.description '<varlistentry
xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>Połączenie MySQL. Jeśli identyfikator połączenia nie zostanie
podany, użyte zostanie ostatnie połączenie otwarte za pomocą funkcji
<function>mysql_connect</function>. Jeśli nie znalezione zostanie żadne połączenie, wygenerowany zostanie błąd
poziomu <constant>E_WARNING</constant>.</para></listitem></varlistentry>'>

<!ENTITY mysql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><para>Wynik w postaci zmiennej typu
<type>resource</type>, które jest przetwarzane. Wynik ten pochodzi z wywołania
funkcji <function>mysql_query</function>.</para></listitem></varlistentry>'>

<!ENTITY mysql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>field_offset</parameter></term><listitem><para>Liczbowe przesunięcie pola.
<parameter>przesunięcie_pola</parameter> zaczyna się od wartości
<literal>0</literal>. Jeśli
<parameter>przesunięcie_pola</parameter> nie istnieje, wygenerowane zostanie
ostrzeżenie poziomu
<constant>E_WARNING</constant>.</para></listitem></varlistentry>'>

<!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">To rozszerzenie zostało uznane za przestarzałe w PHP 5.5.0 i usunięte w PHP 7.0.0.
Zamiast niego należy stosować rozszerzenia <link linkend="book.mysqli">MySQLi</link> lub <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Zobacz też przewodnik <link linkend="mysqlinfo.api.choosing">MySQL: wybieranie API</link>.
Alternatywy dla tej funkcji to między innymi:</para>'>

<!ENTITY mysql.alternative.note.4-3-0 '<para xmlns="http://docbook.org/ns/docbook">Ta funkcja została uznana za przestarzałą w PHP 4.3.0 i usunięta,
wraz z całym <link linkend="book.mysql">oryginalnym rozszerzeniem MySQL</link>, w PHP 7.0.0.
W zamian użyj aktywnie rozwijanych rozszerzeń <link linkend="book.mysqli">MySQLi</link> lub <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Zobacz też przewodnik <link linkend="mysqlinfo.api.choosing">MySQL: wybieranie API</link>.
Alternatywy dla tej funkcji to między innymi:</para>'>

<!ENTITY mysql.alternative.note.5-3-0 '<para xmlns="http://docbook.org/ns/docbook">Ta funkcja została uznana za przestarzałą w PHP 5.3.0 i usunięta,
wraz z całym <link linkend="book.mysql">oryginalnym rozszerzeniem MySQL</link>, w PHP 7.0.0.
W zamian użyj aktywnie rozwijanych rozszerzeń <link linkend="book.mysqli">MySQLi</link> lub <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Zobacz też przewodnik <link linkend="mysqlinfo.api.choosing">MySQL: wybieranie API</link>.
Alternatywy dla tej funkcji to między innymi:</para>'>

<!ENTITY mysql.alternative.note.5-4-0 '<para xmlns="http://docbook.org/ns/docbook">Ta funkcja została uznana za przestarzałą w PHP 5.4.0 i usunięta,
wraz z całym <link linkend="book.mysql">oryginalnym rozszerzeniem MySQL</link>, w PHP 7.0.0.
W zamian użyj aktywnie rozwijanych rozszerzeń <link linkend="book.mysqli">MySQLi</link> lub <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Zobacz też przewodnik <link linkend="mysqlinfo.api.choosing">MySQL: wybieranie API</link>.
Alternatywy dla tej funkcji to między innymi:</para>'>

<!ENTITY mysql.alternative.note.5-5-0 '<para xmlns="http://docbook.org/ns/docbook">Ta funkcja została uznana za przestarzałą w PHP 5.5.0 i usunięta,
wraz z całym <link linkend="book.mysql">oryginalnym rozszerzeniem MySQL</link>, w PHP 7.0.0.
W zamian użyj aktywnie rozwijanych rozszerzeń <link linkend="book.mysqli">MySQLi</link> lub <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Zobacz też przewodnik <link linkend="mysqlinfo.api.choosing">MySQL: wybieranie API</link>.
Alternatywy dla tej funkcji to między innymi:</para>'>

<!ENTITY mysql.close.connections.result.sets '<para xmlns="http://docbook.org/ns/docbook">
Otwarte nietrwałe połącznie z MySQL i zbiory wyników są automatycznie niszczone, gdy skrypt
PHP kończy swoje wykonywanie. Tak więc, mimo iż samodzielne zamykanie
połączeń i zwalnianie zasobów wyników nie jest obowiązkowe, jest to zalecane.
Pozwala natychmiastowo zwrócić zasoby dla PHP i MySQL, co może
poprawić wydajność. Aby uzyskać więcej informacji, przeczytaj o
<link linkend="language.types.resource.self-destruct">zwalnianiu zasobów</link></para>'>

<!-- Xattr entities -->
<!ENTITY xattr.namespace '<para xmlns="http://docbook.org/ns/docbook">Rozszerzone atrybuty mają dwie różne
przestrzenie nazw: przestrzeń użytkownika i roota. Przestrzeń
użytkownika dostępna jest dla wszystkich użytkowników, podczas gdy przestrzeń
roota dostępna jest tylko dla użytkownika z uprawnieniami superużytkownika.
xattr domyślne działa w przestrzeni użytkownika, ale można to zmienić używając
argumentu <parameter xmlns="http://docbook.org/ns/docbook">flags</parameter>.</para>'>

<!-- Notes for IPv6 -->
<!ENTITY ipv6.brackets '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Podając numerycznie adres IPv6
(np. fe80::1), adres musi być objęty nawiasami kwadratowymi. Na przykład
<literal xmlns="http://docbook.org/ns/docbook">tcp://[fe80::1]:80</literal>.</simpara></note>'>

<!-- Notes for tidy -->
<!ENTITY tidy.object 'Obiekt <classname xmlns="http://docbook.org/ns/docbook">Tidy</classname>.'>

<!ENTITY tidy.conf-enc '<para xmlns="http://docbook.org/ns/docbook">Parametr <parameter xmlns="http://docbook.org/ns/docbook">config</parameter> może być
przekazany jako tablica lub ciąg znaków. Jeśli zostanie przekazany jako ciąg
znaków, będzie on interpretowany jako nazwa pliku konfiguracyjnego. W
przeciwnym przypadku będzie interpretowany jako zbiór opcji. Pod adresem
<link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.tidy.conf;">&url.tidy.conf;</link>
można znaleźć objaśnienia każdej opcji.</para><para xmlns="http://docbook.org/ns/docbook">Parametr
<parameter xmlns="http://docbook.org/ns/docbook">encoding</parameter> określa kodowanie dokumentów wejściowych/wyjściowych.
Dozwolone wartości dla <parameter xmlns="http://docbook.org/ns/docbook">encoding</parameter> to:
<literal xmlns="http://docbook.org/ns/docbook">ascii</literal>, <literal xmlns="http://docbook.org/ns/docbook">latin0</literal>, <literal xmlns="http://docbook.org/ns/docbook">latin1</literal>,
<literal xmlns="http://docbook.org/ns/docbook">raw</literal>, <literal xmlns="http://docbook.org/ns/docbook">utf8</literal>, <literal xmlns="http://docbook.org/ns/docbook">iso2022</literal>,
<literal xmlns="http://docbook.org/ns/docbook">mac</literal>, <literal xmlns="http://docbook.org/ns/docbook">win1252</literal>, <literal xmlns="http://docbook.org/ns/docbook">ibm858</literal>,
<literal xmlns="http://docbook.org/ns/docbook">utf16</literal>, <literal xmlns="http://docbook.org/ns/docbook">utf16le</literal>,
<literal xmlns="http://docbook.org/ns/docbook">utf16be</literal>, <literal xmlns="http://docbook.org/ns/docbook">big5</literal> i
<literal xmlns="http://docbook.org/ns/docbook">shiftjis</literal>.</para>'>

<!-- Snippets for the installation section -->
<!ENTITY warn.apache2.compat '<warning xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Nie zalecamy korzystania z
wątkowanego MPM na produkcyjnych serwerach Apache2. Zamiast niego wskazane jest
używanie preforkowanego MPM, który jest domyślny w Apache 2.0 i Apache 2.2.
Wyjaśnienie powodów można znaleźć w odpowiednim punkcie FAQ, dotyczącym używania
<link xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.apache2">Apache2 z wątkowanym
MPM</link></para></warning>'>
<!ENTITY warn.install.third-party-support '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <para>
  Kompilacje (buildy) od osób trzecich są uznawane za nieoficjalne i nie są bezpośrednio
  wspierane przez projekt PHP. Jakiekolwiek napotkane błędy powinny być zgłaszane do
  dostawcy tych nieoficjalnych kompilacji, chyba że można je zreprodukować używając
  kompilacji z <link xlink:href="&url.php.downloads;">oficjalnej
  sekcji pobierania</link>.
 </para>
</warning>'>

<!ENTITY note.apache.slashes '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Nalezy pamiętać, że podając
ścieżki w plikach konfiguracyjnych Apache w systemie Windows, wszystkie znaki
backslash takie jak na przykład w ścieżce
<filename xmlns="http://docbook.org/ns/docbook">c:\directory\file.ext</filename> powinny być zamienione na znaki slash,
na przykład <filename xmlns="http://docbook.org/ns/docbook">c:/directory/file.ext</filename>. Zamykające znaki slash
mogą być także niezbędne dla katalogów.</simpara></note>'>

<!-- Snippets and titles for the contributors section -->
<!ENTITY Credit.Authors.and.Contributors 'Autorzy i współpracownicy'>

<!ENTITY Credit.Introduction '<para xmlns="http://docbook.org/ns/docbook">Istnieje duża grupa współpracowników, którzy
pomagają w pracach, lub włożyli w przeszłości wiele pracy przy tym projekcie.
Jest też wielu niewymienionych tutaj ludzi, którzy wnieśli wkład w rozwój tego
podręcznika licznymi komentarzami. Cały czas te uwagi są one uwzględniane
w odnośnikach, i za nie serdecznie dziękujemy. Wszystkie poniższe listy
uporządkowane są w kolejności alfabetycznej.</para>'>

<!ENTITY Credit.Authors.and.Editors 'Autorzy i edytorzy'>

<!ENTITY Credit.Past.Authors.Text 'Poniżsi współpracownicy powinni zostać
wyróżnieni za wpływ jaki mieli (lub ciągle mają) w rozwój podręcznika:'>

<!ENTITY Credit.Past.Editors.Text 'Poniżsi współpracownicy włożyli wiele pracy
przy edycji podręcznika:'>

<!ENTITY Credit.Note.Editors.Title 'Opiekunowie notatek'>

<!ENTITY Credit.Note.Editors.Active 'Aktualnie najbardziej aktywni opiekunowie to:'>

<!ENTITY Credit.Note.Editors.Inactive 'Te osoby także pracowały nad
zarządzaniem notatkami:'>

<!ENTITY listendand ' i'>

<!-- runkit entities -->
<!ENTITY note.runkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Ta funkcja nie może być
użyta do manipulacji aktualnie działającej (lub powiązanej) metody.</simpara>
</note>'>

<!ENTITY note.runkit.internal-override '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Domyślnie, tylko funkcje
przestrzeni użytkownika mogą być usunięte, przemianowane lub zmodyfikowane. Aby
uzyskać możliwość modyfikacji funkcji wewnętrznych, należy włączyć opcję
<literal xmlns="http://docbook.org/ns/docbook">runkit.internal_override</literal> w pliku &php.ini;.</simpara></note>'>

<!-- SSH2 Extension -->
<!ENTITY note.ssh2.subsystem.publickey '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">
Podsystem klucza publicznego używany jest do zarządzania kluczami publicznymi
na serwerze, do którego klient <emphasis xmlns="http://docbook.org/ns/docbook">już jest</emphasis> autoryzowany.
Aby autoryzować się do zdalnego systemu używając autoryzacji klucza publicznego,
należy skorzystać z funkcji <function xmlns="http://docbook.org/ns/docbook">ssh2_auth_pubkey_file</function>.
</simpara></note>'>

<!-- Session notes -->
<!ENTITY returns.session.storage.retval 'Zwracana wartość (zazwyczaj &true; w przypadku sukcesu, &false; dla porażki). Wartość ta jest zwracana wewnętrznie do PHP w celu jej przetworzenia.'>

<!-- XMLWriter Notes -->
<!ENTITY xmlwriter.xmlwriter.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>writer</parameter></term><listitem><para>Jedynie dla wywołań proceduralnych.
<link linkend="language.types.resource">Zasób</link> XMLWriter, który jest modyfikowany. Ten zasób pochodzi, z wywołania funkcji <function>xmlwriter_open_uri</function> lub <function>xmlwriter_open_memory</function>.</para></listitem></varlistentry>'>

<!ENTITY xmlwriter.changelog.writer-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>writer</parameter> oczekuje teraz obiektu klasy <classname>XMLWriter</classname>;
  wcześniej oczekiwany był <link linkend="language.types.resource">zasób</link>.
 </entry>
</row>'>

<!-- SOAP notes -->
<!ENTITY soap.wsdl.mode.only "<note xmlns='http://docbook.org/ns/docbook'><para xmlns='http://docbook.org/ns/docbook'>Ta funkcja działa tylko w trybie WSDL.</para></note>">

<!-- Stomp notes -->
<!ENTITY stomp.param.link "<varlistentry xmlns='http://docbook.org/ns/docbook'><term xmlns='http://docbook.org/ns/docbook'><parameter xmlns='http://docbook.org/ns/docbook'>link</parameter></term><listitem xmlns='http://docbook.org/ns/docbook'><para xmlns='http://docbook.org/ns/docbook'>Tylko styl proceduralny: identyfikator połączenia stomp zwracany przez <function xmlns='http://docbook.org/ns/docbook'>stomp_connect</function>.</para></listitem></varlistentry>">
<!ENTITY stomp.param.headers "<varlistentry xmlns='http://docbook.org/ns/docbook'><term xmlns='http://docbook.org/ns/docbook'><parameter xmlns='http://docbook.org/ns/docbook'>headers</parameter></term><listitem xmlns='http://docbook.org/ns/docbook'><para xmlns='http://docbook.org/ns/docbook'>Tablica wielowymiarowa zawierająca dodatkowe nagłówki (na przykład: receipt).</para></listitem></varlistentry>">
<!ENTITY stomp.note.transaction "<note xmlns='http://docbook.org/ns/docbook'><para xmlns='http://docbook.org/ns/docbook'>Można określić nagłówek transakcji, wskazując, że potwierdzenie odbioru powinno być częścią nazwanej transakcji.</para></note>">
<!ENTITY stomp.note.sync "<tip xmlns='http://docbook.org/ns/docbook'><simpara xmlns='http://docbook.org/ns/docbook'>Stomp jest z natury asynchroniczny. Komunikacja synchroniczna może być uzyskana przez dodanie nagłówka receipt (otrzymanie). Spowoduje to, że metody nie będą niczego zwracać, dopóki serwer nie potwierdzi otrzymania wiadomości lub dopóki nie zostanie osiągnięty limit czasowy odczytu.</simpara></tip>">

<!-- SVN notes -->
<!ENTITY svn.relativepath "<note xmlns='http://docbook.org/ns/docbook'><simpara xmlns='http://docbook.org/ns/docbook'>Względne ścieżki zostaną rozwiązane, jeśli bieżący katalog roboczy jest jednym z zawierających binaria PHP. Aby odwołać się do skryptu roboczego katalogu, użyj <function xmlns='http://docbook.org/ns/docbook'>realpath</function> lub dirname(__FILE__).</simpara></note>">
<!ENTITY svn.referto.status 'Odwołaj się do <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.status">stałych statusu</link> po możliwe wartości.'>
<!ENTITY svn.referto.type 'Odwołaj się do <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.type">stałych typów</link> po możliwe wartości.'>

<!-- FANN notes -->
<!ENTITY fann.ann.description '<para xmlns="http://docbook.org/ns/docbook"><link linkend="language.types.resource">Zasób</link> sieci neuronowej.</para>'>
<!ENTITY fann.train.description '<para xmlns="http://docbook.org/ns/docbook"><link linkend="language.types.resource">Zasób</link> danych treningowych sieci neuronowej..</para>'>
<!ENTITY fann.errdat.description '<para xmlns="http://docbook.org/ns/docbook"><link linkend="language.types.resource">Zasób</link> sieci neuronowej lub danych treningowych sieci neuronowej.</para>'>
<!ENTITY fann.return.void '<para xmlns="http://docbook.org/ns/docbook">Nie jest zwracana żadna wartość.</para>'>
<!ENTITY fann.return.bool '<para xmlns="http://docbook.org/ns/docbook">Zwraca &true; przy powodzeniu, &false; w przeciwnym wypadku.</para>'>
<!ENTITY fann.return.ann '<para xmlns="http://docbook.org/ns/docbook"> Zwraca zasób sieci neuronowej przy powodzeniu, &false; w wypadku błędu.</para>'>
<!ENTITY fann.return.train '<para xmlns="http://docbook.org/ns/docbook"> Zwraca zasób danych treningowych przy powodzeniu, &false; w wypadku błędu.</para>'>
<!ENTITY fann.note.function.fann-2.2 '<note xmlns="http://docbook.org/ns/docbook"><para>Ta funkcja jest dostępna tylko jeśli rozszerzenie fann zostało skompilowane z libfann &gt;= 2.2.</para></note>'>

<!-- Imagick generic return types -->
<!ENTITY imagick.return.success 'Zwraca &true; w przypadku sukcesu.'>
<!ENTITY imagick.imagick.throws 'Zgłasza wyjątek ImagickException w przypadku błędu.'>
<!ENTITY imagick.imagickdraw.throws 'Zgłasza wyjątek ImagickDrawException w przypadku błędu.'>
<!ENTITY imagick.imagickpixel.throws 'Zgłasza wyjątek ImagickPixelException w przypadku błędu.'>
<!ENTITY imagick.imagickpixeliterator.throws 'Zgłasza wyjątek ImagickPixelIteratorException w przypadku błędu.'>

<!-- Imagick version infos -->
<!ENTITY imagick.method.available.0x629 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.2.9 lub nowszej.'>
<!ENTITY imagick.method.available.0x631 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.3.1 lub nowszej.'>
<!ENTITY imagick.method.available.0x632 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.3.2 lub nowszej.'>
<!ENTITY imagick.method.available.0x636 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.3.6 lub nowszej.'>
<!ENTITY imagick.method.available.0x637 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.3.7 lub nowszej.'>
<!ENTITY imagick.method.available.0x638 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.3.8 lub nowszej.'>
<!ENTITY imagick.method.available.0x639 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.3.9 lub nowszej.'>
<!ENTITY imagick.method.available.0x640 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.4.0 lub nowszej.'>
<!ENTITY imagick.method.available.0x641 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.4.1 lub nowszej.'>
<!ENTITY imagick.method.available.0x642 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.4.2 lub nowszej.'>
<!ENTITY imagick.method.available.0x643 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.4.3 lub nowszej.'>
<!ENTITY imagick.method.available.0x644 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.4.4 lub nowszej.'>
<!ENTITY imagick.method.available.0x645 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.4.5 lub nowszej.'>
<!ENTITY imagick.method.available.0x647 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.4.7 lub nowszej.'>
<!ENTITY imagick.method.available.0x649 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.4.9 lub nowszej.'>
<!ENTITY imagick.method.available.0x653 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.5.3 lub nowszej.'>
<!ENTITY imagick.method.available.0x657 'Ta metoda jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji 6.5.7 lub nowszej.'>

<!ENTITY imagick.constant.available 'Ta stała jest dostępna, jeśli rozszerzenie Imagick zostało skompilowane z ImageMagick w wersji'>

<!-- Imagick default channel information -->
<!ENTITY imagick.default.channel.info 'Domyślnie: <constant xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant>. Zapoznaj się z listą <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">stałych kanałów</link>'>

<!-- Fuzz parameter -->
<!ENTITY imagick.parameter.fuzz 'Ilość puchu. Przykładowo, ustaw puch na 10, a kolor czerwony o intensywności 100 i 102, będzie rozpoznawany jako ten sam kolor.'>

<!-- Channel parameter -->
<!ENTITY imagick.parameter.channel 'Dostarcz stałą kanału, która jest poprawna dla Twojego trybu kanału. Aby zastosować więcej niż jeden kanał, połącz <link xmlns="http://docbook.org/ns/docbook"  linkend="imagick.constants.channel">stałe kanału</link> przy użyciu operatorów bitowych. &imagick.default.channel.info;'>

<!-- Alpha parameter -->
<!ENTITY imagick.parameter.alpha 'Poziom przezroczystości: 1.0 - w pełni nieprzezroczysty, 0.0 - w pełni przezroczysty.'>

<!ENTITY imagick.imagickexception.throw 'Zgłasza wyjątek
<classname xmlns="http://docbook.org/ns/docbook">ImagickException</classname> gdy wystąpi błąd.'>

<!ENTITY imagick.bestfit.note '<note xmlns="http://docbook.org/ns/docbook">
 <simpara xmlns="http://docbook.org/ns/docbook">
  Zachowanie parametru <parameter xmlns="http://docbook.org/ns/docbook">bestfit</parameter> zostało zmienione w wersji Imagick 3.0.0.
  Przed tą wersją podane wymiary 400x400 obrazka o wymiarach 200x150 pozostały by
  nietknięte. W Imagick 3.0.0 i późniejszych, obrazek zostałby przeskalowany do rozmiaru 400x300, ponieważ
  pasuje on najlepiej do podanych wymiarów. Jeżeli użyto parametru <parameter xmlns="http://docbook.org/ns/docbook">bestfit</parameter>,
  trzeba określić zarówno wysokość i szerokość.
 </simpara>
</note>'>

<!ENTITY note.openssl.cnf '<note xmlns="http://docbook.org/ns/docbook">
 <simpara xmlns="http://docbook.org/ns/docbook">
  Aby ta funkcja prawidłowo działała wymaga poprawnie zainstalowanego
  <filename xmlns="http://docbook.org/ns/docbook">openssl.cnf</filename>.  Aby uzyskać więcej informacji przeczytaj
  rozdział <link xmlns="http://docbook.org/ns/docbook" linkend="openssl.installation">instalacja openssl</link>.
 </simpara>
</note>'>
<!ENTITY note.openssl.param-notext '<para xmlns="http://docbook.org/ns/docbook">
 Opcjonalny parametr <parameter xmlns="http://docbook.org/ns/docbook">notext</parameter> wpływa na szczegółowość
 komunikatów wyjścia. Jeśli wynosi &false;, wówczas do wyjścia dołączane są
 dodatkowe informacje zrozumiałe dla ludzi. Wartość domyślna parametru
 <parameter xmlns="http://docbook.org/ns/docbook">notext</parameter> wynosi: &true;.
</para>'>

<!-- COM/Dotnet -->
<!ENTITY com.variant-arith '<note xmlns="http://docbook.org/ns/docbook">
<para xmlns="http://docbook.org/ns/docbook">
 Wszystkie arytmetyczne funkcje wariantowe przyjmują jako parametry albo rdzenne
 typy PHP (integer, string, floating point, boolean lub &null;), albo instancje
 klas COM, VARINAT lub DOTNET.  Rdzenne typy PHP są konwertowane do wariantowych
 przy użyciu tych samych reguł, które znajdują się w klasie konstruktora
 <xref xmlns="http://docbook.org/ns/docbook" linkend="class.variant"/>.  Obiekty COM i DOTNET powinny mieć wartości
 swoich domyślnych właściwości pobierane i używane jako wartości wariantowe.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Arytmetyczne funkcje wariantowe są nakładkami na podobnie nazwane funkcje
 w bibliotece COM; aby uzyskac więcej informacji o tych funkcjach odwiedź
 witrynę biblioteki MSDN.  Funkcje PHP są nazwane nieco inaczej. Na przykład
 funkcji <function xmlns="http://docbook.org/ns/docbook">variant_add</function> w PHP odpowiada <literal xmlns="http://docbook.org/ns/docbook">VarAdd()
 </literal> w dokumentacji MSDN.
</para>
</note>
'>

<!-- phar -->
<!ENTITY phar.write '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Ta
metoda wymaga ustawienia w &php.ini; wartości <literal xmlns="http://docbook.org/ns/docbook">phar.readonly</literal>
na <literal xmlns="http://docbook.org/ns/docbook">0</literal> aby działała z obiektami <classname xmlns="http://docbook.org/ns/docbook">Phar</classname>.
W przeciwnym przypadku, klasa <classname xmlns="http://docbook.org/ns/docbook">PharException</classname> zwróci wyjątek
.</para></note>'>

<!ENTITY phar.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>Phar::addFile</function>, <function>Phar::addFromString</function> and <function>Phar::offsetSet</function>
  zapisują nowe archiwum phar przy każdym ich wywołaniu. Jeśli wydajność budzi niepokój,
  możesz zamiast tego użyć <function>Phar::buildFromDirectory</function>
  lub <function>Phar::buildFromIterator</function>.
 </simpara>
</note>'>

<!ENTITY phardata.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>PharData::addFile</function>, <function>PharData::addFromString</function> and <function>PharData::offsetSet</function>
  zapisują nowe archiwum phar przy każdym ich wywołaniu. Jeśli wydajność budzi niepokój,
  możesz zamiast tego użyć  <function>PharData::buildFromDirectory</function>
  lub <function>PharData::buildFromIterator</function>.
 </simpara>
</note>'>

<!-- XML -->
<!ENTITY libxml.required '<para xmlns="http://docbook.org/ns/docbook">
 To rozszerzenie wymaga rozszerzenia PHP <link linkend="book.libxml">libxml</link>.
 To oznacza, że należy podać dyrektywę konfiguracyjną <option role="configure">--with-libxml</option>
 lub <option role="configure">--enable-libxml</option> przed PHP 7.4
 podczas kompilacji, pomimo tego, że zasadniczo jest to już spełnione, ponieważ libxml
 jest domyślnie włączone.
</para>'>

<!-- XMLReader -->
<!ENTITY xmlreader.libxml20620.note '<caution xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Ta funkcja jest dostępna tylko wtedy,
gdy PHP zostało skompilowane z biblioteką libxml 20620 lub nowszą.</para></caution>'>

<!-- inotify -->
<!ENTITY inotify.instance.description 'Zasób zwracany przez
<function xmlns="http://docbook.org/ns/docbook">inotify_init</function>'>

<!-- User streams -->
<!ENTITY userstream.not.implemented.warning '<para xmlns="http://docbook.org/ns/docbook">Zgłasza
<constant>E_WARNING</constant> jeśli wywołanie tej metody nie powiedzie się
(np. nie jest zaimplementowana).</para>'>
<!ENTITY userstream.updates.context '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Właściwość
<varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>
jest aktualizowana, jeśli do wywołującej funkcji jest przekazywany prawidłowy kontekst.</para></note>'>

<!ENTITY stream.bucket.param '<parameter>bucket</parameter> oczekuje teraz obiektu <classname>StreamBucket</classname>, wcześniej oczekiwany był obiekt typu <classname>stdClass</classname>.'>
<!ENTITY stream.bucket.return 'Ta funkcja zwraca teraz obiekt <classname>StreamBucket</classname>, wcześniej zwracany był obiekt typu <classname>stdClass</classname>.'>

<!-- Gmagick -->
<!ENTITY gmagick.return.success 'Zwraca &true; w przypadku powodzenia.'>
<!ENTITY gmagick.gmagickexception.throw 'Wywołuje wyjątek
<classname xmlns="http://docbook.org/ns/docbook">GmagickException</classname> w przypadku błędu.'>

<!-- Reflection -->
<!ENTITY reflection.export.return 'Jeśli parametr <parameter xmlns="http://docbook.org/ns/docbook">return</parameter>
jest ustawiony na &true;, eksport jest zwracany jako <type xmlns="http://docbook.org/ns/docbook">string</type>,
w przeciwnym przypadku jako &null;.'>

<!ENTITY reflection.export.param.return 'Ustawienie na &true; zwróci eksport,
zamiast go wyświetlać. Ustawienie na &false; (domyślne) odwrotnie.'>

<!ENTITY reflection.invoke.reference 'Jeśli funkcja posiada argumenty które muszą być
referencjami, muszą one być referencjami w przekazywanej liście argumentów.'>

<!ENTITY reflection.export.param.name 'Refleksja do eksportu.'>

<!ENTITY reflection.getattributes.param.name '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>name</parameter></term>
<listitem>
 <para>
  Filtruje wyniki tak aby zawierały tylko obiekty <classname>ReflectionAttribute</classname>
  dla atrybutów, które pasują do podanej nazwy.
 </para>
</listitem>
</varlistentry>'>

<!ENTITY reflection.getattributes.param.flags '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>flags</parameter></term>
<listitem>
 <para>
  Flagi określające jak filtrować wyniki, jeśli parametr <parameter>name</parameter>
  został podany.
 </para>
 <para>
  Domyślnym ustawieniem jest <literal>0</literal>, które zwróci wyniki tylko dla atrybutów,
  które są klasy podanej w <parameter>name</parameter>.
 </para>
 <para>
  Jedyną inną dostępną opcją jest użycie <constant>ReflectionAttribute::IS_INSTANCEOF</constant>,
  które zamiast tego do filtrowania użyje <literal>instanceof</literal>.
 </para>
</listitem>
</varlistentry>'>

<!ENTITY spl.files.intro.title '<title xmlns="http://docbook.org/ns/docbook">Obsługa plików</title>'>
<!ENTITY spl.files.intro '<partintro xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">SPL dostarcza kilka klas do pracy na plikach.</para></partintro>'>

<!ENTITY spl.interfaces.intro.title '<title xmlns="http://docbook.org/ns/docbook">Interfejsy</title>'>
<!ENTITY spl.interfaces.intro '<para xmlns="http://docbook.org/ns/docbook">SPL dostarcza kilka interfejsów.</para><para xmlns="http://docbook.org/ns/docbook">Patrz także: <xref xmlns="http://docbook.org/ns/docbook" linkend="reserved.interfaces" /></para>'>
<!ENTITY spl.interfaces.list '<title xmlns="http://docbook.org/ns/docbook">Lista interfejsów</title>'>

<!ENTITY spl.iterators.intro.title '<title xmlns="http://docbook.org/ns/docbook">Iteratory</title>'>
<!ENTITY spl.iterators.intro '<para xmlns="http://docbook.org/ns/docbook">SPL udostępnia zestaw iteratorów do przechodzenia po obiektach.</para>'>

<!ENTITY spl.misc.intro.title '<title xmlns="http://docbook.org/ns/docbook">Różne klasy i interfejsy</title>'>
<!ENTITY spl.misc.intro '<partintro xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Pozostałe klasy i interfejsy SPL.</para></partintro>'>

<!-- ZIP -->
<!ENTITY zip.filename.separator '<note xmlns="http://docbook.org/ns/docbook"><simpara>W celu zapewnienia maksymalnej przenośności zaleca się aby zawsze używać normalnych ukośników (<literal>/</literal>) jako separatora katalogów w nazwach plików w ZIP.</simpara></note>'>

<!-- Win32Service -->
<!ENTITY win32service.false.error ', &false; jeśli występuje problem z parametrami lub <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Kod Błędu Win32</link> w przypadku niepowodzenia.'>
<!ENTITY win32service.success.false.error 'Zwraca &true; w przypadku powodzenia &win32service.false.error;'>
<!ENTITY win32service.noerror.false.error 'zwracane było <constant xmlns="http://docbook.org/ns/docbook">WIN32_NO_ERROR</constant> w przypadku powodzenia, &win32service.false.error;'>

<!-- SNMP -->
<!ENTITY snmp.set.type.values '<para xmlns="http://docbook.org/ns/docbook">
 <acronym>MIB</acronym> definiuje typ każdego id obiektu. Musi być podany jako pojedynczy znak z poniższej listy
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>types</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>=</entry><entry>Typ pobrany z MIB</entry></row>
   <row><entry>i</entry><entry>INTEGER</entry> </row>
   <row><entry>u</entry><entry>INTEGER</entry></row>
   <row><entry>s</entry><entry>STRING</entry></row>
   <row><entry>x</entry><entry>HEX STRING</entry></row>
   <row><entry>d</entry><entry>DECIMAL STRING</entry></row>
   <row><entry>n</entry><entry>NULLOBJ</entry></row>
   <row><entry>o</entry><entry>OBJID</entry></row>
   <row><entry>t</entry><entry>TIMETICKS</entry></row>
   <row><entry>a</entry><entry>IPADDRESS</entry></row>
   <row><entry>b</entry><entry>BITS</entry></row>
  </tbody>
 </tgroup>
</table>
<para xmlns="http://docbook.org/ns/docbook">
 Jeśli przy kompilacji biblioteki <acronym>SNMP</acronym> zdefiniowana została stała <constant>OPAQUE_SPECIAL_TYPES</constant>, dostępne są także poniższe wartości:
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>types</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>U</entry><entry>unsigned int64</entry></row>
   <row><entry>I</entry><entry>signed int64</entry></row>
   <row><entry>F</entry><entry>float</entry></row>
   <row><entry>D</entry><entry>double</entry></row>
  </tbody>
 </tgroup>
</table>
'>
<!ENTITY snmp.set.type.values.asn.mapping '<para xmlns="http://docbook.org/ns/docbook">
 Większość z nich będzie w sposób oczywisty odpowiadać typowi ASN.1 &apos;s&apos;, &apos;x&apos;, &apos;d&apos; i &apos;b&apos; są różnymi sposobami na określenie wartości OCTET STRING, a typ &apos;u&apos; - bez określania znaku - stosowany jest także dla obsługi wartości Gauge32.
</para>
'>
<!ENTITY snmp.set.type.values.equal.note '<para xmlns="http://docbook.org/ns/docbook">
 Jeśli pliki MIB są ładowane do drzewa MIB poprzez "snmp_read_mib" lub przez podanie ich w konfiguracji libsnmp, &apos;=&apos; może być stosowane
 jako wartość parametru <parameter>type</parameter> dla wszystkich id obiektów, jako że typ może być automatycznie odczytany z MIB.
</para>
'>
<!ENTITY snmp.set.type.values.bitset.note '<para xmlns="http://docbook.org/ns/docbook">
 Istnieją dwa sposoby aby ustawić wartość zmiennej typu BITS, przykładowo
 "SYNTAX    BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
      Stosując typ "b" i listę wartości bitowych. Ta metoda nie jest zalecana ponieważ zapytanie GET dla dla tego samego OID zwróciłoby np. 0xF8.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
      Stosując typ "x" i wartość szesnastkową bez zwyczajowego prefiksu "0x".
  </simpara>
 </listitem>
</itemizedlist>
<para xmlns="http://docbook.org/ns/docbook">
 Zobacz też sekcję z przykładami.
</para>
'>
<!ENTITY snmp.methods.exceptions_enable.refsect '<refsect1 role="errors" xmlns="http://docbook.org/ns/docbook">
&reftitle.errors;
<para>
    Ta metoda domyślnie nie zwraca żadnych wyjątków.
    Aby włączyć zwracanie wyjątku SNMPException przy wystąpieniu niektórych błędów biblioteki,
    należy odpowiednio ustawić parametru klasy SNMP <parameter>exceptions_enabled</parameter>.
    Zobacz <link linkend="snmp.props.exceptions-enabled">opis
 <parameter>SNMP::$exceptions_enabled</parameter></link> aby dowiedzieć się więcej.
</para>
</refsect1>
'>

<!-- Eio -->
<!ENTITY eio.callback.proto '<para xmlns="http://docbook.org/ns/docbook">
Funkcja <parameter xmlns="http://docbook.org/ns/docbook">callback</parameter> jest wywoływana po zakończeniu wywołania. Powinna ona być zgodna z następującym prototypem: <programlisting role="php"><![CDATA[
void callback(mixed $dane, int $wynik[, resource $zapytanie]);
]]></programlisting>
<variablelist xmlns="http://docbook.org/ns/docbook">
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>dane</parameter></term>
<listitem><para>dane przekazywane do zapytania.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>wynik</parameter></term>
<listitem><para>wartość wynikowa, zależna od zapytania; ogólnie, jest to wartość zwracana przez odpowiednie wywołanie systemowe.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>zapytanie</parameter></term>
<listitem><para>opcjonalny zasób zapytania, który może być użyty z funkcjami takimi jak <function>eio_get_last_error</function>.</para></listitem>
</varlistentry>
</variablelist>
</para>
'>

<!ENTITY eio.request.pri.values '<para
xmlns="http://docbook.org/ns/docbook">Priorytet zapytania: <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MIN</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MAX</constant>, lub &null;.
Jeśli podana zostanie wartość &null;, parametr <parameter
xmlns="http://docbook.org/ns/docbook">pri</parameter> jest wewnętrznie ustawiany na
<constant xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>.
</para>
'>

<!ENTITY eio.warn.relpath '<warning
xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Unikaj ścieżek względnych
</simpara></warning>
'>

<!ENTITY trader.arg.array.of.real 'Tablica wartości zmiennoprzecinkowych.'>
<!ENTITY trader.arg.array.of.real.high 'Najwyższa cena, High price, tablica wartości zmiennoprzecinkowych.'>
<!ENTITY trader.arg.array.of.real.low 'Najniższa cena, tablica wartości zmiennoprzecinkowych.'>
<!ENTITY trader.arg.array.of.real.close 'Cena zamknięcia, tablica wartości zmiennoprzecinkowych.'>
<!ENTITY trader.arg.array.of.real.open 'Cena otwarcia, tablica wartości zmiennoprzecinkowych.'>
<!ENTITY trader.arg.array.of.real.volume 'Wolumen obrotu, tablica wartości zmiennoprzecinkowych.'>
<!ENTITY trader.arg.array.of.real.periods 'Tablica wartości zmiennoprzecinkowych.'>
<!ENTITY trader.arg.penetration 'Procent penetracji świecy wewnątrz innej świecy.'>
<!ENTITY trader.arg.vfactor 'Współczynnik wolumenu. Wartość z zakresu od 1 do 0.'>
<!ENTITY trader.arg.time.period 'Numer okresu. Wartość z zakresu od 2 do 100000.'>
<!ENTITY trader.arg.fast.period 'Numer okresu dla szybkiego MA. Wartość z zakresu od 2 do 100000.'>
<!ENTITY trader.arg.slow.period 'Numer okresu dla wolnego MA. Wartość z zakresu od 2 do 100000.'>
<!ENTITY trader.arg.signal.period 'Wygładzanie linii sygnału (numer okresu). Wartość z zakresu od 1 do 100000.'>
<!ENTITY trader.arg.fastk.period 'Przedział czasowy dla budowania linii Fast-K. Wartość z zakresu od 1 do 100000.'>
<!ENTITY trader.arg.fastd.period 'Wygładzanie do stworzenia linii Fast-D. Wartość z zakresu od 1 do 100000, zazwyczaj ustawiana na 3.'>
<!ENTITY trader.arg.slowk.period 'Wygładzanie do stworzenia linii Slow-K. Wartość z zakresu od 1 do 100000, zazwyczaj ustawiana na 3.'>
<!ENTITY trader.arg.slowd.period 'Wygładzanie do stworzenia linii Slow-D. Wartość z zakresu od 1 do 100000, zazwyczaj ustawiana na 3.'>
<!ENTITY trader.arg.min.period 'Wartość mniejsza od minimalnej będzie zmieniona do wartości okresu minimalnego. Wartość z zakresu od 2 do 100000'>
<!ENTITY trader.arg.max.period 'Wartość wyższa od minimalnej będzie zmieniona do wartości okresu maksymalnego. Wartość z zakresu od 2 do 100000'>
<!ENTITY trader.arg.ma.type 'Typ ruchomej średniej. Należy stosować stałe z serii <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.fast.ma.type 'Typ ruchomej średniej dla szybkiego MA. Należy stosować stałe z serii <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.slow.ma.type 'Typ ruchomej średniej dla wolnego MA. Należy stosować stałe z serii <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.fastd.ma.type 'Typ ruchomej średniej dla Fast-D. Należy stosować stałe z serii <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.fastk.ma.type 'Typ ruchomej średniej dla Fast-K. Należy stosować stałe z serii <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.slowd.ma.type 'Typ ruchomej średniej dla Slow-D. Należy stosować stałe z serii <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.slowk.ma.type 'Typ ruchomej średniej dla Slow-K. Należy stosować stałe z serii <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.signal.ma.type 'Typ ruchomej średniej dla linii sygnału. Należy stosować stałe z serii <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.nbdevup 'Mnożnik odchylenia dla górnego zakresu. Wartość z przedziału od <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> do <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.nbdevdn 'Mnożnik odchylenia dla dolnego zakresu. Wartość z przedziału od <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> to <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.fast.limit 'Górny limit do stosowania w algorytmie adaptacyjnym. Wartość z zakresu od 0.01 do 0.99.'>
<!ENTITY trader.arg.slow.limit 'Dolny limit do stosowania w algorytmie adaptacyjnym. Wartość z zakresu od 0.01 do 0.99.'>

<!-- mongodb -->

<!ENTITY mongodb.changelog.tentative-return-types '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 1.15.0</entry>
        <entry>
         Typy zwracane przez metody są określone jako niepewne w PHP 8.0 i nowszych,
         co powoduje zgłaszanie <constant>E_DEPRECATED</constant> w kodzie, który implementuje ten interfejs
         bez zadeklarowania odpowiednich zwracanych typów. Można użyć atrybutu
         <code>#[ReturnTypeWillChange]</code> aby wyciszyć zgłaszanie komunikatów <code>E_DEPRECATED</code>.
        </entry>
       </row>
'>

<!ENTITY mongodb.option.collation '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>collation</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            <link xlink:href="&url.mongodb.docs.collation;" xmlns:xlink="http://www.w3.org/1999/xlink">Porównywanie znaków</link> pozwala użytkownikom na określenie typowych dla języka zasad porównywania ciągów znaków, takich jak reguły dla wielkości znaków czy znaków akcentów. Przy określaniu porównyania znaków pole <literal>"locale"</literal> jest obowiązkowe; pozostałe pola collation są opcjonalne. Aby zapoznać się z opisami pól przeczytaj <link xlink:href="&url.mongodb.docs.collation;#collation-document" xmlns:xlink="http://www.w3.org/1999/xlink">Collation Document</link>.
           </para>
           <para>
            Jeśli porównanie znaków jest nieokreslone, ale kolekcja ma domyślne porównywanie znaków, operacja będzie używać porównywania znaków określonego dla kolekcji. Jeśli kolekcja ani operacja nie ma określonego porównywania znaków, MongoDB użyje prostego porównania binarnego, które było używane dla porównań ciągów znaków we wcześniejszych wersjach.
           </para>
           <para>
            Ta opcja jest dostępna w Mongo 3.4+ i użycie jej w starszych wersjach spowoduje rzucenie wyjątku w trakcie wykonywania skryptu.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.let '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>let</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            Mapa nazw i wartości parametrów. Wartości muszą być wyrażeniami stałymi lub zamkniętymi, które nie odnoszą się do pól dokumentu. Do parametrów można dostać się jak do zmiennych w kontekście wyrażenia agregującego (np. <literal>$$var</literal>).
           </para>
           <para>
            Ta opcja jest dostępna w Mongo 5.0+ i użycie jej w starszych wersjach spowoduje rzucenie wyjątku w trakcie wykonywania skryptu.
           </para>
          </entry>
         </row>
'>
<!-- //// TODO DOKOŃCZYĆ //// -->
<!ENTITY mongodb.option.encryption.keyVaultClient '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultClient</entry>
          <entry><classname>MongoDB\Driver\Manager</classname></entry>
          <entry>The Manager used to route data key queries to a separate MongoDB cluster. By default, the current Manager and cluster is used.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultNamespace '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultNamespace</entry>
          <entry><type>string</type></entry>
          <entry>A fully qualified namespace (e.g. <literal>"databaseName.collectionName"</literal>) denoting the collection that contains all data keys used for encryption and decryption. This option is required.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.kmsProviders '
         <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
          <entry>kmsProviders</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            A document containing the configuration for one or more KMS providers, which are used to encrypt data keys. Supported providers include <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal>, <literal>"kmip"</literal>, and <literal>"local"</literal> and at least one must be specified.
           </para>
           <para>
            If an empty document is specified for <literal>"aws"</literal>,
            <literal>"azure"</literal>, or <literal>"gcp"</literal>, the driver
            will attempt to configure the provider using
            <link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Automatic Credentials</link>.
           </para>
           <para>
            The format for <literal>"aws"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
aws: {
    accessKeyId: <string>,
    secretAccessKey: <string>,
    sessionToken: <optional string>
}
]]>
           </programlisting>
           <para>
            The format for <literal>"azure"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
azure: {
    tenantId: <string>,
    clientId: <string>,
    clientSecret: <string>,
    identityPlatformEndpoint: <optional string> // Defaults to "login.microsoftonline.com"
}
]]>
           </programlisting>
           <para>
            The format for <literal>"gcp"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
gcp: {
    email: <string>,
    privateKey: <base64 string>|<MongoDB\BSON\Binary>,
    endpoint: <optional string> // Defaults to "oauth2.googleapis.com"
}
]]>
           </programlisting>
           <para>
            The format for <literal>"kmip"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
kmip: {
    endpoint: <string>
}
]]>
           </programlisting>
           <para>
            The format for <literal>"local"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
local: {
    // 96-byte master key used to encrypt/decrypt data keys
    key: <base64 string>|<MongoDB\BSON\Binary>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.masterKey-options-by-provider '
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"aws"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>region</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>key</entry>
       <entry>string</entry>
       <entry>Required. The Amazon Resource Name (ARN) to the AWS customer master key (CMK).</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional. An alternate host identifier to send KMS requests to. May include port number.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"azure"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyVaultEndpoint</entry>
       <entry>string</entry>
       <entry>Required. Host with optional port (e.g. "example.vault.azure.net").</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Optional. A specific version of the named key. Defaults to using the key&apos;s primary version.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"gcp"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>projectId</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>location</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyRing</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Optional. A specific version of the named key. Defaults to using the key&apos;s primary version.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional. Host with optional port. Defaults to "cloudkms.googleapis.com".</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"kmip"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyId</entry>
       <entry>string</entry>
       <entry>Optional. Unique identifier to a 96-byte KMIP secret data managed object. If unspecified, the driver creates a random 96-byte KMIP secret data managed object.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional. Host with optional port.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
'>
<!ENTITY mongodb.option.encryption.tlsOptions '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>tlsOptions</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            A document containing the TLS configuration for one or more KMS providers. Supported providers include <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal>, and <literal>"kmip"</literal>. All providers support the following options:
           </para>
           <programlisting role="javascript">
<![CDATA[
<provider>: {
    tlsCaFile: <optional string>,
    tlsCertificateKeyFile: <optional string>,
    tlsCertificateKeyFilePassword: <optional string>,
    tlsDisableOCSPEndpointCheck: <optional bool>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.maxCommitTimeMS '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>maxCommitTimeMS</entry>
          <entry>integer</entry>
          <entry>
           <para>
            The maximum amount of time in milliseconds to allow a single
            <literal>commitTransaction</literal> command to run.
           </para>
           <para>
            If specified, <literal>maxCommitTimeMS</literal> must be a signed
            32-bit integer greater than or equal to zero.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readConcern</entry>
          <entry><classname>MongoDB\Driver\ReadConcern</classname></entry>
          <entry>
           <para>
            A read concern to apply to the operation.
           </para>
           <para>
            This option is available in MongoDB 3.2+ and will result in an
            exception at execution time if specified for an older server
            version.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readPreference '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readPreference</entry>
          <entry><classname>MongoDB\Driver\ReadPreference</classname></entry>
          <entry>
           <para>
            A read preference to use for selecting a server for the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.session '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>session</entry>
          <entry><classname>MongoDB\Driver\Session</classname></entry>
          <entry>
           <para>
            A session to associate with the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.transactionReadWriteConcern '
     <warning xmlns="http://docbook.org/ns/docbook">
      <para>
       If you are using a <literal>"session"</literal> which has a transaction
       in progress, you cannot specify a <literal>"readConcern"</literal> or
       <literal>"writeConcern"</literal> option. This will result in an
       <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>
       being thrown. Instead, you should set these two options when you create
       the transaction with
       <methodname>MongoDB\Driver\Session::startTransaction</methodname>.
      </para>
     </warning>
'>
<!ENTITY mongodb.option.writeConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>writeConcern</entry>
          <entry><classname>MongoDB\Driver\WriteConcern</classname></entry>
          <entry>
           <para>
            A write concern to apply to the operation.
           </para>
          </entry>
         </row>
'>

<!ENTITY mongodb.parameter.namespace '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>namespace</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      W pełni wykwalifikowana przestrzeń nazw (np. <literal>"nazwaBazyDanych.nazwaKolekcji"</literal>).
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.db '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>db</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      Nazwa bazy danych, na której wykonać komendę.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWrite</classname>)</term>
    <listitem>
     <para>
      Zapis(y) do wykonania.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.command '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
    <listitem>
     <para>
      Komenda do wykonania.
     </para>
    </listitem>
   </varlistentry>
'>
<!-- //// TODO DOKOŃCZYĆ //// -->
<!ENTITY mongodb.parameter.encryptOpts '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>options</parameter></term>
    <listitem>
     <para>
      <table>
       <title>Opcje szyfrowania</title>
       <tgroup cols="3">
        <thead>
         <row>
          <entry>Opcja</entry>
          <entry>Typ</entry>
          <entry>Opis</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry>algorithm</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            Algorytm szyfrowania, który powinien być użyty. Ta opcja jest wymagana.
            Możesz określić jedną z następujących
            <link linkend="mongodb-driver-clientencryption.constants">stałych ClientEncryption</link>:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant></member>
           </simplelist>
          </entry>
         </row>
         <row>
          <entry>contentionFactor</entry>
          <entry><type>int</type></entry>
          <entry>
           <para>
            The contention factor for evaluating queries with indexed, encrypted
            payloads.
           </para>
           <para>
            This option only applies and may only be specified when
            <literal>algorithm</literal> is
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            or
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>keyAltName</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            Identifies a key vault collection document by
            <literal>keyAltName</literal>. This option is mutually exclusive
            with <literal>keyId</literal> and exactly one is required.
           </para>
          </entry>
         </row>
         <row>
          <entry>keyId</entry>
          <entry><classname>MongoDB\BSON\Binary</classname></entry>
          <entry>
           <para>
            Identifies a data key by <literal>_id</literal>. The value is a UUID
            (binary subtype 4). This option is mutually exclusive with
            <literal>keyAltName</literal> and exactly one is required.
           </para>
          </entry>
         </row>
         <row>
          <entry>queryType</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            The query type for evaluating queries with indexed, encrypted
            payloads. Specify one of the following
            <link linkend="mongodb-driver-clientencryption.constants">ClientEncryption constants</link>:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE</constant></member>
           </simplelist>
           <para>
            This option only applies and may only be specified when
            <literal>algorithm</literal> is
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            or <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>rangeOpts</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Index options for a queryable encryption field supporting "range"
            queries. The options below must match the values set in the
            <literal>encryptedFields</literal> of the target collection. For
            double and decimal128 BSON field types, <literal>min</literal>,
            <literal>max</literal>, and <literal>precision</literal> must all be
            set, or all be unset.
           </para>
           <para>
            <table>
             <title>Range index options</title>
             <tgroup cols="3">
              <thead>
               <row>
                <entry>Option</entry>
                <entry>Type</entry>
                <entry>Description</entry>
               </row>
              </thead>
              <tbody>
               <row>
                <entry>min</entry>
                <entry><type>mixed</type></entry>
                <entry>
                 Required if <literal>precision</literal> is set. The minimum
                 BSON value of the range.
                </entry>
               </row>
               <row>
                <entry>max</entry>
                <entry><type>mixed</type></entry>
                <entry>
                 Required if <literal>precision</literal> is set. The maximum
                 BSON value of the range.
                </entry>
               </row>
               <row>
                <entry>sparsity</entry>
                <entry><type>int</type></entry>
                <entry>Required. Positive 64-bit integer.</entry>
               </row>
               <row>
                <entry>precision</entry>
                <entry><type>int</type></entry>
                <entry>
                 Optional. Positive 32-bit integer specifying precision to use
                 for explicit encryption. May only be set for double or
                 decimal128 BSON field types.
                </entry>
               </row>
               <row>
                <entry>trimFactor</entry>
                <entry><type>int</type></entry>
                <entry>Optional. Positive 32-bit integer.</entry>
               </row>
              </tbody>
             </tgroup>
            </table>
           </para>
          </entry>
         </row>
        </tbody>
       </tgroup>
      </table>
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.query '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>query</parameter> (<classname>MongoDB\Driver\Query</classname>)</term>
    <listitem>
     <para>
      Zapytanie do wykonania.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.readPreference '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>readPreference</parameter> (<type>MongoDB\Driver\ReadPreference</type>)</term>
    <listitem>
     <para>
      Opcjonalnie <classname>MongoDB\Driver\ReadPreference</classname>, aby określić serwer dla tej operacji. Jeśli nie podano, zostanie użyta preferencja zapisu z <link linkend="mongodb-driver-manager.construct-uri">URI Połączenia MongoDB</link>.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>typeMap</parameter> (<type>array</type>)</term>
    <listitem>
     <para>
      <link linkend="mongodb.persistence.typemaps">Konfiguracja mapy typów</link>.
     </para>
    </listitem>
   </varlistentry>
'>
<!-- //// TODO DOKOŃCZYĆ //// -->
<!ENTITY mongodb.parameter.filter '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>filter</parameter> (<type class="union"><type>array</type><type>object</type></type>)</term>
    <listitem>
     <para>
      The <link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">query predicate</link>.
      An empty predicate will match all documents in the collection.
     </para>
     <note>
      <simpara>
       When evaluating query criteria, MongoDB compares types and values according to its own <link xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/" xmlns:xlink="http://www.w3.org/1999/xlink">comparison rules for BSON types</link>, which differs from PHP&apos;s <link linkend="types.comparisons">comparison</link> and <link linkend="language.types.type-juggling">type juggling</link> rules. When matching a special BSON type the query criteria should use the respective <link linkend="mongodb.bson">BSON class</link> (e.g. use <classname>MongoDB\BSON\ObjectId</classname> to match an <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
      </simpara>
     </note>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">Zwraca <classname>MongoDB\Driver\Cursor</classname> przy powodzeniu.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">Zwraca <classname>MongoDB\Driver\WriteResult</classname> przy powodzeniu.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.session-readwriteconcern '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> jeśli opcja <literal>"session"</literal> jest używana w powiązanej transakcji w połączeniu z opcją <literal>"readConcern"</literal> lub <literal>"writeConcern"</literal>.</member>'>
<!-- //// TODO DOKOŃCZYĆ //// -->
<!ENTITY mongodb.throws.session-unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> jeśli opcja <literal>"session"</literal> option is used in combination with an unacknowledged write concern.</member>'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\BulkWriteException</classname> w przypadku niepowodzenia zapisu (e.g. write error, failure to apply a write concern)</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> przy błędach parsowania argumentów.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\AuthenticationException</classname> jeśli wymagana autoryzacja nie powiedzie się.</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\ConnectionException</classname> jeśli połączenie z serwerem nie powiedzie się (z powodów innych niż autoryzacja).</member>'>
<!-- //// TODO DOKOŃCZYĆ //// -->
<!ENTITY mongodb.throws.bson.unexpected '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\UnexpectedValueException</classname> if the input did not contain exactly one BSON document. Possible reasons include, but are not limited to, invalid BSON, extra data (after reading one BSON document), or an unexpected <link xlink:href="&url.mongodb.libbson;" xmlns:xlink="http://www.w3.org/1999/xlink">libbson</link> error.</member>'>

<!-- Not used in EN anymore -->
<!ENTITY mongodb.note.queryable-encryption-preview ''>

<!ENTITY mongodb.note.decimal128 '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     <classname>MongoDB\BSON\Decimal128</classname> is only compatible with
     MongoDB 3.4+. Attempting to use the BSON type with an earlier version of
     MongoDB will result in an error.
    </simpara>
   </note>
'>
<!ENTITY mongodb.note.extended-json '
  <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <simpara>
    The output is consistent with the <function>MongoDB\BSON\toJSON</function>
    function, which uses the driver-specific legacy extended JSON format. This
    does not necessarily match the
    <link xlink:href="&url.mongodb.specs.extendedjson;#relaxed-extended-json-example">relaxed</link>
    or <link xlink:href="&url.mongodb.specs.extendedjson;#canonical-extended-json-example">canonical</link>
    extended JSON representations used by
    <function>MongoDB\BSON\toRelaxedExtendedJSON</function> and
    <function>MongoDB\BSON\toCanonicalExtendedJSON</function>, respectively.
   </simpara>
  </note>
'>
<!ENTITY mongodb.note.forking '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     On Unix platforms, the extension is sensitive to scripts that use the
     fork() system call without also calling exec(). Users are advised not to
     re-use <classname>MongoDB\Driver\Manager</classname> instances in a forked
     child process.
    </simpara>
   </note>
'>

<!ENTITY mongodb.note.uint32 '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    Because PHP&apos;s integer type is signed, some values returned by this
    method may appear as negative integers on 32-bit platforms. The
    <literal>"&#37;u"</literal> formatter of <function>sprintf</function> may be
    used to obtain a string representation of the unsigned decimal value.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.readpreference '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    The <literal>"readPreference"</literal> option does not control the server
    to which the driver issues the operation; it will always be executed on
    this server object. Instead, it may be used when issuing the operation to a
    secondary (from a replica set connection, not standalone) or mongos node to
    ensure that the driver sets the wire protocol accordingly or adds the read
    preference to the operation, respectively.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.write '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    It is the caller&apos;s responsibility to ensure that the server is capable
    of executing the write operation. For example, executing a write operation
    on a secondary (excluding its "local" database) will fail.
   </simpara>
  </note>
'>

<!ENTITY mongodb.warning.duplicate-keys '
   <warning xmlns="http://docbook.org/ns/docbook">
    <simpara>
     BSON documents can technically contain duplicate keys because documents are
     stored as a list of key-value pairs; however, applications should refrain
     from generating documents with duplicate keys as server and driver behavior
     may be undefined. Since PHP objects and arrays cannot have duplicate keys,
     data could also be lost when decoding a BSON document with duplicate keys.
    </simpara>
   </warning>
'>

<!-- Radius -->
<!ENTITY radius.request.required '<note xmlns="http://docbook.org/ns/docbook"><para>Przed wywołaniem tej funkcji trzeba utworzyć zapytanie używając <function>radius_create_request</function>.</para></note>'>
<!ENTITY radius.parameter.attribute-type '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>type</parameter></term><listitem><para>Typ atrybutu.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.handle '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>radius_handle</parameter></term><listitem><para>Zasób RADIUS.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.options '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>options</parameter></term><listitem><para>Maska bitowa opcji atrybutu. Dostępne opcje to <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> oraz <link linkend="constant.radius-option-salt"><constant>RADIUS_OPTION_SALT</constant></link>.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.tag '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>tag</parameter></term><listitem><para>Tag atrybutu. Ten parametr jest ignorowany dopóki nie ustawiono opcji <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link>.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>vendor</parameter></term><listitem><para>ID vendora.</para></listitem></varlistentry>'>

<!-- posix snippets -->
<!-- //// TODO DOKOŃCZYĆ //// -->
<!ENTITY posix.parameter.fd '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>file_descriptor</parameter></term>
 <listitem>
  <para>
   The file descriptor, which is expected to be either a file
   <type>resource</type> or an <type>int</type>. An <type>int</type>
   will be assumed to be a file descriptor that can be passed directly to
   the underlying system call.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY posix.rlimits '
<para xmlns="http://docbook.org/ns/docbook">
  Each resource has an associated soft and hard limit.  The soft
  limit is the value that the kernel enforces for the corresponding
  resource.  The hard limit acts as a ceiling for the soft limit.
  An unprivileged process may only set its soft limit to a value
  from 0 to the hard limit, and irreversibly lower its hard limit.
</para>
'>

<!-- strings snippets -->
<!ENTITY strings.stripped.characters '
 <itemizedlist xmlns="http://docbook.org/ns/docbook">
    <listitem>
     <simpara>
      <literal>" "</literal>: znak <acronym>ASCII</acronym> <acronym>SP</acronym>
      <literal>0x20</literal>, zwykła spacja.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\t"</literal>: znak <acronym>ASCII</acronym> <acronym>HT</acronym>
      <literal>0x09</literal>, tabulator.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\n"</literal>: znak <acronym>ASCII</acronym> <acronym>LF</acronym>
      <literal>0x0A</literal>, nowa linia (znak nowego wiersza).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\r"</literal>: znak <acronym>ASCII</acronym> <acronym>CR</acronym>
      <literal>0x0D</literal>, znak powrotu karetki.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\0"</literal>: znak <acronym>ASCII</acronym> <acronym>NUL</acronym>
      <literal>0x00</literal>, bajt NUL.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\v"</literal>: znak <acronym>ASCII</acronym> <acronym>VT</acronym>
      <literal>0x0B</literal>, pionowy tabulator.
     </simpara>
    </listitem>
   </itemizedlist>
'>

<!ENTITY strings.stripped.unicode '
 <itemizedlist xmlns="http://docbook.org/ns/docbook">
    <listitem>
     <simpara>
      <literal>" "</literal> (<acronym>Unicode</acronym> U+0020), zwykła spacja.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\t"</literal> (<acronym>Unicode</acronym> U+0009), tabulator.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\n"</literal> (<acronym>Unicode</acronym> U+000A), nowa linia (znak nowego wiersza).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\r"</literal> (<acronym>Unicode</acronym> U+000D), znak powrotu karetki
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\0"</literal> (<acronym>Unicode</acronym> U+0000), bajt NUL.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\v"</literal> (<acronym>Unicode</acronym> U+000B), pionowy tabulator.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\f"</literal> (<acronym>Unicode</acronym> U+000C), znak form feed.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u00A0"</literal> (<acronym>Unicode</acronym> U+00A0), znak NO-BREAK SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u1680"</literal> (<acronym>Unicode</acronym> U+1680), znak OGHAM SPACE MARK.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2000"</literal> (<acronym>Unicode</acronym> U+2000), znak EN QUAD.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2001"</literal> (<acronym>Unicode</acronym> U+2001), znak EM QUAD.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2002"</literal> (<acronym>Unicode</acronym> U+2002), znak EN SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2003"</literal> (<acronym>Unicode</acronym> U+2003), znak EM SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2004"</literal> (<acronym>Unicode</acronym> U+2004), znak THREE-PER-EM SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2005"</literal> (<acronym>Unicode</acronym> U+2005), znak FOUR-PER-EM SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2006"</literal> (<acronym>Unicode</acronym> U+2006), znak SIX-PER-EM SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2007"</literal> (<acronym>Unicode</acronym> U+2007), znak FIGURE SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2008"</literal> (<acronym>Unicode</acronym> U+2008), znak PUNCTUATION SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2009"</literal> (<acronym>Unicode</acronym> U+2009), znak THIN SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u200A"</literal> (<acronym>Unicode</acronym> U+200A), znak HAIR SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2028"</literal> (<acronym>Unicode</acronym> U+2028), znak LINE SEPARATOR.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2029"</literal> (<acronym>Unicode</acronym> U+2029), znak PARAGRAPH SEPARATOR.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u202F"</literal> (<acronym>Unicode</acronym> U+202F), znak NARROW NO-BREAK SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u205F"</literal> (<acronym>Unicode</acronym> U+205F), znak MEDIUM MATHEMATICAL SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u3000"</literal> (<acronym>Unicode</acronym> U+3000), znak IDEOGRAPHIC SPACE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u0085"</literal> (<acronym>Unicode</acronym> U+0085), znak NEXT LINE (NEL).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u180E"</literal> (<acronym>Unicode</acronym> U+180E), znak MONGOLIAN VOWEL SEPARATOR.
     </simpara>
    </listitem>
   </itemizedlist>
'>

<!ENTITY strings.parameter.characters.optional '
 <simpara xmlns="http://docbook.org/ns/docbook">
  Opcjonalnie można też określić usuwane znaki przy użyciu
  parametru <parameter>characters</parameter>.
  Po prostu wymień wszystkie znaki, które mają zostać usunięte.
  Przy użyciu <literal>..</literal> możliwe jest określenie rosnącego zakresu znaków.
 </simpara>
'>

<!ENTITY strings.parameter.unicode.optional '
 <simpara xmlns="http://docbook.org/ns/docbook">
  Opcjonalnie można też określić usuwane znaki przy użyciu
  parametru <parameter>characters</parameter>.
  Po prostu wymień wszystkie znaki, które mają zostać usunięte.
 </simpara>
'>

<!ENTITY strings.parameter.encoding '
 <para xmlns="http://docbook.org/ns/docbook">
  Opcjonalny parametr określający kodowanie przy konwersji znaków.
 </para>

 <para xmlns="http://docbook.org/ns/docbook">
  Jeśli pominięto, to domyślną wartością parametru <parameter>encoding</parameter> będzie
  opcja konfiguracyjna <link linkend="ini.default-charset">default_charset</link>.
 </para>

 <para xmlns="http://docbook.org/ns/docbook">
  Pomimo iż technicznie ten parametr jest opcjonalny, wysoce zalecane jest
  ustawienie wartości odpowiedniej dla Twojego kodu,
  jeśli Twoja wartość <link linkend="ini.default-charset">default_charset</link>
  może być ustawiona niepoprawnie dla określonych danych wejściowych.
 </para>
'>

<!ENTITY strings.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>format</parameter></term>
 <listitem>
  <para>
   Ciąg formatujący składa się z zera lub więcej dyrektyw:
   zwykłych znaków (poza <literal>&#37;</literal>), które
   są bezpośrednio kopiowane do wyniku oraz <emphasis>specyfikacji
   formatu</emphasis>, z których każdy pobiera swój
   własny parametr..
  </para>

  <para>
   Specyfikacja formatu przyjmuje następującą formę:
   <literal>&#37;[numer_argumentu$][flagi][szerokość][.precyzja]znak_formatujący</literal>.
  </para>

  <formalpara>
   <title>numer_argumentu</title>
   <para>
    Liczba, po której następuje znak dolara <literal>$</literal>,
    określająca do którego argumentu zostanie zaaplikowana konwersja.
   </para>
  </formalpara>

  <para>
   <table>
    <title>Flagi</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Flaga</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>-</literal></entry>
       <entry>
        Wyrównaj do lewej w ramach szerokości danego pola;
        domyślnie wyrównuje do prawej
       </entry>
      </row>
      <row>
       <entry><literal>+</literal></entry>
       <entry>
        Poprzedź liczby dodatnie znakiem plusa
        <literal>+</literal>; Domyślnie tylko liczby ujemne
        poprzedzone są znakiem minus.
       </entry>
      </row>
      <row>
       <entry><literal> </literal>(spacja)</entry>
       <entry>
        Wyrównaj wynik spacjami.
        Zachowanie domyślne.
       </entry>
      </row>
      <row>
       <entry><literal>0</literal></entry>
       <entry>
        Wyrównaj wynik zerami z lewej strony.
        W połączeniu z <literal>s</literal> może to też
        wyrównywać zerami z prawej strony.
       </entry>
      </row>
      <row>
       <entry><literal>&apos;</literal>(znak)</entry>
       <entry>
        Wyrównuje wynik znakiem (char).
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <formalpara>
   <title>Szerokość</title>
   <para>
    Jest to albo liczba, która mówi ile znaków (minimum)
    powinna zwrócić dana konwersja, albo <literal>*</literal>.
    Jeżeli użyto <literal>*</literal> to szerokość jest podawana
    jako dodatkowa wartość liczbowa poprzedzająca tą sformatowaną
    danym znakiem formatującym.
   </para>
  </formalpara>

  <formalpara>
   <title>Precyzja</title>
   <para>
    Kropka (<literal>.</literal>) po której opcjonalnie następuje
    albo liczba albo <literal>*</literal>,
    których znaczenie zależy od znaku formatującego:
    <itemizedlist>
     <listitem>
      <simpara>
       Dla znaków <literal>e</literal>, <literal>E</literal>,
       <literal>f</literal> oraz <literal>F</literal>
       ta liczba określa ile cyfr ma być wypisanych
       po kropce dziesiętnej (domyślnie jest to 6).
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Dla znaków <literal>g</literal>, <literal>G</literal>,
       <literal>h</literal> oraz <literal>H</literal>
       ta liczba określa maksymalną ilość cyfr
       znaczących do wypisania.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Dla znaku <literal>s</literal> zachowuje się jako punkt odcięcia,
       określając maksymalny limit znaków dla ciągu.
      </simpara>
     </listitem>
    </itemizedlist>
    <note>
     <simpara>
      Jeśli podano kropkę bez okreslonej wartości dla precyzji,
      to przyjmowane jest 0. Jeśli użyto <literal>*</literal>, to precyzja jest podawana
      jako dodatkowa wartość liczbowa poprzedzająca tą sformatowaną
      danym znakiem formatującym.
     </simpara>
    </note>
   </para>
  </formalpara>

  <para>
   <table>
    <title>Znaki formatujące</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Znak</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>&#37;</literal></entry>
       <entry>
        Dosłowny znak procenta. Nie jest wymagany żaden arugment.
       </entry>
      </row>
      <row>
       <entry><literal>b</literal></entry>
       <entry>
        Argument jest traktowany jak liczba całkowita i przedstawiany
        jako liczba binarna.
       </entry>
      </row>
      <row>
       <entry><literal>c</literal></entry>
       <entry>
        Argument jest traktowany jak liczba całkowita i przedstawiany
        jako znak z odpowiadającym kodem ASCII.
       </entry>
      </row>
      <row>
       <entry><literal>d</literal></entry>
       <entry>
        Argument jest traktowany jak liczba całkowita i przedstawiany
        jako liczba dziesiętna ze znakiem.
       </entry>
      </row>
      <row>
       <entry><literal>e</literal></entry>
       <entry>
        Argument jest traktowany jako notacja naukowa (np. 1.2e+2).
       </entry>
      </row>
      <row>
       <entry><literal>E</literal></entry>
       <entry>
        Tak jak <literal>e</literal>, ale używa
        dużej litery (np. 1.2E+2).
       </entry>
      </row>
      <row>
       <entry><literal>f</literal></entry>
       <entry>
        Argument jest traktowany jako liczba zmiennoprzecinkowa i prezentowany
        jako liczba zmiennoprzecinkowa (z uwzględnieniem ustawień regionalnych [locale]).
       </entry>
      </row>
      <row>
       <entry><literal>F</literal></entry>
       <entry>
        Argument jest traktowany jako liczba zmiennoprzecinkowa i prezentowany
        jako liczba zmiennoprzecinkowa (bez uwzględnienienia ustawień regionalnych [locale]).
       </entry>
      </row>
      <row>
       <entry><literal>g</literal></entry>
       <entry>
        <para>
         Format ogólny.
        </para>
        <para>
         Niech P będzie równe prezycji jeśli ta jest różna od zera, 6 jeśli precyzja jest pominięta
         lub 1 jeśli precyzja wynosi 0.
         Wtedy, jeśli konwersja ze stylem E miałaby wykładnik X:
        </para>
        <para>
         Jeśli P > X ≥ −4, to konwersja jest ze stylem f a precyzja to P − (X + 1).
         W przeciwnym razie konwersja jest ze stylem e, a precyzja to P − 1.
        </para>
       </entry>
      </row>
      <row>
       <entry><literal>G</literal></entry>
       <entry>
        Tak jak <literal>g</literal>, z tym że używa
        <literal>E</literal> i <literal>f</literal>.
       </entry>
      </row>
      <row>
       <entry><literal>h</literal></entry>
       <entry>
        Tak jak <literal>g</literal>, z tym że używa <literal>F</literal>.
        Dostępne od PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>H</literal></entry>
       <entry>
        Tak jak <literal>g</literal>, z tym że używa
        <literal>E</literal> oraz <literal>F</literal>. Dostępne od PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>o</literal></entry>
       <entry>
        Argument jest traktowany jak liczba całkowita i przedstawiany
        jako liczba ósemkowa.
       </entry>
      </row>
      <row>
       <entry><literal>s</literal></entry>
       <entry>
        Argument jest traktowany i przedstawiany jako string.
       </entry>
      </row>
      <row>
       <entry><literal>u</literal></entry>
       <entry>
        Argument jest traktowany jak liczba całkowita i przedstawiany
        jako liczba dziesiętna bez znaku.
       </entry>
      </row>
      <row>
       <entry><literal>x</literal></entry>
       <entry>
        Argument jest traktowany jak liczba całkowita i przedstawiany
        jako liczba szesnastkowa (z małymi literami).
       </entry>
      </row>
      <row>
       <entry><literal>X</literal></entry>
       <entry>
        Argument jest traktowany jak liczba całkowita i przedstawiany
        jako liczba szesnastkowa (z dużymi literami).
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <warning>
   <para>
    Znak formatujący <literal>c</literal> ignoruje dopełnienia (padding) i szerokość.
   </para>
  </warning>

  <warning>
   <para>
    Próba użycia kombinacji znaków formatujących dla ciągów znaków (string) z zestawami znaków, które wymagają więcej niż jednego bajtu na znam może powodować nieoczekiwane wyniki.
   </para>
  </warning>

  <para>
   Zmienne zostaną skonwertowane na typ odpowiedni dla danego znaku formatującego:
   <table>
    <title>Obsługa typów</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Typ</entry>
       <entry>Znaki formatujące</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><type>string</type></entry>
       <entry><literal>s</literal></entry>
      </row>
      <row>
       <entry><type>int</type></entry>
       <entry>
        <literal>d</literal>,
        <literal>u</literal>,
        <literal>c</literal>,
        <literal>o</literal>,
        <literal>x</literal>,
        <literal>X</literal>,
        <literal>b</literal>
       </entry>
      </row>
      <row>
       <entry><type>float</type></entry>
       <entry>
        <literal>e</literal>,
        <literal>E</literal>,
        <literal>f</literal>,
        <literal>F</literal>,
        <literal>g</literal>,
        <literal>G</literal>,
        <literal>h</literal>,
        <literal>H</literal>
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </listitem>
</varlistentry>
'>

<!ENTITY strings.scanf.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>format</parameter></term>
     <listitem>
      <para>
       Interpretowany format dla parametru <parameter>string</parameter>, który
       został opisany w dokumentacji dla <function>sprintf</function> z
       następującymi różnicami:
       <simplelist>
        <member>
         Funkcja nie uwzględnia ustawień regionalnych (locale).
        </member>
        <member>
         Znaki formatujące <literal>F</literal>, <literal>g</literal>, <literal>G</literal> i
         <literal>b</literal> nie są wspierane.
        </member>
        <member>
         <literal>D</literal> oznacza liczby dziesiętne.
        </member>
        <member>
         <literal>i</literal> oznacza liczbę dziesiętną z wykryciem podstawy.
        </member>
        <member>
         <literal>n</literal> oznacza liczbę znaków przetworzonych dotychczas.
        </member>
        <member>
         <literal>s</literal> zatrzymuje odczyt na dowolnym białym znaku.
        </member>
        <member>
         <literal>*</literal> instead of <literal>argnum$</literal> suppresses
         the assignment of this conversion specification.
        </member>
       </simplelist>
      </para>
     </listitem>
    </varlistentry>
'>

<!ENTITY strings.parameter.needle.non-string '
 <para xmlns="http://docbook.org/ns/docbook">
  Przed PHP 8.0.0, jeśli parametr <parameter>needle</parameter> nie jest ciągiem znaków, jest on konwertowany
  na liczbę całkowitą i stosowany jako liczba porządkowa znaku.
  To zachowanie jest przestarzałe od PHP 7.3.0 i poleganie na nim jest
  niezalecane. W zależności od oczekiwanego zachowania, parametr
  <parameter>needle</parameter> powinien zostać jawnie zrzutowany na ciąg znaków
  lub powinna zostać jawnie użyta funkcja <function>chr</function>.
 </para>
'>

<!ENTITY strings.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Parametr <parameter>needle</parameter> dopuszcza teraz też pusty ciąg znaków.
 </entry>
</row>'>

<!ENTITY strings.changelog.encoding '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>5.6.0</entry>
  <entry>
   Zmieniono domyślną wartość parametru <parameter>encoding</parameter> na
   wartość opcji konfiguracyjnej
   <link linkend="ini.default-charset">default_charset</link>.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.ascii-case-conversion '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   Konwersja wielkości znaków nie zależy już od ustawień regionalnych ustawionych przy użyciu
   <function>setlocale</function>. Zostaną skonwertowane tylko znaki ASCII.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.ascii-case-folding '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   Case folding (traktowanie małych i dużych liter jak takie same) nie zależy już od ustawień regionalnych ustawionych przy użyciu
   <function>setlocale</function>. Tylko znaki ASCII podlegają case foldingowi.
   Bajty spoza ASCII będą porównywane przy użyciu ich wartości bajtu.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.sprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Ta funkcja nie zwraca już &false; w wypadku błędu.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Rzuca <classname>ValueError</classname> jeżeli liczba argumentów to zero;
       wczesniej ta funkcja emitowała <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Rzuca <classname>ValueError</classname> jeżeli <literal>[szerokość]</literal> jest mniejsza niż zero lub większa niż <constant>PHP_INT_MAX</constant>;
       wczesniej ta funkcja emitowała <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Rzuca <classname>ValueError</classname> jeśli <literal>[precyzja]</literal> jest mniejsza niż zero lub większa niż <constant>PHP_INT_MAX</constant>;
       wczesniej ta funkcja emitowała <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Rzuca <classname>ArgumentCountError</classname> gdy podano mniej argumentów niż jest wymagane;
       wczesniej ta funkcja emitowała <constant>E_WARNING</constant>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

<!ENTITY strings.changelog.vsprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Ta funkcja nie zwraca już &false; w wypadku błędu.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Rzuca <classname>ValueError</classname> jeżeli liczba argumentów to zero;
       wczesniej ta funkcja emitowała <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Rzuca <classname>ValueError</classname> jeżeli <literal>[szerokość]</literal> jest mniejsza niż zero lub większa niż <constant>PHP_INT_MAX</constant>;
       wczesniej ta funkcja emitowała <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Rzuca <classname>ValueError</classname> jeśli <literal>[precyzja]</literal> jest mniejsza niż zero lub większa niż <constant>PHP_INT_MAX</constant>;
       wczesniej ta funkcja emitowała <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Rzuca <classname>ValueError</classname> gdy podano mniej argumentów niż jest wymagane;
       wczesniej ta funkcja emitowała <constant>E_WARNING</constant>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

<!ENTITY strings.errors.sprintf '
  <para xmlns="http://docbook.org/ns/docbook">
   Począwszy od PHP 8.0.0 rzucany jest <classname>ValueError</classname> jeśli liczba argumentów wynosi zero.
   Przed PHP 8.0.0 emitowany był <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Począwszy od PHP 8.0.0 rzucany jest <classname>ValueError</classname> jeśli <literal>[szerokość]</literal> jest mniejsza niż zero lub większa niż <constant>PHP_INT_MAX</constant>.
   Przed PHP 8.0.0 emitowany był <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Począwszy od PHP 8.0.0 rzucany jest <classname>ValueError</classname> jeśli <literal>[precyzja]</literal> jest mniejsza niż zero lub większa niż <constant>PHP_INT_MAX</constant>.
   Przed PHP 8.0.0 emitowany był <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Począwszy od PHP 8.0.0 rzucany jest <classname>ArgumentCountError</classname> gdy podano mniej argumentów niż jest wymagane.
   Przed PHP 8.0.0 zwracane było &false; i emitowany był <constant>E_WARNING</constant>.
  </para>
'>

<!ENTITY strings.errors.vsprintf '
  <para xmlns="http://docbook.org/ns/docbook">
   Począwszy od PHP 8.0.0 rzucany jest <classname>ValueError</classname> jeśli liczba argumentów wynosi zero.
   Przed PHP 8.0.0 emitowany był <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Począwszy od PHP 8.0.0 rzucany jest <classname>ValueError</classname> jeśli <literal>[szerokość]</literal> jest mniejsza niż zero lub większa niż <constant>PHP_INT_MAX</constant>.
   Przed PHP 8.0.0 emitowany był <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Począwszy od PHP 8.0.0 rzucany jest <classname>ValueError</classname> jeśli <literal>[precyzja]</literal> jest mniejsza niż zero lub większa niż <constant>PHP_INT_MAX</constant>.
   Przed PHP 8.0.0 emitowany był <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Począwszy od PHP 8.0.0 rzucany jest <classname>ValueError</classname> gdy podano mniej argumentów niż jest wymagane.
   Przed PHP 8.0.0 zwracane było &false; i emitowany był <constant>E_WARNING</constant>.
  </para>
'>

<!ENTITY strings.comparison.return '
  <simpara xmlns="http://docbook.org/ns/docbook">
   Zwraca wartość mniejszą od 0 jeśli <parameter>string1</parameter>
   jest mniejszy niż <parameter>string2</parameter>; wartość większą
   od 0 jeśli <parameter>string1</parameter> jest większy niż
   <parameter>string2</parameter> i <literal>0</literal> jeśli
   są równe.
   Poza użytym znakiem, z wartości nie można wywnioskować żadnego konkretnego
   znaczenia.
  </simpara>
'>

<!-- filter snippets -->
<!-- TODO: Remove -->
<!ENTITY filter.param.filter '
 <varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>filter</parameter></term>
  <listitem>
   <para>
    Filtr do zastosowania.
    Może być filtrem walidującym jeśli użyta zostanie jedna ze stałych
    <constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>,
    filtrem oczyszczającym jeśli użyta zostanie jedna ze stałych
    <constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant>,
    filtrem <constant>FILTER_UNSAFE_RAW</constant> lub własnym filtrem przy użyciu
    <constant>FILTER_CALLBACK</constant>.
   </para>
   <para>
    Domyślnym jest <constant>FILTER_DEFAULT</constant>,
    który jest aliasem dla <constant>FILTER_UNSAFE_RAW</constant>.
    Skutkuje to domyślnym brakiem filtrowania.
   </para>
  </listitem>
 </varlistentry>
'>

<!-- csprng snippets -->
<!ENTITY csprng.sources '
<para xmlns="http://docbook.org/ns/docbook">
 Źródła losowych danych dla tej funkcji prezentują się następująco (posortowane według priorytetu):
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <listitem>
  <para>
   Linux: <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   FreeBSD &gt;= 12 (PHP &gt;= 7.3): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Windows (PHP &gt;= 7.2): <link xlink:href="&url.csprng.cng-api;">CNG-API</link>
  </para>
  <para>
   Windows: <link xlink:href="&url.csprng.crypt-gen-random;">CryptGenRandom</link>
  </para>
 </listitem>
 <listitem>
  <para>
   macOS (PHP &gt;= 8.2; &gt;= 8.1.9; &gt;= 8.0.22 jeśli CCRandomGenerateBytes jest dostępne w czasie kompilacji): CCRandomGenerateBytes()
  </para>
  <para>
   macOS (PHP &gt;= 8.1; &gt;= 8.0.2): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   NetBSD &gt;= 7 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   OpenBSD &gt;= 5.5 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   DragonflyBSD (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Solaris (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <simpara>
   Każda inna niewymieniona kombinacja systemu operacyjnego i wersji PHP: <filename>/dev/urandom</filename>.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Jeśli żadne z wyżej wymienionych źródeł nie będzie dostępne lub wszystkie dostępne źródła dadzą rady wygenerować
   losowości, zostanie rzucony wyjątek
   <classname>Random\RandomException</classname>.
  </simpara>
 </listitem>
</itemizedlist>
'>
<!ENTITY csprng.errors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Jeśli odpowiednie źródło losowości nie może zostać znalezione,
   zostanie rzucony wyjątek <classname>Random\RandomException</classname>.
  </simpara>
 </listitem>
'>
<!ENTITY csprng.function.backport '
 <note xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Mimo iż ta funkcja została dodana w PHP 7.0, dostępna jest
   <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.compat;">implementacja napisana w PHP</link>,
   której można użyć od PHP 5.2 do 5.6 włącznie.
  </simpara>
 </note>
'>

<!-- Random snippets -->
<!ENTITY random.engineErrors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Dowolne z <classname>Throwable</classname> rzucone przez metodę <methodname>Random\Engine::generate</methodname>
   pochodzące z użytego <link linkend="random-randomizer.props.engine"><literal>Random\Randomizer::$engine</literal></link>.
  </simpara>
 </listitem>
'>

<!-- UOPZ snippets -->

<!ENTITY uopz.warn.removed.function-5-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja została
<emphasis>USUNIĘTA</emphasis> w PECL uopz 5.0.0.</simpara></warning>'>

<!-- XML snippets -->
<!ENTITY xml.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <para>
   Parser XML.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY xml.handler.description '<para xmlns="http://docbook.org/ns/docbook">
 Jeżeli przekazano &null;, to funkcja obsługi jest resetowana do swojego stanu domyślnego.
 <warning>
  <simpara>
    Pusty ciąg znaków także resetuje handler,
    jednak jest to przestarzałe od PHP 8.4.0.
  </simpara>
 </warning>
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Jeżeli parametr <parameter>handler</parameter> jest typu <type>callable</type>,
 to jako handler jest ustawiany callable.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Jeżeli parametr <parameter>handler</parameter> to ciąg znaków (<type>string</type>),
 to ten ciąg znaków może być nazwą metody obiektu ustawionego za pomocą
 <function>xml_set_object</function>.
 <warning>
  <simpara>
   Jest to przestarzałe od PHP 8.4.0.
  </simpara>
 </warning>
</para>
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Od PHP 8.4.0, poprawność callable jest sprawdzana podczas ustawiania funkcji obsługi,
  a nie w chwili jej wykonania.
  Oznacza to, że <function>xml_set_object</function> musi zostać wywołana przed
  ustawieniem ciągu znaków z metodą jako funkcji zwrotnej.
  Jednak jako, że to zachowanie także jest przestarzałe od PHP 8.4.0,
  zalecane jest użycie faktycznego <type>callable</type> dla tej metody.
 </simpara>
</warning>
'>

<!ENTITY xml.handler.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <simpara>
   Parser XML wywołujący handler.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY xml.changelog.handler-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Przekazanie ciągu znaków, który nie jest poprawnym <type>callable</type>
  jako parametr <parameter>handler</parameter> jest teraz przestarzałe.
  Użyj poprawnego callable dla metod lub &null; aby zresetować handler.
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Poprawność parametru <parameter>handler</parameter> jako <type>callable</type>
  jest teraz sprawdzana w chwili ustawiania funkcji obsługi, a nie podczas jej wykonywania.
 </entry>
</row>'>

<!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>parser</parameter> oczekuje obiektu klasy <classname>XMLParser</classname>
  wcześniej oczekiwany był poprawny <link linkend="language.types.resource">zasób</link> <literal>xml</literal>.
 </entry>
</row>'>

<!-- Migration Guide snippets -->
<!-- //// TODO DOKOŃCZYĆ //// -->
<!ENTITY migration56.openssl.peer-verification '
   <para xmlns="http://docbook.org/ns/docbook">
    All encrypted client streams now enable peer verification by default. By
    default, this will use OpenSSL&apos;s default CA bundle to verify the peer
    certificate. In most cases, no changes will need to be made to communicate
    with servers with valid SSL certificates, as distributors generally
    configure OpenSSL to use known good CA bundles.
   </para>

   <para xmlns="http://docbook.org/ns/docbook">
    The default CA bundle may be overridden on a global basis by setting
    either the openssl.cafile or openssl.capath configuration setting, or on a
    per request basis by using the
    <link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> or
    <link linkend="context.ssl.capath"><parameter>capath</parameter></link>
    context options.
   </para>

   <para xmlns="http://docbook.org/ns/docbook">
    While not recommended in general, it is possible to disable peer
    certificate verification for a request by setting the
    <link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
    context option to &false;, and to disable peer name validation by setting
    the <link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link>
    context option to &false;.
   </para>
'>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: fen fdm=syntax fdl=2 si
vim: et tw=78
vi: ts=1 sw=1
-->