Contributions are ready for review

From:	doc-pt-br at lists dot php dot net	Date:	Mon, 03 Feb 2014 13:00:01 +0000
Subject:	Contributions are ready for review
Groups:	php.doc.pt-br
Request:	Send a blank email to doc-pt-br+get-4594@lists.php.net to get a copy of this message

Hello PHP PT_BR Documentation team, There are contributions within the online editor queue for this language. Please review, then commit or delete these patches. Patches for review : ----------------------- New file: pt_BR/faq/databases.xml By: thiago on 2010-06-30 12:25:31 =================================================================== --- pt_BR/faq/databases.xml +++ pt_BR/faq/databases.xml @@ -0,0 +1,292 @@ +<?xml version="1.0" encoding="utf-8"?> + + <chapter xml:id="faq.databases" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Questões de Banco de Dados</title> + <titleabbrev>Questões de Banco de Dados</titleabbrev> + + <para> + Esta seção responde algumas perguntas comuns sobre a relação entre + PHP e banco de dados. Sim, o PHP pode acessar virtualmente qualquer banco + de dados disponíveis hoje. + </para> + + <qandaset> + <qandaentry xml:id="faq.databases.mssql"> + <question> + <para> + Ouvi dizer que é possível acessar o Microsoft SQL Server a partir de PHP. + Como? + </para> + </question> + <answer> + <para> + Em máquinas Windows, você pode simplesmente usar o suporte ao driver + ODBC. + </para> + <para> + Em máquinas Unix, você pode usar o Driver Sybase-CT para acessar os + servidores Microsoft SQL, porque eles são (em pelo menos a maioria) + compatível com o protocolo. Sybase fez uma + <link xlink:href="&url.sybase.ctlib;"> versão gratuita do necessário + bibliotecas para sistemas Linux </link> . Para outros sistemas Unix, + você precisa entrar em contato com Sybase para as bibliotecas corretas. + Ver também a resposta para a pergunta seguinte. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.databases.access"> + <question> + <para>Posso acessar bancos de dados Microsoft Access?</para> + </question> + <answer> + <para> + Sim. Você já tem todas as ferramentas que você precisa se você estiver + executando inteiramente sob Windows 9x/Me, ou NT/2000, onde você pode + usar ODBC e drivers da Microsoft ODBC para bancos de dados Microsoft + Access. + </para> + <para> + Se você estiver executando o PHP em uma caixa de Unix e deseja falar + com o MS Access em uma caixa de Windows você vai precisar drivers Unix + ODBC. <link xlink:href="&url.openlink;"> OpenLink Software </link> tem + drivers ODBC que pode fazer isso. + </para> + <para> + Outra alternativa é usar um servidor SQL que tem + ODBC drivers Windows e usá-lo para armazenar os dados, que pode ser + em seguida, acessar a partir do Microsoft Access (usando ODBC) e PHP + (usando o construído em drivers), ou usar um formato de arquivo que o + Access intermediário PHP e ambos entendem, como arquivos flat ou bancos + de dados dBase. + Sobre este ponto Tim Hayes de software OpenLink escreve: + <blockquote> + <para> + Usando um outro banco de dados como um intermediário não é uma boa idéia, + quando você pode usar ODBC do PHP direto para seu banco de dados - ou + seja, com os drivers da OpenLink. Se você precisa usar um formato de + arquivo intermediário, OpenLink já lançado Virtuoso (um mecanismo de + banco de dados virtual) para NT, Linux e outras plataformas Unix. + Por favor, visite nosso <link xlink:href="&url.openlink;"> site </link> + para um download gratuito. + </para> + </blockquote> + </para> + <para> + Uma opção que se revelou bem sucedida é a utilização de MySQL e seus + drivers MyODBC no Windows e sincronizar as bases de dados. Steve Lawrence + escreve: + </para> + <para> + <itemizedlist> + <listitem> + <simpara> + Instale o MySQL em sua plataforma de acordo com as instruções com + o MySQL. Disponível em <link xlink:href="&url.mysql;">&url.mysql;</link> + Nenhuma configuração especial necessária, exceto quando você criar + um banco de dados e configurar o usuário, você deve colocar % no + campo host, ou o nome do host do computador com o Windows que você + deseja acessar com o MySQL . Faça uma nota do seu servidor (nome + do servidor ou ip), nome de usuário e senha. + </simpara> + </listitem> + <listitem> + <simpara> + Baixe o driver MyODBC para Windows a partir do site do MySQL. + Instale-o em sua máquina Windows. Você pode testar a operação com + os utilitários incluídos com esteprograma. + </simpara> + </listitem> + <listitem> + <simpara> + Criar um usuário ou um sistema em seu administrador ODBC, localizada no painel de controle. Torne-se um nome de DSN, digite o nome do host, nome de usuário, senha + porto, etc para o banco de dados MySQL que você configurou na etapa 1. + </simpara> + </listitem> + <listitem> + <simpara> + Instalar Access com uma instalação completa, isto faz com que você começa a boa add-ins ... pelo menos você terá suporte ODBC e gerencia. + </simpara> + </listitem> + <listitem> + <simpara> + Agora a parte divertida! Criar um banco de dados novo acesso. Na tabela + janela com o botão direito e selecione Vincular tabelas, ou em processo (opção no menu), selecione Obter dados externos e, em seguida, em Ligar tabelas. + Quando a caixa de navegador de arquivos aparecer, selecione os arquivos do tipo: ODBC . + Selecione DSN de sistema e o nome do DSN criado no passo 3. + Selecione a tabela de ligação, pressione OK, e pronto! Você pode agora + abra a tabela e adicionar / apagar / editar os dados no servidor MySQL! + Você também pode criar consultas, tabelas de importação / exportação para o MySQL, + construir formulários e relatórios, etc. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Dicas e Truques: + <itemizedlist> + <listitem> + <simpara> + Você pode construir suas tabelas no Access e exportá-los + para o MySQL, em seguida, vinculá-los para trás dentro Isso faz com que a tabela + rápida criação. + </simpara> + </listitem> + <listitem> + <simpara> + Ao criar tabelas no Access, você deve ter uma chave primaria, definiu a fim de ter acesso de gravação para o quadro do + acesso. Certifique-se de criar uma chave primária no MySQL antes de + ligando no acesso + </simpara> + </listitem> + <listitem> + <simpara> + Se você alterar uma tabela no MySQL, você tem que re-ligação é + em Access. Vá em Ferramentas> add-ins> Gerenciador de Tabelas Vinculadas, + cruzeiro no seu ODBC DSN e selecione a tabela de lá. Você também pode mover a sua fonte dsn por lá, + acabou de bater o sempre pronta para a caixa novo local antes de + pressionando OK. + </simpara> + </listitem> + </itemizedlist> + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.databases.mysql.php5"> + <question> + <para> + PHP 5 pacotes não bibliotecas clientes do MySQL, o que significa isso para + me? Posso continuar a usar MySQL com PHP? Eu tento usar MySQL e obter + "função indefinida" erros, o que dá? + </para> + </question> + <answer> + <para> + Sim. Sempre haverá suporte ao MySQL em PHP de um tipo ou + outro. A única mudança no PHP 5 é que já não estamos a agregação + biblioteca do próprio cliente. Algumas razões em nenhuma ordem especial: + </para> + <itemizedlist> + <listitem> + <para> + A maioria dos sistemas estes dias já tem a biblioteca do cliente instalado. + </para> + </listitem> + <listitem> + <para> + Face ao exposto, tendo várias versões da biblioteca pode começar. Por exemplo, se você ligar mod_auth_mysql contra uma versão + e PHP contra o outro, e então permitir que tanto o Apache, você começa a + crash bom gordura. Além disso, a biblioteca embutida nem sempre trabalha bem com a versão do servidor instalado. O sintoma mais evidente deste + desacordo ser sobre onde encontrar o mysql.socket. + </para> + </listitem> + <listitem> + <para> + Manutenção estava um pouco frouxa e ele foi ficando cada vez mais e mais + por trás da versão lançada. + </para> + </listitem> + <listitem> + <para> + Versões + Futuro da biblioteca estão sob a licença GPL e, portanto, nós não + tem um caminho de atualização, uma vez que pode não agregar uma biblioteca GPL em um + BSD / Apache-style projeto licenciado. A ruptura em PHP 5 parecia como a melhor opção. + </para> + </listitem> + </itemizedlist> + <para> + Isso não vai realmente afetar muitas pessoas. usuários do Unix, pelo menos, os que sabem o que estão fazendo, sempre tendem a compilar o PHP contra + biblioteca libmysqlclient seu sistema simplesmente adicionando o <option + role="configure"> --with-mysql=/usr </option> Opção + na construção de PHP. Os usuários do Windows podem permitir a extensão + <filename> php_mysql.dll </filename> dentro do php.ini ;. + Para mais detalhes, consulte a <link linkend="ref.mysql"> Referência do MySQL </link> + Para obter instruções de instalação. Além disso, certifique-se + <filename> libmysql.dll </filename> está disponível no PATH do sistema. + Para mais detalhes sobre como, leia o FAQ sobre + <link linkend="faq.installation.addtopath"> criação do Windows </link> . Porque <filename> libmysql.dll </filename> (E + muitos outros arquivos relacionados ao PHP) existem na pasta PHP, você vai querer + adicione a pasta do PHP no PATH do seu sistema. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.databases.shared-mysql"> + <question> + <para> + Após a instalação compartilhada suporte MySQL, Apache core dumps logo libphp4.so como é carregado. Isso pode ser corrigido? + </para> + </question> + <answer> + <para> + Se o seu libs MySQL estão ligadas contra pthreads isso vai acontecer. Verifique + usando ldd. Se eles estão, pegue o tarball e compilar o MySQL a partir da fonte, + ou recompilar o código de rpm e retire o interruptor no arquivo spec, que liga o código do cliente threaded. Qualquer uma destas sugestões + corrigir isso. Então recompile o PHP com o MySQL libs novas. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.databases.mysqlresource"> + <question> + <para> + Por que eu recebo um erro que é algo como isto: + "Aviso: 0 não é um índice de resultado MySQL em <file> + <x> em linha" ou "Aviso: o argumento fornecido não é um recurso válido do resultado de MySQL em <file> em linha <x> "? + </para> + </question> + <answer> + <para> + Você está tentando usar um identificador de resultado que é 0. A indica 0 + , que a consulta falhou por algum motivo. Você precisa verificar se há erros + após a apresentação de uma consulta e antes de tentar usar o identificador de resultado retornado. A maneira apropriada de fazer isso é com [code similar @] para o seguinte: + <programlisting role="php"> +<![CDATA[ +<?php + +$result = mysql_query("SELECT * FROM tables_priv"); +if (!$result) { + echo mysql_error(); + exit; +} +?> +]]> + </programlisting> + ou + <programlisting role="php"> +<![CDATA[ +<?php + +$result = mysql_query("SELECT * FROM tables_priv") + or die("Bad query: " . mysql_error()); +?> +]]> + </programlisting> + </para> + </answer> + </qandaentry> + </qandaset> + </chapter> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=749 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=749 ------------------------------------------------------------------ New file: pt_BR/reference/solr/solrquery/getmltmaxnumtokens.xml By: admin jefersson on 2013-02-27 08:38:06 =================================================================== --- pt_BR/reference/solr/solrquery/getmltmaxnumtokens.xml +++ pt_BR/reference/solr/solrquery/getmltmaxnumtokens.xml @@ -1,26 +1,24 @@ <?xml version="1.0" encoding="utf-8"?> +  + <refentry xml:id="solrquery.getmltmaxnumtokens" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>SolrQuery::getMltMaxNumTokens</refname> - <refpurpose>Retorna o número máximo de tokens para analisar em cada -campo do documento que não é armazenado com suporte a -TermVectorReturns</refpurpose> + <refpurpose>Retorna o número máximo de tokens para analisar em cada campo do documento que não é armazenado com suporte a TermVectorReturns</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier>public</modifier> -<type>int</type><methodname>SolrQuery::getMltMaxNumTokens</methodname> + <modifier>public</modifier> <type>int</type><methodname>SolrQuery::getMltMaxNumTokens</methodname> <void /> </methodsynopsis> <para> - Retorna o número máximo de tokens para analisar em cada campo do -documento que não é armazenado com suporte a TermVectorReturns + Retorna o número máximo de tokens para analisar em cada campo do documento que não é armazenado com suporte a TermVectorReturns </para> - + </refsect1> <refsect1 role="parameters"> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=45601 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=45601 ------------------------------------------------------------------ New file: pt_BR/reference/solr/book.xml By: admin jefersson on 2013-03-10 15:52:43 =================================================================== --- pt_BR/reference/solr/book.xml +++ pt_BR/reference/solr/book.xml @@ -1,59 +1,56 @@ <?xml version="1.0" encoding="utf-8"?> +  + + -<book xml:id="book.solr" xmlns="http://docbook.org/ns/docbook" -xmlns:xlink="http://www.w3.org/1999/xlink"> +<book xml:id="book.solr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Apache Solr</title> <titleabbrev>Solr</titleabbrev> - + <preface xml:id="intro.solr"> &reftitle.intro; <para> - A extensão Solr, permite comunicar-se de forma eficaz com um servidor -Apache Solr ultilizando o PHP 5. + A extensão Solr, permite comunicar-se de forma eficaz com um servidor Apache Solr ultilizando o PHP 5. </para> - - <para>A extensão Solr é extremamente rápida, leve, rica em recursos de -biblioteca que permite que os desenvolvedores de PHP se comuniquem de forma -eficaz com servidores Solr.</para> + + <para>A extensão Solr é extremamente rápida, leve, rica em recursos de biblioteca que permite que os desenvolvedores de PHP se comuniquem de forma eficaz com servidores Solr.</para> <para>Ele é compatível com as versões 1.3 e 1.4 do Apache Solr.</para> - <para>Ele tem ferramentas para adicionar documentos e fazer atualizações -para o servidor Solr.</para> - <para>Ele também contém ferramentas que lhe permite construir consultas -avançadas para o servidor para buscar documentos.</para> + <para>Ele tem ferramentas para adicionar documentos e fazer atualizações para o servidor Solr.</para> + <para>Ele também contém ferramentas que lhe permite construir consultas avançadas para o servidor para buscar documentos.</para> </preface> - + &reference.solr.setup; &reference.solr.constants; &reference.solr.reference; - + &reference.solr.examples; - + &reference.solr.solrutils; - + &reference.solr.solrinputdocument; &reference.solr.solrdocument; &reference.solr.solrdocumentfield; - + &reference.solr.solrobject; - + &reference.solr.solrclient; - + &reference.solr.solrresponse; &reference.solr.solrqueryresponse; &reference.solr.solrupdateresponse; &reference.solr.solrpingresponse; &reference.solr.solrgenericresponse; - + &reference.solr.solrparams; &reference.solr.solrmodifiableparams; &reference.solr.solrquery; - + &reference.solr.solrexception; &reference.solr.solrclientexception; &reference.solr.solrillegalargumentexception; &reference.solr.solrillegaloperationexception; - + </book>  + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=45602 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=45602 ------------------------------------------------------------------ New file: pt_BR/reference/solr/functions/solr-get-version.xml By: admin jefersson on 2013-04-03 01:51:58 =================================================================== --- pt_BR/reference/solr/functions/solr-get-version.xml +++ pt_BR/reference/solr/functions/solr-get-version.xml @@ -0,0 +1,105 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<refentry xml:id="function.solr-get-version" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>solr_get_version</refname> + <refpurpose>Retorna a versão atual da extensão Apache Solr</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>solr_get_version</methodname> + <void /> + </methodsynopsis> + <para> + Essa função retorna uma string com a versão atual da extensão Solr. + </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + &no.function.parameters; + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; +  + <para> + Retorna uma string, ou &false; se falhar. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + Essa função não lança nenhum erro ou exeções. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>solr_get_version</function> example</title> + <para> + Qualquer texto que descreva a finalidade do exemplo, ou o que se passa no exemplo deve ser aqui.. + </para> + <programlisting role="php"> +<![CDATA[ +<?php + +$solr_version = solr_get_version(); + +print $solr_version; + +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ + +0.9.6 + +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>SolrUtils::getSolrVersion</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=46166 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=46166 ------------------------------------------------------------------ New file: pt_BR/language/predefined/interfaces.xml By: Felipe Ismael Barth on 2013-05-26 18:59:56 =================================================================== --- pt_BR/language/predefined/interfaces.xml +++ pt_BR/language/predefined/interfaces.xml @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<part xml:id="reserved.interfaces" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Interfaces e Classes predefinidas</title> + + <partintro> + <para> + Veja também as <link linkend="spl.interfaces">Interfaces SPL</link> e <link + linkend="reserved.classes">classes reservadas</link>. + </para> + </partintro> + + &language.predefined.traversable; + &language.predefined.iterator; + &language.predefined.iteratoraggregate; + &language.predefined.arrayaccess; + &language.predefined.serializable; + &language.predefined.closure; + &language.predefined.generator; + +</part> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=46978 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=46978 ------------------------------------------------------------------ New file: pt_BR/reference/spl/countable.xml By: Felipe Ismael Barth on 2013-05-27 10:33:36 =================================================================== --- pt_BR/reference/spl/countable.xml +++ pt_BR/reference/spl/countable.xml @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<phpdoc:classref xml:id="class.countable" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> + + <title>Interface Countable</title> + <titleabbrev>Countable</titleabbrev> + + <partintro> + + + <section xml:id="countable.intro"> + &reftitle.intro; + <para> + Classes que implementam <classname>Countable</classname> podem ser usadas com a função + <function>count</function>. + </para> + </section> + + + <section xml:id="countable.synopsis"> + &reftitle.interfacesynopsis; + + + <classsynopsis> + <ooclass><classname>Countable</classname></ooclass> + + + <classsynopsisinfo> + <ooclass> + <classname>Countable</classname> + </ooclass> + </classsynopsisinfo> + + + <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo> + <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.countable')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> + </classsynopsis> + + + </section> + + </partintro> + + &reference.spl.entities.countable; + +</phpdoc:classref> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=46977 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=46977 ------------------------------------------------------------------ New file: pt_BR/reference/json/functions/json-last-error-msg.xml By: Jefersson Nathan on 2013-05-29 02:30:46 =================================================================== => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47105 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47105 ------------------------------------------------------------------ New file: pt_BR/reference/json/functions/json-last-error.xml By: Jefersson Nathan on 2013-05-29 02:40:02 =================================================================== => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47106 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47106 ------------------------------------------------------------------ New file: pt_BR/reference/reflection/book.xml By: Felipe Barth on 2013-06-13 14:52:32 =================================================================== --- pt_BR/reference/reflection/book.xml +++ pt_BR/reference/reflection/book.xml @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<book xml:id="book.reflection" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <?phpdoc extension-membership="core" ?> + <title>Reflexão</title> + <titleabbrev>Reflexão</titleabbrev> + + <preface xml:id="intro.reflection"> + &reftitle.intro; + <para> + PHP 5 vem com uma completa API de reflexão que acrescenta a capacidade de realizar + <literal>engenharia reversa</literal> em classes, interfaces, funções, + métodos e extensões. Além disso, a API de reflexão oferece maneiras de + recuperar comentários de documentação para as funções, classes e métodos. + </para> + <para> + Por favor note que algumas partes da <acronym>API</acronym> + está faltando o código necessário para executar a extensão de reflexão. + Por exemplo, uma classe PHP interna pode estar faltando dados de reflexão para as + propriedades. Estes são poucos casos que são considerados bugs, no entando eles devem + ser descobertos e corrigidos. + </para> + </preface> + + &reference.reflection.setup; + &reference.reflection.constants; + &reference.reflection.examples; + &reference.reflection.extending; + &reference.reflection.reflection; + &reference.reflection.reflectionclass; + &reference.reflection.reflectionzendextension; + &reference.reflection.reflectionextension; + &reference.reflection.reflectionfunction; + &reference.reflection.reflectionfunctionabstract; + &reference.reflection.reflectionmethod; + &reference.reflection.reflectionobject; + &reference.reflection.reflectionparameter; + &reference.reflection.reflectionproperty; + &reference.reflection.reflector; + &reference.reflection.reflectionexception; + +</book> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47226 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47226 ------------------------------------------------------------------ New file: pt_BR/reference/reflection/constants.xml By: Felipe Barth on 2013-06-13 15:39:45 =================================================================== --- pt_BR/reference/reflection/constants.xml +++ pt_BR/reference/reflection/constants.xml @@ -0,0 +1,33 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<appendix xml:id="reflection.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.constants; + <para> + Cada classe descreve suas próprias constantes. + </para> +</appendix> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47228 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47228 ------------------------------------------------------------------ New file: pt_BR/reference/reflection/examples.xml By: Felipe Barth on 2013-06-13 15:45:11 =================================================================== --- pt_BR/reference/reflection/examples.xml +++ pt_BR/reference/reflection/examples.xml @@ -0,0 +1,156 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<chapter xml:id="reflection.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.examples; + <para> + Existem muitos exemplos dentro da documentação Reflexão, tipicamente + dentro da documentação do __construct de cada classe. + </para> + <example> + <title>Exemplo de Reflexão no shell (terminal)</title> + <programlisting role="shell"> +<![CDATA[ +$ php --rf strlen +$ php --rc finfo +$ php --re json +$ php --ri dom +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Function [ <internal:Core> function strlen ] { + + - Parameters [1] { + Parameter #0 [ <required> $str ] + } +} + +Class [ <internal:fileinfo> class finfo ] { + + - Constants [0] { + } + + - Static properties [0] { + } + + - Static methods [0] { + } + + - Properties [0] { + } + + - Methods [4] { + Method [ <internal:fileinfo, ctor> public method finfo ] { + + - Parameters [2] { + Parameter #0 [ <optional> $options ] + Parameter #1 [ <optional> $arg ] + } + } + + Method [ <internal:fileinfo> public method set_flags ] { + + - Parameters [1] { + Parameter #0 [ <required> $options ] + } + } + + Method [ <internal:fileinfo> public method file ] { + + - Parameters [3] { + Parameter #0 [ <required> $filename ] + Parameter #1 [ <optional> $options ] + Parameter #2 [ <optional> $context ] + } + } + + Method [ <internal:fileinfo> public method buffer ] { + + - Parameters [3] { + Parameter #0 [ <required> $string ] + Parameter #1 [ <optional> $options ] + Parameter #2 [ <optional> $context ] + } + } + } +} + +Extension [ <persistent> extension #23 json version 1.2.1 ] { + + - Constants [10] { + Constant [ integer JSON_HEX_TAG ] { 1 } + Constant [ integer JSON_HEX_AMP ] { 2 } + Constant [ integer JSON_HEX_APOS ] { 4 } + Constant [ integer JSON_HEX_QUOT ] { 8 } + Constant [ integer JSON_FORCE_OBJECT ] { 16 } + Constant [ integer JSON_ERROR_NONE ] { 0 } + Constant [ integer JSON_ERROR_DEPTH ] { 1 } + Constant [ integer JSON_ERROR_STATE_MISMATCH ] { 2 } + Constant [ integer JSON_ERROR_CTRL_CHAR ] { 3 } + Constant [ integer JSON_ERROR_SYNTAX ] { 4 } + } + + - Functions { + Function [ <internal:json> function json_encode ] { + + - Parameters [2] { + Parameter #0 [ <required> $value ] + Parameter #1 [ <optional> $options ] + } + } + Function [ <internal:json> function json_decode ] { + + - Parameters [3] { + Parameter #0 [ <required> $json ] + Parameter #1 [ <optional> $assoc ] + Parameter #2 [ <optional> $depth ] + } + } + Function [ <internal:json> function json_last_error ] { + + - Parameters [0] { + } + } + } +} + +dom + +DOM/XML => enabled +DOM/XML API Version => 20031129 +libxml Version => 2.7.3 +HTML Support => enabled +XPath Support => enabled +XPointer Support => enabled +Schema Support => enabled +RelaxNG Support => enabled +]]> + </screen> + </example> +</chapter> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47229 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47229 ------------------------------------------------------------------ New file: pt_BR/reference/reflection/configure.xml By: Felipe Barth on 2013-06-13 16:06:58 =================================================================== --- pt_BR/reference/reflection/configure.xml +++ pt_BR/reference/reflection/configure.xml @@ -0,0 +1,35 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<section xml:id="reflection.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.install; + + <para> + A extensão reflexão é ativada por padrão, a partir do PHP 5. + </para> + +</section> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47227 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47227 ------------------------------------------------------------------ New file: pt_BR/reference/reflection/reflection.xml By: Felipe Barth on 2013-06-13 16:12:31 =================================================================== --- pt_BR/reference/reflection/reflection.xml +++ pt_BR/reference/reflection/reflection.xml @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<phpdoc:classref xml:id="class.reflection" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> + + <title>Classe Reflection</title> + <titleabbrev>Reflection</titleabbrev> + + <partintro> + + + <section xml:id="reflection.intro"> + &reftitle.intro; + <para> + Classe de reflexão. + </para> + </section> + + + <section xml:id="reflection.synopsis"> + &reftitle.classsynopsis; + + + <classsynopsis> + <ooclass><classname>Reflection</classname></ooclass> + + + <classsynopsisinfo> + <ooclass> + <classname>Reflection</classname> + </ooclass> + </classsynopsisinfo> + + + <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo> + <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.reflection')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> + </classsynopsis> + + + </section> + + </partintro> + + &reference.reflection.entities.reflection; + +</phpdoc:classref> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47231 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47231 ------------------------------------------------------------------ New file: pt_BR/reference/reflection/reflectionclass.xml By: Felipe Barth on 2013-06-13 16:26:42 =================================================================== --- pt_BR/reference/reflection/reflectionclass.xml +++ pt_BR/reference/reflection/reflectionclass.xml @@ -0,0 +1,161 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<phpdoc:classref xml:id="class.reflectionclass" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> + + <title>Classe ReflectionClass</title> + <titleabbrev>ReflectionClass</titleabbrev> + + <partintro> + + + <section xml:id="reflectionclass.intro"> + &reftitle.intro; + <para> + Classe <classname>ReflectionClass</classname>reporta + informações sobre uma classe. + </para> + </section> + + + <section xml:id="reflectionclass.synopsis"> + &reftitle.classsynopsis; + + + <classsynopsis> + <ooclass><classname>ReflectionClass</classname></ooclass> + + + <classsynopsisinfo> + <ooclass> + <classname>ReflectionClass</classname> + </ooclass> + + <oointerface> + <interfacename>Reflector</interfacename> + </oointerface> + </classsynopsisinfo> + + <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo> + <fieldsynopsis> + <modifier>const</modifier> + <type>integer</type> + <varname linkend="reflectionclass.constants.is-implicit-abstract">ReflectionClass::IS_IMPLICIT_ABSTRACT</varname> + <initializer>16</initializer> + </fieldsynopsis> + <fieldsynopsis> + <modifier>const</modifier> + <type>integer</type> + <varname linkend="reflectionclass.constants.is-explicit-abstract">ReflectionClass::IS_EXPLICIT_ABSTRACT</varname> + <initializer>32</initializer> + </fieldsynopsis> + <fieldsynopsis> + <modifier>const</modifier> + <type>integer</type> + <varname linkend="reflectionclass.constants.is-final">ReflectionClass::IS_FINAL</varname> + <initializer>64</initializer> + </fieldsynopsis> + + <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo> + <fieldsynopsis> + <modifier>public</modifier> + <varname linkend="reflectionclass.props.name">name</varname> + </fieldsynopsis> + + + <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo> + <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.reflectionclass')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> + </classsynopsis> + + + </section> + + + + <section xml:id="reflectionclass.props"> + &reftitle.properties; + <variablelist> + <varlistentry xml:id="reflectionclass.props.name"> + <term><varname>name</varname></term> + <listitem> + <para> + Nome da classe. Apenas leitura, gera + <classname>ReflectionException</classname> na tentativa de escrita. + </para> + </listitem> + </varlistentry> + </variablelist> + </section> + + + + + <section xml:id="reflectionclass.constants"> + &reftitle.constants; + <section xml:id="reflectionclass.constants.modifiers"> + <title>Modificadores ReflectionClass</title> + <variablelist> + + <varlistentry xml:id="reflectionclass.constants.is-implicit-abstract"> + <term><constant>ReflectionClass::IS_IMPLICIT_ABSTRACT</constant></term> + <listitem> + <para> + Indica que a classe é <link linkend="language.oop5.abstract"> + abstrata</link> pois possui alguns métodos abstratos. + </para> + </listitem> + </varlistentry> + + <varlistentry xml:id="reflectionclass.constants.is-explicit-abstract"> + <term><constant>ReflectionClass::IS_EXPLICIT_ABSTRACT</constant></term> + <listitem> + <para> + Indica que a classe é <link linkend="language.oop5.abstract"> + abstrata</link> por causa da sua definição. + </para> + </listitem> + </varlistentry> + + <varlistentry xml:id="reflectionclass.constants.is-final"> + <term><constant>ReflectionClass::IS_FINAL</constant></term> + <listitem> + <para> + Indica classe<link linkend="language.oop5.final">final</link>. + </para> + </listitem> + </varlistentry> + + </variablelist> + </section> + </section> + + + + </partintro> + + &reference.reflection.entities.reflectionclass; + +</phpdoc:classref> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47232 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47232 ------------------------------------------------------------------ New file: pt_BR/reference/reflection/reflectionexception.xml By: Felipe Barth on 2013-06-14 15:08:33 =================================================================== --- pt_BR/reference/reflection/reflectionexception.xml +++ pt_BR/reference/reflection/reflectionexception.xml @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<phpdoc:classref xml:id="class.reflectionexception" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> + + <title>Classe ReflectionException</title> + <titleabbrev>ReflectionException</titleabbrev> + + <partintro> + + + <section xml:id="reflectionexception.intro"> + &reftitle.intro; + <para> + Classe ReflectionException. + </para> + </section> + + + <section xml:id="reflectionexception.synopsis"> + &reftitle.classsynopsis; + + + <classsynopsis> + <ooclass><classname>ReflectionException</classname></ooclass> + + + <classsynopsisinfo> + <ooclass> + <classname>ReflectionException</classname> + </ooclass> + + <ooclass> + <modifier>extends</modifier> + <classname>Exception</classname> + </ooclass> + </classsynopsisinfo> + + <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo> + <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/db:classsynopsis/db:fieldsynopsis)" /> + + <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo> + <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> + + </classsynopsis> + + + </section> + + + </partintro> + +</phpdoc:classref> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47236 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47236 ------------------------------------------------------------------ New file: pt_BR/reference/reflection/reflectionextension.xml By: Felipe Barth on 2013-06-14 15:16:31 =================================================================== --- pt_BR/reference/reflection/reflectionextension.xml +++ pt_BR/reference/reflection/reflectionextension.xml @@ -0,0 +1,99 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<phpdoc:classref xml:id="class.reflectionextension" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> + + <title>Classe ReflectionExtension</title> + <titleabbrev>ReflectionExtension</titleabbrev> + + <partintro> + + + <section xml:id="reflectionextension.intro"> + &reftitle.intro; + <para> + A classe <classname>ReflectionExtension</classname> reporta + informações sobre uma extensão. + </para> + </section> + + + <section xml:id="reflectionextension.synopsis"> + &reftitle.classsynopsis; + + + <classsynopsis> + <ooclass><classname>ReflectionExtension</classname></ooclass> + + + <classsynopsisinfo> + <ooclass> + <classname>ReflectionExtension</classname> + </ooclass> + + <oointerface> + <interfacename>Reflector</interfacename> + </oointerface> + </classsynopsisinfo> + + <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo> + <fieldsynopsis> + <modifier>public</modifier> + <varname linkend="reflectionextension.props.name">name</varname> + </fieldsynopsis> + + + <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo> + <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.reflectionextension')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> + </classsynopsis> + + + </section> + + + + <section xml:id="reflectionextension.props"> + &reftitle.properties; + <variablelist> + <varlistentry xml:id="reflectionextension.props.name"> + <term><varname>name</varname></term> + <listitem> + <para> + Nome da extensão, mesmo que chamar o método + <methodname>ReflectionExtension::getName</methodname> + </para> + </listitem> + </varlistentry> + </variablelist> + </section> + + + + </partintro> + + &reference.reflection.entities.reflectionextension; + +</phpdoc:classref> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47237 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47237 ------------------------------------------------------------------ New file: pt_BR/reference/reflection/reflectionfunction.xml By: Felipe Barth on 2013-06-14 15:19:31 =================================================================== --- pt_BR/reference/reflection/reflectionfunction.xml +++ pt_BR/reference/reflection/reflectionfunction.xml @@ -0,0 +1,138 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<phpdoc:classref xml:id="class.reflectionfunction" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> + + <title>Classe ReflectionFunction</title> + <titleabbrev>ReflectionFunction</titleabbrev> + + <partintro> + + + <section xml:id="reflectionfunction.intro"> + &reftitle.intro; + <para> + A classe <classname>ReflectionFunction</classname> reporta + informações sobre uma função. + </para> + </section> + + + <section xml:id="reflectionfunction.synopsis"> + &reftitle.classsynopsis; + + + <classsynopsis> + <ooclass><classname>ReflectionFunction</classname></ooclass> + + + <classsynopsisinfo> + <ooclass> + <classname>ReflectionFunction</classname> + </ooclass> + + <ooclass> + <modifier>extends</modifier> + <classname>ReflectionFunctionAbstract</classname> + </ooclass> + + <oointerface> + <interfacename>Reflector</interfacename> + </oointerface> + </classsynopsisinfo> + + <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo> + <fieldsynopsis> + <modifier>const</modifier> + <type>integer</type> + <varname linkend="reflectionfunction.constants.is-deprecated">ReflectionFunction::IS_DEPRECATED</varname> + <initializer>262144</initializer> + </fieldsynopsis> + + <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo> + <fieldsynopsis> + <modifier>public</modifier> + <varname linkend="reflectionfunction.props.name">name</varname> + </fieldsynopsis> + + + <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo> + <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.reflectionfunction')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> + + <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo> + <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.reflectionfunctionabstract')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> + + </classsynopsis> + + + </section> + + + + <section xml:id="reflectionfunction.props"> + &reftitle.properties; + <variablelist> + <varlistentry xml:id="reflectionfunction.props.name"> + <term><varname>name</varname></term> + <listitem> + <para> + Nome da função. Apenas leitura, gera + <classname>ReflectionException</classname> na tentativa de escrita. + </para> + </listitem> + </varlistentry> + </variablelist> + </section> + + + + + <section xml:id="reflectionfunction.constants"> + &reftitle.constants; + <section xml:id="reflectionfunction.constants.modifiers"> + <title>Modificadores ReflectionFunction</title> + <variablelist> + + <varlistentry xml:id="reflectionfunction.constants.is-deprecated"> + <term><constant>ReflectionFunction::IS_DEPRECATED</constant></term> + <listitem> + <para> + Indica uma função depreciada. + </para> + </listitem> + </varlistentry> + + </variablelist> + </section> + </section> + + + + </partintro> + + &reference.reflection.entities.reflectionfunction; + +</phpdoc:classref> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47238 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47238 ------------------------------------------------------------------ New file: pt_BR/reference/reflection/extending.xml By: Felipe Barth on 2013-06-14 15:25:04 =================================================================== --- pt_BR/reference/reflection/extending.xml +++ pt_BR/reference/reflection/extending.xml @@ -0,0 +1,102 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<chapter xml:id="reflection.extending" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Extendendo</title> + <para> + Caso queira criar versões especializdas das + classes nativas(digamos, para criar HTML colorido + quando sendo exportado, tendo variáveis membros de + fácil acesso ao invés de métodos ou tendo métodos utilitários), + você pode extendê-las. + </para> + <example> + <title>Extendendo classe nativas</title> + <programlisting role="php"> +<![CDATA[ +<?php +/** + * Minha Classe Reflection_Method + */ +class My_Reflection_Method extends ReflectionMethod +{ + public $visibility = array(); + + public function __construct($o, $m) + { + parent::__construct($o, $m); + $this->visibility = Reflection::getModifierNames($this->getModifiers()); + } +} + +/** + * Demonstração classe #1 + * + */ +class T { + protected function x() {} +} + +/** + * Demonstração classe #2 + * + */ +class U extends T { + function x() {} +} + +// Imprimir as informações +var_dump(new My_Reflection_Method('U', 'x')); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +object(My_Reflection_Method)#1 (3) { + ["visibility"]=> + array(1) { + [0]=> + string(6) "public" + } + ["name"]=> + string(1) "x" + ["class"]=> + string(1) "U" +} +]]> + </screen> + </example> + <caution> + <para> + Se construtor for sobrescrito, lembre-se de chamar + o contrutor pai antes de qualquer código que você adicionar. + Se isto não for feito irá resultar no seguinte erro: + <literal>Fatal error: Internal error: Failed to retrieve the reflection object</literal> + </para> + </caution> +</chapter> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47230 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47230 ------------------------------------------------------------------ New file: pt_BR/install/fpm/index.xml By: Jefersson Nathan on 2013-06-21 01:23:05 =================================================================== --- pt_BR/install/fpm/index.xml +++ pt_BR/install/fpm/index.xml @@ -1,5 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> - + + + <chapter xml:id="install.fpm" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>FastCGI Process Manager (FPM)</title> @@ -39,13 +41,13 @@ <listitem> <para> "slowlog" - os scripts de registro (e não apenas seus nomes, mas o seu PHP backtraces também, - usando ptrace e coisas semelhantes para o processo de leitura remota execute_data) que são executados extraordinariamente lento; + usando ptrace e coisas semelhantes para o processo de leitura remota execute_data) que são executados extraordinariamente lento; </para> </listitem> <listitem> <para> <function>fastcgi_finish_request</function> - função especial para finalizar pedido e liberar todos os dados ao mesmo tempo - continuando a fazer algo demorado (conversão de vídeo, processamento de estatísticas, etc); + continuando a fazer algo demorado (conversão de vídeo, processamento de estatísticas, etc); </para> </listitem> <listitem> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47472 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47472 ------------------------------------------------------------------ New file: pt_BR/install/fpm/configuration.xml By: Jefersson Nathan on 2013-06-21 03:00:12 =================================================================== --- pt_BR/install/fpm/configuration.xml +++ pt_BR/install/fpm/configuration.xml @@ -1,5 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> - + + + <sect1 xml:id="install.fpm.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Configuração</title> @@ -39,7 +41,7 @@ </term> <listitem> <para> - Nível de log de erro. Valores possíveis: alert, error, warning, notice, + Nível de log de erro. Valores possíveis: alert, error, warning, notice, debug. Valor padrão: aviso prévio. </para> </listitem> @@ -52,7 +54,7 @@ <listitem> <para> Se esse número de processos filho sair com SIGSEGV ou SIGBUS dentro - do intervalo de tempo definido pelo <literal>emergency_restart_interval</literal> + do intervalo de tempo definido pelo <literal>emergency_restart_interval</literal> então FPM será reiniciado. Um valor de 0 significa 'Off'. Valor padrão: 0 (desligado). </para> </listitem> @@ -80,7 +82,7 @@ <listitem> <para> Prazo para processos filhos para esperar uma reação em sinais de - mestre. Unidades disponíveis: s(econds), m(inutes), h(ours), or d(ays) + mestre. Unidades disponíveis: s(econds), m(inutes), h(ours), or d(ays) Unidade Padrão: seconds. Valor padrão: 0. </para> </listitem> @@ -93,7 +95,7 @@ <listitem> <para> Enviar FPM de fundo. Definido como 'no'(não) para manter FPM em primeiro plano para - depuração. Valor padrão: yes. + depuração. Valor padrão: yes. </para> </listitem> </varlistentry> @@ -116,7 +118,7 @@ <para> O endereço no qual a aceitar pedidos FastCGI. Sintaxes válidas são: 'ip.add.re.ss:port', 'port', '/path/to/unix/socket'. Esta opção é - obrigatório, em cada rotina. + obrigatório, em cada rotina. </para> </listitem> </varlistentry> @@ -140,10 +142,10 @@ <listitem> <para> Lista de endereços IPv4 de clientes FastCGI que estão autorizados a - conectar. Equivalente à variável de ambiente FCGI_WEB_SERVER_ADDRS no - originais PHP FastCGI (5.2.2 +). Só faz sentido com um soquete de escuta TCP. - Cada endereço deve ser separado por uma vírgula. Se este valor for deixado em branco, - conexões serão aceitas a partir de qualquer endereço IP. Valor padrão: nenhum. + conectar. Equivalente à variável de ambiente FCGI_WEB_SERVER_ADDRS no + originais PHP FastCGI (5.2.2 +). Só faz sentido com um soquete de escuta TCP. + Cada endereço deve ser separado por uma vírgula. Se este valor for deixado em branco, + conexões serão aceitas a partir de qualquer endereço IP. Valor padrão: nenhum. </para> </listitem> </varlistentry> @@ -155,9 +157,9 @@ <listitem> <para> Definir permissões para socket unix, se este for usado. No Linux, permissões de - leitura/gravação devem ser definidas de forma a permitir conexões a partir de um servidor - web. Muitos sistemas derivados do BSD permitir conexões independentemente das permissões. - Os valores padrão: usuários e grupos são definidos como o usuário que está executando, de modo está definido para 0666. + leitura/gravação devem ser definidas de forma a permitir conexões a partir de um servidor + web. Muitos sistemas derivados do BSD permitir conexões independentemente das permissões. + Os valores padrão: usuários e grupos são definidos como o usuário que está executando, de modo está definido para 0666. </para> </listitem> </varlistentry> @@ -202,7 +204,7 @@ <listitem> <para> Grupo Unix de processos FPM. Se não for definido, o grupo do usuário padrão é - utilizado. + utilizado. </para> </listitem> </varlistentry> @@ -214,7 +216,7 @@ <listitem> <para> Escolha como o gestor do processo vai controlar o número de processos - filhos. Valores possíveis: <literal>static</literal>, <literal>ondemand</literal>, + filhos. Valores possíveis: <literal>static</literal>, <literal>ondemand</literal>, <literal>dynamic</literal>. Esta opção é obrigatória. </para> @@ -223,12 +225,12 @@ </para> <para> <literal>ondemand</literal> - os processos sob demanda (quando solicitado, - em oposição a dinâmica, então <literal>pm.start_servers</literal> são iniciadas - quando o serviço é iniciado. + em oposição a dinâmica, então <literal>pm.start_servers</literal> são iniciadas + quando o serviço é iniciado. </para> <para> <literal>dynamic</literal> - o número de processos filho é definida dinamicamente com base nas - seguintes diretrizes: <literal>pm.max_children</literal>, <literal>pm.start_servers</literal>, + seguintes diretrizes: <literal>pm.max_children</literal>, <literal>pm.start_servers</literal>, <literal>pm.min_spare_servers</literal>, <literal>pm.max_spare_servers</literal>. </para> </listitem> @@ -247,9 +249,9 @@ </para> <para> Esta opção define o limite para o número de solicitações simultâneas que - será servida. Equivalente à directiva ApacheMaxClients com - mpm_prefork e ao <varname>PHP_FCGI_CHILDREN</varname> variável de ambiente no - originais PHP FastCGI. + será servida. Equivalente à directiva ApacheMaxClients com + mpm_prefork e ao <varname>PHP_FCGI_CHILDREN</varname> variável de ambiente no + originais PHP FastCGI. </para> </listitem> </varlistentry> @@ -261,7 +263,7 @@ <listitem> <para> O número de processos filhos criados na inicialização. - Usado apenas quando <literal>pm</literal> é configurado em <literal>dynamic</literal>. + Usado apenas quando <literal>pm</literal> é configurado em <literal>dynamic</literal>. Valor padrão: min_spare_servers + (max_spare_servers - min_spare_servers) / 2. </para> @@ -315,7 +317,7 @@ <listitem> <para> O URI para visualizar a página de status do FPM. Se este valor não for definido, não URI - será reconhecida como uma página de estado. Valor padrão: nenhum. + será reconhecida como uma página de estado. Valor padrão: nenhum. </para> </listitem> </varlistentry> @@ -327,9 +329,9 @@ <listitem> <para> O URI ping para chamar a página de FPM de monitoramento. Se este valor não é - definido, nenhuma URI será reconhecido como uma página de ping. Isto poderia ser usado para testar - de fora que FPM está vivo e responder. Por favor, note que o valor deve - começar com uma barra à esquerda (/). + definido, nenhuma URI será reconhecido como uma página de ping. Isto poderia ser usado para testar + de fora que FPM está vivo e responder. Por favor, note que o valor deve + começar com uma barra à esquerda (/). </para> </listitem> </varlistentry> @@ -341,8 +343,8 @@ <listitem> <para> Esta diretiva pode ser usado para personalizar a resposta a um pedido - ping. A resposta é formatada como text/plain com uma resposta de código 200. - Valor padrão: pong. + ping. A resposta é formatada como text/plain com uma resposta de código 200. + Valor padrão: pong. </para> </listitem> </varlistentry> @@ -354,10 +356,10 @@ <listitem> <para> O tempo limite para servir um único pedido após o qual o processo - trabalha serão encerradas. Esta opção deve ser usada quando o 'max_execution_time', - opção do arquivo ini não parar a execução do script por algum motivo. Um valor de '0', significa - 'Off'. Unidades disponíveis: s(econds) (padrão), m(inuts), h(our), ou d(ays). - Valor padrão: 0. + trabalha serão encerradas. Esta opção deve ser usada quando o 'max_execution_time', + opção do arquivo ini não parar a execução do script por algum motivo. Um valor de '0', significa + 'Off'. Unidades disponíveis: s(econds) (padrão), m(inuts), h(our), ou d(ays). + Valor padrão: 0. </para> </listitem> </varlistentry> @@ -369,8 +371,8 @@ <listitem> <para> O tempo limite para servir um único pedido depois que um rastreamento PHP - serão despejados para o arquivo 'slowlog. Um valor de '0 'significa' Off '. - Unidades disponíveis: s(econds)(padrão), m(inutes), h(ours), or d(ays). + serão despejados para o arquivo 'slowlog. Um valor de '0 'significa' Off '. + Unidades disponíveis: s(econds)(padrão), m(inutes), h(ours), or d(ays). Valor padrão: 0. </para> </listitem> @@ -382,7 +384,7 @@ </term> <listitem> <para> - O arquivo de log de solicitações lentas. Valor padrão: + O arquivo de log de solicitações lentas. Valor padrão: <literal>#INSTALL_PREFIX#/log/php-fpm.log.slow</literal>. </para> </listitem> @@ -406,7 +408,7 @@ <listitem> <para> Defina o tamanho do núcleo maxímo do rlimit. Valores possíveis: 'unlimited' ou um número inteiro maior ou igual a 0. - Valor padrão: valor definido pelo sistema. + Valor padrão: valor definido pelo sistema. </para> </listitem> </varlistentry> @@ -418,7 +420,7 @@ <listitem> <para> Chroot para o início deste diretório. Este valor deve ser definido como - um caminho absoluto. Quando este valor não está definido, chroot não é usado. + um caminho absoluto. Quando este valor não está definido, chroot não é usado. </para> </listitem> </varlistentry> @@ -430,7 +432,7 @@ <listitem> <para> Chdir para o início deste diretório. Este valor deve ser um caminho - absoluto. Valor padrão: diretório atual ou / ao chroot. + absoluto. Valor padrão: diretório atual ou / ao chroot. </para> </listitem> </varlistentry> @@ -441,18 +443,18 @@ </term> <listitem> <para> - Redirecionar stdout e stderr no log de erro principal. Se não for definido, - stdout e stderr serão redirecionadas para /dev/null de acordo com especificações FastCGI. - Valor padrão: no. + Redirecionar stdout e stderr no log de erro principal. Se não for definido, + stdout e stderr serão redirecionadas para /dev/null de acordo com especificações FastCGI. + Valor padrão: no. </para> </listitem> </varlistentry> </variablelist> <para> - É possível passar variáveis de ambiente adicionais e atualizar as configurações do PHP de uma determinada rotina. - Para fazer isso, você precisa adicionar as seguintes opções para <filename>php-fpm.conf</filename> + É possível passar variáveis de ambiente adicionais e atualizar as configurações do PHP de uma determinada rotina. + Para fazer isso, você precisa adicionar as seguintes opções para <filename>php-fpm.conf</filename> <example> - <title>Passando variáveis de ambiente e configurações do PHP para a rotina</title> + <title>Passando variáveis de ambiente e configurações do PHP para a rotina</title> <programlisting role="ini"> <![CDATA[ env[HOSTNAME] = $HOSTNAME @@ -471,11 +473,11 @@ </example> Configurações do PHP feitas com <literal>php_value</literal> ou <literal>php_flag</literal> irá substituir o seu valor anterior. - Por favor, note que a definição de + Por favor, note que a definição de <link linkend="ini.disable-functions">disable_functions</link> ou <link linkend="ini.disable-classes">disable_classes</link> não - irá substituir os previamente os valores definidos em <filename>php.ini</filename>, - mas irá adicionar o novo valor em seu lugar. + irá substituir os previamente os valores definidos em <filename>php.ini</filename>, + mas irá adicionar o novo valor em seu lugar. </para> <para> Configurações definidas com <literal>php_admin_value</literal> e <literal>php_admin_flag</literal> @@ -498,9 +500,9 @@ <caution> <para> Como essas configurações são passadas para php-fpm como cabeçalhos FastCGI, - php-fpm não deve ser vinculado a um endereço acessível em todo o mundo. - Caso contrário, qualquer um pode alterar as opções de configuração do PHP. - veja também + php-fpm não deve ser vinculado a um endereço acessível em todo o mundo. + Caso contrário, qualquer um pode alterar as opções de configuração do PHP. + veja também <link linkend="listen-allowed-clients">listen.allowed_clients</link>. </para> </caution> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47478 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47478 ------------------------------------------------------------------ New file: pt_BR/reference/network/functions/checkdnsrr.xml By: Marcos Leandro on 2013-09-24 09:01:39 =================================================================== --- pt_BR/reference/network/functions/checkdnsrr.xml +++ pt_BR/reference/network/functions/checkdnsrr.xml @@ -0,0 +1,140 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<refentry xml:id="function.checkdnsrr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>checkdnsrr</refname> + <refpurpose>Checa os registros DNS correspondentes para o nome do host ou endereço IP informado</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>checkdnsrr</methodname> + <methodparam><type>string</type><parameter>host</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>tipo</parameter><initializer>"MX"</initializer></methodparam> + </methodsynopsis> + <para> + Pesquisa o DNS para os registros <parameter>tipo</parameter> + correspondentes <parameter>host</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>host</parameter></term> + <listitem> + <para> + <parameter>host</parameter> pode ser o endereço IP em + notação quádrupla separada por pontos ou o nome do host. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>tipo</parameter></term> + <listitem> + <para> + <parameter>tipo</parameter> pode ser: A, MX, NS, SOA, + PTR, CNAME, AAAA, A6, SRV, NAPTR, TXT or ANY. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retorna &true; se o registro for encontrado; retorna &false; se não encontrar registros ou um erro ocorrer. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.3.0</entry> + <entry> + Esta função está disponível na plataforma Windows. + </entry> + </row> + <row> + <entry>5.2.4</entry> + <entry> + <parameter>tipo</parameter> TXT foi adicionado. + </entry> + </row> + <row> + <entry>5.0.0</entry> + <entry> + <parameter>tipo</parameter> AAAA foi adicionado. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Para compatibilidade com Windows antes dessa implementação, tente a classe + <link xlink:href="&url.php.pear;">PEAR</link> + <link xlink:href="&url.pear.package;Net_DNS">Net_DNS</link>. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dns_get_record</function></member> + <member><function>getmxrr</function></member> + <member><function>gethostbyaddr</function></member> + <member><function>gethostbyname</function></member> + <member><function>gethostbynamel</function></member> + <member>the named(8) manual page</member> + </simplelist> + </para> + </refsect1> + +</refentry> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=50262 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=50262 ------------------------------------------------------------------ New file: pt_BR/reference/fpm/functions/fastcgi-finish-request.xml By: Marcos Leandro on 2013-09-24 09:32:24 =================================================================== --- pt_BR/reference/fpm/functions/fastcgi-finish-request.xml +++ pt_BR/reference/fpm/functions/fastcgi-finish-request.xml @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<refentry xml:id="function.fastcgi-finish-request" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>fastcgi_finish_request</refname> + <refpurpose>Libera todos os dados de resposta ao cliente</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>boolean</type><methodname>fastcgi_finish_request</methodname> + <void /> + </methodsynopsis> + <para> + Esta função libera todos os dados de resposta para o cliente e finaliza a requisição. + Isso permite que tarefas demoradas sejam executadas sem + que a conexão com o cliente seja mantida aberta. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=50265 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=50265 ------------------------------------------------------------------ Modified: pt_BR/reference/json/book.xml By: Jefersson Nathan on 2013-05-29 02:19:20 =================================================================== => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47104 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47104 ------------------------------------------------------------------ Modified: pt_BR/reference/array/functions/range.xml By: rdohms on 2013-06-05 23:13:24 =================================================================== --- pt_BR/reference/array/functions/range.xml +++ pt_BR/reference/array/functions/range.xml @@ -135,16 +135,7 @@ </programlisting> </example> </para> - <note> - <para> - - </para> - </note> - <caution> - <para> - - </para> - </caution> + <para> Veja também <function>shuffle</function>, <function>array_fill</function>, e => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=47148 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=47148 ------------------------------------------------------------------ -- https://edit.php.net/ This email is send automatically by the Php Docbook Online Editor.