指定した数で文字列を丸める（n文字目で…にする）関数substr、mb_substr、mb_strimwidthの違い
2019/03/30
PHPで指定した文字数で文字列を丸める関数の使い方と動作の違い
Webサイトを構築する際に活躍する関数 substr、mb_substr、mb_strimwidthの使い方とその機能の違い
Webサイトを構築する際、「この段落の文字数は最大 50文字まで表示するようにしてください。50文字を超えた部分は『．．．』にしておいてください。」なんて言う指示を受けることがよくあります。
一覧ページ、一覧表などで編集される文字数が多くなると、全体的なバランスが崩れる場合があります。
そのような事態を防ぐため、ある一定数以上の文字数の場合は、途中までしか表示しないようにする、という対応です。
そして、このように指定した文字数で文字列を丸める処理を行う PHPの関数は以下のものがあります。
- substr
- mb_substr
- mb_strimwidth
substr、mb_substr、mb_strimwidth関数は、具体的に下記の様に利用します。
|
1 2 3 4 5 6 7 8 9 10 |
$mbstrin = "あいうえおabcdeかきくけこ"; $mbstrout1 = substr ( $mbstrin, 0, 6 ); $mbstrout2 = mb_substr ( $mbstrin, 0, 6, "utf-8" ); $mbstrout3 = mb_strimwidth ( $mbstrin, 0, 6, "...", "utf-8" ); echo $mbstrin . "<br>"; echo $mbstrout1 . "<br>"; echo $mbstrout2 . "<br>"; echo $mbstrout3 . "<br>"; |
これらはよく似た動きをする関数なのですが、必須となるパラメータや、パラメータの順番などが違っていることはもちろんのこと、処理の内容も少しずつ違っていますので、これをしっかり把握していないと望んでいる結果にならない場合もあります。
使う前に今一度仕様を確認しておきましょう。
substr()関数
substr()関数は、下記の様に記述します。
|
1 |
substr ( 入力文字列, 開始場所 [, 文字数 ] ); |
substr()関数の「文字数」は、「バイト数」でカウントします。
そのため、半角文字は 1文字 1バイト、全角文字は 1文字 2バイト～4バイトとなります。
全角文字のバイト数が合わない場合（例えば「あ」に対して「1バイト」を指定した場合）は、最後の文字が文字化けします。
全角文字は、Shift-Jis、EUCなどの文字コードでは 2バイトでしたが、UTF-8の文字コードでは 3バイト、4バイトの文字が存在します。
文字コードによってバイト数が違いますので、全角文字が使われる可能性がある変数の文字数を処理する場合には向かない関数と言えます。
全角文字のバイト数に関しては下記に記事を書いていますので、あわせて参考にしてください。
日本語は2バイト文字？3バイト文字？
また、「開始場所」に負の値を入力すると、文字列の最後からの文字数となります。
「文字数」を省略すると、文字列の最後までが指定されたものとみなされます。
詳細は、PHPマニュアルにて
http://php.net/manual/ja/function.substr.php
mb_substr()関数
mb_substr()関数は、下記の様に記述します。
|
1 |
mb_substr ( 入力文字列, 開始場所 [, 文字数 [, エンコーディング ] ] ); |
mb_substr()関数の「文字数」は、文字通り文字数でカウントします。
半角も全角も 1文字は 1文字としてカウントします。
ただし、正しく文字コードが認識されたとき、という条件が付きます。
正しく文字コードを処理できない場合は、「substr()関数」と同じバイト数で処理しますので、最後の文字が文字化けする場合があります。
たまたま文字コードが正しく認識されたときはいいですが、環境が変わった場合でも正しく動作させるために、パラメータの 4項目目の「エンコーディング」は必ず指定するようにしておくべきです。
詳細は、PHPマニュアルにて
http://php.net/manual/ja/function.mb-substr.php
mb_strimwidth()関数
mb_strimwidth()関数は、下記の様に記述します。
|
1 |
mb_strimwidth ( 入力文字列, 開始場所, 文字数 [, 丸めたときに追加される文字列 [, エンコーディング ] ] ); |
mb_strimwidth()関数の「文字数」は、半角と全角で長さが変わります。
半角文字は 1文字 1文字、全角文字は 1文字 2文字となります。バイト数とも違いますので、注意が必要です。
ただし、これも、正しく文字コードが認識されたとき、という条件が付きます。
正しく文字コードを処理できない場合は、「substr()関数」と同じバイト数で処理しますので、最後の文字が文字化けする場合があります。
そのため、環境が変わった場合でも正しく動作させるため、パラメータの 4項目目の「エンコーディング」は必ず指定するようにしましょう。
4項目目のパラメータ「エンコーディング」を指定している場合は、全角文字の文字数が合わない場合でも文字化けはしませんので安心です。
例えば「あ」に対して「1文字」を指定した場合は、表示されません。（「2文字」を指定した場合にのみ表示されます。）
また、「mb_strimwidth()関数」の特徴としては、「丸めたときに追加される文字列」を指定できる点です。
Webサイトを作る際によくある、「50文字以上ある場合は 50文字まで表示して、文章を省略した場合は最後は『．．．』を追加してほしい」という要望があるかと思いますが、その場合「mb_strimwidth()関数」を使うと簡単に実装できてしまいます。
文章を省略していない場合は「．．．」は表示されませんので、制限の文字数に達したか、達していないかを自分で分岐処理を作る必要がありません。
ただし、1点注意点としては、「．．．」も含めて文字数としてカウントされている、ということです。
具体的には、「10文字」と指定した場合は「あいう...」となります。「あいうえお...」ではありません。
詳細は、PHPマニュアルにて
http://php.net/manual/ja/function.mb-strimwidth.php
GoogleAdwords
GoogleAdwords
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！
関連記事
-
-
ECCUBEのポイント設定、ポイント付与率を一括で変更する方法解説
ECCUBEの商品個別に設定してあるポイントを一括で変更する方法を解説。ECCUBEには商品個別のポイントを一括して変更する機能がありません。SQLを作成して一括置換！
-
-
連想配列のキーも値もまとめてhtmlspecialchars()でサニタイズする関数の作成解説
PHPの配列・連想配列のキーと値をまとめてhtmlspecialchars()関数でサニタイズ（無害化、無毒化）を行う関数を作成。連想配列のキーはarray_map()関数でのサニタイズは無理。
-
-
PHPパーミッション変更のchmod関数・モードを変数で指定する方法
パーミッション変更関数であるchmod関数の第二引数、ファイルモードの指定に変数を使う場合は8進数に変換するoctdec関数を使って変換します。
-
-
サーバ移転、PHPバージョンアップでPHPのソースコードが表示される・ショートタグのPHPが動かない
PHPでショートタグを使うのは危険。サーバ移転やバージョンアップで動かなくなる！ソースが丸見え、設定情報流出のリスクが！php.iniのshort_open_tagの設定を再確認。
-
-
ECCUBEの注文完了画面注文番号と商品情報を編集するCRITEO（クリテオ）タグを編集
ECCUBEの注文完了画面にクリテオのタグを編集する方法を紹介。標準機能では完了画面に注文IDや購入商品の情報を渡さないため改修が必要です。
-
-
ob_start、ob_get_contents関数でPHPの標準出力をバッファリング・変数に代入
標準出力をバッファリングし変数に代入することができるob_start()関数の解説。include()の処理をバッファリングすることで自由な場所に処理を記述することが可能。
-
-
ECCUBEの商品一覧ページのSEO対策！rel=”next” rel=”prev”を設定
Googleは関連あるページはその旨明示するよう求めています。ECCUBEの商品一覧ページでその求めに応じるための「rel=”next”」「rel=”prev”」について解説します。
-
-
PHP画面が真っ白 header(“Location: $url”);
PHPの開発で header(“Location: $url”);を使うと画面が真っ白になる不具合が出る場合もあります。
-
-
SEO対策用タイトル、ディスクリプションの文字数カウントツール
SEO対策に使える文字数カウントツールで文字数の条件の説明も行っています。
-
-
Phpmailerでスパム回避！Gmail等のSMTPを経由するPHPのメールフォーム解説
お問い合わせ等のメールフォームから送ったメールがスパム扱いされる！その対策としてライブラリ「Phpmailer」を使う方法を解説。関数化していますのでコピペでOK。
