HHVMの真髄：Repo Authoritative ModeとJITの深淵なる調律
諸君、HackとHHVMの深淵へようこそ。
多くのエンジニアが「HHVMは速い」と信じているが、それはあくまで表面的な理解に過ぎない。Repo Authoritative Modeを有効にし、JIT（Just-In-Time）コンパイラの挙動を制御することは、単なる設定変更ではない。それは、CPUのパイプラインをあなたのコードに最適化させる「錬金術」だ。
今日は、プロダクション環境において、デプロイ直後のパフォーマンス低下（コールドスタート）を排除し、最大出力を維持するためのアーキテクチャ設計を伝授する。
—
1. Repo Authoritative Modeの「真の役割」を理解せよ
`Repo Authoritative Mode`は、単にファイルシステムへのアクセスを減らすものではない。HHVMが起動時にディスク上の`.hhbc`（バイトコード）をメモリにマッピングし、ファイルシステム上のソースコードの変更を一切無視するモードだ。
- メリット: 動的なファイルI/Oの完全排除、クラス定義の静的解決、メモリレイアウトの最適化。
- 代償: デプロイ時のアトミックな差し替えが必須となる。
ここで重要なのは、JITコンパイラが「どの時点でコードをプロファイリングし、ネイティブ命令に変換するか」だ。このモード下では、HHVMはアプリケーションの構造を読み込んだ瞬間、最高効率で実行を開始できる準備が整っている。
2. JITウォームアップの解像度を上げる
多くのエンジニアが犯す最大の過ちは、デプロイ直後に「いきなり全トラフィックを流す」ことだ。Repo Authoritative Modeであっても、JITキャッシュは実行されるまで生成されない。
プロダクションコード例：ウォームアップ・スクリプト
ロードバランサーに組み込む前に、重要なパスを事前に実行し、ホットな状態を作るためのシンプルなエントリポイントを設計せよ。
<<__EntryPoint>>
async function warmup_system(): Awaitable
// 1. 主要なルートの初期化（DIコンテナの解決など）
// 2. 頻出する型チェック・複雑な関数呼び出しの強制実行
$criticalPaths = vec[
() ==> MyController::index(),
() ==> MyService::processData(),
];
foreach ($criticalPaths as $path) {
try {
// メインの実行パスをトレースさせ、JITコンパイルを誘発する
await $path();
} catch (Exception $e) {
// 予期せぬ実行時エラーは握り潰さずログへ
Logger::error(‘Warmup failed: ‘ . $e->getMessage());
}
}
}
3. なぜ「型の厳格さ」がJITに寄与するのか
Hackの静的型システムは、単なるバグ除けではない。型が確定していることは、JITコンパイラにとって「推論のステップを省略できる」ことを意味する。
動的型付け言語で発生する「型ガード（Type Guard）」のオーバーヘッドを、Hackはコンパイル時に除去する。Repo Authoritative Modeと組み合わせることで、JITは「この変数は絶対に`int`である」と確信し、CPUのレジスタへ直接値をロードする最適化を行うのだ。
非効率を排除する設計パターン
// 悪い例：共用体型や混在型を多用する（JITが型判定を繰り返す）
function process(mixed $data): void { … }
// 良い例：明確な型定義とShapeの活用
type UserPayload = shape(‘id’ => int, ‘email’ => string);
function process_optimized(UserPayload $data): void {
// 型情報がスタティックに確定しているため、
// JITはメモリのオフセット計算を完全に固定できる
$id = $data[‘id’];
// …
}
4. 堅牢なデプロイ・戦略的設定
Repo Authoritative Modeで運用する場合、以下の`php.ini`（または`server.ini`）の設定が「黄金律」となる。
; リポジトリの場所を固定
hhvm.repo.authoritative = true
hhvm.repo.path = /var/run/hhvm/hhvm.hhbc
; JITの設定：ウォームアップを急ぐ設定
hhvm.jit = true
hhvm.jit_a_size = 134217728 ; 128MBのコードキャッシュ
hhvm.jit_global_data_size = 67108864 ; 64MBのグローバルデータ
チーフアーキテクトからの助言
1. jit_a_sizeをケチるな: 現代のサーバーで128MBは小さすぎる。複雑なシステムなら256MB以上を確保し、キャッシュミスによるJITの再コンパイルを抑えろ。
2. hhvm.jit_profile_threshold: これを低くしすぎると、逆に頻繁に再プロファイルが発生してパフォーマンスが落ちる。デフォルトを信頼しつつ、負荷テストでチューニングせよ。
—
最後に：コードは「機械への命令書」であれ
諸君が書くHackコードは、人間が読むための文書ではなく、HHVMという巨大なエンジンを制御するための物理的な指令書だ。
Repo Authoritative Modeを使いこなし、厳格な型システムでJITに明確な道筋を示せ。デプロイ直後のレスポンスタイムが、ミリ秒単位で劇的に改善されるはずだ。それが、言語の深淵を理解した者にのみ許された特権である。
さあ、コードを開け。最適化の余地は、まだそこにあるはずだ。