什么是 PHP 中的 strpos 函数？附基本用法和简单示例说明

gitbox 2025-06-15

在 PHP 编程中，strpos 是一个常用的字符串函数，用于查找某个子字符串首次出现的位置。这个函数特别有用，当你需要检查一个字符串中是否存在某个特定的子字符串时，它能帮助你快速定位位置。如果找到了，strpos 会返回该子字符串的第一个出现位置（基于 0 的索引）；如果找不到，则返回 false。

基本语法

<span><span><span class="hljs-title function_ invoke__">strpos</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$needle</span></span><span>, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$offset</span></span><span> = </span><span><span class="hljs-number">0</span></span><span>): </span><span><span class="hljs-keyword">mixed</span></span><span>
</span></span>

参数解释：

$haystack：要搜索的字符串。
$needle：要查找的子字符串。
$offset：可选参数，表示从 $haystack 的哪个位置开始搜索，默认为 0（从头开始搜索）。

返回值：

如果找到 $needle，则返回它在 $haystack 中首次出现的位置（整数，基于 0 的索引）。
如果没有找到 $needle，则返回 false。

示例

示例 1：基本查找

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$haystack</span></span><span> = </span><span><span class="hljs-string">"Hello, welcome to the PHP world!"</span></span><span>;
</span><span><span class="hljs-variable">$needle</span></span><span> = </span><span><span class="hljs-string">"PHP"</span></span><span>;

</span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strpos</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$needle</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$position</span></span><span> !== </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"找到 '<span class="hljs-subst">$needle</span></span></span><span>' 在字符串中的位置: </span><span><span class="hljs-subst">$position</span></span><span>";
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"'<span class="hljs-subst">$needle</span></span></span><span>' 未在字符串中找到";
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

输出：

<span><span>找到 </span><span><span class="hljs-string">'PHP'</span></span><span> 在字符串中的位置: 18
</span></span>

在这个例子中，strpos 查找的是字符串 "PHP" 在 "$haystack" 中的位置。返回的结果是 18，因为 "PHP" 从第 18 个字符开始。

示例 2：从指定位置开始查找

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$haystack</span></span><span> = </span><span><span class="hljs-string">"Hello, welcome to the PHP world!"</span></span><span>;
</span><span><span class="hljs-variable">$needle</span></span><span> = </span><span><span class="hljs-string">"o"</span></span><span>;

</span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strpos</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$needle</span></span><span>, </span><span><span class="hljs-number">5</span></span><span>);  </span><span><span class="hljs-comment">// 从第5个字符位置开始查找</span></span><span>

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$position</span></span><span> !== </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"从位置 5 开始找到 'o' 在字符串中的位置: <span class="hljs-subst">$position</span></span></span><span>";
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"'o' 未在字符串中找到"</span></span><span>;
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

输出：

<span><span>从位置 </span><span><span class="hljs-number">5</span></span><span> 开始找到 </span><span><span class="hljs-string">'o'</span></span><span> 在字符串中的位置: </span><span><span class="hljs-number">7</span></span><span>
</span></span>

在这个示例中，strpos 会跳过前五个字符（即 "Hello"），然后从第 5 个字符开始查找 "o"。结果返回的是第一个 "o" 出现的位置，即第 7 个字符。

示例 3：查找字符串中不存在的子字符串

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$haystack</span></span><span> = </span><span><span class="hljs-string">"Hello, welcome to the PHP world!"</span></span><span>;
</span><span><span class="hljs-variable">$needle</span></span><span> = </span><span><span class="hljs-string">"Python"</span></span><span>;

</span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strpos</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$needle</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$position</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"'<span class="hljs-subst">$needle</span></span></span><span>' 未在字符串中找到";
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"找到 '<span class="hljs-subst">$needle</span></span></span><span>' 在字符串中的位置: </span><span><span class="hljs-subst">$position</span></span><span>";
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

输出：

<span><span><span class="hljs-string">'Python'</span></span><span> 未在字符串中找到
</span></span>

在这个例子中，"Python" 并不存在于 $haystack 中，strpos 会返回 false，并且我们通过 === 比较操作符来确保准确判断。

注意事项

返回值的比较：需要特别注意，strpos 返回的结果可能是 0，这意味着子字符串出现在字符串的开头。由于 0 被视为 false，如果直接使用 if ($position) 进行判断，可能会导致错误的判断结果。因此，应该使用 !== false 来检查返回值是否为 false。
区分大小写：strpos 是区分大小写的，如果你需要不区分大小写的查找，可以使用 stripos 函数。

stripos 示例：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$haystack</span></span><span> = </span><span><span class="hljs-string">"Hello, welcome to the PHP world!"</span></span><span>;
</span><span><span class="hljs-variable">$needle</span></span><span> = </span><span><span class="hljs-string">"php"</span></span><span>;

</span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">stripos</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$needle</span></span><span>);  </span><span><span class="hljs-comment">// 不区分大小写的查找</span></span><span>

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$position</span></span><span> !== </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"找到 '<span class="hljs-subst">$needle</span></span></span><span>'（不区分大小写）在字符串中的位置: </span><span><span class="hljs-subst">$position</span></span><span>";
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"'<span class="hljs-subst">$needle</span></span></span><span>' 未在字符串中找到";
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

输出：

<span><span>找到 </span><span><span class="hljs-string">'php'</span></span><span>（不区分大小写）在字符串中的位置: 18
</span></span>

总结

strpos 是 PHP 中非常实用的字符串函数，能够帮助你高效地查找子字符串的首次出现位置。通过合理的使用，可以方便地处理字符串搜索的需求。在开发中，掌握这个函数的基本用法，可以大大提高代码的效率和可读性。

strpos