「当プラグイン用の商品情報」の「商品レビュー」から、「最適な商品レビューの文字列」を作成する

// 「ちょうどいい」の単語で「fit」を選んだ。
public static function makeFitReviewText(
	ReviewItem $reviewItem,
	ReviewItemHTMLOption $reviewItemHTMLOption
) {

	$reviewLength = $reviewItemHTMLOption->getReviewLength();

	$reviewText;

	$reviewLineArray = $reviewItem->getReviewLineArray();
	if (count($reviewLineArray) > 0) {

		$reviewText = ReviewItemHTMLUtils::makeFitReviewLinesText(
			$reviewLineArray,
			$reviewLength
		);
	} else {

		$plainTextReview = $reviewItem->getPlainTextReview();
		// HTML終了タグがないので、文字列を途中で切断できる。平文なので、HTML文法エラーとならない。
		$reviewText = TextUtils::mb_strimwidth($plainTextReview, 0, $reviewLength, "…"); // $reviewLengthは、文字幅（見た目の長さ）を示す。
	}

	$stringToDeleteJSONArray = $reviewItemHTMLOption->getStringToDeleteJSONArray();
	$reviewText = str_replace($stringToDeleteJSONArray, "", $reviewText); // 表示したくない文字列を削除する。

	$stringToBreakJSONArray = $reviewItemHTMLOption->getStringToBreakJSONArray();
	// 文字列の前または後ろに、改行タグを追加する。
	$SENTENCE_SYMBOLS = $reviewItemHTMLOption->getLatestSentenceSymbols();
	$reviewText = ReviewItemHTMLUtils::makeReviewTextWithLineBreakAdded(
		$reviewText,
		$stringToBreakJSONArray,
		$SENTENCE_SYMBOLS
	);

	return $reviewText;
}

【メール便送料無料、通常24時間以内出荷】著者：山田。<br>
<br>●通常24時間以内に出荷可能です。<br>

中略

※繁忙期やセール等、ご注文数が多い日につきましては　発送まで48時間かかる場合があります…

{
"●":"<br>●",
"■":"<br>■",
"◆":"<br>◆",
"◇":"<br>◇",
"★":"<br>★",
"【":"<br>【",
"※":"<br>※",
" ・":"<br> ・",
" サイズ ":"<br> サイズ ",
" 素材 ":"<br> 素材 ",
" 注意事項 ":"<br> 注意事項 ",
"。":"。<br>"
}

// 「ちょうどいい」の単語で「fit」を選んだ。
$reviewLength = $reviewItemHTMLOption->getReviewLength();

$reviewText;

$reviewLineArray = $reviewItem->getReviewLineArray();
if (count($reviewLineArray) > 0) {

	$reviewText = ReviewItemHTMLUtils::makeFitReviewLinesText(
		$reviewLineArray,
		$reviewLength
	);
} else {

	$plainTextReview = $reviewItem->getPlainTextReview();
	// HTML終了タグがないので、文字列を途中で切断できる。平文なので、HTML文法エラーとならない。
	$reviewText = TextUtils::mb_strimwidth($plainTextReview, 0, $reviewLength, "…"); // $reviewLengthは、文字幅（見た目の長さ）を示す。
}

$reviewLineArray = $reviewItem->getReviewLineArray();
if (count($reviewLineArray) > 0) {

	$reviewText = ReviewItemHTMLUtils::makeFitReviewLinesText(
		$reviewLineArray,
		$reviewLength
	);
}

$plainTextReview = $reviewItem->getPlainTextReview();
// HTML終了タグがないので、文字列を途中で切断できる。平文なので、HTML文法エラーとならない。
$reviewText = TextUtils::mb_strimwidth($plainTextReview, 0, $reviewLength, "…"); // $reviewLengthは、文字幅（見た目の長さ）を示す。

例えば、
段落を表す<p>商品の説明文その1</p>において、

<p>商品の説明文その…

このように文字列の切り詰めで、終了タグ</p>を失うことはありません。

$reviewText = TextUtils::mb_strimwidth($plainTextReview, 0, $reviewLength, "…"); // $reviewLengthは、文字幅（見た目の長さ）を示す。

$stringToDeleteJSONArray = $reviewItemHTMLOption->getStringToDeleteJSONArray();
$reviewText = str_replace($stringToDeleteJSONArray, "", $reviewText); // 表示したくない文字列を削除する。

$stringToDeleteJSONArray = $reviewItemHTMLOption->getStringToDeleteJSONArray();

["＜p＞","＜/p＞","＜b＞","＜br＞","＜br /＞"]

$reviewText = str_replace($stringToDeleteJSONArray, "", $reviewText); // 表示したくない文字列を削除する。

$stringToBreakJSONArray = $reviewItemHTMLOption->getStringToBreakJSONArray();
// 文字列の前または後ろに、改行タグを追加する。
$SENTENCE_SYMBOLS = $reviewItemHTMLOption->getLatestSentenceSymbols();
$reviewText = ReviewItemHTMLUtils::makeReviewTextWithLineBreakAdded(
	$reviewText,
	$stringToBreakJSONArray,
	$SENTENCE_SYMBOLS
);

$stringToBreakJSONArray = $reviewItemHTMLOption->getStringToBreakJSONArray();

array(12)
"●":"<br>●",
"■":"<br>■",
"◆":"<br>◆",
"◇":"<br>◇",
"★":"<br>★",
"【":"<br>【",
"※":"<br>※",
" ・":"<br> ・",
" サイズ ":"<br> サイズ ",
" 素材 ":"<br> 素材 ",
" 注意事項 ":"<br> 注意事項 ",
"。":"。<br>"

{
"●":"<br>●",
"■":"<br>■",
"◆":"<br>◆",
"◇":"<br>◇",
"★":"<br>★",
"【":"<br>【",
"※":"<br>※",
" ・":"<br> ・",
" サイズ ":"<br> サイズ ",
" 素材 ":"<br> 素材 ",
" 注意事項 ":"<br> 注意事項 ",
"。":"。<br>"
}

$SENTENCE_SYMBOLS = $reviewItemHTMLOption->getLatestSentenceSymbols();

●■◆◇★【※。

$reviewText = ReviewItemHTMLUtils::makeReviewTextWithLineBreakAdded(
	$reviewText,
	$stringToBreakJSONArray,
	$SENTENCE_SYMBOLS
);

private static function makeFitReviewLinesText($reviewLineArray, $reviewLength)
{

	$fitReviewLinesText = "";
	$BR_TAG = "<br>";

	$lineCount = count($reviewLineArray);
	$lastIndex = $lineCount - 1;

	for ($i = 0; $i < $lineCount; $i++) {

		$fitReviewLinesText .= $reviewLineArray[$i];

		// $BR_TAGを加えた長さで判定する。例：mb_strimwidthの数え間違い例：<br>…… が <br…… という風に切断されていた。
		$stringWidth = mb_strwidth($fitReviewLinesText . $BR_TAG, "UTF-8"); // 文字幅（見た目の長さ） //var_dump($stringWidth);
		if ($stringWidth >= $reviewLength) {

			$fitReviewLinesText = TextUtils::mb_strimwidth(
				$fitReviewLinesText,
				0,
				$reviewLength,
				"…"
			);
			break;
		}

		if ($i < $lastIndex) {
			$fitReviewLinesText .= $BR_TAG;
		}
	}

	return $fitReviewLinesText;
}

商品レビューの行その1<br>商品レビューの行その2<br>商品レビューの…

for ($i = 0; $i < $lineCount; $i++) {

	$fitReviewLinesText .= $reviewLineArray[$i];

	// $BR_TAGを加えた長さで判定する。例：mb_strimwidthの数え間違い例：<br>…… が <br…… という風に切断されていた。
	$stringWidth = mb_strwidth($fitReviewLinesText . $BR_TAG, "UTF-8"); // 文字幅（見た目の長さ） //var_dump($stringWidth);
	if ($stringWidth >= $reviewLength) {

		$fitReviewLinesText = TextUtils::mb_strimwidth(
			$fitReviewLinesText,
			0,
			$reviewLength,
			"…"
		);
		break;
	}

	if ($i < $lastIndex) {
		$fitReviewLinesText .= $BR_TAG;
	}
}

array(3)
0: "商品レビューの行その1"
1: "商品レビューの行その2"
2: "商品レビューの行その3"

for ($i = 0; $i < $lineCount; $i++) {

	$fitReviewLinesText .= $reviewLineArray[$i];

以下省略

// $BR_TAGを加えた長さで判定する。例：mb_strimwidthの数え間違い例：<br>…… が <br…… という風に切断されていた。
$stringWidth = mb_strwidth($fitReviewLinesText . $BR_TAG, "UTF-8"); // 文字幅（見た目の長さ） //var_dump($stringWidth);
if ($stringWidth >= $reviewLength) {

	$fitReviewLinesText = TextUtils::mb_strimwidth(
		$fitReviewLinesText,
		0,
		$reviewLength,
		"…"
	);
	break;
}

// $fitReviewLinesText変数の例。
商品レビューの行その1<br>商品レビューの行その2<br>商品レビューのその3

// $BR_TAG変数の例。
<br>

// 「商品レビューの行の文字列」と「改行タグ」を結合した文字列の例。
商品レビューの行その1<br>商品レビューの行その2<br>商品レビューのその3<br>

商品レビューの行その1<br>商品レビューの行その2<br>商品レビューの…

商品レビューの行その1<br……

mb_strwidth(文字列, 文字エンコーディング);

引数には、
文字列とオプショナルで文字エンコーディングを、指定できます。

for ($i = 0; $i < $lineCount; $i++) {

中略

	if ($i < $lastIndex) {
		$fitReviewLinesText .= $BR_TAG;
	}
}

array(3)
0: "商品レビューの行その1" に "<br>" を追加する。
1: "商品レビューの行その2" に "<br>" を追加する。
2: "商品レビューの行その3" 最後の要素なので、"<br>" を追加しない。

private static function makeReviewTextWithLineBreakAdded($reviewText, $stringToBreakJSONArray, $SENTENCE_SYMBOLS)
{

	$LINE_BREAK_TAG = "<br>";

	$NON_SENTENCE_CHARACTERS_PATTERN;
	// $SENTENCE_SYMBOLSの例："●■◆★。"「●箇条書き」の記号文字たち、または句点
	if ($SENTENCE_SYMBOLS) {
		$NON_SENTENCE_CHARACTERS_PATTERN = '[^' . $SENTENCE_SYMBOLS . ']+?';
	} else {
		$NON_SENTENCE_CHARACTERS_PATTERN = '.*?';
	}

	$newReviewText = $reviewText;

	foreach ($stringToBreakJSONArray as $stringToBreak => $replaceText) {

		// 例：'/●([^●◆。]+?)/u'
		// 例：●●●の場合、●●<br>●と置き換える。
		// ●の後に、「●」または「◆」または「。」でない文字列。
		// この文字列は、「●箇条書き」の本文、または句点のこと。
		// +? 最短一致。UTF-8でpreg系を使う場合は、パターン修飾子として"u"を指定する。
		$pattern = '/' . $stringToBreak . '(' . $NON_SENTENCE_CHARACTERS_PATTERN . ')/u';

		$replace = $replaceText . '\1'; // 例：<br>●\1。\1は箇条書きの本文。
		$newReviewText = preg_replace($pattern, $replace, $newReviewText);
	}

	if (TextUtils::startsWith($newReviewText, $LINE_BREAK_TAG)) { // 先頭の<br>を取り除く。
		$startIndex = mb_strlen($LINE_BREAK_TAG, "UTF-8");
		$newReviewText = mb_substr($newReviewText, $startIndex, NULL, "UTF-8");
	}

	// 例：'#<br>[\s ]*?<br>#u'
	// ここでは正規表現の区切り文字（デリミタ）を/の代わりに#を使った。
	// 以前スラッシュ文字がある<br />を使って処理していたから。
	// *? 最短一致
	$pattern = '#' . $LINE_BREAK_TAG . '[\s　]*?' . $LINE_BREAK_TAG . '#u';
	// 例：<br>空白文字<br>を<br>に置換する。
	$newReviewText = preg_replace($pattern, $LINE_BREAK_TAG, $newReviewText);

	return $newReviewText;
}

array(12)
"●":"<br>●",
"■":"<br>■",
"◆":"<br>◆",
"◇":"<br>◇",
"★":"<br>★",
"【":"<br>【",
"※":"<br>※",
" ・":"<br> ・",
" サイズ ":"<br> サイズ ",
" 素材 ":"<br> 素材 ",
" 注意事項 ":"<br> 注意事項 ",
"。":"。<br>"

"●"を
"<br>●"に、置換します。

この文字列置換によって、HTMLの改行タグを追加します。

【メール便送料無料、通常24時間以内出荷】著者：山田。<br>
<br>●通常24時間以内に出荷可能です。<br>

中略

※繁忙期やセール等、ご注文数が多い日につきましては　発送まで48時間かかる場合があります…

$NON_SENTENCE_CHARACTERS_PATTERN;
// $SENTENCE_SYMBOLSの例："●■◆★。"「●箇条書き」の記号文字たち、または句点
if ($SENTENCE_SYMBOLS) {
	$NON_SENTENCE_CHARACTERS_PATTERN = '[^' . $SENTENCE_SYMBOLS . ']+?';
} else {
	$NON_SENTENCE_CHARACTERS_PATTERN = '.*?';
}

●商品の説明文です。

●■◆◇★【※。

$newReviewText = $reviewText;

foreach ($stringToBreakJSONArray as $stringToBreak => $replaceText) {

	// 例：'/●([^●◆。]+?)/u'
	// 例：●●●の場合、●●<br>●と置き換える。
	// ●の後に、「●」または「◆」または「。」でない文字列。
	// この文字列は、「●箇条書き」の本文、または句点のこと。
	// +? 最短一致。UTF-8でpreg系を使う場合は、パターン修飾子として"u"を指定する。
	$pattern = '/' . $stringToBreak . '(' . $NON_SENTENCE_CHARACTERS_PATTERN . ')/u';

	$replace = $replaceText . '\1'; // 例：<br>●\1。\1は箇条書きの本文。
	$newReviewText = preg_replace($pattern, $replace, $newReviewText);
}

array(12)
"●":"<br>●",
"■":"<br>■",
"◆":"<br>◆",
"◇":"<br>◇",
"★":"<br>★",
"【":"<br>【",
"※":"<br>※",
" ・":"<br> ・",
" サイズ ":"<br> サイズ ",
" 素材 ":"<br> 素材 ",
" 注意事項 ":"<br> 注意事項 ",
"。":"。<br>"

●商品の説明文その1です。
■商品の説明文その2です。
◆商品の説明文その3です。

<br>●商品の説明文その1です。<br>
<br>■商品の説明文その2です。<br>
<br>◆商品の説明文その3です。<br>

foreach ($stringToBreakJSONArray as $stringToBreak => $replaceText) {
	$pattern = '/' . $stringToBreak . '(' . $NON_SENTENCE_CHARACTERS_PATTERN . ')/u';

	$replace = $replaceText . '\1'; // 例：<br>●\1。\1は箇条書きの本文。
	$newReviewText = preg_replace($pattern, $replace, $newReviewText);
}

$pattern = '/' . $stringToBreak . '(' . $NON_SENTENCE_CHARACTERS_PATTERN . ')/u';
$replace = $replaceText . '\1'; // 例：<br>●\1。\1は箇条書きの本文。

$newReviewText = preg_replace($pattern, $replace, $newReviewText);

 例：'/●([^●◆。]+?)/u'

<br>●商品の説明文その1です。<br>
<br>■商品の説明文その2です。<br>
<br>◆商品の説明文その3です。<br>

if (TextUtils::startsWith($newReviewText, $LINE_BREAK_TAG)) { // 先頭の<br>を取り除く。
	$startIndex = mb_strlen($LINE_BREAK_TAG, "UTF-8");
	$newReviewText = mb_substr($newReviewText, $startIndex, NULL, "UTF-8");
}

<br>●商品の説明文その1です。<br>
<br>■商品の説明文その2です。<br>
<br>◆商品の説明文その3です。<br>

●商品の説明文その1です。<br>
<br>■商品の説明文その2です。<br>
<br>◆商品の説明文その3です。<br>

// 例：'#<br>[\s ]*?<br>#u'
// ここでは正規表現の区切り文字（デリミタ）を/の代わりに#を使った。
// 以前スラッシュ文字がある<br />を使って処理していたから。
// *? 最短一致
$pattern = '#' . $LINE_BREAK_TAG . '[\s　]*?' . $LINE_BREAK_TAG . '#u';
// 例：<br>空白文字<br>を<br>に置換する。
$newReviewText = preg_replace($pattern, $LINE_BREAK_TAG, $newReviewText);

$pattern変数が保持する正規表現。
'#<br>[\s ]*?<br>#u'

<?php

namespace goodsmemo\item\html;

use goodsmemo\item\ReviewItem;
use goodsmemo\item\html\ReviewItemHTMLOption;
use goodsmemo\text\TextUtils;

require_once GOODS_MEMO_DIR . "item/ReviewItem.php";
require_once GOODS_MEMO_DIR . "item/html/ReviewItemHTMLOption.php";
require_once GOODS_MEMO_DIR . "text/TextUtils.php";

class ReviewItemHTMLUtils
{

	public static function makeFitReviewText(
		ReviewItem $reviewItem,
		ReviewItemHTMLOption $reviewItemHTMLOption
	) {

		// 「ちょうどいい」の単語で「fit」を選んだ。
		$reviewLength = $reviewItemHTMLOption->getReviewLength();

		$reviewText;

		$reviewLineArray = $reviewItem->getReviewLineArray();
		if (count($reviewLineArray) > 0) {

			$reviewText = ReviewItemHTMLUtils::makeFitReviewLinesText(
				$reviewLineArray,
				$reviewLength
			);
		} else {

			$plainTextReview = $reviewItem->getPlainTextReview();
			// HTML終了タグがないので、文字列を途中で切断できる。平文なので、HTML文法エラーとならない。
			$reviewText = TextUtils::mb_strimwidth($plainTextReview, 0, $reviewLength, "…"); // $reviewLengthは、文字幅（見た目の長さ）を示す。
		}

		$stringToDeleteJSONArray = $reviewItemHTMLOption->getStringToDeleteJSONArray();
		$reviewText = str_replace($stringToDeleteJSONArray, "", $reviewText); // 表示したくない文字列を削除する。

		$stringToBreakJSONArray = $reviewItemHTMLOption->getStringToBreakJSONArray();
		// 文字列の前または後ろに、改行タグを追加する。
		$SENTENCE_SYMBOLS = $reviewItemHTMLOption->getLatestSentenceSymbols();
		$reviewText = ReviewItemHTMLUtils::makeReviewTextWithLineBreakAdded(
			$reviewText,
			$stringToBreakJSONArray,
			$SENTENCE_SYMBOLS
		);

		return $reviewText;
	}

	private static function makeFitReviewLinesText($reviewLineArray, $reviewLength)
	{

		$fitReviewLinesText = "";
		$BR_TAG = "<br>";

		$lineCount = count($reviewLineArray);
		$lastIndex = $lineCount - 1;

		for ($i = 0; $i < $lineCount; $i++) {

			$fitReviewLinesText .= $reviewLineArray[$i];

			// $BR_TAGを加えた長さで判定する。例：mb_strimwidthの数え間違い例：<br>…… が <br…… という風に切断されていた。
			$stringWidth = mb_strwidth($fitReviewLinesText . $BR_TAG, "UTF-8"); // 文字幅（見た目の長さ） //var_dump($stringWidth);
			if ($stringWidth >= $reviewLength) {

				$fitReviewLinesText = TextUtils::mb_strimwidth(
					$fitReviewLinesText,
					0,
					$reviewLength,
					"…"
				);
				break;
			}

			if ($i < $lastIndex) {
				$fitReviewLinesText .= $BR_TAG;
			}
		}

		return $fitReviewLinesText;
	}

	private static function makeReviewTextWithLineBreakAdded($reviewText, $stringToBreakJSONArray, $SENTENCE_SYMBOLS)
	{

		$LINE_BREAK_TAG = "<br>";

		$NON_SENTENCE_CHARACTERS_PATTERN;
		// $SENTENCE_SYMBOLSの例："●■◆★。"「●箇条書き」の記号文字たち、または句点
		if ($SENTENCE_SYMBOLS) {
			$NON_SENTENCE_CHARACTERS_PATTERN = '[^' . $SENTENCE_SYMBOLS . ']+?';
		} else {
			$NON_SENTENCE_CHARACTERS_PATTERN = '.*?';
		}

		$newReviewText = $reviewText;

		foreach ($stringToBreakJSONArray as $stringToBreak => $replaceText) {

			// 例：'/●([^●◆。]+?)/u'
			// 例：●●●の場合、●●<br>●と置き換える。
			// ●の後に、「●」または「◆」または「。」でない文字列。
			// この文字列は、「●箇条書き」の本文、または句点のこと。
			// +? 最短一致。UTF-8でpreg系を使う場合は、パターン修飾子として"u"を指定する。
			$pattern = '/' . $stringToBreak . '(' . $NON_SENTENCE_CHARACTERS_PATTERN . ')/u';

			$replace = $replaceText . '\1'; // 例：<br>●\1。\1は箇条書きの本文。
			$newReviewText = preg_replace($pattern, $replace, $newReviewText);
		}

		if (TextUtils::startsWith($newReviewText, $LINE_BREAK_TAG)) { // 先頭の<br>を取り除く。
			$startIndex = mb_strlen($LINE_BREAK_TAG, "UTF-8");
			$newReviewText = mb_substr($newReviewText, $startIndex, NULL, "UTF-8");
		}

		// 例：'#<br>[\s ]*?<br>#u'
		// ここでは正規表現の区切り文字（デリミタ）を/の代わりに#を使った。
		// 以前スラッシュ文字がある<br />を使って処理していたから。
		// *? 最短一致
		$pattern = '#' . $LINE_BREAK_TAG . '[\s　]*?' . $LINE_BREAK_TAG . '#u';
		// 例：<br>空白文字<br>を<br>に置換する。
		$newReviewText = preg_replace($pattern, $LINE_BREAK_TAG, $newReviewText);

		return $newReviewText;
	}
}