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()はバイトを数えます。英語のテキストなら文字数と同じですが、日本語、中国語、絵文字、アクセント付きの文字では違います。それらには、下で紹介するmb_substr()を使います。

構文

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

• $offsetは開始位置です。0が最初の文字で、負の値は末尾から数えます。
• $lengthは取り出すバイト数です（ASCIIだけのテキストなら1バイトが1文字）。負の値は末尾からその数だけ残します。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)は、ループで残った末尾のカンマなど、最後の文字を取り除く定番の方法です。

最初や最後の文字を取得する

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では、かなとよく使う漢字は1文字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"を返してしまいます。