strpos() trong PHP: tìm vị trí của chuỗi con

strpos($haystack, $needle) trả về vị trí của $needle đầu tiên bên trong $haystack, đếm từ 0, hoặc false nếu không có. Luôn kiểm tra kết quả bằng !== false, vì kết quả khớp ở đầu chuỗi trả về 0.

<?php
$text = 'apple, banana, cherry';

var_dump(strpos($text, 'banana'));   // found at position 7
var_dump(strpos($text, 'apple'));    // found at position 0
var_dump(strpos($text, 'grape'));    // not found

if (strpos($text, 'apple') !== false) {
    echo "Found apple\n";
}

Nếu trên PHP 8 bạn chỉ cần câu trả lời có hoặc không, str_contains() rõ ràng hơn. Dùng strpos() khi vị trí là điều quan trọng.

Cú pháp

strpos(string $haystack, string $needle, int $offset = 0): int|false

Việc tìm kiếm có phân biệt hoa thường. $offset cho biết bắt đầu tìm từ đâu; offset âm được đếm từ cuối chuỗi.

Bẫy !== false

0 và false bằng nhau khi so sánh lỏng (==). Vì vậy, kết quả khớp ở vị trí 0 bị coi là "không tìm thấy" trong mọi phép kiểm tra không nghiêm ngặt.

<?php
$url = 'https://example.com';

// Wrong: position 0 is falsy, so this says "no"
if (strpos($url, 'https')) {
    echo "wrong check: has https\n";
} else {
    echo "wrong check: no https\n";
}

// Right: compare strictly with false
if (strpos($url, 'https') !== false) {
    echo "right check: has https\n";
}

Quy tắc này cũng áp dụng cho stripos(), strrpos() và array_search(), vì chúng đều có thể trả về 0 cho một kết quả khớp thật.

Tìm không phân biệt hoa thường với stripos

stripos() nhận cùng các đối số và bỏ qua chữ hoa, chữ thường của các chữ cái ASCII.

<?php
$title = 'Learning PHP the Hard Way';

var_dump(strpos($title, 'php'));    // case-sensitive: not found
var_dump(stripos($title, 'php'));   // found at 9

Tìm lần xuất hiện cuối cùng với strrpos

strrpos() trả về vị trí của kết quả khớp cuối cùng. Đây là cách chuẩn để lấy phần mở rộng của tệp hoặc đoạn cuối của một đường dẫn.

<?php
$file = 'archive.backup.tar.gz';

$dot = strrpos($file, '.');
echo substr($file, $dot + 1), "\n";      // gz
echo substr($file, 0, $dot), "\n";       // archive.backup.tar

$path = '/var/www/html/index.php';
echo substr($path, strrpos($path, '/') + 1), "\n";

Riêng với tên tệp, pathinfo($file, PATHINFO_EXTENSION) làm sẵn việc này cho bạn. Cách cắt chuỗi tại vị trí tìm được có ở trang substr().

Bắt đầu tìm từ một offset

Đối số thứ ba bỏ qua phần đầu của chuỗi. Offset âm bắt đầu tìm từ chừng ấy ký tự trước cuối chuỗi.

<?php
$s = 'one two one two';

var_dump(strpos($s, 'one'));        // 0
var_dump(strpos($s, 'one', 1));     // skip position 0: finds the second one
var_dump(strpos($s, 'two', -3));    // search only the last 3 characters

Tìm mọi lần xuất hiện

strpos() chỉ tìm một kết quả. Hãy dùng vòng lặp và dời offset qua từng kết quả để tìm tất cả:

<?php
$text = 'the cat sat on the mat with the hat';
$needle = 'the';

$positions = [];
$offset = 0;
while (($pos = strpos($text, $needle, $offset)) !== false) {
    $positions[] = $pos;
    $offset = $pos + strlen($needle);
}

print_r($positions);
echo count($positions), " matches\n";

Chỉ cần số lần xuất hiện? substr_count($text, 'the') ngắn gọn hơn. Với mẫu (pattern), preg_match_all() kèm PREG_OFFSET_CAPTURE trả về mọi kết quả khớp cùng vị trí của chúng.

Văn bản tiếng Nhật: vị trí theo byte và vị trí theo ký tự

strpos() tìm đúng văn bản nhiều byte, nhưng con số nó trả về tính theo byte. Mỗi chữ kana và kanji thông dụng chiếm 3 byte trong UTF-8, nên với văn bản toàn tiếng Nhật, vị trí theo byte gấp ba vị trí theo ký tự, còn với văn bản trộn lẫn (kể cả tiếng Việt có dấu) thì hai con số lệch nhau khó đoán hơn. mb_strpos() trả về vị trí theo ký tự, đúng thứ mà mb_substr() cần.

<?php
$s = '東京都渋谷区';

var_dump(strpos($s, '渋谷'));      // byte position
var_dump(mb_strpos($s, '渋谷'));   // character position

echo mb_substr($s, mb_strpos($s, '渋谷')), "\n";

Trộn hai loại là một bug kinh điển: truyền kết quả của strpos() cho mb_substr() sẽ bắt đầu quá xa trong chuỗi. Dùng strpos đi với substr, và mb_strpos đi với mb_substr.