<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/migration71.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'migration71.changed-functions.php',
    1 => '变动的函数',
    2 => '变动的函数',
  ),
  'up' => 
  array (
    0 => 'migration71.php',
    1 => '从 PHP 7.0.x 移植到 PHP 7.1.x',
  ),
  'prev' => 
  array (
    0 => 'migration71.deprecated.php',
    1 => 'PHP 7.1.x 中废弃的特性',
  ),
  'next' => 
  array (
    0 => 'migration71.other-changes.php',
    1 => '其它变更',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'appendices/migration71/changed-functions.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="migration71.changed-functions" class="sect1">
 <h2 class="title">变动的函数</h2>

 <div class="sect2" id="migration71.changed-functions.core">
  <h3 class="title">PHP 核心</h3>
  

  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.getopt.php" class="function">getopt()</a></span> 函数增加了第三个参数，这是一个可选参数。通过以引用的方式传入参数，它可以用来存储参数列表中下一个参数的下标位置。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.getenv.php" class="function">getenv()</a></span> 可以不传入任何参数。如果不传入参数，此函数会以关联数组的形式返回所有的环境变量。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.get-headers.php" class="function">get_headers()</a></span> 增加了一个参数，可以用来解析自定义的流上下文。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.output-reset-rewrite-vars.php" class="function">output_reset_rewrite_vars()</a></span> 
     函数不再重置会话 URL 重写变量了。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.parse-url.php" class="function">parse_url()</a></span> 更加严格的限制，并且提供对 RFC3986 的支持。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.unpack.php" class="function">unpack()</a></span> 函数增加第三个参数，这是一个可选参数，用来指定开始解包的位置。
    </span>
   </li>
  </ul>
 </div>

 <div class="sect2" id="migration71.changed-functions.filesystem">
  <h3 class="title">文件系统</h3>
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.file-get-contents.php" class="function">file_get_contents()</a></span> 接受负数作为搜索偏移量，前提是流上下文必须是可搜索的。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.tempnam.php" class="function">tempnam()</a></span> 
     会在退回使用系统临时目录的时候，产生警告。
    </span>
   </li>
  </ul>
 </div>

 <div class="sect2" id="migration71.changed-functions.json">
  <h3 class="title">JSON</h3>
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.json-encode.php" class="function">json_encode()</a></span> 增加新的选项
     <strong><code><a href="json.constants.php#constant.json-unescaped-line-terminators">JSON_UNESCAPED_LINE_TERMINATORS</a></code></strong>。这个选项可以在指定 <strong><code><a href="json.constants.php#constant.json-unescaped-unicode">JSON_UNESCAPED_UNICODE</a></code></strong>
     选项的时候，对于 U+2028 和 U+2029 这两个字符不再进行转义。
    </span>
   </li>
  </ul>
 </div>

 <div class="sect2" id="migration71.changed-functions.mbstring">
  <h3 class="title">多子节字符</h3>
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.mb-ereg.php" class="function">mb_ereg()</a></span> 不接受无效的字节序列。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.mb-ereg-replace.php" class="function">mb_ereg_replace()</a></span> 不接受无效的字节序列。
    </span>
   </li>
  </ul>
 </div>

 <div class="sect2" id="migration71.changed-functions.pdo">
  <h3 class="title">PDO</h3>
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     <span class="methodname"><a href="pdo.lastinsertid.php" class="methodname">PDO::lastInsertId()</a></span> 在用于 PostgreSQL 数据库的时候，如果当前会话（到 PostgreSQL
     的数据库连接）上尚未调用过 <code class="literal">nextval</code>，那么此方法会触发一个错误。
    </span>
   </li>
  </ul>
 </div>

 <div class="sect2" id="migration71.changed-functions.pgsql">
  <h3 class="title">PostgreSQL</h3>
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.pg-last-notice.php" class="function">pg_last_notice()</a></span> 增加一个用来指定操作的可选参数。可使用以下常量作为此参数的值
     <strong><code><a href="pgsql.constants.php#constant.pgsql-notice-last">PGSQL_NOTICE_LAST</a></code></strong>、<strong><code><a href="pgsql.constants.php#constant.pgsql-notice-all">PGSQL_NOTICE_ALL</a></code></strong> 或
     <strong><code><a href="pgsql.constants.php#constant.pgsql-notice-clear">PGSQL_NOTICE_CLEAR</a></code></strong>。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.pg-fetch-all.php" class="function">pg_fetch_all()</a></span> 增加第二个参数，这是一个可选参数，它用来指定返回结果的类型（类似于
     <span class="function"><a href="function.pg-fetch-array.php" class="function">pg_fetch_array()</a></span> 的第三个参数）。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.pg-select.php" class="function">pg_select()</a></span> 增加第四个参数，这是一个可选参数，它用来指定返回结果的类型（类似于
     <span class="function"><a href="function.pg-fetch-array.php" class="function">pg_fetch_array()</a></span> 的第三个参数）。
    </span>
   </li>
  </ul>
 </div>

 <div class="sect2" id="migration71.changed-functions.session">
  <h3 class="title">Session</h3>
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     <span class="function"><a href="function.session-start.php" class="function">session_start()</a></span> 当无法成功初始化会话的时候，返回 <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>，并且不会初始化超级变量 
     <var class="varname"><a href="reserved.variables.session.php" class="classname">$_SESSION</a></var>。
    </span>
   </li>
  </ul>
 </div>
</div><?php manual_footer($setup); ?>