2026.09.23 泊まれる場所4,223 立ち寄りスポット59,693 営業中を確認したキャンプ場1,005 note を読む

PHPのpreg_replaceで「$」と数字が消える原因|置き換える文字は後方参照として読まれる

テンプレートの値段を差し替えたら、ドル表記の値段だけが「0」になった。
エラーは出ない。
置き換える側の「$」と数字は、後方参照として読まれる。

PHPのpreg_replaceで、置き換える文字に「$100」と書くと、結果は「0」になる。
「$1,980円」は「,980円」になる。
エラーも警告も出ない。
原因は、置き換える側の文字の中の「$」と数字が、後方参照として読まれることだった。

直し方は3つある。
正規表現が要らないならstr_replaceに替える。
要るならpreg_replace_callbackで値を返すか、値の「$」と「\」をエスケープしてから渡す。
この記事のコードは、2026年11月12日に PHP 8.3.32 で動かして結果を確かめたものだ。

何が起きるのか

テンプレートの「{price}」を値段に差し替える、よくある処理で試す。

$tpl = 'お値段:{price}';
echo preg_replace('/\{price\}/', '$100', $tpl);
// お値段:0

echo preg_replace('/\{price\}/', '$1,980円', $tpl);
// お値段:,980円

echo preg_replace('/\{price\}/', '¥1,980', $tpl);
// お値段:¥1,980

「$100」が「0」になった。
「¥」で書いた値段は無事で、「$」で書いたものだけが壊れる。
値段がデータベースから来る場合、ふだんは「¥」なので気づかず、ドル表記の商品が来た日にだけ表示が変わる。
こういう壊れ方が、僕はいちばん怖いと思う。

置き換える側の「$1」は、後方参照として読まれる

PHPのマニュアルには、replacement(2つ目の引数)について、\n形式か$n形式で参照を書けると書かれている。
n は 0 から 99 まで。
それぞれ、n 番目のカッコにマッチした文字に置き換わる。
$0 は、パターン全体にマッチした文字だ。

「$100」の場合、PHP は「$10」を10番目のカッコとして読み、残りの「0」をただの文字として扱う。
今回のパターンにはカッコが1つも無いので、10番目は空っぽになる。
だから「空っぽ+0」で「0」。
「$1,980円」は「$1」が空になり、「,980円」だけが残る。

数字が2けたまで読まれる、というのがややこしい。
同じことが、カッコを使ったパターンでも起きる。

echo preg_replace('/(\d+)円/', '$10円', '100円');
// 円

echo preg_replace('/(\d+)円/', '${1}0円', '100円');
// 1000円

「1番目のカッコのあとに0を付けたい」つもりで「$10」と書くと、10番目を探して空になる。
マニュアルにも、後方参照の直後に数字を続けたい時は${1}のように波カッコで囲む、と例つきで書かれている。

バックスラッシュも同じことが起きる

「\」と数字も参照として読まれる。
Windows のパスのような値を入れると、こうなる。

echo preg_replace('/\{price\}/', 'C:\\new\\1st', $tpl);
// お値段:C:\newst

「\1」が空の参照として消え、「1st」の「1」がなくなった。
「$」と「\」の2つが、置き換える側で特別な意味を持つ文字だと覚えておくといい。

直し方1:正規表現が要らないなら str_replace

決まった文字を差し替えるだけなら、正規表現はいらない。
マニュアルの冒頭にも、パターンではなく文字列そのものと一致させたい時はstr_replace()を検討するように、と書かれている。

echo str_replace('{price}', '$100', $tpl);
// お値段:$100

str_replaceは、置き換える側の「$」も「\」も、ただの文字として扱う。
テンプレートの差し込みなら、これがいちばん事故が少ない。

直し方2:preg_replace_callback で値を返す

パターンを使いたい時は、preg_replace_callbackに替える。
関数が返した文字は、参照として読み直されない。

echo preg_replace_callback('/\{price\}/', fn($m) => '$100', $tpl);
// お値段:$100

「{name}」「{price}」のように差し込む場所がいくつもある時は、$m[1]でキーを取り出して配列から値を引く書き方にすると、1回で全部を差し替えられる。

直し方3:値の「$」と「\」をエスケープしてから渡す

既存のコードを大きく変えたくない時は、渡す値の側をエスケープする。

echo preg_replace('/\{price\}/', addcslashes('$100', '\\$'), $tpl);
// お値段:$100

addcslashesで「\」と「$」の前にバックスラッシュを足している。
ただ、これは「エスケープを忘れたら壊れる」形のままなので、僕は直し方1か2を先に考える。

ここでpreg_quoteを思い出す人もいると思う。
preg_quoteは、パターン(1つ目の引数)に入れる文字のためのエスケープだ。
置き換える側に使うものではない。
試しに「$1.5」をpreg_quoteしてから渡すと、「$」は守られたが、結果は「$1\.5」になり、要らないバックスラッシュが残った。

僕が気をつけていること

僕の作業メモには「テンプレート置換の対象の文字に、$と数字を入れない(後方参照として化ける)」と書いてある。
このサイトの CMS は、テンプレートやデータベースの文字を差し替える処理が多い。
差し込む値がどこから来るか分からない時ほど、preg_replaceの2つ目の引数に変数をそのまま渡していないかを見るようにしている。

見分け方は単純だと思う。
preg_replaceの2つ目の引数が、固定の文字ではなく変数になっていたら、一度止まって中身に「$」や「\」が入る可能性を考える。
入る可能性があるなら、直し方1か2に替える。

正規表現まわりでは、「.*?」が短く効きすぎてヘッダーを壊した話も書いた。
文字の長さで同じように気づきにくいのがstrlenとmb_strlenの違いで、比較の落とし穴はPHPの「==」の罠にまとめている。

出典

まる子パパ

まる子パパ

会社員。受託開発のエンジニアを15年以上続けていて、その前は寿司職人・長距離運転手・農業。 技術ブログは、キャンプの合間に踏んだバグと、AI・Web開発の運用の失敗を書いています。 このサイト自体が、開発に携わっているCMS「コンテナ」の稼働中の実例です。 このサイトについて / 小さな自動化の相談

—

ほかにも書いています

受託・note・スタンプ

※受託の相談とnoteは、運営者が個人で受けている・書いているものです。

技術ブログ一覧へ戻る