PHPでテキストの操作

ヒアドキュメント（Heredoc）

ヒアドキュメントは、<<<識別子 の形式で始まり、識別子と同じ名前を行頭に置くことで終了します。ダブルクォーテーションと同じように変数展開が可能です。

<?php
$name = "Taro";
$text = <<<EOD

こんにちは、{$name}さん。<br>
本日はご利用ありがとうございます。
またのご利用をお待ちしております。

EOD;

echo $text;

//【表示例】
//こんにちは、Taroさん。
//本日はご利用ありがとうございます。 またのご利用をお待ちしております。

?>

ヒアドキュメントはインデントができない点に注意が必要です。識別子 EOD は行頭に記述し、スペースやタブを入れないようにしましょう。

ナウドキュメント（Nowdoc）

ナウドキュメントは、シングルクォーテーション付きの識別子（例：<<<'EOD'）を使って記述します。変数展開は行われず、記述された文字列がそのまま出力されます。テンプレートを静的に扱いたいときに適しています。

<?php
$name = "Taro";
$text = <<<'EOD'
こんにちは、$nameさん。<br>
この文では変数は展開されません。

EOD;
echo $text; 

//【表示例】
//こんにちは、$nameさん。<br>
//この文では変数は展開されません。

?>

ナウドキュメントは、HTMLコードやスクリプトなど変数の展開が不要な静的なコンテンツを埋め込む際に便利です。

ヒアドキュメントとナウドキュメントは、どちらもコードの可読性を高め、長い文字列を安全かつ簡潔に管理できる強力なツールです。特にテンプレート処理が多いPHP開発では、ぜひ覚えておきたい構文のひとつです。

基本的な使い方

<?php
$firstName = "Taro";
$lastName = "Yamada";

$fullName = $firstName . "---" . $lastName;
echo $fullName;
// 出力: Taro---Yamada

?>

上記のように、複数の文字列や変数を . でつなぐことで、一つの文字列として扱えます。

代入と連結を同時に行う

.=（ドットイコール） を使うことで、文字列に追記することも可能です。

<?php
$message = "こんにちは";
$message .= "、Taroさん。";
$message .= " ご来店ありがとうございます。";

echo $message;
// 出力: こんにちは、Taroさん。 ご来店ありがとうございます。

?>

このように、複数の情報を順に加えていくときに便利です。

よくある注意点

• . を使ったあとは、必ずスペースを空けるのが推奨されます。空けないと可読性が下がるだけでなく、記述ミスの原因になることもあります。
• 数値との連結時に意図しない挙動を防ぐため、必要であれば strval() や number_format() などで明示的に文字列に変換することが望ましいです。

<?php
$price = 1500;
echo "価格は " . $price . " 円です。";

// 出力: 価格は 1500 円です。

?>

実務での応用例

HTMLタグを出力する場合にも、文字列連結は頻繁に使われます。

<?php
$title = "ようこそ";
$content = "<h1>" . $title . "</h1>";
echo $content;

?>

このように、テンプレート構築やメール本文の生成など、文字列の連結はPHP開発において基本中の基本とも言える操作です。

strlen() は「バイト数」を返す

<?php
$str = 'こんにちは';
echo strlen($str);

// 出力: 15

?>

この例のように、日本語は1文字あたり3バイト（UTF-8の場合）なので、strlen() は5文字の「こんにちは」を15バイトとしてカウントします。これは英数字のような1バイト文字では問題になりませんが、マルチバイト文字では見た目の文字数とは一致しないため、表示やバリデーションなどで誤動作の原因になります。

正しく「文字数」を数えるには mb_strlen()

<?php
$str = 'こんにちは';
echo mb_strlen($str);

// 出力: 5

?>

mb_strlen() を使えば、**正確に「見た目の文字数」**をカウントできます。UTF-8などのエンコーディングに対応しており、日本語でも安心して使用できます。

部分的に切り出すには mb_substr()

文字列の一部だけを取り出す場合も、同様に substr() ではなく mb_substr() を使うのが安全です。

<?php
$str = 'こんにちは';
echo mb_substr($str, 2, 2);

// 出力: にち

?>

このコードでは、3文字目から2文字分（「にち」）を切り出しています。mb_substr() では開始位置も「バイト」ではなく「文字数」で指定できます。

mb_internal_encoding() で毎回の設定を省略

mb_strlen() や mb_substr() には第3引数としてエンコーディングを指定できますが、毎回書くのは面倒です。そこで、事前に内部エンコーディングを設定しておくと便利です。

<?php
mb_internal_encoding('UTF-8');

$str = 'こんにちは';
echo mb_strlen($str);

// 出力: 5

?>

この設定により、mb_ 系関数はデフォルトで UTF-8 として動作し、コードの記述がシンプルになります。

補足：対応する mb_ 関数一覧（一部）

まとめ

• マルチバイト文字（日本語など）では、mb_ 系関数を使うのが基本
• strlen() や substr() は英数字向きで、日本語では誤動作の可能性あり
• 内部エンコーディングを設定しておくと、より安全で簡潔なコードに

マルチバイト環境下での文字列操作は、Webアプリケーションの表示やバリデーションに直結する重要なテーマです。正しい関数選びを心がけましょう。

空白の除去：trim() 関数

trim() 関数は、文字列の先頭と末尾の空白文字（スペース、タブ、改行など）を取り除くために使います。PHP 8.0以降では、全角スペース（U+3000）も除去対象に含まれており、マルチバイト文字を含む入力にも対応できます。

<?php
$raw = '  Hello World  ';
$clean = trim($raw);
echo $clean;

// 出力:"Hello World"（先頭と末尾の空白が除去される）
?>

大小文字の統一：strtolower() と strtoupper()

データの比較時に大小文字の差異を無視したい場合は、文字列をすべて小文字（または大文字）に統一するのが一般的です。

<?php
$clean = 'Hello World';
echo strtoupper($clean);
// 出力: HELLO WORLD（すべて大文字に変換）

echo strtolower($clean);
// 出力: hello world（すべて小文字に変換）

?>

たとえば、ログイン時のユーザーIDや、メールアドレス、カテゴリ名などを比較するときには、大文字と小文字を区別しないほうが自然なケースが多いため、正規化した上で比較することが推奨されます。