PHPのwordwrap()関数とは？文字列の折り返し方法をわかりやすく解説

PHPのwordwrap()関数は、文字列が指定した長さに達したタイミングで自動的に改行を挿入するための関数です。メール本文の整形や、レイアウト崩れを防ぎたい場面などで活用できます。

wordwrap()関数の基本

この関数は、対象の文字列が指定された幅（文字数）を超えた場合に、任意の区切り文字を使って行を折り返します。

構文

wordwrap(str, width, break, cut)

パラメータ

• str − 折り返し処理を行う対象の文字列

• width − 1行あたりの最大文字数。省略した場合のデフォルト値は「75」

• break − 改行に使用する区切り文字。省略した場合のデフォルト値は「\n」

• cut − TRUEを指定すると、単語の途中でも指定幅で強制的に折り返します。FALSEの場合は単語の境界でのみ折り返されます

戻り値

wordwrap()関数は、処理が成功した場合は折り返しが適用された文字列を返し、失敗した場合はFALSEを返します。

使用例

以下は、15文字ごとに「<br />」タグを挿入して折り返すサンプルコードです。

<?php
    $str = "Java is a programming language developed by James Gosling in 1994.";
    $res = wordwrap($str, 15, "<br />\n");
    echo $res;
?>

出力結果

上記のコードを実行すると、次のような出力が得られます。

Java is a<br />
programming<br />
language<br />
developed by<br />
James Gosling<br />
in 1994.

このようにwordwrap()関数を使えば、HTML出力だけでなく、プレーンテキスト形式のメール本文を整形する際にも便利に利用できます。必要に応じてwidthやbreakの値を変更することで、柔軟な折り返し処理が可能になります。