Ticketix は、インストール用 ZIP パッケージから新しい空のフォルダーにインストールします。ブラウザベースのセットアップで、設定と最初の管理者アカウントが作成されます。
始める前に
- サーバー要件を確認します。
- Ticketix のインストール用 ZIP をパソコンに用意します。ライセンスメールのリンクからダウンロードしてください。新規インストールにアップデート用 ZIP を使用したり、既存のインストールにインストールパッケージを上書きアップロードしたりしないでください。
- 空の MySQL データベース(
utf8mb4)と、そのデータベースに対するすべての権限を持つデータベースユーザーを作成します。 - 公開アドレス(例:
https://support.example.comまたはhttps://support.example.com/ticketix)を決め、HTTPS で動作することを確認します。 - スマートフォンに認証アプリをインストールします。初回サインイン時に必要です。
ファイルをアップロードする
- インストール用 ZIP を、選んだアドレスの Web フォルダーに展開します。
- Web サーバーのユーザーがアプリケーションフォルダーと
storageフォルダーに書き込めることを確認してください。 - Nginx の場合は、動作要件に記載されたアクセスルールを追加してください。Apache の場合は、同梱の
.htaccessファイルがこれを行います。
セットアップを実行する
- 公開アドレスでセットアップページを開きます(例:
https://support.example.com/setup.php)。最終的なアドレスで開いてください。セットアップはこのアドレスをapp_urlとして保存します。 - 各フィールドを入力します:
| フィールド | 入力内容 |
|---|---|
| App Name | インターフェースとメールに表示される名前 |
| Default Language | English、Türkçe または العربية |
| Storage Root | ストレージフォルダー。ホストで別のパスが必要な場合を除き、提案された storage フォルダーのままにしてください |
| Support Email | 顧客に表示されるアドレス、および既定の送信元 |
| Mail Server Host | メールサーバーのホスト名 |
| ホスト、ポート、データベース名、データベースユーザー、データベースパスワード | データベース (MySQL) に入力する MySQL の接続情報 |
| Charset, Collation | 変更する理由がない限り utf8mb4 と utf8mb4_unicode_ci のままにしてください |
| Admin Name, Admin Email, Administrator password | 最初の管理者アカウント。パスワードは8文字以上必要です |
- Install Ticketix をクリックします。セットアップはデータベース接続をテストし、
config.phpを書き込み、テーブルと管理者アカウントを作成します。 - Installation completed. You can now log in. と表示されたら、Admin Login をクリックします。
Ticketix のインストール後は、setup.php を開いてもサインインページに移動するだけです。セットアップ画面では、インストール後に setup.php を削除することが推奨されます。Ticketix 2.0.2 以降、アップデート ZIP には setup.php が含まれないため、削除した setup.php がアップデートで復活することはありません。
config.php ファイルと app_url
セットアップは config.sample.php テンプレートから恒久的な config.php を作成します。このファイルには、データベースの接続情報、Ticketix が生成したシークレット(スケジュールタスク、ヘルスチェック、受信メール用)、および次の設定が含まれます:
| 設定 | デフォルト | 内容 |
|---|---|---|
app_url | セットアップを開いたアドレス | メール内のリンクに使われる公開アドレス(スケジュールタスクが送信するメールのリンクを含む) |
storage_root | storage フォルダー | 添付ファイル、ログ、セッション、ライセンスファイル、ai-secret.key |
auto_close_days | 7 | 保留中または回答済みのチケットが自動的にクローズされるまでの日数 |
invite_expiry_hours | 72 | 顧客招待リンクの有効期間 |
app_url は、サブフォルダーを含む完全な公開アドレスで、末尾のスラッシュは付けません:
'app_url' => 'https://support.example.com/ticketix',
後で Ticketix を別のアドレスに移動した場合は、config.php の app_url を変更してください。app_url が正しくないと、スケジュールタスクが送信するメール内のリンク(受信メールから作成されたチケットの確認メールなど)を開けません。
重要:
config.phpは絶対に公開せず、アップデート時に置き換えないでください。storageフォルダーと一緒にバックアップしてください。
初めてサインインする
管理者とエージェントは二要素認証を使用する必要があります。初回サインイン時に設定します:
/admin/でスタッフ用サインインページを開きます(例:https://support.example.com/admin/)。ページ名は Staff sign-in です。- Email or display name に管理者のメールアドレスを入力し、パスワード を入力して Sign in をクリックします。
- Ticketix で Set up two-factor authentication が開きます。認証アプリを開いてアカウントを追加し、QR コードをスキャンします。スキャンできない場合は、Cannot scan? Enter the setup key を開き、キーをアプリに入力してください。
- Six-digit code from the app と Current password を入力し、Turn on two-factor authentication をクリックします。
- Ticketix に Save your backup codes として10個のワンタイムコードが表示されます。パスワードマネージャーに保存してください。これらは一度しか表示されません。
セットアップコードの有効期間は10分です。期限が切れた場合は、Create a new setup code をクリックして新しい QR コードをスキャンしてください。
以降は、サインインのたびにパスワードの後で認証アプリのコードが求められます。二要素認証とパスワードのリセットをご覧ください。
インストール後
- アプリケーションフォルダーへの書き込み権限は、PHP の実行ユーザーに限定してください。お知らせ 画面からのアップデートでは PHP がアプリケーションファイルを書き込む必要があります。PHP が書き込めない場合は、アップデート ZIP を使って手動でアップデートしてください。
storageフォルダーは常に書き込み可能にしておく必要があります。Ticketix をアップデートするをご覧ください。 config.phpとstorageフォルダーを、アクセスが制限された場所へ定期的にバックアップしてください。storage/ai-secret.keyは、保存された AI プロバイダーキーと二要素認証の認証用シークレットを保護します。