当前位置：首页 > PHP

php strpos源码实现

2026-02-16 06:10:30PHP

PHP strpos 源码实现分析

PHP 的 strpos 函数用于查找字符串中子字符串首次出现的位置。其底层实现基于 C 语言，核心逻辑在 PHP 源码的 ext/standard/string.c 文件中。

函数原型

strpos 的 C 语言实现原型如下：

PHP_FUNCTION(strpos)
{
    zend_string *haystack;
    zend_string *needle;
    zend_long offset = 0;
    zend_bool strict = 0;

    ZEND_PARSE_PARAMETERS_START(2, 3)
        Z_PARAM_STR(haystack)
        Z_PARAM_STR(needle)
        Z_PARAM_OPTIONAL
        Z_PARAM_LONG(offset)
        Z_PARAM_BOOL(strict)
    ZEND_PARSE_PARAMETERS_END();

    // 核心查找逻辑
    php_strpos_impl(return_value, haystack, needle, offset, strict);
}

核心查找逻辑

php_strpos_impl 是实际执行查找的函数：

php strpos源码实现

static void php_strpos_impl(
    zval *return_value, 
    zend_string *haystack, 
    zend_string *needle, 
    zend_long offset, 
    zend_bool strict
) {
    const char *p, *e;
    char *r;
    size_t haystack_len = ZSTR_LEN(haystack);
    size_t needle_len = ZSTR_LEN(needle);

    // 边界检查
    if (needle_len == 0) {
        php_error_docref(NULL, E_WARNING, "Empty needle");
        RETURN_FALSE;
    }

    if (offset < 0) {
        offset += haystack_len;
    }

    if (offset < 0 || (size_t)offset > haystack_len) {
        php_error_docref(NULL, E_WARNING, "Offset not contained in string");
        RETURN_FALSE;
    }

    // 实际字符串匹配
    p = ZSTR_VAL(haystack) + offset;
    e = ZSTR_VAL(haystack) + haystack_len;
    r = php_memnstr(p, ZSTR_VAL(needle), needle_len, e);

    if (r) {
        RETURN_LONG(r - ZSTR_VAL(haystack));
    } else {
        RETURN_FALSE;
    }
}

关键点说明

参数处理：解析输入参数，包括目标字符串 haystack、查找字符串 needle、起始偏移量 offset 和严格模式标志 strict。
边界检查：验证 needle 非空，检查 offset 是否在有效范围内。负偏移量会从字符串末尾开始计算。
字符串匹配：使用 php_memnstr 函数执行实际的字符串匹配。该函数类似于标准 C 的 memmem，但针对 PHP 进行了优化。
结果返回：找到匹配时返回位置（字节偏移量），否则返回 false。