操作手順

1. 任意のスペースをクリックします。
2. 任意のプロジェクトをクリックします。
3. 「アクション」タブをクリックします。
4. 「+ 新しいアクションを作成する」ボタンを押します。
5. 「プログラム」をクリックします。
   新規登録の際、「テンプレートから作成」、「+ 新規作成」を選択することが可能です。
   「テンプレートから作成」を選択した場合はこちら
   「新規作成」を選択した場合は、次のステップへお進みください。
6. 「アクションの名前」と「説明」を入力します。
7. 実行するプログラムを作成します。使用できる言語は次の通りです。
   • PHP
8. 「テストデータ設定」ボタンを押します。
9.  プログラムアクション中で使用した「データ項目」に対して json 形式でテストデータを設定し、「設定する」ボタンを押します。

   • // サンプルコード
     {
       "項目名１": "テストデータ１",
       "項目名２": "テストデータ２"
     }

10. 「テスト実行」ボタンを押し、「テスト実行」ボタンが「テスト成功」に更新されることを確認後、「保存する」ボタンを押すことで、設定完了となります。
    ※「テスト実行」に失敗した場合は、保存できないためご注意ください。

その他仕様

入力データの書き換え

//サンプルコード
 
// $data = 入力データの配列
function handle(array $data): array { 

//値の上書き
$data["項目名"] = "新しい値"; 
return $data;
}

1. 入力データは、$data に配列で格納されており、使用する場合はこちらから value を取り出します。取り出すには、$data["項目名"] と記述します。
2. $data["対象の項目名"] = "新しい値"; とすることで、値を書き換えることも可能です。
3. プログラムアクション以降で編集した $data を利用する場合は return 文で $data を返します。

<?php
// $data = フォームデータの配列
// $context = プログラムアクションの実行時に必要な情報が入っている配列
function handle(array $data, array $context): array {
// テンポラリディレクトリのパスを取得
$tempDir = $context["temp_dir"];
// ロガーオブジェクトを取得
$logger = $context["logger"];

// テンポラリディレクトリにファイルを書き込み
file_put_contents($tempDir . "/test", "hoge");
// ロガーにログを出力
$logger->log("program action executed", ["today" => date("%Y%m%d")]);

// クライアントのリクエスト情報
$user_agent = $context["request"]["user_agent"];
$client_ip = $context["request"]["client_ip"];
$host = $context["request"]["host"];
$access_time = $context["request"]["access_time"];

// キャッシュ
$cache = $context["cache"];
$json_data = json_encode($data);
$cache->set("hoge", $json_data);
$cached_data = $cache->get("hoge");
$cached_data = json_decode($cached_data);
$logger->log("cached", ["data" => $cached_data]);

// これまでに入力されたデータ項目のフォームデータを参照
$name = $data["name"];
$age = $data["age"];

// 外部通信
$postData = json_encode(["name" => $name, "age" => $age]);
$ch=curl_init("https://example.com/api/user");
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-type: application/json'));
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_exec($ch);

コンテキスト

オブジェクト

ロガー

• 次のメソッドを持つオブジェクトです。出力した内容をログとして参照することができます。

log(string $message, $arguments = []): void

$logger->log("hoge", ["logging" => "ok"]);

//得られる結果
{"time":"2023-03-15T19:45+0900","message":"hoge", "logging":"ok"}

キャッシュ

• 次のメソッドを持つオブジェクトです。フローで共通のキャッシュを保持することができます。例えば、頻繁に外部へアクセスすることによる外部サービスへの負荷増加を防ぐ時などに使用します。キャッシュには文字列として登録されるため、文字列ではないデータ、JSONやオブジェクトなどをキャッシュに登録する場合は事前に文字列に変換してから登録する処理が必要になります。

get(string $key): ?string

set(string $key, string $value, int $ttl = 3600): void

exists(string $key): bool

delete(string $key): void

メソッドの紹介

PHP

利用可能バージョン

制限事項

PHPのタイムゾーンに関する制限

• デフォルトのタイムゾーンは、Asia/Tokyoそれ以外はUTCのみ利用可能です。

使用できない関数

• ローカルファイルアクセス関連
  • chown
  • chmod
  • chgrp
•  外部プログラム実行関連
  • exec
  • passthru
  • shell_exec
  • system
  • proc_open
  • popen
• PHP設定ファイル関連
  • parse_ini_file
  • ini_set
  • ini_get
  • ini_get_all
  • get_cfg_var
  • ini_restore
• その他
  • phpinfo
  • mail
  • mb_send_mail

使用可能なライブラリ

• php
• php-dev
• php-bz2
• php-bcmath
• php-calendar
• php-ctype
• php-curl
• php-dom
• php-enchant
• php-exif
• php-iconv
• php-mbstring
• php-openssl
• php-opcache
• php-pcntl
• php-posix
• php-pspell
• php-session
• php-soap
• php-tidy
• php-xml
• php-xmlreader
• php-xsl
• php-zip
• php-pear
• php-mysqli
• php-pgsql
• php-pdo
• php-pdo_mysql
• php-pdo_pgsql