LinuxでLaravelを使ってアプリケーションを構築したいと考えている方へ、この記事では、Laravelを簡単にインストールするための手順を紹介します。初心者から上級者まで理解できるように、わかりやすく説明していきますので、ぜひ参考にしてください。
Laravelとは？
Laravel（ララベル）は、PHPで書かれたオープンソースのウェブアプリケーションフレームワークです。その優れた構造と豊富な機能から、多くのデベロッパーに愛用されています。コードが美しく、データベース管理や認証システムが内蔵されているため、開発者は効率的にアプリケーションを構築できます。
必要な環境設定
Laravelをインストールする前に、まずLinux環境に必要なソフトウェアを準備します。まず、以下の要件を確認してください。
- PHP 8.0以上: Laravel 9の最新バージョンを使用するにはPHP 8.0以上が必要です。
- Composer: PHPの依存関係を管理するためのツールです。
- Webサーバー: ApacheまたはNginxが推奨されます。
- データベース: MySQLまたはPostgreSQLなど。開発環境ではSQLiteを使用することも多いです。
PHPとComposerのインストール
最初に、PHPがインストールされているか確認し、必要に応じてインストールを行います。
PHPのインストール
sudo apt update
sudo apt install php php-cli php-mbstring php-xml php-zip php-curl
次に、PHPが正しくインストールされたかを確認します。
php -v
このコマンドでPHPのバージョンが表示されればインストール成功です。
Composerのインストール
Composerをインストールするには、以下の手順を実行します。
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
Composerのインストールを確認するには、次のコマンドを使用します。
composer -v
これで、Composerが正常に動作していれば準備完了です。
Laravelのインストール
以上の準備が整ったら、いよいよLaravelをインストールします。
新しいLaravelプロジェクトを作成する
Laravelをグローバルにインストールせず、直接プロジェクトを作成するのが一般的です。以下のコマンドを実行します。
composer create-project --prefer-dist laravel/laravel my_project
my_projectはプロジェクトのディレクトリ名です。任意の名前を指定してください。
環境設定の調整
インストールが完了したら、ディレクトリに移動し、環境設定を行います。
cd my_project
プロジェクトのルートには.envファイルがあります。ここでデータベース接続情報などの設定を行えます。デフォルトの設定を使う場合でも、必ずAPP_KEYを設定する必要があります。
php artisan key:generate
これにより、アプリケーションのセキュリティが強化されます。
サーバーの起動
Laravelが正しくインストールされると、内蔵の開発サーバーを利用してプロジェクトを手軽に起動できます。
php artisan serve
通常、http://127.0.0.1:8000にアクセスすることでブラウザでアプリケーションを確認できます。
その他の設定
データベース設定
.envファイルにアクセスし、以下のようにデータベースの接続設定を確認、もしくは修正します。
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
PHP拡張機能の確認
Laravelが提供する様々な機能を利用するために、必要なPHP拡張機能がインストールされているか確認しましょう。
sudo apt install php-mbstring php-xml php-gd php-curl php-zip
問題発生時のトラブルシューティング
インストール中または後に問題が発生した場合、以下の点を確認してください。
- PHP and Composerのバージョン: Laravelは特定のバージョンを必要とするため、最新のものを使用してください。
- フォルダの権限: Laravelのディレクトリに対する読み書き権限が正しく設定されているか確認します。
-
環境変数の確認:
.envファイルが正しく設定されているか確認します。
まとめ
以上、Linux環境でのLaravelインストール手順を詳しく紹介しました。この記事を参考にして、誰でも簡単にLaravelの環境を構築し、開発を始められることを願っています。新しいプロジェクトの構築を楽しく行いましょう！
コメント