PHP文字列関数一覧｜mb_substr・str_replaceなど文字列操作早見表

PHPの文字列関数とは、strlen（長さ）、substr（切り出し）、str_replace（置換）、explode（分割）のように、文字列を調べたり加工したりするための組み込み関数です。日本語を扱うときは、文字単位で数える mb_strlen や mb_substr などの mb_ 版を使います。

この記事では、文字列関数を「やりたいこと」別の一覧表にまとめ、すべての関数に PHP 8.4.21 で実行した結果を付けました。あわせて、substr で日本語が文字化けする様子、strpos の 0 と false の見分け方、PHP 8.0〜8.4 で加わった str_contains・mb_str_pad・mb_trim などの新しい関数、全角半角を変換する mb_convert_kana のオプション一覧も紹介します。

PHP文字列関数の早見表

まず、目的ごとの代表的な関数です。「mb_版」の列に関数名があるものは、日本語を扱うときにそちらを使います。

「mb_版が不要」と書いた関数は、UTF-8の日本語をそのまま渡しても正しく動きます（理由はあとの章で説明します）。

動作確認した環境

表の「結果」は、次の小さなコードで式と戻り値を並べて出力し、そのまま転記したものです。配列や真偽値は json_encode() の形（["a","b"]、true、false）で書いています。

<?php
function p(string $code): void
{
    $v = eval("return $code;");
    echo $code, ' => ', json_encode($v, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES), PHP_EOL;
}
p("mb_substr('こんにちは', 0, 2)");

mb_substr('こんにちは', 0, 2) => "こん"

日本語はmb_関数を使う理由

mb_ が付かない関数は、文字列をバイト単位で扱います。UTF-8では日本語1文字が3バイトなので、長さや位置がずれます。

echo strlen('こんにちは'), ' ', mb_strlen('こんにちは'), PHP_EOL;

echo substr('こんにちは', 0, 6), PHP_EOL;       // 6バイト = 2文字
echo substr('こんにちは', 0, 4), '|', PHP_EOL;   // 4バイト = 1文字と1/3
echo bin2hex(substr('こんにちは', 0, 4)), PHP_EOL;
var_dump(mb_check_encoding(substr('こんにちは', 0, 4), 'UTF-8'));

echo mb_substr('こんにちは', 0, 2), PHP_EOL;

15 5
こん
こ�|
e38193e3
bool(false)
こん

strlen('こんにちは') は 5 ではなく 15（バイト数）を返しました。substr で4バイトを切り出すと、2文字目の先頭1バイト（e3）だけが残り、表示は文字化けし、UTF-8として正しくない文字列になります。この文字列をデータベースに保存したり json_encode() に渡したりするとエラーの原因になるので、日本語の切り出しは mb_substr を使います。

同じことがほかの関数でも起こります。

mb_版がなくても日本語で使える関数

一方、str_replace、explode、implode、str_contains、str_starts_with、str_ends_with などは、バイト列として一致する部分を探すだけの関数です。UTF-8は「ある文字のバイト列が、別の文字の途中に現れない」作りになっているため、ソースもデータもUTF-8で統一されていれば、日本語をそのまま渡して正しく動きます。

長さを調べる関数

入力欄の「20文字以内」のような文字数チェックには mb_strlen を使います。 絵文字の 🍣 は strlen で 4、mb_strlen で 1 でした。

切り出す関数

一覧画面でタイトルを一定の幅に収めたいときは mb_strimwidth が便利です。 全角を2、半角を1として数えるので、見た目の幅がそろいます。

$title = 'PHPの文字列関数を学ぶ';
echo mb_strimwidth($title, 0, 12, '…'), PHP_EOL;

PHPの文字列…

検索する関数

strposの0とfalseの見分け方

strpos は、見つかった位置を整数で、見つからないときは false を返します。先頭で見つかったときの 0 は、if の条件では false と同じ扱いになるため、次のような結果になります。

$s = 'PHP入門';

// 直す前
if (strpos($s, 'PHP')) {
    echo 'A: 見つかった', PHP_EOL;
} else {
    echo 'A: 見つからない', PHP_EOL;
}

// 直した後（=== で false と比べる）
if (strpos($s, 'PHP') !== false) {
    echo 'B: 見つかった', PHP_EOL;
}

// PHP 8.0 以降は str_contains が使える
if (str_contains($s, 'PHP')) {
    echo 'C: 見つかった', PHP_EOL;
}

var_dump(strpos($s, 'PHP'), strpos($s, 'Java'), strpos($s, 'PHP') == false, strpos($s, 'PHP') === false);

A: 見つからない
B: 見つかった
C: 見つかった
int(0)
bool(false)
bool(true)
bool(false)

'PHP入門' は PHP で始まっているのに、Aでは「見つからない」と表示されました。0 == false は true ですが、0 === false は false です。

「含むかどうか」だけを知りたいときは str_contains、位置が必要なときだけ strpos と !== false、と使い分けましょう。

置換する関数

引数の順番は str_replace(探す文字列, 置き換える文字列, 対象) です。対象が最後に来ます。

str_replaceとstrtrの違い

配列で複数の置換を指定したとき、str_replace は前から順番に置換を行います。そのため、1つ目の置換結果が2つ目の置換の対象になります。

echo str_replace(['a', 'b'], ['b', 'c'], 'ab'), PHP_EOL;
echo strtr('ab', ['a' => 'b', 'b' => 'c']), PHP_EOL;

cc
bc

str_replace では a → b に変わったあと、その b も c に変わって cc になりました。strtr は元の文字列を1回だけ走査するので、置換後の文字が再び置換されることはありません。 「AとBを入れ替える」ような置換では strtr が向いています。

分割・結合する関数

explode(',', '') は空の配列ではなく [""]（要素数1）を返します。 入力が空のときに要素数を0にしたい場合は、先に空文字列かどうかを確かめます。

$tags = $input === '' ? [] : explode(',', $input);

CSVの1行を分けたあと、各要素の前後の空白を除く定番の形です。

print_r(array_map('trim', explode(',', 'a , b ,c')));

Array
(
    [0] => a
    [1] => b
    [2] => c
)

整形する関数（trim・pad・repeat）

全角スペースを除く

フォームの入力では、前後に全角スペースが入ることがよくあります。PHP 8.4 では mb_trim で全角スペースもまとめて除けます。

var_dump(trim('　全角　'));
var_dump(mb_trim('　全角　'));

string(12) "　全角　"
string(6) "全角"

PHP 8.3 以前の環境では、正規表現で同じ結果が得られます（u はUTF-8として扱う指定です）。

var_dump(preg_replace('/\A[\s　]+|[\s　]+\z/u', '', "　全角 \n"));

string(6) "全角"

大文字・小文字を変える関数

スネークケースとキャメルケースの変換は、これらを組み合わせて書けます。

echo lcfirst(str_replace('_', '', ucwords('user_name_id', '_'))), PHP_EOL;
echo strtolower(preg_replace('/(?<!^)[A-Z]/', '_$0', 'userNameId')), PHP_EOL;

userNameId
user_name_id

PHP 8.0〜8.4で加わった文字列関数

新しい版で加わった関数をまとめます。以前は数行で書いていた処理が、1つの関数で書けるようになっています。

いずれも今回の PHP 8.4.21 で動作を確認しました（function_exists('mb_trim') と function_exists('mb_str_pad') はどちらも true）。運用中のPHPの版が分からないときは、php -v か echo PHP_VERSION; で確認してから使いましょう。

全角・半角を変換するmb_convert_kana

mb_convert_kana(文字列, オプション) は、全角と半角、ひらがなとカタカナを変換します。オプションの英字は小文字が「半角へ」、大文字が「全角へ」と覚えると整理しやすくなります。

半角カタカナを全角にするときは、K だけでなく KV と書くのがポイントです。K だけだと「ガ」が「カ」と「゛」の2文字に分かれました。

フォームの入力をそろえるときによく使う組み合わせは asKV（英数字とスペースは半角へ、カタカナは全角へ）です。

echo mb_convert_kana('ＡＢＣ　１２３　ｱｲｳ', 'asKV'), PHP_EOL;

ABC 123 アイウ

型や形式を変換する関数

is_numeric は '1e5' や前後に空白のある '12 ' も true と判定しました。「数字だけ」を確かめたい入力（数量や郵便番号など）には ctype_digit や正規表現 /\A\d+\z/ が向いています。

htmlspecialcharsで画面に出す文字列をエスケープする

利用者が入力した文字列をHTMLに表示するときは、htmlspecialchars で特別な意味を持つ文字を置き換えます。

echo htmlspecialchars('<a href="x">T&J\'s</a>'), PHP_EOL;
echo htmlspecialchars("<script>alert('x')</script>"), PHP_EOL;
echo nl2br(htmlspecialchars("<b>\n改行")), PHP_EOL;

<a href="x">T&J's</a>
<script>alert('x')</script>
&lt;b&gt;<br />
改行

PHP 8.4 では、フラグを省略してもシングルクォートまで変換されました。改行を <br> にしたいときは、htmlspecialchars を先に、nl2br を後に適用します。順番を逆にすると <br /> までエスケープされて文字として表示されます。毎回書くのが長い場合は、短い関数にまとめておくと便利です。

function h(?string $s): string
{
    return htmlspecialchars($s ?? '', ENT_QUOTES, 'UTF-8');
}

比較する関数

文字列どうしの比較は === を使うと、'10' と '1e1' が等しいと判定されるような意図しない結果を避けられます。ファイル名の img2、img12 を人が見て自然な順に並べたいときは、strnatcmp や natsort() が使えます。

書式を整える関数（sprintf・number_format）

sprintfの書式一覧

sprintf(書式, 値...) は、% で始まる指定子の位置に値を埋め込んだ文字列を返します。画面に直接出すときは printf を使います。

%5s などの幅指定はバイト数で数えられるため、日本語では桁がそろいません（sprintf('[%5s]', '日本') は [日本]）。日本語の桁ぞろえには mb_str_pad を使います。

number_formatで3桁区切りにする

number_format の戻り値は文字列です。カンマが入った文字列を計算に使うと数値として読めないため、計算は数値のまま行い、表示の直前に number_format を適用します。

変数を文字列に埋め込む

$name = 'PHP';
$v = 8.4;
echo "ver: {$name} {$v}\n";
echo 'ver: {$name}\n', "\n";

ver: PHP 8.4
ver: {$name}\n

ダブルクォートの中では変数と \n が展開され、シングルクォートの中ではそのままの文字として扱われます。

正規表現を使う関数（preg_）の概要

決まった文字列ではなく「数字が続く部分」「空白が1つ以上」のようなパターンで探すときは、preg_ で始まる関数を使います。ここでは代表的な使い方だけを紹介します。

日本語を含む文字列では、パターンの末尾に u を付けるとUTF-8の1文字を1文字として扱えます。

固定の文字列を探す・置き換えるだけなら、str_contains や str_replace のほうが短く書けて読みやすくなります。

よくある質問

Q. substr と mb_substr はどう使い分けますか？ A. 日本語など英数字以外を含む可能性がある文字列は mb_substr を使います。substr はバイト単位で切るため、UTF-8の日本語（1文字3バイト）を途中で切ると文字化けします。英数字だけと分かっている文字列（ID、日付の 2026-10-02 など）は substr で問題ありません。

Q. strpos で見つかっているのに if が偽になるのはなぜですか？ A. 先頭（位置 0）で見つかっており、0 が偽として扱われているためです。strpos($s, $x) !== false と書くか、PHP 8.0 以降なら str_contains($s, $x) を使います。

Q. 文字列を連結するにはどう書きますか？ A. .（ドット）でつなぎます。$a . $b で連結、$a .= $b で末尾に追加です。配列の要素をつなぐときは implode を使います。

Q. 文字数を数えるとき、絵文字はどうなりますか？ A. mb_strlen('🍣') は 1 を返します。ただし、複数の絵文字を組み合わせた家族の絵文字（👨‍👩‍👧）は mb_strlen で 5、intl拡張の grapheme_strlen で 1 でした。見た目の1文字として数えたいときは grapheme_strlen を使います。

まとめ

• 日本語の長さ・切り出し・位置は mb_strlen・mb_substr・mb_strpos を使う。strlen('こんにちは') は 15（バイト数）になる
• 探す・置き換える・区切るだけの str_replace・explode・str_contains は、UTF-8ならそのまま日本語で使える
• strpos は先頭で見つかると 0 を返す。判定は !== false か、PHP 8.0 以降の str_contains で書く
• PHP 8.0 で str_contains・str_starts_with・str_ends_with、8.3 で mb_str_pad、8.4 で mb_trim・mb_ucfirst が加わった
• 全角半角の変換は mb_convert_kana。半角カタカナを全角にするときは KV、入力の統一には asKV
• 画面に出す文字列は htmlspecialchars、数値の表示は number_format、桁ぞろえは sprintf と mb_str_pad
• 文字列の比較は ===。並べ替えには strcmp・strnatcmp・<=> を使う

株式会社RJCでは、文字列操作のような基礎を仲間と学び合っています。こうした知識を共有しながら、日々技術を磨いています。

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。