PHP strpos() 函數詳解：查找字符串首次出現位置

函數定義與用法

strpos() 函數返回字符串在另一個字符串中首次出現的位置（索引從 0 開始）。如果未找到，返回 FALSE。

語法

strpos(string $haystack, string $needle, int $offset = 0): int|false

• $haystack：被搜索的字符串（乾草堆）
• $needle：要查找的子字符串（針）
• $offset：可選，開始搜索的位置

重要特性

• 區分大小寫：strpos() 嚴格區分大小寫，不區分大小寫請用 stripos()。
• 返回值判斷：必須使用 === 或 !== 判斷，因為位置 0 會被當作 false。

代碼示例

<?php
// 基本用法
echo strpos("Hello world!", "wo"); // 輸出: 6

// 正確判斷是否找到
$pos = strpos("Hello world!", "wo");
if ($pos !== false) {
    echo "找到位置: $pos";
} else {
    echo "未找到";
}

// 區分大小寫對比
var_dump(strpos("Hello", "h")); // false
var_dump(stripos("Hello", "h")); // 0

常見陷阱

<?php
// ❌ 錯誤寫法：位置 0 會被當作 false
if (strpos("abc", "a")) { ... }

// ✅ 正確寫法
if (strpos("abc", "a") !== false) { ... }