Xserver ( レンタルサーバー ) に laravel 環境を構築してみた

今回構築する環境は Laravel 11 + Breeze ( React/TypeScript + Vite ) という環境を構築する方法を紹介します

使用した環境

今回使用したサーバーは sv16001.xserver.jp 以降のサーバーです
このサーバーでは Node.js の導入が比較的簡単に行えます

sv16001.xserver.jp 以降のサーバーのサービス仕様について │ エックスサーバー
https://www.xserver.ne.jp/spec_sv16001.php

sv16000.xserver.jp 以前のサーバー では新しいバージョンの Node.js が nodebrew では導入できません
この場合 unofficial-builds を使ってインストールする必要があります

Node.js unofficial-builds project - GitHub
https://github.com/nodejs/unofficial-builds

bashrc 作成

~/<ドメイン名>/deploy/<公開ドメイン名>/.bashrc にファイルを作成
( すでにあれば作成不要 )

export PATH=$HOME/<ドメイン名>/.bin:$PATH

export NODEBREW_ROOT=$HOME/<ドメイン名>/.bin/nodebrew
export PATH=$HOME/<ドメイン名>/.bin/nodebrew/current/bin:$PATH

php 8.3 導入

~/<ドメイン名>/.bin にディレクトリを作成
( すでにあれば作成不要 )

source ~/<ドメイン名>/deploy/<公開ドメイン名>/.bashrc
cd ~/<ドメイン名>/.bin/

ln -s /opt/php-8.3/bin/php .

Composer 導入

~/<ドメイン名>/.bin にディレクトリを作成
( すでにあれば作成不要 )

source ~/<ドメイン名>/deploy/<公開ドメイン名>/.bashrc
cd ~/<ドメイン名>/.bin/

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

mv composer.phar composer

nodebrew 導入

~/<ドメイン名>/.bin にディレクトリを作成
( すでにあれば作成不要 )

source ~/<ドメイン名>/deploy/<公開ドメイン名>/.bashrc
cd ~/<ドメイン名>/.bin/

export NODEBREW_ROOT=$HOME/<ドメイン名>/.bin/nodebrew
curl -L git.io/nodebrew | perl - setup

node 導入 ( nodebrew 導入済み )

source ~/<ドメイン名>/deploy/<公開ドメイン名>/.bashrc

nodebrew ls-remote

nodebrew install v22.11.0
nodebrew use v22.11.0

上記の例では nodebrew ls-remote で最新バージョンが v22.11.0 だったのでそちらをインストールしました
最新バージョンがリリースされていればそちらを使用する事をおすすめします

最後に

~/<ドメイン名>/deploy/<公開ドメイン名>/.bashrcの位置について「ちょっと変じゃない？」と思った方もいるかもしれません

私の場合 ~/<ドメイン名>/deploy/<公開ドメイン名>/ 以下にシェルスクリプトを記述しており
そのシェルスクリプトを実行することで公開に必要な一連の手順を一度に実行できるようにしています
( source を読み込み git pull をしてライブラリのインストールやマイグレーションビルドなど )

この方法を使えば Circle CI や Jenkins に自動で実行させることもできますし
他の方とスクリプトのパスを共有すれば決まった手順でデプロイできるので非常に便利です

そのためビルドに必要なファイルとしてこの場所に bashrc を配置しています