By name: fbp-cli description: Execute and verify FBP features through cli.php commands including app_call/app_check and schema/data inspection.
fbp-cli
trigger conditions
- 実装前後のCLI確認が必要
app_call/app_checkで画面導線を検証したいdb_*/data_*/cron_list等の状態確認をしたい
workflow
- 初動3点を確認:
db_schema,db_tables_list,db_additionals_list。 - 必要なら
cron_list,webhook_rule_list,embed_app_listを確認。 - 一括投入は「1コマンド1JSON」で実行し、各ステップの必須キーを事前検証してから流す。
- 実装後は
app_callで生レスポンス、app_checkで期待値検証。 - 更新系は
data_get/data_listで結果を確認。
quick commands
- 迷ったら対象アプリの
cli.phpでdb_schema/db_tables_list/db_additionals_listをまとめて確認する。 - 画面の生レスポンス確認:
php <app-root>/fbp/cli.php app_call --json='{"class":"setting","function":"page"}' - 期待値検証:
php <app-root>/fbp/cli.php app_check --json='{"class":"public_form","function":"index","get":{"key":"abc"}}' - 更新結果確認:
php <app-root>/fbp/cli.php data_get --json='{"table":"customers","id":1}'php <app-root>/fbp/cli.php data_list --json='{"table":"customers","max":100}' - HMAC API 経由のデータ更新は、環境固有のクライアント設定に従う。
- 追加 JSON が必要な場合は、
app_call/app_checkの第3引数にpost/get/files/output_fileをそのまま渡す。 - ラッパーで足りない CLI はそのまま透過実行できる:
php <app-root>/fbp/cli.php cron_list --json='{"id":1}'
bulk execution safety
- 長い複合コマンドを
bash -lc '...'に多重クォートして実行しない（特にphp -r/ ヒアドキュメント混在を禁止）。 - 一括処理は
/tmp等に実行スクリプトを作成し、set -euo pipefail付きでbash /tmp/<script>.shで実行する。 - JSON は各操作ごとに個別で組み立てる（
db_tables_add,db_fields_add,screen_fields_add,data_addを混在させた巨大1発JSONを作らない）。 - 失敗時はその場で停止し、成功済みの確認コマンド（
*_list/data_list）で再開位置を特定してから再実行する。
purpose templates
- 初動確認:
php <app-root>/fbp/cli.php db_schema - 画面1枚の確認:
php <app-root>/fbp/cli.php app_call --json='{"class":"<class>","function":"<function>"}' - POST付き更新確認:
php <app-root>/fbp/cli.php app_call --json='{"class":"<class>","function":"<function>","post":{"id":1}}'直後にdata_getで対象レコードを確認する。 - 一覧反映確認:
php <app-root>/fbp/cli.php data_list --json='{"table":"<table>","max":100}' - 公開導線確認:
php <app-root>/fbp/cli.php app_check --json='{"class":"<class>","function":"<function>","get":{"key":"abc"}}' - screen_fields の確認:
php <app-root>/fbp/cli.php screen_fields_list --json='{"tb_name":"<tb_name>","screen_name":"<screen_name>"}' - 標準画面チェッカー:
php <app-root>/fbp/cli.php standard_screen_check --json='{"tb_name":"<tb_name>"}'screen_fields登録・変更後に実行し、ERRORは修正、WARNは意図確認する。 - 生の CLI でしか表せない場合:
php <app-root>/fbp/cli.php <command> --json='{}'
required key checks
db_fields_add:db_id,parameter_nameは必須。screen_fields_add:tb_name,screen_name,parameter_nameは必須。db_tables_edit/db_fields_edit/screen_fields_edit:idは必須。- 一括投入前に、必須キー不足があるJSONを投入しない。
known pitfalls
data_listはtableだけでなくmaxも要求される環境がある。{"table":"x","max":100}形式で呼ぶ。- API更新系は read-only 専用ではない。調査・承認前は参照系だけに限定する。
db_fields_listの結果にtb_nameが含まれない環境がある。db_idとdb_tables_list.idを対応させてテーブル名を特定する。db()->insert()/update()は参照渡し実装のため、配列リテラルを直接渡さず変数に入れてから渡す。app_callの戻りにはrequest.post/request.get/console_logが含まれる。送信値の不整合確認はまずここを見る。- アプリ受信後のPOST全体を確認したい場合は、対象関数に一時的に
$ctl->console_log($ctl->POST());を入れると CLI のconsole_logに出る。 - shell 直打ち時の
--json='...'クォート崩れが多い場合は、JSONファイルを作って--json_file相当の入力に寄せる。
constraints
- 実行ディレクトリは対象環境ルールに従う（環境固有は framework-development を参照）。