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文字後ろにずれています。

修正前:--worktree-at までが文字列の色になっている

修正後:オプションの色で表示される

最初は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のバージョンにまでつながっていました。