Ubuntu 24.04にLaravel PHPフレームワークをインストールする方法

Laravelは、エンタープライズWebアプリケーションを構築するために使用されるPHPに基づいたWebアプリケーションフレームワークです。これは、モデル-ビュー-コントローラー（MVC）アーキテクチャに従い、Symfonyに基づいた無料でオープンなWebフレームワークです。クリーンなコードでアプリケーションを作成できるエレガントな構文を提供し、読みやすく理解しやすいです。

Laravelは、エンタープライズおよび堅牢なフルスタックWebアプリケーションを構築するためのエンタープライズグレードのWebフレームワークです。Laravelアプリケーションは、開発プロセスから本番環境まで、頭痛なしで迅速に提供できます。

このガイドでは、Ubuntu 24.04サーバーにLaravel Webフレームワークをインストールする方法を学びます。LAMPスタック（Linux、Apache、MySQL/MariaDB、およびPHP）とComposer PHPパッケージマネージャーを使用してLaravelをインストールします。

前提条件

このガイドを開始する前に、以下のものを用意してください：

Ubuntu 24.04サーバー。
管理者権限を持つ非ルートユーザー

LAMPスタックとComposerのインストール

Laravelは、現代のWeb開発のための人気のあるPHP Webフレームワークです。したがって、UbuntuサーバーにPHPやその他の依存関係がインストールされていることを確認する必要があります。このセクションでは、LAMPスタック（Linux、Apache、MySQL/MariaDB、およびPHP）とComposerを使用してLaravelをインストールします。

パッケージをインストールする前に、次のコマンドを実行してUbuntuリポジトリを更新します。

sudo apt update

update repo

次に、以下のコマンドを実行して、LAMPスタック（Linux、Apache、MySQL/MariaDB、およびPHP）、Composer、およびGitを含むLaravelの依存関係をインストールします。

sudo apt install apache2 mariadb-server php php-curl php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip composer git

インストールを続行するには、Yと入力します。

インストールが完了したら、ApacheとMariaDBのサービスステータスを確認します。次に、PHPとComposerのバージョンを確認します。

以下のコマンドでApacheサービスのステータスを確認します。UbuntuのデフォルトのApacheサービスは自動的に有効になり、実行されているはずです。

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

出力：

check apache2

次に、以下のコマンドを使用してMariaDBサービスを確認します。MariaDBサーバーは、Ubuntuシステムで有効になり、実行されているはずです。

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

出力：

check mariadb

最後に、以下のコマンドを使用してPHPとComposerのバージョンを確認します。システムにPHP 8.3とComposer 2.7.1がインストールされているのが表示されます。

php -v  
sudo -u www-data composer -v

check php and composer

オプション：Node.jsとNPM（Node.jsパッケージマネージャー）のインストール

Node.jsとNPMは、BladeやJavaScriptなどのテンプレートエンジンを使用してLaravelを使用する場合に必要です。このセクションでは、Ubuntuリポジトリを介してNode.jsとNPM（Node.jsパッケージマネージャー）を両方インストールします。

UbuntuシステムにNode.jsとNPMをインストールするには、次のコマンドを実行します。

sudo apt install nodejs npm

インストールを確認するにはYと入力します。

インストールが完了したら、以下のコマンドを入力してNode.jsとNPMのバージョンを確認します。

node --version  
npm --version

以下の出力は、Node.js 18とNPM 9.5がインストールされていることを示しています。

PHPの設定

Laravelを実行するには、fileinfo、mbstring、およびopensslなどのいくつかのPHP拡張機能が有効になっていることを確認する必要があります。したがって、’php.ini’ファイルを変更してこれらのPHP拡張機能を読み込みます。

nanoエディタを使用して、デフォルトのPHP設定ファイル’/etc/php/8.3/apache2/php.ini’を編集します。

sudo nano /etc/php/8.3/apache2/php.ini

以下の行のコメントを解除して、PHP拡張機能fileinfo、mbstring、opensslを有効にします。

extension=fileinfo  
extension=mbstring  
extension=openssl

ファイルを保存してエディタを終了します。

次に、以下のコマンドを実行してApacheサービスを再起動し、PHPの変更を適用します。

sudo systemctl restart apache2

次に、以下のコマンドでPHP拡張機能fileinfo、mbstring、opensslを確認します。これらの拡張機能が有効になっている場合、各拡張機能名が表示されます。

sudo php -m | grep 'fileinfo\|mbstring\|openssl'

setup php

さらに、PHPINFOを介して有効なPHP拡張機能のリストを確認できます。以下のコマンドで新しいPHPINFOファイルを作成します。

echo "" > /var/www/html/info.php

次に、http://192.168.5.30/info.phpにアクセスします。拡張機能fileinfo、mbstring、opensslが有効になっていることを確認します。

phpinfo

MariaDBサーバーの設定

PHPの設定が完了したら、MariaDBサーバーを保護し、Laravel用の新しいデータベースとユーザーを作成する必要があります。

以下の’mariadb-secure-installation’コマンドを実行してMariaDBサーバーを保護します。これで、MariaDBサーバーの設定が求められます。

sudo mariadb-secure-installation

プロンプトが表示されたら、Yを入力して新しい設定を適用するか、Nを入力して拒否します。

デフォルトのMariaDBインストールにはパスワードがありません。パスワードを求められたらENTERを押します。
次に、Yを入力してMariaDBのrootパスワードを設定します。その後、MariaDBの新しいパスワードを入力し、パスワードを繰り返します。
MariaDBインストールから匿名ユーザーを削除するにはYを入力します。
MariaDBのrootユーザーのリモートログインを無効にするように求められたら再度Yを入力します。
MariaDBからデフォルトのデータベースtestを削除するにはYを入力します。
最後に、テーブルの権限を再読み込みし、新しい変更を適用するにはYを入力します。

MariaDBサーバーを保護した後、Laravelプロジェクト用の新しいデータベースとユーザーを作成する必要があります。

以下のコマンドを使用してMariaDBサーバーにログインします。プロンプトが表示されたらMariaDBのrootパスワードを入力します。

sudo mariadb -u root -p

次に、以下のクエリを実行して新しいデータベースとユーザー’ laravelapp ‘を作成します。パスワードは’ password ‘です。

CREATE DATABASE laravelapp;  
CREATE USER laravelapp@localhost IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON laravelapp.* TO laravelapp@localhost;  
FLUSH PRIVILEGES;

creating database

次に、以下のクエリを実行してユーザー’ laravelapp ‘の権限を確認します。これにより、ユーザーがLaravelデータベース’ laravelapp ‘にアクセスできることが確認されます。

SHOW GRANTS FOR laravelapp@localhost;

最後に、quitと入力してMariaDBサーバーから退出します。

show privileges for user

Composerを介してLaravelをインストール

PHPを設定し、MySQL/MariaDBデータベースとユーザーを作成したので、Laravelをインストールできます。このセクションでは、プロジェクトディレクトリを設定し、Composerを介してLaravelをインストールし、LaravelをMySQL/MariaDBデータベースと統合します。

まず、以下のコマンドを実行して/var/www/.cache（Composerキャッシュ用）、/var/www/.config（追加のComposer設定用）、および/var/www/laravelapp（Laravelプロジェクト用）のディレクトリを作成します。

sudo mkdir -p /var/www/{.cache,.config,laravelapp}

次に、/var/www/.cache、/var/www/.config、および/var/www/laravelappディレクトリの所有権をユーザー’ www-data ‘に変更します。

sudo chown -R www-data:www-data /var/www/{.cache,.config,laravelapp}

次に、/var/www/laravelappディレクトリに移動し、以下のComposerコマンドを使用してLaravelをインストールします。

cd /var/www/laravelapp/  
sudo -u www-data composer create-project laravel/laravel .

Laravelのインストールは以下のように始まるはずです：

install Laravel via composer

次に、以下のnanoエディタコマンドを使用して’.env’ファイルを開きます。

nano .env

デフォルトの’ APP_URL ‘をローカルドメイン名に変更します。この例では、Laravelはドメイン’laravelapp.local’で実行されます。

APP_URL=http://laravelapp.local

デフォルトの’ DB_CONNECTION ‘を’ mysql ‘に変更し、コメントを解除してデータベースの詳細をあなたの情報に変更します。

DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravelapp  
DB_PASSWORD=password

ファイルを保存して終了します。

最後に、以下のコマンドを実行してLaravelプロジェクトのデータベースをマイグレーションします。

sudo -u www-data php artisan migrate

Laravelデータベースマイグレーションの出力：

Migrate database

Laravelのための仮想ホストの設定

このセクションでは、Laravelの仮想ホストファイルを設定します。Laravel開発用のローカルドメイン名を用意しておいてください。

仮想ホストを作成する前に、以下のコマンドでApacheの’ rewrite ‘モジュールを有効にします。

sudo a2enmod rewrite

nanoエディタを使用して新しい仮想ホスト設定’ /etc/apache2/sites-available/laravelapp.conf ‘を作成します。

sudo nano /etc/apache2/sites-available/laravelapp.conf

以下の設定を追加し、ServerNameオプションをLaravelドメイン名（例：’ laravelapp.local ‘）に変更します。

  
  
  ServerAdmin [email protected]  
  ServerName laravelapp.local  
  DocumentRoot /var/www/laravelapp/public  
  
    
    Options FollowSymLinks  
    AllowOverride None  
    
    
    AllowOverride All  
    
  
  ErrorLog ${APACHE_LOG_DIR}/error.log  
  CustomLog ${APACHE_LOG_DIR}/access.log combined

ファイルを保存してエディタを終了します。

次に、以下のコマンドを実行して’ laravelapp.conf ‘仮想ホストを有効にし、Apacheの構文を確認します。エラーがなければ、’ Syntax OK ‘という出力が表示されるはずです。

sudo a2ensite laravelapp.conf  
sudo apachectl configtest

新しいLaravel仮想ホストファイルを適用するためにApacheサービスを再起動します。Apacheが再起動した後、Laravelのインストールが完了します。

sudo systemctl restart apache2

setup apache vhost

Laravelプロジェクトへのアクセス

この時点で、’hosts’ファイルを介してLaravelインストールにアクセスする準備が整いました。

LinuxまたはMacOSユーザーは、’ /etc/hosts ‘ファイルをルート権限で変更します。Windowsユーザーは、’ C:\Windows\System32\drivers\etc\hosts ‘ファイルを管理者として開きます。

以下のように、UbuntuサーバーのIPアドレスの後にLaravelドメイン名を追加します。

192.168.5.30 laravelapp.local

ファイルを保存して終了します。

次に、ウェブブラウザでhttp://laravelapp.local/を訪問します。Laravelのインストールが成功していれば、以下のページが表示されるはずです。

Laravel app

結論

おめでとうございます！Ubuntu 24.04にLaravelのインストールが完了しました。LAMPスタック（Linux、Apache、MySQL/MariaDB、およびPHP）でLaravelが実行されており、プロジェクトを作成するための基本的なComposerコマンドを学びました。