blob: b64b7981477317f102c4d200a56d6b76dc9fa29e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
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` コマンドへの依存が排除された。
|
