集計機能を作ったのに、ページには何も出なかった

手取りを増やそう！をつくる第10回 ／ 全12回目次

「結果を蓄積して、みんなで見られるようにしたい」という要望をもらって、統計ページを作ることにした。
年収と計算結果を集めれば、年収帯ごとの手取り率や、都道府県ごとの社会保険料の違いが見えてくる。数字がたまるほど面白くなる機能だと思った。

何を送るかより、何を送らないかを先に決めた

年収を扱う機能なので、プライバシーの設計を先に固めた。
年収は1万円単位に丸める。年齢は年代（30sのように）に落とす。氏名やメールアドレスは、そもそも入力欄を作らない。同意のチェックが入っていなければ、何も送らない。

丸めた値をそのまま送ると「額面－社会保険料－税」と手取りの数字が合わなくなる。だから丸めた額面から手取りを逆算して、整合の取れた値を送るようにした。
まったく同じ条件の結果は、SHA-256のフィンガープリントで見分けて、新しい行を作らずに人数だけ加算する。少人数のグループ（3人未満）は集計から外し、全体で10人に満たないうちは統計そのものを出さないことにした。

データベースを見ても、原因が見当たらない

プラグインを作り、テーブルを用意し、APIも通した。管理画面でプラグインを有効にして、統計ページを開いた。
そこにあったのは、集計グラフではなく

まず疑ったのはプラグインの有効化状態だった。データベースの m_plugin テーブルを見ると、たしかに有効になっている。原因はそこには無かった。

コアの読み込み処理を追って分かったのは、このCMSのプラグインローダーがデータベースを見ていないという事実だった。
GC_PluginLoader::load() は、起動のたびに package/cache/plugins_active.php というキャッシュファイルを読んでいる。管理画面でプラグインを有効にしても、このキャッシュを作り直さない限り、フックは一切登録されない。

セットアップスクリプトの最後に、キャッシュの再生成を足した

有効なプラグイン一覧をデータベースから取り直して、キャッシュファイルをPHPの配列としてそのまま書き出す処理を、プラグインのセットアップスクリプトの末尾に足した。
これでプラグインを導入するたびに、キャッシュも自動で追従するようになった。

「有効になっているのに動かない」は、テーブルの中を何度見ても見つからない種類の不具合だった。
データの正しさと、それが読み込まれる経路は、別のレイヤーの話だと学んだ。