Skip to content

Commit d3080b3

Browse files
leonardolaraleonardolara
committed
initial translation in reference
1 parent 0dbdcb2 commit d3080b3

File tree

3 files changed

+393
-0
lines changed

3 files changed

+393
-0
lines changed

‎reference/curl/curlsharepersistenthandle.xml

+79
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 01d19a544891db839e36de8316e78f81de56c1ca Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
3+
<reference xml:id="class.curlsharepersistenthandle" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
4+
<title>A classe CurlSharePersistentHandle</title>
5+
<titleabbrev>CurlSharePersistentHandle</titleabbrev>
6+
7+
<partintro>
8+
9+
<!-- {{{ CurlSharePersistentHandle intro -->
10+
<section xml:id="curlsharepersistenthandle.intro">
11+
&reftitle.intro;
12+
<simpara>
13+
Representa um identificador cURL "compartilhado" persistente.
14+
</simpara>
15+
</section>
16+
<!-- }}} -->
17+
18+
<section xml:id="curlsharepersistenthandle.synopsis">
19+
&reftitle.classsynopsis;
20+
21+
<!-- {{{ Synopsis -->
22+
<classsynopsis class="class">
23+
<ooclass>
24+
<modifier>final</modifier>
25+
<classname>CurlSharePersistentHandle</classname>
26+
</ooclass>
27+
28+
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
29+
<fieldsynopsis>
30+
<modifier>public</modifier>
31+
<modifier>readonly</modifier>
32+
<type>array</type>
33+
<varname linkend="curlsharepersistenthandle.props.options">options</varname>
34+
</fieldsynopsis>
35+
</classsynopsis>
36+
<!-- }}} -->
37+
38+
</section>
39+
40+
<!-- {{{ CurlSharePersistentHandle properties -->
41+
<section xml:id="curlsharepersistenthandle.props">
42+
&reftitle.properties;
43+
<variablelist>
44+
<varlistentry xml:id="curlsharepersistenthandle.props.options">
45+
<term><varname>options</varname></term>
46+
<listitem>
47+
<simpara>Os caches <constant>CURL_LOCK_DATA_<replaceable>*</replaceable></constant> compartilhados entre requisições que usam este identificador.</simpara>
48+
</listitem>
49+
</varlistentry>
50+
</variablelist>
51+
</section>
52+
<!-- }}} -->
53+
54+
55+
</partintro>
56+
57+
<!-- &reference.curl.entities.curlsharepersistenthandle; -->
58+
59+
</reference>
60+
<!-- Keep this comment at the end of the file
61+
Local variables:
62+
mode: sgml
63+
sgml-omittag:t
64+
sgml-shorttag:t
65+
sgml-minimize-attributes:nil
66+
sgml-always-quote-attributes:t
67+
sgml-indent-step:1
68+
sgml-indent-data:t
69+
indent-tabs-mode:nil
70+
sgml-parent-document:nil
71+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
72+
sgml-exposed-tags:nil
73+
sgml-local-catalogs:nil
74+
sgml-local-ecat-files:nil
75+
End:
76+
vim600: syn=xml fen fdm=syntax fdl=2 si
77+
vim: et tw=78 syn=sgml
78+
vi: ts=1 sw=1
79+
-->

‎reference/curl/functions/curl-share-init-persistent.xml

+154
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 01d19a544891db839e36de8316e78f81de56c1ca Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2+
<refentry xml:id="function.curl-share-init-persistent" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
3+
<refnamediv>
4+
<refname>curl_share_init_persistent</refname>
5+
<refpurpose>Inicializa um identificador compartilhado cURL <emphasis role="bold">persistente</emphasis></refpurpose>
6+
</refnamediv>
7+
8+
<refsect1 role="description">
9+
&reftitle.description;
10+
<methodsynopsis>
11+
<type>CurlSharePersistentHandle</type><methodname>curl_share_init_persistent</methodname>
12+
<methodparam><type>array</type><parameter>share_options</parameter></methodparam>
13+
</methodsynopsis>
14+
<simpara>
15+
Inicializa um identificador compartilhado cURL <emphasis role="bold">persistente</emphasis>
16+
com as opções de compartilhamento informadas. Diferente de <function>curl_share_init</function>,
17+
os identificadores criados por esta função não serão destruídos ao final da
18+
requisição PHP. Se um identificador compartilhado persistente com o mesmo conjunto de
19+
<parameter>share_options</parameter> for encontrado, ele será reutilizado.
20+
</simpara>
21+
</refsect1>
22+
23+
<refsect1 role="parameters">
24+
&reftitle.parameters;
25+
26+
<variablelist>
27+
<varlistentry>
28+
<term><parameter>share_options</parameter></term>
29+
<listitem>
30+
<simpara>
31+
Um array não vazio de constantes <constant>CURL_LOCK_DATA_<replaceable>*</replaceable></constant>.
32+
</simpara>
33+
<note>
34+
<simpara>
35+
<constant>CURL_LOCK_DATA_COOKIE</constant>
36+
não é permitida e, se utilizada, esta função lançará uma exceção
37+
<exceptionname>ValueError</exceptionname>. Compartilhar cookies entre requisições
38+
PHP pode levar a uma mistura inadvertida de cookies sensíveis entre usuários.
39+
</simpara>
40+
</note>
41+
</listitem>
42+
</varlistentry>
43+
</variablelist>
44+
45+
</refsect1>
46+
47+
<refsect1 role="returnvalues">
48+
&reftitle.returnvalues;
49+
<simpara>
50+
Retorna um objeto <classname>CurlSharePersistentHandle</classname>.
51+
</simpara>
52+
</refsect1>
53+
54+
<refsect1 role="errors">
55+
&reftitle.errors;
56+
<itemizedlist>
57+
<listitem>
58+
<simpara>
59+
Se <parameter>share_options</parameter> estiver vazio, esta função lança uma
60+
exceção <exceptionname>ValueError</exceptionname>.
61+
</simpara>
62+
</listitem>
63+
<listitem>
64+
<simpara>
65+
Se <parameter>share_options</parameter> contiver um valor que não corresponde
66+
a uma constante <constant>CURL_LOCK_DATA_<replaceable>*</replaceable></constant>,
67+
esta função lança uma exceção <classname>ValueError</classname>.
68+
</simpara>
69+
</listitem>
70+
<listitem>
71+
<simpara>
72+
Se <parameter>share_options</parameter> contiver
73+
<constant>CURL_LOCK_DATA_COOKIE</constant>, esta função lança uma exceção
74+
<exceptionname>ValueError</exceptionname>.
75+
</simpara>
76+
</listitem>
77+
<listitem>
78+
<simpara>
79+
Se <parameter>share_options</parameter> contiver um valor não inteiro,
80+
esta função lança uma exceção <exceptionname>TypeError</exceptionname>.
81+
</simpara>
82+
</listitem>
83+
</itemizedlist>
84+
</refsect1>
85+
86+
<refsect1 role="examples">
87+
&reftitle.examples;
88+
<example xml:id="function.curl-share-init-persistent.example.basic">
89+
<title>Exemplo de <function>curl_share_init_persistent</function></title>
90+
<simpara>
91+
Este exemplo criará um identificador de compartilhamento cURL persistente e demonstrará
92+
conexões compartilhadas entre si. Se isso for executado em um PHP SAPI
93+
de longa duração, <literal>$sh</literal> sobreviverá entre as requisições SAPI.
94+
</simpara>
95+
96+
<programlisting role="php">
97+
<![CDATA[
98+
<?php
99+
// Cria ou recupera um identificador de compartilhamento cURL persistente definido para compartilhar pesquisas e conexões de DNS.
100+
$sh = curl_share_init([CURL_LOCK_DATA_DNS, CURL_LOCK_DATA_CONNECT]);
101+
102+
// Inicializa o primeiro identificador cURL e atribui a ele o identificador de compartilhamento.
103+
$ch1 = curl_init("http://example.com/");
104+
curl_setopt($ch1, CURLOPT_SHARE, $sh);
105+
106+
// Executa o primeiro identificador cURL. Isto pode reutilizar a conexão de uma solicitação SAPI anterior.
107+
curl_exec($ch1);
108+
109+
// Inicializa o segundo identificador cURL e atribui o identificador de compartilhamento a ele.
110+
$ch2 = curl_init("http://example.com/");
111+
curl_setopt($ch2, CURLOPT_SHARE, $sh);
112+
113+
// Executa o segundo identificador cURL. Isso reutilizará a conexão de $ch1.
114+
curl_exec($ch2);
115+
116+
// Fecha os identificadores cURL
117+
curl_close($ch1);
118+
curl_close($ch2);
119+
?>
120+
121+
]]>
122+
</programlisting>
123+
</example>
124+
</refsect1>
125+
126+
<refsect1 role="seealso">
127+
&reftitle.seealso;
128+
<simplelist>
129+
<member><function>curl_setopt</function></member>
130+
<member><function>curl_share_init</function></member>
131+
</simplelist>
132+
</refsect1>
133+
134+
</refentry>
135+
<!-- Keep this comment at the end of the file
136+
Local variables:
137+
mode: sgml
138+
sgml-omittag:t
139+
sgml-shorttag:t
140+
sgml-minimize-attributes:nil
141+
sgml-always-quote-attributes:t
142+
sgml-indent-step:1
143+
sgml-indent-data:t
144+
indent-tabs-mode:nil
145+
sgml-parent-document:nil
146+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
147+
sgml-exposed-tags:nil
148+
sgml-local-catalogs:nil
149+
sgml-local-ecat-files:nil
150+
End:
151+
vim600: syn=xml fen fdm=syntax fdl=2 si
152+
vim: et tw=78 syn=sgml
153+
vi: ts=1 sw=1
154+
-->

‎reference/dom/domxpath/registerphpfunctionns.xml

+160
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,160 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 01904e809eaf0aa60e7ce0524400ddd5681c9541 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
3+
<refentry xml:id="domxpath.registerphpfunctionns" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
4+
<refnamediv>
5+
<refname>DOMXPath::registerPhpFunctionNS</refname>
6+
<refpurpose>Registra uma função PHP como função XPath com namespace</refpurpose>
7+
</refnamediv>
8+
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis role="DOMXPath">
12+
<modifier>public</modifier> <type>void</type><methodname>DOMXPath::registerPhpFunctionNS</methodname>
13+
<methodparam><type>string</type><parameter>namespaceURI</parameter></methodparam>
14+
<methodparam><type>string</type><parameter>name</parameter></methodparam>
15+
<methodparam><type>callable</type><parameter>callable</parameter></methodparam>
16+
</methodsynopsis>
17+
<simpara>
18+
Este método permite usar uma função PHP como uma função XPath com namespace
19+
dentro de expressões XPath.
20+
</simpara>
21+
22+
</refsect1>
23+
24+
<refsect1 role="parameters">
25+
&reftitle.parameters;
26+
<variablelist>
27+
<varlistentry>
28+
<term><parameter>namespaceURI</parameter></term>
29+
<listitem>
30+
<simpara>
31+
O URI do namespace.
32+
</simpara>
33+
</listitem>
34+
</varlistentry>
35+
<varlistentry>
36+
<term><parameter>name</parameter></term>
37+
<listitem>
38+
<simpara>
39+
O nome da função local dentro do namespace.
40+
</simpara>
41+
</listitem>
42+
</varlistentry>
43+
<varlistentry>
44+
<term><parameter>callable</parameter></term>
45+
<listitem>
46+
<simpara>
47+
A função PHP a ser chamada quando a função XPath é chamada dentro da expressão XPath.
48+
Quando uma lista de nós é passada como parâmetro para a função de retorno,
49+
eles são arrays contendo os nós DOM correspondentes.
50+
</simpara>
51+
</listitem>
52+
</varlistentry>
53+
</variablelist>
54+
</refsect1>
55+
56+
<xi:include xpointer="domxpath.registerphpfunctions..errors" />
57+
58+
<refsect1 role="returnvalues">
59+
&reftitle.returnvalues;
60+
<simpara>
61+
&return.void;
62+
</simpara>
63+
</refsect1>
64+
65+
<refsect1 role="examples">
66+
&reftitle.examples;
67+
<example>
68+
<title>Registra uma função XPath com namespace e a chama a partir da expressão XPath</title>
69+
<programlisting role="php">
70+
<![CDATA[
71+
<?php
72+
$xml = <<<EOB
73+
<books>
74+
<book>
75+
<title>PHP Basics</title>
76+
<author>Jim Smith</author>
77+
<author>Jane Smith</author>
78+
</book>
79+
<book>
80+
<title>PHP Secrets</title>
81+
<author>Jenny Smythe</author>
82+
</book>
83+
<book>
84+
<title>XML basics</title>
85+
<author>Joe Black</author>
86+
</book>
87+
</books>
88+
EOB;
89+
90+
$doc = new DOMDocument;
91+
$doc->loadXML($xml);
92+
93+
$xpath = new DOMXPath($doc);
94+
95+
// Registra o namespace my: (obrigatório)
96+
$xpath->registerNamespace("my", "urn:my.ns");
97+
98+
// Registra funções PHP (sem restrições)
99+
$xpath->registerPHPFunctionNS(
100+
'urn:my.ns',
101+
'substring',
102+
fn (array $arg1, int $start, int $length) => substr($arg1[0]->textContent, $start, $length)
103+
);
104+
105+
// Chama a função substr no título do livro
106+
$nodes = $xpath->query('//book[my:substring(title, 0, 3) = "PHP"]');
107+
108+
echo "Encontrados {$nodes->length} livros iniciando com 'PHP':\n";
109+
foreach ($nodes as $node) {
110+
$title = $node->getElementsByTagName("title")->item(0)->nodeValue;
111+
$author = $node->getElementsByTagName("author")->item(0)->nodeValue;
112+
echo "$title por $author\n";
113+
}
114+
115+
?>
116+
]]>
117+
</programlisting>
118+
&example.outputs.similar;
119+
<screen>
120+
<![CDATA[
121+
Encontrados 2 livros iniciando com 'PHP':
122+
PHP Basics por Jim Smith
123+
PHP Secrets por Jenny Smythe
124+
]]>
125+
</screen>
126+
</example>
127+
</refsect1>
128+
129+
<refsect1 role="seealso">
130+
&reftitle.seealso;
131+
<simplelist>
132+
<member><methodname>DOMXPath::registerNamespace</methodname></member>
133+
<member><methodname>DOMXPath::query</methodname></member>
134+
<member><methodname>DOMXPath::evaluate</methodname></member>
135+
<member><methodname>XSLTProcessor::registerPHPFunctions</methodname></member>
136+
<member><methodname>XSLTProcessor::registerPHPFunctionNS</methodname></member>
137+
</simplelist>
138+
</refsect1>
139+
140+
</refentry>
141+
<!-- Keep this comment at the end of the file
142+
Local variables:
143+
mode: sgml
144+
sgml-omittag:t
145+
sgml-shorttag:t
146+
sgml-minimize-attributes:nil
147+
sgml-always-quote-attributes:t
148+
sgml-indent-step:1
149+
sgml-indent-data:t
150+
indent-tabs-mode:nil
151+
sgml-parent-document:nil
152+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
153+
sgml-exposed-tags:nil
154+
sgml-local-catalogs:nil
155+
sgml-local-ecat-files:nil
156+
End:
157+
vim600: syn=xml fen fdm=syntax fdl=2 si
158+
vim: et tw=78 syn=sgml
159+
vi: ts=1 sw=1
160+
-->

0 commit comments

Comments
 (0)