preg_replace_callback回調函數參數是啥？詳解每個參數的作用

gitbox 2025-08-18

在PHP中， preg_replace_callback是一個非常實用的正則替換函數，它允許你在正則表達式匹配的基礎上，利用回調函數來處理匹配的結果。它通常用於復雜的替換需求，尤其是在匹配內容需要動態修改的情況下。理解回調函數的參數對於正確使用這個函數至關重要。本文將逐一解析preg_replace_callback回調函數中的每個參數的作用。

preg_replace_callback函數簡介

preg_replace_callback函數用於執行一個回調函數來替換匹配正則表達式的部分。它的基本語法如下：

 <span><span><span class="hljs-title function_ invoke__">preg_replace_callback</span></span><span>(</span><span><span class="hljs-variable">$pattern</span></span><span>, </span><span><span class="hljs-variable">$callback</span></span><span>, </span><span><span class="hljs-variable">$subject</span></span><span>);
</span></span>

$pattern : 正則表達式模式。
$callback : 用於處理匹配結果的回調函數。
$subject : 要進行匹配和替換的字符串。

回調函數的參數解析

回調函數是preg_replace_callback的核心，通常在匹配到的內容需要做特殊處理時，我們會通過回調函數來操作每一個匹配項。回調函數的定義可以是一個匿名函數，也可以是一個命名的函數。無論是哪種形式，回調函數都會接受特定數量的參數。

1.匹配結果數組(matches)

回調函數的第一個參數是一個數組，這個數組包含了正則表達式匹配到的所有結果。它的內容包括：

第一個元素（ $matches[0] ）是整個匹配的字符串。
後續的元素（ $matches[1] , $matches[2] , ...）是各個捕獲組（即正則表達式中的圓括號部分）的匹配結果。

例如，假設我們有如下的正則表達式：

 <span><span><span class="hljs-variable">$pattern</span></span><span> = </span><span><span class="hljs-string">'/(\d+)\-(\d+)/'</span></span><span>;
</span><span><span class="hljs-variable">$subject</span></span><span> = </span><span><span class="hljs-string">'12-34, 56-78'</span></span><span>;
</span></span>

然後，使用preg_replace_callback來處理：

 <span><span><span class="hljs-title function_ invoke__">preg_replace_callback</span></span><span>(</span><span><span class="hljs-variable">$pattern</span></span><span>, function(</span><span><span class="hljs-variable">$matches</span></span><span>) {
    </span><span><span class="hljs-title function_ invoke__">print_r</span></span><span>(</span><span><span class="hljs-variable">$matches</span></span><span>);
}, </span><span><span class="hljs-variable">$subject</span></span><span>);
</span></span>

執行結果為：

 <span><span><span class="hljs-title function_ invoke__">Array</span></span><span>
(
    [</span><span><span class="hljs-number">0</span></span><span>] =&gt; </span><span><span class="hljs-number">12</span></span><span>-</span><span><span class="hljs-number">34</span></span><span>
    [</span><span><span class="hljs-number">1</span></span><span>] =&gt; </span><span><span class="hljs-number">12</span></span><span>
    [</span><span><span class="hljs-number">2</span></span><span>] =&gt; </span><span><span class="hljs-number">34</span></span><span>
)
</span><span><span class="hljs-title function_ invoke__">Array</span></span><span>
(
    [</span><span><span class="hljs-number">0</span></span><span>] =&gt; </span><span><span class="hljs-number">56</span></span><span>-</span><span><span class="hljs-number">78</span></span><span>
    [</span><span><span class="hljs-number">1</span></span><span>] =&gt; </span><span><span class="hljs-number">56</span></span><span>
    [</span><span><span class="hljs-number">2</span></span><span>] =&gt; </span><span><span class="hljs-number">78</span></span><span>
)
</span></span>

$matches[0]是匹配到的完整字符串。
$matches[1]和$matches[2]是匹配到的子模式部分。

2.回調函數的返回值

回調函數的返回值將作為替換的結果。這意味著，回調函數不僅僅是一個數據處理函數，它的返回值直接影響替換的內容。如果回調函數返回一個字符串，這個字符串將替換掉原本匹配的部分。

例如：

 <span><span><span class="hljs-variable">$pattern</span></span><span> = </span><span><span class="hljs-string">'/(\d+)\-(\d+)/'</span></span><span>;
</span><span><span class="hljs-variable">$subject</span></span><span> = </span><span><span class="hljs-string">'12-34, 56-78'</span></span><span>;

</span><span><span class="hljs-variable">$replaced</span></span><span> = </span><span><span class="hljs-title function_ invoke__">preg_replace_callback</span></span><span>(</span><span><span class="hljs-variable">$pattern</span></span><span>, function(</span><span><span class="hljs-variable">$matches</span></span><span>) {
    </span><span><span class="hljs-comment">// 將兩個數字的和作為替換內容</span></span><span>
    </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-variable">$matches</span></span><span>[</span><span><span class="hljs-number">1</span></span><span>] + </span><span><span class="hljs-variable">$matches</span></span><span>[</span><span><span class="hljs-number">2</span></span><span>];
}, </span><span><span class="hljs-variable">$subject</span></span><span>);

</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$replaced</span></span><span>;
</span></span>

輸出結果為：

 <span><span>46, 134
</span></span>

在這個例子中，我們將匹配到的數字相加，並用結果替代原本的匹配字符串。

3.其它可選參數：offset 和limit

回調函數本身還可以通過$offset和$limit參數獲取更詳細的信息。這些參數通常由preg_replace_callback在內部處理，但你可以通過preg_replace_callback_array來更靈活地控制這些參數。通常情況下，在常見使用中，回調函數的第一個參數（ $matches ）和返回值就足夠了。

結論

preg_replace_callback函數和它的回調函數提供了極大的靈活性，允許開發者根據匹配的內容動態地進行替換。回調函數中的第一個參數$matches提供了關於匹配的詳細信息，包括完整匹配和捕獲的組信息，而回調函數的返回值則直接決定了替換後的內容。掌握了這些基礎概念後，你就可以利用preg_replace_callback實現複雜的正則替換操作。