過去バージョン

static method と static property の基本

class Counter {
    public static int $count = 0;

    public static function increment(): void {
        self::$count++;
    }

    public static function reset(): void {
        self::$count = 0;
    }
}

// インスタンス化せずに使う
Counter::increment();
Counter::increment();
echo Counter::$count;   // 2
Counter::reset();

呼び出し方:

• ClassName::method() — 通常
• self::method() — 記述したクラス内から
• static::method() — 呼び出し元クラス基準 (Late Static Binding)
• parent::method() — 親クラスの static を呼ぶ

self:: と static:: の違い (Late Static Binding)

class Animal {
    public static function create(): static {
        return new self();    // ← Animal 固定
    }

    public static function createV2(): static {
        return new static();  // ← 呼び出したクラス (子も含む)
    }
}

class Dog extends Animal {}

var_dump(Animal::create());     // Animal
var_dump(Dog::create());        // Animal (self だから)
var_dump(Dog::createV2());      // Dog    (static だから)

Static Factory パターン

class User {
    private function __construct(
        public string $name,
        public string $email,
    ) {}

    public static function register(string $name, string $email): static {
        // バリデーション
        if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
            throw new InvalidArgumentException();
        }
        return new static($name, $email);
    }

    public static function fromArray(array $data): static {
        return new static($data['name'], $data['email']);
    }
}

$u = User::register('taro', 'taro@example.com');
$u = User::fromArray(['name' => 'jiro', 'email' => 'j@example.com']);

Singleton (推奨しない例)

class DBConnection {
    private static ?self $instance = null;
    private PDO $pdo;

    private function __construct() {
        $this->pdo = new PDO(/* ... */);
    }

    public static function getInstance(): self {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }
}

DBConnection::getInstance()->pdo->query('SELECT 1');

// ❌ 問題: テストでモック化不能、グローバル状態
// → DI コンテナ (Laravel Service Container) の使用を推奨

関数内 static 変数 (関数呼出間で値を保持)

function counter(): int {
    static $count = 0;   // 初回のみ初期化
    return ++$count;
}

counter();   // 1
counter();   // 2
counter();   // 3
// → 関数を抜けても値が消えない

// 用途: メモ化
function expensiveCalc(int $n): int {
    static $cache = [];
    if (isset($cache[$n])) return $cache[$n];
    return $cache[$n] = /* 重い計算 */ $n * $n;
}

static の問題点とテスト

// ❌ 静的依存はテストしにくい
class OrderService {
    public function place(Order $o): void {
        $now = DateTime::now();    // ← 直接呼び出し
        Mailer::send($o->email);   // ← 静的呼び出し → モック不能
    }
}

// ✅ DI でインスタンス注入
class OrderService {
    public function __construct(
        private ClockInterface $clock,
        private MailerInterface $mailer,
    ) {}

    public function place(Order $o): void {
        $now = $this->clock->now();
        $this->mailer->send($o->email);
    }
}
// → テストで Clock / Mailer のモックを差し替え可能

戻り値型としての static (PHP 8+)

// Fluent Builder で便利
class QueryBuilder {
    private array $wheres = [];

    public function where(string $col, $val): static {
        $this->wheres[] = [$col, $val];
        return $this;
    }
}

class CustomQueryBuilder extends QueryBuilder {
    public function newMethod(): static { /* ... */ return $this; }
}

// 子クラスで連鎖しても型が CustomQueryBuilder に推論される
(new CustomQueryBuilder())->where('id', 1)->newMethod();

定数 const と static の使い分け

class Config {
    // 定数: 不変
    public const MAX_RETRY = 3;

    // static property: 変更可
    public static int $timeout = 30;
}

Config::MAX_RETRY;       // 3
Config::$timeout = 60;   // 変更可

// 定数は ::CONSTANT、static は ::$variable

よくあるエラー

FAQ

Q: static を使うべきか避けるべきか？
A: ユーティリティ関数 (純粋関数) なら OK。状態を持つもの (DB 接続 / 設定) は DI 推奨。

Q: self と static、どっち書けばいい？
A: 継承を考慮するなら static:: (LSB)、固定なら self::。最近は static 派が増加。

Q: static メソッドはなぜテストしにくい？
A: モックライブラリの多くがインスタンスメソッドにしか対応しないため。回避するには「静的呼び出しをラップするインスタンスメソッドを作る」or「DI で差し替える」。