맥에서 라라벨 설치하기 2026｜명령어 한 줄로 끝내는 방법 (M1~M5)

맥에서 라라벨 개발 환경을 만드는 방법은 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 dev

composer 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 open

my-app.test로 바로 접속됩니다. 서버를 따로 띄울 필요가 없고, 프로젝트를 여러 개 만들어도 포트가 겹치지 않습니다.

Homebrew로 직접 설치하려면

서버에 직접 설치하는 것이 아니라서 개발용으로 세팅하는 것이라 가볍게 설치해보기로 했는데요. 맥에서 프로그램 설치를 도와줄 homebrew 를 먼저 설치해 줍니다.

기존 개발 환경이 이미 Homebrew로 구성돼 있다면 이 방법도 여전히 유효합니다. 다만 버전을 정확히 지정해야 합니다.

brew install [email protected]

PHP는 keg-only 포뮬러라 설치만으로는 php 명령이 잡히지 않습니다. 링크를 걸어줍니다.

brew link --overwrite --force [email protected]

여기서 버전 번호를 반드시 붙여야 합니다. 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 [email protected] — 이제 실패합니다

$ brew install [email protected]
Error: No available formula with the name "[email protected]"

PHP 8.0은 2023년 11월에 보안 지원이 끝났고, Homebrew에서도 포뮬러가 제거됐습니다. 현재 Homebrew에서 설치할 수 있는 버전은 [email protected]부터 [email protected], 그리고 버전 없는 php(8.5)입니다.

brew link php — 버전을 붙여야 합니다

[email protected]를 설치했다면 링크도 brew link [email protected]여야 합니다. 버전 없이 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 [email protected]입니다.

정리

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

세 줄로 라라벨 개발 환경이 완성됩니다.

함께 읽으면 좋은 글들

맥북에서 개발 환경 세팅하기: Homebrew부터 Docker까지 완벽 가이드

개발자용 AI 비교 2026｜코딩은 클로드(Claude), 검색 결합은 제미나이(Gemini), 범용은 챗지피티(ChatGPT)