[PHP 8.4] fix php/doc-en#4063 (PHP 8.4: trigger_error() updates) (#191)

* [WIP] work on php/doc-en#4063 * #191 Insert original content ref: php/doc-en@72b70d7 * #191 Translate * #194 Fix element position
php · Nov 25, 2024 · 2d5c271 · 2d5c271
1 parent 722af66
commit 2d5c271
Showing 1 changed file with 30 additions and 3 deletions.
diff --git a/reference/errorfunc/functions/trigger-error.xml b/reference/errorfunc/functions/trigger-error.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 210d382b5b139444fe2e16a5a3211076a65ff2ba Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 72b70d7c3c3b2b87423641906da2db407c32c3c3 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi -->
 <refentry xml:id="function.trigger-error" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -42,6 +42,14 @@
       <para>
        このエラーに割り当てられたエラー型です。<constant>E_USER_<replaceable>*</replaceable></constant> の定数のみが指定可能で、デフォルトは <constant>E_USER_NOTICE</constant> です。
       </para>
+      <warning>
+       <simpara>
+        <parameter>error_level</parameter> として
+        <constant>E_USER_ERROR</constant> を指定するのは非推奨となりました。
+        かわりに、<exceptionname>Exception</exceptionname> をスローするか、
+        <function>exit</function> を呼び出してください。
+       </simpara>
+      </warning>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -77,6 +85,22 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       <parameter>error_level</parameter> として
+       <constant>E_USER_ERROR</constant> を指定するのは非推奨となりました。
+       かわりに、<exceptionname>Exception</exceptionname> をスローするか、
+       <function>exit</function> を呼び出してください。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       戻り値の型が、<type>bool</type> ではなく
+       <type>true</type> に変更されました。
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>
@@ -102,9 +126,11 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-if ($divisor == 0) {
-    trigger_error("ゼロで割ることはできません", E_USER_ERROR);
+$password = $_POST['password'] ?? '';
+if ($password === '') {
+  trigger_error("空のパスワードを使用することは安全ではありません", E_USER_WARNING);
 }
+$hash = password_hash($password, PASSWORD_DEFAULT);
 ?>
 ]]>
     </programlisting>
@@ -129,6 +155,7 @@ if ($divisor == 0) {
     <member><function>set_error_handler</function></member>
     <member><function>restore_error_handler</function></member>
     <member><link linkend="errorfunc.constants">エラーレベル定数</link></member>
+    <member><classname>Deprecated</classname> アトリビュート</member>
    </simplelist>
   </para>
  </refsect1>