シン・VPSにLaravelアプリをデプロイする方法！アプリイメージで簡単に環境構築

本ページはプロモーションが含まれています

今回はシン・VPSを使ってLaravelアプリのデプロイ作業を行っていきます。

一からOS、ミドルウェアをインストールしても良いのですが、シン・VPSにはLaravel環境を簡単に構築できるアプリイメージが用意されていますので、そちらを使ってさくっとデプロイしていきます。

デプロイするLaravelアプリの環境

今回デプロイするLaravelアプリの環境は以下の通りです。

シン・VPSのLaravelアプリイメージを使う場合、WebサーバーはApacheとなりますので、手元の環境でNginxなど他のWebサーバーを使っている場合はアプリイメージを使わない方法でシン・VPSの環境構築をするか手元の環境をApacheに合わせることをおすすめします。

今回デプロイするLaravelアプリはこちらです。

シン・VPSにLaravelアプリをデプロイする流れ

シン・VPSにLaravelアプリをデプロイする大まかな流れは以下の通りです。

アプリイメージを使うとApacheやMySQL（MariaDB）等のミドルウェアを含め、Composerもインストールしてくれているので、こちらで行うのはLaravelプロジェクトファイルのアップロードと環境設定だけでOKです。

シン・VPSのLaravelアプリイメージを使って環境を構築する

さっそくデプロイ作業を行っていきます。

まずはシン・VPSのアプリイメージを使ってLaravel環境を作っていきます。

シン・VPSに申し込む

まだシン・VPSを契約していない方は、シン・VPSの公式サイトから申し込み手続きをします。

公式サイトの「お申し込みはこちら」をクリックしてください。

すでにシン・VPSをお申し込み済みの方はOS再インストールからLaravelアプリイメージを使用してください。

OS再インストールを行うと運用中のサーバーは一度リセットされてしまいます。申し込んでいるサーバーで別のアプリケーションを運用中の方は新しくサーバーを追加申し込みしてください。

すでにXserverアカウントを持っている方は「ログイン」、初めて申し込む方は「すぐにスタート！新規お申込み」をクリックしてください。

申し込みフォームが表示されます。

お客様情報を入力する

シン・アカウントを作成するために、お客様情報を入力します。

必要項目を入力しましょう。

入力が完了したら、「次へ進む」をクリックしてください。

続いて、本人認証のために確認コードがメールで送られます。

メールを確認して、確認コードを入力しましょう。

最後に入力内容を確認して、問題がなければ「この内容で登録しサーバー申し込みへ進む」をクリックします。

これでシン・アカウントの作成は完了です。

お申し込み内容を入力する

続いて、VPSの申し込みをします。

こちらも必要項目を入力していきます。

「イメージタイプ」に「アプリケション」→「Laravel」を選択します。

入力が完了したら、「お申し込み内容を確認する」をクリックしてください。

確認画面で申し込み内容を確認します。

問題がなければ、「お支払いへ進む」をクリックしてください。

お支払い情報を入力する

支払い設定を行います。

シン・VPSではクレジットカード払いのみ対応しています。

「決済画面へ進む」をクリックします。

クレジットカード情報を入力して、「確認画面へ進む」をクリックしてください。

内容を確認して、問題がなければ「支払いをする」をクリックしてください。

これでシン・VPSの申し込みは完了です。

シン・VPSのLaravelアプリイメージでインストールしたサーバー環境

申込後しばらくするとLaravel環境のサーバーが立ち上げられます。

インストールされたLaravel環境は以下の通りです。（2024/1/15時点）

手元の環境と若干バージョンの差異がありますが、問題なく動作しました。

PHPのバージョンを合わせる【必要な方だけ】

シン・VPSにインストールされているPHPのバージョンはLaravel10.x系に合わせて8.2.xとなっています。（2024/1/15時点）

手元のLaravelプロジェクトのバージョンが8.xや7.xとなっている場合、プロジェクトファイルをそのままアップロードしてもPHPバージョンが対応していないとエラーが出てしまう可能性があります。

手元のLaravelプロジェクトに合わせて、シン・VPSのPHPバージョンを合わせておきましょう。

お使いのSSH接続ツールを使って、シン・VPSにSSH接続してください。

シン・VPSにインストールされているOSがUbuntuなのでaptを使います。

インストールするPHPのバージョンはご自身の環境に合わせて書き換えてください。

パッケージを更新します。

sudo apt update

PHPのバージョン7.4をインストールします。

ApacheにPHPモジュールを結合するため、libapache2-mod-phpオプションをつけています。

sudo apt install php7.4 libapache2-mod-php

インストールしたPHP7.4を有効化します。

sudo a2enmod php7.4

念の為適用されていたPHP8.2を無効化しておきます。

sudo a2dismod php8.2

Apacheを再起動します。

sudo systemctl restart apache2

これでPHPのバージョンを変更できたと思います。

Node.jsのバージョンを合わせる

OS標準で入っているNode.jsは少し古い場合がありますので、プロジェクトでNode.jsを使用している方はこちらもインストールしておきます。

Nodeのバージョン管理ツールとして、今回はVoltaを使用します。

Voltaをインストール

公式サイトに従ってVoltaをインストールします。

sudo curl https://get.volta.sh | bash

以下のメッセージが表示されるとセットアップ完了です。

success: Setup complete. Open a new terminal to start using Volta!

一度ターミナルを開き直し、Voltaコマンドを実行してみます。

volta

無事にVoltaをインストールすることができました。

Volta 1.1.1
The JavaScript Launcher ⚡

バージョンを指定してNode.jsをインストール

バージョン指定してNode.jsをインストールするには、installオプションにnode@バージョン番号を付けてください。

volta install node@14

無事にバージョン14.x.xのNode.jsをインストールすることができました。

installed and set node@14.21.3 (with npm@6.14.18) as default

Laravelのプロジェクトファイルをシン・VPSにアップロード

ここまででサーバーのセットアップは完了したので、アプリケーションファイルをサーバーにアップロードしていきます。

今回はCyberduckを使ってファイルをアップロードします。

Githubでソースコードを管理している場合はそのままgit cloneしても構いません。
その場合、依存パッケージのインストール作業（composer installやnpm install）を忘れずに行ってください。

SFTPツールでVPSに接続

Cyberduckの新規接続からSFTP接続してください。

「Laravel」フォルダを削除

「/var/www/html/」に移動します。

アプリイメージでインストールした際に作成されたLaravelアプリのファイルは必要ありませんので削除します。

Laravelプロジェクトをアップロード

同じ階層に手元のLaravelプロジェクトファイルをアップロードしてください。

環境設定

プロジェクトファイルがアップロードできたら環境設定を行っていきます。

ドキュメントルートの変更

デフォルトではドキュメントルートに「/var/www/html/laravel/public/」が設定されています。

「laravel」の部分をアップロードしたプロジェクトファイル名に変更していきます。

SSH接続して設定ファイルを開きます。

vi ../etc/apache2/sites-available/000-default.conf

DocumentRoot ディレクティブのパスをアップロードしたLaravelアプリのものに書き換えます。

「esc」を押して編集モードを解除し、下記コマンドで保存してください。

:wq

Apacheを再起動します。

sudo systemctl restart apache2

storageファイルのパーミッションを変更

Laravelのアプリディレクトリに移動します。

cd ../var/www/html/{アップロードしたLaravelアプリのディレクトリ名}

以下のコマンドを実行してstrage等のディレクトリの権限を755にします。

chmod 757 bootstrap/cache
chmod 757 storage/app/public
chmod 757 storage/framework/cache
chmod 757 storage/framework/sessions
chmod 757 storage/framework/views
chmod 757 storage/logs

envファイルの修正

.envファイルのアプリ設定を修正します。

エディタで編集してSFTPでアップロードしても良いですし、そのままvimで編集しても構いません。

APP_NAME=(プロジェクトの名前)
APP_ENV=production
APP_KEY=
APP_DEBUG=false

APP_KEYは後ほど生成するので空のままにしておきましょう。

データベース接続設定

続いて、.envにデータベース接続の設定を編集します。

データベース自体はアプリイメージでインストールした際に自動で構築されています。

DB_CONNECTION=mysql
DB_HOST=(データベースホスト)
DB_PORT=3306
DB_DATABASE=(データベース名）
DB_USERNAME=(ユーザ名）
DB_PASSWORD=(パスワード）

接続先のデータベース情報はSSH接続した際に表示されます。

アプリイメージで作成したLaravel環境のMySQLにはrootユーザーに加えて、「laravel」というユーザーが作成されています。SSH接続時に「laravel」ユーザーのパスワードも表示されています。

APP_KEYの生成

APP KEYを作成します。

php artisan key:generate

データベース構築

接続したデータベースにmigrateを実行します。

php artisan migrate

ブラウザで確認

無事にアプリが立ち上がっているかブラウザで確認してみます。

無事にブラウザにLaravelをアプリを表示させることができました。

これでデプロイ作業は終了です。

まとめ

今回はシン・VPSを使ってLaravelアプリをデプロイしてみました。

VPSにLaravel環境を構築するとなると、OSからWebサーバー、データベースなど各種ミドルウェアを1つづつインストールする必要がありますが、シン・VPSにはLaravelのアプリイメージが用意されているので、それらの工程を省くことができました。

料金も512MBの最小プランだとかなり安いので小規模開発や学習用途には使い勝手の良いVPSだと感じます。

今回の記事が少しでも誰かの役に立てれば幸いです。

あわせて読みたい

Xserver VPSにLaravelアプリをデプロイする方法！アプリイメージで簡単に環境構築 今回はXserver VPSを使ってLaravelアプリのデプロイ作業を行っていきます。 一からOS、ミドルウェアをインストールしても良いのですが、Xserver VPSにはLaravel環境を簡…