Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Merged
merged 4 commits into from
Nov 25, 2024
Merged

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

Changes from 3 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
899361f
[WIP] work on php/doc-en#4063
o0h Nov 24, 2024
5d6470f
#191 Insert original content
o0h Nov 24, 2024
c09c0ce
#191 Translate
o0h Nov 24, 2024
dae9dfe
#194 Fix element position
o0h Nov 25, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 30 additions & 3 deletions reference/errorfunc/functions/trigger-error.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 -->
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

php/doc-en@72b70d7

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

<!-- CREDITS: takagi -->
<refentry xml:id="function.trigger-error" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -46,6 +46,14 @@
</varlistentry>
</variablelist>
</para>
<warning>
<simpara>
<parameter>error_level</parameter> として
<constant>E_USER_ERROR</constant> を指定するのは非推奨となりました。
かわりに、<exceptionname>Exception</exceptionname> をスローするか、
<function>exit</function> を呼び出してください。
</simpara>
</warning>
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

preview:
image

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

訳はLGTMです。位置なのですが、この <warning> セクションは:

原文: <para>The designated error type ...</para>
訳文: <para>このエラーに割り当てられた...</para>

この要素のすぐ下に追加されているようです。

文言追加位置

</refsect1>

<refsect1 role="returnvalues">
Expand Down Expand Up @@ -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>
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

preview:
image

<row>
<entry>8.0.0</entry>
<entry>
Expand All @@ -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>
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

preview:
image

Expand All @@ -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>
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

他の箇所でも「アトリビュート」「属性」の訳語が揺れていそうで、一旦「アトリビュート」にしています。
migrationの表記は以下

doc-ja/appendices/migration84/new-features.xml

Lines 130 to 136 in c378f9b

<simpara>
新しい <classname>Deprecated</classname> 属性を使用して、関数、メソッド、
およびクラス定数を非推奨としてマークできます。このアトリビュートで非推奨となった機能の動作は、
PHP 自身が提供する既存の非推奨メカニズムの動作と一致します。
唯一の例外は、発生するエラーコードが
<constant>E_DEPRECATED</constant> ではなく <constant>E_USER_DEPRECATED</constant> であることです。
</simpara>

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

preview:
image

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

ありがとうございます！私も アトリビュート が良いと思います。

普通名詞の意味の「属性」ではなく、固有シンタックスを指していることが明確にわかりますね。
（8.4から離れてしまいますが、見つけた箇所はプルリク作成いただいて大丈夫です。私も見つけ次第修正していきます。）

</simplelist>
</para>
</refsect1>
Expand Down