本文详细解析php `substr` 函数在处理负数 `length` 参数时的行为。我们将阐明负数 `length` 并非表示第二个偏移量，而是指从字符串末尾省略指定数量的字符，并重点解释 `offset` 参数优先于 `length` 参数的计算顺序，尤其是在 `offset` 自身也为负数时的处理逻辑，通过具体示例帮助读者掌握其精确用法。
PHP substr 函数基础
substr 是 PHP 中一个常用的字符串处理函数，用于从字符串中提取子字符串。其基本语法为 substr(string $string, int $offset, ?int $length = null): string|false。
- $string: 待处理的输入字符串。
- $offset: 指定子字符串的起始位置。
- 正数 offset：从字符串开头（索引0）开始计算。
- 负数 offset：从字符串末尾开始计算。例如，-1 表示倒数第一个字符。
- $length: 指定子字符串的长度。
- 正数 length：表示要返回的子字符串的长度。
- null 或省略：表示从 offset 处到字符串末尾的所有字符。
- 负数 length：这是本文的重点，表示从字符串末尾省略指定数量的字符。
解析 length 参数的负值行为
当 $length 参数为负数时，它不再表示提取的子字符串的长度，而是指示 substr 函数在确定子字符串的最终边界时，从字符串的末尾（在 offset 确定起始位置之后）忽略多少个字符。
让我们通过几个示例来理解这一行为：
示例 1：正数 offset 与负数 length
立即学习“PHP免费学习笔记（深入）”；
echo substr("abcdefgh", 1, -1);
// 输出: bcdefg解析：
- offset = 1：从字符串 "abcdefgh" 的索引 1 处开始，即从字符 'b' 开始。此时，我们关注的有效部分是 "bcdefgh"。
- length = -1：表示从当前有效部分 "bcdefgh" 的末尾省略 1 个字符。末尾的字符是 'h'，省略后得到 "bcdefg"。
示例 2：正数 offset 与负数 length
echo substr("abcdefgh", 2, -2);
// 输出: cdef解析：
- offset = 2：从字符串 "abcdefgh" 的索引 2 处开始，即从字符 'c' 开始。有效部分是 "cdefgh"。
- length = -2：表示从当前有效部分 "cdefgh" 的末尾省略 2 个字符。末尾的字符是 'g' 和 'h'，省略后得到 "cdef"。
从上述示例可以看出，负数 length 并非指定第二个偏移量，而是从 offset 确定的起始点到字符串末尾的这段子字符串中，再从其末尾进行截断。
offset 与 length 参数的计算优先级
PHP 官方文档中关于 length 参数的描述提到：“如果 length 参数是负数，那么将从 string 的末尾省略掉 length 那么多的字符（在 offset 参数是负数时，起始位置计算之后）。” 这句话强调了一个关键点：offset 参数的计算总是优先于 length 参数。无论 offset 是正数还是负数，它都会首先被用来确定子字符串的有效起始位置。length 参数（尤其是负数 length）则是在这个确定的起始位置之后，对剩余部分进行进一步的裁剪。
示例 3：负数 offset 与负数 length
这是一个更复杂的场景，有助于理解计算顺序的重要性：
echo substr("phpisfun", -5, -2);
// 输出: isf解析：
- 处理 offset 参数： offset = -5。字符串 "phpisfun" 的长度为 8。从末尾倒数 5 个字符，即 8 - 5 = 3，对应索引 3 处的字符 'i'。因此，子字符串的有效起始点是 'i'。从这个点开始，字符串可以看作 "isfun"。
- 处理 length 参数： length = -2。现在，我们从 offset 确定的有效部分 "isfun" 中，从末尾省略 2 个字符。末尾的字符是 'u' 和 'n'。省略后，最终结果是 "isf"。
如果计算顺序颠倒（先处理 length，再处理 offset），结果将完全不同。例如，如果先从 "phpisfun" 末尾省略 2 个字符（'u', 'n'），得到 "phpisf"。然后从这个新字符串的倒数第 5 个字符开始，将得到 'h'。这与实际输出的 'isf' 不符，再次证明了 offset 优先计算的原则。
综合代码示例
<?php
// 示例 1: 正数 offset, 负数 length
// 从索引 1 ('b') 开始，从剩余部分 "bcdefgh" 的末尾省略 1 个字符 ('h')
echo "substr(\"abcdefgh\", 1, -1) => " . substr("abcdefgh", 1, -1) . "\n"; // 输出: bcdefg
// 示例 2: 正数 offset, 负数 length
// 从索引 2 ('c') 开始，从剩余部分 "cdefgh" 的末尾省略 2 个字符 ('g', 'h')
echo "substr(\"abcdefgh\", 2, -2) => " . substr("abcdefgh", 2, -2) . "\n"; // 输出: cdef
// 示例 3: 负数 offset, 负数 length
// offset -5 定位到 'i' (字符串 "phpisfun" 的索引 3)
// 从 'i' 开始的有效部分是 "isfun"
// 从 "isfun" 的末尾省略 2 个字符 ('u', 'n')
echo "substr(\"phpisfun\", -5, -2) => " . substr("phpisfun", -5, -2) . "\n"; // 输出: isf
// 示例 4: 负数 offset, 正数 length
// offset -4 定位到 's' (字符串 "phpisfun" 的索引 4)
// 从 's' 开始提取长度为 3 的子字符串
echo "substr(\"phpisfun\", -4, 3) => " . substr("phpisfun", -4, 3) . "\n"; // 输出: sfu
// 示例 5: 仅负数 offset (length 为 null)
// offset -3 定位到 'f' (字符串 "phpisfun" 的索引 5)
// 从 'f' 开始到字符串末尾
echo "substr(\"phpisfun\", -3) => " . substr("phpisfun", -3) . "\n"; // 输出: fun
?>总结与实践建议
理解 substr 函数中负数 length 参数的行为对于编写精确的字符串处理代码至关重要。
- 负数 length 的核心含义： 它表示从 offset 确定的起始位置开始，到字符串的末尾之间，再从末尾向前截断指定数量的字符。它不是第二个偏移量。
- 计算顺序： offset 参数总是优先计算，以确定子字符串的实际起始点。length 参数（无论是正数还是负数）都是基于这个起始点进行后续操作。
- 阅读官方文档： 当对函数的行为有疑问时，查阅官方文档是最佳实践。虽然有时描述可能略显晦涩，但结合示例和实验，能够帮助我们准确理解其工作原理。
通过掌握这些细节，开发者可以更自信、更高效地使用 substr 函数进行字符串操作。
