Skip to content

Commit 5e60ba9

Browse files
SobakSobak
committed
Translate more pages from reference/misc/
1 parent 73e3189 commit 5e60ba9

15 files changed

+1732
-0
lines changed

‎reference/misc/functions/halt-compiler.xml‎

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 4411b371d0ba1d5faee06177a473f928716c2921 Maintainer: sobak Status: ready -->
3+
<refentry xml:id="function.halt-compiler" xmlns="http://docbook.org/ns/docbook">
4+
<refnamediv>
5+
<refname>__halt_compiler</refname>
6+
<refpurpose>
7+
Zatrzymuje wykonywanie kompilatora
8+
</refpurpose>
9+
</refnamediv>
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis>
13+
<type>void</type><methodname>__halt_compiler</methodname>
14+
<void/>
15+
</methodsynopsis>
16+
<para>
17+
Zatrzymuje wykonywanie kompilatora. Może być to przydatne aby zawrzeć
18+
dane w skryptach PHP, na przykład pliki instalacyjne.
19+
</para>
20+
<para>
21+
Pozycja bajtu początku danych może być określona przy użyciu
22+
stałej <constant>__COMPILER_HALT_OFFSET__</constant>, która jest definiowana
23+
tylko, jeśli w pliku występuje <function>__halt_compiler</function>.
24+
</para>
25+
</refsect1>
26+
27+
<refsect1 role="parameters">
28+
&reftitle.parameters;
29+
&no.function.parameters;
30+
</refsect1>
31+
32+
<refsect1 role="returnvalues">
33+
&reftitle.returnvalues;
34+
<para>
35+
&return.void;
36+
</para>
37+
</refsect1>
38+
39+
<refsect1 role="examples">
40+
&reftitle.examples;
41+
<para>
42+
<example>
43+
<title>Przykład użycia <function>__halt_compiler</function></title>
44+
<programlisting role="php">
45+
<![CDATA[
46+
<?php
47+
48+
// otwórz ten plik
49+
$fp = fopen(__FILE__, 'r');
50+
51+
// przeszukaj wskaźnik pliku, aby znaleźć dane
52+
fseek($fp, __COMPILER_HALT_OFFSET__);
53+
54+
// i wyświetl je
55+
var_dump(stream_get_contents($fp));
56+
57+
// na końcu wykonywania skryptu
58+
__halt_compiler(); dane instalacyjne (np. tar, gz, PHP itd.)
59+
]]>
60+
</programlisting>
61+
</example>
62+
</para>
63+
</refsect1>
64+
65+
<refsect1 role="notes">
66+
&reftitle.notes;
67+
<note>
68+
<para>
69+
<function>__halt_compiler</function> może być użyte tylko z najbardziej zewnętrznego
70+
zakresu.
71+
</para>
72+
</note>
73+
</refsect1>
74+
75+
</refentry>
76+
77+
<!-- Keep this comment at the end of the file
78+
Local variables:
79+
mode: sgml
80+
sgml-omittag:t
81+
sgml-shorttag:t
82+
sgml-minimize-attributes:nil
83+
sgml-always-quote-attributes:t
84+
sgml-indent-step:1
85+
sgml-indent-data:t
86+
indent-tabs-mode:nil
87+
sgml-parent-document:nil
88+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
89+
sgml-exposed-tags:nil
90+
sgml-local-catalogs:nil
91+
sgml-local-ecat-files:nil
92+
End:
93+
vim600: syn=xml fen fdm=syntax fdl=2 si
94+
vim: et tw=78 syn=sgml
95+
vi: ts=1 sw=1
96+
-->

‎reference/misc/functions/highlight-file.xml‎

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 443d81b33e6537a000cc235c2a11748ba8d56232 Maintainer: sobak Status: ready -->
3+
<refentry xml:id="function.highlight-file" xmlns="http://docbook.org/ns/docbook">
4+
<refnamediv>
5+
<refname>highlight_file</refname>
6+
<refpurpose>Koloruje składnię pliku</refpurpose>
7+
</refnamediv>
8+
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis>
12+
<type class="union"><type>string</type><type>bool</type></type><methodname>highlight_file</methodname>
13+
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
14+
<methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>&false;</initializer></methodparam>
15+
</methodsynopsis>
16+
<para>
17+
Wypisuje lub zwraca pokolorowaną wersję kodu zawartą w pliku z parametru
18+
<parameter>filename</parameter>, używając kolorów zdefiniowanych we
19+
wbudowanym mechanizmie podświetlania składni dla PHP.
20+
</para>
21+
<para>
22+
Wiele serwerów jest skonfigurowanych tak, aby automatycznie podświetlać pliki
23+
z rozszerzeniem <emphasis>phps</emphasis>. Na przykład plik
24+
<filename>example.phps</filename> po otwarciu pokaże
25+
podświetlona źródło tego pliku. Aby włączyć takie zachowanie, dodaj
26+
ten kod do &httpd.conf;:
27+
</para>
28+
<screen>
29+
<![CDATA[
30+
AddType application/x-httpd-php-source .phps
31+
]]>
32+
</screen>
33+
</refsect1>
34+
35+
<refsect1 role="parameters">
36+
&reftitle.parameters;
37+
<para>
38+
<variablelist>
39+
<varlistentry>
40+
<term><parameter>filename</parameter></term>
41+
<listitem>
42+
<para>
43+
Ścieżka do pliku PHP, który mieć kolorowaną składnię.
44+
</para>
45+
</listitem>
46+
</varlistentry>
47+
<varlistentry>
48+
<term><parameter>return</parameter></term>
49+
<listitem>
50+
<para>
51+
Ustaw ten parametr na &true; aby ta funkcja zwracała
52+
pokolorowany kod.
53+
</para>
54+
</listitem>
55+
</varlistentry>
56+
</variablelist>
57+
</para>
58+
</refsect1>
59+
60+
<refsect1 role="returnvalues">
61+
&reftitle.returnvalues;
62+
<para>
63+
Jeśli parametr <parameter>return</parameter> jest ustawiony na &true;, to zwraca pokolorowany
64+
kod jako ciąg znaków, zamiast go wyświetlać. W przeciwnym razie zwraca
65+
&true; w wypadku powodzenia lub &false; w razie błędu.
66+
</para>
67+
</refsect1>
68+
69+
<refsect1 role="changelog">
70+
&reftitle.changelog;
71+
<para>
72+
<informaltable>
73+
<tgroup cols="2">
74+
<thead>
75+
<row>
76+
<entry>&Version;</entry>
77+
<entry>&Description;</entry>
78+
</row>
79+
</thead>
80+
<tbody>
81+
<row>
82+
<entry>8.3.0</entry>
83+
<entry>
84+
Wynikowy kod HTML został zmieniony.
85+
</entry>
86+
</row>
87+
</tbody>
88+
</tgroup>
89+
</informaltable>
90+
</para>
91+
</refsect1>
92+
93+
<refsect1 role="notes">
94+
&reftitle.notes;
95+
<caution>
96+
<para>
97+
Powinno się uważać używając funkcji <function>highlight_file</function>,
98+
aby nie ujawnić bezpowrotnie wrażliwych
99+
informacji takich jak hasła lub inne typy danych, które mogą
100+
spowodować zagrożenie bezpieczeństwa.
101+
</para>
102+
</caution>
103+
&note.uses-ob;
104+
</refsect1>
105+
106+
<refsect1 role="seealso">
107+
&reftitle.seealso;
108+
<para>
109+
<simplelist>
110+
<member><function>highlight_string</function></member>
111+
<member><link linkend="ini.syntax-highlighting">Dyrektywy INI powiązane z kolorowaniem składni</link></member>
112+
</simplelist>
113+
</para>
114+
</refsect1>
115+
116+
</refentry>
117+
118+
<!-- Keep this comment at the end of the file
119+
Local variables:
120+
mode: sgml
121+
sgml-omittag:t
122+
sgml-shorttag:t
123+
sgml-minimize-attributes:nil
124+
sgml-always-quote-attributes:t
125+
sgml-indent-step:1
126+
sgml-indent-data:t
127+
indent-tabs-mode:nil
128+
sgml-parent-document:nil
129+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
130+
sgml-exposed-tags:nil
131+
sgml-local-catalogs:nil
132+
sgml-local-ecat-files:nil
133+
End:
134+
vim600: syn=xml fen fdm=syntax fdl=2 si
135+
vim: et tw=78 syn=sgml
136+
vi: ts=1 sw=1
137+
-->

‎reference/misc/functions/highlight-string.xml‎

Lines changed: 156 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,156 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: ba50f222e7108287fb6eb11265c2b28efe0cc0ce Maintainer: sobak Status: ready -->
3+
<refentry xml:id="function.highlight-string" xmlns="http://docbook.org/ns/docbook">
4+
<refnamediv>
5+
<refname>highlight_string</refname>
6+
<refpurpose>Koloruje składnię z ciągu znaków</refpurpose>
7+
</refnamediv>
8+
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis>
12+
<type class="union"><type>string</type><type>true</type></type><methodname>highlight_string</methodname>
13+
<methodparam><type>string</type><parameter>string</parameter></methodparam>
14+
<methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>&false;</initializer></methodparam>
15+
</methodsynopsis>
16+
<simpara>
17+
Wyświetla lub zwraca kod HTML dla pokolorowanej wersji podanego kodu PHP,
18+
używając kolorów zdefiniowanych we wbudowanym mechanizmie podświetlania składni dla PHP.
19+
</simpara>
20+
</refsect1>
21+
22+
<refsect1 role="parameters">
23+
&reftitle.parameters;
24+
<para>
25+
<variablelist>
26+
<varlistentry>
27+
<term><parameter>string</parameter></term>
28+
<listitem>
29+
<para>
30+
Kod PHP, który ma zostać pokolorowany. Powinien on zawierać znacznik otwierający.
31+
</para>
32+
</listitem>
33+
</varlistentry>
34+
<varlistentry>
35+
<term><parameter>return</parameter></term>
36+
<listitem>
37+
<para>
38+
Ustaw ten parametr na &true; aby ta funkcja zwracała
39+
pokolorowany kod.
40+
</para>
41+
</listitem>
42+
</varlistentry>
43+
</variablelist>
44+
</para>
45+
</refsect1>
46+
47+
<refsect1 role="returnvalues">
48+
&reftitle.returnvalues;
49+
<para>
50+
Jeśli parametr <parameter>return</parameter> jest ustawiony na &true;, to zwraca pokolorowany
51+
kod jako ciąg znaków, zamiast go wyświetlać.
52+
W przeciwnym razie zwraca &true;.
53+
</para>
54+
</refsect1>
55+
56+
<refsect1 role="changelog">
57+
&reftitle.changelog;
58+
<para>
59+
<informaltable>
60+
<tgroup cols="2">
61+
<thead>
62+
<row>
63+
<entry>&Version;</entry>
64+
<entry>&Description;</entry>
65+
</row>
66+
</thead>
67+
<tbody>
68+
<row>
69+
<entry>8.4.0</entry>
70+
<entry>
71+
Typ zwracanych danych zmieniony z <type class="union"><type>string</type><type>bool</type></type> na <type class="union"><type>string</type><type>true</type></type>.
72+
</entry>
73+
</row>
74+
<row>
75+
<entry>8.3.0</entry>
76+
<entry>
77+
Wynikowy kod HTML został zmieniony.
78+
</entry>
79+
</row>
80+
</tbody>
81+
</tgroup>
82+
</informaltable>
83+
</para>
84+
</refsect1>
85+
86+
<refsect1 role="examples">
87+
&reftitle.examples;
88+
<para>
89+
<example>
90+
<title>Przykład użycia <function>highlight_string</function></title>
91+
<programlisting role="php">
92+
<![CDATA[
93+
<?php
94+
highlight_string('<?php phpinfo(); ?>');
95+
?>
96+
]]>
97+
</programlisting>
98+
&example.outputs;
99+
<screen>
100+
<![CDATA[
101+
<code><span style="color: #000000">
102+
<span style="color: #0000BB">&lt;?php phpinfo</span><span style="color: #007700">(); </span><span style="color: #0000BB">?&gt;</span>
103+
</span>
104+
</code>
105+
]]>
106+
</screen>
107+
&example.outputs.83;
108+
<screen>
109+
<![CDATA[
110+
<pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php phpinfo</span><span style="color: #007700">(); </span><span style="color: #0000BB">?&gt;</span></code></pre>
111+
]]>
112+
</screen>
113+
</example>
114+
</para>
115+
</refsect1>
116+
117+
<refsect1 role="notes">
118+
&reftitle.notes;
119+
&note.uses-ob;
120+
<para>
121+
Generowany kod HTML może podlegać zmianom.
122+
</para>
123+
</refsect1>
124+
125+
<refsect1 role="seealso">
126+
&reftitle.seealso;
127+
<para>
128+
<simplelist>
129+
<member><function>highlight_file</function></member>
130+
<member><link linkend="ini.syntax-highlighting">Dyrektywy INI powiązane z kolorowaniem składni</link></member>
131+
</simplelist>
132+
</para>
133+
</refsect1>
134+
135+
</refentry>
136+
137+
<!-- Keep this comment at the end of the file
138+
Local variables:
139+
mode: sgml
140+
sgml-omittag:t
141+
sgml-shorttag:t
142+
sgml-minimize-attributes:nil
143+
sgml-always-quote-attributes:t
144+
sgml-indent-step:1
145+
sgml-indent-data:t
146+
indent-tabs-mode:nil
147+
sgml-parent-document:nil
148+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
149+
sgml-exposed-tags:nil
150+
sgml-local-catalogs:nil
151+
sgml-local-ecat-files:nil
152+
End:
153+
vim600: syn=xml fen fdm=syntax fdl=2 si
154+
vim: et tw=78 syn=sgml
155+
vi: ts=1 sw=1
156+
-->

0 commit comments

Comments
 (0)