PHP 字串部分替換：substr_replace() 函數完整用法指南

前言

substr_replace() 可在字串指定位置、指定長度範圍內替換為新字串，比 str_replace() 更精確控制替換範圍。本文詳細說明參數、多重替換與實務範例。

函數簽名

substr_replace(
    string|array $string,
    string|array $replace,
    int|array $offset,
    int|array $length = null
): string|array

參數說明

• $offset：起始位置（0 為開頭，負數從結尾倒數）。
• $length：替換長度。0 為插入不刪除；正數刪除該長度；負數保留結尾該長度；null 替換到結尾。

基本範例：倒數計時訊息

<?php
$msg = "Warning: System will shutdown in NN minutes!";
$pos = strpos($msg, "NN");

echo substr_replace($msg, "15", $pos, 2) . "\n"; // Warning: System will shutdown in 15 minutes!
sleep(10); // 模擬 10 秒
echo substr_replace($msg, "5", $pos, 2) . "\n";  // Warning: System will shutdown in 5 minutes!
?>

進階用法

<?php
$str = "abcdef";

// 插入不刪除（length=0）
echo substr_replace($str, "XXX", 2, 0) . "\n"; // abXXXcdef

// 替換到結尾（length=null）
echo substr_replace($str, "XYZ", 2) . "\n";    // abXYZ

// 保留結尾 2 字元（length=-2）
echo substr_replace($str, "MID", 1, -2) . "\n"; // aMIDef

// 陣列批次處理
$arr = ["apple", "banana", "cherry"];
echo implode(", ", substr_replace($arr, "FRUIT_", 0, 0)) . "\n";
// FRUIT_apple, FRUIT_banana, FRUIT_cherry
?>

與 str_replace() 比較

總結

substr_replace() 以位置索引精確控制替換範圍，適合模板訊息、固定格式字串處理。掌握 $offset 與 $length 的正負數含義即可靈活運用。希望本文對您的 PHP 程式設計有所幫助。

1. 上一篇文章： PHP 文字段落自動換行：wordwrap() 函數用法詳解
2. 下一篇文章： PHP 尋找字串位置：strpos() 函數用法、回傳值陷阱與嚴格比較

PHP 相關知識

Appcan 應用客戶端自動更新機制：PHP 版本號比對、差分下載與安裝完整流程

Appcan 應用客戶端自動更新機制：PHP 版本號比對、差

Windows 下 PHPUnit 單元測試環境安裝圖文教程

Windows 下 PHPUnit 單元測試環境安裝圖文教程

CodeIgniter 框架源碼閱讀筆記：架構設計、核心流程與關鍵組件深度解析

前言 CodeIgniter (CI) 作為輕量級 PHP

PHP 字串遮罩工具：靈活隱藏手機、身分證等敏感資訊

需求背景 常見需求：手機號碼隱藏中間四碼（`0912****