やあ。Hackの世界へようこそ。
HHVMの深淵を覗き込み、型チェッカーであるHack（`hh_client`）の冷徹な判断基準を日々見つめていると、「型」とは単なる制約ではなく、開発者の意思をコードに刻むための「契約」であると痛感するんだ。
今回は、Hackの中級者が必ず一度は直面する迷い、「Shape型か、それともクラス（インターフェース）か？」という境界線について、アーキテクトの視点から紐解いていこう。
—
1. 構造と名前：Hackが提示する二つの世界
Hackにおいて、データを表現する方法は大きく分けて二つある。
- Shape型（構造的部分型）： 「この形さえしていればOK」。中身の構造（フィールド名と型）が全て。
- クラス・インターフェース（公称的部分型）： 「この名前（型名）を継承していることが重要」。アイデンティティが重視される。
この二つの境界線を理解していないと、コードは「何でもあり」の複雑な迷宮と化してしまう。ここをクリアすれば、君の書くコードは驚くほど堅牢で、かつ柔軟なものに変わるはずだよ。
—
2. Shape型：データの「一時的な流儀」
Shape型は、「データの持ち運び」に特化している。特に外部APIとの通信や、関数間での軽量なデータ授受には最適だ。
// APIから返ってくるユーザー情報の最小構成を定義
type UserProfile = shape(
‘id’ => int,
‘username’ => string,
?’email’ => string, // ? をつけるとオプション（あってもなくても良い）
);
function processUser(UserProfile $user): void {
// Shapeは辞書のように扱えるが、型安全だ
echo “Processing user: ” . $user[‘username’];
}
陥りやすい罠：Shapeの「広さ」
初心者によくあるミスは、Shapeを「ドメインオブジェクトの代わり」に使ってしまうことだ。
Shapeは「メソッドを持てない」。もし、ユーザー情報に対して「メールアドレスのバリデーションロジック」や「表示名の整形メソッド」を追加したくなったらどうする？ Shapeのままではコードが散らばり、保守性が崩壊するんだ。
—
3. クラス・インターフェース：振る舞いの「系譜」
一方で、インターフェースは「振る舞い」を保証する。
オブジェクトが「何ができるか（メソッド）」を定義するなら、迷わずインターフェースを選択しよう。
interface UserInterface {
public function getDisplayName(): string;
public function isValid(): bool;
}
class RegisteredUser implements UserInterface {
public function __construct(private string $name) {}
public function getDisplayName(): string {
return ‘User: ‘ . $this->name;
}
public function isValid(): bool {
return strlen($this->name) > 0;
}
}
—
4. 境界線を見極めるための「設計ガイドライン」
さて、ここからが本題だ。どちらを使うべきか迷ったときは、以下の「3つの質問」を自分に投げかけてみてほしい。
① ロジックが必要か？
- Yes： クラス・インターフェース一択。データに付随するメソッドや、内部状態の隠蔽（カプセル化）が必要ならShapeでは役不足だ。
- No： Shape型で十分。ただのデータ構造なら、わざわざクラスを作ってボイラープレートを増やす必要はない。
② そのデータは「境界線」を越えるか？
- Yes： Shape型が適している。外部（JSON、DBなど）からのデータ転送オブジェクト（DTO）として扱う場合、構造が明確なShapeは相性がいい。
- No： クラス・インターフェース。アプリケーションの内部ロジックで一貫性を保ちたいなら、名前付きの型で「型システムの守護」を受けるべきだ。
③ 型の「名前」に意味があるか？
- Yes： クラス・インターフェース。`Manager` や `Service` といった役割を持つなら、型名で明示するべきだ。
- No： Shape型。単なる「IDと名前のペア」のような一時的な構造に、仰々しい名前をつけるのはオーバーエンジニアリングだ。
—
5. まとめ：Hackを掌握するということ
Hackの型システムは、君たちが意図しないミスをコンパイル時にすべて弾き飛ばすように設計されている。
- Shapeは、「データの形」を素直に表現する軽快なツール。
- インターフェースは、「責務の境界」を明確にする堅牢な砦。
初心者は「何でもクラスにする」か「何でもShapeで済ませる」の両極端に陥りがちだ。しかし、熟練したエンジニアは、「データはShapeで流し、振る舞いはインターフェースで守る」という使い分けを直感的に行っている。
この境界線さえ意識できれば、君のHackコードはHHVMの最適化を最大限に引き出し、同時にチームメイトにも読みやすい、最高品質の資産になるはずだ。
「型」という言語と対話する楽しさを、ぜひコードの中で味わってほしい。また次の深淵で会おう。