## PHP 8.0 废弃的功能

### PHP 核心中废弃的功能

- 如果带有默认值的参数后面跟着一个必要的参数，那么默认值就会无效。这在 PHP 8.0.0 中已被废弃，通常可以通过删除默认值，不影响现有功能：

      <?php
      function test($a = [], $b) {} // 之前
      function test($a, $b) {}      // 之后
      ?>

  这条规则的一个例外是 `Type $param = null` 形式的参数，其中 null 的默认值使得类型隐式为空。这种用法仍然是允许的，但仍建议使用显式可空类型。

      <?php
      function test(A $a = null, $b) {} // 旧写法，仍可用
      function test(?A $a, $b) {}       // 推荐写法
      ?>

- 参数 `exclude_disabled` 不能设置为 `false` 来调用 get_defined_functions()，该参数已被废弃，不再起作用。 get_defined_functions() 绝不会再包含禁用的函数。

### Enchant

- 弃用 enchant_broker_set_dict_path() 和 enchant_broker_get_dict_path() ，因为此功能在 libenchant < 1.5 和 libenchant-2 中均不可用。

- 弃用 enchant_dict_add_to_personal()，使用 enchant_dict_add() 替代。

- 弃用 enchant_dict_is_in_session()，使用 enchant_dict_is_added() 替代。

- 弃用 enchant_broker_free() 和 enchant_broker_free_dict()，取而代之的是取消对象。

- 弃用 `ENCHANT_MYSPELL` 和 `ENCHANT_ISPELL` 常量。

### LibXML

弃用 libxml_disable_entity_loader()。由于现在需要 libxml 2.9.0，默认情况下会禁用外部实体加载并且不再需要此函数来防止 XXE 攻击，除非使用（仍然易受攻击的） `LIBXML_NOENT`。在这种情况下，建议使用 libxml_set_external_entity_loader() 重构代码以抑制外部实体加载。

### PGSQL / PDO PGSQL

- 现在常量 `PGSQL_LIBPQ_VERSION_STR` 的值与 `PGSQL_LIBPQ_VERSION`相同，因此废弃。

- pgsql 扩展中的函数别名已废弃。请参阅以下列表了解应该使用那些函数：

  - pg_errormessage() → pg_last_error()
  - pg_numrows() → pg_num_rows()
  - pg_numfields() → pg_num_fields()
  - pg_cmdtuples() → pg_affected_rows()
  - pg_fieldname() → pg_field_name()
  - pg_fieldsize() → pg_field_size()
  - pg_fieldtype() → pg_field_type()
  - pg_fieldnum() → pg_field_num()
  - pg_result() → pg_fetch_result()
  - pg_fieldprtlen() → pg_field_prtlen()
  - pg_fieldisnull() → pg_field_is_null()
  - pg_freeresult() → pg_free_result()
  - pg_getlastoid() → pg_last_oid()
  - pg_locreate() → pg_lo_create()
  - pg_lounlink() → pg_lo_unlink()
  - pg_loopen() → pg_lo_open()
  - pg_loclose() → pg_lo_close()
  - pg_loread() → pg_lo_read()
  - pg_lowrite() → pg_lo_write()
  - pg_loreadall() → pg_lo_read_all()
  - pg_loimport() → pg_lo_import()
  - pg_loexport() → pg_lo_export()
  - pg_setclientencoding() → pg_set_client_encoding()
  - pg_clientencoding() -> pg_client_encoding()

### 标准库

- 排序比较函数现在返回 `true` 或者 `false` 将会引发弃用警告，应替换为返回小于、等于或者大于零的 int 值。

      <?php
      // 替换
      usort($array, fn($a, $b) => $a > $b);
      // 为
      usort($array, fn($a, $b) => $a <=> $b);
      ?>

### Zip

- 弃用使用空文件作为 ZipArchive。Libzip 1.6.0 不再接受空文件作为有效的 zip 归档。现有的解决方案将在下个版本删除。

- 弃用面向过程的 Zip API。使用 ZipArchive 替代。可以使用 ZipArchive::statIndex() 和 for 循环完成对所有条目的迭代：

      <?php
      // 使用面向过程 API 进行迭代
      assert(is_resource($zip));
      while ($entry = zip_read($zip)) {
          echo zip_entry_name($entry);
      }

      // 使用面向对象 API 进行迭代
      assert($zip instanceof ZipArchive);
      for ($i = 0; $entry = $zip->statIndex($i); $i++) {
          echo $entry['name'];
      }
      ?>

### 反射

- 弃用 ReflectionFunction::isDisabled()，因为不可能再为禁用的函数创建 ReflectionFunction。此方法现在总是返回 `false`。

- 弃用 ReflectionParameter::getClass()、 ReflectionParameter::isArray()、 ReflectionParameter::isCallable()。 应该使用 ReflectionParameter::getType() 和 ReflectionType API 替代。

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open