최종 수정일 - 영어 : 2년 전 / 한글 : 4년 전
영문 같이보기 영어 원문보기

라라벨 홈스테드

시작하기

라라벨은 여러분의 로컬 개발 환경을 포함하여 전체 PHP 개발 경험을 유쾌하게 만들기 위해서 노력하고 있습니다. Vagrant은 간단하고 세련되게 가상 머신을 관리하고 준비할 수 있는 방법을 제공합니다.

라라벨 홈스테드는 공식적으로 여러분이 PHP, 웹서버, 기타 다른 서버 소프트웨어를 설치할 필요가 없는 사전에 준비된 Vagrant box이며 멋진 개발 환경을 제공합니다. 운영체제가 너저분 해지는 것을 걱정할 필요가 없습니다! Vagrant box는 완전히 일회용입니다. 만약 뭔가 잘 되지 않는다면, 여러분은 몇분안에 다시 box를 생성할 수 있습니다.

홈스테드는 Windows, Mac 그리고 Linux 시스템에서 실행할 수 있으며 Nginx, PHP, MySQL, PostgreSQL, Redis, Memcached, Node 및 기타 라라벨 애플리케이션 개발에 필요한 멋진 도구들을 모두 포함하고 있습니다. .

{note} 만약 윈도우를 사용하는 경우, 하드웨어 가상화 (VT-x)를 활성화해야합니다. 이 설정은 일반적으로 BIOS에서 사용할 수 있습니다. 만약 UEFI 시스템에서 Hyper-V 를 사용중이라면 추가적으로 VT-x에 액세스하기 위해 Hyper-V를 비활성화 해야합니다.

포함된 소프트웨어

  • Ubuntu 18.04
  • Git
  • PHP 7.4
  • PHP 7.3
  • PHP 7.2
  • PHP 7.1
  • PHP 7.0
  • PHP 5.6
  • Nginx
  • MySQL
  • lmm for MySQL or MariaDB database snapshots
  • Sqlite3
  • PostgreSQL
  • Composer
  • Node (With Yarn, Bower, Grunt, and Gulp)
  • Redis
  • Memcached
  • Beanstalkd
  • Mailhog
  • avahi
  • ngrok
  • Xdebug
  • XHProf / Tideways / XHGui
  • wp-cli

Optional Software

  • Apache
  • Blackfire
  • Cassandra
  • Chronograf
  • CouchDB
  • Crystal & Lucky Framework
  • Docker
  • Elasticsearch
  • Gearman
  • Go
  • Grafana
  • InfluxDB
  • MariaDB
  • MinIO
  • MongoDB
  • MySQL 8
  • Neo4j
  • Oh My Zsh
  • Open Resty
  • PM2
  • Python
  • RabbitMQ
  • Solr
  • Webdriver & Laravel Dusk Utilities

설치 & 구성하기

첫번째 단계

라라벨 홈스테드를 구동하기 전에 여러분은 반드시 VirtualBox 6.x, VMWare 또는 Parallels, Hyper-V 그리고 Vagrant를 설치해야 합니다. 이 소프트웨어 패키지들은 모든 운영체제에서 손쉽게 설치할 수 있는 인스톨러 프로그램을 제공합니다.

VMware 프로바이더를 사용하려면 VMware Fusion / Workstation 과 VMware Vagrant plug-in을 구매해야 합니다. 무료는 아니지만, VMware 의 경우 추가적인 설정 없이도 더 빠른 공유폴더의 퍼포먼스를 제공합니다.

Parallels 프로바이더를 사용하려면, Parallels Vagrant 플러그인을 설치해야 합니다. 이는 무료입니다.

Vagrant 제한사항으로 인해서, Hyper-V 프로바이더에서는 모든 네트워크 설정이 무시됩니다.

홈스테드 Vagrant Box 설치하기

VirtualBox / VMware 그리고 Vagrant 가 설치되었다면, 터미널에서 다음의 명령어를 통해서 인스톨된 Vagrant에 laravel/homestead box 를 추가해야 합니다. box를 다운로드 하는 것은 인터넨 연결 속도에 따라 몇분 정도 소요됩니다.

vagrant box add laravel/homestead

이 명령어가 실패하면, Vagrant 설치가 최신버전인지 확인하십시오.

{note} Homestead는 정기적으로 테스트를 위해 "알파" / "베타"박스를 발행하는데, 이로 인해 vagrant box add 명령이 방해받을 수 있습니다. vagrant box add 실행에 문제가 있는 경우 vagrant up 명령을 실행할 수 있으며 Vagrant가 가상 머신을 시작하려고 할 때 올바른 상자가 다운로드됩니다.

홈스테드 설치하기

Git 저장소를 작업하는 머신에 복제하여 홈스테드를 설치할 수 있습니다. 여러분의 "home" 디렉토리안에 Homestead 폴더로 저장소를 복제하면 홈스테드 box가 라라벨 프로젝트의 모든 호스트 역할을 할 것입니다.

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

master 브랜치는 개발중이라 안정적이지 않을 수도 있기 때문에, 태그를 지정한 버전을 체크아웃 해야합니다. 안정적인 버전은 GitHub 릴리즈 페이지에서 찾으실 수 있습니다. 또는 항상 최신 안정 릴리즈가 포함 된 release 브랜치를 체크 아웃 할 수 있습니다.

cd ~/Homestead

git checkout release

홈스테드 저장소를 복제한 뒤에, 홈스테드 디렉토리에서 bash init.sh 명령어를 통해서 Homestead.yaml 설정 파일을 생성할 수 있습니다. 홈스테드 디렉토리에 Homestead.yaml 파일이 생성될 것입니다.

// Mac / Linux...
bash init.sh

// Windows...
init.bat

홈스테드 설정하기

프로바이더 설정하기

Homestead.yaml 파일의 provider 키는 virtualbox, vmware_fusion, vmware_workstation, parallels와 hyperv 중 어느 것을 사용할 것인지를 알려줍니다. 여러분이 원하는대로 이 프로바이더를 설정할 수 있습니다.

provider: virtualbox

공유폴더 설정하기

Homestead.yaml 파일의 folders 속성은 홈스테드 환경과 공유하고자 하는 모든 폴더가 나열되어 있습니다. 여러분의 로컬 머신과 홈스테드 환경사이에서 동기화된 이 폴더 안의 파일들이 변경되면 변경사항이 서로 유지됩니다. 필요한 만큼 공유 폴더를 설정하십시오:

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

{note} Windows 사용자는 ~/경로 구문을 사용하지 말고 대신 C:\Users\user\Code\project1와 같은 프로젝트의 전체 경로를 사용해야 합니다.

~/code 폴더 전체를 매핑하는 대신 개별 프로젝트를 항상 자신의 폴더 매핑에 매핑해야합니다. 폴더를 매핑 할 때 가상머신은 폴더의 모든 파일에 대한 모든 디스크 IO를 추적해야합니다. 폴더에 많은 수의 파일이있는 경우 성능 문제가 발생합니다.

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

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

{note} Homestead를 사용할 때는 . (현재 디렉토리)를 마운트하지 마십시오. 이로 인해 Vagrant는 현재 폴더를 /vagrant로 매핑하지 않으며 옵션 기능을 중단하고 프로비저닝하는 동안 예상치 못한 결과를 초래합니다.

NFS를 사용하기 위해서는 동기화 폴더 설정에 플래그를 더해주면 됩니다.

folders:
    - map: ~/code/project1
      to: /home/vagrant/project1
      type: "nfs"

{note} 윈도우에서 NFS를 사용할 때에는, vagrant-winnfsd 플러그인을 설치해야만 합니다. 이 플러그인은 홈스테드 box안에서 파일과 디렉토리를 위한 올바른 사용자와 권한을 관리해줍니다.

options 키 아래 Vagrant의 동기화 폴더옵션을 나열식으로 전달할 수 있습니다.

folders:
    - map: ~/code/project1
      to: /home/vagrant/project1
      type: "rsync"
      options:
          rsync__args: ["--verbose", "--archive", "--delete", "-zz"]
          rsync__exclude: ["node_modules"]

Nginx 사이트 설정하기

Nginx에 익숙하지 않으신가요? 문제없습니다. sites 속성을 통해 홈스테드 환경의 폴더와 "도메인"을 쉽게 매핑 할 수 있습니다. 사이트 샘플이 Homestead.yaml 파일에 포함되어 있습니다. 여기에서도 여러분의 홈스테드 환경에 필요한만큼 사이트를 추가할 수 있습니다. 홈스테드는 편리하게, 여러분이 작업을 수행하는 모든 라라벨 프로젝트를 위한 가상 환경을 제공합니다.

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

홈스테드 박스가 프로비저닝 된 이후에 sites 속성을 변경한다면, 가상머신의 Nginx 설정을 갱신하기 위해서 vagrant reload --provision 을 다시 실행시켜야만 합니다.

{note} Homestead 스크립트는 가능한 한 멱등성을 유지하도록 만들어졌습니다. 그러나 프로비저닝 중에 문제가 발생하는 경우, vagrant destroy && vagrant up를 통해 가상머신을 제거하고 재구성해야합니다.

Hostname 해결

Homestead는 자동 호스트 해결을 위해 mDNS를 통해 hostname을 발행합니다. Homestead.yaml 파일에 hostname:homestead를 설정하면 homestead.local로 호스트를 사용할 수 있습니다. MacOS, iOS 및 Linux 데스크탑 배포판에는 기본적으로 mDNS지원이 포함되어 있습니다. Windows에서 Windows 용 Bonjour Print Services를 설치해야합니다.

자동 hostname 사용은 Homestead의 "프로젝트 별"설치에 가장 적합합니다. Homestead 인스턴스 하나에 여러 사이트를 호스팅하는 경우 웹 사이트의 "도메인"을 컴퓨터의 hosts 파일에 추가 할 수 있습니다. hosts 파일은 여러분의 홈스테드 사이트에 대한 요청을 홈스테드 머신으로 리다이렉트 시킬 것 입니다. 맥과 리눅스에서는 /etc/hosts, 윈도우에서는 C:\Windows\System32\drivers\etc\hosts에 파일이 있습니다. 이 파일에 추가하는 행은 다음과 같습니다.

192.168.10.10  homestead.test

입력한 IP 주소가 여러분의 Homestead.yaml 파일에 설정된 목록중 하나인지 확인하십시오. hosts 파일에 도메인을 추가 하고 Vagrant box를 구동하면 웹브라우저를 통해서 사이트에 액세스 할 수 있습니다.

http://homestead.test

Vagrant Box 구동하기

Homestead.yaml 파일 설정이 끝났다면, 홈스테드 디렉토리에서 vagrant up 명령어를 실행하십시오. Vagrant가 가상머신을 구동시키고 자동으로 공유폴더와 Nginx 사이트를 설정할 것입니다.

가상 머신을 제거하기 위해서는 vagrant destroy --force 명령어를 사용하면 됩니다.

프로젝트별 설치하기

홈스테드를 전역에 설치하고 전체 프로젝트에서 동일한 홈스테드 박스를 공유하는 대신, 홈스테드 인스턴스를 각각의 관리하는 프로젝트별로 설정할 수 있습니다. 프로젝트마다 홈스테드를 설치하는 것은 Vagrantfile을 프로젝트에서 구성하여, vagrant up을 할 때 다른 작업을 할 수 있도록 하는 장점이 있습니다.

홈스테드를 프로젝트에 직접 설치하려면 Composer-컴포저를 사용합니다.

composer require laravel/homestead --dev

홈스테드가 설치되고 나면, make 명령어를 사용하여 Vagrantfile 과 Homestead.yaml 파일을 프로젝트 루트 디렉토리에 생성합니다. make 명령어는 자동으로 Homestead.yaml 파일에서 sites 와 folders 옵션을 설정할 것입니다.

Mac / Linux:

php vendor/bin/homestead make

Windows:

vendor\\bin\\homestead make

다음으로 터미널에서 vagrant up 명령어를 실행하고 브라우저에서 http://homestead.test 프로젝트에 엑세스 하십시오. 자동화된 hostname 해결을 사용하지 않는다면, homestead.test 또는 선택한 도메인을 /etc/hosts 파일에 추가 할 필요가 있다는 것을 기억하십시오.

옵션 기능 설치

선택적인 소프트웨어는 Homestead 설정 파일의 "features"설정을 사용하여 설치합니다. boolean 값으로 대부분의 기능을 활성화 또는 비활성화 할 수 있으며 일부 기능은 여러 옵션 설정이 가능합니다.

features:
    - blackfire:
        server_id: "server_id"
        server_token: "server_value"
        client_id: "client_id"
        client_token: "client_value"
    - cassandra: true
    - chronograf: true
    - couchdb: true
    - crystal: true
    - docker: true
    - elasticsearch:
        version: 7
    - gearman: true
    - golang: true
    - grafana: true
    - influxdb: true
    - mariadb: true
    - minio: true
    - mongodb: true
    - mysql8: true
    - neo4j: true
    - ohmyzsh: true
    - openresty: true
    - pm2: true
    - python: true
    - rabbitmq: true
    - solr: true
    - webdriver: true

MariaDB

MariaDB를 활성화하면 MySQL이 제거되고 MariaDB가 설치됩니다. MariaDB는 MySQL의 상위호환 대체품이기 때문에 애플리케이션의 데이터베이스 구성에서 mysql 데이터베이스 드라이버를 사용해야합니다.

MongoDB

기본 MonogoDB 설치에는 homestead 를 계정 이름으로, secret을 패스워드로 지정됩니다.

Elasticsearch

Elasticsearch의 지원 버전을 지정할 수 있습니다. 이 버전은 메이저 버전 또는 (major.minor.patch) 형태의 정확한 버전을 지정하면 됩니다. 기본 설치는 homestead라는 이름으로 클러스터가 생성됩니다. Elasticsearch에 운영체제 메모리의 절반 이상을 할당하면 안됩니다. 따라서 홈스테드 머신에 Elasticsearch에 할당한 것의 두배 이상의 메모리가 있는지 확인하십시오.

{tip} 관련 설정을 변경하려면 Elasticsearch 매뉴얼을 참고하십시오.

Neo4j

기본적인 Neo4j 설치에는 homestead 를 계정 이름으로 secret을 패스워드로 지정됩니다. Neo4j에 엑세스 하기 위해서는, 브라우저에서 http://homestead.test:7474 를 통해서 접근하면 됩니다. 포트 7687 (Bolt), 7474 (HTTP), 7473 (HTTPS) 를 통해서 Neo4j 에 접근할 수 있습니다.

별칭 설정

홈스테드 디렉토리에 있는 aliases 파일을 수정하여 홈스테드 머신에 Bash 별칭을 추가할 수 있습니다.

alias c='clear'
alias ..='cd ..'

aliases 파일을 수정한 뒤에는 vagrant reload --provision 명령어를 사용하여 홈스테드 머신을 다시 프로비저닝 하십시오. 이렇게 하면 머신에서 새로운 별칭이 사용가능해집니다.

사용 방법

어디에서나 홈스테드 엑세스하기

때로는 파일시스템의 어디에서나 여러분의 홈스테드 머신에 vagrant up을 실행하고자 할 수 있습니다. 이렇게 하기 위해서는 맥 / 리눅스 시스템에서 Bash 함수를 Bash profile 에 추가하여 구현할 수 있습니다. 윈도우에서는 PATH에 "배치 파일을 추가하여 수행할 수 있습니다. 이 스크립트는 여러분이 시스템 어디에서나 Vagrant 명령어를 실행할 수 있게 하고 자동으로 홈스테드 설치를 대상으로 하게 할 수 있습니다.

맥 / 리눅스

function homestead() {
    ( cd ~/Homestead && vagrant $* )
}

함수에서 설정한 ~/Homestead 경로가 여러분의 실제 홈스테드 설치 위치인지 확인하십시오. 함수를 설정하면 시스템의 어느 곳에서나 homestead up 또는 homestead ssh와 같은 명령어를 실행할 수 있습니다.

윈도우

다음 내용을 가지는 homestead.bat 배치 파일을 원하는 곳에다가 생성합니다.

@echo off

set cwd=%cd%
set homesteadVagrant=C:\Homestead

cd /d %homesteadVagrant% && vagrant %*
cd /d %cwd%

set cwd=
set homesteadVagrant=

스크립트에서 설정한 C:\Homestead 경로가 여러분의 실제 홈스테드 설치 위치인지 확인하십시오 파일을 생성한뒤에, 파일의 경로를 PATH 에 추가합니다. 시스템의 어떤 경로에서라도 homestead up 또는 homestead ssh 명령어를 실행할 수 있습니다.

SSH를 통해서 연결하기

홈스테드 디렉토리에서 vagrant ssh 명령어를 실행하여 SSH를 통해서 홈스테드 환경에 접속할 수 있습니다.

하지만, 홈스테드 머신에 자주 접속할 것이기 때문에 손쉽게 홈스테드 머신에 SSH로 접속하기 위해서 앞서 이야기한 "함수"을 추가하는 것을 고려해 보십시오.

데이터베이스 접속하기

별다른 설정 없이도 homestead 데이터베이스는 MySQL과 PostgreSQL 가 설정되어 있습니다. 호스트 컴퓨터의 데이터베이스 클라이언트에서 MySQL 또는 PostgreSQL 데이터베이스에 연결하려면 127.0.0.1 및 포트 33060 (MySQL) 또는 54320 (PostgreSQL)에 연결해야합니다. 두 데이터베이스의 사용자 이름과 비밀번호는 homestead / secret입니다.

데이터베이스 클라이언트를 통해서 MySQL 또는 PostgreSQL 데이터베이스에 접속하려면 127.0.0.1 의 33060 (MySQL) 또는 54320 (PostgreSQL) 포트에 연결하면 됩니다. 데이터베이스 사용자 이름과 암호는 모두 homestead / secret 입니다.

{note} 데이터베이스에 접속할 때는 이러한 표준이 아닌 포트를 사용해야 합니다. 라라벨이 가상 머신 안에서 동작하고 있기 때문에 기본적인 3306 과 5432 포트는 라라벨 데이터베이스 설정 파일 안에서 사용할 수 있습니다.

데이터베이스 백업하기

홈스테드는 Vagrant box 가 종료될 때 자동으로 데이터베이스를 백업합니다. 이 기능을 사용하기 위해서는 Vagrant 2.1.0 이상 버전을 사용해야 합니다. 그 이전버전이라면, vagrant-triggers 플러그인을 설치해야 합니다. 자동으로 데이터베이스 백업을 활성화 하려면, 다음의 설정을 Homestead.yaml 파일에 추가하면 됩니다.

backup: true

설정을 하고나면, 홈스테드는 vagrant destroy 명령이 실행될 때 데이터베이스를 mysql_backup 과 postgres_backup 디렉토리로 백업을 내보냅니다. 이 디렉토리는 프로젝트 별 설치방법을 사용하는 경우에는 루트 디렉토리에, 홈스테드를 클론(복제) 한 경우에는 해당 디렉토리에서 찾을 수 있습니다.

데이터베이스 스냅샷

Homestead는 MySQL 및 MariaDB 데이터베이스의 상태를 고정시키고 Logical MySQL Manager를 사용하여 이들 사이를 분기하는 것을 지원합니다. 예를 들어, 수 기가 바이트 데이터베이스가 있는 사이트에서 작업하는 것을 상상해보십시오. 데이터베이스를 가져 와서 스냅 샷을 만들 수 있습니다. 일부 작업을 수행하고 일부 테스트 컨텐츠를 로컬로 작성한 후 신속하게 원래 상태로 복원 할 수 있습니다.

내부적으로 LMM은 LVM의 씬-thin 스냅 샷 기능을 사용하여 쓰기 중 복사를 지원합니다. 실제로 이는 테이블의 단일 행을 변경하면 디스크에 변경 사항 만 기록하여 복원 중 상당한 시간과 디스크 공간을 절약 할 수 있음을 의미합니다.

lmm은 LVM과 상호 작용하기 때문에 root로 실행되어야 합니다. 사용 가능한 모든 명령을 보려면, 당신의 Vagrant 박스 안에 sudo lmm을 실행하십시오. 일반적인 작업순서는 다음과 같습니다.

  1. 디폴트 master lmm 브랜치로 데이터베이스를 임포트하십시오.
  2. sudo lmm branch prod-YYYY-MM-DD를 사용하여 변경되지 않은 데이터베이스의 스냅 샷을 저장하십시오.
  3. 데이터베이스를 수정하십시오.
  4. sudo lmm merge prod -YYYY-MM-DD를 실행하여 모든 변경 사항을 취소하십시오.
  5. sudo lmm delete <branch>를 실행하여 필요없는 브랜치를 삭제하십시오.

추가적인 사이트 지정하기

홈스테드 환경이 준비되어 구성되고 난 뒤에 라라벨 애플리케이션에 추가적인 Nginx 사이트를 구성하기를 원할 수도 있습니다. 하나의 홈스테드 환경 안에서 여러개의 라라벨을 설치하여 작동 시킬수도 있습니다. 추가적인 사이트를 지정하기 위해서, Homestead.yaml 파일에 사이트를 추가하십시오:

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
    - map: another.test
      to: /home/vagrant/project2/public

Vagrant 가 자동으로 "hosts" 파일을 관리하지 않는다면, 직접 다음의 사이트를 호스트 파일에 추가해야합니다.

192.168.10.10  homestead.test
192.168.10.10  another.test

사이트가 추가되면, 홈스테드 디렉토리에서 vagrant reload --provision 명령어를 실행하십시오.

사이트 타입

홈스테드는 라라벨이 아닌 프로젝트를 손쉽게 구동할 수 있는 몇가지 사이트 타입을 지원합니다. 예를 들자면, symfony2 사이트 타입은 Synfony 애플리케이션을 홈스테드에서 추가할 수 있도록 해줍니다.

sites:
    - map: symfony2.test
      to: /home/vagrant/my-symfony-project/web
      type: "symfony2"

사용가능한 사이트 타입에는 apache, apigility, expressive, laravel (기본값), proxy, silverstripe, statamic, symfony2, symfony4, 그리고 zf가 있습니다.

사이트 파라미터

추가적인 Nginx fastcgi_param 값을 사이트에 설정하려면 params 사이트 지시어를 사용하면 됩니다. 예를 들어 BAR 라는 값을 가지는 FOO 파라미터를 추가해보겠습니다.

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
      params:
          - key: FOO
            value: BAR

시스템 ENV 환경 변수

Homestead.yaml 파일에 시스템 ENV 변수를 지정할 수 있습니다.

variables:
    - key: APP_ENV
      value: local
    - key: FOO
      value: bar

Homestead.yaml 파일을 수정한 뒤에는 vagrant reload --provision 를 실행하여 머신을 새롭게 프로비저닝 하십시오. 이 명령어는 설치된 PHP버전에 맞는 PHP-FPM 설정을 업데이트하고 vagrant 사용자를 위한 구동환경을 업데이트 합니다.

Cron 스케줄링 설정하기

라라벨에서는 단 한번 schedule:run 아티즌 명령어를 실행하여 매분마다 Cron 작업 스케줄링을 할 수 있도록 하는 편리한 방법을 제공합니다. schedule:run 명령어는 App\Console\Kernel 클래스에 정의되어 있는 작업 스케줄이 실행되어야 하는지 검사할 것입니다.

홈스테드의 사이트에서 schedule:run 명령을 실행하려면 사이트를 정의 할 때 schedule 옵션을 true 로 설정하십시오.

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
      schedule: true

사이트를 위한 Cron 작업은 가상 머신의 /etc/cron.d 폴더에 정의됩니다.

Mailhog 설정하기

Mailhog를 사용하면 실제로 메일을 받는 사람에게 메일을 보내지 않고도 송신하는 메일을 손쉽게 찾아보고 확인 할 수 있습니다. 이를 시작하려면 .env 파일을 수정하여 다음의 메일 설정을 사용하십시오:

MAIL_DRIVER=smtp
MAIL_HOST=localhost
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

Mailhog이 구성되면 http://localhost:8025 로 Mailhog 대시 보드에 액세스 할 수 있습니다.

Minio 설정하기

Minio 는 Amazon S3 API와 호환되는 오픈소스 객체 스토리지 서버입니다. Minio를 설치하려면 Homestead.yaml 파일의 features섹션에 다음의 설정 내용을 추가하십시오.

minio: true

기본적으로 Minio는 9600포트를 사용합니다. http://localhost:9600/ 을 방문하여 Minio 제어판에 엑세스 할 수 있습니다. 기본 엑세스 키는 homestead 이고, 기본 비밀 키는 secretkey 입니다. Minio에 엑세스 할 때는 항상 us-east-1 리전을 사용해야합니다.

Minio를 사용하기 위해서는 설정 파일 config/filesystems.php 에서 S3 디스크 설정을 수정해야합니다. 디스크 구성에 use_path_style_endpoint 옵션을 추가하고 url 키를 endpoint 로 변경해야합니다.

's3' => [
    'driver' => 's3',
    'key' => env('AWS_ACCESS_KEY_ID'),
    'secret' => env('AWS_SECRET_ACCESS_KEY'),
    'region' => env('AWS_DEFAULT_REGION'),
    'bucket' => env('AWS_BUCKET'),
    'endpoint' => env('AWS_URL'),
    'use_path_style_endpoint' => true
]

마지막으로 .env 파일에 다음 옵션이 있는지 확인하십시오 :

AWS_ACCESS_KEY_ID=homestead
AWS_SECRET_ACCESS_KEY=secretkey
AWS_DEFAULT_REGION=us-east-1
AWS_URL=http://localhost:9600

버킷을 프로비저닝하려면 Homestead 환경설정 파일에 buckets 지시문을 추가하십시오.

buckets:
    - name: your-bucket
      policy: public
    - name: your-private-bucket
      policy: none

지원되는policy 값은none,download,upload,public입니다.

포트지정하기

기본적으로 다음의 포트들이 홈스테드 환경에서 포워딩 설정 되어 있습니다.

  • SSH: 2222 → Forwards To 22
  • ngrok UI: 4040 → Forwards To 4040
  • HTTP: 8000 → Forwards To 80
  • HTTPS: 44300 → Forwards To 443
  • MySQL: 33060 → Forwards To 3306
  • PostgreSQL: 54320 → Forwards To 5432
  • MongoDB: 27017 → Forwards To 27017
  • Mailhog: 8025 → Forwards To 8025
  • Minio: 9600 → Forwards To 9600

추가적인 포트 포워딩하기

원한다면 포트뿐만 아니라 프로토콜을 추가로 Vagrant Box에 포워딩하도록 지정 할 수 있습니다.

ports:
    - send: 50000
      to: 5000
    - send: 7777
      to: 777
      protocol: udp

환경 공유하기

가끔씩, 현재 작업하고 있는 환경을 동료들이나, 다른 사람들과 공유하고 싶을 수도 있습니다. Vagrant는 이를 위해서 vagrant share를 통해서 환경을 공유할 수 있는 내장 기능이 지원됩니다; 그렇지만, Homestead.yaml 파일에 여러개의 사이트가 설정된 경우에는 동작이 원하는대로 작동하지 않습니다.

이 문제를 극복하기 위해서, 홈스테드에 share 명령어가 포함되었습니다. 이렇게 하기 위해서 vagrant ssh 명령어를 통해서 홈스테드 머신에 SSH 접속을 한 다음 share homestead.test 을 실행하십시오. 이렇게 하면 여러분의 Homestead.yaml 설정에 있는 homestead.test 사이트와 다른 사이트도 공유할 수 있습니다.

share homestead.test

이 명령어를 실행하면, 여러분은 Ngrok 스크린에서 activity log와 함께 공유한 사이트에 접속할 수 있는 public URL을 확인할 수 있습니다. 커스텀 리전, 서브도메인, Ngrok 실행 옵션을 지정하고자 한다면 share 명령어에 이를 추가하면됩니다.

share homestead.test -region=eu -subdomain=laravel

{note} 유념할점은, share 명령어를 실행중일 때는 가상머신이 인터넷에 노출되고 보안에 노출될 수 있다는 점입니다.

여러 버전의 PHP 사용하기

홈스테드 6부터 동일한 가상 머신에서 여러버전의 PHP를 사용할 수 있습니다. 해당 사이트에서 어떤 버전의 PHP를 사용할지 Homestead.yaml에서 지정할 수 있습니다. 사용가능한 PHP 버전은 "5.6", "7.0", "7.1", "7.2", "7.3", "7.4"(기본) 입니다.

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
      php: "7.1"

추가적으로 CLI를 통해서 지원되는 PHP 버전들은 다음과 같이 사용할 수 있습니다.

php5.6 artisan list
php7.0 artisan list
php7.1 artisan list
php7.2 artisan list
php7.3 artisan list
php7.4 artisan list

Homestead 가상 머신에서 다음 명령을 실행하여 기본 CLI 버전을 업데이트 할 수도 있습니다.

php56
php70
php71
php72
php73
php74

웹서버

홈스테드는 기본적으로 Nginx를 웹서버로 사용합니다. 그렇지만, site 타입에 apache를 지정해서 아파치를 설치할 수 있습니다. 두 웹서버를 모두 설치할 수 있지만, 동시에 실행할 수는 없습니다. flip 쉘 명령어를 사용하여 웹서버를 쉽게 전환할 수 있습니다. flip 쉘 명령어는 자동으로 실행되는 웹서버를 멈추고 다른 서버를 구동합니다. 이 명령어을 사용하려면 홈스테드에 SSH 접속을 하고 터미널에 명령어를 실행하면 됩니다.

flip

이메일

홈스테드는 기본적으로 1025 포트를 사용하는 Postfix 메일 전송 에이전트를 포함하고 있습니다. 따라서 애플리케이션에서 smtp 메일드라이버에 localhost 와 포트번호 1025 를 설정할 수 있습니다. 이렇게 하면 모든 메일은 Postfix로 처리되고 Mailhog 에 기록됩니다. 전달된 이메일을 확인하려면 브라우저에서 http://localhost:8025를 열어보십시오.

디버깅과 프로파일링

Xdebug로 웹 요청 디버깅

Homestead는 Xdebug를 사용하여 단계별 디버깅을 지원합니다. 예를 들어 브라우저에서 웹 페이지를 로드 할 수 있으며, PHP는 IDE에 연결하여 실행중인 코드를 검사하고 수정할 수 있습니다.

기본적으로 Xdebug는 이미 실행 중이며 연결을 수락 할 준비가 되어 있습니다. CLI에서 Xdebug를 활성화하려면 Vagrant 박스 안에서 sudo phpenmod xdebug 커맨드를 실행하십시오. 그런 다음 IDE의 지침에 따라 디버깅을 활성화합니다. 마지막으로 Xdebug와 함께 확장 프로그램이나 bookmarklet이 실행되도록 브라우저를 구성합니다.

{note} Xdebug를 사용하면 PHP가 상당히 느리게 실행됩니다. Xdebug를 비활성화하려면, Vagrant 상자에서 sudo phpdismod xdebug를 실행하고 FPM 서비스를 다시 시작하십시오.

CLI 애플리케이션 디버깅

PHP CLI 애플리케이션을 디버깅하려면, Vagrant 박스 안에 xphp 쉘 별칭을 사용하십시오.

xphp path/to/script

Xdebug 자동시작

웹 서버에 요청하는 기능 테스트를 디버깅 할 때 커스텀 헤더 또는 쿠키를 통해서 디버깅을 실행하도록 테스트를 수정하는 대신 디버깅을 자동 시작하는 것이 더 쉽습니다. Xdebug를 자동으로 시작하려면 Vagrant 박스에서 /etc/php/7.x/fpm/conf.d/20-xdebug.ini을 수정하고 다음 설정을 추가하십시오.

; If Homestead.yaml contains a different subnet for the IP address, this address may be different...
xdebug.remote_host = 192.168.10.1
xdebug.remote_autostart = 1

Blackfire로 애플리케이션 프로파일링

Blackfire는 웹 요청 및 CLI 애플리케이션 및 쓰기 성능 assertion을 프로파일링하는 SaaS 서비스입니다. 콜 그래프 및 타임 라인에 프로필 데이터를 표시하는 대화 형 사용자 인터페이스를 제공합니다. 이는 개발, 스테이징 및 프로덕션에서 사용하기 위해 제작되었으며 최종 사용자에게는 오버 헤드가 없습니다. 코드와 php.ini 설정 값에 대한 성능, 품질, 보안 검사를 제공합니다.

Blackfire Player는 프로파일링 시나리오를 스크립팅하기 위해 Blackfire와 공동으로 작업 할 수있는 오픈 소스 웹 크롤링, 웹 테스트 및 웹 스크래핑 애플리케이션입니다.

Blackfire를 사용하려면 Homestead 설정 파일에서 "features"설정을 사용하십시오.

features:
    - blackfire:
        server_id: "server_id"
        server_token: "server_value"
        client_id: "client_id"
        client_token: "client_value"

Blackfire 서버 인증 및 클라이언트 인증은 사용자 계정이 필요합니다. Blackfire는 CLI 도구 및 브라우저 확장을 포함하여 애플리케이션을 프로파일링하기위한 다양한 옵션을 제공합니다. 자세한 내용은 Blackfire 설명서를 검토하십시오.

XHGui를 사용하여 PHP 성능 프로파일링

XHGui는 PHP 애플리케이션의 성능을 탐색 할 수있는 사용자 인터페이스입니다. XHGui를 활성화하려면 사이트 설정에 xhgui:'true'를 추가하십시오.

sites:
    -
        map: your-site.test
        to: /home/vagrant/your-site/public
        type: "apache"
        xhgui: 'true'

사이트가 이미 존재하는 경우 설정을 업데이트 한 후 vagrant provision을 실행하십시오.

웹 요청을 프로파일링하려면 쿼리 파라미터로 xhgui=on을 요청에 추가하십시오. XHGui는 응답에 쿠키를 자동으로 첨부하여 이후 요청에는 쿼리 문자열 값이 필요하지 않습니다. http://your-site.test/xhgui로 이동하여 애플리케이션 프로필 결과를 볼 수 있습니다.

XHGui를 사용하여 CLI 요청을 프로파일링하려면 명령 앞에 XHGUI=on을 추가하십시오 :

XHGUI=on path/to/script

CLI 프로파일 결과는 웹 프로파일 결과와 동일한 방법으로 볼 수 있습니다.

프로파일링을하면 스크립트 실행 속도가 느려지고 절대 시간은 실제 요청보다 두 배나 늘어 날 수 있습니다. 따라서 절대 값이 아닌 항상 개선율을 비교하십시오. 또한 실행 시간에는 디버거에서 일시 중지 한 시간이 포함됩니다.

성능 프로파일은 상당한 디스크 공간을 차지하므로 며칠 후에 자동으로 삭제됩니다.

네트워크 인터페이스

Homestead.yaml 설정의 networks 속성은 홈스테드 환경의 네트워크 인터페이스 설정에 관련된 것입니다. 필요한 경우 여러개의 인터페이스를 설정할 수 있습니다.

networks:
    - type: "private_network"
      ip: "192.168.10.20"

bridged 인터페이스를 활성화 하기 위해서는, bridge 옵션을 설정하고 네트워크 타입을 public_network로 변경해야 합니다.

networks:
    - type: "public_network"
      ip: "192.168.10.20"
      bridge: "en1: Wi-Fi (AirPort)"

DHCP를 활성화하기 위해서는, 설정에서 간단하게 ip 옵션을 제거하면 됩니다.

networks:
    - type: "public_network"
      bridge: "en1: Wi-Fi (AirPort)"

홈스테드 확장하기

Homestead의 디렉토리 루트에있는 after.sh 스크립트를 사용하여 Homestead를 확장 할 수 있습니다. 이 파일에서 가상 머신을 올바르게 구성하고 커스터마이징 하는 데 필요한 쉘 명령을 추가 할 수 있습니다.

Homestead를 커스터마이징 할 때, 우분투는 패키지의 원래 환경설정을 유지하거나 새로운 환경설정 파일로 덮어 쓸 것인지 묻습니다. 이를 방지하려면 패키지를 설치할 때 이전에 Homestead에서 작성한 환경설정을 덮어 쓰지 않도록 다음 명령을 사용해야합니다.

sudo apt-get -y \
    -o Dpkg::Options::="--force-confdef" \
    -o Dpkg::Options::="--force-confold" \
    install your-package

개인 커스터마이징

Homestead를 팀 환경에서 사용할 때 개인 개발 스타일에 더 잘 적응할 수 있도록 Homestead를 조정할 수 있습니다. Homestead 디렉토리의 루트 (Homestead.yaml이 들어있는 동일한 디렉토리)에 user-customizations.sh 파일을 만들 수 있습니다. 이 파일 내에서 원하는대로 커스터마이징 할 수 있습니다. 그러나 user-customizations.sh는 버전 관리가 되어서는 안됩니다.

홈스테드 업데이트하기

Homestead 업데이트를 시작하기 전에 Homestead 디렉토리에서 다음 명령을 실행하여 현재 가상 머신을 제거했는지 확인하십시오. 

vagrant destroy

다음으로 Homestead 소스 코드를 업데이트해야합니다. 저장소를 복제 한 경우 원래 저장소를 복제 한 위치에서 다음 명령을 실행할 수 있습니다.

git fetch

git pull origin release

이 명령은 Homestead 코드를 GitHub 저장소에서 가져 와서 최신 태그를 가져온 다음 최신 태그 릴리스를 체크 아웃합니다. 최신 안정 버전은 GitHub 릴리즈 페이지에서 찾을 수 있습니다.

프로젝트의 composer.json 파일을 통해서 홈스테드를 설치했었다면, composer.json 파일이 "laravel/homestead": "^10"를 포함하여 의존성을 업데이트 할 수 있게 해야합니다.

composer update

그런 다음 vagrant box update 명령어를 사용하여 Vagrant 박스를 업데이트 해야합니다.

vagrant box update

마지막으로, 최신 Vagrant를 설치하려면 Homestead 박스를 재생성해야합니다.

vagrant destroy

vagrant up

프로바이더 지정 셋팅

VirtualBox

natdnshostresolver

기본적으로, 홈스테드는 natdnshostresolver 설정을 on 으로 구성합니다. 이렇게 하면 홈스테드가 여러분의 OS의 DNS 셋팅을 사용할 수 있게 해줍니다. 이 동작을 오버라이딩 하고자 한다면, Homestead.yaml 파일에 다음 라인을 추가하십시오:

provider: virtualbox
natdnshostresolver: 'off'

윈도우에서 심볼릭 링크

윈도우 환경에서 심볼릭 링크가 원하는 대로 동작하지 않는다면, Vagrantfile 파일에 다음 블럭을 추가하십시오:

config.vm.provider "virtualbox" do |v|
    v.customize ["setextradata", :id, "VBoxInternal2/SharedFoldersEnableSymlinksCreate/v-root", "1"]
end
디렉토리 구조 발렛-Valet

이 문서의 번역에 기여해주신 분들

kkame 기여에 참여하기