sync with en rev

This commit is contained in:
Leonardo Lara Rodrigues
2025-10-22 08:47:05 -03:00
parent b8e6f6b888
commit 1f73796766
3 changed files with 56 additions and 43 deletions

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 37280533a76693adac626a37ffc8daa2276400ce Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: f309e78f9439ae5d063a284cefb4b375233aa785 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<appendix xml:id="soap.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
&extension.constants;
@@ -140,7 +140,8 @@
Especifica o uso de um cabeçalho "Accept-Encoding"
quando aprovado como parte da
<link linkend="soapclient.construct.options.compression">
opção <parameter>compression</parameter></link>
opção <parameter>compression</parameter>
</link>
para <methodname>SoapClient::__construct</methodname>.
</entry>
</row>
@@ -154,7 +155,8 @@
Especifica o uso da compactação gzip
quando aprovado como parte da
<link linkend="soapclient.construct.options.compression">
opção <parameter>compression</parameter></link>
opção <parameter>compression</parameter>
</link>
para <methodname>SoapClient::__construct</methodname>.
</entry>
</row>
@@ -168,7 +170,8 @@
Especifica o uso da compactação deflacionada
quando aprovado como parte da
<link linkend="soapclient.construct.options.compression">
opção <parameter>compression</parameter></link>
opção <parameter>compression</parameter>
</link>
para <methodname>SoapClient::__construct</methodname>.
</entry>
</row>
@@ -205,7 +208,8 @@
<entry>
Usado com a descontinuada
<link linkend="soapclient.construct.options.ssl-method">
opção <parameter>ssl_method</parameter></link>
opção <parameter>ssl_method</parameter>
</link>
para <methodname>SoapClient::__construct</methodname>.
</entry>
</row>
@@ -218,7 +222,8 @@
<entry>
Usado com a descontinuada
<link linkend="soapclient.construct.options.ssl-method">
opção <parameter>ssl_method</parameter></link>
opção <parameter>ssl_method</parameter>
</link>
para <methodname>SoapClient::__construct</methodname>.
</entry>
</row>
@@ -231,7 +236,8 @@
<entry>
Usado com a descontinuada
<link linkend="soapclient.construct.options.ssl-method">
opção <parameter>ssl_method</parameter></link>
opção <parameter>ssl_method</parameter>
</link>
para <methodname>SoapClient::__construct</methodname>.
</entry>
</row>
@@ -244,7 +250,8 @@
<entry>
Usado com a descontinuada
<link linkend="soapclient.construct.options.ssl-method">
opção <parameter>ssl_method</parameter></link>
opção <parameter>ssl_method</parameter>
</link>
para <methodname>SoapClient::__construct</methodname>.
</entry>
</row>
@@ -681,7 +688,8 @@
<entry>
Usado com a opção
<link linkend="soapclient.construct.options.features">
<parameter>features</parameter></link>
<parameter>features</parameter>
</link>
para <methodname>SoapClient::__construct</methodname>.
</entry>
</row>
@@ -694,7 +702,8 @@
<entry>
Usado com a opção
<link linkend="soapclient.construct.options.features">
<parameter>features</parameter></link>
<parameter>features</parameter>
</link>
para <methodname>SoapClient::__construct</methodname>.
</entry>
</row>
@@ -707,7 +716,8 @@
<entry>
Usado com a opção
<link linkend="soapclient.construct.options.features">
<parameter>features</parameter></link>
<parameter>features</parameter>
</link>
para <methodname>SoapClient::__construct</methodname>.
</entry>
</row>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<!-- EN-Revision: f309e78f9439ae5d063a284cefb4b375233aa785 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<refentry xml:id="soapclient.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SoapClient::__construct</refname>
@@ -26,7 +26,7 @@
<term><parameter>wsdl</parameter></term>
<listitem>
<para>
URI de um arquivo WSDL que descreve o serviço, que é usado para
URI de um arquivo <acronym>WSDL</acronym> que descreve o serviço, que é usado para
configurar o cliente. Se não for fornecido, o cliente operará em modo
não WSDL.
</para>
@@ -57,12 +57,12 @@
</term>
<listitem>
<para>
A URL do servidor SOAP para o qual enviar a solicitação.
A URL do servidor SOAP para o qual a solicitação será enviada.
</para>
<para>
Obrigatório se o parâmetro <parameter>wsdl</parameter> não for fornecido.
Se ambos o parâmetro <parameter>wsdl</parameter> e a
opção <literal>location</literal> são fornecidas, a
opção <literal>location</literal> são fornecidos, a
opção <literal>location</literal> substituirá qualquer local
especificado no arquivo WSDL.
</para>
@@ -92,9 +92,9 @@
<para>
Especifica o estilo de ligação a ser usado para este cliente, usando as constantes
<constant>SOAP_RPC</constant> e <constant>SOAP_DOCUMENT</constant>.
<constant>SOAP_RPC</constant> indica ligação no estilo RPC, onde o
<constant>SOAP_RPC</constant> indica ligação no estilo "RPC", onde o
corpo da solicitação SOAP contém uma codificação padrão de uma chamada de função.
<constant>SOAP_DOCUMENT</constant> indica vinculação no estilo do documento,
<constant>SOAP_DOCUMENT</constant> indica vinculação no estilo documento,
onde o corpo da solicitação SOAP contém um documento XML com
significado definido pelo serviço.
</para>
@@ -104,7 +104,7 @@
</para>
<para>
Se nem esta opção nem o parâmetro <parameter>wsdl</parameter>
for fornecido, o estilo RPC é usado.
forem fornecidos, o estilo "RPC" é usado.
</para>
</listitem>
</varlistentry>
@@ -118,7 +118,7 @@
Especifica o estilo de codificação a ser usado para este cliente, usando as
constantes <constant>SOAP_ENCODED</constant> ou <constant>SOAP_LITERAL</constant>.
<constant>SOAP_ENCODED</constant> indica codificação usando os tipos
definido na especificação SOAP.
definidos na especificação SOAP.
<constant>SOAP_LITERAL</constant> indica codificação usando um esquema
definido pelo serviço.
</para>
@@ -128,7 +128,7 @@
</para>
<para>
Se nem esta opção nem o parâmetro <parameter>wsdl</parameter>
é fornecido, o estilo "codificado" é usado.
forem fornecidos, o estilo "encoded" é usado.
</para>
</listitem>
</varlistentry>
@@ -156,7 +156,7 @@
<listitem>
<para>
Especifica o método de autenticação ao usar a autenticação HTTP
em solicitações. O valor pode ser tanto
em solicitações. O valor pode ser
<constant>SOAP_AUTHENTICATION_BASIC</constant>
ou <constant>SOAP_AUTHENTICATION_DIGEST</constant>.
</para>
@@ -200,8 +200,8 @@
<listitem>
<para>
Caminho para um certificado de cliente para uso com autenticação HTTPS.
Deve ser um arquivo codificado em <acronym>PEM</acronym> que contém seu certificado
e chave privada.
Deve ser um arquivo codificado em <acronym>PEM</acronym> que contém o certificado
e a chave privada.
</para>
<para>
O arquivo também pode incluir uma cadeia de emissores, que deve vir
@@ -227,7 +227,7 @@
</para>
<para>
Não deve ser confundido com <literal>password</literal>,
que é usado para autenticação sica ou resumida.
que é usado para autenticação Basic ou Digest.
</para>
<para>
Também pode ser definido via
@@ -298,9 +298,9 @@
Permite compactação de solicitações e respostas HTTP SOAP.
</para>
<para>
O valor deve ser o bit a bit OR de três partes:
O valor deve ser a operação OR binária de três partes:
um <constant>SOAP_COMPRESSION_ACCEPT</constant> opcional,
para enviar um cabeçalho "Accept-Encoding"; qualquer
para enviar um cabeçalho "Accept-Encoding";
<constant>SOAP_COMPRESSION_GZIP</constant>
ou <constant>SOAP_COMPRESSION_DEFLATE</constant> para indicar
o algoritmo de compressão a ser usado; e um número entre 1 e 9
@@ -352,13 +352,13 @@
Usado para mapear tipos definidos no WSDL para classes PHP.
Deve ser especificado como um <type>array</type> associativo com
nomes do WSDL como chaves e nomes de classes PHP como valores.
Observe que os nomes dos tipos de um elemento não são necessariamente iguais aos
o nome do elemento (tag).
Observe que o nome do tipo de um elemento não é necessariamente igual ao
nome (etiqueta) do elemento.
</para>
<para>
Os nomes de classe fornecidos devem sempre ser totalmente qualificados com qualquer
Os nomes de classe fornecidos devem sempre ser totalmente qualificados com
<link linkend="language.namespaces">namespaces</link>, e nunca
comece com um <literal>\</literal>. A forma correta pode ser
começar com um <literal>\</literal>. A forma correta pode ser
gerada usando
<link linkend="language.oop5.basic.class.class">::class</link>.
</para>
@@ -377,7 +377,7 @@
</term>
<listitem>
<para>
Usado para definir mapeamentos de tipo usando funções de retorno de chamada definidas pelo usuário.
Usado para definir mapeamentos de tipo usando funções de retorno definidas pelo usuário.
Cada mapeamento de tipo deve ser um array com chaves
<literal>type_name</literal> (<type>string</type> especificando o
tipo de elemento XML);
@@ -495,8 +495,8 @@
e <literal>user_agent</literal>.
</para>
<para>
Observe que os seguintes cabeçalhos HTTP são gerados automaticamente ou de outras
opções e será ignorado se especificado na opçãod e contexto <literal>'header'</literal>:
Observe que os seguintes cabeçalhos HTTP são gerados automaticamente ou a partir de outras
opções e serão ignorados se especificados na opção de contexto <literal>'header'</literal>:
<literal>host</literal>, <literal>connection</literal>,
<literal>user-agent</literal>, <literal>content-length</literal>,
<literal>content-type</literal>, <literal>cookie</literal>,
@@ -585,30 +585,30 @@
<para>
Especifica a versão do protocolo SSL ou TLS a ser usada com conexões HTTP
seguras, em vez da negociação padrão.
Especificando <constant>SOAP_SSL_METHOD_SSLv2</constant>
Especificar <constant>SOAP_SSL_METHOD_SSLv2</constant>
ou <constant>SOAP_SSL_METHOD_SSLv3</constant> forçará o uso de SSL 2
ou SSL 3, respectivamente.
Especificar <constant>SOAP_SSL_METHOD_SSLv23</constant> não tem efeito;
a constante existe apenas para compatibilidade com versões anteriores.
A partir do PHP 7.2, especificando <constant>SOAP_SSL_METHOD_TLS</constant>
também não tem efeito; nas versões anteriores, forçava o uso do TLS 1.0.
A partir do PHP 7.2.0, especificar <constant>SOAP_SSL_METHOD_TLS</constant>
também não tem efeito; em versões anteriores, forçava o uso do TLS 1.0.
</para>
<para>
Observe que as versões 2 e 3 do SSL são consideradas inseguras e não podem
ser suportado pela biblioteca OpenSSL instalada.
</para>
<para>
Esta opção está <emphasis>DESCONTINUADA</emphasis> a partir do PHP 8.1.0.
Esta opção está <emphasis role="strong">descontinuada</emphasis> a partir do PHP 8.1.0.
Uma alternativa mais flexível, que permite especificar
versões individuais do TLS, é usar a
<link linkend="soapclient.construct.options.stream-context">
opção <parameter>stream_context</parameter></link> com
o parâmetro de contexto 'crypto_method'.
<example>
<title>Especificando o uso somente do TLS 1.3</title>
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
// Especificando o uso somente do TLS 1.3
$context = stream_context_create([
'ssl' => [
'crypto_method' => STREAM_CRYPTO_METHOD_TLSv1_3_CLIENT
@@ -617,7 +617,7 @@ $context = stream_context_create([
$client = new SoapClient("some.wsdl", ['context' => $context]);
]]>
</programlisting>
</example>
</informalexample>
</para>
</listitem>
</varlistentry>
@@ -638,7 +638,7 @@ $client = new SoapClient("some.wsdl", ['context' => $context]);
</para>
<para>
Uma exceção <classname>SoapFault</classname> será lançada se o
URI <parameter>wsdl</parameter> não pode ser carregado.
URI <parameter>wsdl</parameter> não puder ser carregado.
</para>
</refsect1>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: f4ff30a7a6a555fc825577d2cb877e3a07094d6b Maintainer: leonardolara Status: ready -->
<chapter xml:id="yaf.appconfig" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title xmlns="http://docbook.org/ns/docbook">Configuração de Aplicação</title>
@@ -18,6 +18,7 @@
<programlisting role="php">
<![CDATA[
<?php
$configs = array(
"application" => array(
"directory" => dirname(__FILE__),
@@ -29,7 +30,9 @@ $configs = array(
),
),
);
$app = new Yaf_Application($configs);
?>
]]>
</programlisting>
@@ -39,7 +42,7 @@ $app = new Yaf_Application($configs);
<programlisting role="ini">
<![CDATA[
[yaf]
yaf.directory = APPLICATION_PATH "/appliation"
yaf.directory = APPLICATION_PATH "/application"
yaf.dispatcher.catchException = 0
[product : yaf]