<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/migration81.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'migration81.incompatible.php',
    1 => '不向后兼容的变更',
    2 => '不向后兼容的变更',
  ),
  'up' => 
  array (
    0 => 'migration81.php',
    1 => '从 PHP 8.0.x 移植到 PHP 8.1.x',
  ),
  'prev' => 
  array (
    0 => 'migration81.constants.php',
    1 => '新的全局常量',
  ),
  'next' => 
  array (
    0 => 'migration81.deprecated.php',
    1 => 'PHP 8.1.x 废弃的功能',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'appendices/migration81/incompatible.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="migration81.incompatible" class="sect1">
 <h2 class="title">不向后兼容的变更</h2>

 <div class="sect2" id="migration81.incompatible.core">
  <h3 class="title">PHP 内核</h3>

  <div class="sect3" id="migration81.incompatible.core.globals-access">
   <h4 class="title">$GLOBALS 访问限制</h4>

   <p class="para">
    现在访问 <var class="varname"><a href="reserved.variables.globals.php" class="classname">$GLOBALS</a></var> 数组受到一些限制。对单个数组元素的读写访问 
    <code class="code">$GLOBALS[&#039;var&#039;]</code> 与之前一样。也将继续支持对整个数组
    <var class="varname"><a href="reserved.variables.globals.php" class="classname">$GLOBALS</a></var> 的只读访问。但是，不再支持对整个 
    <var class="varname"><a href="reserved.variables.globals.php" class="classname">$GLOBALS</a></var> 数组的写访问。例如
    <code class="code">array_pop($GLOBALS)</code> 将返回错误。
   </p>
  </div>

  <div class="sect3" id="migration81.incompatible.core.static-variable-inheritance">
   <h4 class="title">
    在继承的方法中 <span class="modifier">static</span> 变量的用法
   </h4>

   <p class="para">
    当一个方法使用继承的（而不是重写的）静态变量时，继承的方法将与父级共享这个静态变量。
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">A </span><span style="color: #007700">{<br />    public static function </span><span style="color: #0000BB">counter</span><span style="color: #007700">() {<br />        static </span><span style="color: #0000BB">$counter </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">;<br />        </span><span style="color: #0000BB">$counter</span><span style="color: #007700">++;<br />        return </span><span style="color: #0000BB">$counter</span><span style="color: #007700">;<br />    }<br />}<br />class </span><span style="color: #0000BB">B </span><span style="color: #007700">extends </span><span style="color: #0000BB">A </span><span style="color: #007700">{}<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">A</span><span style="color: #007700">::</span><span style="color: #0000BB">counter</span><span style="color: #007700">()); </span><span style="color: #FF8000">// int(1)<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">A</span><span style="color: #007700">::</span><span style="color: #0000BB">counter</span><span style="color: #007700">()); </span><span style="color: #FF8000">// int(2)<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">B</span><span style="color: #007700">::</span><span style="color: #0000BB">counter</span><span style="color: #007700">()); </span><span style="color: #FF8000">// int(3)，之前是 int(1)<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">B</span><span style="color: #007700">::</span><span style="color: #0000BB">counter</span><span style="color: #007700">()); </span><span style="color: #FF8000">// int(4)，之前是 int(2)<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
    这意味着方法中的静态变量现在的使用方式与静态属性一样。
   </p>
  </div>

  <div class="sect3" id="migration81.incompatible.core.optional-before-required">
   <h4 class="title">在强制参数之前指定可选参数</h4>

   <p class="para">
    现在在强制参数之前指定<a href="functions.arguments.php#functions.arguments.default" class="link">可选参数</a>都被视为强制参数，即使是使用<a href="functions.arguments.php#functions.named-arguments" class="link">命名参数</a>调用也是如此。自 PHP 8.0.0 起至 PHP
    8.1.0 之前，在定义时会发出弃用通知，但能成功调用。自 PHP 8.1.0 起，会抛出类为
    <span class="classname"><a href="class.argumentcounterror.php" class="classname">ArgumentCountError</a></span> 的错误，就跟使用位置参数调用一样。

    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">function </span><span style="color: #0000BB">makeyogurt</span><span style="color: #007700">(</span><span style="color: #0000BB">$container </span><span style="color: #007700">= </span><span style="color: #DD0000">"bowl"</span><span style="color: #007700">, </span><span style="color: #0000BB">$flavour</span><span style="color: #007700">)<br />{<br />    return </span><span style="color: #DD0000">"Making a </span><span style="color: #0000BB">$container</span><span style="color: #DD0000"> of </span><span style="color: #0000BB">$flavour</span><span style="color: #DD0000"> yogurt.\n"</span><span style="color: #007700">;<br />}<br />try<br />{<br />    echo </span><span style="color: #0000BB">makeyogurt</span><span style="color: #007700">(</span><span style="color: #0000BB">flavour</span><span style="color: #007700">: </span><span style="color: #DD0000">"raspberry"</span><span style="color: #007700">);<br />}<br />catch (</span><span style="color: #0000BB">Error $e</span><span style="color: #007700">)<br />{<br />    echo </span><span style="color: #0000BB">get_class</span><span style="color: #007700">(</span><span style="color: #0000BB">$e</span><span style="color: #007700">), </span><span style="color: #DD0000">' - '</span><span style="color: #007700">, </span><span style="color: #0000BB">$e</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getMessage</span><span style="color: #007700">(), </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

     <p class="para">以上示例在 PHP 8.0 中的输出：</p>
     <div class="example-contents screen">
<div class="cdata"><pre>
Deprecated: Required parameter $flavour follows optional parameter $container
 in example.php on line 3
Making a bowl of raspberry yogurt.
</pre></div>
     </div>
     <p class="para">以上示例在 PHP 8.1 中的输出：</p>
     <div class="example-contents screen">
<div class="cdata"><pre>
Deprecated: Optional parameter $container declared before required parameter
 $flavour is implicitly treated as a required parameter in example.php on line 3
ArgumentCountError - makeyogurt(): Argument #1 ($container) not passed
</pre></div>
     </div>
    </div>
   </p>
   <p class="para">
    注意，在强制参数之前可以使用 <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> 默认值来指定<a href="language.types.declarations.php#language.types.declarations.nullable" class="link">可为空类型</a>，但仍然需要该参数。
   </p>
  </div>

  <div class="sect3" id="migration81.incompatible.core.type-compatibility-internal">
   <h4 class="title">返回类型与内部类的兼容性</h4>

   <p class="para">
    大多数非 final 的内部方法现在要求重写方法声明一个可兼容的返回类型，否则在继承时会给出方法废弃的提示。如果由于
    PHP 跨版本兼容性的问题，导致不能为重写方法声明返回类型，则可以添加 <span class="classname"><a href="class.returntypewillchange.php" class="classname">ReturnTypeWillChange</a></span> 注解来取消废弃提示。
   </p>
  </div>

  <div class="sect3" id="migration81.incompatible.core.new-keywords">
   <h4 class="title">新的关键词</h4>
   <p class="para">
    现在 <code class="literal">readonly</code> 是一个关键词。不过，它仍然可以被用作函数名。
   </p>
   <p class="para">
    <code class="literal">never</code> 现在是保留字，所以不能用于类，接口或者
    trait，也禁止在命名空间中使用。
   </p>
  </div>
 </div>

 <div class="sect2" id="migration81.incompatible.resource2object">
  <h3 class="title">Resource 类型迁移为 Object 类型</h3>

  <p class="para">
   一些 <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型已被迁移到 <span class="type"><a href="language.types.object.php" class="type object">object</a></span> 类型。要检查返回值，应该从 <span class="function"><a href="function.is-resource.php" class="function">is_resource()</a></span>
   检查是否为资源，更改为检查返回值是否等于 <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。
  </p>
  <ul class="itemizedlist">
   <li class="listitem">
    <p class="para">
     现在 <a href="book.fileinfo.php" class="link">FileInfo</a> 函数接收并返回 <span class="classname"><a href="class.finfo.php" class="classname">finfo</a></span>
     对象类型，而不是 <code class="literal">fileinfo</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     现在 <a href="book.ftp.php" class="link">FTP</a> 函数接收并返回 <span class="classname"><a href="class.ftp-connection.php" class="classname">FTP\Connection</a></span>
     对象类型，而不是 <code class="literal">ftp</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     现在 <a href="book.imap.php" class="link">IMAP</a> 函数接收并返回 <span class="classname"><a href="class.imap-connection.php" class="classname">IMAP\Connection</a></span>
     对象类型，而不是 <code class="literal">imap</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     现在 <a href="book.ldap.php" class="link">LDAP</a> 函数接收并返回 <span class="classname"><a href="class.ldap-connection.php" class="classname">LDAP\Connection</a></span>
     对象类型，而不是 <code class="literal">ldap link</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     现在 <a href="book.ldap.php" class="link">LDAP</a> 函数接收并返回 <span class="classname"><a href="class.ldap-result.php" class="classname">LDAP\Result</a></span>
     对象类型，而不是 <code class="literal">ldap result</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     现在 <a href="book.ldap.php" class="link">LDAP</a> 函数接收并返回 <span class="classname"><a href="class.ldap-result-entry.php" class="classname">LDAP\ResultEntry</a></span>
     对象类型，而不是 <code class="literal">ldap result entry</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     现在 <a href="book.pgsql.php" class="link">PgSQL</a> 函数接收并返回 <span class="classname"><a href="class.pgsql-connection.php" class="classname">PgSql\Connection</a></span>
     对象类型，而不是 <code class="literal">pgsql link</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     现在 <a href="book.pgsql.php" class="link">PgSQL</a> 函数接收并返回 <span class="classname"><a href="class.pgsql-result.php" class="classname">PgSql\Result</a></span>
     对象类型，而不是 <code class="literal">pgsql result</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     现在 <a href="book.pgsql.php" class="link">PgSQL</a> 函数接收并返回 <span class="classname"><a href="class.pgsql-lob.php" class="classname">PgSql\Lob</a></span>
     对象类型，而不是 <code class="literal">pgsql large object</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     现在 <a href="book.pspell.php" class="link">PSpell</a> 函数接收并返回 <span class="classname"><a href="class.pspell-dictionary.php" class="classname">PSpell\Dictionary</a></span>
     对象类型，而不是 <code class="literal">pspell</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     现在 <a href="book.pspell.php" class="link">PSpell</a> 函数接收并返回 <span class="classname"><a href="class.pspell-config.php" class="classname">PSpell\Config</a></span>
     对象类型，而不是 <code class="literal">pspell config</code> <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 类型。
    </p>
   </li>
  </ul>
 </div>

 <div class="sect2" id="migration81.incompatible.mysqli">
  <h3 class="title">MySQLi</h3>

  <p class="para">
   现在 <span class="function"><a href="mysqli-result.fetch-fields.php" class="function">mysqli_fetch_fields()</a></span> 和 <span class="function"><a href="mysqli-result.fetch-field-direct.php" class="function">mysqli_fetch_field_direct()</a></span> 对于 <span class="property">max_length</span>
   将返回 <code class="literal">0</code> 值。这一信息可以迭代结果集来计算，并获取最大长度。这是之前 PHP 内部的做法。
  </p>

  <p class="para">
   常量 <strong><code><a href="mysqli.constants.php#constant.mysqli-stmt-attr-update-max-length">MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH</a></code></strong> 不再生效。
  </p>

  <p class="para">
   常量 <strong><code><a href="mysqli.constants.php#constant.mysqli-store-result-copy-data">MYSQLI_STORE_RESULT_COPY_DATA</a></code></strong> 不再生效。传递给 <span class="methodname"><a href="mysqli.store-result.php" class="methodname">mysqli::store_result()</a></span>
   的 <code class="parameter">mode</code> 参数的所有值不再生效。
  </p>

  <p class="para">
   现在 <span class="methodname"><a href="mysqli.construct.php" class="methodname">mysqli::connect()</a></span> 成功时返回 <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> 而不再返回 <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>。
  </p>

  <p class="para">
   默认错误处理模式已经由 silent 变成了 exception，更多详情及如何设置该属性请参见 <a href="mysqli-driver.report-mode.php" class="link">MySQLi
   报告模式</a>。要恢复之前的行为习惯，请使用：<code class="code">mysqli_report(MYSQLI_REPORT_OFF);</code>
  </p>

  <p class="para">
   现在，扩展 <span class="methodname"><a href="mysqli-stmt.execute.php" class="methodname">mysqli_stmt::execute()</a></span> 类需要指定额外的可选参数。
  </p>
 </div>

 <div class="sect2" id="migration81.incompatible.mysqlnd">
  <h3 class="title">MySQLnd</h3>

  <p class="para">
   <a href="mysqlnd.config.php#ini.mysqlnd.fetch_data_copy" class="link">mysqlnd.fetch_data_copy</a> INI 指令已被取消。这不会造成用户可见的变化。
  </p>
 </div>

 <div class="sect2" id="migration81.incompatible.openssl">
  <h3 class="title">OpenSSL</h3>

  <p class="para">
   现在 EC 私钥将以 <abbr title="Public Key Cryptography Standards">PKCS</abbr>#8 格式导出，而非像其他秘钥那样的传统格式。
  </p>
  <p class="para">
   现在 <span class="function"><a href="function.openssl-pkcs7-encrypt.php" class="function">openssl_pkcs7_encrypt()</a></span> 和 <span class="function"><a href="function.openssl-cms-encrypt.php" class="function">openssl_cms_encrypt()</a></span> 将默认使用 AES-128-CBC，而非
   RC2-40。RC2-40 加密被认为是不安全的，OpenSSL 3 默认不启用。
  </p>
 </div>

 <div class="sect2" id="migration81.incompatible.pdo">
  <h3 class="title">PHP 数据对象</h3>

  <p class="para">
   现在 <strong><code><a href="pdo.constants.php#pdo.constants.attr-stringify-fetches">PDO::ATTR_STRINGIFY_FETCHES</a></code></strong> 的类型从 <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> 变成了字符串 <code class="literal">&quot;0&quot;</code> 或
   <code class="literal">&quot;1&quot;</code>。之前的 <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> 类型没有被字符串化。
  </p>
  <p class="para">
   现在当 <strong><code><a href="pdo.constants.php#pdo.constants.attr-stringify-fetches">PDO::ATTR_STRINGIFY_FETCHES</a></code></strong> 未启用时，以 <strong><code><a href="pdo.constants.php#pdo.constants.param-lob">PDO::PARAM_LOB</a></code></strong> 为参数调用
   <span class="methodname"><a href="pdostatement.bindcolumn.php" class="methodname">PDOStatement::bindColumn()</a></span> 结果将始终绑定流。以前，结果是流或字符串，这取决于所用的数据库驱动及其执行绑定的时间。
  </p>

  <div class="sect3" id="migration81.incompatible.pdo.mysql">
   <h4 class="title">MySQL 驱动</h4>

   <p class="para">
    现在，当使用模拟预处理时，结果集里面的整数及浮点数将会以 PHP 原始类型返回，而不是字符串。这与原生的预处理方式一样。之前的行为方式可以通过
    <strong><code><a href="pdo.constants.php#pdo.constants.attr-stringify-fetches">PDO::ATTR_STRINGIFY_FETCHES</a></code></strong> 恢复。
   </p>
  </div>

  <div class="sect3" id="migration81.incompatible.pdo.sqlite">
   <h4 class="title">SQLite 驱动</h4>

   <p class="para">
    现在，结果集中的整数及浮点数将会以 PHP 原始类型返回。之前的行为方式可以通过 <strong><code><a href="pdo.constants.php#pdo.constants.attr-stringify-fetches">PDO::ATTR_STRINGIFY_FETCHES</a></code></strong> 恢复。
   </p>
  </div>
 </div>

 <div class="sect2" id="migration81.incompatible.phar">
  <h3 class="title">Phar</h3>

  <p class="para">
   为了遵守 <span class="interfacename"><a href="class.arrayaccess.php" class="interfacename">ArrayAccess</a></span> 接口，<span class="methodname"><a href="phar.offsetunset.php" class="methodname">Phar::offsetUnset()</a></span> 和
   <span class="methodname"><a href="phardata.offsetunset.php" class="methodname">PharData::offsetUnset()</a></span> 不再以 <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> 类型返回。
  </p>
 </div>

 <div class="sect2" id="migration81.incompatible.standard">
  <h3 class="title">常规</h3>

  <p class="para">
   <span class="function"><a href="function.version-compare.php" class="function">version_compare()</a></span> 函数不再接收未经记录的操作符缩写。
  </p>

  <p class="para">
   现在 <span class="function"><a href="function.htmlspecialchars.php" class="function">htmlspecialchars()</a></span>、<span class="function"><a href="function.htmlentities.php" class="function">htmlentities()</a></span>、<span class="function"><a href="function.htmlspecialchars-decode.php" class="function">htmlspecialchars_decode()</a></span>、<span class="function"><a href="function.html-entity-decode.php" class="function">html_entity_decode()</a></span>、<span class="function"><a href="function.get-html-translation-table.php" class="function">get_html_translation_table()</a></span>
   使用 <code class="literal">ENT_QUOTES | ENT_SUBSTITUTE</code> 作为默认值，而不再是 <strong><code><a href="string.constants.php#constant.ent-compat">ENT_COMPAT</a></code></strong>。这意味着
   <code class="literal">&#039;</code> 被转义为 <code class="literal">&amp;#039;</code> 而不像之前那样不作处理。此外，有缺陷的
   UTF-8 将被 Unicode 替代字符（substitute character）替换，而不是产生一个空字符串。
  </p>

  <p class="para">
   现在 <span class="function"><a href="function.debug-zval-dump.php" class="function">debug_zval_dump()</a></span> 函数可以打印封装的引用计数了，不仅仅只是打印 <code class="literal">&amp;</code>
   引用计数的值。这更准确地模拟了自 PHP 7.0 以来的引用注解。
  </p>

  <p class="para">
   现在 <span class="function"><a href="function.debug-zval-dump.php" class="function">debug_zval_dump()</a></span> 可打印 <code class="literal">interned</code> 字符串，而不是 interned 字符串和不可变数组的虚拟的引用计数。
  </p>
 </div>

 <div class="sect2" id="migration81.incompatible.spl">
  <h3 class="title">PHP 标准库（SPL）</h3>

  <p class="para">
   <span class="classname"><a href="class.splfixedarray.php" class="classname">SplFixedArray</a></span> 将会像 <span class="type"><a href="language.types.array.php" class="type array">array</a></span> 类型一样被 JSON 编码。
  </p>
 </div>

</div><?php manual_footer($setup); ?>