1
0
mirror of https://github.com/php/doc-pl.git synced 2026-03-23 22:52:11 +01:00

Sync with EN

This commit is contained in:
Maciej Sobaczewski
2024-08-30 04:43:53 +02:00
parent 3dd8e3e626
commit ca49c8cd49
16 changed files with 110 additions and 137 deletions

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b9e6268918813e27972c644897970b0cdbc6f86e Maintainer: joeaccord Status: ready -->
<!-- EN-Revision: 6d46a5549bcb66444ce7a3b34301420ba7552bc8 Maintainer: joeaccord Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: leszek, sobak, cyb0org -->
<appendix xml:id="aliases" xmlns="http://docbook.org/ns/docbook">
@@ -21,7 +21,7 @@
<thead>
<row>
<entry>Alias</entry>
<entry>Główna funkcja</entry>
<entry>Podstawowa nazwa funkcji</entry>
<entry>Rozszerzenie</entry>
</row>
</thead>
@@ -621,11 +621,6 @@
<entry><function>strstr</function></entry>
<entry>Podstawowa składnia</entry>
</row>
<row>
<entry>xptr_new_context</entry>
<entry><function>xpath_new_context</function></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 61eadb77279dfc430988e259919c78983770a1f0 Maintainer: joeaccord Status: ready -->
<!-- EN-Revision: 592b824dd743c3ffd5dce2eefa63628c8e64117e Maintainer: joeaccord Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: sobak, qrak -->
<sect2 xml:id="reserved.constants.core" xmlns="http://docbook.org/ns/docbook">
@@ -126,6 +126,28 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.debug-backtrace-provide-object">
<term>
<constant>DEBUG_BACKTRACE_PROVIDE_OBJECT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Wypełnia klucz "object".
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.debug-backtrace-ignore-args">
<term>
<constant>DEBUG_BACKTRACE_IGNORE_ARGS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Nie zawiera informacji o argumentach funkcji w stosie wywołań (stack trace).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-maxpathlen">
<term>
<constant>PHP_MAXPATHLEN</constant>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: fdabefd50cedaed15fa965ea3a8be31646207a1a Maintainer: joeaccord Status: ready -->
<!-- EN-Revision: ced6d2c2bacc02e3048abd4a2ab58d755d09307d Maintainer: joeaccord Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: leszek, adi, sobak -->
@@ -62,11 +62,6 @@
</author>
</authorgroup>
<copyright>
<year>1997-<?dbtimestamp format="Y"?></year>
<holder>the PHP Documentation Group</holder>
</copyright>
<legalnotice xml:id="copyright" xmlns:xlink="http://www.w3.org/1999/xlink">
<info><title>Copyright</title></info>
<simpara>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ba36a88377878340feb08b36cdde88c26f34df6a Maintainer: sobak Status: ready -->
<!-- EN-Revision: 2d0ae2133ccc5365c31ac675c88cda06b4877e22 Maintainer: sobak Status: ready -->
<!-- $Revision$ -->
<chapter xml:id="introduction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<info><title>Wprowadzenie</title></info>
@@ -81,7 +81,7 @@
strony czy wysyłanie i odbieranie ciasteczek. Lecz PHP może znacznie więcej.
</para>
<para>
Istnieje kilka głównych obszarów, w których są wykorzystywane skrypty PHP.
Istnieją dwa główne obszary, w których są wykorzystywane skrypty PHP.
<itemizedlist>
<listitem>
<simpara>
@@ -110,19 +110,6 @@
aby dowiedzieć się więcej.
</simpara>
</listitem>
<listitem>
<simpara>
Pisanie aplikacji desktopowych. PHP nie jest prawdopodobnie
najlepszym językiem do tworzenia aplikacji desktopowych,
ale jeśli znasz go bardzo dobrze i chciałbyś użyć
zaawansowanych możliwóści PHP w aplikacjach po stronie klienta,
możesz użyć PHP-GTK do napisania takich programów. W ten sposób
można też tworzyć aplikacje wieloplatformowe. PHP-GTK jest rozszerzeniem
dla PHP, niedostępnym w głównej dystrybucji. Jeśli zainteresował Cię PHP-GTK,
odwiedź <link xlink:href="&url.php.gtk;">jego
stronę</link>.
</simpara>
</listitem>
</itemizedlist>
</para>
<para>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 2d1981cc3003cd94f5fb88e0473eed2c5b26efde Maintainer: joeaccord Status: ready -->
<!-- EN-Revision: 61d5b83d9145d58515ad4c93c6125a339fb5eeda Maintainer: joeaccord Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: slawek, sobak -->
<chapter xml:id="features.http-auth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -15,8 +15,8 @@
<varname>PHP_AUTH_USER</varname>, <varname>PHP_AUTH_PW</varname> i
<varname>AUTH_TYPE</varname> zawierającymi odpowiednio
nazwę użytkownika, hasło i typ autoryzacji. Zmienne te będą dostępne w
tablicy <varname>$_SERVER</varname> Obsługiwane <emphasis>tylko</emphasis> autoryzacje
typu "Basic" i "Digest". Więcej informacji można znaleźć w opisie funkcji
tablicy <varname>$_SERVER</varname> Obsługiwane jest <emphasis>tylko</emphasis> autoryzacje
typu "Basic". Więcej informacji można znaleźć w opisie funkcji
<function>header</function>.
</simpara>
@@ -44,73 +44,6 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) {
</example>
</para>
<para>
<example>
<title>Przykład uwierzytelnianie Digest HTTP</title>
<para>
Ten przykład pokazuje jak zaimplementować proste umierzytelnianie
Digest HTTP. Więcej informacji znajduje się w dokumencie <link
xlink:href="&url.rfc;2617">RFC 2617</link>.
</para>
<programlisting role="php">
<![CDATA[
<?php
$realm = 'Zastrzeżona strefa';
//user => password
$users = array('admin' => 'mypass', 'guest' => 'guest');
if (empty($_SERVER['PHP_AUTH_DIGEST'])) {
header('HTTP/1.1 401 Unauthorized');
header('WWW-Authenticate: Digest realm="'.$realm.
'",qop="auth",nonce="'.uniqid().'",opaque="'.md5($realm).'"');
die('Tekst do wysłania kiedy użytkownik kliknie klawisz anuluj');
}
// analiza zmiennej PHP_AUTH_DIGEST
if (!($data = http_digest_parse($_SERVER['PHP_AUTH_DIGEST'])) ||
!isset($users[$data['username']]))
die('Nieprawidłowe listy uwierzytelniające!');
// tworzenie prawidłowej odpowiedzi
$A1 = md5($data['username'] . ':' . $realm . ':' . $users[$data['username']]);
$A2 = md5($_SERVER['REQUEST_METHOD'].':'.$data['uri']);
$valid_response = md5($A1.':'.$data['nonce'].':'.$data['nc'].':'.$data['cnonce'].':'.$data['qop'].':'.$A2);
if ($data['response'] != $valid_response)
die('Nieprawidłowe listy uwierzytelniające!');
// ok, prawidłowa nazwa użytkownika i hasło
echo 'Jesteś zalogowany jako: ' . $data['username'];
// function to parse the http auth header
function http_digest_parse($txt)
{
// zabezpieczenie przeciwko brakującym informacjom
$needed_parts = array('nonce'=>1, 'nc'=>1, 'cnonce'=>1, 'qop'=>1, 'username'=>1, 'uri'=>1, 'response'=>1);
$data = array();
$keys = implode('|', array_keys($needed_parts));
preg_match_all('@(\w+)=(?:([\'"])([^\2]+)\2|([^\s,]+))@', $txt, $matches, PREG_SET_ORDER);
foreach ($matches as $m) {
$data[$m[1]] = $m[3] ? $m[3] : $m[4];
unset($needed_parts[$m[1]]);
}
return $needed_parts ? false : $data;
}
?>
]]>
</programlisting>
</example>
</para>
<note>
<title>Kompatybilność</title>
<para>

View File

@@ -1,17 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: e443388d4249fea383d6ec2d1a338be220cf95ee Maintainer: leszek Status: ready -->
<!-- EN-Revision: cf9fc93681ad1bd5dfaaf61282a0463c2531f7d5 Maintainer: leszek Status: ready -->
<!-- $Revision$ -->
<chapter xml:id="install.general" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Ogólnie o instalacji</title>
<para>
Przed instalacją musisz wiedzieć, do czego potrzebne Ci jest PHP.
PHP jest używane głównie w trzech polach, tak jak to zostało
PHP jest używane głównie w dwóch obszarach, jak to zostało
opisane w rozdziale
<link linkend="intro-whatcando">Co potrafi PHP?</link>
<itemizedlist>
<listitem><simpara>skrypty po stronie serwera</simpara></listitem>
<listitem><simpara>skrypty wywoływane z linii poleceń</simpara></listitem>
<listitem><simpara>aplikacje po stronie klienta</simpara></listitem>
</itemizedlist>
</para>
<para>
@@ -48,16 +47,6 @@
wywoływanych z linii poleceń</link>. W tym przypadku nie potrzebujesz
ani serwera ani przeglądarki.
</para>
<para>
W PHP możesz pisać także aplikacje z interfejsem użytkownika
używając rozszerzenia PHP-GTK. Jest to podejście zupełnie
inne niż tworzenie stron internetowych, ponieważ nie wysyłasz
żadnego wyjścia HTMLowego, ale obsługujesz okienka i obiekty
w nich zawarte. Aby uzyskać więcej informacji o PHP-GTK,
odwiedź <link xlink:href="&url.php.gtk;">stronę poświęconą
temu rozszerzeniu</link>. PHP-GTK nie jest zawarte
w oficjalnej dystrybucji PHP.
</para>
<para>
Od tego miejsca rozdział dotyczy konfiguracji PHP z serwerami
WWW pracującymi pod kontrolą systemów Unix i Windows

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 437bbf134e015c678f9d4b8a5b8da53429a9a12d Maintainer: joeaccord Status: ready -->
<!-- EN-Revision: 38ee86c3c030bc74362a7e5c185192ef8ad5a442 Maintainer: joeaccord Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: leszek, sobak -->
@@ -80,6 +80,7 @@
<!ENTITY Properties "Właściwości">
<!ENTITY InheritedConstants "Stałe dziedziczone">
<!ENTITY Constants "Stałe">
<!ENTITY Constructor "Konstruktor">
<!ENTITY NotAvailable "Niedostępne">
<!-- These are used in reference/$extname/reference.xml and other

View File

@@ -798,7 +798,7 @@ wewnątrz katalogów określonych za pomocą <link xmlns="http://docbook.org/ns/
<!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; now;, wcześniej był to <type>bool</type>.
Typem zwracanym przez tę funkcję jest teraz &true;, wcześniej był to <type>bool</type>.
</entry>
</row>'>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 31cacb6f262f455c616094cfe6d09bc0d1df2748 Maintainer: leszek Status: ready -->
<!-- EN-Revision: 1de7b5b65f959de3babdd8ea1b060f8cebd60856 Maintainer: leszek Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: sobak, grzesiek -->
<refentry xml:id="function.array-filter" xmlns="http://docbook.org/ns/docbook">

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: d45ff7a3e78243470d1b7e5141d7ded022286d7f Maintainer: cyb0org Status: ready -->
<!-- EN-Revision: cec5275f23d2db648df30a5702b378044431be97 Maintainer: cyb0org Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: leszek, sobak, grzesiek -->
<refentry xml:id="function.array-walk" xmlns="http://docbook.org/ns/docbook">
@@ -10,7 +10,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>array_walk</methodname>
<type>true</type><methodname>array_walk</methodname>
<methodparam><type class="union"><type>array</type><type>object</type></type><parameter role="reference">array</parameter></methodparam>
<methodparam><type>callable</type><parameter>callback</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>arg</parameter><initializer>&null;</initializer></methodparam>
@@ -87,7 +87,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Zwraca &true;.
&return.true.always;
</para>
</refsect1>
@@ -114,6 +114,7 @@
</row>
</thead>
<tbody>
&return.type.true;
<row>
<entry>8.0.0</entry>
<entry>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e311803cd2fb931ad80bab6fd0f996d2ece6e2b8 Maintainer: leszek Status: ready -->
<!-- EN-Revision: d58ee8eaaa7f716c51f66f5f1058ab3c42376d98 Maintainer: leszek Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: sobak -->
<refentry xml:id="function.compact" xmlns="http://docbook.org/ns/docbook">
@@ -19,8 +19,9 @@
</para>
<para>
Dla każdej z nich <function>compact</function> sprawdza zmienną o
nazwie określonej przez bieżący symbol w tablicy i dodaje ją
do tablicy wyjściowej tak, że nazwa zmiennej staje się kluczem,
tej nazwie w obecnej
<link linkend="features.gc.refcounting-basics">tablicy symboli</link>
i dodaje ją do tablicy wyjściowej tak, że nazwa zmiennej staje się kluczem,
a zawartość zmiennej wartością dla tego klucza.
Krótko mówiąc, funkcja ta jest przeciwieństwem <function>extract</function>.
</para>
@@ -102,6 +103,7 @@
<programlisting role="php">
<![CDATA[
<?php
$city = "San Francisco";
$state = "CA";
$event = "SIGGRAPH";
@@ -110,6 +112,7 @@ $location_vars = array("city", "state");
$result = compact("event", $location_vars);
print_r($result);
?>
]]>
</programlisting>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4a7ddddc27271967b616ad3400cfbe2a9b48212b Maintainer: leszek Status: ready -->
<!-- EN-Revision: d58ee8eaaa7f716c51f66f5f1058ab3c42376d98 Maintainer: leszek Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: sobak -->
<refentry xml:id="function.extract" xmlns="http://docbook.org/ns/docbook">
@@ -16,8 +16,8 @@
<methodparam choice="opt"><type>string</type><parameter>prefix</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
<para>
Ta funkcja służy do importowania zmiennych z tablicy do bieżącej tablicy
symboli.
Importuje zmienne z tablicy do bieżącej
<link linkend="features.gc.refcounting-basics">tablicy symboli</link>.
</para>
<para>
Sprawdzany jest każdy element przekazanej tablicy <parameter>array</parameter>, żeby zobaczyć czy jest on poprawną nazwą zmiennej.
@@ -186,9 +186,12 @@
wddx_deserialize */
$size = "duży";
$var_array = array("color" => "niebieski",
"size" => "średni",
"shape" => "kwadrat");
$var_array = array(
"color" => "niebieski",
"size" => "średni",
"shape" => "kwadrat"
);
extract($var_array, EXTR_PREFIX_SAME, "wddx");
echo "$color, $size, $shape, $wddx_size\n";

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2ca090342977839edca2f7f4e52305a1b5da6095 Maintainer: leszek Status: ready -->
<!-- EN-Revision: 4acad9b77f9422b44aa58266f5fe1585b5bb3fe5 Maintainer: leszek Status: ready -->
<!-- $Revision$ -->
<refentry xml:id="function.krsort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -58,6 +58,13 @@
</thead>
<tbody>
&return.type.true;
<row>
<entry>8.2.0</entry>
<entry>
Ta funkcja używa teraz standardowych reguł PHP 8 do porównywania
numerycznych ciągów znaków, jeśli użyto <constant>SORT_REGULAR</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2ca090342977839edca2f7f4e52305a1b5da6095 Maintainer: leszek Status: ready -->
<!-- EN-Revision: 4acad9b77f9422b44aa58266f5fe1585b5bb3fe5 Maintainer: leszek Status: ready -->
<!-- $Revision$ -->
<refentry xml:id="function.ksort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -58,6 +58,13 @@
</thead>
<tbody>
&return.type.true;
<row>
<entry>8.2.0</entry>
<entry>
Ta funkcja używa teraz standardowych reguł PHP 8 do porównywania
numerycznych ciągów znaków, jeśli użyto <constant>SORT_REGULAR</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: sobak Status: ready -->
<!-- EN-Revision: 6846ebb4e33d51faee4a1e99c241a7a24861e0e4 Maintainer: sobak Status: ready -->
<!-- $Revision$ -->
<refentry xml:id="function.get-declared-classes" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -16,6 +16,12 @@
Pobiera zadeklarowane klasy.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
@@ -32,6 +38,31 @@
</para>
</note>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>7.4.0</entry>
<entry>
We wcześniejszych wersjach <function>get_declared_classes</function> zawsze zwracała klasy rodziców przed
klasami potomnymi. Nie jest to już prawdą. Dla wartości zwracanej przez
<function>get_declared_classes</function> nie jest zagwarantowana żadna konkretna kolejność.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ba08db8805ddb14cbab613c893dd47eacbda22f2 Maintainer: sobak Status: ready -->
<!-- EN-Revision: 184f3f7bd45643cb80f828d0bb001991ec3a5fad Maintainer: sobak Status: ready -->
<!-- $Revision$ -->
<section xml:id="curl.installation" xmlns="http://docbook.org/ns/docbook">
&reftitle.install;
@@ -11,17 +11,16 @@
powinien znaleźć się folder <filename>curl</filename> zawierający pliki
<filename>easy.h</filename> i <filename>curl.h</filename>.
Powinien istnieć także plik <filename>libcurl.a</filename> umieszczony w
katalogu <filename>lib</filename>. Począwszy od PHP 4.3.0 możesz skonfigurować
PHP, aby korzystał z cURL do obsługi strumieni. Odpowiednia opcja przy kompilacji
to <option role="configure">--with-curlwrappers</option>.
Ta możliwość została przeniesiona do PECL z wersją PHP 5.5.0.
katalogu <filename>lib</filename>.
</para>
<note>
<title>Dla użytkowników Win32</title>
<simpara>
Aby włączyć ten moduł w środowski Windows pliki
<filename>libeay32.dll</filename> i <filename>ssleay32.dll</filename>
Aby włączyć ten moduł w środowisku Windows pliki
<filename>libeay32.dll</filename> i <filename>ssleay32.dll</filename> lub (począwszy od OpenSSL 1.1)
<filename>libcrypto-*.dll</filename> and <filename>libssl-*.dll</filename>
muszą być obecne w zmiennej <envar>PATH</envar>.
Plik <filename>libssh2.dll</filename> także musi znajdować się w zmiennej <envar>PATH</envar>.
</simpara>
<simpara>
Nie potrzebujesz <filename>libcurl.dll</filename> ze strony cURL.