phpをやっていてカプセル化がわかりません。

Question

phpをやっていてカプセル化がわかりません。

カプセル化をしないと値が変更されてしまう可能性があると書いてありましが、値が変更されてしまう場合というのはどのような時ですか？具体的なプログラミングを用いて教えてもらえるとたすかります。

Comments

[m.ts10806]

自身が調べたこと試したことを記載してください。
「これがなければアプリケーションができない」というようなものではないので、盛り込むのが必須と言うわけではありません。
それも含めて「採用可否」も検討必要があるので（オブジェクト指向自体もそうですが）、全体的なクラス設計などする段階で考慮すべきものだったりします。つまり、「カプセル化って何」だけを理解しても使えないということですね

Answer 1

こんな感じで分かりますか？
カプセル化しても値は変更できます。想定外の使い方をされないようにするのがポイントです。

publicはガードがまったくできませんし、
ただアクセッサーを用意しただけでは、そのクラスの仕様をしらないと正しく利用できない可能性があります。
※よくある、このメソッドを呼んだら、このメソッドをあわせて呼べみたいなやつ

仕様をメソッドにうまく隠ぺいすることをカプセル化といいます。

class Worst
{
    public $speed = 0;
    public $fuel = 100;
}

class NoGood
{
    private $speed = 0;
    private $fuel = 100;
    
    public function setSpeed($speed) {
        if ($speed < 0) return;

        $this->speed = $speed;
    }
    public function setFuel($amount) {
        if ($amount < 0) return;

        $this->fuel = $amount;
    }
}

class Better
{
    private $speed = 0;
    private $fuel = 100;
    
    public function speedUp() {
        $this->fuel -= 1;
        $this->speed += 1;
    }
    public function speedDown() {
        $this->speed -= 1;
    }
}

追記

想定外の使われ方をされないためと書いてありますが、それはどのような時ですか？

プログラム内での処理の中でされるのか、それともこのサービスを使ってるユーザーによる想定外の入力によってなのか、教えていただけたら助かります。

"プログラム内での処理の中でされる"方です。
想定外の入力というより（入力も含みますが）、利用方法です。
サンプルの例だとスピードをあげたら、燃料を減らす処理が必要という仕様がある前提で
カプセル化をしないと、燃料を減らす処理を、そのクラスを利用するプログラマが書かないと上記の仕様が満たされません

docコメントに、setSpeedを呼んだら、それに合わせてsetFuelを呼び出してください
なんてのがあったらカプセル化できていないと思っていいです。

クラス化やカプセル化は、そもそもプログラミングの技術・技法の話でプログラマ向けの話です。
そもそもユーザには関係ない話だと思いますが・・・

サービスという表現が気になります。webサービス、WebAPIのようなものを想定しているのでしたら、
それらは基本的にカプセル化されているはずです（厳密にはカプセル化という表現は誤解を招くと思いますが）

WebAPIで、このAPIをたたく前に、これをして・・・あれをして・・・というのがあれば設計がダサイ。

内部の暗黙のルール(仕様)を外部に公開せずに利用できるようにメソッドを作成/公開することをカプセル化といいます。

変数をprivateにしてアクセッサーを用意することをカプセル化という説明を見たことがありますが、
かなり説明不足だと思います。

Comments

[satakehirohumi]

回答ありがとうございます！
想定外の使われ方をされないためと書いてありますが、それはどのような時ですか？
プログラム内での処理の中でされるのか、それともこのサービスを使ってるユーザーによる想定外の入力によってなのか、教えていただけたら助かります。

[momon-ga]

"プログラム内での処理の中でされる"方です。
想定外の入力というより（入力も含みますが）、利用方法です。
サンプルの例だとスピードをあげたら、燃料を減らす処理が必要という仕様がある前提で
カプセル化をしないと、燃料を減らす処理をプログラマが書かないと上記の仕様が満たされません