Laravel - 로컬개발 환경설정 (Homestead with VirtualBox)

---

2025.1.24 라라벨 개발은 Herd 또는 docker DeskTop 을 이용하는걸 추천한다. 

2023.12.24 VirtualBox apple silicon M1,M2,M3 를 지원하고 있지 않다.
유료버전 Paralles 버전은 설치가능하다.

 

개인PC 에 가상화 프로그램을 설치해야 한다.

VirtualBox 또는 Paraelles 를 PC 또는 Mac에 설치하다. (설명은 Mac 기준)

 

VirtualBox 또는 Paralles 에 라라벨 개발 환경을 구축하기 위해서는 OS, webserver, php, db 등을 개별적으로  설치해야 한다.

가상화로 개발을 진행하는 이유는, 이러한 노력을 간단하게 해결하기 위해서다.

---

라라벨에서 제공하는 개발환경 패키지

• Laravel Homestead
• Laravel Sail
• Laravel Valet

 

가상화에 미리 만들어 놓은 설정 파일을 불러오기만 하면 된다. 원하는 환경을 언제든지 동일하게 만들 수 있다.

이런 가상화를 쉽게 다루기 위한 툴이 vagrant 이다.

vagrant 에서 설정 파일을 세팅하고 시작만 하면 자동으로 가상화 프로그램에 자동으로 올라간다.

 

라라벨에서는 이런 설정 파일을 homestead 라고 미리 정리해 두었다.

따라서 사용자는 가상화 프로그램과 vagrant 를 설치하고 homestead 를 다운받아 vagrant 로 시작만 시키면 된다.

---

가상화 프로그램 설치

https://www.virtualbox.org/wiki/Downloads

https://www.parallels.com/products/desktop/

---

Vagrant 설치

개발환경을 구축할 수 있는 CLI 기반 도구

 

vagrant 가 지원하는 가상화툴

• VirtualBox
• VMware
• KVM
• Linux Container (LXC)
• Docker

Mac에 homebrew 를 이용해서 설치

brew install vagrant

vagrant 는 Vagrantfile 파일을 확인하고 설정한 내용을 가상화 프로그램에 런칭시켜준다.
Vagrantfile 이 없다면, vagrant init  명령어로 만들수 있다.

 

---

Laravel Homestead 다운로드

Laravel 에 제공하는 미리 설정된 파일을 다운로드 할것이다.

git clone https://github.com/laravel/homestead.git ~/Homestead

cd ~/homestead

git checkout release

# 버전
git checkout tags/v14.2.2 -b v14.2.2

~/homestead 폴더로 이동해서 다음 명령어를 실행시킨다.

 

Homestead.yaml 파일 생성하기

bash init.sh

 

Homestead.yaml 원하는 설정으로 수정.

ip: "192.168.56.56"
memory: 2048
cpus: 2
provider: virtualbox

authorize: ~/.ssh/id_rsa.pub

keys:
    - ~/.ssh/id_rsa

folders:
    - map: ~/code
      to: /home/vagrant/code

sites:
    - map: homestead.test
      to: /home/vagrant/code/public

databases:
    - homestead

features:
    - mysql: true
    - mariadb: false
    - postgresql: false
    - ohmyzsh: false
    - webdriver: false

services:
    - enabled:
          - "mysql"
#    - disabled:
#        - "postgresql@11-main"

#ports:
#    - send: 33060 # MySQL/MariaDB
#      to: 3306
#    - send: 4040
#      to: 4040
#    - send: 54320 # PostgreSQL
#      to: 5432
#    - send: 8025 # Mailhog
#      to: 8025
#    - send: 9600
#      to: 9600
#    - send: 27017
#      to: 27017

provider: VirtualBox 설정을 변경하면 다른 가상화 프로그램으로 변경가능하다.

 

Laravel Project 생성하기

cd ~

laravel new code

 

 

Virtual Box 에 올리기

vagrant up

 

 

자동으로 Virtual Box에 추가된 모습이다.

 

웹브라우져에서 확인하기

192.168.56.56

 

주소로 접속하기 위해서

/etc/hosts 파일 수정

sudo vi /etc/hosts

192.168.56.56 homestead.test

위의 내용 추가

 

 

터미널로 가상화에 접속하기

ssh 접속할려면 Key 를 생성해줘야 한다.

ssh-keygen -t rsa -C “your_email@example.com”

Enter 만 계속 눌러서 생성한다.

 

vagrant ssh

바로 접속 된다.

 

 

phpMyAdmin 설치하기

public 폴더에 복사

 

기본 계정 정보

root, secret
homestead, secret

 

 

Vagrant && Laravel Homestead

아래 내용은 Vagrant 에서 검색하고 원하는 설정을 다운받아 가상화 프로그램을 런칭하는 방법이다.

 

Vagrant Cloud 에서 laravel 로 검색하고 laravel/homestead 를 설치.

https://laravel.com/docs/10.x/homestead 

Laravel - The PHP Framework For Web Artisans

 

라라벨 홈스테드 설치하기

Vagrant Cloud 에서 Laraval Homestead 를 검색한다.

https://app.vagrantup.com/boxes/search

Vagrant Cloud by HashiCorp

 

검색결과

https://app.vagrantup.com/laravel/boxes/homestead

설치해야할 목록이 laravel/homestead 이다.

 

다운받기

vagrant init laravel/homestead
vagrant up

 

원하는 버전으로 

vagrant box add laravel/homestead --box-version=13.0.0

 

확인

vagrant box list

vagrant up

 

Vagrant 기본 명령어

Vagrant를 사용하기 위해서 반드시 알아야 하는 기본 명령어들이 있다.

vagrant init
베이그런트를 프로비저닝 하기 위한 Vagrantfile을 생성한다.

vagrant up
작성된 Vagrantfile을 바탕으로 프로비저닝을 진행한다.

vagrant halt
베이그런트에서 관리하는 가상 머신을 종료한다.

vagrant destroy
베이그런트에서 관리하는 가상 머신을 삭제한다.

vagrant ssh
베이그런트에서 생성된 가상 머신에 ssh로 접속한다.

vagrant provision
베이그런트에서 관리하는 가상 머신의 설정을 변경하고 적용한다.