Skip to content

Commit f4d7706

Browse files
SobakSobak
committed
Sync with EN
1 parent acd4265 commit f4d7706

File tree

9 files changed

+162
-36
lines changed

9 files changed

+162
-36
lines changed

‎appendices/tokens.xml‎

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

55
<appendix xml:id="tokens" xmlns="http://docbook.org/ns/docbook">
@@ -144,7 +144,7 @@ defined('T_FN') || define('T_FN', 10001);
144144
<entry><constant>T_CLASS_C</constant></entry>
145145
<entry>__CLASS__</entry>
146146
<entry>
147-
<link linkend="language.constants.predefined">stałe magiczne</link>
147+
<link linkend="language.constants.magic">stałe magiczne</link>
148148
</entry>
149149
</row>
150150
<row xml:id="constant.t-clone">
@@ -228,7 +228,7 @@ defined('T_FN') || define('T_FN', 10001);
228228
<row xml:id="constant.t-dir">
229229
<entry><constant>T_DIR</constant></entry>
230230
<entry>__DIR__</entry>
231-
<entry><link linkend="language.constants.predefined">stałe magiczne</link></entry>
231+
<entry><link linkend="language.constants.magic">stałe magiczne</link></entry>
232232
</row>
233233
<row xml:id="constant.t-div-equal">
234234
<entry><constant>T_DIV_EQUAL</constant></entry>
@@ -375,7 +375,7 @@ defined('T_FN') || define('T_FN', 10001);
375375
<row xml:id="constant.t-file">
376376
<entry><constant>T_FILE</constant></entry>
377377
<entry>__FILE__</entry>
378-
<entry><link linkend="language.constants.predefined">stałe magiczne</link></entry>
378+
<entry><link linkend="language.constants.magic">stałe magiczne</link></entry>
379379
</row>
380380
<row xml:id="constant.t-final">
381381
<entry><constant>T_FINAL</constant></entry>
@@ -414,7 +414,7 @@ defined('T_FN') || define('T_FN', 10001);
414414
<entry><constant>T_FUNC_C</constant></entry>
415415
<entry>__FUNCTION__</entry>
416416
<entry>
417-
<link linkend="language.constants.predefined">stałe magiczne</link>
417+
<link linkend="language.constants.magic">stałe magiczne</link>
418418
</entry>
419419
</row>
420420
<row xml:id="constant.t-global">
@@ -523,7 +523,7 @@ defined('T_FN') || define('T_FN', 10001);
523523
<row xml:id="constant.t-line">
524524
<entry><constant>T_LINE</constant></entry>
525525
<entry>__LINE__</entry>
526-
<entry><link linkend="language.constants.predefined">stałe magiczne</link></entry>
526+
<entry><link linkend="language.constants.magic">stałe magiczne</link></entry>
527527
</row>
528528
<row xml:id="constant.t-list">
529529
<entry><constant>T_LIST</constant></entry>
@@ -561,7 +561,7 @@ defined('T_FN') || define('T_FN', 10001);
561561
<entry><constant>T_METHOD_C</constant></entry>
562562
<entry>__METHOD__</entry>
563563
<entry>
564-
<link linkend="language.constants.predefined">stałe magiczne</link>
564+
<link linkend="language.constants.magic">stałe magiczne</link>
565565
</entry>
566566
</row>
567567
<row xml:id="constant.t-minus-equal">
@@ -717,7 +717,7 @@ defined('T_FN') || define('T_FN', 10001);
717717
<entry><constant>T_PROPERTY_C</constant></entry>
718718
<entry>__PROPERTY__</entry>
719719
<entry>
720-
<link linkend="language.constants.predefined">stałe magiczne</link>
720+
<link linkend="language.constants.magic">stałe magiczne</link>
721721
</entry>
722722
</row>
723723
<row xml:id="constant.t-protected">

‎language/control-structures/include.xml‎

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

55
<sect1 xml:id="function.include" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -80,11 +80,11 @@ echo "Jem $kolor $owoc"; // Jem zielone jabłko
8080
</para>
8181
<simpara>
8282
Jeżeli include występuje wewnątrz funkcji, w pliku dołączającym,
83-
to cały kod zawarty w dołączanym pliku będzie się zachowywał jakby
83+
to cały kod zawarty w dołączanym pliku będzie się zachowywał tak, jakby
8484
był zdefiniowany wewnątrz tej funkcji. Otrzyma więc zasięg zmiennych
8585
tej funkcji. Wyjątkiem od tej reguły są <link
86-
linkend="language.constants.predefined">stałe magiczne</link>, które są
87-
wykonywane przez parser zanim plik zostanie dołączony.
86+
linkend="language.constants.magic">stałe magiczne</link>, które są
87+
wykonywane przez parser, zanim plik zostanie dołączony.
8888
</simpara>
8989
<para>
9090
<example>

‎language/oop5/constants.xml‎

Lines changed: 49 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: 7ddc30e0d2087d75b8f50da40668f4e422c6a4c5 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 922b4b5aeb327d78ea1bb4b932e5db2e9a03ffc5 Maintainer: sobak Status: ready -->
33
<sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook">
44
<title>Stałe w klasach</title>
55
<para>
@@ -28,6 +28,12 @@
2828
Stałe w klasach są alokowane raz na klasę, a nie raz dla każdej
2929
z instancji klasy.
3030
</para>
31+
<para>
32+
Od PHP 8.3.0 stałe w klasach mogą mieć typ skalarny, taki jak <literal>bool</literal>,
33+
<literal>int</literal>, <literal>float</literal>, <literal>string</literal> lub nawet
34+
<literal>array</literal>. Gdy użyty jest typ <literal>array</literal>, zawartością tablicy
35+
mogą być tylko inne typy skalarne.
36+
</para>
3137
<example>
3238
<title>Ustawienie i użycie stałej</title>
3339
<programlisting role="php">
@@ -174,6 +180,48 @@ echo Foo::{$name}, PHP_EOL; // bar
174180
zmiennej.
175181
</para>
176182
</note>
183+
<example>
184+
<title>Przypisywanie typów do stałych w klasach (od PHP 8.3.0)</title>
185+
<programlisting role="php">
186+
<![CDATA[
187+
<?php
188+
189+
class MyClass {
190+
public const bool MY_BOOL = true;
191+
public const int MY_INT = 1;
192+
public const float MY_FLOAT = 1.01;
193+
public const string MY_STRING = 'one';
194+
public const array MY_ARRAY = [self::MY_BOOL, self::MY_INT, self::MY_FLOAT, self::MY_STRING];
195+
}
196+
197+
var_dump(MyClass::MY_BOOL);
198+
var_dump(MyClass::MY_INT);
199+
var_dump(MyClass::MY_FLOAT);
200+
var_dump(MyClass::MY_STRING);
201+
var_dump(MyClass::MY_ARRAY);
202+
?>
203+
]]>
204+
</programlisting>
205+
&example.outputs.83;
206+
<screen>
207+
<![CDATA[
208+
bool(true)
209+
int(1)
210+
float(1.01)
211+
string(3) "one"
212+
array(4) {
213+
[0]=>
214+
bool(true)
215+
[1]=>
216+
int(1)
217+
[2]=>
218+
float(1.01)
219+
[3]=>
220+
string(3) "one"
221+
}
222+
]]>
223+
</screen>
224+
</example>
177225
</sect1>
178226
<!-- Keep this comment at the end of the file
179227
Local variables:

‎language/predefined/variables/server.xml‎

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

55
<refentry role="variable" xml:id="reserved.variables.server" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -50,7 +50,7 @@
5050
<varname>$_SERVER['PHP_SELF']</varname> w skrypcie pod
5151
addresem <filename>http://example.com/foo/bar.php</filename>
5252
będzue ustawiona na <filename>/foo/bar.php</filename>.
53-
Stała <link linkend="language.constants.predefined">__FILE__</link>
53+
Stała <link linkend="language.constants.magic">__FILE__</link>
5454
zawiera pełną ścieżkę i nazwę pliku aktualnego (np.
5555
dołączonego) pliku.
5656
</simpara>
@@ -345,7 +345,7 @@
345345
<simpara>
346346
Zawiera ścieżkę do obecnego skryptu. Jest to użyteczne na stronach,
347347
które muszą odwoływać się do samych siebie.
348-
Stała <link linkend="language.constants.predefined">__FILE__</link>
348+
Stała <link linkend="language.constants.magic">__FILE__</link>
349349
zawiera pełną ścieżkę i nazwę pliku aktualnego (np.
350350
dołączonego) pliku.
351351
</simpara>

‎reference/misc/functions/define.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: e52b5c7312891f4728a2000583b7861a505b7ec9 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: a124543dd3f6b1e5567b07420d23899e582514dc Maintainer: sobak Status: ready -->
33
<!-- CREDITS: grzesiek -->
44
<refentry xml:id="function.define" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
@@ -159,7 +159,7 @@ echo ZWIERZETA[1]; // wyświetli "kot"
159159
<para>
160160
Ten przykład ilustruje <emphasis>możliwość</emphasis> zdefiniowania
161161
stałej o tej samej nazwie, co
162-
<link linkend="language.constants.predefined">stała magiczna</link>.
162+
<link linkend="language.constants.magic">stała magiczna</link>.
163163
Ponieważ wynikające z tego zachowanie jest oczywiście mylące,
164164
nie zaleca się robienia tego w praktyce.
165165
</para>

‎reference/random/functions/mt-rand.xml‎

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 0b6c76516a299395a3703e6df44f8ea4cb4549a8 Maintainer: qrak Status: ready -->
2+
<!-- EN-Revision: 0a5e7b12546b62a611a0cbc7105e617ab96fbcbd Maintainer: qrak Status: ready -->
33
<!-- $Revision$ -->
44
<refentry xml:id="function.mt-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -64,10 +64,20 @@
6464
&reftitle.returnvalues;
6565
<para>
6666
Losowa liczba całkowita pomiędzy <parameter>min</parameter> (lub 0)
67-
a <parameter>max</parameter> (lub <function>mt_getrandmax</function> włącznie),
68-
lub &false; jeśli <parameter>max</parameter> wynosi mniej niż <parameter>min</parameter>.
67+
a <parameter>max</parameter> (lub <function>mt_getrandmax</function> włącznie).
6968
</para>
7069
</refsect1>
70+
<refsect1 role="errors">
71+
&reftitle.errors;
72+
<itemizedlist>
73+
<listitem>
74+
<simpara>
75+
Jeżeli wartość <parameter>max</parameter> jest mniejsza niż <parameter>min</parameter>, to
76+
rzucony zostanie <classname>ValueError</classname>.
77+
</simpara>
78+
</listitem>
79+
</itemizedlist>
80+
</refsect1>
7181
<refsect1 role="changelog">
7282
&reftitle.changelog;
7383
<para>
@@ -80,6 +90,13 @@
8090
</row>
8191
</thead>
8292
<tbody>
93+
<row>
94+
<entry>8.0.0</entry>
95+
<entry>
96+
Błąd <classname>ValueError</classname> zostanie rzucony, jeśli wartość <parameter>max</parameter> jest mniejsza niż <parameter>min</parameter>;
97+
wcześniej zgłaszany był błąd <constant>E_WARNING</constant> a funkcja zwracała &false;.
98+
</entry>
99+
</row>
83100
<row>
84101
<entry>7.2.0</entry>
85102
<entry>

‎reference/reflection/reflectionclass/setstaticpropertyvalue.xml‎

Lines changed: 36 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: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: c4aabaa0b97ef1ecc00cf2cd539ea186c6a855ae Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44
<refentry xml:id="reflectionclass.setstaticpropertyvalue" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>ReflectionClass::setStaticPropertyValue</refname>
7-
<refpurpose>Ustawia wartość właściwości statycznej</refpurpose>
7+
<refpurpose>Ustawia wartość publicznej właściwości statycznej</refpurpose>
88
</refnamediv>
99

1010
<refsect1 role="description">
@@ -15,8 +15,16 @@
1515
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
1616
</methodsynopsis>
1717
<para>
18-
Ustawia wartość właściwości statycznej.
18+
1919
</para>
20+
<simpara>
21+
Ustawia wartość publicznej właściwości statycznej.
22+
Jeżeli właściwość jest prywatna lub protected, metoda zwróci błąd.
23+
</simpara>
24+
<simpara>
25+
<methodname>ReflectionProperty::setValue</methodname> pozwala na
26+
ustawienie wartości właściwości publicznej, prywatnej i protected.
27+
</simpara>
2028
</refsect1>
2129

2230
<refsect1 role="parameters">
@@ -50,11 +58,36 @@
5058
</para>
5159
</refsect1>
5260

61+
<refsect1 role="changelog">
62+
&reftitle.changelog;
63+
<informaltable>
64+
<tgroup cols="2">
65+
<thead>
66+
<row>
67+
<entry>&Version;</entry>
68+
<entry>&Description;</entry>
69+
</row>
70+
</thead>
71+
<tbody>
72+
<row>
73+
<entry>7.4.0</entry>
74+
<entry>
75+
Użycie <methodname>ReflectionClass::setStaticPropertyValue</methodname>, aby
76+
ustawić właściwość prywatną lub protected skutkuje teraz błędem krytycznym. Wcześniej
77+
powodowało to rzucenie <classname>ReflectionException</classname>.
78+
</entry>
79+
</row>
80+
</tbody>
81+
</tgroup>
82+
</informaltable>
83+
</refsect1>
84+
5385
<refsect1 role="seealso">
5486
&reftitle.seealso;
5587
<para>
5688
<simplelist>
5789
<member><methodname>ReflectionClass::getStaticPropertyValue</methodname></member>
90+
<member><methodname>ReflectionProperty::setValue</methodname></member>
5891
</simplelist>
5992
</para>
6093
</refsect1>

‎reference/reflection/reflectionmethod/export.xml‎

Lines changed: 29 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: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: d8c71db13e6862906439f16b3cede5134492c163 Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44

55
<refentry xml:id="reflectionmethod.export" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -64,6 +64,34 @@
6464
</para>
6565
</refsect1>
6666

67+
<refsect1 role="changelog">
68+
&reftitle.changelog;
69+
<informaltable>
70+
<tgroup cols="2">
71+
<thead>
72+
<row>
73+
<entry>&Version;</entry>
74+
<entry>&Description;</entry>
75+
</row>
76+
</thead>
77+
<tbody>
78+
<row>
79+
<entry>8.0.0</entry>
80+
<entry>
81+
&removed.function;
82+
</entry>
83+
</row>
84+
<row>
85+
<entry>7.4.0</entry>
86+
<entry>
87+
&deprecated.function;
88+
</entry>
89+
</row>
90+
</tbody>
91+
</tgroup>
92+
</informaltable>
93+
</refsect1>
94+
6795
<refsect1 role="seealso">
6896
&reftitle.seealso;
6997
<para>

0 commit comments

Comments
 (0)