LaravelのブログでMarkdownのコードブロックをハイライトするために、PHP製のシンタックスハイライター Phiki を使っています。旧サイトの記事を移行して表示を確認していたところ、日本語を含むコードブロックで色付けがずれることに気付きました。
原因はPhikiの中で使われている mb_ereg_search_pos() の戻り値でした。上流で修正が提案されていたので、それを cweagans/composer-patches で当てています。さらに、本番のレンタルサーバーではgitが古くてパッチが当たらないという問題も踏みました。
検証環境(2026年11月時点)
- PHP 8.4 / Laravel 13
- phiki/phiki 2.2.1
- cweagans/composer-patches 2.x
日本語の後ろから色がずれる
例えば、次のコマンドで起きます。
git archive -o 圧縮ファイル名.zip --worktree-attributes HEAD
修正前のPhikiでは、日本語の後ろにあるトークンが別の種類として扱われていました。--worktree-attributes のうち --worktree-at までが文字列の色になり、後ろの tributes だけがオプションの色になります。オプションの色が付き始める位置が、14文字後ろにずれています。


最初はCSSかテーマの問題だと思いました。でも、日本語を英数字に変えると、修正前でも正しく色が付きます。
バイト位置を文字位置として扱っていた
Phikiは正規表現でトークンを探すときに、マルチバイト対応の mb_ereg_search_pos() を使っています。この関数が返すのはバイト単位の位置です。
mb_regex_encoding('UTF-8');
mb_ereg_search_init('設定abc', 'abc');
var_dump(mb_ereg_search_pos()); // [6, 3](「設定」はUTF-8で6バイト)
ところが、受け取った側はこれを文字単位の位置として mb_substr() などで使っていました。UTF-8の日本語は1文字3バイトなので、日本語が1文字出てくるたびに位置が2ずつずれていきます。英語だけなら1文字1バイトなので、ずれは起きません。
上流の修正をcomposer-patchesで当てる
上流のリポジトリに、バイト位置で正しく扱うように直す修正(PR #149)が出ていました。マージとリリースを待つ間、この修正の2つのコミットをパッチファイルにして、cweagans/composer-patches で当てています。パッチは特定のバージョンに対して作るものなので、phiki/phiki は 2.2.1 に固定しています。
composer require cweagans/composer-patches:^2.0
{
"extra": {
"patches": {
"phiki/phiki": [
{
"description": "Multibyte fix 1/2: locate captures by byte offset (phikiphp/phiki#149, d6b4d33)",
"url": "patches/phiki-2.2.1-pr149-locate-captures-by-byte-offset.patch"
},
{
"description": "Multibyte fix 2/2: cut retokenized captures at the right byte offset (phikiphp/phiki#149, 8e48b56)",
"url": "patches/phiki-2.2.1-pr149-cut-retokenized-captures.patch"
}
]
}
}
}
composer-patches 2.x では patches.lock.json が作られるので、これもコミットしておきます。パッチの内容が変わるとロックとの差分で気付けます。
パッチが当たらなかったときに、気付かず修正前のPhikiが入ることは避けたいところです。composer-patches 2.x は、パッチが当たらないと既定で composer install を失敗させるので、この点は設定なしで守られます。さらに、日本語を含むコードのハイライト結果を比べる回帰テストも用意しました。
本番でだけパッチが当たらない
ローカルとCIでは問題なく当たったのに、本番のレンタルサーバーで composer install が失敗しました。
No available patcher was able to apply patch ...
composer-patches 2.x は、まずgitを使うパッチャーを試します。このパッチャーは git -C <パス> apply を実行しますが、-C オプションはgit 1.8.5で追加されたものです。サーバーのgitは1.8.3で、このオプションがありません。
Unknown option: -C
レンタルサーバーなのでgitを更新することもできません。
GNU patchを使うFreeformPatcherを設定する
composer-patches 2.x には、任意のコマンドでパッチを当てる FreeformPatcher があります。実行ファイルと引数を設定したときだけ動くので、2つのパッチそれぞれに設定を追加しました。
{
"description": "Multibyte fix 1/2: locate captures by byte offset (phikiphp/phiki#149, d6b4d33)",
"url": "patches/phiki-2.2.1-pr149-locate-captures-by-byte-offset.patch",
"extra": {
"freeform": {
"executable": "patch",
"args": "-t -p%s --no-backup-if-mismatch -d %s -i %s",
"dry_run_args": "-t -p%s --dry-run --no-backup-if-mismatch -d %s -i %s"
}
}
}
引数のポイントは2つです。
-t(バッチモード):質問をせずに進めるオプションです。デプロイ中に入力待ちで止まらないようにします。逆向きに見えるパッチは逆に当てる(すでに当たっているパッチを外す)点には注意が必要です。ただ、composer-patches がパッチを当てるのは、Composer がパッケージを新しく展開した直後(インストールと更新のとき)だけです。すでにパッチが当たった vendor にもう一度当てることはないので、問題になりません。--no-backup-if-mismatch:GNU patch 2.7系は、ハンクが元の行番号からずれた位置(offset)に当たると、元ファイルを.origとして残します。vendorに不要なファイルを残さないために付けました。
gitが新しいローカルとCIでは従来どおりgitのパッチャーが使われ、gitが古いサーバーでだけFreeformPatcherに切り替わります。
CIでサーバーと同じ経路も検証する
今回の問題は、ローカルとCIではgitのパッチャーが成功してしまうため、サーバーで初めて表に出ました。そこでCIに、gitのパッチャーを無効にしてGNU patchだけで新規インストールするジョブを追加しました。gitのパッチャーは環境変数 COMPOSER_PATCHES_DISABLE_PATCHERS で無効にしています。
COMPOSER_PATCHES_DISABLE_PATCHERS には \cweagans\Composer\Patcher\GitPatcher,\cweagans\Composer\Patcher\GitInitPatcher を指定しました。先頭の \ が必要で、カンマの後に空白を入れると効きません。GitInitPatcher は GitPatcher を継承していますが、片方だけ書いてももう片方は無効になりません。
サーバーのGNU patchは2.7系なので、ubuntu-22.04(2.7系)と ubuntu-latest(2.8)(2026年11月時点ではubuntu 26.04)の両方で動かしています。
このジョブでは次を確認しています。
- 2つのパッチがFreeformPatcherで当たること
vendor/phiki/phikiに.origや.rejが残っていないこと- 日本語を含むコードの回帰テストが通ること
日をまたぎましたが、作業時間で言うと、原因の調査からサーバーでの対応まで全部で4時間ほどでした。最初はCSSを疑っていた問題が、最後はサーバーのgitのバージョンにまでつながっていました。