프로퍼티 (Properties)

class User {
    public $username = "Guest";  // 외부에서 접근 및 수정 가능
    protected $email;             // 본인 및 상속 클래스 내부에서만 접근 가능
    private $password;           // 본인 클래스 내부에서만 접근 가능
}

class Product {
    public int $id;              // 정수만 허용
    public string $name;         // 문자열만 허용
    public ?float $price = null; // float 또는 null 허용 (Nullable)
    public array $tags = [];     // 배열만 허용
}

$prod = new Product();
$prod->id = 100;
// $prod->name = [1, 2, 3]; // ❌ TypeError 발생! (배열은 string 프로퍼티에 대입 불가능)

class Book {
    // 타입 선언이 반드시 동반되어야 readonly를 지정할 수 있습니다.
    public readonly string $isbn;

    public function __construct(string $isbn) {
        $this->isbn = $isbn; // 1단계: 생성자 등을 통해 최초 1회 초기화 허용
    }
}

$book = new Book("978-3-16-148410-0");
echo $book->isbn; // 읽기 가능
// $book->isbn = "new-isbn-value"; // ❌ 에러! Fatal error: Cannot modify readonly property Book::$isbn

// PHP 8.2+ 읽기 전용 클래스 선언
readonly class UserDto {
    // 내부의 모든 프로퍼티는 자동으로 readonly 속성이 부여됩니다.
    public function __construct(
        public string $name,
        public int $age
    ) {}
}

$dto = new UserDto("jiny", 20);
// $dto->name = "other"; // ❌ 에러! 모든 프로퍼티 수정 시도 차단됨
// $dto->newVar = "dynamic"; // ❌ 에러! 동적 속성 추가도 차단됨

class User {
    // 프로퍼티 선언 내부에 get/set 훅을 정의합니다.
    public string $name {
        // 값을 읽을 때 실행되는 get 훅
        get => ucfirst($this->name);
        
        // 값을 쓸 때 실행되는 set 훅 ($value는 외부에서 대입한 입력값을 의미함)
        set (string $value) {
            if (strlen($value) < 2) {
                throw new InvalidArgumentException("이름은 최소 2글자 이상이어야 합니다.");
            }
            $this->name = trim($value);
        }
    }
}

$user = new User();
$user->name = "  hojin  "; // set 훅 작동: 공백 제거 후 "hojin" 저장
echo $user->name; // get 훅 작동: 첫 글자 대문자화하여 "Hojin" 출력

class Customer {
    // 읽기(기본 가시성)는 public이고, 쓰기(set)는 private으로 설정합니다.
    public private(set) string $id;
    
    // 읽기는 public이고, 쓰기는 protected(상속 허용)로 설정합니다.
    public protected(set) string $name;

    public function __construct(string $id, string $name) {
        $this->id = $id;     // 클래스 내부이므로 쓰기(set) 가능
        $this->name = $name; // 클래스 내부이므로 쓰기(set) 가능
    }
}

$customer = new Customer("C100", "홍길동");
echo $customer->id; // 🟢 public 읽기이므로 정상 작동!
// $customer->id = "C200"; // ❌ 에러! Fatal error: Cannot modify private(set) property Customer::$id