PHP 核心

• 如果具有預設值的參數後面跟著一個必填參數，則預設值將失效。此用法自 PHP 8.0.0 起已被棄用，通常可以透過移除預設值來解決，而不會改變功能。

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

  此規則的一個例外是 Type $param = null 形式的參數，其中 null 預設值使類型隱式可為 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，外部實體載入預設會被停用，因此除非使用（仍然容易受到攻擊的）LIBXML_NOENT，否則不再需要此函式來防範 XXE 攻擊。在這種情況下，建議使用 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()

標準函式庫 (Standard Library)

• 排序比較函式若回傳 true 或 false 現在會拋出棄用警告，並且應該改用回傳小於、等於或大於零的整數的實作方式來取代。

  <?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'];
}
?>

反射 (Reflection)

• ReflectionFunction::isDisabled() 已被棄用，因為不再能為已停用的函式建立 ReflectionFunction。此方法現在一律回傳 false。

• ReflectionParameter::getClass()、ReflectionParameter::isArray() 和 ReflectionParameter::isCallable() 已被棄用。應該改用 ReflectionParameter::getType() 和 ReflectionType API。