Skip to content

Commit a7d6195

Browse files
SobakSobak
committed
Sync with EN
1 parent bf800d7 commit a7d6195

File tree

11 files changed

+178
-24
lines changed

11 files changed

+178
-24
lines changed

‎appendices/about.xml‎

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: fc7fe7faecea431a37e1f809b2ba3056e4ef2e1b Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: e8ac70bf549a723cb36465667a6109d9933b8619 Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44

55
<appendix xml:id="about" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -337,10 +337,9 @@ Zwraca długość podanego ciągu znaków.
337337
</para>
338338
<para>
339339
Jeżeli znalazłeś błąd w manualu, w dowolnym języku, zgłoś go proszę
340-
341-
używając systemu śledzenia błędów w repozytorium odpowiedniego języka pod <link xlink:href="https://github.com/php/?q=doc">https://github.com/php</link>.
342-
Przykładowo błędy w angielskiej wersji podręcznika powinny być zgłaszane pod
343-
<link xlink:href="https://github.com/php/doc-en/issues">https://github.com/php/doc-en/issues</link>.
340+
używając systemu śledzenia błędów w repozytorium odpowiedniego języka w <link xlink:href="&url.php.git;">&url.php.git;</link>.
341+
Przykładowo błędy w polskiej wersji podręcznika powinny być zgłaszane pod
342+
<link xlink:href="&url.php.git;doc-pl/issues">&url.php.git;doc-pl/issues</link>.
344343
Wszystkie problemy
345344
związane z dokumentacją, także te o formatach podręcznika, powinny być zgłaszane jako
346345
zgłoszenia błędów.

‎appendices/resources.xml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<!-- EN-Revision: be3338bf720808467447fdcdd6cab9d3e8d821bc Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 8d0b3a6ff0419e1d25384a942fd3d3dbcc2eb5f9 Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44
<!-- CREDITS: joeaccord, qrak -->
55
<appendix xml:id="resource" xmlns="http://docbook.org/ns/docbook">
@@ -15,7 +15,7 @@
1515
<tgroup cols="5">
1616
<colspec colwidth='1*'/>
1717
<colspec colwidth='1*'/>
18-
<colspec colwidth='1.4*'/>
18+
<colspec colwidth='2*'/>
1919
<colspec colwidth='1*'/>
2020
<colspec colwidth='1*'/>
2121
<thead>

‎language/exceptions.xml‎

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: f4f96ef8b2a95283c92ea2183fe1dedf06f3ad22 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 844190217fcb8ad1d0790ef5a90f7c18fa9d1a9d Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44
<chapter xml:id="language.exceptions" xmlns="http://docbook.org/ns/docbook">
55
<title>Wyjątki</title>
@@ -327,6 +327,12 @@ try {
327327
?>
328328
]]>
329329
</programlisting>
330+
&example.outputs;
331+
<screen>
332+
<![CDATA[
333+
Został rzucony konkretny wyjątek, ale nie interesują nas szczegóły.
334+
]]>
335+
</screen>
330336
</example>
331337
<example>
332338
<title>Throw jako wyrażenie</title>
@@ -339,6 +345,10 @@ function test() {
339345
zrob_cos_ryzykownego() or throw new Exception('Nie zadziałało');
340346
}
341347
348+
function zrob_cos_ryzykownego() {
349+
return false; // Zasymuluj niepowodzenie
350+
}
351+
342352
try {
343353
test();
344354
} catch (Exception $e) {
@@ -347,6 +357,12 @@ try {
347357
?>
348358
]]>
349359
</programlisting>
360+
&example.outputs;
361+
<screen>
362+
<![CDATA[
363+
Nie zadziałało
364+
]]>
365+
</screen>
350366
</example>
351367
</sect1>
352368

‎language/oop5/changelog.xml‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: c0fa5077c8862405942d8aac7360c5169558b59b Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 6a3ce2f9a191ad00fdd709c249e6dea16df316e3 Maintainer: sobak Status: ready -->
33
<sect1 xml:id="language.oop5.changelog" xmlns="http://docbook.org/ns/docbook">
44
<title>Wykaz zmian dla modelu OOP</title>
55
<para>
@@ -16,6 +16,12 @@
1616
</row>
1717
</thead>
1818
<tbody>
19+
<row>
20+
<entry>8.4.0</entry>
21+
<entry>
22+
Dodano: wsparcie dla <link linkend="language.oop5.property-hooks">Property Hooks</link>.
23+
</entry>
24+
</row>
1925
<row>
2026
<entry>8.4.0</entry>
2127
<entry>

‎language/predefined/iteratoraggregate/getiterator.xml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 460f49a93d103cac99556147cb9325b095ca3d42 Maintainer: grzesiek Status: ready -->
2+
<!-- EN-Revision: 63b48309213faf184b4c2b6333e19675654aa473 Maintainer: grzesiek Status: ready -->
33
<!-- $Revision$ -->
44
<refentry xml:id="iteratoraggregate.getiterator" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>IteratorAggregate::getIterator</refname>
7-
<refpurpose>Pobiera zewnętrzny iterator</refpurpose>
7+
<refpurpose>Pobiera zewnętrzny iterator lub traversable</refpurpose>
88
</refnamediv>
99

1010
<refsect1 role="description">
@@ -14,7 +14,7 @@
1414
<void/>
1515
</methodsynopsis>
1616
<para>
17-
Zwraca zewnętrzny iterator.
17+
Zwraca zewnętrzny iterator lub traversable.
1818
</para>
1919
</refsect1>
2020

‎language/variables.xml‎

Lines changed: 43 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: df1e7145848499f193d0e106a86c27a9b94d130e Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44
<!-- CREDITS: garbus, qrak -->
55
<chapter xml:id="language.variables" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -43,7 +43,7 @@
4343
&tip.userlandnaming;
4444

4545
<example>
46-
<title>Poprawne i niepoprawne nazwy zmiennych</title>
46+
<title>Poprawne nazwy zmiennych</title>
4747
<programlisting role="php">
4848
<![CDATA[
4949
<?php
@@ -59,6 +59,16 @@ $jaŹń = 'osobowość'; // poprawna nazwa - "ń" i "Ź" należą do (roz
5959
</programlisting>
6060
</example>
6161

62+
<example>
63+
<title>Niepoprawne nazwy zmiennych</title>
64+
<programlisting role="php">
65+
<![CDATA[
66+
<?php
67+
$7dni = 'tydzień'; // niepoprawna nazwa - zaczyna się od cyfry
68+
]]>
69+
</programlisting>
70+
</example>
71+
6272
<simpara>
6373
PHP przyjmuje sekwencję dowolnych bajtów jako nazwę zmiennej. Dostęp do
6474
nazw zmiennych, które nie stosują się do wspomnianych wyżej reguł, może być
@@ -528,6 +538,35 @@ function foo(){
528538
</example>
529539
</para>
530540

541+
<simpara>
542+
Zmienne statyczne wewnątrz funkcji anonimowych są zachowywane tylko wewnątrz
543+
instancji tej konkretnej funkcji. Jeśli funkcja anonimowa jest tworzona ponownie przy każdym
544+
wywołaniu, to zmienna statyczna będzie inicjalizowana ponownie.
545+
</simpara>
546+
<example>
547+
<title>Zmienne statyczne w funkcjach anonimowych</title>
548+
<programlisting role="php">
549+
<![CDATA[
550+
<?php
551+
function exampleFunction($input) {
552+
$result = (static function () use ($input) {
553+
static $counter = 0;
554+
$counter++;
555+
return "Wejście: $input, Licznik: $counter\n";
556+
});
557+
558+
return $result();
559+
}
560+
561+
// Wywołania exampleFunction będą tworzyły funkcję anonimową ponownie, więc zmienna
562+
// statyczna nie zachowa swojej wartości.
563+
echo exampleFunction('A'); // Wyświetla: Wejście: A, Licznik: 1
564+
echo exampleFunction('B'); // Wyświetla: Wejście: B, Licznik: 1
565+
?>
566+
]]>
567+
</programlisting>
568+
</example>
569+
531570
<para>
532571
Od PHP 8.1.0, kiedy metoda używająca zmiennych statycznych jest dziedziczona (ale nie nadpisywana),
533572
odziedziczona metoda będzie współdzielić zmienne statyczne z metodą rodzica.
@@ -821,11 +860,13 @@ echo $foo->{$arr}[1] . "\n";
821860
</programlisting>
822861
&example.outputs;
823862
<screen>
863+
<![CDATA[
824864
Jestem bar.
825865
Jestem bar.
826866
Jestem bar.
827867
Jestem r.
828868
Jestem B.
869+
]]>
829870
</screen>
830871
</example>
831872
</para>

‎reference/bc/functions/bcpowmod.xml‎

Lines changed: 34 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: cbac1ecf71d754707d69bdc344c4031c157eaa54 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
4-
<refentry xml:id="function.bcpowmod" xmlns="http://docbook.org/ns/docbook">
4+
<refentry xml:id="function.bcpowmod" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
55
<refnamediv>
66
<refname>bcpowmod</refname>
77
<refpurpose>Podnosi liczbę o dużej precyzji do potęgi i wykonuje dzielenie modulo</refpurpose>
@@ -52,19 +52,35 @@
5252
</para>
5353
</listitem>
5454
</varlistentry>
55-
&bc.scale.description;
55+
<xi:include xpointer="function.bcadd..parameters.scale" />
5656
</variablelist>
5757
</para>
5858
</refsect1>
5959

6060
<refsect1 role="returnvalues">
6161
&reftitle.returnvalues;
6262
<para>
63-
Zwraca wynik jako ciąg znaków lub &false; jeśli parametr <parameter>modulus</parameter>
64-
wynosi <literal>0</literal>, lub parametr <parameter>exponent</parameter> jest ujemny.
63+
Zwraca wynik jako ciąg znaków.
6564
</para>
6665
</refsect1>
6766

67+
<refsect1 role="errors">
68+
&reftitle.errors;
69+
<para>
70+
Ta funkcja rzuca <exceptionname>ValueError</exceptionname> w następujących wypadkach:
71+
<simplelist>
72+
<member><parameter>num</parameter>, <parameter>exponent</parameter> lub <parameter>modulus</parameter> nie są poprawnie sformatowanymi dla BCMath ciągami numerycznymi</member>
73+
<member><parameter>num</parameter>, <parameter>exponent</parameter> lub <parameter>modulus</parameter> mają część ułamkową</member>
74+
<member><parameter>exponent</parameter> ma wartość ujemną</member>
75+
<member><parameter>scale</parameter> jest poza poprawnym zakresem</member>
76+
</simplelist>
77+
</para>
78+
<simpara>
79+
Ta funkcja rzuca wyjątek <exceptionname>DivisionByZeroError</exceptionname> jeśli <parameter>modulus</parameter>
80+
wynosi <literal>0</literal>.
81+
</simpara>
82+
</refsect1>
83+
6884
<refsect1 role="changelog">
6985
&reftitle.changelog;
7086
<informaltable>
@@ -82,6 +98,18 @@
8298
Parametr <parameter>scale</parameter> dopuszcza teraz &null;.
8399
</entry>
84100
</row>
101+
<row>
102+
<entry>8.0.0</entry>
103+
<entry>
104+
Od teraz rzucany jest <exceptionname>ValueError</exceptionname> zamiast zwrócenia &false; jeśli <parameter>exponent</parameter> jest ujemną wartością.
105+
</entry>
106+
</row>
107+
<row>
108+
<entry>8.0.0</entry>
109+
<entry>
110+
Dzielenie przez <literal>0</literal> rzuca teraz wyjątek <exceptionname>DivisionByZeroError</exceptionname> zamiast zwracać &false;.
111+
</entry>
112+
</row>
85113
</tbody>
86114
</tgroup>
87115
</informaltable>
@@ -126,6 +154,7 @@ $b = bcmod(bcpow($x, $y), $mod);
126154
<simplelist>
127155
<member><function>bcpow</function></member>
128156
<member><function>bcmod</function></member>
157+
<member><methodname>BcMath\Number::powmod</methodname></member>
129158
</simplelist>
130159
</para>
131160
</refsect1>

‎reference/classobj/functions/is-a.xml‎

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: fd65805e83f7dc3b12ab5844cafc4489dc367a27 Maintainer: sobak Status: ready -->
3-
<!-- $Revision$ -->
2+
<!-- EN-Revision: c558c3af38874a913c7515bbd49aaf2e689cbdd0 Maintainer: sobak Status: ready -->
43
<!-- CREDITS: dombal -->
54
<refentry xml:id="function.is-a" xmlns="http://docbook.org/ns/docbook">
65
<refnamediv>
@@ -89,6 +88,15 @@ if (is_a($WF, 'WidgetFactory')) {
8988
<programlisting role="php">
9089
<![CDATA[
9190
<?php
91+
// zdefiniuj klasę
92+
class WidgetFactory
93+
{
94+
var $oink = 'moo';
95+
}
96+
97+
// stwórz nowy obiekt
98+
$WF = new WidgetFactory();
99+
92100
if ($WF instanceof WidgetFactory) {
93101
echo 'Tak, $WF jest obiektem WidgetFactory';
94102
}

‎reference/reflection/book.xml‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: c477749c82111cbbdd657a0e98eeaeeec0d90c91 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: e0e74c05cb704b614ff6925552884fbffb26bb53 Maintainer: sobak Status: ready -->
33

44
<book xml:id="book.reflection" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<?phpdoc extension-membership="core" ?>
@@ -50,6 +50,7 @@
5050
&reference.reflection.reflectionattribute;
5151
&reference.reflection.reflector;
5252
&reference.reflection.reflectionexception;
53+
&reference.reflection.propertyhooktype;
5354

5455
</book>
5556

‎reference/reflection/reflectionproperty/ispublic.xml‎

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 16f66c05a4060a7d673ae1c70b656d65009407b0 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: e0e74c05cb704b614ff6925552884fbffb26bb53 Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44
<refentry xml:id="reflectionproperty.ispublic" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -35,12 +35,29 @@
3535
</note>
3636
</refsect1>
3737

38+
<refsect1 role="notes">
39+
&reftitle.notes;
40+
<note>
41+
<simpara>
42+
Miej świadomość, że to iż właściwość jest <literal>public</literal> nie zawsze
43+
oznacza, że jest ona publicznie zapisywalna. Właściwość może być wirtualna bez
44+
hooka <literal>set</literal> lub może być tylko do odczytu (<literal>readonly</literal>)
45+
i już ją ustawiono; może też mieć
46+
<link linkend="language.oop5.visibility-members-aviz">zadeklarowaną widoczność
47+
<literal>set</literal></link>, która nie jest publiczna. We wszystkich tych wypadkach
48+
ta metoda zwróci &true;, ale do właściwości wciąż nie będzie można nic zapisać.
49+
</simpara>
50+
</note>
51+
</refsect1>
52+
3853
<refsect1 role="seealso">
3954
&reftitle.seealso;
4055
<para>
4156
<simplelist>
4257
<member><methodname>ReflectionProperty::isProtected</methodname></member>
58+
<member><methodname>ReflectionProperty::isProtectedSet</methodname></member>
4359
<member><methodname>ReflectionProperty::isPrivate</methodname></member>
60+
<member><methodname>ReflectionProperty::isPrivateSet</methodname></member>
4461
<member><methodname>ReflectionProperty::isReadOnly</methodname></member>
4562
<member><methodname>ReflectionProperty::isStatic</methodname></member>
4663
</simplelist>

0 commit comments

Comments
 (0)