한 줄 뜻 접근 제어자는 속성·메서드·상수를 "누가 볼 수 있나"로 나누는 표시예요. PHP 에는 public(모두), protected(그 클래스와 자식), private(그 클래스만) 셋이 있고, 아무것도 안 적은 메서드는 public 이에요.
왜 필요한가 쿠폰의 할인율·비밀 값이 모두 public 이면 주문 화면 코드가 할인율을 90 으로 바꿔도 막을 수 없어요. 어느 줄이 바꿨는지 찾는 데 오래 걸려요.
바깥에 보여 줄 것(code, apply()), 자식에게만 열어 줄 것(percent), 클래스 혼자 사용할 것(secret)을 나누면, 고칠 때 영향을 받는 범위가 미리 정해져요. private 은 마음 놓고 이름을 바꿔도 돼요.
일상 비유 가게를 떠올려 보세요. 진열대(public)는 손님 누구나 보고, 창고(protected)는 본점과 가맹점 직원이 드나들고, 사장실 금고(private)는 그 가게 사람만 열어요. 같은 가게 직원이면 다른 금고도 열 수 있는 것처럼, PHP 의 private 은 같은 클래스 코드라면 다른 객체 것도 열어요.
예제 코드 main.php · 54줄 실행 복사 고쳐 보기 처음 코드로 <?php declare (strict_types=1 ); class Coupon { public const PREFIX = 'APP' ; protected int $percent ; private string $secret ; public function __construct (public readonly string $code , int $percent ) { $this ->percent = $percent ; $this ->secret = strrev ($code ); } public function apply (int $price ): int { return $price - intdiv ($price * $this ->percent, 100 ); } public function sameSecret (Coupon $other ): bool { return $this ->secret === $other ->secret; } } class VipCoupon extends Coupon { public function apply (int $price ): int { $this ->percent += 5 ; $price = parent ::apply ($price ); $this ->percent -= 5 ; return $price ; } public function peek (): string { return isset ($this ->secret) ? 'can see' : 'cannot see' ; } } $c = new Coupon ('SPRING10' , 10 );$v = new VipCoupon ('SPRING10' , 10 );echo Coupon ::PREFIX . '-' . $c ->code, "\n" ;echo $c ->apply (20000 ), ' / ' , $v ->apply (20000 ), "\n" ;var_dump ($c ->sameSecret ($v ));echo $v ->peek (), "\n" ;$kinds = [];foreach (['code' , 'percent' , 'secret' ] as $name ) { $r = new ReflectionProperty (Coupon ::class , $name ); $kinds [] = $name . '=' . ($r ->isPublic () ? 'public' : ($r ->isProtected () ? 'protected' : 'private' )); } echo implode (' ' , $kinds ), "\n" ;
고친 코드는 실행 단추로 돌려 볼 수 있어요. 한 줄씩 따라가기와 위 실행 결과는 원래 코드 기준이에요.
한 줄씩 따라가기 시작 전 다음을 누르면 클래스 아래 실행 코드의 첫 줄부터 움직여요. 밝은 띠가 방금 실행한 줄이고, 메서드 안으로 들어가면 띠도 따라 들어가요.
처음 이전 다음
실행 결과 APP-SPRING10 18000 / 17000 bool(true) cannot see code=public percent=protected secret=private 서버의 PHP(CLI)와 브라우저 안 PHP 8.3 두 곳에서 돌려 같게 나온 결과예요.
클래스 그림 Coupon + PREFIX = 'APP' + code: string (readonly) # percent: int - secret: string + __construct(code, percent) + apply(int): int + sameSecret(Coupon): bool VipCoupon + apply(int): int + peek(): string + public · # protected · - private · 밑줄 static · 기울임 abstract · (readonly) 처음 한 번만 넣는 속성
PHP 공개 범위 한눈에 같은 클래스 안 자식 클래스 안 바깥 코드 같은 클래스의 다른 객체 publicO O O O protectedO O X O privateO X X O
readonly 는 공개 범위와 따로 붙는 표시로, 처음 넣은 뒤로 못 바꿔요(8.1 부터). PHP 8.4 부터는 public private(set) 처럼 읽기와 쓰기 범위를 따로 줄 수 있어요(새 버전 기능). 아무것도 안 적은 메서드는 public 이에요.
언제 사용하나 처음에는 모두 private 으로 두고, 필요할 때 한 단계씩 열어요 자식이 바꿔야 하는 값만 protected 로 둬요 밖에서 읽기만 해야 하면 public readonly(8.1) 나 8.4 의 public private(set) 을 생각해요 PHP 에는 자바의 "같은 패키지" 범위가 없어요. 이름공간(namespace)은 이름을 나누기만 하고, 보이는 범위는 정하지 않아요.
자주 하는 실수 자식에서 부모의 private 속성을 씀 자식 코드에게 부모의 private 칸은 없는 것과 같아요. 오류로 멈추지 않고 경고와 함께 null 이 나와서 버그를 늦게 알아채요. 자식도 사용해야 하는 값이면 protected 로 열어요.
틀린 코드
class Coupon { private string $secret = 'abc' ; } class VipCoupon extends Coupon { public function show (): ?string { return $this ->secret; } } echo (new VipCoupon ())->show () ?? 'nothing' , "\n" ;실행하면 Warning: Undefined property: VipCoupon::$secret
nothing
고친 코드
class Coupon { protected string $secret = 'abc' ; } class VipCoupon extends Coupon { public function show (): ?string { return $this ->secret; } } echo (new VipCoupon ())->show () ?? 'nothing' , "\n" ;실행하면 abc
덮어쓰면서 public 을 protected 로 줄임 부모 자리에 자식이 들어가도 똑같이 불려야 해요. 바깥 코드가 $coupon->apply() 를 부르는데 자식만 막혀 있으면 안 되니 PHP 가 클래스를 읽을 때 막아요.
틀린 코드
class Coupon { public function apply (int $price ): int { return $price ; } } class VipCoupon extends Coupon { protected function apply (int $price ): int { return $price - 1000 ; } } PHP 가 내는 오류 Fatal error: Access level to VipCoupon::apply() must be public (as in class Coupon)
고친 코드
class Coupon { public function apply (int $price ): int { return $price ; } } class VipCoupon extends Coupon { public function apply (int $price ): int { return $price - 1000 ; } } echo (new VipCoupon ())->apply (5000 ), "\n" ;실행하면 4000
readonly 값을 클래스 안에서 다시 바꿈readonly 는 바깥만 막는 게 아니라 클래스 안에서도 처음 한 번만 넣게 해요. 값이 바뀐 것이 필요하면 새 객체를 돌려주는 with...() 메서드를 만들어요.
틀린 코드
final class Code { public function __construct (public readonly string $value ) { } public function rename (string $v ): void { $this ->value = $v ; } } (new Code ('A1' ))->rename ('B2' ); 실행하면 Fatal error: Uncaught Error: Cannot modify readonly property Code::$value
고친 코드
final class Code { public function __construct (public readonly string $value ) { } public function withValue (string $v ): static { return new static ($v ); } } $a = new Code ('A1' );$b = $a ->withValue ('B2' );echo $a ->value, ' ' , $b ->value, "\n" ;실행하면 A1 B2
확인 문제 문제 1
예제의 Coupon 을 만들고 밖에서 echo $x->percent; 를 하면?
1 50 2 Error 가 나요3 0
답과 까닭 보기 답: 2. `Error` 가 나요 protected 는 그 클래스와 자식 클래스 코드에만 열려 있어요. 바깥 코드에서 읽으면 Error 가 나요.
문제 2
코드가 같은 두 쿠폰의 비밀 값을 견주면?
var_dump ((new Coupon ('Q' , 1 ))->sameSecret (new Coupon ('Q' , 99 )));1 bool(true) 2 bool(false) 3 Error 가 나요
답과 까닭 보기 답: 1. bool(true) sameSecret() 은 Coupon 클래스의 코드라 다른 쿠폰 객체의 private 칸도 읽어요. 비밀 값은 코드를 뒤집은 글자라 둘 다 'Q' 예요.
이어서 볼 주제 앞 주제 합성·static·trait·enum 다음 주제 구조 잡기 같이 보면 좋은 주제 캡슐화 같이 보면 좋은 주제 상속 자주 묻는 것 private 은 같은 클래스의 다른 객체 것도 볼 수 있나요? 네. PHP 의 private 은 "그 클래스의 코드만"이라 같은 클래스 메서드라면 다른 객체의 private 속성도 읽어요.
자식 클래스에서 부모의 private 을 사용하면 어떻게 되나요? 자식에게는 없는 속성처럼 보여서 경고와 함께 null 이 나와요. 자식도 사용해야 하면 protected 로 열어요.
아무것도 안 적은 메서드는 무엇인가요? public 이에요. 읽기 쉽게 public 을 늘 적어 두는 것이 PSR-12 의 권고예요.