맥에서 라라벨 개발 환경을 만드는 방법은 2022년과 지금이 완전히 다릅니다. 예전에는 Homebrew로 PHP를 설치하고 Composer를 붙이고 PATH를 잡아주는 과정을 하나씩 거쳐야 했는데, 지금은 명령어 한 줄이면 끝납니다.
이 글은 2026년 8월 기준으로 다시 정리했습니다. 애플 실리콘(M1~M5) 맥 전부에 해당합니다.
가장 빠른 방법 — 한 줄 설치
라라벨 공식 문서가 권장하는 방법입니다. PHP와 Composer, 라라벨 설치 관리자까지 한 번에 설치됩니다.
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.5)"설치가 끝나면 터미널을 새로 열고 확인합니다.
php -v
composer --version이 스크립트는 라라벨 팀이 운영하는 php.new에서 내려받으며, ~/.config/herd-lite/bin에 PHP·Composer·laravel 실행 파일을 설치하고 PATH까지 자동으로 잡아줍니다. Homebrew가 없어도 됩니다.
새 프로젝트 만들기
laravel new example-app프로젝트 이름과 옵션을 물어봅니다. 선택이 끝나면 필요한 패키지가 자동으로 설치됩니다. 그다음 실행합니다.
cd example-app
npm install && npm run build
composer run devcomposer run dev는 개발 서버와 큐 워커, Vite를 한 번에 띄웁니다. 브라우저에서 http://localhost:8000으로 접속하면 라라벨 시작 화면이 나옵니다.
Herd — GUI로 관리하고 싶다면
여러 프로젝트를 동시에 다루거나 PHP 버전을 프로젝트마다 다르게 쓴다면 Herd가 편합니다. 라라벨 팀이 만든 macOS 앱으로, 무료 버전만으로도 충분합니다.
herd.laravel.com에서 받아 설치하면 ~/Herd 폴더가 생깁니다. 이 안에 만든 프로젝트는 자동으로 .test 도메인이 붙습니다.
cd ~/Herd
laravel new my-app
cd my-app
herd openmy-app.test로 바로 접속됩니다. 서버를 따로 띄울 필요가 없고, 프로젝트를 여러 개 만들어도 포트가 겹치지 않습니다.
Homebrew로 직접 설치하려면
서버에 직접 설치하는 것이 아니라서 개발용으로 세팅하는 것이라 가볍게 설치해보기로 했는데요. 맥에서 프로그램 설치를 도와줄 homebrew 를 먼저 설치해 줍니다.
기존 개발 환경이 이미 Homebrew로 구성돼 있다면 이 방법도 여전히 유효합니다. 다만 버전을 정확히 지정해야 합니다.
brew install php@8.4PHP는 keg-only 포뮬러라 설치만으로는 php 명령이 잡히지 않습니다. 링크를 걸어줍니다.
brew link --overwrite --force php@8.4여기서 버전 번호를 반드시 붙여야 합니다. brew link php처럼 버전 없이 쓰면 다른 버전이 링크될 수 있습니다.
brew install composer
composer global require laravel/installer마지막으로 laravel 명령을 쓸 수 있게 PATH에 경로를 추가합니다. 이때 경로를 직접 타이핑하지 말고 Composer에게 물어보는 편이 확실합니다.
composer global config bin-dir --absolute출력된 경로를 셸 설정 파일에 넣습니다. 요즘 맥의 기본 셸은 zsh이므로 ~/.zshrc입니다.
echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc터미널에서 export만 실행하면 그 창을 닫는 순간 사라집니다. 반드시 ~/.zshrc에 넣어야 다음에도 유지됩니다.
세 가지 방법, 어떤 걸 고를까
| 방법 | 이럴 때 | 설치 시간 |
|---|---|---|
| php.new 한 줄 | 지금 바로 라라벨을 시작하고 싶을 때 | 1~2분 |
| Herd | 프로젝트가 여럿이거나 PHP 버전을 나눠 쓸 때 | 3~5분 |
| Homebrew | 이미 brew로 환경을 관리하고 있을 때 | 10분+ |
처음 시작하신다면 php.new 한 줄을 권합니다. 나중에 Herd로 옮겨도 충돌하지 않습니다.
2022년 방식이 지금은 안 되는 이유
예전 글이나 튜토리얼을 따라 하다가 막히셨다면 대부분 이 두 가지 때문입니다.
brew install php@8.0 — 이제 실패합니다
$ brew install php@8.0
Error: No available formula with the name "php@8.0"PHP 8.0은 2023년 11월에 보안 지원이 끝났고, Homebrew에서도 포뮬러가 제거됐습니다. 현재 Homebrew에서 설치할 수 있는 버전은 php@8.1부터 php@8.4, 그리고 버전 없는 php(8.5)입니다.
brew link php — 버전을 붙여야 합니다
php@8.4를 설치했다면 링크도 brew link php@8.4여야 합니다. 버전 없이 brew link php를 쓰면 의도한 것과 다른 버전이 잡힐 수 있습니다.
자주 묻는 질문
Q. PHP 버전은 뭘 써야 하나요?
라라벨 13은 PHP 8.3 이상이 필요합니다. 새로 시작한다면 8.4나 8.5를 쓰시면 됩니다. 기존 프로젝트를 옮기는 것이라면 그 프로젝트의 composer.json에 적힌 요구 버전을 먼저 확인하세요.
Q. MAMP나 XAMPP를 써도 되나요?
됩니다. 다만 라라벨은 자체 개발 서버가 있어서 굳이 필요하지 않습니다. 데이터베이스가 필요하면 macOS에서는 brew install mysql이나 DBngin이 더 가볍습니다.
Q. Docker(Sail)와 뭐가 다른가요?
Sail은 프로젝트 전체를 컨테이너 안에서 돌립니다. 팀원과 환경을 똑같이 맞춰야 하거나 Redis·MySQL 같은 서비스를 함께 묶어야 할 때 유리합니다. 대신 컨테이너 오버헤드가 있어 혼자 개발할 때는 로컬 설치가 더 빠릅니다.
Q. 인텔 맥에서도 같나요?
같습니다. php.new 스크립트가 아키텍처를 자동으로 판별합니다. Homebrew 방식이라면 설치 경로만 다릅니다 — 애플 실리콘은 /opt/homebrew, 인텔은 /usr/local입니다.
Q. 설치한 걸 지우려면?
rm -rf ~/.config/herd-lite그리고 ~/.zshrc에 추가된 PATH 줄을 지우면 됩니다. Homebrew로 설치했다면 brew uninstall php@8.4입니다.
정리
2022년에는 Homebrew → PHP → Composer → PATH 순으로 네 단계를 거쳐야 했습니다. 지금은 명령어 한 줄이면 같은 결과가 나옵니다.
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.5)"
laravel new my-app
cd my-app && composer run dev세 줄로 라라벨 개발 환경이 완성됩니다.