substr() trong PHP: cắt lấy một phần của chuỗi

substr($string, $offset, $length) trả về phần của $string bắt đầu tại vị trí $offset (đếm từ 0) và dài $length ký tự. substr('Hello world', 0, 5) trả về "Hello". Bỏ $length đi để lấy mọi thứ cho đến cuối chuỗi.

<?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() đếm theo byte. Với văn bản tiếng Anh, byte cũng là ký tự, nhưng với tiếng Việt có dấu, tiếng Nhật, tiếng Trung hay emoji thì không. Với những văn bản đó, hãy dùng mb_substr(), được trình bày ở phía dưới.

Cú pháp

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

• $offset là vị trí bắt đầu. 0 là ký tự đầu tiên. Giá trị âm được đếm từ cuối chuỗi.
• $length là số byte cần lấy (trong văn bản ASCII thuần, một byte là một ký tự). Giá trị âm chừa lại chừng ấy ký tự ở cuối. null (hoặc bỏ trống) nghĩa là "đến hết chuỗi".

Offset và length âm: làm việc từ cuối chuỗi

$offset âm bắt đầu đếm từ cuối chuỗi, nên -1 là ký tự cuối cùng. $length âm dừng lại trước cuối chuỗi chừng ấy ký tự.

<?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) là cách thường dùng để xóa ký tự cuối cùng, ví dụ dấu phẩy thừa do vòng lặp để lại.

Lấy ký tự đầu tiên hoặc cuối cùng

Để lấy một byte, bạn cũng có thể truy cập chuỗi trực tiếp theo chỉ số. $s[0] là ký tự đầu tiên và, từ PHP 7.1, $s[-1] là ký tự cuối cùng.

<?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

Truy cập một vị trí không tồn tại sẽ in ra cảnh báo, còn substr() chỉ trả về chuỗi rỗng. Nếu chuỗi có thể rỗng, hãy ưu tiên substr().

Ngoài phạm vi: chuỗi rỗng, không phải false

Nếu $offset nằm sau cuối chuỗi, substr() trả về "" trong PHP 8. Trong PHP 7 hàm này trả về false, nên code cũ kiểm tra === false không còn chạy đúng nữa.

<?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

Văn bản tiếng Nhật: dùng mb_substr

UTF-8 lưu mỗi chữ kana và kanji thông dụng bằng 3 byte (kanji hiếm như 𠮷 và emoji chiếm 4 byte). substr() đếm byte, nên substr('こんにちは', 0, 3) chỉ trả về こ, và một độ dài không rơi đúng ranh giới ký tự sẽ cắt đôi ký tự, tạo ra văn bản bị lỗi. mb_substr() nhận cùng các đối số và đếm theo ký tự.

<?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'));

Điều này cũng đúng với emoji và chữ có dấu như é hay chữ tiếng Việt. Để đếm số ký tự, dùng mb_strlen(); xem strlen() để hiểu rõ byte và ký tự.

Rút gọn văn bản kèm dấu ba chấm

Cắt bớt một tiêu đề dài để hiển thị trong danh sách hoặc thẻ là cách dùng substr() phổ biến nhất trong thực tế. Dùng mb_substr() để tiêu đề tiếng Nhật hay tiếng Việt không bao giờ bị cắt giữa ký tự, và chỉ thêm ... khi bạn thật sự đã rút gọn.

<?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, '...') làm điều tương tự theo độ rộng hiển thị, trong đó một ký tự tiếng Nhật toàn khổ tính là 2 cột còn một chữ Latin tính là 1. Hàm này hợp với bố cục có độ rộng cố định.

Đếm chuỗi con với substr_count

substr_count($haystack, $needle) trả về số lần $needle xuất hiện. Hàm này phân biệt hoa thường và không đếm các kết quả khớp chồng lên nhau.

<?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";

Kết hợp substr với strpos: lấy văn bản trước hoặc sau một ký tự

Kết hợp substr() với strpos() để cắt tại một ký tự mà bạn không biết trước vị trí, ví dụ dấu @ trong địa chỉ email:

<?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";

Hãy kiểm tra strpos() không trả về false trước khi dùng kết quả: nếu không có ký tự đó, false được coi là 0 mà không có cảnh báo nào, nên substr('nobody', 0, $at) trả về "" còn substr('nobody', $at + 1) trả về "obody".