ver.1サポートサイト

DBオペレーション – 更新登録(1レコード)

最終更新日:2020年02月26日

データベースに対して更新キーにマッチしたデータを更新するサンプルプログラムです。
また、マッチしなかった場合、データを1行登録します。
本サンプルプログラムは外部呼出し(スパイラル以外のサーバから動作させる場合)と内部呼出し(スパイラル内部で動作させる場合)と分けて記載をしています。
利用する用途によって使用するサンプルプログラムの使い分けを行ってください。
※外部呼出しに利用するサンプルプログラムにはスパイラル内のWebコンポーネントで使用できない関数などが含まれる場合がありますのでご注意ください。
使用できないPHPの関数について、PHP利用時の注意事項をご覧ください。
※内部呼出しを利用する場合はアカウント内APIの設定を「ON」に変更する必要があります。

関連するページ

スパイラルAPIの使い方

APIリファレンス:データベース(レコード)
アカウント内API

外部呼出しを利用する場合

<?php
/**
* [ 概要 ]
* スパイラルのAPIを使ったサンプルプログラムです。
*
* [ サンプルで行う事 ]
* - 検索条件にマッチしたデータを更新します。
* - 検索条件にマッチしなかった場合、データを1行登録します。
*
* UTF8で保存してください。
*/
/**
* [サンプルを動かすための準備]
*
* 1. PHPにcurlライブラリが組み込まれている必要があります。
* 参考:http://www.php.net/manual/ja/intro.curl.php
*
* 2. スパイラルの操作画面の「DBグループ」「通常DB管理」で、以下のような構成でDBを発行します。
* DBタイトル:member
*
* フィールド:
* No1 フィールド名  :登録日時
* フィールドタイプ:登録日時
* 差替えキーワード:registDate
*
* No2 フィールド名  :メールアドレス
* フィールドタイプ:メールアドレス(大・小文字を無視)
* 差替えキーワード:email
*
* No3 フィールド名  :メンバーID
* フィールドタイプ:数字・記号・アルファベット(32 bytes)
* 差替えキーワード:member_id
*
* No4 フィールド名  :パスワード
* フィールドタイプ:メッセージダイジェスト(SHA256)
* 差替えキーワード:pass
*
* No5 フィールド名  :氏名
* フィールドタイプ:テキストフィールド(64 bytes)
* 差替えキーワード:name
*
*/
// ロケータのURL (変更の必要はありません)
$locator = "https://www.pi-pe.co.jp/api/locator";
// スパイラルの操作画面で発行したトークンを設定します。
$TOKEN = "XXXXXXXXXXXXXXXXXXXXXXXXXXX";
$SECRET = "XXXXXXXXXXXXXXXXXXXXXXXXXXX";
// API用のHTTPヘッダ
$api_headers = array(
"X-SPIRAL-API: locator/apiserver/request",
"Content-Type: application/json; charset=UTF-8",
);
// 送信するJSONデータを作成
$parameters = array();
$parameters["spiral_api_token"] = $TOKEN; //トークン
// 送信用のJSONデータを作成します。
$json = json_encode($parameters);
// curlライブラリを使って送信します。
$curl = curl_init($locator);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_POST , true);
curl_setopt($curl, CURLOPT_POSTFIELDS , $json);
curl_setopt($curl, CURLOPT_HTTPHEADER , $api_headers);
curl_exec($curl);
// エラーがあればエラー内容を表示
if (curl_errno($curl)) echo curl_error($curl);
$response = curl_multi_getcontent($curl);
curl_close($curl);
$response_json = json_decode($response , true);
// サービス用のURL
$APIURL = $response_json['location'];
// -----------------------------------------------------------------------------
// 更新登録
// -----------------------------------------------------------------------------
// API用のHTTPヘッダ
$api_headers = array(
"X-SPIRAL-API: database/upsert/request",
"Content-Type: application/json; charset=UTF-8",
);
// リクエストデータを作成
$parameters = array();
$parameters["spiral_api_token"] = $TOKEN; //トークン
$parameters["db_title"] = "member"; //DBのタイトル
$parameters["key"] = "member_id"; //更新キー
$parameters["passkey"] = time(); //エポック秒
// 更新登録したいデータを設定します(1件分)
// 改行は改行コード("\n")を指定します。JSONデータは "\n" の文字へエスケープされます。
$parameters["data"] = array(
array("name" => "registDate", "value" => "now"),
array("name" => "email", "value" => "test001@example.com"),
array("name" => "member_id", "value" => "1111"),
array("name" => "pass", "value" => "hogehoge"),
array("name" => "name", "value" => "佐藤 桃子"),
);
// 署名を付けます
$key = $parameters["spiral_api_token"] . "&" . $parameters["passkey"];
$parameters["signature"] = hash_hmac('sha1', $key, $SECRET, false);
// JSON形式にエンコードします
$json = json_encode($parameters);
echo "===> database/upsert\n";
// curlライブラリを使って送信します。
$curl = curl_init($APIURL);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_POST , true);
curl_setopt($curl, CURLOPT_POSTFIELDS , $json);
curl_setopt($curl, CURLOPT_HTTPHEADER , $api_headers);
curl_exec($curl);
// エラーがあればエラー内容を表示
if (curl_errno($curl)) echo curl_error($curl);
$response = curl_multi_getcontent($curl);
curl_close($curl);
// 画面に表示
// 配列にしたい時は json_decode($response, true); とします。
//echo "$response\n\n";
print_r(json_decode($response, true));
?>

内部呼出しを利用する場合

<?php
/**
* [ 概要 ]
* スパイラルのAPIを使ったサンプルプログラムです。
*
* [ サンプルで行う事 ]
* - データベースへ1件更新登録する
*
* UTF8で保存してください。
*/
/**
* [サンプルを動かすための準備]
* スパイラルの操作画面の「DBグループ」「通常DB管理」で、以下のような構成でDBを発行します。
*
* DBタイトル:member
*
* フィールド:
* No1 フィールド名  :登録日時
* フィールドタイプ:登録日時
* 差替えキーワード:registDate
*
* No2 フィールド名  :メールアドレス
* フィールドタイプ:メールアドレス(大・小文字を無視)
* 差替えキーワード:email
*
* No3 フィールド名  :メンバーID
* フィールドタイプ:数字・記号・アルファベット(32 bytes)
* 差替えキーワード:member_id
*
* No4 フィールド名  :パスワード
* フィールドタイプ:メッセージダイジェスト(SHA256)
* 差替えキーワード:pass
*
* No5 フィールド名  :氏名
* フィールドタイプ:テキストフィールド(64 bytes)
* 差替えキーワード:name
*
*/
// -----------------------------------------------------------------------------
// 更新登録
// -----------------------------------------------------------------------------
// データを1件更新登録します
$db = $SPIRAL->getDataBase("member");
$response = $db->doUpsert("member_id",
array("member_id" => "1111",
"registDate" => "now",
"email" => "test001@example.com",
"pass" => "hogehoe",
"name" => "佐藤 桃子"
));
print_r($response);
?>