-
-

更新履歴

-
    -
  1. - : デジタルサーカス株式会社の社内記事として公開 -
    2. -
  2. - : 公開 -
    3. -
-
-
-
- NOTE -
-
-

- この記事は、2025-04-10 に デジタルサーカス株式会社 の社内 Qiita Team に公開された記事をベースに、加筆修正して一般公開したものです。 -

-
-
-
-

はじめに

-

- Composer は PHP におけるデファクトスタンダードなパッケージ管理システムである。 -

-

- Composer を拡張するプラグインの一つに、composer-patches という Composer パッケージがある。これは、Composer でパッケージをインストールするときにそのパッケージへ任意のパッチを当てるプラグインである。 -

-

- 社内で発見しすぐに適用しなければならないバグ修正や、Pull Request こそあるもののなかなかマージされない機能等をすぐさま適用してリリースすることができる。 -

-

- 弊社でも多くのプロジェクトで活用されており、のべ数では数百ものパッチが当てられている。 -

-
-
-

macOS での問題点

-

- composer-patches は、macOS で一部のパッチの適用に失敗することが知られている。関連 issues: -

- -

- これは、composer-patches の想定する patch コマンドが GNU 実装の patch であることに由来する。macOS にプリインストールされている patch はいわゆる BSD patch であり、GNU patch とは完全な互換性がない。 -

-

- ワークアラウンドとして、macOS にも GNU patch をインストールしてしまうという方法がある。例: -

-
- 
$ brew install gpatch
-$ echo 'PATH="/opt/homebrew/opt/gpatch/libexec/gnubin:$PATH"' >> ~/.zshrc
-
-

- GNU patch を Homebrew などの手段でインストールし、BSD patch よりも優先されるパスに配置すれば問題が解消する。 -

-
-
-

v2 では

-

- 現在ベータ版である composer-patches v2 では、このワークアラウンドが不要になる (見込み)。 -

-

- 最新の実装では、git apply コマンドが最優先で使われる。また、Git リポジトリがない場合 (config.preferred-install を dist に設定している場合など。デフォルトではそうなる) には git init を使って一時的にリポジトリを作成し、その上で git apply を実行するようになった。 -

-

- この変更により、環境ごとに差異のある patch コマンドへの依存がなくなるので、macOS で composer-patches を使うときの厄介事は解消されるものと思われる。 -

-

- 2.0.0-beta1 のリリースノートより: -

-
-
    -
  • - Only have git patchers and freeform patcher? by @cweagans in #472 -
    • -
-
-

- この変更で patch コマンドへの依存が排除された。 -

-
-