05. [Laravel] Mac OS - 라라벨 설치하기

laravel 설치 방법은 공식 홈페이지에 상세하게 나와있습니다.

https://laravel.kr/docs/8.x/valet

Mac OS를 사용하는 경우 valet이라는 좋은 개발환경이 있습니다. 

 

Valet 설치하기

먼저 homebrew를 설치해야 합니다.

homebrew를 설치하셨거나 원래 있으시다면 먼저 업데이트를 해줍니다.

brew update

 

그다음 설치해야 할 프로그램을 찾아줍니다.

brew search php

 

원하는 버전의 php를 install 합니다.

brew install php@7.4

---

composer 설치

composer를 설치합니다.

설치방법 참고는 공식문서를 참고했습니다.

https://getcomposer.org/download/

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

 

설치가 완료되었습니다.

All settings correct for using Composer
Downloading...

Composer (version 2.2.6) successfully installed to: /Users/pples/composer.phar
Use it: php composer.phar

 

현재는 composer를 실행시키려면 composer.phar 명령어를 입력해야 합니다.

간편하게 composer 명령어 만으로도 실행시킬 수 있게 하기 위해 PATH 디렉터리로 composer 파일을 이동시킵니다.

sudo mv composer.phar /usr/local/bin/composer

---

laravel 설치하기

laravel installer 설치하기

composer global require "laravel/installer"

 

설치가 완료했다면 laravel이 어디서든 실행될 수 있도록 PATH를 설정해줘야 합니다.

편집 에디터를 이용하여 bash_profile 파일을 열고 아래 코드를 추가합니다.

export PATH="$PATH:$HOME/.composer/vendor/bin"

 

만약 터미널이 bash가 아닌 zsh라면 .bash_profile이 아닌 .zshrc 라는 파일에 경로를 입력해야 합니다.

터미널을 변경하고 싶다면 아래 코드를 참고합니다.

$ cat /etc/shells

/bin/bash
/bin/csh
/bin/dash
/bin/ksh
/bin/sh
/bin/tcsh
/bin/zsh

$ chsh -s /bin/bash

cat /etc/shells : 사용 가능한 셸의 종류를 찾습니다.

chsh -s /bin/bash : bash를 기본값으로 변경합니다.

 

 

경로를 추가했다면 source 명령어를 통해 .bash_profile을 적용해줍니다.

source ~/.bash_profile

 

그리고 설정이 잘 되었는지 아래 코드로 확인합니다.

$ laravel

에러가 나지 않는다면 제대로 설정된 것입니다.

Laravel Installer 4.2.10

Usage:
  command [options] [arguments]

Options:
  -h, --help            Display help for the given command. When no command is given display help for the list command
  -q, --quiet           Do not output any message
  -V, --version         Display this application version
      --ansi|--no-ansi  Force (or disable --no-ansi) ANSI output
  -n, --no-interaction  Do not ask any interactive question
  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Available commands:
  completion  Dump the shell completion script
  help        Display help for a command
  list        List commands
  new         Create a new Laravel application

 

 

laravel project를 만들 위치로 이동하여 아래 명령어를 입력합니다. (8 버전을 설치)

composer create-project --prefer-dist laravel/laravel="8.*" myapp

 

설치를 마쳤으면 laravel project가 잘 실행되는 확인하기 위하여 해당 프로젝트 폴더로 이동합니다.

cd myapp

 

웹서버를 실행합니다.

php artisan serve

 

터미널에 표시된 주소로 접속해 봅니다.

Starting Laravel development server: http://127.0.0.1:8000

 

웹 페이지로 잘 접속이 된다면 로컬 개발환경 구축은 이것으로 마무리입니다.

---

valet 설치하기

한 가지를 추가하자면 valet 정도는 설치해주는 게 좋습니다.

매번 터미널을 통해 프로젝트 폴더에 들어가서 php artisan serve 명령을 수행하는 수고로움을 덜어주기 때문입니다.

composer global require laravel/valet
valet install

* composer 명령을 통해 valet 설치를 할 때 PHP 버전이 laravel 설치 당시의 PHP 버전과 맞지 않으면 오류 발생

 

valet 설치가 잘 되었고 명령이 잘 실행되는지 확인해 봅니다.

터미널에서 valet 명령을 실행했을 때 아래와 같은 오류가 뜬다면 path에 valet 설치 폴더의 위치가 추가되었는지 확인해봅니다.

$ valet
-bash : valet: command not found

 

macos의 PATH 설정 파일은 /etc/paths 입니다. vi로 열어 확인해봅니다.

valet 설치 폴더가 추가되어 있지 않다면 터미널에서 아래 명령으로 추가해줍니다.

export PATH=$PATH:~/.composr/vendor/bin

또는 vi 편집기로 paths 파일을 열어 맨 아래줄에 해당 폴더만 추가해주고 터미널에서 source /etc/paths 를 실행해주어도 됩니다.

 

설치를 성공적으로 마쳤다면 터미널에서 valet 명령을 실행하면 옵션 리스트를 보여줄 것입니다.

이제 laravel 프로젝트 폴더들을 넣어둔 상위 폴더로 이동하여 아래의 명령을 실행해 줍니다.

valet part

This directory has been added to Valet's paths.

라는 성공 메시지를 띄워줬다면 해당 폴더에 위치한 laravel 프로젝트들은 이제 브라우저에서 도메인으로 접속이 가능해집니다.

http://[프로젝트_폴더이름].test

저는 http://myapp.test 로됩니다.

/etc/hosts 파일을 수정해주지 않아도 되니까 편리하죠?

 

valet이 설치되었다면 도메인뿐만 아니라 로컬 개발환경에서 https 접속도 쉽게 설정이 가능합니다.

valet secure [프로젝트_폴더이름]

https로 접속하길 원하는 프로젝트 폴더를 지정하여 valet secure 명령을 실행해주면 됩니다.

접속 후 인증서를 확인해보면 laravel에서 발급해준 인증서를 확인할 수 있습니다.

 

개발을 하다가 MAMP나 XAMPP 등 다른 APM을 띄어야 할 때는 valet을 중지할 필요가 있습니다.

valet을 중지할 때는 아래 명령어를 입력합니다.

valet stop