PHP 클래스와 객체: 속성, 메서드, $this

PHP 클래스는 class Name { ... }로 선언하며 속성(변수)과 메서드(함수)를 담습니다. new Name()은 그것으로 객체를 만들고, ->로 속성을 읽거나 메서드를 호출합니다: $user->name, $user->greet().

<?php
class User
{
    public string $name = 'Guest';

    public function greet(): string
    {
        return "Hello, {$this->name}";
    }
}

$user = new User();
echo $user->greet(), "\n";

$user->name = 'Ada';
echo $user->greet(), "\n";

클래스는 설계도이고, 객체는 그것으로 만든 하나의 물건입니다. 한 클래스로 필요한 만큼 객체를 만들 수 있고, 각 객체는 자신의 속성 값을 가집니다.

속성과 메서드

속성은 접근 제어 키워드, 선택적인 타입, 선택적인 기본값과 함께 선언합니다. 메서드는 클래스 안의 함수입니다. 메서드 안에서 $this는 메서드가 호출된 객체이므로 $this->balance는 그 객체의 잔액을 읽습니다.

<?php
class Account
{
    public string $owner = '';
    public float $balance = 0;

    public function deposit(float $amount): void
    {
        $this->balance += $amount;
    }

    public function summary(): string
    {
        return sprintf('%s has %.2f', $this->owner, $this->balance);
    }
}

$a = new Account();
$a->owner = 'Ada';
$a->deposit(50);
$a->deposit(25.5);

$b = new Account();
$b->owner = 'Linus';
$b->deposit(10);

echo $a->summary(), "\n";
echo $b->summary(), "\n";

각 객체는 자신의 $balance를 가지므로 $a에 입금해도 $b는 바뀌지 않습니다. new 다음에 속성을 하나씩 설정하는 것은 번거로우므로, 대신 생성자가 시작 값을 인수로 받습니다.

public, private, protected

접근 제어는 누가 속성을 건드리거나 메서드를 호출할 수 있는지 정합니다.

속성을 private으로 만들고 메서드를 노출하는 것이 클래스가 자신의 규칙을 지키는 방법입니다. 여기서 잔액은 잘못된 금액을 거부하는 deposit()과 withdraw()를 통해서만 바뀔 수 있습니다.

<?php
class Wallet
{
    private int $cents = 0;

    public function deposit(int $cents): void
    {
        if ($cents <= 0) {
            throw new InvalidArgumentException('Deposit must be positive');
        }
        $this->cents += $cents;
    }

    public function withdraw(int $cents): bool
    {
        if ($cents > $this->cents) {
            return false;
        }
        $this->cents -= $cents;
        return true;
    }

    public function balance(): int
    {
        return $this->cents;
    }
}

$w = new Wallet();
$w->deposit(500);
var_dump($w->withdraw(800));
var_dump($w->withdraw(200));
echo $w->balance(), "\n";

클래스 바깥에서 private 속성을 읽는 것은 경고가 아니라 Error입니다.

<?php
// This throws an Error on purpose: $cents is private
class Wallet
{
    private int $cents = 500;
}

$w = new Wallet();
echo $w->cents;

타입이 있는 속성과 초기화되지 않은 값

기본값이 없는 타입 있는 속성은 초기화되지 않은 상태로 시작하며, 이는 null과 다릅니다. 무언가를 대입하기 전에 읽으면 Error를 던집니다. 기본값을 주거나, 생성자에서 대입하거나, ?Type과 = null로 nullable하게 만드세요.

<?php
class Product
{
    public string $name;           // no default: uninitialized
    public ?string $sku = null;    // nullable with a default
    public int $stock = 0;
}

$p = new Product();
var_dump($p->sku, $p->stock);

try {
    echo $p->name;
} catch (Error $e) {
    echo $e->getMessage(), "\n";
}

$p->name = 'Keyboard';
echo $p->name, "\n";

타입은 대입할 때 강제됩니다. 기본(엄격하지 않은) 모드에서 $p->stock = '7'은 숫자 문자열을 7로 변환하고, $p->stock = 'many'는 TypeError를 던집니다.

readonly 속성

readonly 속성(PHP 8.1)은 클래스 안에서 한 번 쓸 수 있고 그 뒤로는 다시 쓸 수 없습니다. 금액이나 ID 같은 값 객체를 만드는 일반적인 방법입니다. PHP 8.2는 모든 속성을 readonly로 만드는 readonly class를 추가했습니다.

<?php
class Order
{
    public readonly string $id;

    public function __construct(string $id)
    {
        $this->id = $id;
    }
}

$order = new Order('A-1001');
echo $order->id, "\n";

try {
    $order->id = 'B-2002';
} catch (Error $e) {
    echo $e->getMessage(), "\n";
}

readonly 속성은 타입이 있어야 하고 기본값을 가질 수 없습니다. 바뀐 복사본이 필요하면 예전 객체를 고치는 대신 새 객체를 만드세요(new Order('B-2002')).

__toString으로 객체 출력하기

echo $object는 클래스가 __toString()을 정의했을 때만 동작합니다. 이 메서드는 객체가 텍스트로 취급될 때마다 PHP가 쓸 문자열을 반환합니다. echo, 문자열 연결, "{$object}" 등입니다.

<?php
class Money
{
    public function __construct(
        private int $cents,
        private string $currency = 'EUR',
    ) {}

    public function __toString(): string
    {
        return number_format($this->cents / 100, 2) . ' ' . $this->currency;
    }
}

$price = new Money(129900);
echo $price, "\n";
echo 'Total: ' . $price . "\n";
echo "Shipping: " . new Money(450, 'USD') . "\n";

// For debugging, print_r and var_dump show the properties
print_r(new Money(5));

__toString이 없으면 echo $object는 Error("Object of class Money could not be converted to string")를 던집니다. 디버깅에는 print_r()과 var_dump()가 어떤 객체에서든 동작하고 private 속성도 보여 줍니다. var_dump와 print_r을 참고하세요.

객체를 대입해도 복사되지 않는다

배열에 익숙한 사람들이 가장 많이 겪는 실수입니다. 배열을 대입하면 복사됩니다. 객체를 대입하면 핸들만 복사되어 두 변수가 같은 객체를 가리킵니다.

<?php
class Point
{
    public int $x = 0;
    public int $y = 0;
}

$a = new Point();
$b = $a;          // same object
$b->x = 10;
echo "a->x = {$a->x}\n";

$c = clone $a;    // independent copy
$c->x = 99;
echo "a->x = {$a->x}, c->x = {$c->x}\n";

var_dump($a === $b, $a === $c, $a == $c);
var_dump($a instanceof Point);
echo get_class($c), "\n";

clone은 얕은 복사를 합니다. 속성이 다른 객체를 담고 있으면 두 복사본이 그 안쪽 객체를 여전히 공유합니다. ===는 같은 객체일 때만 참이고, ==는 같은 클래스의 두 객체의 속성 값을 비교합니다. 객체를 함수에 넘기는 것도 대입과 똑같이 동작하므로, 함수는 받은 객체를 바꿀 수 있습니다.