環境構築の流れ
後で説明しますが、LaravelをインストールするときはComposerというソフトを使用します。MAMP環境内でダウンロードを行う際、MAMPのPHPのバージョンを確認して、使用できるクラスなどを準備します。
なので、本項で作成したLaravelを、他の環境に移動して使用しようとするとPHPのバージョンの違いで動かないことがあります。
そう言った場合は、移動した先の環境下でcomposerの調整を行う必要が出てきますのでご注意ください。
LaravelのダウンロードとMAMPへ接続
まず、本カリキュラムではLaravelをインストールする際に、「Composer」というPHPのライブラリ依存性管理ソフトを使用するため、まずこちらをダウンロードします。
Composer(Laravelのパッケージ管理ソフト)のダウンロード
Composer
ダウンロードすることでさまざまな機能を実装することができる「パッケージ」という機能群があります。パッケージを使用することで、制作の高速化を図ることができます。
パッケージにもたくさんの種類があり、それらは「ライブラリ」と呼ばれる一つのまとまりになっています。また、そのライブラリも色々なメーカーや、種類ごとにまとまっていて様々なものが存在します。
例えば「便利そうなライブラリAを使用したい」という場面で、使い方を調べてみると「ライブラリAを使うにはライブラリBが必要であることが分かった…そしてライブラリBを使うには、Cが必要で…」というような、実装に手間がかかることがあります。
Composerを使用すると、「composer require ライブラリA」と入力するだけで、依存関係を考慮して必要なものをダウンロードしてくれます。
このように、ある一つのライブラリが必要な環境に、他のライブラリが必要になる場面で「他パッケージとの依存性」を「管理」して、必要なデータを選んでダウンロードを行なってくれます。
ダウンロード手順
では実際にComposerをインストールしましょう。
ターミナルで、以下のコマンドを入力してください。
curl -sS https://getcomposer.org/installer | php
次に、どの階層でもcomposerコマンドが使用できるように、パスを通します。mvコマンドを使用してこのファイルを移動して下さい。
sudo mv composer.phar /usr/local/bin/composer
試しに、コマンドが使用できるか試してみましょう。
以下のコマンドを入力して、Composerのバージョン確認をしてみて下さい。
composer -V
Composer version 2.0.9 2021-01-27 16:09:27
Laravelのダウンロード
では、Laravelをダウンロードしましょう。
始めにLaravelをダウンロードするディレクトリに移動します。下記のコマンドでMAMPの開発環境「/htdocs」に移動して下さい。
ターミナルで以下のコマンドを実行してください。
cd /Applications/MAMP/htdocs/
MAMP環境に移動したら、Laravel_CRUDというファイルを作成して、その中にLaravelをダウンロードしましょう。下記のコマンドでフォルダを作成、Laravel_CRUDフォルダ内に移動します。
mkdir Laravel_CRUD && cd Laravel_CRUD
フォルダに移動できたら、以下のコマンドでComposerを使用しLaravelをダウンロードします。
composer create-project laravel/laravel=5.5 Laravel
以上でダウンロード手順は終了です。
ダウンロードしたものを確認してみましょう
ターミナルだけで作業をしていたので、フォルダ内階層がどうなっている一度確認しましょう。FinderでMAMPの「/htdocs」フォルダ内を見てどのような構造になっているか確認してみてください。
Finderから「アプリケーション/MAMP/htdocs/」を開いて頂き、「Laravel_CRUDフォルダ」が作成されていて、中にLaravelフォルダが入っていれば大丈夫です。
LaravelをMAMPのデータベースに接続する
データベースの作成
まず、MAMPのデータベースに今回Laravelで使用するデータベースを作成します。MAMPの「WEBスタートページ」(MAMPを起動した状態で、ブラウザで「http://localhost:8888/MAMP/」)を開き、ヘッダーメニューから「TOOLS/PHPMYADMIN」を選択して下さい。
すると、このようなページが開きます。
このページでは、MAMP環境内のデータベースをGUIで表示したページで、クリック操作で「データベース作成」や「テーブルの確認」などを行ったり、SQL文を入力して「レコードの作成」などを行うことができます。
ただ、テーブル作成、レコードの挿入はLaravelからコマンド入力で行うことができるので、今回は「データベース作成」のみをこの画面から行います。
PHPMyAdminで以下の操作をしてください。
タブメニューの「データベース」を選んでください。
すると、データベースを作成する画面に切り替わります。
続けて、作成するデータベースの名前を入力します。今回は「Laravel_CRUD」というデータベースを作成し、Laravelでこのデータベースに接続しましょう。
「作成」をクリックすればデータベースが作成されます。
以上でデータベース作成完了です。
.envファイルの編集
次にLaravelでMAMPのデータベースに接続する設定を行います。
「.env」という、接続設定を行うファイルがあるのですが、「.」で始まるこのファイルは「隠しファイル」といい、アプリケーションの動作に関連する重要なファイル群のひとつです。
「隠しファイル」という名の通り、OSの初期搭載ソフトでは設定などを変更することなく、表示されないようになっています。
ショートカットコマンドで表示することができるので、入力してみましょう。
Finderでファイルを開いた状態で「command + shift + .(ドット)」を入力して下さい。
すると全ての階層で、半透明の「隠しファイル」が表示されるようになります。
先にも述べましたが、隠しファイルは重要なファイルなので、不必要に消したり、編集しない様に注意してください。
続けて、「.env」ファイルを開きましょう。
Finderで「アプリケーション/MAMP/htdocs/Laravel」を開いて下さい。
半透明のデータ「隠しファイル」の中に「.env」というファイルを確認できましたか？
今回編集するこの「.env」ファイルも「隠しファイル」で、中にはLaravelとデータベースを接続に関する設定が記載されています。
では、このファイルを編集していきましょう。
設定に関する記述が並んでいますが、記述の一部を、MAMPのデータベースに接続するように変更します。
書き換える内容は、MAMPの「WEBスタートページ」(MAMPを起動した状態で「http://localhost:8888/MAMP/」をご確認下さい)に記載のMySQL箇所に合わせます。
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret
上記箇所をMAMPのWEBスタートページのMySQL情報に記載されている内容に修正してください。
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=8889
DB_DATABASE=Laravel_CRUD
DB_USERNAME=root
DB_PASSWORD=root
DB_SOCKET=/Applications/MAMP/tmp/mysql/mysql.sock
・ご自身のMAMPのMySQL情報と同じ内容になっているか確認してください。
「DB_DATABASE」は、PHPMyAdminで作成したデータベース名にします。
これでLaravelのデータベースの設定は完了しました。
以上でMAMPでLaravel環境構築のセットアップは完了になります。お疲れ様でした。
ここからは、元のカリキュラムに戻って作業を進めて頂きますが、一部コマンド入力の階層が、元のカリキュラムと異なる箇所があるので、次のMAMPでLaravel環境構築(確認方法)のページもご確認下さい。
まとめ
- LaravelのダウンロードとMAMPへ接続
- Composer(Laravelのパッケージ管理ソフト)のダウンロード
- Laravelのダウンロード
- LaravelからMAMPのデータベースへ接続する