1. Laravel Valet이란? 🤔

Laravel Valet은 Mac 사용자를 위해 특별히 설계된 초경량 로컬 개발 환경이에요. 2016년에 처음 출시된 이후로 계속 발전해왔고, 2025년 현재는 더욱 강력하고 유연해졌답니다!

Valet은 Nginx를 사용하여 컴퓨터가 켜져 있는 동안 항상 백그라운드에서 실행돼요. 그래서 프로젝트 폴더에 들어가서 php artisan serve 같은 명령어를 실행할 필요가 전혀 없답니다! 😲

간단히 말해서, Valet은 여러분의 Mac을 항상 개발 준비가 되어 있는 상태로 만들어주는 마법 같은 도구예요. 프로젝트 폴더를 만들고 바로 브라우저에서 접속할 수 있으니 개발 시작이 정말 빨라져요! 🚀

2. Valet의 장점과 특징 💪

이런 장점들 덕분에 Mac을 사용하는 PHP 개발자들 사이에서는 Valet이 거의 필수템이 되었어요! 재능넷 같은 개발자 커뮤니티에서도 Valet 사용법에 대한 질문이 자주 올라오는 걸 보면 인기가 정말 많죠. 😎

3. 설치 전 준비사항 📋

Valet을 설치하기 전에 몇 가지 준비물이 필요해요. 차근차근 확인해볼까요?

모든 준비가 끝났다면, 이제 본격적으로 Valet을 설치해볼까요? 진짜 쉬워서 놀랄걸요? ㅋㅋㅋ

4. Valet 설치 방법 (2025년 최신 버전) 🛠️

자, 이제 본격적으로 Valet을 설치해볼게요! 2025년 3월 기준 최신 방법으로 안내해드릴게요.

composer global require laravel/valet

valet install

mkdir ~/Sites
cd ~/Sites
valet park

cd ~/Sites
mkdir hello-valet
cd hello-valet
echo "<?php echo 'Valet이 정상 작동합니다! 짱이에요! 🎉'; ?>" > index.php

5. Valet 기본 명령어 마스터하기 ⌨️

Valet을 100% 활용하려면 기본 명령어들을 알아두는 게 좋아요. 자주 사용하는 명령어들을 정리해봤어요!

cd ~/Sites
composer create-project laravel/laravel my-laravel-app
cd my-laravel-app
valet link
valet secure

cd ~/Sites
mkdir wordpress-site
cd wordpress-site
curl -O https://wordpress.org/latest.zip
unzip latest.zip
mv wordpress/* .
rmdir wordpress
rm latest.zip
valet link wp-site

이 명령어들만 알아도 Valet의 80%는 활용할 수 있어요! 더 많은 명령어가 궁금하다면 valet --help를 입력해보세요. 모든 명령어 목록이 나온답니다. 😉

6. 실전 프로젝트 세팅하기 🚀

이제 Valet을 이용해 실제 프로젝트를 세팅해볼까요? Laravel 프로젝트를 예로 들어볼게요!

brew install mysql
brew services start mysql
mysql_secure_installation

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=awesome
DB_USERNAME=root
DB_PASSWORD=your_password

mysql -u root -p
CREATE DATABASE awesome;

cd ~/Sites/my-awesome-project
php artisan migrate

7. Valet vs 다른 개발 환경 🥊

Valet 말고도 다양한 로컬 개발 환경이 있어요. 각각의 장단점을 비교해볼까요?

결론: 만약 Mac 사용자이고, 빠르고 가벼운 개발 환경을 원한다면 Valet이 최고의 선택이에요! 하지만 팀 프로젝트나 복잡한 의존성이 있는 프로젝트라면 Docker나 Homestead가 더 적합할 수 있어요.

저는 개인적으로 간단한 프로젝트나 빠른 프로토타이핑에는 Valet을, 팀 프로젝트나 복잡한 서비스에는 Docker를 사용하는 하이브리드 전략을 선호해요! 재능넷 같은 서비스도 초기에는 Valet으로 빠르게 개발하다가 규모가 커지면서 Docker로 전환하는 경우가 많답니다. 😊

8. 고급 설정 및 커스터마이징 ⚙️

Valet의 기본 기능만으로도 충분히 강력하지만, 더 깊이 들어가면 다양한 커스터마이징 옵션이 있어요! 2025년 최신 기능들도 함께 살펴볼게요.

# 여러 PHP 버전 설치
brew install php@8.1
brew install php@8.2
brew install php@8.3

# 전역 PHP 버전 변경
valet use php@8.3

# 특정 사이트만 PHP 버전 변경 (2025년 신기능!)
cd ~/Sites/legacy-project
valet isolate php@8.1

cd ~/Sites/my-project
valet env set DB_CONNECTION=mysql
valet env set DB_DATABASE=custom_db

valet env list

# Node.js 앱을 Valet 도메인으로 연결 (3000번 포트 사용)
valet proxy node-app http://127.0.0.1:3000

# React 개발 서버 연결
valet proxy react-app http://127.0.0.1:5173

cd ~/.config/valet/Drivers
touch CustomDriver.php

<?php

namespace Valet\Drivers;

use Valet\Drivers\ValetDriver;

class CustomDriver extends ValetDriver
{
    public function serves($sitePath, $siteName, $uri)
    {
        // 이 드라이버가 적용될 조건 정의
        return file_exists($sitePath.'/custom-framework-file.php');
    }

    public function isStaticFile($sitePath, $siteName, $uri)
    {
        // 정적 파일 처리 로직
        if (file_exists($staticFilePath = $sitePath.'/public'.$uri)) {
            return $staticFilePath;
        }

        return false;
    }

    public function frontControllerPath($sitePath, $siteName, $uri)
    {
        // 프론트 컨트롤러 경로 정의
        return $sitePath.'/public/index.php';
    }
}

valet restart

{
    "domain": "test",
    "paths": [
        "/Users/username/Sites"
    ],
    "tld": "test",
    "loopback": "127.0.0.1",
    "php": "/usr/local/opt/php@8.3/bin/php",
    "nginx_config": "/Users/username/.config/valet/Nginx/valet.conf",
    "secure": [
        "secure-app"
    ],
    "proxies": {
        "node-app": "http://127.0.0.1:3000"
    }
}

이런 고급 설정들을 활용하면 Valet을 훨씬 더 강력하게 사용할 수 있어요! 특히 2025년 버전에서는 사이트별 PHP 버전 격리와 환경 변수 설정 기능이 추가되어 더욱 유연해졌답니다. 😎

9. 문제 해결 가이드 🔧

Valet은 대부분 문제없이 잘 작동하지만, 가끔 문제가 발생할 수 있어요. 자주 발생하는 문제와 해결 방법을 알아볼까요?

# Valet 중지
valet stop

# Valet 설정 초기화 (링크와 설정 유지)
valet reset

# 완전 초기화 (모든 설정 삭제)
valet uninstall

# 재설치
composer global require laravel/valet
valet install

# Valet 상태 진단
valet diagnose

# 특정 사이트 진단
valet diagnose site-name

문제 해결 과정에서 도움이 필요하다면 GitHub 이슈나 재능넷 같은 개발자 커뮤니티에서 질문해보세요! 많은 개발자들이 기꺼이 도움을 줄 거예요. 😊

10. 마무리 및 추천 자료 🎓