【PHP】よく使用する文字列メソッドまとめ(ユースケース別)

環境

• windows10
• DockerDesktop for Win 3.5.x
• PHP 8.x
• VsCode
• gitbash 2.32.0.1

一覧

文字列に特定の文字列が含まれるかチェックしたい。

概要

str_contains以外は、先頭に文字が存在する場合は0を返すので、比較の際は注意が必要。(例えば、(0 == true)はfalseになる。)

具体例

strpos

// 0から開始する
var_dump(strpos("豊臣秀吉", "秀")); // int(2)
var_dump(strpos("hoge", "HO")); // bool(false)

stripos

大文字小文字区別しない

var_dump(stripos("hoge", "HO")); // int(0)

mb_strpos、mb_striposはマルチバイト対応だけのため、割愛

str_contains

$str = "hogemaru";
var_dump(str_contains($str, "hoge")); // bool(true)

文字列を別の文字列で置換したい

概要

正規表現を使用した複雑な置換が不要であれば、preg_replaceではなく、str_replaceが推奨。

具体例

str_replace

$mixedの$searchと一致する文字列を$replaceに置き換える

$search = '*';
$mixed = 'c*o*m*p*o*s*e*r';
$replace = '';

var_dump(str_replace($search, $replace, $mixed));

preg_replace

str_replaceの正規表現版なので割愛

文字列から正規表現に一致する文字列のみを取り出したい

preg_match_allという関数もあるが、こちらは、正規表現にマッチしたのち、そのマッチした文字列の後から検索が続行される

具体例

preg_match

一致する文字列が存在するので、返り値には1が、$matchesには正規表現に一致したstring("leefe777")が返る

$string = "fjeife00000leefe777";

// 直前の文字が0以外の文字1回以上の連続のあとに、7が3回連続する文字列に一致する
$result = preg_match('/[^0]+[7]{3}/', $string, $matches);

var_dump($result); // int(1)
var_dump($matches[0]); // string("leefe777")

文字列を大文字から小文字に変換したい(またはその逆)

具体例

strtolower、strtoupperは割愛

mb_strtolower

$string = "AIUeO";
var_dump(mb_strtolower($string)); // string(5) "aiueo"

mb_strtoupper

$string = "AIUeO";
var_dump(mb_strtoupper($string)); // string(5) "AIUEO"

日本語文字列の「半角」-「全角」変換を行いたい

オプションの一覧はこちら

https://www.php.net/manual/ja/function.mb-convert-kana.php

mb_convert_kana("文字列", 'kna')

具体例

mb_convert_kana

$string = "ＡＢＣＤＥａｂｃｄｅｆｇｈｉｊ０１２３４ァアィイ";
var_dump(mb_convert_kana($string, 'kna')); // string(32) "ABCDEabcdefghij01234ｧｱｨｲ"

文字列を特定の文字列で分割して配列に変換したい

具体例

explode

$string = "PHP,Ruby,Java,Python";
var_dump(explode(",", $string));

array(4) {
  [0]=>
  string(3) "PHP"
  [1]=>
  string(4) "Ruby"
  [2]=>
  string(4) "Java"
  [3]=>
  string(6) "Python"
}

文字列のバイト数を取得したい

var_dump(strlen("PHP"));
var_dump(strlen(1));
var_dump(strlen("false"));
var_dump(strlen(0));
var_dump(strlen(null));
var_dump(strlen(false));
var_dump(strlen(""));

int(3)
int(1)
int(5)
int(1)
int(0)
int(0)
int(0)

※null, false, ""の扱いには注意(0が返る)

まとめ

いかがでしたでしょうか。本記事では、PHPにおける文字列メソッドまとめ(ユースケース別でよく使用するものについて紹介しています。開発を行う上で文字列の扱いを理解しておくことは必須と思いますので、ぜひ参考にしてみてください。