한 줄 뜻 캡슐화는 객체의 속을 숨기고, 정해 둔 메서드로만 값을 바꾸게 하는 일이에요. PHP 에서는 private·protected 로 숨기고, readonly 로 한 번 넣은 값을 못 바꾸게 막아요.
왜 필요한가 잔액이 public 이면 컨트롤러, 관리자 화면, 크론 스크립트 어디서든 $acct->balance -= ... 를 사용할 수 있어요. 그중 한 곳만 검사를 빼먹어도 잔액이 음수가 돼요.
잔액을 private 으로 감추고 deposit()·withdraw() 만 열어 두면 규칙(0 이하 거절, 잔액보다 많이 빼기 거절, 기록 남기기)이 한 곳에 모여요. 규칙이 바뀌어도 그 두 메서드만 고치면 돼요.
일상 비유 은행 창구를 떠올려 보세요. 손님은 금고에 손을 넣지 못하고 창구 직원에게 "입금해 주세요"라고 말할 뿐이에요. 직원은 위조지폐인지, 잔액이 모자라지 않은지 보고 통장에 한 줄을 찍어요. 금고가 private 속성이고 창구가 메서드예요.
캡슐화를 안 했을 때 생기는 버그 <?php class 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줄 실행 복사 고쳐 보기 처음 코드로 <?php declare (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" ;
고친 코드는 실행 단추로 돌려 볼 수 있어요. 한 줄씩 따라가기와 위 실행 결과는 원래 코드 기준이에요.
한 줄씩 따라가기 시작 전 다음을 누르면 클래스 아래 실행 코드의 첫 줄부터 움직여요. 밝은 띠가 방금 실행한 줄이고, 메서드 안으로 들어가면 띠도 따라 들어가요.
처음 이전 다음
실행 결과 Refused: not enough money: 45000 > 18000 Refused: deposit must be positive: -500 Blocked: Cannot modify readonly property Account::$owner Haneul: 18000 History: +30000, -12000 서버의 PHP(CLI)와 브라우저 안 PHP 8.3 두 곳에서 돌려 같게 나온 결과예요.
클래스 그림 Account - balance: int - log: array + owner: string (readonly) + __construct(owner, opening) + deposit(int): void + withdraw(int): void + balance(): int + history(): array + public · # protected · - private · 밑줄 static · 기울임 abstract · (readonly) 처음 한 번만 넣는 속성
언제 사용하나 값에 지켜야 할 규칙이 있을 때(음수 금지, 최대 길이, 날짜 순서) 값이 바뀔 때마다 기록·알림 같은 일을 같이 해야 할 때 한 번 정하면 바뀌면 안 되는 값일 때(주인 이름, 주문 번호) → 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; 이라고 쓰면?
1 잔액이 0 이 돼요 2 Error 가 나요3 아무 일도 없이 지나가요
답과 까닭 보기 답: 2. `Error` 가 나요 private 속성은 밖에서 읽지도 쓰지도 못해요. PHP 가 Error 를 던지고 잔액은 그대로예요.
문제 2
history() 로 받은 배열에 한 줄을 더했어요. 계좌 안 기록은 몇 줄일까요?
$acct = new Account ('Joon' , 500 );$h = $acct ->history ();$h [] = '+999999' ;echo count ($acct ->history ()), "\n" ;1 1 2 2 3 오류가 나요
답과 까닭 보기 답: 1. 1 PHP 배열은 넘길 때 복사돼요. $h 에 더한 줄은 사본에만 붙어서 계좌 안 기록은 처음 입금 한 줄 그대로예요.
이어서 볼 주제 앞 주제 클래스와 객체 다음 주제 상속 같이 보면 좋은 주제 접근 제어자 자주 묻는 것 private 속성은 밖에서 읽을 수도 없나요? 네. 읽기와 쓰기 모두 Error 가 나요. 읽게 하려면 balance() 같은 메서드를 열어 두거나 public readonly 로 둬요.
readonly 와 private 은 어떻게 다른가요? private 은 누가 볼 수 있는지를, readonly 는 한 번 넣은 뒤 바꿀 수 있는지를 정해요. public readonly 면 누구나 읽지만 아무도 못 바꿔요.
getter·setter 를 모두 만들어야 하나요? 아니요. 값을 아무렇게나 바꾸는 setter 는 public 속성과 같아요. deposit·withdraw 처럼 하는 일로 이름 지은 메서드에서 검사해요.