ReactPHP で Gemini Protocol Server を作る

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP GEMINI PROTOCOL × REACTPHP ReactPHP で Gemini Protocol Server を作る シンプルさとプライバシーを追求した ミニマリストプロトコルを PHP で実装してみた 黒井春人 / @halt / 有限会社アリウープ 2026-04-21 第186回 PHP勉強会@東京 1

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP 自己紹介 halt 黒井 春人 (くろい はると) @halt 直近3年間は無職でしたが、今年から有限会社アリウープで働いています ずっと無職だったので発表も久しぶりです。お手柔らかに 🙇 東京のPHP勉強会に関わっています — なんと20年前から… x.com/halt zenn.dev/halt phpstudy アーカイブ 2

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP Laravel Live Japan は 5月26日 - 27日開催！ 2026年5月26日（火）〜 27日（水） 📍 立川 所属企業である 有限会社アリウープ が ゴールドスポンサー をやってます。 他のゴールドスポンサー：Sentry / JetBrains / CodeRabbit よろしくおねがいします！ 3

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP 執筆 📚 PHPと共に歩んできた PHP4 の最初くらいから PHP5.3 くらいまで極めてました 15年くらい前の話ですが、書籍執筆とかもやってました このあと起業したり EM になったりして、こういう活動しなくなってしまった… 4

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP 今日話すこと 1. Gemini Protocol とは何か 2. Google Gemini との違い（大事） 3. IndieWeb という思想 4. 宇宙との関係・用語の世界観 5. Gemtext ― 専用マークアップ言語 6. ReactPHP の仕組み 7. 実装：GeminiServer をゼロから作る 8. Lagrange で実際に見てみる 5

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP 現代の Web はどうなっているか 5 MB+ 68% 3 sec 平均ページサイズ (2024) サードパーティ トラッカー含有率 モバイル平均 読み込み時間 広告・トラッキングスクリプトが常時ユーザーを監視 JavaScript の肥大化で低スペック端末では表示すら困難 「情報を届ける」という本来の目的が二次的になっている 6

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP Gemini Protocol とは？ 🌐 ⚡ 1991年の Gopher にインスパイアされ、TLS を取り入れた現代的再構築。2019 年誕生。 文書テキストの表示に特化。JS なし、CSS なし、動画なし。 🔒 ✨ Cookie もトラッカーも広告もプロトコルレベルで存在しない。TLS 必須。 「情報を届ける」という Web 本来の機能に立ち返る設計思想。 誕生の背景 プライバシー重視 超軽量設計 デジタルミニマリズム 7

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP まず最初に大事なこと 「Gemini」は 2 つある Google Gemini Gemini Protocol（今日の話） 大規模言語モデル（LLM） 通信プロトコル（HTTP の仲間） Google の AI サービス 有志のコミュニティが開発 2023年「Bard」で登場 2019年に誕生 2024年「Gemini」に改名 AI とは一切無関係 gemini.google.com gemini:// スキーム 注意：Google の改名で混乱しがちですが、全くの別物です。 8

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP Web・Gopher・Gemini の比較 項目 HTTP/Web Gopher Gemini 暗号化 任意 なし 必須 マークアップ HTML+CSS+JS プレーン Gemtext スクリプト あり なし なし トラッキング ふんだん なし なし ポート番号 80/443 70 1965 9

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP IndieWeb という思想 自分のコンテンツを、自分で管理する 10

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP POSSE の原則 Publish (on) Own Site, Syndicate Elsewhere “ “ まず自分のサイトに投稿し、SNS には**配信（コピー）**する。 SNS が流れ去っても、自分の「家」は残り続ける。 🏠 オーナーシップ 🔗 ウェブ標準の活用 コンテンツは自分のドメインに保存。SNS に依存しない。 HTML, RSS, Webmention などの公開技術で連携。 11

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP なぜ SNS 依存は危険なのか？ 💀 🤖 倒産・サービス終了・アカウント凍結で過去の投稿が消える。Vine・Google+ の前 例。 表示順・範囲は運営の都合で変わる。フォロワーがいても届かない。 🗂 🎯 データ消失リスク 分断された記録 複数 SNS を使うと活動記録がバラバラに。検索もできない。 アルゴリズムの支配 主張の歪み バズる内容に引っ張られ、伝えたい内容から遠ざかる。 12

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP Gemini と宇宙のメタファー 💊 Capsule 📡 Port 1965 NASA のジェミニ計画 から。アポロ計画（月 面着陸）の前段とし て宇宙ドッキング技術 を確立した計画。 Gemini のウェブサイト 単位。宇宙船帰還カ プセルから連想。独立 した小さな領域を表 す。 デフォルトポート。ジェミ ニ 3 号（NASA 初の 有人ミッション）が行 われた年。 技術仕様を超え、宇宙というメタファーで哲学・世界観を表現している。 “ “ 🚀 Gemini 13

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP Gemtext ― 専用マークアップ言語 構文 意味 備考 # テキスト 見出し 1 最大ヘッダー ## テキスト 見出し 2 中ヘッダー => URL [ラベル] リンク 行の先頭のみ * テキスト リスト 箇条書き > テキスト 引用 ブロック引用 インライン装飾（太字・斜体）も テーブル も CSS も JS も無し。 必要最小限の要素のみ。 14

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP Gemtext を書いてみると… # Gemini カプセルへようこそ これは Gemtext で書いたページです。 HTMLとは違い、装飾は最小限。 ## リンク集 => gemini://example.com トップページ => gemini://example.com/about About * シンプル * プライベート * テキスト中心 > Less is more. 15

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP ReactPHP とは？ PHP でイベント駆動・非同期プログラミングを実現するライブラリ 通常の PHP（同期） ReactPHP（非同期） リクエスト来る → プロセス起動 イベントループが常に動く DB クエリ発行（待つ） 待機中に並行で他を処理 HTML を返す → 終了 1 プロセスで数千接続 TCP/UDP サーバー実装に最適 ― まさに今回のユースケース。 16

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP Gemini プロトコルの通信シーケンス 1 Client → Server : TLS ハンドシェイク 2 Server → Client : 証明書交換（自己署名も可） 3 Client → Server : gemini://host/path\r\n （1 行） 4 Server → Client : 20 text/gemini\r\n （ステータス + MIME） 5 Server → Client : 本文（Gemtext） 6 接続切断（keep-alive なし） リクエストは 1 行、レスポンスはステータス行 + 本文のみ ― 驚くほど単純。 17

GEMINI PROTOCOL × REACTPHP

Gemini Protocol × ReactPHP
実装：エントリーポイント
<?php
$host

= getenv('GEMINI_HOST') ?: '0.0.0.0';

$port

= getenv('GEMINI_PORT') ?: 1965;

$docRoot

= getenv('GEMINI_DOC_ROOT');

$hostname = getenv('GEMINI_HOSTNAME');

// TLS 証明書を自動生成
$cert = new CertificateGenerator($certDir);
$path = $cert->generate($hostname);
// サーバー起動
$server = new GeminiServer(
$host, $port,
new StaticFileHandler($docRoot),
$path
);
$server->run();

18

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP 実装のポイント ① 環境変数で設定を外部化 ② TLS は自動生成 ホスト・ポート・ドキュメントルートを env で切り替え可能に。 Gemini は TLS 必須。openssl で自己署名を自動作成。 ③ StaticFileHandler ④ run() = イベントループ .gmi ファイルを text/gemini で返すだけ。 ReactPHP のイベントループが起動し接続を待つ。 19

GEMINI PROTOCOL × REACTPHP

Gemini Protocol × ReactPHP
GeminiServer の内部実装
class GeminiServer {
public function run(): void {
$loop = Factory::create();

// TLS コンテキスト設定
$ctx = stream_context_create([
'ssl' => ['local_cert' => $this->certPath]
]);
// TLS サーバーソケット起動
$server = new SecureServer(
new Server("{$this->host}:{$this->port}", $loop),
$loop, ['tls' => $ctx]
);
$server->on('connection', function($conn) {
$conn->on('data', fn($url) =>
$this->handler->handle($conn, $url)
);
});
$loop->run();
}
}

20

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP ReactPHP の API ポイント SecureServer on('connection') TLS 対応ソケットサーバー。証明書パスを渡すだけで HTTPS 的な暗号化ができ 接続が来るたびにコールバックが呼ばれる。同期的な while ループは不要。 る。 on('data') $loop->run() データが届いたタイミングで handler を呼び出す。Gemini はリクエストが 1 行。 ここでイベントループに入り、プロセスは終了せず待ち続ける。 21

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP Lagrange で実際に見てみる $ php bin/server.php Certificate: /certs/localhost.pem Gemini server listening on 0.0.0.0:1965 # Lagrange ブラウザで $ open gemini://localhost:1965/ Lagrange ― Windows/Mac/Linux 対応の Gemini 専用ブラウザ。 表示される：見出し・リスト・リンク・引用・コードブロック クリックで開く：画像・動画 存在しない：テーブル・スタイル指定・JS 22

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP 実際に使ってみて感じたこと 👍 よかった点 🤔 ストイックすぎる点 思想・哲学に強く共感 テーブルが存在しない 実装が驚くほどシンプル 画像はクリックで開く 仕様書が数ページで読める インライン装飾が一切なし コンテンツに集中できる 専用ブラウザが必要 ReactPHP との相性が抜群 SEO という概念がない 23

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP Gemini は「普及」を目指していない “ 現代 Web の置き換えではなく、 ミニマルな補完として存在する。 “ “ デジタルミニマリズムを実践したい人のためのスペース。 遅くていい、不便でいい、それが哲学。 “ 小さなコミュニティが今も活発に運営 「書くこと」そのものを楽しむ文化 技術者が自分で実装できるシンプルさ 24

GEMINI PROTOCOL × REACTPHP Gemini Protocol × ReactPHP 自分のものを 自分でホストする X でつぶやいて終わり、になっていませんか？ レコメンドシステムに自分の主張をおさえつけられていないか？ 20 年後も参照できるコンテンツを、自分のカプセルから発信しよう。 github.com/ha1t/php-gm-server 25