implode()関数の使い方

implode()関数は、
配列の要素を1つの文字列に結合（変換）する関数です。

この関数は、指定された配列の各要素を、引数で指定した区切り文字で連結し、1つの文字列として返します。

PHP 
$colors = ['red', 'green', 'blue'];
$comma_separated = implode(', ', $colors); // 「,」で区切って連結

echo $comma_separated; // 出力: 'red, green, blue'

この例では、$colors配列の要素が', 'という区切り文字で結合され、1つの文字列になります。その結果、'red, green, blue'という文字列が生成されます。

参考！
この関数は、join()という名前でも使用できます。どちらの名前でも同じ動作をします。

implode()関数の構文は次のとおりです。

構文

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

引数

implode()関数の引数の説明
$separator オプション。配列の各要素を連結する際に使用する区切り文字です。
デフォルト値は空文字列（''）です。
$array 文字列に結合する配列です。

戻り値

implode()関数は、配列の要素を順番に区切り文字で結合して生成した文字列を返します。

変更履歴

implode()関数のバージョン別の変更履歴
バージョン説明
8.0.0 配列の後に区切り文字を渡す方法は、もはやサポートされていません。
7.4.0 配列の後に区切り文字を渡す方法（つまり、以前の引数の順序）は非推奨（deprecated）となりました。

implode()関数は、基本的にこのように使用します。

PHP 
implode(string $separator, array $array);

しかし、過去には以下のように使うこともできました。

PHP 
implode(array $array, string $separator); // 旧方式（現在は非推奨または削除されています）

使用例

implode()関数の使い方について説明します。

基本的な使い方

PHP 
$fruits = ['apple', 'banana', 'orange'];
$fruits_string = implode(', ', $fruits);

echo $fruits_string; // 出力: 'apple, banana, orange'

上記のコードは、配列$fruitsの各要素をカンマとスペース（', '）で区切って1つの文字列に結合し、出力します。

配列の要素をHTMLリストとして連結する

PHP 
$items = ['Item 1', 'Item 2', 'Item 3'];
$html_list = '<ul><li>' . implode('</li><li>', $items) . '</li></ul>';

echo "HTML List:\n" . $html_list;
結果の出力

上記のコードは、配列$itemsの各要素をHTMLリストとして生成し、出力します。

implode()関数に渡される配列にオブジェクトが含まれる場合があります

PHP 
class StringArray {
    protected $title;

    public function __construct($title)
    {
        $this->title = $title;
    }

    public function __toString()
    {
        return $this->title;
    }
}

$array = [
    new StringArray('春'),
    new StringArray('夏'),
    new StringArray('秋'),
    new StringArray('冬')
];

echo implode('; ', $array); // 出力: '春; 夏; 秋; 冬'

空の配列の処理

PHP 
$empty = [];
$result = implode(', ', $empty);

var_dump($result); // 出力: string(0) ""

配列が空の場合、implode()関数はエラーを発生させず、空文字列を返します。この動作は安全ですが、特別な処理をしないと意図しない空の出力が発生する可能性があるため注意が必要です。

SQLクエリ文字列の作成

PHP 
$ids = [10, 20, 30];
$query = "SELECT * FROM users WHERE id IN (" . implode(', ', $ids) . ")";

echo $query;
// 出力: SELECT * FROM users WHERE id IN (10, 20, 30)

この例は配列の値を使って動的にSQLクエリを生成する実際の使用例です。implode()関数は配列のIDをカンマ区切りの文字列に変換し、クエリの条件として利用できるようにします。ただし、ユーザー入力を使う場合は、SQLインジェクションを防ぐために必ず適切な検証やエスケープ処理を行う必要があります。

注意点

implode()関数に渡される配列にブール型の要素が含まれる可能性がある点です。この場合、予期しない結果が発生することがあります。

PHP 
$booleans_array = [true, true, false, false, true];
$result = implode('', $booleans_array);

var_dump($result); // 出力: string(3) '111'
// trueは'1'になり、falseは何も出力されません。

参考資料

関連項目