PHPからMySQLに配列を格納するには‥２つの方法

PHPからMySQLを使っていたとき・・

どうしても配列を格納したい
あれ？でもどうやって？
MySQLに配列型なんてないし...

そう悩む場面がありました。

でも工夫次第でなんとでもなります。

そこで PHP+MySQLで配列格納する方法を２つ紹介！

コード例と一緒に載せておきます。

このページの目次

方法１．CSVとして疑似的な配列として格納
方法２．JSON文字列で配列・連想配列を格納
方法３．searialize・unserializeで配列格納
方法４．テーブル設計自体を見直しする
方法５．MySQL5.7からJSON型が使用可能
配列を格納する方法のまとめ

方法１．CSVとして疑似的な配列として格納

まず１つめはCSVとして格納する方法

※ CSV = Comma Separated Values

CSVについての説明は不要ですよね。

具体的な方法は次のような感じ

１．テーブルを作る

▼ 例として次のテーブルを作成

CREATE TABLE group_list (
  id               INT AUTO_INCREMENT,
  members_csv      VARCHAR(1024),
  PRIMARY KEY(id)
);

CREATE TABLE group_list (

id INT AUTO_INCREMENT,

members_csv VARCHAR(1024),

PRIMARY KEY(id)

);

このSQLの members_csv はただの可変長文字列（長さは任意）です。ここにCSVを格納することで疑似的に配列を保存してみようと思います。

２．PHPのmysqliを使って配列を格納・取得

▼ 配列をCSVとして格納するコード例

/// 配列をCSVとしてDBに保存
$members = ['hoge', 'fuga', 'piyo'];
$members_csv = implode(',', $members);
$sql = "
  INSERT INTO group_list (
    members_csv
  ) VALUES ( ? );
";
$stmt = $mysqli->prepare($sql);
$stmt->bind_param('s', $members_csv);
$stmt->execute();
$stmt->close();

/// 配列をCSVとしてDBに保存

$members = ['hoge', 'fuga', 'piyo'];

$members_csv = implode(',', $members);

$sql = "

INSERT INTO group_list (

members_csv

) VALUES ( ? );

$stmt = $mysqli->prepare($sql);

$stmt->bind_param('s', $members_csv);

$stmt->execute();

$stmt->close();

▼ 配列をCSVから取得するコード例

/// 配列をCSVとしてDBから取得
$sql = "
  SELECT members_csv 
  FROM group_list LIMIT 1
";
$stmt = $mysqli->prepare($sql);
$stmt->execute();
$stmt->bind_result($members_csv);
$stmt->fetch();
$stmt->close();

/// CSV文字列を元の配列に復元する
$members = explode(',', $members_csv);
echo '$members : ' . var_export($members,1);

/// 配列をCSVとしてDBから取得

$sql = "

SELECT members_csv

FROM group_list LIMIT 1

$stmt = $mysqli->prepare($sql);

$stmt->execute();

$stmt->bind_result($members_csv);

$stmt->fetch();

$stmt->close();

/// CSV文字列を元の配列に復元する

$members = explode(',', $members_csv);

echo '$members : ' . var_export($members,1);

▼ 上コードの出力結果

$members : array ( 
  0 => 'hoge', 
  1 => 'fuga', 
  2 => 'piyo'
)

$members : array (

0 => 'hoge',

1 => 'fuga',

2 => 'piyo'

)

しっかりと格納・取得ができてます。

この方法の使いどころは次の場面

単純な配列を格納するだけでいい
連想配列などを扱っていない

もし複雑なデータ（連想配列とか入れ子構造になってる配列とか）も格納したい場合、２つめのJSONを使った格納方法がベストだと思います。

方法２．JSON文字列で配列・連想配列を格納

２つめは１つめより汎用的な方法

JSON（文字列）を使って保存します。

▼ 説明不要だけど念のため...

JavaScript Object Notation（JSON、ジェイソン）はデータ記述言語の1つである。軽量なテキストベースのデータ交換用フォーマットでありプログラミング言語を問わず利用できる[1]。名称と構文はJavaScriptにおけるオブジェクトの表記法に由来する。

引用元　：　https://ja.wikipedia.org/wiki/JavaScript_Object_Notation

多くの言語がサポートしているデータ形式

だからPHPに限らず汎用的に配列格納できます。

その具体的なコード例は次の通り

１．配列格納するテーブルを作成

▼ 例として次SQLからテーブル作成

CREATE TABLE group_list (
  id            INT AUTO_INCREMENT,
  members_json  VARCHAR(1024),
  PRIMARY KEY(id)
);

CREATE TABLE group_list (

id INT AUTO_INCREMENT,

members_json VARCHAR(1024),

PRIMARY KEY(id)

);

この中の members_json がJSONを格納するためのカラム。このように末尾に _json とつけておくと「このテーブルってただの文字列？」のような誤解をなくせます。

２．PHPのmysqliから配列を格納・取得

▼ 連想配列をJSONとして格納するコード例

/// 配列をJSONとしてDB保存する
$members = [
  ['name' => 'hoge'],
  ['name' => 'fuga'],
  ['name' => 'piyo']
];
$json = json_encode($members);
$sql = "
  INSERT INTO group_list (
    members_json
  ) VALUES ( ? )
";
$stmt = $mysqli->prepare($sql);
$stmt->bind_param('s', $json);
$stmt->execute();
$stmt->close();

/// 配列をJSONとしてDB保存する

$members = [

['name' => 'hoge'],

['name' => 'fuga'],

['name' => 'piyo']

];

$json = json_encode($members);

$sql = "

INSERT INTO group_list (

members_json

) VALUES ( ? )

$stmt = $mysqli->prepare($sql);

$stmt->bind_param('s', $json);

$stmt->execute();

$stmt->close();

▼ JSONとして配列取得するコード例

/// 配列をJSONとしてDBから取得
$sql = "
  SELECT members_json
  FROM group_list LIMIT 1
";
$stmt = $mysqli->prepare($sql);
$stmt->execute();
$stmt->bind_result($json);
$stmt->fetch();
$stmt->close();

$members = json_decode($json, true);
echo '$members : ' . var_export($members,1);

/// 配列をJSONとしてDBから取得

$sql = "

SELECT members_json

FROM group_list LIMIT 1

$stmt = $mysqli->prepare($sql);

$stmt->execute();

$stmt->bind_result($json);

$stmt->fetch();

$stmt->close();

$members = json_decode($json, true);

echo '$members : ' . var_export($members,1);

▼ 上コードの出力結果

$members : array ( 
  0 => array ( 'name' => 'hoge', ),
  1 => array ( 'name' => 'fuga', ), 
  2 => array ( 'name' => 'piyo', ),
)

$members : array (

0 => array ( 'name' => 'hoge', ),

1 => array ( 'name' => 'fuga', ),

2 => array ( 'name' => 'piyo', ),

)

問題なく配列の格納・取得ができてます。

この方法の利点は次のようなところ

入れ子の配列にも対応できる
オブジェクトの格納できる
いろいろと汎用性が高くて便利

配列を格納したいけど「もっと複雑な構造になるかもしれない」、「なるべく汎用的にしたいな」と言った場合、１つめのCSVを使う方法より確実性が高いですね。

方法３．searialize・unserializeで配列格納

PHPではデータをシリアライズ化できます。

次の２つの関数を使うことで可能。

▼ serialize関数の解説

serialize ( mixed $value ) : string

値の保存可能な表現を生成します。型や構造を失わずに PHP の値を保存または渡す際に有用です。シリアル化された文字列を PHP の値に戻すには、 unserialize() を使用してください。

引用元　：　https://www.php.net/manual/ja/function.serialize.php

▼ unserialize関数の解説

unserialize ( string $str [, array $options ] ) : mixed

unserialize() は、シリアル化された変数を PHP 変数値に戻す変換を行います。

引用元　：　https://www.php.net/manual/ja/function.unserialize.php

これもコード例を紹介・・・

と思ったけど面倒くさいので省略します。

ここまでのコードを少し改造するだけです。