PHP substr()：截取字符串的一部分

substr($string, $offset, $length) 返回 $string 中从位置 $offset（从 0 开始计算）开始、长度为 $length 个字符的部分。substr('Hello world', 0, 5) 返回 "Hello"。省略 $length 就会一直取到末尾。

<?php
$s = 'Hello world';

echo substr($s, 0, 5), "\n";   // from the start, 5 characters
echo substr($s, 6), "\n";      // from position 6 to the end
echo substr($s, 4, 3), "\n";   // 3 characters from position 4

substr() 按字节计数。对英文文本来说，字节数和字符数相同，但对日文、中文、emoji 或带重音的字母就不一样了。处理这些文本时用 mb_substr()，下文会讲到。

语法

substr(string $string, int $offset, ?int $length = null): string

• $offset 是起始位置。0 是第一个字符。负数表示从末尾开始计算。
• $length 是要取的字节数（在纯 ASCII 文本中，一个字节就是一个字符）。负数表示在末尾留下那么多个不取。null（或者省略）表示“取到末尾”。

负数的偏移量和长度：从末尾开始

负数的 $offset 从字符串末尾开始计算，所以 -1 是最后一个字符。负数的 $length 在距末尾那么多个字符的地方停下。

<?php
$file = 'report-2026.pdf';

echo substr($file, -3), "\n";       // last 3 characters
echo substr($file, -8, 4), "\n";    // 4 characters, starting 8 from the end
echo substr($file, 0, -4), "\n";    // everything except the last 4
echo substr($file, 7, -4), "\n";    // from position 7, minus the last 4

substr($s, 0, -1) 是去掉最后一个字符的常用写法，比如去掉循环留下的末尾逗号。

获取第一个或最后一个字符

对于单个字节，也可以直接用下标访问字符串。$s[0] 是第一个字符，从 PHP 7.1 开始，$s[-1] 是最后一个字符。

<?php
$word = 'banana';

echo substr($word, 0, 1), ' ', $word[0], "\n";    // first character
echo substr($word, -1), ' ', $word[-1], "\n";     // last character
echo substr($word, 1), "\n";                     // drop the first character

用下标访问不存在的位置会打印警告，而 substr() 只会返回空字符串。如果字符串可能为空，优先用 substr()。

超出范围：返回空字符串，而不是 false

如果 $offset 超出了字符串末尾，PHP 8 中 substr() 返回 ""。PHP 7 中它返回 false，所以检查 === false 的旧代码已经不再有效。

<?php
var_dump(substr('abc', 5));       // start past the end
var_dump(substr('abc', 1, 100));  // length longer than the rest is fine
var_dump(substr('abc', -10));     // negative offset before the start: from 0

中文和日文文本：用 mb_substr

UTF-8 中假名和常用汉字各占 3 个字节（𠮷 这样的生僻字和 emoji 占 4 个）。substr() 按字节计数，所以 substr('こんにちは', 0, 3) 只返回 こ；如果长度没有落在字符边界上，就会把一个字符切成两半，得到乱码。mb_substr() 接收同样的参数，但按字符计数。

<?php
$greeting = 'こんにちは世界';

echo substr($greeting, 0, 3), "\n";       // 3 bytes = 1 character
echo mb_substr($greeting, 0, 3), "\n";    // 3 characters
echo mb_substr($greeting, -2), "\n";      // last 2 characters

// Cutting at 4 bytes splits a character: the result is not valid UTF-8
var_dump(mb_check_encoding(substr($greeting, 0, 4), 'UTF-8'));

emoji 和 é 这样带重音的字母也是同样的道理。统计字符数用 mb_strlen()；字节和字符的区别见 strlen()。

截断文本并加省略号

在列表或卡片里截短过长的标题，是 substr() 在实际项目中最常见的用法。用 mb_substr()，确保中文或日文标题不会在字符中间被切断，并且只在真的截短了内容时才加上 ...。

<?php
function excerpt(string $text, int $max): string
{
    if (mb_strlen($text) <= $max) {
        return $text;
    }
    return rtrim(mb_substr($text, 0, $max)) . '...';
}

echo excerpt('Short title', 20), "\n";
echo excerpt('A much longer title that will not fit in the card', 20), "\n";
echo excerpt('東京から大阪までの新幹線の旅', 8), "\n";

mb_strimwidth($text, 0, $width, '...') 按显示宽度做同样的事，一个全角的中日文字符算 2 列，一个拉丁字母算 1 列。它适合等宽排版。

用 substr_count 统计子串次数

substr_count($haystack, $needle) 返回 $needle 出现的次数。它区分大小写，不统计重叠的匹配。

<?php
echo substr_count('banana', 'an'), "\n";
echo substr_count('aaaa', 'aa'), "\n";      // 2, not 3: no overlaps
echo substr_count('Hello hello', 'hello'), "\n";
echo substr_count(strtolower('Hello hello'), 'hello'), "\n";

substr 配合 strpos：取某个字符之前或之后的文本

把 substr() 和 strpos() 结合起来，就能在事先不知道位置的字符处截断，比如邮箱地址里的 @：

<?php
$email = 'ada.lovelace@example.com';
$at = strpos($email, '@');

echo substr($email, 0, $at), "\n";    // before the @
echo substr($email, $at + 1), "\n";   // after the @

// strstr does the same in one call
echo strstr($email, '@', true), "\n";

使用 strpos() 的结果之前，先确认它没有返回 false：如果字符不存在，false 会被悄悄当成 0，不会有任何警告，于是 substr('nobody', 0, $at) 返回 ""，substr('nobody', $at + 1) 返回 "obody"。