PHP文字列操作 チートシート

文字列のバイト数または文字数を取得します。

コード例:

<?php
$string_ascii = 'hello';
$string_jp = 'こんにちは';

// strlen: バイト数を返す
echo strlen($string_ascii); // 出力: 5
echo "\n";
echo strlen($string_jp);    // 出力: 15 (UTF-8の場合、1文字3バイト * 5文字)
echo "\n";

// mb_strlen: 文字数を返す
echo mb_strlen($string_ascii, 'UTF-8'); // 出力: 5
echo "\n";
echo mb_strlen($string_jp, 'UTF-8');    // 出力: 5
?>

文字列内から特定の文字列やパターンを検索します。

特定の文字列の検索

コード例 (strpos / mb_strpos):

<?php
$haystack = 'これはPHPのテストです。phpは良い言語です。';
$needle_jp = 'テスト';
$needle_en = 'php';

// strpos (バイト単位、大文字小文字区別) - マルチバイト文字には不向き
$pos1 = strpos($haystack, $needle_jp); // 正しく動作しない可能性がある
$pos2 = strpos($haystack, $needle_en);
if ($pos2 !== false) {
    echo "'php'が見つかったバイト位置: " . $pos2 . "\n"; // 出力例: 'php'が見つかったバイト位置: 33 (UTF-8の場合)
}

// mb_strpos (文字単位、大文字小文字区別)
$pos3 = mb_strpos($haystack, $needle_jp, 0, 'UTF-8');
if ($pos3 !== false) {
    echo "'テスト'が見つかった文字位置: " . $pos3 . "\n"; // 出力: 'テスト'が見つかった文字位置: 5
}

// mb_stripos (文字単位、大文字小文字無視)
$pos4 = mb_stripos($haystack, $needle_en, 0, 'UTF-8');
if ($pos4 !== false) {
    echo "'php'(大文字小文字無視)が最初に見つかった文字位置: " . $pos4 . "\n"; // 出力: 'php'(大文字小文字無視)が最初に見つかった文字位置: 3
}

// PHP 8+
if (function_exists('str_contains')) {
    echo "str_contains('テスト'): " . (str_contains($haystack, 'テスト') ? 'はい' : 'いいえ') . "\n"; // マルチバイト非対応のため注意
    echo "mb_strposを使用: " . (mb_strpos($haystack, 'テスト') !== false ? 'はい' : 'いいえ') . "\n"; // 推奨
    echo "str_starts_with('これ'): " . (str_starts_with($haystack, 'これ') ? 'はい' : 'いいえ') . "\n"; // マルチバイト非対応のため注意
    echo "mb_substrを使用: " . (mb_substr($haystack, 0, 2) === 'これ' ? 'はい' : 'いいえ') . "\n"; // 推奨
}
?>

正規表現による検索

コード例 (preg_match / preg_match_all):

<?php
$text = '電話番号は 012-3456-7890 と 090-1111-2222 です。メールは test@example.com です。';
$pattern_tel = '/\d{2,4}-\d{4}-\d{4}/'; // 電話番号のパターン
$pattern_email = '/[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/'; // Emailのパターン

// preg_match: 最初に見つかった電話番号
if (preg_match($pattern_tel, $text, $matches)) {
    echo "最初に見つかった電話番号: " . $matches[0] . "\n"; // 出力: 最初に見つかった電話番号: 012-3456-7890
}

// preg_match_all: 全ての電話番号
if (preg_match_all($pattern_tel, $text, $matches_all)) {
    echo "見つかった全ての電話番号: " . implode(', ', $matches_all[0]) . "\n"; // 出力: 見つかった全ての電話番号: 012-3456-7890, 090-1111-2222
}

// preg_match: Email
if (preg_match($pattern_email, $text, $email_match)) {
    echo "見つかったEmail: " . $email_match[0] . "\n"; // 出力: 見つかったEmail: test@example.com
}

// マルチバイト文字を含む検索 (u修飾子)
$text_jp = '今日は良い天気ですね。明日はどうかな？';
$pattern_jp = '/天気/u'; // 'u'修飾子でUTF-8として処理
if (preg_match($pattern_jp, $text_jp, $matches_jp)) {
    echo "'天気' が見つかりました。\n"; // 出力: '天気' が見つかりました。
}
?>

文字列内の一部を別の文字列やパターンで置換します。

特定の文字列の置換

コード例 (str_replace):

<?php
$text = "I like apples. Apples are tasty.";
$search = "apples";
$replace = "oranges";

// 大文字小文字を区別して置換
$new_text1 = str_replace($search, $replace, $text);
echo $new_text1 . "\n"; // 出力: I like oranges. Apples are tasty. (最初の'apples'のみ置換)

// 大文字小文字を区別せずに置換
$new_text2 = str_ireplace($search, $replace, $text);
echo $new_text2 . "\n"; // 出力: I like oranges. oranges are tasty. ('apples'と'Apples'の両方が置換)

// 配列を使用した複数置換
$text_multi = "今日の天気は晴れ。気温は25度。";
$search_multi = ["晴れ", "25度"];
$replace_multi = ["曇り", "20度"];
$new_text_multi = str_replace($search_multi, $replace_multi, $text_multi);
echo $new_text_multi . "\n"; // 出力: 今日の天気は曇り。気温は20度。 (※マルチバイト文字の場合は注意)

// substr_replace: 位置指定での置換
$original = "abcdefgh";
$replacement = "XYZ";
$new_substr = substr_replace($original, $replacement, 3, 2); // 3バイト目から2バイト分を'XYZ'に置換
echo $new_substr . "\n"; // 出力: abcXYZfgh
?>

正規表現による置換

コード例 (preg_replace / preg_replace_callback):

<?php
$text = 'これは [商品A] です。価格は [PRICE] 円。';
$pattern = '/\[([A-Z]+)\]/'; // [大文字] のパターン

// preg_replace: パターンにマッチした部分を置換
$replacement = '***';
$new_text1 = preg_replace($pattern, $replacement, $text);
echo $new_text1 . "\n"; // 出力: これは *** です。価格は *** 円。

// preg_replace: 後方参照を使った置換
$replacement_ref = '($1)'; // $1には()でキャプチャした部分が入る
$new_text2 = preg_replace($pattern, $replacement_ref, $text);
echo $new_text2 . "\n"; // 出力: これは (商品A) です。価格は (PRICE) 円。

// preg_replace_callback: コールバック関数で置換内容を決定
$data = ['商品A' => 'すごい商品', 'PRICE' => 1000];
$new_text3 = preg_replace_callback(
    $pattern,
    function ($matches) use ($data) {
        $key = $matches[1]; // マッチした括弧の中身 (商品A, PRICE)
        return isset($data[$key]) ? $data[$key] : $matches[0]; // dataにあれば置換、なければ元のまま
    },
    $text
);
echo $new_text3 . "\n"; // 出力: これは すごい商品 です。価格は 1000 円。

// マルチバイト文字列の置換 (u修飾子)
$text_jp = '今日は【晴れ】です。明日は【曇り】の予報。';
$pattern_jp = '/【(.*?)】/u'; // 【】で囲まれた部分 (u修飾子必須)
$new_text_jp = preg_replace($pattern_jp, '「$1」', $text_jp);
echo $new_text_jp . "\n"; // 出力: 今日は「晴れ」です。明日は「曇り」の予報。
?>

文字列を指定した区切り文字で配列に分割したり、配列要素を文字列に結合したりします。

コード例:

<?php
// explode / implode
$csv_string = "apple,banana,orange";
$fruits_array = explode(',', $csv_string);
print_r($fruits_array);
// 出力: Array ( [0] => apple [1] => banana [2] => orange )
echo "\n";

$joined_string = implode(' | ', $fruits_array);
echo $joined_string . "\n"; // 出力: apple | banana | orange

// str_split (マルチバイト非対応)
$text_ascii = "Hello";
$chars_ascii = str_split($text_ascii);
print_r($chars_ascii);
// 出力: Array ( [0] => H [1] => e [2] => l [3] => l [4] => o )
echo "\n";

$text_jp = "日本語"; // UTF-8: 9バイト
$chars_jp_broken = str_split($text_jp); // 1バイトずつ分割され文字化け
// print_r($chars_jp_broken); // 意図しない結果になる

// mb_str_split (PHP 7.4+) (マルチバイト対応)
if (function_exists('mb_str_split')) {
    $chars_jp_correct = mb_str_split($text_jp); // デフォルトは1文字ずつ
    print_r($chars_jp_correct);
    // 出力: Array ( [0] => 日 [1] => 本 [2] => 語 )
    echo "\n";
} else {
     // PHP 7.4未満の場合の代替 (preg_splitを使用)
     $chars_jp_correct_alt = preg_split('//u', $text_jp, -1, PREG_SPLIT_NO_EMPTY);
     print_r($chars_jp_correct_alt);
    // 出力: Array ( [0] => 日 [1] => 本 [2] => 語 )
     echo "\n";
}


// preg_split (正規表現で分割)
$text_complex = "item1, item2; item3 item4";
$items = preg_split('/[,;\s]+/', $text_complex); // カンマ、セミコロン、空白文字で分割
print_r($items);
// 出力: Array ( [0] => item1 [1] => item2 [2] => item3 [3] => item4 )
echo "\n";

// preg_split (マルチバイト対応)
$text_jp_split = "単語１、単語２　単語３"; // 全角カンマ、全角スペース
$words_jp = preg_split('/[、\s　]+/u', $text_jp_split); // u修飾子が必要
print_r($words_jp);
// 出力: Array ( [0] => 単語１ [1] => 単語２ [2] => 単語３ )

?>

二つの文字列を比較します。

コード例:

<?php
$str1 = "apple";
$str2 = "Apple";
$str3 = "banana";

// strcmp (大文字小文字区別)
echo strcmp($str1, $str1); // 出力: 0 (等しい)
echo "\n";
echo strcmp($str1, $str2); // 出力: > 0 ('a' > 'A') - 環境依存の可能性あり、通常は正の値
echo "\n";
echo strcmp($str1, $str3); // 出力: < 0 ('a' < 'b') - 通常は負の値
echo "\n";

// strcasecmp (大文字小文字無視)
echo strcasecmp($str1, $str2); // 出力: 0 (等しい)
echo "\n";

// strncmp (最初の3バイトを比較)
echo strncmp("apple", "apply", 3); // 出力: 0 ("app" == "app")
echo "\n";
echo strncmp("apple", "apricot", 3); // 出力: < 0 ('p' < 'r') - 通常は負の値
echo "\n";

// similar_text
$similar_chars = similar_text("apple", "apply", $percent);
echo "類似文字数: " . $similar_chars; // 出力例: 類似文字数: 4
echo ", 類似度: " . round($percent, 2) . "%\n"; // 出力例: , 類似度: 80%

// levenshtein
echo levenshtein("apple", "apply"); // 出力: 1 (e -> y の置換1回)
echo "\n";
echo levenshtein("banana", "bandana"); // 出力: 1 (挿入/削除1回)
echo "\n";
echo levenshtein("kitten", "sitting"); // 出力: 3 (k->s, e->i, +g の3回)
echo "\n";

// Note: strcmp系の関数はマルチバイト非対応。日本語比較には通常 == や === を使うか、
// ロケール依存の比較が必要なら strcoll() を setlocale() と共に使う。
setlocale(LC_COLLATE, 'ja_JP.UTF-8'); // ロケール設定 (環境により設定値は異なる)
$jp1 = "あいう";
$jp2 = "アイウ";
echo strcmp($jp1, $jp2); // バイト比較なので 0 以外になる
echo "\n";
echo strcoll($jp1, $jp2); // ロケールによっては 0 になる場合も、ならない場合もある
echo "\n";

?>

文字列から一部分を抽出したり、先頭や末尾の不要な文字を削除したりします。

コード例:

<?php
$text = "abcdefghij";
$text_jp = "あいうえおかきくけこ"; // UTF-8

// substr (バイト単位)
echo substr($text, 2, 5); // 2バイト目から5バイト分 -> cdefg
echo "\n";
echo substr($text, -3, 2); // 後ろから3バイト目から2バイト分 -> hi
echo "\n";
// echo substr($text_jp, 1, 3); // マルチバイト文字では文字化けする

// mb_substr (文字単位)
echo mb_substr($text_jp, 2, 5, 'UTF-8'); // 2文字目から5文字分 -> うえおかき
echo "\n";
echo mb_substr($text_jp, -3, 2, 'UTF-8'); // 後ろから3文字目から2文字分 -> くけ
echo "\n";

// trim, ltrim, rtrim
$padded_string = "  \t Hello World! \n\r ";
echo "Original: [" . $padded_string . "]\n";
echo "trim():   [" . trim($padded_string) . "]\n"; // 先頭末尾の空白除去 -> [Hello World!]
echo "ltrim():  [" . ltrim($padded_string) . "]\n"; // 先頭の空白除去 -> [Hello World! \n\r ]
echo "rtrim():  [" . rtrim($padded_string) . "]\n"; // 末尾の空白除去 -> [  \t Hello World!]

// 指定文字のトリム
$path = "/path/to/file/";
echo "rtrim('/'): [" . rtrim($path, '/') . "]\n"; // 末尾のスラッシュのみ除去 -> [/path/to/file]
$custom_chars = ".,;";
$text_chars = ",.Hello;.";
echo "trim(',.;'): [" . trim($text_chars, $custom_chars) . "]\n"; // 先頭末尾の指定文字除去 -> [Hello]

// マルチバイト空白のトリム (通常の trim は全角スペースに対応しない)
$jp_space = "　全角スペース　"; // 全角スペース
echo "trim(): [" . trim($jp_space) . "]\n"; // 全角スペースは除去されない
// 全角スペースも除去する例 (preg_replace を使用)
$trimmed_jp_space = preg_replace('/^[\\s　]+|[\\s　]+$/u', '', $jp_space);
echo "preg_replace: [" . $trimmed_jp_space . "]\n"; // -> [全角スペース]

?>

文字列のアルファベットの大文字・小文字を変換します。

コード例:

<?php
$text = "hELLo wORLd!";
$text_jp = "ＡＢＣ ｘｙｚ"; // 全角アルファベット

// 基本的なケース変換
echo strtolower($text) . "\n"; // 出力: hello world!
echo strtoupper($text) . "\n"; // 出力: HELLO WORLD!
echo ucfirst("hello") . "\n"; // 出力: Hello
echo lcfirst("HELLO") . "\n"; // 出力: hELLO
echo ucwords("hello world again") . "\n"; // 出力: Hello World Again

// マルチバイト対応のケース変換
echo mb_strtolower($text_jp, 'UTF-8') . "\n"; // 出力: ａｂｃ ｘｙｚ
echo mb_strtoupper($text_jp, 'UTF-8') . "\n"; // 出力: ＡＢＣ ＸＹＺ

// mb_convert_case
echo mb_convert_case($text, MB_CASE_UPPER, "UTF-8") . "\n"; // 出力: HELLO WORLD!
echo mb_convert_case($text, MB_CASE_LOWER, "UTF-8") . "\n"; // 出力: hello world!
echo mb_convert_case("hello world", MB_CASE_TITLE, "UTF-8") . "\n"; // 出力: Hello World
echo mb_convert_case($text_jp, MB_CASE_LOWER, "UTF-8") . "\n"; // 出力: ａｂｃ ｘｙｚ

// mb_convert_case で全角/半角変換 (参考)
$text_zen = "ＡＢＣ１２３";
$text_han = "abc456";
echo mb_convert_kana($text_zen, "a", "UTF-8") . "\n"; // 全角英数を半角に -> ABC123
echo mb_convert_kana($text_han, "A", "UTF-8") . "\n"; // 半角英数を全角に -> ａｂｃ４５６

?>

数値をフォーマットしたり、文字列を指定した形式に整形したりします。

コード例:

<?php
// sprintf / printf
$name = "Alice";
$age = 30;
$price = 19.99;
$formatted_string = sprintf("名前: %s, 年齢: %d歳, 価格: %.2fドル", $name, $age, $price);
echo $formatted_string . "\n"; // 出力: 名前: Alice, 年齢: 30歳, 価格: 19.99ドル

printf("商品コード: %06d\n", 123); // 出力: 商品コード: 000123

// vsprintf (配列で引数を渡す)
$args = ["Bob", 25, 9.50];
$formatted_vsprintf = vsprintf("名前: %s, 年齢: %d歳, 価格: %.2fドル", $args);
echo $formatted_vsprintf . "\n"; // 出力: 名前: Bob, 年齢: 25歳, 価格: 9.50ドル

// number_format
$number = 1234567.8912;
echo number_format($number) . "\n"; // 出力: 1,234,568 (デフォルト: 整数、カンマ区切り)
echo number_format($number, 2) . "\n"; // 出力: 1,234,567.89 (小数点以下2桁)
echo number_format($number, 2, ',', '.') . "\n"; // 出力: 1.234.567,89 (小数点',' 桁区切り'.')

// nl2br
$text_with_newlines = "一行目。\n二行目。\r\n三行目。";
echo nl2br($text_with_newlines) . "\n";
/* 出力:
一行目。

二行目。

三行目。
*/

// wordwrap (マルチバイト非対応)
$long_text = "This is a very long string that needs to be wrapped to fit within a certain width.";
echo wordwrap($long_text, 20, "<br />\n") . "\n";
/* 出力例:
This is a very long

string that needs to

be wrapped to fit

within a certain

width.
*/

// chunk_split (マルチバイト非対応)
$data = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
echo chunk_split($data, 5, '-') . "\n"; // 出力: ABCDE-FGHIJ-KLMNO-PQRST-UVWXY-Z-

?>

HTMLとして特別な意味を持つ文字を安全な形式（HTMLエンティティ）に変換したり、元に戻したりします。また、HTMLタグを除去します。

コード例:

<?php
$html_input = '<script>alert("XSS"); 
Hello & World
';
$text_input = "C'est l'été. Ça coûte cher."; // フランス語など

// htmlspecialchars (XSS対策の基本)
$escaped_html = htmlspecialchars($html_input, ENT_QUOTES, 'UTF-8');
echo "htmlspecialchars(): " . $escaped_html . "\n";
// 出力例: htmlspecialchars(): <script>alert("XSS");</script> <p style="color:red;">Hello & World</p>

// htmlentities (より多くの文字を変換)
$escaped_entities = htmlentities($text_input, ENT_QUOTES | ENT_HTML5, 'UTF-8');
echo "htmlentities(): " . $escaped_entities . "\n";
// 出力例: htmlentities(): C'est l'été. Ça coûte cher.

// デコード
$decoded_special = htmlspecialchars_decode($escaped_html, ENT_QUOTES);
echo "htmlspecialchars_decode(): " . $decoded_special . "\n";
// 出力例: htmlspecialchars_decode(): <script>alert("XSS"); 
Hello & World

$decoded_entities = html_entity_decode($escaped_entities, ENT_QUOTES | ENT_HTML5, 'UTF-8');
echo "html_entity_decode(): " . $decoded_entities . "\n";
// 出力例: html_entity_decode(): C'est l'été. Ça coûte cher.

// strip_tags (タグ除去)
$stripped_text = strip_tags($html_input);
echo "strip_tags(): " . $stripped_text . "\n";
// 出力例: strip_tags(): alert("XSS"); Hello & World

// strip_tags (特定のタグを許可)
$stripped_allow_p = strip_tags($html_input, '
');
echo "strip_tags('
'): " . $stripped_allow_p . "\n";
// 出力例: strip_tags('
'): alert("XSS"); 
Hello & World

?>

マルチバイト文字列（日本語など）を扱う上で重要な設定関数や、その他の関連関数です。

コード例:

<?php
// 基本設定 (スクリプトの先頭で行うのが一般的)
mb_internal_encoding('UTF-8');
mb_language('Japanese');
// mb_http_output('UTF-8'); // php.iniでの設定が推奨されることが多い

// エンコーディング変換
$sjis_string = mb_convert_encoding("これはShift_JISの文字列です。", "SJIS-win", "UTF-8");
// echo $sjis_string; // このままUTF-8環境で出力すると文字化けする

$utf8_string = mb_convert_encoding($sjis_string, "UTF-8", "SJIS-win");
echo "変換後 (UTF-8): " . $utf8_string . "\n"; // 出力: 変換後 (UTF-8): これはShift_JISの文字列です。

// エンコーディング検出 (精度に注意)
$detected_encoding = mb_detect_encoding($utf8_string, "UTF-8, SJIS-win, EUC-JP", true); // 厳密モード
echo "検出されたエンコーディング: " . $detected_encoding . "\n"; // 出力: 検出されたエンコーディング: UTF-8

// エンコーディングチェック
if (mb_check_encoding($utf8_string, "UTF-8")) {
    echo "文字列は有効なUTF-8です。\n";
} else {
    echo "文字列は有効なUTF-8ではありません。\n";
}

// 全角/半角 カナ/英数 変換
$text = "ﾃｽﾄ test １２３"; // 半角カナ、半角英数、全角数字
// 半角カナ -> 全角カナ ('K'), 全角数字 -> 半角数字 ('n')
$converted_kana = mb_convert_kana($text, "Kn", "UTF-8");
echo "mb_convert_kana('Kn'): " . $converted_kana . "\n"; // 出力: mb_convert_kana('Kn'): テスト test 123

// 全角英数 -> 半角英数 ('a'), 半角スペース -> 全角スペース ('S')
$text2 = "ＡＢＣ　ＤＥＦ";
$converted_alpha_space = mb_convert_kana($text2, "aS", "UTF-8");
echo "mb_convert_kana('aS'): " . $converted_alpha_space . "\n"; // 出力: mb_convert_kana('aS'): ABC　DEF (スペースは全角のまま)
// 全角英数 -> 半角英数 ('a'), 全角スペース -> 半角スペース ('s')
$converted_alpha_space2 = mb_convert_kana($text2, "as", "UTF-8");
echo "mb_convert_kana('as'): " . $converted_alpha_space2 . "\n"; // 出力: mb_convert_kana('as'): ABC DEF (スペースも半角に)

?>