ini.core.html

php的帮助文档,涉及到PHP的案例和基本语法,以及实际应用内容

     </dt>


     <dt id="ini.register-argc-argv">
      <span class="term">
       <i><tt class="parameter">register_argc_argv</tt></i>

       <a href="language.types.boolean.html" class="type boolean">boolean</a>
      </span>

      <dd>

       <span class="simpara">
        Tells PHP whether to declare the argv &amp; argc variables
        (that would contain the GET information).
       </span>
       <span class="simpara">
        See also <a href="features.commandline.html" class="link">command line</a>.
        Also, this directive became available in PHP 4.0.0 and
        was always &quot;on&quot; before that.
       </span>
      </dd>

     </dt>


     <dt id="ini.register-long-arrays">
      <span class="term">
       <i><tt class="parameter">register_long_arrays</tt></i>

       <a href="language.types.boolean.html" class="type boolean">boolean</a>
      </span>

      <dd>

       <span class="simpara">
        Tells PHP whether or not to register the deprecated long
        <var class="varname">$HTTP_*_VARS</var> type
        <a href="language.variables.predefined.html" class="link">predefined
        variables</a>.  When On (default), long predefined PHP
        variables like <var class="varname">$HTTP_GET_VARS</var> will be defined.
        If you&#039;re not using them, it&#039;s recommended to turn them off,
        for performance reasons.  Instead, use the superglobal arrays,
        like <var class="varname"><a href="reserved.variables.get.html" class="classname">$_GET</a></var>.
       </span>
       <span class="simpara">
        This directive became available in PHP 5.0.0 and was dropped in PHP
        6.0.0.
       </span>
      </dd>

     </dt>


     <dt id="ini.post-max-size">
      <span class="term">
       <i><tt class="parameter">post_max_size</tt></i>

       <a href="language.types.integer.html" class="type integer">integer</a>
      </span>

      <dd>

       <span class="simpara">
        Sets max size of post data allowed. This setting also affects
        file upload. To upload large files, this value must be larger
        than <a href="ini.core.html#ini.upload-max-filesize" class="link">upload_max_filesize</a>.
       </span>
       <span class="simpara">
        If memory limit is enabled by your configure script, <a href="ini.core.html#ini.memory-limit" class="link">memory_limit</a> also affects
        file uploading. Generally speaking,
        <a href="ini.core.html#ini.memory-limit" class="link">memory_limit</a> should be
        larger than <i><tt class="parameter">post_max_size</tt></i>
.
       </span>

       <span class="simpara">When an <a href="language.types.integer.html" class="type integer">integer</a> is used, the 
value is measured in bytes. Shorthand notation, as described 
in <a href="faq.using.html#faq.using.shorthandbytes" class="link">this FAQ</a>, may also be used.
</span>

       <span class="simpara">
        If the size of post data is greater than post_max_size, the
        <var class="varname"><a href="reserved.variables.post.html" class="classname">$_POST</a></var> and <var class="varname"><a href="reserved.variables.files.html" class="classname">$_FILES</a></var>
        <a href="language.variables.superglobals.html" class="link">superglobals</a>
        are empty. This can be tracked in various ways, e.g. by passing the
        <var class="varname"><a href="reserved.variables.get.html" class="classname">$_GET</a></var> variable to the script processing the data,
        i.e. <i>&lt;form action=&quot;edit.php?processed=1&quot;&gt;</i>,
        and then checking if <var class="varname"><a href="reserved.variables.get.html" class="classname">$_GET['processed']</a></var> is set.
       </span>
       <p class="para">
        <blockquote><p><b class="note">Note</b>: 
         
          PHP allows shortcuts for bit values, including K (kilo), M (mega) 
          and G (giga). PHP will do the conversions automatically if you 
          use any of these. Be careful not to exceed the 32 bit signed integer 
          limit (if you&#039;re using 32bit versions) as it will cause your script 
          to fail.
         <br />
        </p></blockquote>
       </p>

      </dd>

     </dt>


     <dt id="ini.gpc-order">
      <span class="term">
       <i><tt class="parameter">gpc_order</tt></i>

       <a href="language.types.string.html" class="type string">string</a>
      </span>

      <dd>

       <p class="para">
        Set the order of GET/POST/COOKIE variable parsing. The
        default setting of this directive is &quot;GPC&quot;.  Setting this to
        &quot;GP&quot;, for example, will cause PHP to completely ignore cookies
        and to overwrite any GET method variables with POST-method
        variables of the same name.
       </p>
       <blockquote><p><b class="note">Note</b>: 
        
         This option is not available in PHP 4.
         Use <a href="ini.core.html#ini.variables-order" class="link">variables_order</a>
         instead.
        <br />
       </p></blockquote>
      </dd>

     </dt>


     <dt id="ini.auto-prepend-file">
      <span class="term">
       <i><tt class="parameter">auto_prepend_file</tt></i>

       <a href="language.types.string.html" class="type string">string</a>
      </span>

      <dd>

       <p class="para">
        Specifies the name of a file that is automatically parsed
        before the main file.  The file is included as if it was
        called with the <b>require()</b> function, so
        <a href="ini.core.html#ini.include-path" class="link">include_path</a> is used.</p>
       <p class="para">
        The special value <i>none</i>
        disables auto-prepending.
       </p>
      </dd>

     </dt>


     <dt id="ini.auto-append-file">
      <span class="term">
       <i><tt class="parameter">auto_append_file</tt></i>

       <a href="language.types.string.html" class="type string">string</a>
      </span>

      <dd>

       <p class="para">
        Specifies the name of a file that is automatically parsed
        after the main file.  The file is included as if it was
        called with the <b>require()</b> function, so
        <a href="ini.core.html#ini.include-path" class="link">include_path</a> is used.</p>
       <p class="para">
        The special value <i>none</i>
        disables auto-appending.
        <blockquote><p><b class="note">Note</b>: 
         <span class="simpara">
          If the script is terminated with <a href="function.exit.html" class="function">exit()</a>,
          auto-append will <em class="emphasis">not</em> occur.</span>
        </p></blockquote>
       </p>
      </dd>

     </dt>


     <dt id="ini.default-mimetype">
      <span class="term">
       <i><tt class="parameter">default_mimetype</tt></i>

       <a href="language.types.string.html" class="type string">string</a>
      </span>

      <dd>

       <p class="para">
       </p>
      </dd>

     </dt>


     <dt id="ini.default-charset">
      <span class="term">
       <i><tt class="parameter">default_charset</tt></i>

       <a href="language.types.string.html" class="type string">string</a>
      </span>

      <dd>

       <p class="para">
        As of 4.0.0, PHP always outputs a character encoding by default in
        the Content-type: header. To disable sending of the charset, simply
        set it to be empty.
       </p>
      </dd>

     </dt>


     <dt id="ini.always-populate-raw-post-data">
      <span class="term">
       <i><tt class="parameter">always_populate_raw_post_data</tt></i>

       <a href="language.types.boolean.html" class="type boolean">boolean</a>
      </span>

      <dd>

       <p class="para">
        Always populate the <var class="varname"><a href="reserved.variables.httprawpostdata.html" class="classname">$HTTP_RAW_POST_DATA</a></var> containing
        the raw POST data. Otherwise, the variable is populated only with
        unrecognized MIME type of the data. However, the preferred method for
        accessing the raw POST data is <a href="wrappers.php.html" class="link">php://input</a>.
        <var class="varname"><a href="reserved.variables.httprawpostdata.html" class="classname">$HTTP_RAW_POST_DATA</a></var> is not available with
        <i>enctype=&quot;multipart/form-data&quot;</i>.
       </p>
      </dd>

     </dt>


     <dt id="ini.allow-webdav-methods">
      <span class="term">
       <i><tt class="parameter">allow_webdav_methods</tt></i>

       <a href="language.types.boolean.html" class="type boolean">boolean</a>
      </span>

      <dd>

       <p class="para">
        Allow handling of WebDAV http requests within PHP scripts (eg.
        PROPFIND, PROPPATCH, MOVE, COPY, etc.).
        This directive does not exist as of PHP 4.3.2.
        If you want to get the post data of those requests, you have to
        set <a href="ini.core.html#ini.always-populate-raw-post-data" class="link">
        always_populate_raw_post_data</a> as well.
       </p>
      </dd>

     </dt>

    </dl>

   </p>
   <p class="para">
    See also: <a href="info.configuration.html#ini.magic-quotes-gpc" class="link">magic_quotes_gpc</a>,
    <a href="info.configuration.html#ini.magic-quotes-runtime" class="link">magic_quotes_runtime</a>,
    and
    <a href="sybase.configuration.html#ini.magic-quotes-sybase" class="link">magic_quotes_sybase</a>.
   </p>
  </div>

  <div id="ini.sect.path-directory" class="section">
   <h2 class="title">Paths and Directories</h2>
   <p class="para">
    <table border="5">
     <caption><b>Paths and Directories Configuration Options</b></caption>
     <colgroup>

      <thead valign="middle">
       <tr valign="middle">
        <th colspan="1">Name</th>
        <th colspan="1">Default</th>
        <th colspan="1">Changeable</th>
        <th colspan="1">Changelog</th>
       </tr>

      </thead>

      <tbody valign="middle" class="tbody">
       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">include_path</td>
        <td colspan="1" rowspan="1" align="left">&quot;.;/path/to/php/pear&quot;</td>
        <td colspan="1" rowspan="1" align="left">PHP_INI_ALL</td>
        <td class="empty">&nbsp;</td>
       </tr>

       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">doc_root</td>
        <td colspan="1" rowspan="1" align="left">NULL</td>
        <td colspan="1" rowspan="1" align="left">PHP_INI_SYSTEM</td>
        <td class="empty">&nbsp;</td>
       </tr>

       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">user_dir</td>
        <td colspan="1" rowspan="1" align="left">NULL</td>
        <td colspan="1" rowspan="1" align="left">PHP_INI_SYSTEM</td>
        <td class="empty">&nbsp;</td>
       </tr>

       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">extension_dir</td>
        <td colspan="1" rowspan="1" align="left">&quot;/path/to/php&quot;</td>
        <td colspan="1" rowspan="1" align="left">PHP_INI_SYSTEM</td>
        <td class="empty">&nbsp;</td>
       </tr>

       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">extension</td>
        <td colspan="1" rowspan="1" align="left">NULL</td>
        <td colspan="1" rowspan="1" align="left"><var class="filename">php.ini</var> only</td>
        <td class="empty">&nbsp;</td>
       </tr>

       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">cgi.check_shebang_line</td>
        <td colspan="1" rowspan="1" align="left">&quot;1&quot;</td>
        <td colspan="1" rowspan="1" align="left">PHP_INI_SYSTEM</td>
        <td colspan="1" rowspan="1" align="left">Available since PHP 5.2.0.</td>
       </tr>

       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">cgi.fix_pathinfo</td>
        <td colspan="1" rowspan="1" align="left">&quot;1&quot;</td>
        <td colspan="1" rowspan="1" align="left">PHP_INI_SYSTEM</td>
        <td colspan="1" rowspan="1" align="left">Available since PHP 4.3.0. PHP_INI_ALL prior to PHP 5.2.1.</td>
       </tr>

       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">cgi.force_redirect</td>
        <td colspan="1" rowspan="1" align="left">&quot;1&quot;</td>
        <td colspan="1" rowspan="1" align="left">PHP_INI_SYSTEM</td>
        <td colspan="1" rowspan="1" align="left">Available since PHP 4.2.0. PHP_INI_ALL prior to PHP 5.2.1.</td>
       </tr>

       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">cgi.redirect_status_env</td>
        <td colspan="1" rowspan="1" align="left">NULL</td>
        <td colspan="1" rowspan="1" align="left">PHP_INI_SYSTEM</td>
        <td colspan="1" rowspan="1" align="left">Available since PHP 4.2.0. PHP_INI_ALL prior to PHP 5.2.1.</td>
       </tr>

       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">fastcgi.impersonate</td>
        <td colspan="1" rowspan="1" align="left">&quot;0&quot;</td>
        <td colspan="1" rowspan="1" align="left">PHP_INI_SYSTEM</td>
        <td colspan="1" rowspan="1" align="left">Available since PHP 4.3.0. PHP_INI_ALL prior to PHP 5.2.1.</td>
       </tr>

       <tr valign="middle">
        <td colspan="1" rowspan="1" align="left">cgi.rfc2616_headers</td>
        <td colspan="1" rowspan="1" align="left">&quot;0&quot;</td>
        <td colspan="1" rowspan="1" align="left">PHP_INI_ALL</td>
        <td colspan="1" rowspan="1" align="left">Available since PHP 4.3.0.</td>
       </tr>

      </tbody>
     </colgroup>

    </table>

   </p>

   <p class="para">Here&#039;s a short explanation of
the configuration directives.</p>

   <p class="para">
    <dl>

     <dt id="ini.include-path">
      <span class="term">
       <i><tt class="parameter">include_path</tt></i>

       <a href="language.types.string.html" class="type string">string</a>
      </span>

      <dd>

       <p class="para">
        Specifies a list of directories where the
        <b>require()</b>, <b>include()</b>,
        <a href="function.fopen.html" class="function">fopen()</a>, <a href="function.file.html" class="function">file()</a>,
        <a href="function.readfile.html" class="function">readfile()</a> and <a href="function.file-get-contents.html" class="function">file_get_contents()</a>
        functions look for files.  The format is like the system&#039;s
        <span class="envar">PATH</span> environment variable: a list of directories
        separated with a colon in Unix or semicolon in Windows.
       </p>
       <p class="para">
        <div class="example">
         <p><b>Example #1 Unix include_path</b></p>
         <div class="example-contents">
<div class="cdata"><pre>
include_path=&quot;.:/php/includes&quot;
</pre></div>
         </div>

        </div>
       </p>
       <p class="para">
        <div class="example">
         <p><b>Example #2 Windows include_path</b></p>
         <div class="example-contents">
<div class="cdata"><pre>
include_path=&quot;.;c:\php\includes&quot;
</pre></div>
         </div>

        </div>
       </p>