archived-doc-pt-br/reference/com/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: leonardolara Status: ready -->
<section xml:id="com.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
 <table>
  <title>Opções de configuação de COM</title>
  <tgroup cols="4">
   <thead>
    <row>
     <entry>&Name;</entry>
     <entry>&Default;</entry>
     <entry>&Changeable;</entry>
     <entry>&Changelog;</entry>
    </row>
   </thead>
   <tbody xml:id="com.configuration.list">
    <row>
     <entry><link linkend="ini.com.allow-dcom">com.allow_dcom</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.com.autoregister-typelib">com.autoregister_typelib</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.com.autoregister-verbose">com.autoregister_verbose</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.com.autoregister-casesensitive">com.autoregister_casesensitive</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.com.code-page">com.code_page</link></entry>
     <entry>""</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.com.dotnet-version">com.dotnet_version</link></entry>
     <entry>""</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry>A partir do PHP 8.0.0</entry>
    </row>
    <row>
     <entry><link linkend="ini.com.typelib-file">com.typelib_file</link></entry>
     <entry>""</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry></entry>
    </row>
   </tbody>
  </tgroup>
 </table>
 &ini.php.constants;
 </para>

 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry xml:id="ini.com.allow-dcom">
    <term>
     <parameter>com.allow_dcom</parameter>
    </term>
    <listitem>
    <para>
     Quando ativado, o PHP poderá operar como um cliente D-COM
     (COM Distribuído) e permitirá que o script PHP instancie
     objetos COM em um servidor remoto.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.autoregister-typelib">
    <term>
     <parameter>com.autoregister_typelib</parameter>
    </term>
    <listitem>
    <para>
     Quando ativado, o PHP tentará registrar constantes da
     biblioteca de tipos de objetos <classname>COM</classname> que ele instancia, se esses objetos
     implementarem as interfaces necessárias para obter essas informações.
     A distinção entre maiúsculas e minúsculas das constantes que ele registra é controlada Please
     diretiva <link
     linkend="ini.com.autoregister-casesensitive">com.autoregister_casesensitive</link> do &php.ini;.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.autoregister-verbose">
    <term>
     <parameter>com.autoregister_verbose</parameter>
    </term>
    <listitem>
    <para>
     Quando ativado, quaisquer problemas com o carregamento de uma biblioteca de tipos durante
     a instanciação do objeto serão relatados usando o mecanismo de erro do PHP.
     O padrão é desativado, o que não emite nenhuma indicação se houve
     um erro ao localizar ou carregar a biblioteca de tipos.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.autoregister-casesensitive">
    <term>
     <parameter>com.autoregister_casesensitive</parameter>
    </term>
    <listitem>
    <para>
     Quando ativado (o padrão), as constantes encontradas nas bibliotecas
     de tipos carregadas automaticamente ao instanciar objetos <classname>COM</classname> serão registradas com distinção entre maiúsculas e minúsculas. Consulte
     <function>com_load_typelib</function> para mais detalhes.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.code-page">
    <term>
     <parameter>com.code_page</parameter>
    </term>
    <listitem>
    <para>
     Controla a página de código do conjunto de caracteres padrão a ser usada ao passar
     strings de e para objetos COM. Se definida como uma string vazia, o PHP
     assumirá o valor <constant>CP_ACP</constant>, que é a página de código
     ANSI padrão do sistema.
    </para>
    <para>
     Se o texto nos scripts for codificado usando por padrão um conjunto
     de caracteres ou uma codificação diferente, definir esta diretiva evitará que
     seja necessário passar a página de código como um parâmetro para o construtor de classe <xref
     linkend="class.com"/>. Observe que ao
     usar esta diretiva (como acontece com qualquer diretiva de configuração PHP), o script
     PHP se torna menos portável; deve-se usar o parâmetro do construtor COM
     sempre que possível.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.dotnet-version">
    <term>
     <parameter>com.dotnet_version</parameter>
    </term>
    <listitem>
    <para>
     A versão do .NET Framework a ser usada para objetos <classname>dotnet</classname>.
     O valor da configuração são as três primeiras partes do número da versão do Framework,
     separadas por pontos e prefixadas com <literal>v</literal>, por exemplo, <literal>v4.0.30319</literal>.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.typelib-file">
    <term>
     <parameter>com.typelib_file</parameter>
    </term>
    <listitem>
    <para>
     Quando definida, deve informar o caminho para um arquivo que contém uma lista
     de bibliotecas de tipos que devem ser carregadas na inicialização. Cada linha do
     arquivo será tratada como o nome da biblioteca de tipos e carregada como
     se <function>com_load_typelib</function> tivesse sido chamada.
     As constantes serão registradas de forma persistente, de forma que a biblioteca
     só precise ser carregada uma vez. Se o nome de uma biblioteca de tipos terminar com a
     string <literal>#cis</literal> ou <literal>#case_insensitive</literal>,
     as constantes dessa biblioteca serão registradas
     sem distinção entre maiúsculas e minúsculas.
    </para>
    </listitem>
   </varlistentry>

  </variablelist>
 </para>

</section>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->