CakePHP3でシェルを作成しコマンドラインから実行・CakePHP2との違い
2019/03/02
CakePHP3でシェルを作成コマンドラインから実行
CakePHP3のシェルの作成方法の前書き
この記事では、CakePHP3でシェルプログラムを作成し、コマンドラインから実行する方法を解説します。
また、公式サイトを始め、ブログなどで解説されている CakePHP関連のサンプルソースですが、ファイル名、Class名、関数名は単一単語で付けられた名称がほとんどで、複数の単語をつなぎ合わせたときにどのようにすればいいのか、よく分からないときが多々あります。
今回は「SampleProgram」というファイル名のシェルを作成しますが、この場合
「SampleProgram」(アッパーキャメルケース)
「sampleProgram」(ローワーキャメルケース)
「sample_program」(スネークケース)
「sample-program」(チェインケース)
のどれが正しいでしょうか?
どれだとエラーになるのでしょうか?
CakePHP2の時は動いたけど、CakePHP3になったら動かなくなるのはどれでしょうか?
といったことを含めて解説していきます。
CakePHP3のシェルの作成方法・複数単語の Class名、アクション名の付け方
シェルのプログラムを設置する場所は「/src/Shell/」フォルダの中になります。
ファイル名は「*******Shell.php」形式となります。
今回は「SampleProgram」というシェルを作成しますので、ファイル名は「SampleProgramShell.php」となります。
そして、今回作成するサンプルプログラムのファイルの中身は下記の通りとなります。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
<?php namespace App\Shell; use Cake\Console\Shell; class SampleProgramShell extends Shell { public function main() { $this->out('これはサンプルシェルです'); } public function sampleParameter ($parameter) { $this->out('サンプル関数の引数は「' . $parameter . '」です。'); } } |
4行目の「use Cake\Console\Shell;
」は、シェルを作成するときの必須記述ですので、まずこれを書きます。
6行目のクラス名は、ファイル名と同じですので「SampleProgramShell」を記述します。
CakePHPの命名規則としても「SampleProgramShell」となります。
複合語の先頭を大文字で書き始める記法を「アッパーキャメルケース」もしくは「パスカルケース」と言います。
ただ、「sampleProgramShell」としても問題なくは動作します。
関数を指定せずにシェル名だけを指定して実行したときは「main()」関数が実行されます。
「main()」関数がなくてもエラーにはなりません。
13行目のアクション名(関数名)は、CakePHP3の規約としては「sampleParameter」となります。
複合語の先頭を小文字で書き始める記法を「ローワーキャメルケース」もしくは「キャメルケース」と言います。
Class名は「アッパーキャメルケース」が規約に則った記述方法ですので、注意が必要です。
ただ、「SampleProgramShell」としても問題なくは動作します。
シェルをコマンドラインから実行する方法
前項で作成したシェルをコマンドラインから実行する場合は、
「(CakePHP3のルート)/」で下記のコマンドを実行します。
「(CakePHP3のルート)/」は「/var/www/html/」のような感じの場所です。
シェル名だけを指定した場合は、「main()」関数が実行されます。
引数として「main」を追加しても同じ処理になります。
1 2 3 4 |
$ bin/cake SampleProgram これはサンプルシェルです $ bin/cake SampleProgram main これはサンプルシェルです |
アクション名(関数名)を指定して、シェルを実行する場合は、下記の様に、Class名に続いて、アクション名、その引数を指定します。
1 2 3 4 |
$ bin/cake SampleProgram sampleParameter aaa サンプル関数の引数は「aaa」です。 $ bin/cake SampleProgram sample-parameter aaa サンプル関数の引数は「aaa」です。 |
この時、アクション名として指定するのは、アクション名の記述通りに「sampleParameter」とする方法があります。
また、ブラウザで表示する時と同じく、「sample-parameter」のように「-(ハイフン)」でつなぐ「チェインケース」で記述する方法があります。
また、規約から外れますが、「SampleParameter」「sample_parameter」としても動作はします。
CakePHP2と CakePHP3の違い
CakePHP2でシェルを実行する方法については、下記に記事を書いていますので、こちらを参考にしてください。
CakePHP 2.3 コマンドラインからPHPのシェル実行の方法解説
CakePHP2で作成したシェルを CakePHP3で実行する場合に不具合が発生する可能性があるのは、アクション名(関数名)の付け方ではないか、と感じます。
(というか、私がそれが原因でエラーを発生させてしまいましたので。)
1 2 3 4 5 6 7 8 9 10 11 12 |
<?php namespace App\Shell; use Cake\Console\Shell; class SampleProgramShell extends Shell { public function sample_parameter ($parameter) { $this->out('サンプル関数の引数は「' . $parameter . '」です。'); } } |
具体的には、上記は CakePHP2の元になったシェルを CakePHP3に書き直したものですが、CakePHP2では、アクション名を「public function sample_parameter ($parameter)」のように「_(アンダースコア)」で区切る「スネークケース」で記述することができました。
また、これを実行する場合は、「php cake.php SampleProgram sample_parameter aaa」のようにコマンドを実行することが可能でした。
ですが、CakePHP3では、これが正常に動作しなくなりました。
「main()」アクションがある場合は、「main()」アクションが実行されます。
ですが、「main()」アクションがない場合は、下記のエラーとなります。
1 2 3 4 5 6 |
bin/cake SampleProgram sample_parameter aaa No subcommand provided. Choose one of the available subcommands. Unable to find the `sample_program sample_parameter` subcommand. See `bin/cake sample_program --help`. Available subcommands for the `sample_program` command are : |
syntax error(文法エラー)ではないため、しばらくは何がエラーなのか分かりませんでした。
CakePHP3では、アクション名をローワーキャメルケース(sampleParameter)で記述しておけば、シェルを実行するときはスネークケース(sample_parameter)で呼び出すことは出来ますので、アクション名をスネークケースで記述することができなくなった、ということなのでしょう。
CakePHP3であっても、同一の Class内での関数の場合は、関数名がキャメルケースでもスネークケースでも動作するところもややこしさが増すところではありますね。
命名規則を理解して、しっかり規則に沿った命名を行いましょう!ってことですね。
CakePHP3の関連記事
CakePHP4のCSS、JavaScript、画像のブラウザへのキャッシュをコントロールするCakePHP3でレコードを保存(追加、更新、Insert、Update)する複数の方法を紹介
CakePHP3でモデルなしフォームからCSVをアップロードしレコードを更新する方法解説
CakePHP3でPHP Simple HTML DOM Parserを使ってスクレイピングする方法
CakePHP3のInsert On Duplicate Key Update(upsert)構文を解説・バルク処理も
CakePHP3の1対多での連携を中間テーブルを使った多対多の連携に変更するときの手順
CakePHP3でデフォルトのソート条件を設定してユーザの選択肢たソート条件を有効にする方法
CakePHP3で Ajaxを使う方法の解説。3.6以降対応。Successとthenの両方を解説。
CakePHP3でパンくずの指定は HTMLヘルパーを使って指定する方法を解説
CakePHP3にOGPをfetch、asignを利用してテンプレートごとに指定する方法を解説
その他の「CakePHP3」に関する記事一覧
GoogleAdwords
GoogleAdwords
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです!
関連記事
-
-
CakePHP3のタイムゾーンを協定世界時UTCから日本標準時間JSTにずれを変更する方法
CakePHP3の標準設定のタイムゾーンは「UTC(協定世界時)」に設定されている。これを日本標準時に変更する方法(app.php、bootstrap.phpの変更方法)の解説。
-
-
CakePHP4のFrozenDateで1ヵ月前、先月、今月1日、来月末の日付などを算出する方法
CakePHPには「FrozenDate」の日付を扱う関数が用意されている。これを利用して、1ヶ月後、月末日、月初日、5日後などを指定して日付を取得できる。それを解説。
-
-
CakePHP 2.3でファイルのアップロード処理を作る
CakePHPでプラグインを使わないファイルアップロード処理を解説します。簡単です。DBにファイルを格納する方法も。
-
-
CakePHP3にWYSIWYGエディタのCKEditor4を設置、カスタマイズ方法を解説
WYSIWYGエディタであるCKEditor4をCDNを利用して簡単にCakePHP3に導入する方法とカスタマイズする方法を解説。CakePHP3にはページごとの振り分けを行うブロック化を利用する。
-
-
CakePHP 2.3 主キー(ID)以外のキーで更新方法 updateAll
主キー(ID)以外のカラムをキーとして更新する方法、updateAllの使い方をサンプルを用いて解説します。
-
-
CakePHP4 でコマンドプログラム(シェルプログラム)を作成する方法解説
CakePHP4でバッチ処理を行うためのコマンド・シェルの実装方法について解説。bakeでテンプレートファイルを作成し、「execute()」に処理を記述する方法を解説。
-
-
CakePHP3のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説・3.6以降対応
CakePHP3のユーザ管理プラグイン Usersは、ユーザ登録、メール認証、ログイン認証、ユーザ管理、権限管理、reCAPTCHAなど会員制のサイトを簡単に実現可能。その導入方法、カスタマイズ方法を解説。
-
-
CakePHP 2.3でファイルをアップロード・その2 ファイル名を乱数で設定
CakePHPのアップロードするファイル名を乱数で変更しセキュリティを高める方法を解説。
-
-
CakePHP3でDocumentRootやwebroot、imgフォルダのURLやドメイン、パスを取得
URLやドメイン、フォルダへのパスの取得は、ビューではUrlHelperを使い、コントローラーではRouterクラスを使います。第2引数の指定でURLを取得することも可能。
-
-
CakePHPで Auto Incrementを外すと Duplicate entry ‘0’ for keyのエラーが出るかも
CakePHPでAuto Incrementの設定を変更したときに「Duplicate entry ‘0’ for key」のエラーが出た。原因はModel内で IDを編集する処理の追加を忘れていたからだった。