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

Jump to bottom

[PHP 8.4] 「非対称可視性プロパティ」の翻訳 #153

Merged
merged 3 commits into from
Nov 14, 2024
+213 −63
Merged

[PHP 8.4] 「非対称可視性プロパティ」の翻訳 #153

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b276a83
[PHP 8.4] 「非対称可視性プロパティ」の翻訳
KentarouTakeda Nov 9, 2024
ecf0bf5
用語の統一: 参照 → リファレンス
KentarouTakeda Nov 12, 2024
77615d4
非対称が許可される条件を正確にし表現も見直し
KentarouTakeda Nov 12, 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
57 changes: 37 additions & 20 deletions language/oop5/final.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5e8652131e898cd3d02cd26eeb26da718a6aaf65 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 16f66c05a4060a7d673ae1c70b656d65009407b0 Maintainer: hirokawa Status: ready -->

<sect1 xml:id="language.oop5.final" xmlns="http://docbook.org/ns/docbook">
<title>finalキーワード</title>
<para>
キーワード <literal>final</literal>
を前に付けて定義されたメソッドや定数は、子クラスから上書きできません。
を前に付けて定義されたメソッドやプロパティ、定数は、子クラスから上書きできません。
クラス自体がfinalと定義された場合には、このクラスを拡張することはできません。
</para>
<para>
Expand Down Expand Up @@ -61,38 +61,55 @@ class ChildClass extends BaseClass {
</programlisting>
</example>
</para>
<para>
<example xml:id="language.oop5.final.example.php81">
<title>final定数の例(PHP 8.1.0 以降)</title>
<programlisting role="php">
<example>
<title>finalプロパティの例(PHP 8.4.0 以降)</title>
<programlisting role="php">
<![CDATA[
<?php
class BaseClass {
final protected string $test;
}

class ChildClass extends BaseClass {
public string $test;
}
// Results in Fatal error: Cannot override final property BaseClass::$test
?>
]]>
</programlisting>
</example>
<example xml:id="language.oop5.final.example.php81">
<title>final定数の例(PHP 8.1.0 以降)</title>
<programlisting role="php">
<![CDATA[
<?php
class Foo
{
final public const X = "foo";
}

class Bar extends Foo
{
public const X = "bar";
}

// Fatal error: Bar::X cannot override final constant Foo::X
?>
]]>
</programlisting>
</example>
</para>
<note>
<simpara>
プロパティを final として宣言することはできません。
final として宣言できるのはクラスとメソッド、
および定数(PHP 8.1.0以降)だけです。
</simpara>
<simpara>
PHP 8.0.0 以降は、private メソッドを final として宣言できるのはコンストラクタだけになりました。
</simpara>
</note>
</programlisting>
</example>

<note>
<simpara>
PHP 8.0.0 以降は、private メソッドを final として宣言できるのは<link linkend="language.oop5.decon.constructor">コンストラクタ</link>だけになりました。
</simpara>
</note>
<note>
<simpara>
<link linkend="language.oop5.visibility-members-aviz"><literal>private(set)</literal></link> として宣言されたプロパティは暗黙的に<literal>final</literal>になります。
</simpara>
</note>
</sect1>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
11 changes: 8 additions & 3 deletions language/oop5/properties.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: f94d903985119d3ac00f4528551df947f57b667f Maintainer: takagi Status: ready -->
<!-- EN-Revision: 16f66c05a4060a7d673ae1c70b656d65009407b0 Maintainer: takagi Status: ready -->
<!-- CREDITS: mumumu -->

<sect1 xml:id="language.oop5.properties" xmlns="http://docbook.org/ns/docbook">
Expand Down Expand Up @@ -204,8 +204,13 @@ Fatal error: Uncaught Error: Typed property Shape::$numberOfSides must not be ac
<title>読み取り専用プロパティ</title>
<para>
PHP 8.1.0 以降では、<code>readonly</code>
を付けてプロパティを宣言できます。
これによって、プロパティを初期化した後に値が変更されることを防止できます。
を付けてプロパティを宣言できます。これによって、プロパティを初期化した後に値が変更されることを防止できます。
PHP 8.4.0より前では、<literal>readonly</literal> プロパティは暗黙的に private-set であり、
同じクラス内からのみ書き込みが可能でした。
PHP 8.4.0からは、<literal>readonly</literal> プロパティは暗黙的に
<link linkend="language.oop5.visibility-members-aviz"><literal>protected(set)</literal></link> となり、
子クラスからも設定可能です。必要に応じて明示的に
オーバーライドすることもできます。
<example>
<title>読み取り専用プロパティの例</title>
<programlisting role="php">
Expand Down
185 changes: 149 additions & 36 deletions language/oop5/visibility.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f5e5b54129045a7d02c5285a88cea0abff8ffb6f Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 7d7b378abd302430b8ce7cedb4b78c7033f5e88c Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi,mumumu -->

<sect1 xml:id="language.oop5.visibility" xmlns="http://docbook.org/ns/docbook">
<title>アクセス権</title>
<para>
プロパティ、メソッドまたは (PHP 7.1.0 以降) 定数のアクセス権 (visibility) は、
キーワード: <literal>public</literal>, <literal>protected</literal>
または <literal>private</literal> を指定することにより定義できます。
public 宣言されたクラスのメンバーには、どこからでもアクセス可能です。
protected 宣言されたメンバーには、
そのクラス自身、そのクラスを継承したクラス、および親クラスからのみアクセスできます。
private 宣言されたメンバーには、そのメンバーを定義したクラスからのみアクセスできます。
</para>
<sect1 xml:id="language.oop5.visibility" xmlns="http://docbook.org/ns/docbook">
<title>アクセス権</title>
<para>
プロパティ、メソッドまたは (PHP 7.1.0 以降) 定数のアクセス権 (visibility) は、
キーワード: <literal>public</literal>, <literal>protected</literal>
または <literal>private</literal> を指定することにより定義できます。
public 宣言されたクラスのメンバーには、どこからでもアクセス可能です。
protected 宣言されたメンバーには、
そのクラス自身、そのクラスを継承したクラス、および親クラスからのみアクセスできます。
private 宣言されたメンバーには、そのメンバーを定義したクラスからのみアクセスできます。
</para>

<sect2 xml:id="language.oop5.visibility-members">
<title>プロパティのアクセス権</title>
Expand All @@ -23,10 +23,9 @@
アクセス権を明示的に指定しない場合、
そのプロパティは public として定義されます。
</para>
<para>
<example>
<title>プロパティの宣言</title>
<programlisting role="php">
<example>
<title>プロパティの宣言</title>
<programlisting role="php">
<![CDATA[
<?php
/**
Expand Down Expand Up @@ -81,17 +80,135 @@ $obj2->printHello(); // Public2, Protected2, Undefined を表示します
]]>
</programlisting>
</example>
</para>
</sect2>
<sect3 xml:id="language.oop5.visibility-members-aviz">
<title>非対称可視性プロパティ</title>
<simpara>
PHP 8.4 から、プロパティは非対称に
可視性を設定できるようになりました。
読み取り(<literal>get</literal>)と書き込み(<literal>set</literal>)に
異なるスコープを設定できます。具体的には、<literal>set</literal> の可視性が
メインの可視性より広くならない限り、
別々に指定できます。
</simpara>
<example>
<title>非対称可視性プロパティ</title>
<programlisting role="php">
<![CDATA[
<?php
class Book
{
public function __construct(
public private(set) string $title,
public protected(set) string $author,
protected private(set) int $pubYear,
) {}
}

<sect2 xml:id="language.oop5.visiblity-methods">
<title>メソッドのアクセス権</title>
<para>
クラスメソッドは、public, private, または protected
として定義します。アクセス権を明示せずに宣言したメソッドは、
public となります。
</para>
<para>
class SpecialBook extends Book
{
public function update(string $author, int $year): void
{
$this->author = $author; // OK
$this->pubYear = $year; // 致命的なエラー
}
}

$b = new Book('How to PHP', 'Peter H. Peterson', 2024);

echo $b->title; // OK
echo $b->author; // OK
echo $b->pubYear; // 致命的なエラー

$b->title = 'How not to PHP'; // 致命的なエラー
$b->author = 'Pedro H. Peterson'; // 致命的なエラー
$b->pubYear = 2023; // 致命的なエラー
?>
]]>
</programlisting>
</example>
<para>非対称可視性プロパティにはいくつかの注意点があります:</para>
<itemizedlist>
<listitem>
<simpara>
型付きプロパティのみが、<literal>set</literal> の可視性を個別に指定できます。
</simpara>
</listitem>
<listitem>
<simpara>
<literal>set</literal> の可視性は、<literal>get</literal> と同じか、
より厳しくなければなりません。つまり、
<code>public protected(set)</code> および <code>protected protected(set)</code>
は許可されますが、<code>protected public(set)</code> は構文エラーになります。
</simpara>
</listitem>
<listitem>
<simpara>
プロパティが <literal>public</literal> の場合、メインの可視性は
省略できます。つまり、<code>public private(set)</code> と <code>private(set)</code> は
同じ結果になります。
</simpara>
</listitem>
<listitem>
<simpara>
<literal>private(set)</literal> の可視性を持つプロパティは
自動的に <literal>final</literal> となり、子クラスで再宣言できません。
</simpara>
</listitem>
<listitem>
<simpara>
プロパティへのリファレンスを取得する場合、<literal>get</literal> ではなく <literal>set</literal> の可視性に従います。
これは、リファレンスを使用してプロパティの値を変更できるためです。
</simpara>
</listitem>
<listitem>
<simpara>
同様に、配列プロパティへの書き込みを試みると、内部的には <literal>get</literal> と
<literal>set</literal> の両方の操作が行われます。そのため、常により厳しい <literal>set</literal>
の可視性に従います。
</simpara>
</listitem>
</itemizedlist>
<simpara>
クラスが別のクラスを拡張するとき、子クラスは
<literal>final</literal> でない任意のプロパティを再定義できます。その際、
新しい可視性が親クラスと同じか広い場合に限り、メインの可視性または <literal>set</literal>
の可視性を広げることができます。ただし、
<literal>private</literal> プロパティがオーバーライドされると、
実際には親のプロパティを変更するのではなく、
異なる内部名を持つ新しいプロパティを作成することに注意してください。
</simpara>
<example>
<title>非対称可視性プロパティの継承</title>
<programlisting role="php">
<![CDATA[
<?php
class Book
{
protected string $title;
public protected(set) string $author;
protected private(set) int $pubYear;
}

class SpecialBook extends Book
{
public protected(set) $title; // OK。読み取りの可視性が広く、書き込みは同じだから。
public string $author; // OK。読み取りの可視性は同じで、書き込みが広いから。
public protected(set) int $pubYear; // 致命的なエラー。private(set) プロパティは final です。
}
?>
]]>
</programlisting>
</example>
</sect3>
</sect2>

<sect2 xml:id="language.oop5.visiblity-methods">
<title>メソッドのアクセス権</title>
<para>
クラスメソッドは、public, private, または protected
として定義します。アクセス権を明示せずに宣言したメソッドは、
public となります。
</para>
<example>
<title>メソッドの宣言</title>
<programlisting role="php">
Expand Down Expand Up @@ -182,8 +299,7 @@ $myFoo->test(); // Bar::testPrivate
]]>
</programlisting>
</example>
</para>
</sect2>
</sect2>

<sect2 xml:id="language.oop5.visiblity-constants">
<title>定数のアクセス権</title>
Expand All @@ -192,10 +308,9 @@ $myFoo->test(); // Bar::testPrivate
として定義できるようになりました。
明示的に公開範囲のキーワードを明示的に宣言しない定数は、public として定義されます。
</para>
<para>
<example>
<title>PHP 7.1.0 以降での定数の宣言</title>
<programlisting role="php">
<example>
<title>PHP 7.1.0 以降での定数の宣言</title>
<programlisting role="php">
<![CDATA[
<?php
/**
Expand Down Expand Up @@ -246,9 +361,8 @@ echo MyClass2::MY_PUBLIC; // 動作します
$myclass2->foo2(); // Public, Protected では動作しますが、Private では動作しません
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</sect2>

<sect2 xml:id="language.oop5.visibility-other-objects">
Expand Down Expand Up @@ -304,7 +418,6 @@ Accessed the private method.
</example>
</sect2>
</sect1>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
7 changes: 6 additions & 1 deletion reference/reflection/reflectionproperty/isprivate.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: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: takagi Status: ready -->
<!-- EN-Revision: 16f66c05a4060a7d673ae1c70b656d65009407b0 Maintainer: takagi Status: ready -->

<refentry xml:id="reflectionproperty.isprivate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand Down Expand Up @@ -29,6 +29,11 @@
<para>
private プロパティである場合に &true;、それ以外の場合に &false; を返します。
</para>
<note>
<simpara>
これはデフォルトの可視性のみを参照します。<link linkend="language.oop5.visibility-members-aviz"><literal>set</literal> の可視性</link>は指定されていても無視されることに注意してください。
</simpara>
</note>
</refsect1>

<refsect1 role="seealso">
Expand Down
7 changes: 6 additions & 1 deletion reference/reflection/reflectionproperty/isprotected.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: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: takagi Status: ready -->
<!-- EN-Revision: 16f66c05a4060a7d673ae1c70b656d65009407b0 Maintainer: takagi Status: ready -->

<refentry xml:id="reflectionproperty.isprotected" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand Down Expand Up @@ -29,6 +29,11 @@
<para>
protected プロパティである場合に &true;、それ以外の場合に &false; を返します。
</para>
<note>
<simpara>
これはデフォルトの可視性のみを参照します。<link linkend="language.oop5.visibility-members-aviz"><literal>set</literal> の可視性</link>は指定されていても無視されることに注意してください。
</simpara>
</note>
</refsect1>

<refsect1 role="seealso">
Expand Down
Loading