Spark コマンド
CodeIgniter には、公式コマンド spark と組み込みコマンドが付属しています。
コマンドの実行
CLI 経由での実行
コマンドは、プロジェクトのルートディレクトリでコマンドラインから実行されます。コマンドファイル spark が提供されており、これを使用して CLI コマンドを実行します。
コマンド一覧の表示
コマンドを指定せずに spark を呼び出すと、利用可能なコマンドとその説明がカテゴリ別にソートされた簡単なヘルプページが表示されます。
php spark
spark list
php spark
は、list
コマンドとまったく同じです。
php spark list
--simple
オプションを使用すると、利用可能なすべてのコマンドの生のリストをアルファベット順で取得することもできます。
php spark list --simple
ヘルプの表示
help
コマンドを使用すると、次のように CLI コマンドに関するヘルプを表示できます。
php spark help db:seed
v4.3.0 以降では、help
コマンドの代わりに --help
オプションを使用することもできます。
php spark db:seed --help
コマンドの実行
コマンドを実行するには、コマンドの名前を最初の引数として渡す必要があります。
php spark migrate
一部のコマンドは追加の引数を取り、これらはコマンドの直後にスペースで区切って指定する必要があります。
php spark db:seed DevUserSeeder
CodeIgniter が提供するすべてのコマンドで、必要な引数を指定しない場合は、正しく実行するために必要な情報が求められます。
php spark make:controller
Controller class name :
ヘッダー出力の抑制
コマンドを実行すると、CodeIgniter のバージョンと現在の時刻を含むヘッダーが出力されます。
php spark env
CodeIgniter v4.3.5 Command Line Tool - Server Time: 2023-06-16 12:45:31 UTC+00:00
Your environment is currently set as development.
結果の解析に役立つヘッダー出力を抑制するには、常に --no-header
を渡すことができます。
php spark env --no-header
Your environment is currently set as development.
コマンドの呼び出し
コマンドは、独自のコード内からも実行できます。これは通常、cronjob タスクのコントローラー内で実行されますが、いつでも使用できます。これを行うには、command()
関数を使用します。この関数は常に利用可能です。
<?php
echo command('make:migration TestMigration');
唯一の引数は、呼び出されるコマンドと任意のパラメーターである文字列です。これは、コマンドラインから呼び出す場合とまったく同じように表示されます。
コマンドラインから実行されていない場合、実行されたコマンドからのすべての出力がキャプチャされます。表示するかどうかを選択できるように、コマンドから返されます。