ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 36d8d80891c1dfc49dacecccc7d43b7fe6a6bb89 Maintainer: jhdxr Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<section xml:id="filesystem.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>文件系统和流配置选项</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry><link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
      <entry>"1"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.allow-url-include">allow_url_include</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>自 PHP 7.4.0 起废弃。</entry>
     </row>
     <row>
      <entry><link linkend="ini.user-agent">user_agent</link></entry>
      <entry>NULL</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.default-socket-timeout">default_socket_timeout</link></entry>
      <entry>"60"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
    </row>
     <row>
      <entry><link linkend="ini.from">from</link></entry>
      <entry>""</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>自 PHP 8.1.0 起弃用。</entry>
     </row>
     <row>
      <entry><link linkend="ini.sys-temp-dir">sys_temp_dir</link></entry>
      <entry>""</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>

 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry xml:id="ini.allow-url-fopen">
    <term>
     <parameter>allow_url_fopen</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      本选项激活了 URL 形式的 fopen 封装协议使得可以访问 URL
      对象例如文件。默认的封装协议提供用 ftp 和 http 协议来访问<link
      linkend="features.remote-files">远程文件</link>，一些扩展库例如
      <link linkend="ref.zlib">zlib</link> 可能会注册更多的封装协议。
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.allow-url-include">
    <term>
     <parameter>allow_url_include</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      This option allows the use of URL-aware fopen wrappers with the following 
      functions: <function>include</function>, <function>include_once</function>, 
      <function>require</function>, <function>require_once</function>.
     </para>
     <note>
      <para>
       这个设置项需要开启 allow_url_fopen 。
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.user-agent">
    <term>
     <parameter>user_agent</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      定义 PHP 发送的 User-Agent。
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.default-socket-timeout">
    <term>
     <parameter>default_socket_timeout</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      指定基于 socket 的流的默认超时时间（秒）。指定一个负值意味着不会超时。
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.from">
    <term>
     <parameter>from</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      这个 email 地址在使用 ftp 封装器的时候用于未认证的 FTP
      连接，在使用 http 封装器的时候用于 HTTP 连接的消息头中的
      From 字段。
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.auto-detect-line-endings">
    <term>
     <parameter>auto_detect_line_endings</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      当设为 On 时，PHP 将检查通过
      <function>fgets</function> 和 <function>file</function>
      取得的数据中的行结束符号是符合 Unix，MS-DOS，还是 Macintosh 的习惯。
     </para>
     <para>
      这使得 PHP 可以和 Macintosh 系统交互操作，但是默认值是
      Off，因为在检测第一行的
      EOL 习惯时会有很小的性能损失，而且在 Unix
      系统下使用回车符号作为项目分隔符的人们会遭遇向下不兼容的行为。
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.sys-temp-dir">
    <term>
     <parameter>sys_temp_dir</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
     </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
-->