PHPでstrcmpを使ったときに「思ったように一致しない」ケースは意外と多く、デバッグに時間を取られることがあります。空白や「NULL」「型違い」「大文字小文字の違い」「マルチバイト文字」など、原因はさまざまです。この記事では最新情報を踏まえて、strcmpが一致しない理由を体系的に解説し、具体的な解決策を詳しく紹介します。
PHP strcmp 一致しないときにまず確認すべき基本
strcmpは第一引数と第二引数の文字列をバイナリ単位で比較する関数で、一致なら0を返します。ですから、一致しない結果が返るときはまず基本的な前提が異なっている可能性があります。リテラル・変数の内容・型がどうなっているかを確かめることが重要です。最新のPHPでは8系が一般的で、仕様の細部が従来と変わっている部分もあります。
型（type）の違いが原因になるケース
strcmpは文字列を期待しますが、数値やNULL・boolean・配列などが渡されると予期せぬ挙動になることがあります。例えばNULLやbooleanを文字列と比較すると0一致と見なされることがあるため、==演算子で比較したのと同じように感じることがあります。型を明示的に文字列にキャストすることでこうした問題を防げます。
前後の空白・改行・制御文字の混入
人が目で見て一致していても、変数に不要な空白や改行、タブ、NUL文字などが含まれていると一致しない結果になります。特にshell_execやファイル読み込み、ユーザー入力で末尾に改行が残るケースが頻繁です。trim関数などを使って前後の空白や制御文字を除去することが有効です。
大文字小文字の相違について
strcmpは大文字小文字を区別する比較を行います。従って“Foo”と“foo”は一致しないと判断されます。大文字小文字を無視した比較を行いたいならstrcasecmpを使うか、mbstringを利用して文字単位で大文字小文字の変換を行うことが有効です。
PHP strcmpで一致しない特殊な原因と落とし穴
基本を抑えたうえで、さらに一致しない原因として見落とされがちなポイントがあります。ここでは最新のPHP仕様に則して、マルチバイト・ロケール・返り値仕様などの特殊な要因を解説します。
マルチバイト文字（UTF-8など）の扱い
strcmpはバイナリ安全な関数ですが、マルチバイト文字列を文字単位で比較することはしません。UTF-8などの非ASCII文字が含まれている場合、バイト列をそのまま比較するため、見た目は同じ文字でもバイト構成が異なれば一致しない結果になります。mb_* 系関数やIntl拡張のCollatorを活用することで、文字単位・ロケールに合わせた比較が可能です。
ロケールやローカライズの影響
Comparisons like strcmp do not take locale into account. 日本語や特殊文字を含む場合、ロケールによって文字の順序や大文字小文字の規則が変わりますが、strcmpはあくまでロケールを無視したバイナリ比較を行います。そのため、ロケールを考慮した自然な文字順や大文字小文字規則が必要な場合はstrcollやCollatorクラスを利用する方が適切です。
返り値が予期しない値になる場合（NULL・負の値など）
strcmpの返り値は一致時は0、不一致時は0未満または0より大きい整数です。最新情報では、長さが異なる文字列の場合、従来は文字列の長さの差を返していた仕様が、PHPの最新版では-1 または 1 を返すようになることがあります（8.2系以降）ので、正確な返り値を期待しないことが安全です。また、引数が配列やオブジェクトなど無効な型の場合、NULLが返されることがあり、警告が発生します。必ず引数が文字列であることを確認してください。
PHP strcmp 一致しないときの具体的なデバッグ方法
strcmpで一致しないときに、どこに問題があるかを特定するための具体的な手順を紹介します。これを試せば原因を絞り込めることが多いです。
var_dump／strlenで内容と長さを確認する
まずは変数の中身をvar_dumpで出力して、実際に含まれている文字列と型を確認します。strlenで文字列の長さを調べ、定義した文字列リテラルと長さが一致するかを確認することで空白や制御文字、追加された文字の存在を発見できます。
trim／rtrim／ltrimで不要な空白を取り除く
不要な前後の空白や改行、タブなどはtrimで取り除けます。特にユーザー入力・ファイル読み込み時・データベースからの読み出し時は改行や制御文字が入ることが多いため、比較前にtrim($_POST[…]) のように行うのが常套手段です。
必ず文字列型にキャストする・===で比較する
引数に数値・NULL・booleanなど言語が自動で型変換するデータを使っている場合、一致しない原因になります。比較する前に(string)$var1 などでキャストを行い、比較演算子として==ではなく===を使うことで、型と値の両方を見ているかを確認できます。
知っておくと便利な代替関数とユーティリティ
strcmp以外にも用途や状況に応じて使うと便利な関数やクラスがあります。一致判定だけでなく、自然順や国際化対応などを考えるならこれらのほうが適することがあります。
strcasecmp／strncasecmpで大文字小文字を無視する比較
strcasecmpはstrcmpとほぼ同じですが、大文字小文字を区別せずに比較します。英語アルファベットなどASCII範囲での比較には有用で、Fooとfooを同一視したいケースで重宝します。非ASCII文字を含む場合には結果が予想と異なることがあるため、マルチバイト対応を検討してください。
strcoll／Collatorクラスによるロケール対応比較
文字の並び順や大文字小文字の扱いをロケールに合わせたいならstrcoll関数やIntl拡張のCollatorクラスが適しています。これらは言語／地域の文字規則を考慮して比べることができ、日本語・フランス語・トルコ語などの特殊な文字処理が必要なときに一致判定の品質が向上します。
mbstring系関数で文字エンコーディングを扱う
UTF-8などを含む文字列ではマルチバイト文字が複数バイトで表現されるため、strcmpはバイト単位で比較してしまいます。これを回避するにはmb_strlenやmb_substrを使った操作や、mb_convert_caseで大文字小文字を変換してからstrcmpを使うなどの方法があります。文字数とバイト数の違いに注意することが重要です。
PHP strcmp 一致しない事例と実践的な解決例
ここまで解説した観点に基づき、実際に一致しないケースから原因・解決策をまとめます。手順に沿って確認すれば問題は解決できるでしょう。
事例：改行が含まれていたため一致しなかった
あるとき、ファイル読み込みの末尾に改行が含まれていて、期待する文字列とstrcmpしたところ不一致と判断されたケースがあります。var_dumpで表示すると末尾にLFがあり、strlenでリテラルより長さが1多かったことがわかりました。
解決策として、trimを使って前後の空白・改行を除去したうえで比較することで一致判定が期待どおりになりました。
事例：数値またはNULLを文字列と比較していた
ユーザー入力あるいは非同期処理で、変数がNULLまたは数値型であることを想定していなかったケースがあります。strcmp(“123”, 123) のような比較で、PHPは自動で型変換を試みるものの、返り値が0（一致）になることがあり、人によっては「一致した」と誤認されることがあります。
対応策として、(string)キャストや===を使うなどして、型まで確かめるよう修正した例が有効です。
事例：非ASCII文字を含む文字列で期待どおりの比較ができなかった
日本語の“あいう”と“あいう”を比べたつもりでも、UTF-8のバイト構成が異なっていたためstrcmpが一致しないと判断したケースがあります。例えば全角スペースや異なる種類の句読点が混ざっている場合などです。
この場合、Collatorクラスを使ってロケールを指定するか、特殊文字を正規化してから比較することで解決されました。
まとめ
PHPでstrcmpが一致しない原因は、主に以下のようなものがあります。空白や改行・制御文字による影響。型の不一致（NULL・boolean・数値など）。大文字小文字の違い。マルチバイト文字やロケールによる文字規則の違い。そしてstrcmp自体の返り値仕様の変化などです。
比較前にtrimで不要文字を除く・(string)で型を揃える・===を使う・ASCII外やロケールが絡むならCollatorやmbstring系を使う、といった対応をとれば、一致判定はより確実になります。
strcmpはとても便利な関数ですが、期待どおりに一致しないと感じたら、上で紹介したチェックポイントを順番に試してみてください。多くの場合、それだけで問題は解決します。
コメント