【PHP】implode()で配列を文字列に結合。基本から注意点まで丁寧に解説

例えば、
・ユーザーが入力した複数のキーワードをカンマ区切りで表示したいとき、
・データベースに保存する前に配列を一本の文字列に変換したいとき、
・CSVデータを生成したいとき
など、配列→文字列の変換は日常的な処理のひとつです。

implode(string $separator, array $array): string

<?php
$data = ["data01", "data02", "data03", "data04", "data05"];
$result = implode("/", $data);
echo $result;
?>


data01/data02/data03/data04/data05

古いPHPコードをお使いの方は必ずご確認ください。

• 以前は implode($array, $glue) のように引数を逆順で書いても動作していました。
• しかし、PHP 7.4.0 で非推奨となり、PHP 8.0.0 以降では完全に削除されています。
• PHP 8 環境で逆順に書くと Fatal error が発生してサイトが止まります。

<?php
// NG：PHP8では Fatal error になります
echo implode($data, "/");

// OK：正しい書き方
echo implode("/", $data);
?>


<?php
$items = ["りんご", "バナナ", "みかん"];

// カンマ区切り
echo implode(",", $items);
// 出力：りんご,バナナ,みかん

// 「・」区切り
echo implode("・", $items);
// 出力：りんご・バナナ・みかん

// 区切り文字なし（空文字）
echo implode("", $items);
// 出力：りんごバナナみかん
?>


<?php
$fields = ["name", "email", "phone"];
$csv_header = implode(", ", $fields);
echo $csv_header;
// 出力：name, email, phone
?>


<?php
$ids = [1, 6, 12, 18, 24];
$id_str = implode(", ", $ids);
$sql = "SELECT name, email FROM users WHERE user_id IN ($id_str)";
echo $sql;
// 出力：SELECT name, email FROM users WHERE user_id IN (1, 6, 12, 18, 24)
?>


注意：ユーザーの入力値をそのままSQLに埋め込むのはSQLインジェクションの危険があります。実際の開発ではプレースホルダやPDOを使った安全な処理を行いましょう。

<?php
$user = [
"name" => "田中",
"hobby" => "テニス",
"age" => "28",
];
$result = implode(", ", $user);
echo $result;
// 出力：田中, テニス, 28
?>


<?php
// チェックボックスから送られてきた配列
$selected = ["メルマガ希望", "資料請求", "電話相談希望"];
$saved_value = implode("、", $selected);
echo $saved_value;
// 出力：メルマガ希望、資料請求、電話相談希望
?>


• PHP8では引数の順序が固定されている
  第1引数に区切り文字、第2引数に配列の順番のみ有効です。逆順はエラーになります。
• 配列以外を渡すとエラーになる
  implode()は配列専用の関数です。文字列や数値を直接渡すとエラーが発生します。
• 多次元配列には対応していない
  配列の中にさらに配列が入っている多次元配列には使えません。
• 空の配列を渡すと空文字列が返る
  要素が0件の配列を渡した場合、エラーにはならず空文字列（""）が返ります。

<?php
$data = "data01"; // 配列ではなく文字列の場合
if (is_array($data)) {
$result = implode("/", $data);
echo $result;
} else {
echo "配列ではありません";
}
?>


<?php
$items = ["a", "b", "c"];

echo implode("-", $items); // 出力：a-b-c
echo join("-", $items); // 出力：a-b-c（同じ結果）
?>


<?php
$str = "りんご,バナナ,みかん";
$array = explode(",", $str);
print_r($array);
// 出力：Array ( [0] => りんご [1] => バナナ [2] => みかん )
?>