도구
로그인
한국어

코드 배우기PHP

PHP 접근 제어자

PHP 8.3 기준

쇼핑몰 쿠폰으로 PHP public·protected·private 이 보이는 범위를 견줘요. readonly 와 8.4 도 짚어요.

한 줄 뜻

접근 제어자는 속성·메서드·상수를 "누가 볼 수 있나"로 나누는 표시예요. PHP 에는 public(모두), protected(그 클래스와 자식), private(그 클래스만) 셋이 있고, 아무것도 안 적은 메서드는 public 이에요.

왜 필요한가

쿠폰의 할인율·비밀 값이 모두 public 이면 주문 화면 코드가 할인율을 90 으로 바꿔도 막을 수 없어요. 어느 줄이 바꿨는지 찾는 데 오래 걸려요.

바깥에 보여 줄 것(code, apply()), 자식에게만 열어 줄 것(percent), 클래스 혼자 사용할 것(secret)을 나누면, 고칠 때 영향을 받는 범위가 미리 정해져요. private 은 마음 놓고 이름을 바꿔도 돼요.

일상 비유

가게를 떠올려 보세요. 진열대(public)는 손님 누구나 보고, 창고(protected)는 본점과 가맹점 직원이 드나들고, 사장실 금고(private)는 그 가게 사람만 열어요. 같은 가게 직원이면 다른 금고도 열 수 있는 것처럼, PHP 의 private 은 같은 클래스 코드라면 다른 객체 것도 열어요.

예제 코드

main.php · 54줄
<?phpdeclare(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";

PHP 공개 범위 한눈에

같은 클래스 안자식 클래스 안바깥 코드같은 클래스의 다른 객체
publicOOOO
protectedOOXO
privateOXXO

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; 를 하면?

답과 까닭 보기

답: 2. `Error` 가 나요 protected 는 그 클래스와 자식 클래스 코드에만 열려 있어요. 바깥 코드에서 읽으면 Error 가 나요.

문제 2

코드가 같은 두 쿠폰의 비밀 값을 견주면?

var_dump((new Coupon('Q', 1))->sameSecret(new Coupon('Q', 99)));

답과 까닭 보기

답: 1. bool(true) sameSecret() 은 Coupon 클래스의 코드라 다른 쿠폰 객체의 private 칸도 읽어요. 비밀 값은 코드를 뒤집은 글자라 둘 다 'Q' 예요.

자주 묻는 것

private 은 같은 클래스의 다른 객체 것도 볼 수 있나요?

네. PHP 의 private 은 "그 클래스의 코드만"이라 같은 클래스 메서드라면 다른 객체의 private 속성도 읽어요.

자식 클래스에서 부모의 private 을 사용하면 어떻게 되나요?

자식에게는 없는 속성처럼 보여서 경고와 함께 null 이 나와요. 자식도 사용해야 하면 protected 로 열어요.

아무것도 안 적은 메서드는 무엇인가요?

public 이에요. 읽기 쉽게 public 을 늘 적어 두는 것이 PSR-12 의 권고예요.