さくらのレンタルサーバーでのCRON設定
さくらのレンタルサーバーで、CRM分析プラグインの集計用CRONを設定する手順です。
コントロールパネルから2本のスケジュールを登録します。
前提条件
- さくらのレンタルサーバー スタンダードプラン以上（ライトプランはCRON非対応）
- サーバーコントロールパネルへ、初期ドメイン（または追加ドメイン）でログインできること
- EC-CUBEとCRM分析プラグインがインストール済みであること
- コントロールパネルのCRON設定枠に空きがあること（最大10個）
推奨スケジュール
さくらのレンタルサーバーではコントロールパネルから毎分実行を設定することができない為、CRM分析プラグインでは 5分おき を推奨しています。
| 用途 | 推奨 | コマンド |
|---|---|---|
| 集計ワーカー | 5分おき | eccube:crm-analytics42:worker |
| 日次登録 | 毎日 3:00 | eccube:crm-analytics42:enqueue-daily |
管理画面から集計を開始するとキューに登録され、次回のワーカー実行で処理が始まります。5分おきなら、開始までの待ちは最大で約5分です。
設定手順
- サーバーコントロールパネルにログインする（初期ドメイン / 追加ドメインでログイン）
- 「スクリプト設定」→「CRON設定」を開く
- 「スケジュールの追加」をクリックする
- 後述の「実行コマンド」と「実行日時」を入力する
- コメントに用途（例: CRM分析 worker）を記入する（任意）
- 「追加する」をクリックする
- 日次登録用も同様にもう1件追加する
実行コマンドの書き方
さくらのコントロールパネルでは、実行日時と実行コマンドを分けて入力します。ダッシュボードの初期セットアップに表示される1行（先頭に */5 * * * * などが付いた行）をそのまま貼り付けず、次のように分けてください。コマンドの表示方法は、初期セットアップ を参照してください。
1. 集計ワーカー（5分おき）
実行コマンド（1行）:
cd /home/アカウント名/www/ec-cube && /usr/local/bin/php bin/console --no-debug eccube:crm-analytics42:worker
実行日時:
| 月 | 日 | 時 | 分 | 曜日 |
|---|---|---|---|---|
* | * | * | */5 | * |
2. 日次登録（毎日 3:00）
実行コマンド（1行）:
cd /home/アカウント名/www/ec-cube && /usr/local/bin/php bin/console --no-debug eccube:crm-analytics42:enqueue-daily
実行日時:
| 月 | 日 | 時 | 分 | 曜日 |
|---|---|---|---|---|
* | * | 3 | 0 | * |
PHPのバージョンを設定する
コマンドの /usr/local/bin/php は、サーバーコントロールパネルの「言語バージョン設定」で選んだPHPのバージョンで動きます。コマンド側でバージョンを指定することはできません。
「言語バージョン設定」を、EC-CUBEが対応するバージョン（CRM分析プラグインは PHP 7.4〜8.3。動作環境・対応バージョン を参照）に設定してください。
パスの置き換え
/home/アカウント名/www/ec-cubeは、実際のEC-CUBE設置ディレクトリに置き換えてください- ダッシュボードの初期セットアップに表示されるパスを使うと確実です
- PHPのパスは、
/usr/local/bin/phpのまま使ってください（バージョンは「言語バージョン設定」で決まります）
設定後の確認
- ダッシュボードの初期セットアップで、ワーカー側に「動作を確認しました」と出るか見る
- 初期セットアップの「上記2つの登録が完了したらチェックしてください。」にチェックを入れる
- 管理画面から短い期間で集計を開始し、「定期実行の開始待ち」から実行中へ進むことを確認する
うまくいかないとき
- 毎分（分欄に
*のみ）で登録しようとすると拒否されることがあります →*/5を使ってください - 実行頻度を極端に短くすると、サーバー側で設定が解除されることがあります
--no-debugが付いていないと、長時間集計でメモリ不足になることがあります- 設置パスやPHPパスが違うとコマンドが動きません。SSHが使える場合は同じコマンドを手動実行して確認できます
- PHPのバージョンがEC-CUBEの対応範囲（7.4〜8.3）外だと、分かりにくいエラーになることがあります。「言語バージョン設定」を確認してください
- ダッシュボードに「CRON（定期実行）が動いていない可能性があります」と表示された場合や、解決しない場合は、初期セットアップ の「うまく動かないときは」を参照してください
- 詳細は 集計されない も参照してください
