PHP substr(): Cara Mengambil Sebagian Teks dari String

substr($string, $offset, $length) mengembalikan bagian dari $string yang dimulai di posisi $offset (dihitung dari 0) dan panjangnya $length karakter. substr('Hello world', 0, 5) mengembalikan "Hello". Kalau $length tidak ditulis, kamu mendapat semuanya sampai akhir.

<?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() menghitung byte. Untuk teks bahasa Inggris, byte sama dengan karakter, tetapi tidak untuk teks Jepang, Tionghoa, emoji, atau huruf beraksen. Untuk itu, pakai mb_substr(), yang dibahas di bawah.

Sintaks

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

• $offset adalah posisi awal. 0 adalah karakter pertama. Nilai negatif dihitung dari akhir.
• $length adalah jumlah byte yang diambil (satu byte sama dengan satu karakter di teks ASCII biasa). Nilai negatif membuang sejumlah itu dari akhir. null (atau tidak ditulis) berarti "sampai akhir".

Offset dan length negatif: bekerja dari akhir

$offset negatif mulai menghitung dari akhir string, jadi -1 adalah karakter terakhir. $length negatif berhenti sejumlah karakter itu sebelum akhir.

<?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) adalah cara yang biasa dipakai untuk menghapus karakter terakhir, misalnya koma di akhir yang tersisa dari sebuah loop.

Mengambil karakter pertama atau terakhir

Untuk satu byte, kamu juga bisa langsung mengakses string dengan index. $s[0] adalah karakter pertama, dan sejak PHP 7.1, $s[-1] adalah karakter terakhir.

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

Mengakses index pada posisi yang tidak ada akan mencetak warning, sedangkan substr() hanya mengembalikan string kosong. Kalau string-nya mungkin kosong, lebih baik pakai substr().

Di luar jangkauan: string kosong, bukan false

Kalau $offset melewati akhir string, substr() mengembalikan "" di PHP 8. Di PHP 7, fungsi ini mengembalikan false, jadi kode lama yang memeriksa === false tidak lagi bekerja.

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

Teks Jepang: pakai mb_substr

UTF-8 menyimpan kana dan kanji umum masing-masing dalam 3 byte (kanji langka seperti 𠮷 dan emoji memakai 4). substr() menghitung byte, jadi substr('こんにちは', 0, 3) hanya mengembalikan こ, dan length yang tidak jatuh tepat di batas karakter akan memotong karakter menjadi dua dan menghasilkan teks yang rusak. mb_substr() menerima argumen yang sama dan menghitung karakter.

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

Hal yang sama berlaku untuk emoji dan huruf beraksen seperti é. Jumlah karakter dihitung dengan mb_strlen(); lihat strlen() untuk perbedaan byte dan karakter.

Memendekkan teks dengan elipsis

Memotong judul yang panjang untuk sebuah list atau card adalah pemakaian substr() yang paling umum di dunia nyata. Pakai mb_substr() supaya judul berbahasa Jepang tidak pernah terpotong di tengah karakter, dan tambahkan ... hanya kalau teksnya memang dipendekkan.

<?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, '...') melakukan hal yang sama berdasarkan lebar tampilan, ketika satu karakter Jepang lebar penuh dihitung 2 kolom dan huruf Latin dihitung 1. Fungsi ini cocok untuk tata letak dengan lebar tetap.

Menghitung substring dengan substr_count

substr_count($haystack, $needle) mengembalikan berapa kali $needle muncul. Fungsi ini peka huruf besar kecil dan tidak menghitung kecocokan yang saling tumpang tindih.

<?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 dengan strpos: teks sebelum atau sesudah sebuah karakter

Gabungkan substr() dengan strpos() untuk memotong di karakter yang posisinya belum kamu ketahui sebelumnya, seperti @ di alamat 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";

Periksa bahwa strpos() tidak mengembalikan false sebelum memakai hasilnya: kalau karakternya tidak ada, false dianggap 0 tanpa warning, sehingga substr('nobody', 0, $at) mengembalikan "" dan substr('nobody', $at + 1) mengembalikan "obody".