インストール方法

Beginner guide

XServerへ設置する手順

ここでは、XServerの初期ドメインを使い、ほかのサイトへ影響しにくいサブディレクトリへ設置する例を案内します。公開URLは https://xsXXXXXX.xsrv.jp/qr-stamp-rally/ とします。xsXXXXXXの部分は、ご自身のサーバーIDへ読み替えてください。

1. 1

   設置するドメインを確認する

   XServerの公式サイトを開き、右上の「ログイン」から「サーバーパネル」を選びます。XServerアカウントIDまたはメールアドレスと、XServerアカウントIDパスワードを入力してログインしてください。

   

   

   

   PHPやキャッシュ等の設定画面では対象ドメインの一覧が表示されるため、xsXXXXXX.xsrv.jpの行を選んで設定します。別のドメインの行を変更しないでください。

2. 2

   PHP・SSL・キャッシュを確認する

   対象ドメインでPHP 8.3系を選び、display_errorsをOff、サーバーキャッシュをOFFにします。無料独自SSLとHTTPS転送を有効にし、https://で証明書エラーなくページを開けるまで待ちます。

   php.ini設定

   

   

   サーバーキャッシュ設定

   

   SSL設定とHTTPS転送

   

   

   SSL設定の反映には時間がかかります。設定後に、ブラウザでhttps://xsXXXXXX.xsrv.jp/を正しく開けない場合は、30分〜1時間ほど待ってから、もう一度確認してください。

3. 3

   ZIPを1ファイルのままアップロードする

   XServerの公式サイトを開き、右上の「ログイン」から「ファイルマネージャー」を選びます。FTPユーザーIDとFTPパスワードを入力してログインしてください。

   

   

   

   対象ドメインのpublic_htmlを開き、配布ZIPを展開せずにアップロードします。

   

   

   

   

4. 4

   ZIPを展開し、製品フォルダを配置する

   アップロードしたZIPをXServer上で展開します。同じ名前のフォルダが二重に作られますので、外側のフォルダ（public_html/qr-stamp-rally-0.1.x）を一時名へ変更します（例：public_html/qr-stamp-rally-0.1.x-tmp）。次に、内側の製品フォルダ（public_html/qr-stamp-rally-0.1.x-tmp/qr-stamp-rally-0.1.x）をpublic_html直下へコピーします。コピーした製品フォルダ（public_html/qr-stamp-rally-0.1.x）は、公開URLと同じqr-stamp-rallyへ名前を変更します。

   画像内のバージョン番号は撮影時点の例です。ダウンロードした配布ZIPのバージョン番号へ読み替えてください。

   ZIPを展開する

   

   

   二重フォルダを確認する

   

   外側フォルダを一時名へ変更する

   

   

   内側フォルダをpublic_htmlへコピーする

   

   

   

   

   コピーには30秒ほどかかる場合があります。画面が切り替わるまで、そのまま待ちます。

   

   コピーしたフォルダをqr-stamp-rallyへ変更する

   

   

   製品ファイルを確認する

   

   public_html/
   └── qr-stamp-rally/
       ├── INSTALL.md
       ├── VERSION
       ├── public/
       └── vendor/

   製品フォルダ内にINSTALL.md、VERSION、public、vendorがあることを確認します。隠しファイルを確認できる場合は、public_html/qr-stamp-rally/.htaccess、public_html/qr-stamp-rally/config/.htaccess、public_html/qr-stamp-rally/public/.htaccessがあることも確認します。

5. 5

   セットアップ画面を開く

   配置したフォルダ名に/installを付け、HTTPSで開きます。例は https://xsXXXXXX.xsrv.jp/qr-stamp-rally/install です。CSSが適用された画面と、インストールする製品バージョンが表示されることを確認します。

   

6. 6

   非公開領域と管理者情報を設定する

   「本番環境」、タイムゾーン、ベースURLを確認します。非公開領域はデフォルトでpublic_htmlの外側（非公開領域）のフォルダを指定してあります。環境診断の全項目がOKでしたら、管理者メールアドレスとパスワードを入力してインストールします。

   非公開領域を公開フォルダ内（public_html）へ置かないでください。設定、SQLite DB、ログ等をWebから取得されないようにするための保存先です。画面の候補が公開領域内を指す場合は、公開領域外のパスへ修正します。

   

   

7. 7

   復旧キーを保存し、動作を確認する

   完了画面に一度だけ表示される復旧キーを、PC上の安全な場所へ保存します。管理画面へログインし、イベント設定とスポット1件を登録します。QRコードをスマートフォンで確認しましょう。

   

   

   

   セットアップ画面が正常に開くまでは、サーバー上のZIPと展開用の一時フォルダを残してください。正常表示を確認した後に削除します。