1 files changed, 73 insertions, 0 deletions
diff --git a/services/blog/content/posts/2025-04-24/composer-patches-v2-does-not-require-gnu-patch-even-on-macos.dj b/services/blog/content/posts/2025-04-24/composer-patches-v2-does-not-require-gnu-patch-even-on-macos.dj
new file mode 100644
index 00000000..b64b7981
--- /dev/null
+++ b/services/blog/content/posts/2025-04-24/composer-patches-v2-does-not-require-gnu-patch-even-on-macos.dj
@@ -0,0 +1,73 @@
+---
+[article]
+uuid = "087e98f2-743c-48d8-9f67-e9b57e354845"
+title = "【Composer】 composer-patches v2 では macOS でも GNU patch のインストールが不要になる (予定)"
+description = "composer-patches は BSD patch に対応しておらず、一部のパッチの適用に失敗する。現在ベータ版である v2 では patch コマンドに依存しなくなり、macOS で使うときのストレスが解消される見込み。"
+tags = [
+  "composer",
+  "macos",
+  "php",
+]
+
+[[article.revisions]]
+date = "2025-04-10"
+remark = "デジタルサーカス株式会社の社内記事として公開"
+isInternal = true
+
+[[article.revisions]]
+date = "2025-04-24"
+remark = "公開"
+---
+::: note
+この記事は、2025-04-10 に [デジタルサーカス株式会社](https://www.dgcircus.com/) の社内 Qiita Team に公開された記事をベースに、加筆修正して一般公開したものです。
+:::
+
+{#intro}
+# はじめに
+
+[Composer](https://getcomposer.org/) は PHP におけるデファクトスタンダードなパッケージ管理システムである。
+
+Composer を拡張するプラグインの一つに、[composer-patches](https://github.com/cweagans/composer-patches) という Composer パッケージがある。
+これは、Composer でパッケージをインストールするときにそのパッケージへ任意のパッチを当てるプラグインである。
+
+社内で発見しすぐに適用しなければならないバグ修正や、Pull Request こそあるもののなかなかマージされない機能等をすぐさま適用してリリースすることができる。
+
+弊社でも多くのプロジェクトで活用されており、のべ数では数百ものパッチが当てられている。
+
+{#on-macos}
+# macOS での問題点
+
+`composer-patches` は、macOS で一部のパッチの適用に失敗することが知られている。
+関連 issues:
+
+* https://github.com/cweagans/composer-patches/issues/522
+* https://github.com/cweagans/composer-patches/issues/326
+
+これは、`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 よりも優先されるパスに配置すれば問題が解消する。
+
+{#in-version-2}
+# v2 では
+
+現在ベータ版である `composer-patches` v2 では、このワークアラウンドが不要になる (見込み)。
+
+最新の実装では、`git apply` コマンドが最優先で使われる。
+また、Git リポジトリがない場合 (`config.preferred-install` を `dist` に設定している場合など。デフォルトではそうなる) には `git init` を使って一時的にリポジトリを作成し、その上で `git apply` を実行するようになった。
+
+この変更により、環境ごとに差異のある `patch` コマンドへの依存がなくなるので、macOS で `composer-patches` を使うときの厄介事は解消されるものと思われる。
+
+[2.0.0-beta1](https://github.com/cweagans/composer-patches/releases/tag/2.0.0-beta1) のリリースノートより:
+
+> * Only have git patchers and freeform patcher? by [*@cweagans*](https://github.com/cweagans) in [#472](https://github.com/cweagans/composer-patches/pull/476)
+
+この変更で `patch` コマンドへの依存が排除された。