도구
로그인
한국어

코드 배우기PHP

PHP 캡슐화

PHP 8.3 기준readonly · PHP 8.1 부터

은행 계좌 잔액을 private 과 readonly 로 감춰요. 감추지 않았을 때 생기는 버그부터 봐요.

한 줄 뜻

캡슐화는 객체의 속을 숨기고, 정해 둔 메서드로만 값을 바꾸게 하는 일이에요. PHP 에서는 private·protected 로 숨기고, readonly 로 한 번 넣은 값을 못 바꾸게 막아요.

왜 필요한가

잔액이 public 이면 컨트롤러, 관리자 화면, 크론 스크립트 어디서든 $acct->balance -= ... 를 사용할 수 있어요. 그중 한 곳만 검사를 빼먹어도 잔액이 음수가 돼요.

잔액을 private 으로 감추고 deposit()·withdraw() 만 열어 두면 규칙(0 이하 거절, 잔액보다 많이 빼기 거절, 기록 남기기)이 한 곳에 모여요. 규칙이 바뀌어도 그 두 메서드만 고치면 돼요.

일상 비유

은행 창구를 떠올려 보세요. 손님은 금고에 손을 넣지 못하고 창구 직원에게 "입금해 주세요"라고 말할 뿐이에요. 직원은 위조지폐인지, 잔액이 모자라지 않은지 보고 통장에 한 줄을 찍어요. 금고가 private 속성이고 창구가 메서드예요.

캡슐화를 안 했을 때 생기는 버그

<?phpclass Account{    public string $owner;    public int $balance;     public function __construct(string $owner, int $balance)    {        $this->owner = $owner;        $this->balance = $balance;    }} $acct = new Account('Haneul', 30000);$acct->balance -= 45000;$acct->owner = 'nobody';echo "{$acct->owner}: {$acct->balance}\n";

실행하면

nobody: -15000

속성이 모두 public 이라 30000원 계좌에서 45000원을 빼는 줄이 통과했어요. 잔액이 -15000원이 돼도 막는 코드가 없어요.

계좌 주인 이름까지 아무 줄에서나 바꿀 수 있어서 nobody 가 됐어요. 이런 줄이 컨트롤러 여기저기에 흩어지면 누가 잔액을 망가뜨렸는지 찾느라 하루가 가요.

예제 코드

main.php · 63줄
<?phpdeclare(strict_types=1); final class Account{    private int $balance = 0;    private array $log = [];     public function __construct(        public readonly string $owner,        int $opening,    ) {        $this->deposit($opening);    }     public function deposit(int $amount): void    {        if ($amount <= 0) {            throw new InvalidArgumentException("deposit must be positive: $amount");        }        $this->balance += $amount;        $this->log[] = "+$amount";    }     public function withdraw(int $amount): void    {        if ($amount > $this->balance) {            throw new DomainException("not enough money: $amount > {$this->balance}");        }        $this->balance -= $amount;        $this->log[] = "-$amount";    }     public function balance(): int    {        return $this->balance;    }     public function history(): array    {        return $this->log;    }} $acct = new Account('Haneul', 30000);$acct->withdraw(12000);try {    $acct->withdraw(45000);} catch (DomainException $e) {    echo 'Refused: ', $e->getMessage(), "\n";}try {    $acct->deposit(-500);} catch (InvalidArgumentException $e) {    echo 'Refused: ', $e->getMessage(), "\n";}try {    $acct->owner = 'nobody';} catch (Error $e) {    echo 'Blocked: ', $e->getMessage(), "\n";}echo "{$acct->owner}: {$acct->balance()}\n";echo 'History: ', implode(', ', $acct->history()), "\n";

언제 사용하나

  • 값에 지켜야 할 규칙이 있을 때(음수 금지, 최대 길이, 날짜 순서)
  • 값이 바뀔 때마다 기록·알림 같은 일을 같이 해야 할 때
  • 한 번 정하면 바뀌면 안 되는 값일 때(주인 이름, 주문 번호) → readonly

readonly 는 PHP 8.1 부터, 클래스 전체를 readonly class 로 적는 것은 8.2 부터 돼요. 8.4 부터는 public private(set) int $balance 처럼 읽기와 쓰기 공개 범위를 따로 정할 수 있어요(새 버전 기능 · 8.3 에서는 안 돼요).

자주 하는 실수

private 속성을 밖에서 직접 읽음

private 은 클래스 안에서만 보여요. 밖에서는 읽기조차 안 되니, 읽기를 허락하려면 balance() 같은 메서드를 열어 둬요. 그 메서드 안에서 단위를 바꾸거나 권한을 검사할 수도 있어요.

틀린 코드

$acct = new Account('Haneul', 30000);echo $acct->balance, "\n";

실행하면Fatal error: Uncaught Error: Cannot access private property Account::$balance

고친 코드

$acct = new Account('Haneul', 30000);echo $acct->balance(), "\n";

실행하면30000

숨긴 속성에 든 객체를 그대로 내줌

private 으로 숨겨도 그 안의 DateTime 객체를 돌려주면 받은 쪽이 같은 객체를 고쳐 버려요. 배열은 복사되지만 객체는 같은 것을 가리키기 때문이에요. 바뀌지 않는 DateTimeImmutable 을 사용하면 modify() 가 원래 값을 두고 새 객체를 돌려줘요. 아니면 clone 해서 내줘요.

틀린 코드

final class Booking{    public function __construct(private DateTime $day)    {    }     public function day(): DateTime    {        return $this->day;    }} $b = new Booking(new DateTime('2026-05-01'));$b->day()->modify('+7 days');echo $b->day()->format('Y-m-d'), "\n";

실행하면2026-05-08

고친 코드

final class Booking{    public function __construct(private DateTimeImmutable $day)    {    }     public function day(): DateTimeImmutable    {        return $this->day;    }} $b = new Booking(new DateTimeImmutable('2026-05-01'));$later = $b->day()->modify('+7 days');echo $b->day()->format('Y-m-d'), ' / ', $later->format('Y-m-d'), "\n";

실행하면2026-05-01 / 2026-05-08

private 에 아무 값이나 받는 setter 를 붙임

속성을 숨겨 놓고 setBalance() 로 무엇이든 넣게 하면 public 과 다를 게 없어요. 메서드 이름을 하는 일(deposit, withdraw)로 짓고, 그 안에서 틀린 값을 막아요.

틀린 코드

final class Wallet{    private int $balance = 0;     public function setBalance(int $value): void    {        $this->balance = $value;    }     public function balance(): int    {        return $this->balance;    }} $w = new Wallet();$w->setBalance(-999);echo $w->balance(), "\n";

실행하면-999

고친 코드

final class Wallet{    private int $balance = 0;     public function deposit(int $amount): void    {        if ($amount <= 0) {            throw new InvalidArgumentException('deposit must be positive');        }        $this->balance += $amount;    }     public function balance(): int    {        return $this->balance;    }} $w = new Wallet();try {    $w->deposit(-999);} catch (InvalidArgumentException $e) {    echo $e->getMessage(), "\n";}echo $w->balance(), "\n";

실행하면deposit must be positive 0

확인 문제

문제 1

예제의 Account 에서 밖에서 $acct->balance = 0; 이라고 쓰면?

답과 까닭 보기

답: 2. `Error` 가 나요 private 속성은 밖에서 읽지도 쓰지도 못해요. PHP 가 Error 를 던지고 잔액은 그대로예요.

문제 2

history() 로 받은 배열에 한 줄을 더했어요. 계좌 안 기록은 몇 줄일까요?

$acct = new Account('Joon', 500);$h = $acct->history();$h[] = '+999999';echo count($acct->history()), "\n";

답과 까닭 보기

답: 1. 1 PHP 배열은 넘길 때 복사돼요. $h 에 더한 줄은 사본에만 붙어서 계좌 안 기록은 처음 입금 한 줄 그대로예요.

자주 묻는 것

private 속성은 밖에서 읽을 수도 없나요?

네. 읽기와 쓰기 모두 Error 가 나요. 읽게 하려면 balance() 같은 메서드를 열어 두거나 public readonly 로 둬요.

readonly 와 private 은 어떻게 다른가요?

private 은 누가 볼 수 있는지를, readonly 는 한 번 넣은 뒤 바꿀 수 있는지를 정해요. public readonly 면 누구나 읽지만 아무도 못 바꿔요.

getter·setter 를 모두 만들어야 하나요?

아니요. 값을 아무렇게나 바꾸는 setter 는 public 속성과 같아요. deposit·withdraw 처럼 하는 일로 이름 지은 메서드에서 검사해요.