やあ。HHVMの世界へようこそ。Hackという言語に触れる君たちは、すでに単なるスクリプト言語の枠を超え、型とパフォーマンスが融合する領域に足を踏み入れている。
今日は、大規模なHackアプリケーションの心臓部を蝕む「JITコードキャッシュのフラグメンテーション」という、深淵なトピックについて話そう。これは、ただコードを書くだけのエンジニアが一生触れることのない、しかしアーキテクトならば必ず支配下に置くべき「メモリの鼓動」の話だ。
—
1. JITコードキャッシュとは何か？
HHVMは、君たちが書いたHackコードをそのまま動かすわけではない。一度`HHBC`（HipHop Bytecode）に変換し、そこからさらにネイティブの機械語（マシンコード）へとコンパイルする。これが「JIT（Just-In-Time）コンパイル」だ。
この生成された機械語を溜め込んでおく場所、それが「JITコードキャッシュ」だ。
イメージ図
[ Hackコード ]
↓ (HHVMフロントエンド)
[ HHBC (バイトコード) ]
↓ (JITコンパイラ)
[ 機械語 (JITコードキャッシュ: メモリ領域) ] ← ここが今回の主戦場
2. なぜ「フラグメンテーション（断片化）」が起きるのか？
長時間稼働するHHVMプロセスにおいて、コードキャッシュは「巨大な1枚の紙」のようなものだ。
1. 書き込み: 新しい関数が呼ばれるたびに、コードキャッシュの空き領域に機械語が書き込まれる。
2. 無効化: `hphp_config.ini` の設定や、動的なコードの再定義（めったにないが）によって、特定の機械語が不要になる。
3. 隙間: 削除された部分が「穴」として残り、新しい機械語がその隙間に入りきらないサイズだと、別の場所に書き込まれる。
この「穴だらけのメモリ状態」がフラグメンテーションだ。これが進むと、メモリは十分あるはずなのに「新しいコードを置く場所がない！」という致命的な状況に陥り、HHVMはパフォーマンスを激しく低下させる。
3. フラグメンテーションを制御する：チューニングの極意
君たちがまず触るべきは、`php.ini`（HHVMの設定ファイル）にあるこれらのパラメータだ。
; JITコードキャッシュの初期サイズ（バイト単位）
Eval.JitCodeCacheSize = 256 1024 1024 ; 256MB
; コードキャッシュがフラグメント化した時の再利用戦略
Eval.JitGlobalTranslationStrategy = 1
対策のポイント：
- サイズを適切に見積もる: `Eval.JitCodeCacheSize` が小さすぎると、頻繁なコード再生成（JITの再コンパイル）が走り、CPUを浪費する。大きすぎるとメモリを圧迫する。プロファイラを見ながら、アプリケーションの全コードが収まるサイズを「静的に」決めるのが、伝説的なアーキテクトの流儀だ。
- 不要な動的生成を避ける: Hackは静的型付け言語だ。`eval()`のような動的コード実行は、JITキャッシュを汚染し、フラグメンテーションを加速させる。これらは「Hackの思想」に反する行為だと心に刻んでほしい。
4. 陥りやすい罠：なぜ「再コンパイル」が止まらないのか？
初学者がやりがちなのは、「多相性（ポリモーフィズム）の過剰な利用」だ。
// 悪い例：型が予測不能なメソッド呼び出し
function process(mixed $data): void {
// $dataの型が実行ごとに変わると、JITはそれぞれの型に合わせた
// 機械語を生成しようとしてキャッシュを埋め尽くす
$data->handle();
}
HackのJITは、型が固定されていると非常に強力な最適化を行う。しかし、`mixed`型や不必要な動的呼び出しは、JITに「あ、これも別の機械語で作らなきゃ！」と思わせ、キャッシュ内に無数の小さな機械語の断片を生成させる原因になる。
君たちが守るべき哲学:
「型を明示せよ。推論に頼りすぎず、コンパイラに明確な道筋を示せ。」
5. 最後に：アーキテクトへの道
フラグメンテーションを意識するようになると、君たちのコードは「メモリ配置」を意識したものに変わる。
1. プロファイリング: `hhvm.stats` を定期的に監視し、`jit.code_cache_usage` を確認すること。
2. 静的思考: 実行時の型変化を最小限に抑える構造を設計すること。
ここをクリアすれば、君たちは単なる「コードを書く人」から、「ハードウェアと対話するエンジニア」へと進化できるはずだ。Hackは、君たちが真剣に向き合えば、必ずその期待以上のパフォーマンスで応えてくれる言語だよ。
さあ、次のデプロイでは、メモリの断片化を恐れず、最適化された美しい型システムを構築してくれ。応援しているよ。