Debian 12にLaravelをインストールする方法

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

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

Laravel WebフレームワークをReactやVueなどの他のフレームワークと組み合わせることで、美しくインタラクティブなフロントエンドを作成できます。また、MySQL、PostgreSQL、SQLite、SQL Serverなど、複数のデータベースをサポートしています。Laravelは、安全な認証のためのスキャフォールディングも提供します。

このガイドでは、Debian 12にLaravelをステップバイステップでインストールする方法を示しますので、Laravelプロジェクトを始めることができます。Apache2 Webサーバー、MariaDB、およびPHP 8.2を使用してLaravelをインストールする方法を示します。

前提条件

以下は、このガイドに従うために必要な要件です：

• Debian 12サーバー。
• 管理者権限を持つ非ルートユーザー。

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

最初に行うべきステップは、DebianサーバーにLAMPスタック（Apache2、MariaDB、PHP）をインストールすることです。その後、Apache2とMariaDBサービスの両方を確認して、サービスが実行されていることを確認します。

パッケージをインストールする前に、apt updateコマンドを実行してDebianリポジトリを更新およびリフレッシュします。

sudo apt update

リポジトリが更新されたら、以下のapt installコマンドを実行してLAMPスタック（Apache2、PHP、MariaDB）パッケージをインストールします。以下のコマンドは、Laravelに必要なPHP拡張のいくつかもインストールします。

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

インストールを確認するためにyを入力します。

LAMPスタックがインストールされたら、以下のsystemctlコマンドを実行してapache2とmariadbサービスを確認します。サービスが実行されている場合、出力はactive (running)となります。

sudo systemctl status apache2  
sudo systemctl status mariadb

apache2サービスについては、次のような出力が得られるはずです：

以下はmariadbサービスのステータスです。

次に、以下のphpコマンドを実行してPHPのバージョンと有効なモジュールを確認します。PHP 8.2がインストールされており、curl、date、dom、exifなどのいくつかのモジュールが有効になっているはずです。

php -v  
php -m

最後に、Webブラウザを起動し、DebianサーバーのIPアドレス（例：http://192.168.10.15/）にアクセスします。インストールが成功した場合、Apache Webサーバーのindex.htmlページが表示されるはずです。

PHPの設定

Laravelをインストールするには、fileinfo、mbstring、opensslなどのいくつかのPHP拡張を有効にする必要があります。これらの拡張はphp.iniファイルを介して有効にできます。

以下のnanoエディタを使用してPHP設定ファイル/etc/php/8.2/apache2/php.iniを開きます。

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

以下の行のコメントを外して、fileinfo、mbstring、openssl拡張を有効にします。

extension=fileinfo  
extension=mbstring  
extension=openssl

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

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

sudo systemctl restart apache2

次に、以下のphpコマンドを実行してfileinfo、mbstring、opensslのPHP拡張が有効になっていることを確認します。

sudo php -m

次に、新しいphpinfoファイル/var/www/html/info.phpを以下のコマンドを使用して作成します。PHPとApache2 Webサーバーのインストールが成功していれば、これによりPHPインストールに関する詳細情報が表示されます。

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

好みのWebブラウザを開き、サーバーのIPアドレスにinfo.phpファイルのパスを続けて訪問します（例：http://192.168.10.15/info.php）。成功した場合、次のような出力が表示されるはずです：

MariaDBサーバーの設定

PHPの設定が完了したら、MariaDBサーバーの設定を行います。これには、mariadb-secure-installationユーティリティを介してMariaDBサーバーを保護し、新しいデータベースとユーザーをLaravelプロジェクト用に作成することが含まれます。

まず、以下のmariadb-secure-installationコマンドを実行してMariaDBサーバーのインストールを保護します。このプロセス中に、いくつかのMariaDB設定について尋ねられます。設定を確認するにはYを入力し、nはいいえを選択します。

sudo mariadb-secure-installation

以下は、プロセス中に尋ねられるいくつかのMariaDB設定です：

• MariaDBのrootパスワードを尋ねられたらENTERを押します。
• unix_socket認証方法について尋ねられたらnを入力します。
• MariaDBのrootユーザーの新しいパスワードを設定するためにYを入力します。次に、新しいパスワードを入力し、再度入力します。
• MariaDBからデフォルトの匿名ユーザーを削除するためにYを入力します。
• 次に、MariaDBのrootユーザーのリモートログインを無効にするために再度Yを入力します。
• MariaDBからデフォルトのデータベーステストを削除するためにYを入力します。
• 最後に、テーブルの権限を再読み込みして変更を適用するために再度Yを入力します。

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

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

sudo mariadb -u root -p

次に、以下のクエリを実行して新しいデータベースtestapp、ユーザーtestapp、およびパスワードpasswordを作成します。以下のクエリでパスワードを変更してください。

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

次に、以下のクエリを実行してユーザーtestappがデータベースtestappにアクセスできることを確認します。

SHOW GRANTS FOR testapp@localhost;

以下の出力は、ユーザーtestappがデータベースtestappにアクセスできることを確認します。

最後に、quitと入力してMariaDBサーバーから退出し、このステップを完了します。

Composerのインストール

Laravelは多くの方法でインストールできますが、最も簡単なのはPHPパッケージマネージャーであるComposerを介してインストールすることです。これから、DebianサーバーにComposerをインストールします。

Composer PHPパッケージマネージャーをインストールするには、以下のapt installコマンドを実行します。インストールを続行するように求められたらyと入力します。

sudo apt install composer

インストールが完了したら、以下のコマンドを実行してComposerのバイナリファイルを見つけ、Composerのバージョンを確認します。

which composer  
sudo -u www-data composer --version

Composerのバイナリファイルは/usr/bin/composerにあり、Composer 2.5.5がインストールされています。

最初のLaravelプロジェクトの作成

すべてが整ったので、最初のLaravelプロジェクトをインストールして作成する準備が整いました。MariaDBをデータベースとして使用して最初のLaravelプロジェクトを作成します。

まず、プロジェクト用の新しいドキュメントルートディレクトリ/var/www/testappを作成し、以下のコマンドを介して所有権をwww-dataユーザーに変更します。また、Composerによって使用される/var/www/.cacheおよび/var/www/.configディレクトリも作成します。

sudo mkdir -p /var/www/{.cache,.config,testapp}  
sudo chown -R www-data:www-data /var/www/{.cache,.config,testapp}

次に、/var/www/testapp/ディレクトリに移動し、以下のcomposerコマンドを実行して最初のLaravelプロジェクトを作成します。最初のLaravelプロジェクトは/var/www/testapp/ディレクトリに保存されます。

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

インストール中に、次のような出力が得られるはずです：

Laravelプロジェクトが作成されたら、次に.env設定ファイルを介してプロジェクトのデータベースを設定します。.envファイルは、Laravelプロジェクトの基本設定として使用されます。

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

nano .env

APP_URLパラメータをLaravelプロジェクトのローカルドメイン名に変更します。これにより、ローカルドメイン名を介してプロジェクトにアクセスできます。この場合、ドメイン名はtestapp.localです。

APP_URL=http://testapp.local

次に、データベース設定DB_CONNECTIONをmysqlに変更し、DB_DATABASE、DB_USERNAME、DB_PASSWORDの詳細をMariaDBデータベースとユーザーの詳細に変更します。

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

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

次に、以下のコマンドを実行してデータベースをマイグレーションします。これにより、Laravelプロジェクトのテーブルが作成されます。

sudo -u www-data php artisan migrate

Apache仮想ホストの設定

次のステップでは、Laravelプロジェクト用の新しいApache2仮想ホスト設定を作成します。その後、仮想ホストを有効にし、Apache2の設定を確認し、Apache2 Webサーバーを再起動して変更を適用します。

Laravel用のApache2仮想ホスト設定を作成する前に、以下のコマンドを介してApache2でrewriteモジュールを有効にする必要があります。

sudo a2enmod rewrite

以下のnanoエディタコマンドを使用してApache2仮想ホスト設定/etc/apache2/sites-available/laravel.confを作成します。

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

以下の設定を挿入し、ServerNameパラメータをドメイン名に変更します。

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

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

次に、以下のコマンドを実行して仮想ホスト設定laravel.confを有効にし、Apache2の設定を確認します。適切な設定が行われていれば、Syntax OKというメッセージが表示されるはずです。

sudo a2ensite laravel.conf  
sudo apachectl configtest

最後に、以下のコマンドを実行してapache2サービスを再起動し、行った変更を適用します。

sudo systemctl restart apache2

Laravelへのアクセス

Linuxクライアントを使用している場合は、以下のnanoエディタコマンドを介して/etc/hostsファイルを修正します。

sudo nano /etc/hosts

Windowsマシンを使用している場合は、C:\Windows\System32\drivers\etc\hostsファイルを修正します。

Laravelプロジェクトのドメイン名とDebianサーバーのIPアドレスを以下のように挿入します：

192.168.10.15   testapp.local

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

最後に、Webブラウザを起動し、Laravelプロジェクトのローカルドメイン名（例：http://testapp.local）にアクセスします。成功した場合、次のようなLaravelのページが表示されるはずです：

結論

結論として、Debian 12サーバーにLAMPスタック（Apache2、MariaDB、PHP）を使用してLaravelをインストールしました。また、PHPパッケージマネージャーであるComposerもインストールし、Laravelのインストールメディアとして使用しました。このことを考慮に入れると、Laravel Webフレームワークを使用してアプリケーションを開発し、MariaDBをアプリケーションのデータベースとして使用できるようになります。