substr() ב-PHP: חיתוך חלק ממחרוזת

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() סופרת בתים. זה זהה לתווים בטקסט באנגלית, אבל לא ביפנית, בסינית, באימוג'י או באותיות עם סימנים דיאקריטיים. עבורם השתמשו ב-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 נמצא אחרי סוף המחרוזת, substr() מחזירה "" ב-PHP 8. ב-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 בתים כל אחד (קאנג'י נדירים כמו 𠮷 ואימוג'י תופסים 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'));

אותו הדבר חל על אימוג'י ועל אותיות עם סימנים דיאקריטיים כמו é. ספירת תווים נעשית עם 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".