サーバー構成

OS: CentOS Stream8
Nginx: 1.20.2
PHP: 8.1.5
MariaDB: 10.3.28
Laravel: 9.9.0

概要

本シリーズは、VPS上に構築したCentOSに、IT資産管理ツールを構築することを最終目的としています。
IT資産管理ツールのUIは、Laravelの管理画面ライブラリである「Laravel-admin」を使用する予定です。
前回の記事では、NginxとPHPのインストールをしました。
今回は、MariaDBとLaravelのインストール手順を説明していきます。

MariaDBをインストールする

MariaDBをインストール

MariaDB、Composerのインストールは下記サイトが参考になりました。

sudo dnf -y install mariadb-server
sudo systemctl enable mariadb
sudo systemctl start mariadb
# 下記コマンドを実行するとDBのセットアップが始まります。
sudo mysql_secure_installation

Enter current password for root (enter for none): 
#空欄のままEnterキー

Set root password? [Y/n]
# yを押してEnter
# rootユーザーのパスワードを設定します。
# あとで使用するので控えておいてください。

あとはすべてyを押してEnterキーでOKです。

開発用データベースとユーザーの作成

MariaDBのコンソールにログインします。

mysql -u root -p
#さきほど設定したrootユーザーのパスワードを入力します。

# データベース作成（「laravel」という名前のデータベースを作成します。）
craete database laravel;

# ユーザー作成（「dev」という名前のユーザーを作成します。）
# パスワードは伏字にしています。
create user 'dev'@'localhost' identified by '********';

# データベース「laravel」へのアクセス権（全権）を付与
grant all on laravel.* to 'dev'@'localhost';

Laravelをインストールする

Composerをインストール

事前に、Composer公式サイトを参考にComposerをインストールします。
※インストールコマンドはバージョンによって異なるので必ず公式サイトを確認してください。

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
chmod a+x ./composer.phar
sudo mv composer.phar /usr/local/bin/composer

rootユーザー以外で「sudo composer」を実行できるようにします。

sudo visudo

以下の項目を書き換えます。

# :/usr/local/bin を追記
Defaults    secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin

Ecsキー→「:wq」と入力→Enterキーで上書き保存します。

Laravelをインストール（Laravelプロジェクトを作成）

本記事では、公開ディレクトリにLaravelプロジェクトを作成することにします。

# プロジェクトを作成するディレクトリに移動
cd /var/www/html/example.jp

# 「laravel-admin」という名前のプロジェクトを作成（「laravel-admin」ディレクトリが作成されます）
composer create-project laravel/laravel --prefer-dist laravel-admin

Nginxの設定を変更

このままだとトップページ以外が404エラーになってしまうので、
公開ディレクトリに関する記述等を書き換えます。
下記サイトが参考になりました。

/etc/nginx/conf.d/default.conf

server {
    listen 80;
    server_name example.jp;
    root   /var/www/html/example.jp/laravel-admin/public;
    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass   unix:/var/run/php-fpm/www.sock;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME /var/www/html/example.jp/laravel-admin/public$fastcgi_script_name;
        include        fastcgi_params;
    }
}

Nginxを再起動します。

sudo systemctl restart nginx

パーミッション等の設定

このままではパーミッションエラーが表示されるので各種ディレクトリのパーミッション設定を変更します。
下記サイトが参考になりました。

まず前提として、下記ユーザーが存在しています。

dev: 開発用ユーザー（VSCodeでSSH接続しているのはこのユーザー）
nginx: Webサーバーの実行ユーザー

下記コマンドを打ち込みます。

# Laravel用のグループを作成
sudo groupadd laravel

# 作成したグループにユーザー「dev」、「nginx」を参加させる
sudo gpasswd -a dev laravel
sudo gpasswd -a nginx laravel

# Laravelプロジェクトに移動
cd /var/www/html/example.jp/laravel-admin

# 配下のディレクトリ、ファイルのパーミッションを一括変更
sudo find ./ -type d -exec chmod 755 {} \;
sudo find ./ -type f -exec chmod 644 {} \;

# 所有グループを変更（これでエラーが修正される）
sudo chown -R :laravel ./storage
sudo chown -R :laravel ./bootstrap/cache

# 既存のディレクトリのパーミッションを一括変更
sudo find ./storage -type d -exec chmod 775 {} \;
sudo find ./storage -type f -exec chmod 664 {} \;
sudo find ./bootstrap/cache -type d -exec chmod 775 {} \;
sudo find ./bootstrap/cache -type f -exec chmod 664 {} \;

# SGIDを設定
# 今後作成されるファイルやディレクトリの所有グループがlaravelになるようにする
sudo find ./storage -type d -exec chmod g+s {} \;
sudo find ./bootstrap/cache -type d -exec chmod g+s {} \;

# ACLデフォルト設定を変更
# 今後作成されるファイルやディレクトリのパーミッションが、ファイル：664、ディレクトリ：775になる
sudo setfacl -R -d -m g::rwx ./storage
sudo setfacl -R -d -m g::rwx ./bootstrap/cache

# サーバー再起動
sudo shutdown -r now

動作確認

ブラウザでドメインにアクセスし下記画面が表示されたらインストールは成功です。

参考サイト

CentOS+NginxでLaravelを動かすまで（サーバー構築） | Reuhul tech memo
Composer
nginx + Laravel でホーム以外のページの404エラー解決 - Qiita
Laravelプロジェクトを本番サーバーで公開する時、Permission deniedでハマったら - バックエンドとフロントエンドを行き来するWEBプログラマ―のメモ帳
 CentOS/Apache/Laravel使用時のpermission設定方法 - Qiita

[Laravel-adminを導入しよう！その3] CentOS Stream8にLaravel9（PHP8、Nginx、MariaDB）をインストールする