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
6 changes: 3 additions & 3 deletions appendices/migration70/incompatible/variable-handling.xml
Original file line number Diff line number Diff line change
Expand Up @@ -254,12 +254,12 @@ array(2) {

<sect3 xml:id="migration70.incompatible.variable-handling.parentheses">
<title>
関数のパラメータを括弧で囲んでもその振る舞いは変わらない
関数の引数を括弧で囲んでもその振る舞いは変わらない
</title>

<para>
PHP 5 では、関数のパラメータを冗長な括弧で囲んでおくと
関数のパラメータを参照渡しにした場合の警告を抑止することができました
PHP 5 では、関数の引数を冗長な括弧で囲んでおくと
関数の引数を参照渡しにした場合の警告を抑止することができました
PHP 7 では、たとえ括弧で囲んでも警告が常に発生します。
</para>

Expand Down
16 changes: 8 additions & 8 deletions appendices/migration71/changed-functions.xml
Original file line number Diff line number Diff line change
Expand Up @@ -16,13 +16,13 @@
<itemizedlist>
<listitem>
<simpara>
<function>getopt</function> に、オプションの第三引数が追加されました
これは参照渡しの引数で、処理対象の引数リストの次の要素のインデックスが格納されます。
<function>getopt</function> に、オプションの第三パラメータが追加されました
これは参照渡しのパラメータで、処理対象の引数リストの次の要素のインデックスが格納されます。
</simpara>
</listitem>
<listitem>
<simpara>
<function>getenv</function> の引数が必須ではなくなりました
<function>getenv</function> のパラメータが必須ではなくなりました
省略した場合は、現在の環境変数の内容を連想配列で返します。
</simpara>
</listitem>
Expand All @@ -44,7 +44,7 @@
</listitem>
<listitem>
<simpara>
<function>unpack</function> にオプションの第三引数が追加されました
<function>unpack</function> にオプションの第三パラメータが追加されました
アンパックの開始位置を指定することができます。
</simpara>
</listitem>
Expand Down Expand Up @@ -125,14 +125,14 @@
</listitem>
<listitem>
<simpara>
<function>pg_fetch_all</function> にオプションの第二引数が追加されました。戻される結果の型を指定できます
(<function>pg_fetch_array</function> の第三引数と同じです)。
<function>pg_fetch_all</function> にオプションの第二パラメータが追加されました。戻される結果の型を指定できます
(<function>pg_fetch_array</function> の第三パラメータと同じです)。
</simpara>
</listitem>
<listitem>
<simpara>
<function>pg_select</function> にオプションの第四引数が追加されました。戻される結果の型を指定できます
(<function>pg_fetch_array</function> の第三引数と同じです)。
<function>pg_select</function> にオプションの第四パラメータが追加されました。戻される結果の型を指定できます
(<function>pg_fetch_array</function> の第三パラメータと同じです)。
</simpara>
</listitem>
</itemizedlist>
Expand Down
4 changes: 2 additions & 2 deletions appendices/migration71/incompatible.xml
Original file line number Diff line number Diff line change
Expand Up @@ -635,12 +635,12 @@ object(stdClass)#1 (1) {
<sect2 xml:id="migration71.incompatible.mbstring">
<title>
<function>mb_ereg</function> および <function>mb_eregi</function>
関数の引数のセマンティクスの変更
関数のパラメータのセマンティクスの変更
</title>
<para>
<function>mb_ereg</function> 関数 と
<function>mb_eregi</function> 関数
の第3引数 (<parameter>regs</parameter>) は、
の第3パラメータ (<parameter>regs</parameter>) は、
マッチするものがなかった場合、空の配列が設定されるようになりました。
これより前のバージョンでは、このパラメータは変更されませんでした。
</para>
Expand Down
4 changes: 2 additions & 2 deletions appendices/migration80/deprecated.xml
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
<itemizedlist>
<listitem>
<para>
デフォルト値を持つ引数の後に、必須の引数が続く場合、デフォルト値は意味をなしません。
デフォルト値を持つパラメータの後に、必須のパラメータが続く場合、デフォルト値は意味をなしません。
こうした書き方は PHP 8.0.0 から推奨されなくなります。
以下のようにしてデフォルト値を削除することで、機能を変更することなく解決できます:
</para>
Expand All @@ -26,7 +26,7 @@ function test($a, $b) {} // 変更後
</programlisting>
</para>
<para>
このルールの唯一の例外は、<code>Type $param = null</code> と書かれた引数です
このルールの唯一の例外は、<code>Type $param = null</code> と書かれたパラメータです
null をデフォルトにすることは、型が暗黙のうちに nullable であることを示しています。
この書き方はまだ許可されていますが、以下のようにして 明示的に nullable 型を使うことを推奨します:
</para>
Expand Down
2 changes: 1 addition & 1 deletion appendices/migration80/incompatible.xml
Original file line number Diff line number Diff line change
Expand Up @@ -668,7 +668,7 @@ $array["key"];
<listitem>
<para>
<function>call_user_func_array</function> 関数に渡される
配列のキーは、引数名として解釈されるようになりました
配列のキーは、パラメータ名として解釈されるようになりました
これより前のバージョンでは、静かに無視されていました。
</para>
</listitem>
Expand Down
10 changes: 5 additions & 5 deletions appendices/migration80/new-features.xml
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@
</listitem>
<listitem>
<para>
任意の数の関数の引数が、可変長引数に置き換えられるようになりました。
任意の数の関数のパラメータが、可変長引数に置き換えられるようになりました。
但し、型に互換性がある場合に限ります。
たとえば、次のようなコードが書けるようになります:
</para>
Expand Down Expand Up @@ -174,7 +174,7 @@ $user = $session->user ?? throw new Exception('Must have user');
</listitem>
<listitem>
<para>
引数のリストに付ける最後のカンマも、オプションで許可されるようになりました。
パラメータのリストに付ける最後のカンマも、オプションで許可されるようになりました。
<programlisting role="php">
<![CDATA[
<?php
Expand Down Expand Up @@ -399,7 +399,7 @@ class ChildClass extends ParentClass {
<itemizedlist>
<listitem>
<para>
以下のメソッドは、内部関数の引数のデフォルト値に関する情報を返すようになりました:
以下のメソッドは、内部関数のパラメータのデフォルト値に関する情報を返すようになりました:
</para>
<para>
<simplelist>
Expand Down Expand Up @@ -559,8 +559,8 @@ array_intersect(...$arrays);
</listitem>
<listitem>
<para>
<function>ob_implicit_flush</function> 関数の <parameter>flag</parameter>
引数が、<type>int</type> ではなく <type>bool</type> を受け取るように変更されました。
<function>ob_implicit_flush</function> 関数の <parameter>flag</parameter>
パラメータが、<type>int</type> ではなく <type>bool</type> を受け取るように変更されました。
</para>
</listitem>
</itemizedlist>
Expand Down
14 changes: 7 additions & 7 deletions appendices/migration81/incompatible.xml
Original file line number Diff line number Diff line change
Expand Up @@ -62,13 +62,13 @@ var_dump(B::counter()); // int(4), 以前のバージョンでは int(2)
</sect3>

<sect3 xml:id="migration81.incompatible.core.optional-before-required">
<title>必須の引数の前に、デフォルト値を持つ引数を指定した場合</title>
<title>必須のパラメータの前に、デフォルト値を持つパラメータを指定した場合</title>

<para>
必須の引数の前に
<link linkend="functions.arguments.default">デフォルト値を持つ引数</link>
必須のパラメータの前に
<link linkend="functions.arguments.default">デフォルト値を持つパラメータ</link>
を指定した場合、
デフォルト値を持つ引数は常に必須の引数として扱われるようになりました
デフォルト値を持つパラメータは常に必須のパラメータとして扱われるようになりました
これは、
<link linkend="functions.named-arguments">名前付き引数</link>
を使って関数を呼び出した場合でも同様です。
Expand Down Expand Up @@ -117,10 +117,10 @@ ArgumentCountError - makeyogurt(): Argument #1 ($container) not passed
</informalexample>
</para>
<para>
但し、必須の引数の前であっても
但し、必須のパラメータの前であっても
<link linkend="language.types.declarations.nullable">Null を許容する型</link> を指定するために、
引数にデフォルト値 &null; を指定できることに注意して下さい。
その場合でも、その引数は必須であることには変わりありません
パラメータにデフォルト値 &null; を指定できることに注意して下さい。
その場合でも、そのパラメータは必須であることには変わりありません
</para>
</sect3>

Expand Down
6 changes: 3 additions & 3 deletions appendices/migration81/new-features.xml
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,7 @@ $arr2 = [...$arr1, 'c' => 'd']; //[1, 'a' => 'b', 'c' => 'd']
<title>初期化時の &new; 式の許可</title>

<para>
<code>new ClassName()</code> 式が、引数のデフォルト値の初期化時
<code>new ClassName()</code> 式が、パラメータのデフォルト値の初期化時
static 変数の初期化時、グローバルな定数の初期化時、
およびアトリビュートの引数として許可されるようになりました。
オブジェクトが <function>define</function> に渡せるようにもなっています。
Expand Down Expand Up @@ -393,11 +393,11 @@ echo $h, "\n";
</sect3>

<sect3 xml:id="migration81.new-features.mysqli.bind-in-execute">
<title>実行時に引数をバインド</title>
<title>実行時にパラメータをバインド</title>

<para>
<methodname>mysqli_stmt::execute</methodname>
に配列を指定することで、引数をバインドできるようになりました
に配列を指定することで、パラメータをバインドできるようになりました
全ての値が、文字列としてバインドされます。
(連想配列でない) リストだけを指定できます。
この新機能は、MySQLi を libmysqlclient
Expand Down
4 changes: 2 additions & 2 deletions language/enumerations.xml
Original file line number Diff line number Diff line change
Expand Up @@ -637,7 +637,7 @@ enum Suit implements Colorful
列挙型の case は、定数として表現されているので、
ほとんどの定数式の中で静的な値として使えます。
つまり、プロパティのデフォルト値や、
static 変数のデフォルト値、引数のデフォルト値
static 変数のデフォルト値、パラメータのデフォルト値
グローバル定数やクラス定数の値として使えます。
列挙型の case 以外の値は使えませんが、
通常の定数は、列挙型の case を参照できます。
Expand Down Expand Up @@ -1062,7 +1062,7 @@ enum UserStatus: string
<literal>UserStatus::Suspended</literal> または
<literal>UserStatus::CanceledByUser</literal>
のうちのひとつに限られています。
関数は引数の型を <literal>UserStatus</literal>
関数はパラメータの型を <literal>UserStatus</literal>
に指定できますし、これら4つの値だけを受け入れます。
</para>

Expand Down
38 changes: 19 additions & 19 deletions language/functions.xml
Original file line number Diff line number Diff line change
Expand Up @@ -236,8 +236,8 @@ $v = foo(
<para>
PHP 8.0.0 以降では、関数のパラメーターリストの最後にカンマをつけることができます。
このカンマは無視されます。
これは、引数リストや変数名が長かったりした場合に
引数を縦に並べるのに便利です
これは、パラメータリストや変数名が長かったりした場合に
パラメータを縦に並べるのに便利です
</para>
<example>
<title>関数のパラメーターリストの最後にカンマを付ける</title>
Expand Down Expand Up @@ -307,7 +307,7 @@ echo $str; // 出力は 'This is a string, and something extra.' となりま
</para>
<para>
<example>
<title>関数におけるデフォルト引数の使用法</title>
<title>関数におけるデフォルトパラメータの使用法</title>
<programlisting role="php">
<![CDATA[
<?php
Expand All @@ -332,7 +332,7 @@ Making a cup of espresso.
</example>
</para>
<para>
デフォルト引数の値には、スカラー値、
デフォルトパラメータの値には、スカラー値、
配列、および特殊な型 &null; を指定できます。
PHP 8.1.0 以降では、
<link linkend="language.oop5.basic.new">new ClassName()</link>
Expand Down Expand Up @@ -387,8 +387,8 @@ echo makecoffee(new FancyCoffeeMaker);
(例えば) 変数やクラスのメンバーであってはなりません。
</simpara>
<para>
デフォルト値を有する引数は
デフォルト値がない引数の右側に全てある必要があることに注意して下さい
デフォルト値を有するパラメータは
デフォルト値がないパラメータの右側に全てある必要があることに注意して下さい
そうでない場合、デフォルト値を指定していても、
呼び出し時に省略できません。
次の簡単なコードを見てみましょう。
Expand Down Expand Up @@ -445,13 +445,13 @@ Making a bowl of raspberry yogurt.
</para>
<para>
PHP 8.0.0 以降では、
デフォルト値を指定した引数を複数スキップするために
デフォルト値を指定したパラメータを複数スキップするために
<link linkend="functions.named-arguments">名前付き引数</link>
が使えます。
</para>
<para>
<example>
<title>関数の引数のデフォルト値の 正しい使用法</title>
<title>関数のパラメータのデフォルト値の 正しい使用法</title>
<programlisting role="php">
<![CDATA[
<?php
Expand Down Expand Up @@ -493,7 +493,7 @@ Making a bowl of raspberry natural yogurt.
function foo($a = [], $b) {} // デフォルト値が使われないため、PHP 8.0.0 以降は推奨されません
function foo($a, $b) {} // 上のコードと機能的には同じですが、推奨されない警告は発生しません。

// PHP 8.1.0以降、$a は暗黙的に必須(必須の引数の前にあるため)ですが、
// PHP 8.1.0以降、$a は暗黙的に必須(必須のパラメータの前にあるため)ですが、
// デフォルトのパラメータ値が null であるため、暗黙的に nullable とみなされます(PHP 8.4.0で非推奨)。
function bar(A $a = null, $b) {}
function bar(?A $a, $b) {} // 推奨される書き方です。
Expand All @@ -505,7 +505,7 @@ Making a bowl of raspberry natural yogurt.
<note>
<simpara>
PHP 7.1.0 以降では、
デフォルト値を指定しないで引数を省略すると
デフォルト値を指定しないでパラメータを省略すると
<classname>ArgumentCountError</classname>
がスローされるようになりました。
これより前のバージョンでは、警告が発生していました。
Expand Down Expand Up @@ -648,9 +648,9 @@ Catchable fatal error: Argument 2 passed to total_intervals() must be an instanc
</para>

<para>
名前付き引数は、引数の名前の後にコロンを付けたものを、値の前に付けることで指定します。
引数の名前に予約語を使うことも許されています
引数の名前は識別子でなければならず、動的に指定することは出来ません。
名前付き引数は、パラメータの名前の後にコロンを付けたものを、値の前に付けることで指定します。
パラメータの名前に予約語を使うことも許されています
パラメータの名前は識別子でなければならず、動的に指定することは出来ません。
</para>

<example>
Expand Down Expand Up @@ -1047,7 +1047,7 @@ $func(); // "bar" を表示します。
例えば、<function>str_replace</function>は変更された文字列を
返すのに対し、<function>usort</function>は与えられた引数そのものを
変更します。マニュアルの各項にはそれぞれの関数に関する情報があります。
関数の引数、振る舞いの変更、成功した場合失敗した場合の
関数のパラメータ、振る舞いの変更、成功した場合失敗した場合の
それぞれの戻り値、可用性に関する情報などです。
これらの重要な(時には微妙な)違いを知ることは、
正しいPHPコードを書くうえで極めて重要なことです。
Expand All @@ -1068,18 +1068,18 @@ $func(); // "bar" を表示します。
デフォルトの自動変換(coercive)モードの場合、
null を渡すことが出来ます。
PHP 8.1.0 以降では、
nullable として宣言されていない内部関数の引数に &null; を渡すことは推奨されなくなり、
nullable として宣言されていない内部関数のパラメータに &null; を渡すことは推奨されなくなり、
自動変換モードでは警告が発生するようになっています。
ユーザ定義の関数においては、スカラー型の引数は nullable と明示的にマークする必要があり、その振る舞いと合わせるためです。
</para>

<para>
たとえば、<function>strlen</function>
関数は引数 <literal>$string</literal>
関数はパラメータ <literal>$string</literal>
に null でない文字列を渡すことを期待しています。
歴史的な理由により、
PHP は自動変換モードの場合に、
この引数に &null; を渡すことを許可してきました。
このパラメータに &null; を渡すことを許可してきました。
結果として、引数に &null;
を渡すと暗黙のうちに文字列にキャストされ、
結果は空文字列 <literal>""</literal> になっていました。
Expand Down Expand Up @@ -1449,7 +1449,7 @@ Warning: Cannot bind an instance to a static closure in %s on line %d
<entry>
無名関数は、&link.superglobals; や、
<varname>$this</varname>, もしくは
引数と同じ名前の変数を use で引き継げなくなりました。
パラメータと同じ名前の変数を use で引き継げなくなりました。
</entry>
</row>
</tbody>
Expand Down Expand Up @@ -1547,7 +1547,7 @@ var_export($fn(5)(10));
</para>
<simpara>
無名関数と同じように、
アロー関数の文法は、引数や戻り値、デフォルト値、可変長引数、
アロー関数の文法は、パラメータや戻り値、デフォルト値、可変長引数、
リファレンス渡しやリファレンス返しを含む、任意の関数シグネチャを扱えます。
次に示す例は、全て正しいアロー関数の例です:
</simpara>
Expand Down
4 changes: 2 additions & 2 deletions language/namespaces.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1240,9 +1240,9 @@ namespace foo;

class MyClass {}

// 現在の名前空間のクラスを引数の型として使う
// 現在の名前空間のクラスをパラメータの型として使う
function test(MyClass $parameter_type_example = null) {}
// 現在の名前空間のクラスを引数の型として使うもうひとつの方法
// 現在の名前空間のクラスをパラメータの型として使うもうひとつの方法
function test(\foo\MyClass $parameter_type_example = null) {}

// 現在の名前空間のクラスの継承
Expand Down
Loading