Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
27 changes: 2 additions & 25 deletions README_Glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@
ここには、PHP マニュアル 日本語版で「統一した」訳語を当てている単語を記録しています。
以下の単語の訳がブレていたら、issue または Pull Request で報告してください。

機械的に検出できる訳語・表記(長音の有無など)は [build/prh.yml](build/prh.yml) で管理しており、CI(Textlint)で検出されます。

- visibility
* 「アクセス権」で統一
* protected/private/public を付けた、メソッドやプロパティが可視な範囲のこと
Expand All @@ -18,18 +20,9 @@
- strict モードの対比の文脈で、coercive を「強制する」と訳さない
- language construct
* 言語構造
- unserialize
* アンシリアライズ ( [#21](https://github.com/php/doc-ja/issues/21) )
- 「デシリアライズ」や「アンマーシャリング」にはしない
- nullable
* nullable のままにする。訳さない。
- null を受け入れる何か、という意味だが、PHP マニュアル日本語版では「訳さない」で統一。
- serialize
* シリアライズ / シリアル化
- 「マーシャリング」にはしないこと
- メソッドや変数に付ける static
* static メソッド / static 変数 とする ( [#45](https://github.com/php/doc-ja/issues/45 ), [#46](https://github.com/php/doc-ja/issues/46) )
- 静的変数や静的メソッドなどとはしない
- numeric string
* 数値形式の文字列
- preload
Expand All @@ -41,14 +34,6 @@
* 移行ガイドの文脈での Standard は「標準ライブラリ」で統一する
- php-src で言うところの ext/standard に入っている関数全てを指す
- Standard PHP Librady (SPL) は別にあるが、「標準ライブラリ」でいいことにする
- WHATWG URL Standard
* 「WHATWG URL Standard」(原語のまま)で統一
- ext/uri などで言及される、URL 仕様の固有名詞
- 「WHATWG URL 標準」とはしない
- throw Exception
* 例外をスローする
- 例外を「投げる」とはしない
- Throwable を throw するという文脈ではすべてこれに統一する
- parameters / arguments
* パラメータ / 引数
- 以下の2つは明示的に区別されるべきである
Expand All @@ -66,11 +51,3 @@ test([1234]);
* 「オーバーライド」で統一 ( [#26](https://github.com/php/doc-ja/issues/26) )
- 継承の文脈(メソッド、プロパティ、定数の再定義)では「上書き」を使わない
- 「上書き」はファイルや設定値、配列の値を書き換える文脈 (overwrite) でのみ使う
- fatal error
* 致命的なエラー ( [#321](https://github.com/php/doc-ja/issues/321) )
- 「fatal エラー」としない
- parser
* 「パーサー」と伸ばす。「パーサ」としない ( [#310](https://github.com/php/doc-ja/issues/310) )
- server と同様、末尾の長音記号を付ける
- server
* 「サーバー」と伸ばす。「サーバ」としない ( [#69](https://github.com/php/doc-ja/issues/69) )
2 changes: 1 addition & 1 deletion appendices/migration70/incompatible/error-handling.xml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<title>エラーや例外の取り扱いの変更</title>

<para>
fatal error や recoverable fatal error の多くが、PHP 7 では例外に変換されるようになりました。
致命的なエラーや回復可能な致命的なエラーの多くが、PHP 7 では例外に変換されるようになりました。
これらの例外は <classname>Error</classname> クラスを継承したもので、
このクラスは <classname>Throwable</classname> インターフェイスを実装しています。
この新しいインターフェイスを、すべての例外が実装しています。
Expand Down
2 changes: 1 addition & 1 deletion appendices/migration70/incompatible/other.xml
Original file line number Diff line number Diff line change
Expand Up @@ -343,7 +343,7 @@ switch (1) {

<para>
カスタムセッションハンドラとして実装した関数が
&false; あるいは <literal>-1</literal> を返すとき、fatal error が発生します。
&false; あるいは <literal>-1</literal> を返すとき、致命的なエラーが発生します。
この関数が boolean 値か <literal>-1</literal>, あるいは
<literal>0</literal> 以外を返す場合は、その関数は失敗して E_WARNING が発生します。
</para>
Expand Down
2 changes: 1 addition & 1 deletion appendices/migration70/incompatible/strings.xml
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ var_dump($int); // int(65535)
<para>
<link linkend="migration70.new-features.unicode-codepoint-escape-syntax">Unicode コードポイントのエスケープ構文</link>
が導入されたことにより、<literal>\u{</literal> のあとに無効なシーケンスが続く文字列が
fatal error となる可能性があります。
致命的なエラーとなる可能性があります。
これを回避するには、先頭のバックスラッシュをエスケープする必要があります。
</para>
</sect3>
Expand Down
6 changes: 3 additions & 3 deletions appendices/migration71/incompatible.xml
Original file line number Diff line number Diff line change
Expand Up @@ -421,7 +421,7 @@ new DateTime() == new DateTime();
DBA 拡張モジュールでは、
(<function>dba_insert</function> のように)
データを変更する関数は、キーが正確にふたつの要素を含んでいない場合に
キャッチ可能な fatal error ではなく、
キャッチ可能な致命的なエラーではなく、
<classname>Error</classname> 例外をスローするようになりました。
</para>

Expand All @@ -448,7 +448,7 @@ new DateTime() == new DateTime();
Intl 拡張モジュールでは、
<classname>Collator</classname> クラスを継承したクラスで、
親メソッドを呼ぶ前に親のコンストラクタを呼ぶのに失敗すると、
回復可能な fatal error にはならず、
回復可能な致命的なエラーにはならず、
<classname>Error</classname> 例外をスローするようになりました。

同様に、<classname>Transliterator</classname> を clone すると、
Expand Down Expand Up @@ -527,7 +527,7 @@ new DateTime() == new DateTime();
<para>
standard 拡張モジュールでは、
<function>assert</function>関数 の
最初のパラメーターに string 型の引数が与えられた場合、
最初のパラメータに string 型の引数が与えられた場合、
かつ PHP のコードが不正だった場合に
キャッチ可能な致命的なエラーではなく、
<classname>ParseError</classname> 例外をスローするようになりました。
Expand Down
4 changes: 2 additions & 2 deletions appendices/migration74/deprecated.xml
Original file line number Diff line number Diff line change
Expand Up @@ -209,8 +209,8 @@
</para>
<para>
<function>mb_strrpos</function>
関数に、3番目のパラメーターとしてエンコーディングを渡すのは推奨されません。代わりに
0から始まるオフセットを渡すか、4番目のパラメーターとしてエンコーディングを渡すようにします。
関数に、3番目のパラメータとしてエンコーディングを渡すのは推奨されません。代わりに
0から始まるオフセットを渡すか、4番目のパラメータとしてエンコーディングを渡すようにします。
</para>
</sect2>

Expand Down
4 changes: 2 additions & 2 deletions appendices/migration85/new-features.xml
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ print $result . PHP_EOL; // Prints "11"

<simplelist>
<member>アトリビュートの引数</member>
<member>プロパティやパラメーターのデフォルト値</member>
<member>プロパティやパラメータのデフォルト値</member>
<member>定数および、クラス定数</member>
</simplelist>

Expand Down Expand Up @@ -292,7 +292,7 @@ print T1 . PHP_EOL; // Prints "0"
リクエストが送信される前に libcurl
の接続キューで待機した時間(マイクロ秒単位)を取得できます。
<function>curl_getinfo</function> の <parameter>option</parameter>
パラメーターに <constant>CURLINFO_QUEUE_TIME_T</constant>
パラメータに <constant>CURLINFO_QUEUE_TIME_T</constant>
を渡すことで、値が取得できます。
</simpara>

Expand Down
63 changes: 63 additions & 0 deletions build/prh.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,10 @@ rules:
pattern:
- デシリアライズ
- アンマーシャリング

- expected: シリアライズ
pattern: マーシャリング

- expected: static $1
pattern: /静的な?(変数|メソッド|プロパティ)/
specs:
Expand All @@ -17,6 +19,7 @@ rules:
to: static プロパティ
- from: 遅延静的束縛
to: 遅延静的束縛

- expected: $1スローする
pattern: /((?:例外|Exception|Error|Throwable) ?を)投げる/
specs:
Expand All @@ -26,6 +29,7 @@ rules:
to: Exceptionをスローする
- from: TypeError を投げる
to: TypeError をスローする

- expected: $1スローし$2
pattern: /((?:例外|Exception|Error|Throwable) ?を)投げ(て|た|ま[しすせ])/
specs:
Expand All @@ -35,6 +39,7 @@ rules:
to: Exceptionをスローして
- from: TypeError を投げた
to: TypeError をスローした

- expected: $1スローされ
pattern: /((?:例外|Exception|Error|Throwable) ?が)投げられ/
specs:
Expand All @@ -44,29 +49,87 @@ rules:
to: Exceptionがスローされます
- from: TypeError が投げられた
to: TypeError がスローされた

- expected: サーバー
pattern: /サーバ(?!ー)/
specs:
- from: サーバ
to: サーバー
- from: サーバー
to: サーバー

- expected: オーバーライド
pattern: /オーバ(?!ー)ライド/
specs:
- from: オーバライド
to: オーバーライド
- from: オーバーライド
to: オーバーライド

- expected: WHATWG URL Standard
pattern: WHATWG URL 標準
prh: URL 仕様の固有名詞なので原語のままにする
specs:
- from: WHATWG URL 標準
to: WHATWG URL Standard
- from: WHATWG URL Standard
to: WHATWG URL Standard

- expected: ファイルディスクリプタ
pattern: ファイル記述子
specs:
- from: ファイル記述子
to: ファイルディスクリプタ

- expected: パラメータ
pattern: パラメーター
prh: 既存の訳文の多数派に合わせて長音を付けない
specs:
- from: パラメーター
to: パラメータ

- expected: パーサー
pattern: /パーサ(?!ー)/
prh: 「サーバー」に合わせて長音を付ける
specs:
- from: パーサ
to: パーサー
- from: パーサー
to: パーサー

- expected: イテレータ
pattern: イテレーター
prh: 既存の訳文の多数派に合わせて長音を付けない
specs:
- from: イテレーター
to: イテレータ

- expected: ジェネレータ
pattern: ジェネレーター
prh: 既存の訳文の多数派に合わせて長音を付けない
specs:
- from: ジェネレーター
to: ジェネレータ

- expected: 致命的なエラー
pattern: /[Ff]atal ?エラー/
specs:
- from: fatal エラー
to: 致命的なエラー
- from: Fatalエラー
to: 致命的なエラー

- expected: 致命的なエラー
pattern: /[Ff]atal error(?= ?[ぁ-んァ-ヶー一-龠々、。])/
prh: 日本語の文中の fatal error を検出している。PHP の出力やコード中の英語はそのままにする
specs:
- from: fatal error が発生します
to: 致命的なエラー が発生します
- from: キャッチ可能な fatal error ではなく
to: キャッチ可能な 致命的なエラー ではなく
- from: "Fatal error: Uncaught Error"
to: "Fatal error: Uncaught Error"
- from: a fatal error has occurred
to: a fatal error has occurred
- from: 致命的なエラー (fatal error)
to: 致命的なエラー (fatal error)
2 changes: 1 addition & 1 deletion language/errors/php7.xml
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@
ブロックで現れます。
マッチするブロックがなければ、<function>set_exception_handler</function>
で設定したデフォルトの例外ハンドラが呼ばれます。
デフォルトの例外ハンドラもない場合は、例外が fatal error に変換されて、
デフォルトの例外ハンドラもない場合は、例外が致命的なエラーに変換されて、
これまでのバージョンのエラーと同じように扱われます。
</para>

Expand Down
4 changes: 2 additions & 2 deletions language/exceptions.xml
Original file line number Diff line number Diff line change
Expand Up @@ -23,14 +23,14 @@
その途中で見つかった全ての &finally; ブロックが実行されます。
グローバルスコープに遡るまで全てのコールスタックを探しても、
マッチする &catch; ブロックが見つからない場合は、
グローバルな例外ハンドラが設定されていない限り fatal error となり、
グローバルな例外ハンドラが設定されていない限り致命的なエラーとなり、
プログラムが終了します。
</para>
<para>
スローされるオブジェクトは、
&instanceof; <interfacename>Throwable</interfacename> でなければなりません。
それ以外のオブジェクトをスローしようとすると
PHP の fatal error が発生します。
PHP の致命的なエラーが発生します。
</para>
<para>
PHP 8.0.0 以降では、&throw; キーワードは式として扱えるようになり、
Expand Down
4 changes: 2 additions & 2 deletions language/generators.xml
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
<link linkend="functions.returning-values">return</link>
するのではなく、必要に応じて何度でも &yield; することができます。
つまり、値を繰り返し返せるということです。
イテレーターと同じく、ランダムアクセスはできません。
イテレータと同じく、ランダムアクセスはできません。
</para>

<simpara>
Expand Down Expand Up @@ -328,7 +328,7 @@ foreach (gen_reference() as &$number) {
<title><command>yield from</command> によるジェネレータの委譲</title>

<para>
ジェネレーターを委譲することで、
ジェネレータを委譲することで、
別のジェネレータや <classname>Traversable</classname> オブジェクトあるいは配列から、
<command>yield from</command> キーワードを使って値を yield できます。
外側のジェネレータは、内側のジェネレータ (あるいはオブジェクトや配列) から受け取れるすべての値を yield し、
Expand Down
2 changes: 1 addition & 1 deletion language/oop5/interfaces.xml
Original file line number Diff line number Diff line change
Expand Up @@ -279,7 +279,7 @@ class C implements B
}
}

// これは動作せず、fatal error となります。
// これは動作せず、致命的なエラーとなります。
class D implements B
{
public function foo()
Expand Down
6 changes: 3 additions & 3 deletions language/operators/functional.xml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<titleabbrev>パイプ演算子</titleabbrev>
<para>
PHP 8.5 以降では、callable に直接値を渡す演算子をサポートしています。
<literal>|&gt;</literal> 演算子、または "パイプ" は、右辺にパラメーターをひとつ取る
<literal>|&gt;</literal> 演算子、または "パイプ" は、右辺にパラメータをひとつ取る
callable を受け入れ、左辺値をそれに渡し、callable の結果を評価します。
右辺の callable は、有効な PHP の callable であれば何でも構いません:
つまり、<classname>Closure</classname>、
Expand Down Expand Up @@ -95,9 +95,9 @@ Array
</para>
<para>
パイプの左側は、値や式であれば何でも構いません。
パイプの右側は、パラメーターをひとつ取る PHP の有効な callable か、
パイプの右側は、パラメータをひとつ取る PHP の有効な callable か、
そのように評価できる任意の式であれば何でも構いません。
必須のパラメーターをひとつ以上とる関数を右側に指定した場合、
必須のパラメータをひとつ以上とる関数を右側に指定した場合、
それは許可されず、
引数が不足した状態で関数をコールしたかのように失敗します。
リファレンスの値を取る関数も許可されていません。
Expand Down
2 changes: 1 addition & 1 deletion language/predefined/compileerror.xml
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
<para>
<ooclass><classname>CompileError</classname></ooclass> は
コンパイルエラーが起きた時にスローされます。
以前は fatal error が発生していました。
以前は致命的なエラーが発生していました。
</para>
</section>

Expand Down
2 changes: 1 addition & 1 deletion language/predefined/countable/count.xml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
<simpara>
このメソッドは、
<function>count</function> 関数の
<parameter>value</parameter> パラメーターが
<parameter>value</parameter> パラメータが
<classname>Countable</classname> を実装している場合に実行されます。
</simpara>
</refsect1>
Expand Down
6 changes: 3 additions & 3 deletions language/predefined/generator/rewind.xml
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,10 @@
<void/>
</methodsynopsis>
<para>
<emphasis>最初の</emphasis> &yield; までジェネレーターを実行します。
ジェネレーターが既に <emphasis>最初の</emphasis> &yield; に到達している場合、
<emphasis>最初の</emphasis> &yield; までジェネレータを実行します。
ジェネレータが既に <emphasis>最初の</emphasis> &yield; に到達している場合、
何も行いません。
ジェネレーターが &yield; 式を越えて進んでいる場合、
ジェネレータが &yield; 式を越えて進んでいる場合、
このメソッドは <classname>Exception</classname> をスローします。
</para>

Expand Down
2 changes: 1 addition & 1 deletion reference/curl/constants.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1768,7 +1768,7 @@
</term>
<listitem>
<simpara>
サーバー上のパラメーターを設定します。
サーバー上のパラメータを設定します。
cURL 7.20.0 以降で利用可能です。
</simpara>
</listitem>
Expand Down
Loading
Loading