動作環境
Mac OS Catalina
Laravel 6.18.35
php 7.3.21
この記事について
自分がmacでlaravelの環境構築をする際にずいぶんエラーに悩まされたので、同じようにエラーに悩む人のために環境構築手順をまとめておきます。
インストール
はじめに
laravelのインストール手順に関しては二種類あって
- virtual machineを使う仮想間環境を用意する方法
- ローカルのホストに環境を用意する方法
この二種類があって公式からは前者が進められている
virtual machineを使う仮想間環境を用意する方法
ここでは詳細な説明は省きます。
詳しいやり方に関しては下記を参照してください。
https://laravel.com/docs/6.x/homestead#first-steps
ローカルのホストに環境を用意する方法
前提条件
前提条件として環境にこれらが必要です。
PHP >= 7.2.0
BCMath PHP Extension
Ctype PHP Extension
Fileinfo PHP extension
JSON PHP Extension
Mbstring PHP Extension
OpenSSL PHP Extension
PDO PHP Extension
Tokenizer PHP Extension
XML PHP Extension
phpのバージョン以外は特に大きくは気にしなくても大丈夫です。
インストール方法
①まずはcompoerをダウンロードする。
laravelをインストールする前にパッケージ管理ソフトである
composerをインストールする必要がある
- macの場合
homebrewで入るのでいつも通りhomebrewで入れましょう。
ターミナルで下記を実行する
brew install composer
homebrewがわからない人へ
下記の記事を参考にmacにhomebrewを入れましょう
今は特に何を入れているのか分からなくても問題ないです
https://qiita.com/zaburo/items/29fe23c1ceb6056109fd
- 他の場合
公式からダウンロードしていれてください
https://getcomposer.org
②次にlaravelを入れる
composerが入ったらcomposer経由でlaravelをインストールします
ターミナルで下記を実行する
composer global require "laravel/installer"
③ 最後に環境変数の設定、zprofileをいじる
ターミナルで実行する
echo "export PATH=~/.composer/vendor/bin:$PATH" >> ~/.zprofile
source ~/.zprofile
下記のコマンドで環境変数がきちんと設定されているか確認する
composer global about
開発の手順
これでlaravelがインストールされたので、開発が進めれます。
基本的にコマンドラインから実行していきます。
プロジェクトの作成
アプリを開発するディレクトリを
mkdir ディレクトリ名
これで作成できます
ディレクトリ名は好きにつけてokです
cd ディレクトリ名
これで作成したディレクトリに移動します
このディレクトリの中でアプリを開発していきます
下記のコマンドで
laravel new laravelapp
するとzip extentionがないと言われる。
macのcatalinaの場合これでは無理なので代わりに,composer経由で行う
composer create-project --prefer-dist laravel/laravel test_app
これでtest_appの部分をアプリ名にして実行する
公式では「laravel new アプリ名」でできるらしいんですけど、
どうにもmacのcatalinaではうまくいかないらしいです。
まだ解決策が見つかってないらしく外国の方が嘆いてました。
下記参照
https://github.com/laravel/framework/issues/30386
本題に戻ります。
次にこれをターミナルで実行して、ローカルサーバがたつか確認しましょう
cd test_app
php artisan serve
laravelのページを表示できれば成功
トラブルシューティング
まれにcomposerからでもlaravelを使えないことがあるみたいで、そういう場合はdockerを使うしかない。
下記に一番簡単なlaradockでの環境構築の方法を載せておく。
dockerでlaradockで環境構築する
これ見てやるとできる、laradock
https://www.techpit.jp/courses/laravel-line-bot/lectures/11539279
mkdir laravel-linebot
cd laravel-linebot
git clone https://github.com/Laradock/laradock.git
.envファイルを編集
APP_CODE_PATH_HOST=../laravel
DATA_PATH_HOST=../data
cd ~/laravel-linebot/laradock
docker-compose up -d workspace php-fpm nginx
docker-compose exec workspace composer create-project --prefer-dist laravel/laravel . "6.8.*"
参考記事
laravel公式ドキュメント
https://laravel.com/docs/6.x/installation
laravelコマンドで詰まった時に見た記事
https://qiita.com/endeavor/items/77f7017473c95c42fc29
https://iiiso.ti-da.net/e8647248.html