如何使用Valet在Mac搭建PHP環境 MacOS下快速PHP站點部署方式

在macOS上使用Valet部署PHP站點的核心步驟為：1. 安裝Homebrew；2. 安裝Composer；3. 全局安裝Valet；4. 執行valet install配置服務；5. 使用valet park或valet link部署項目。 Valet通過Nginx、DnsMasq和PHP FPM實現“零配置”本地PHP站點運行，無需虛擬主機設置，資源佔用低，操作簡潔高效。相比MAMP、XAMPP等集成環境，Valet更輕量且專注Web服務器核心功能，不捆綁數據庫和圖形界面，適合多項目快速切換。常見問題如服務異常可通過valet restart解決，PHP版本切換支持全局設置，域名解析問題可藉助valet diagnose或重裝Valet處理。 Valet內置多種框架驅動，如Laravel、WordPress等，自動識別並優化配置，提升開發效率。

在macOS上快速搭建PHP開發環境，Valet無疑是我用過最簡潔、高效的工具。它巧妙地利用Nginx、DnsMasq和PHP FPM，以極低的資源佔用和“零配置”的理念，讓你能夠瞬間啟動並運行本地PHP站點，無需繁瑣的虛擬主機設置或龐大的集成環境。

解決方案

要使用Valet在Mac上部署PHP站點，核心步驟非常直接。我個人覺得，它把那些複雜的服務配置都封裝得很好，你只需要幾個命令就能搞定。

首先，確保你的Mac上安裝了Homebrew，這是macOS上包管理的基石。如果你還沒裝，終端裡跑一下這個：

 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Homebrew搞定後，我們需要Composer，PHP的依賴管理工具。 Valet本身就是通過Composer安裝的。

 brew install composer

接著，就是安裝Valet本體了。這裡我通常會選擇全局安裝，這樣它就能在任何地方被調用：

 composer global require laravel/valet

安裝完Valet的依賴後，還需要讓Valet在你的系統裡“安家落戶”，配置Nginx和DnsMasq：

 valet install

valet install命令會做幾件事：它會安裝並配置Nginx、DnsMasq，並把它們設置為開機自啟動的服務。 DnsMasq負責將你本地的.test域名（默認後綴）解析到127.0.0.1 ，這樣你訪問your-project.test就能指向本地站點了。 Nginx則負責處理HTTP請求。

現在，你的Valet環境已經搭建好了。要部署一個PHP站點，你只需要進入你的項目目錄，然後執行：

 valet park

或者，如果你只想讓某個特定目錄作為站點根目錄，而不是整個父目錄下的所有子目錄都變成站點，你可以用valet link ：

 cd ~/Sites/my-php-project
valet link my-php-project

這樣，你就可以在瀏覽器里通過http://my-php-project.test訪問你的項目了。我用它搭建過幾十個WordPress站，那種絲滑感是MAMP、XAMPP這些大塊頭給不了的。

Valet與傳統WAMP/LAMP/MAMP環境有何不同？

說實話，剛開始接觸Valet的時候，我也好奇它跟MAMP、XAMPP這些老牌集成環境有什麼本質區別。用了一段時間後，我發現它們的設計哲學完全不同。

MAMP、XAMPP這類工具，往往是“一站式”解決方案，它們通常會打包Apache、MySQL、PHP以及phpMyAdmin等，提供一個圖形界面讓你啟動、停止服務，配置虛擬主機。這對於新手來說很友好，因為所有東西都在一個包裡。但缺點也顯而易見：它們通常比較臃腫，資源佔用高，而且你可能並不需要所有這些組件。比如，如果你只做PHP開發，Apache可能就顯得有些“重”了，Nginx在處理靜態文件和並發連接方面往往更高效。

Valet則走的是“極簡主義”路線。它不提供龐大的圖形界面，完全基於命令行操作。它只專注於Web服務器（Nginx）、DNS解析（DnsMasq）和PHP運行環境（PHP FPM）。數據庫呢？它不會幫你裝，你可以單獨安裝MySQL或PostgreSQL，或者用Docker。這種“只做一件事，並把它做好”的理念，讓Valet變得極其輕量和快速。

更關鍵的是，Valet的“零配置”特性。你不需要手動編輯Nginx配置文件來為每個項目設置虛擬主機。 valet park命令會把你指定的一個目錄下的所有子目錄都自動註冊為可訪問的站點（例如， ~/Sites/project-a會變成project-a.test ）。這種自動化的域名解析和站點服務，大大簡化了多項目開發的管理。對我來說，這意味著我可以快速切換項目，不用每次都去配置一遍。

Valet在實際開發中可能遇到的常見問題及解決方案

Valet雖然好用，但在實際使用中，也偶爾會遇到一些小插曲。不過，好在它設計得比較健壯，大部分問題都有直接的解決方案。

一個比較常見的場景是，當你更新了PHP版本或者Valet自身時，服務可能會出現一些小毛病。比如，某個站點突然訪問不了，或者PHP版本不對。這時候，我通常會先嘗試最簡單的“重啟大法”：

 valet restart

這個命令會重啟Valet所管理的所有服務（Nginx、DnsMasq和PHP FPM），通常能解決大部分臨時的配置或服務啟動問題。

另一個經常遇到的問題是PHP版本切換。 Mac上可能安裝了多個PHP版本（比如PHP 7.4、8.0、8.1等）。 Valet默認會使用Homebrew安裝的最新PHP版本。但如果你的項目依賴特定PHP版本，或者你想在不同項目之間切換PHP版本，Valet提供了非常方便的命令：

 valet use php@8.1 # 切換到PHP 8.1
valet use php@7.4 # 切換到PHP 7.4

這會全局切換Valet使用的PHP版本。如果你想某個特定項目使用不同的PHP版本，Valet目前沒有直接的“按項目切換”功能，但你可以考慮使用phpbrew或asdf這類更專業的PHP版本管理工具，或者通過Nginx配置來指定。不過，對於大多數場景，全局切換已經足夠了。

有時候，你可能會遇到.test域名解析失敗的情況。這通常是DnsMasq出了問題。你可以嘗試運行valet diagnose來檢查Valet的運行狀態和配置，它會給出一些診斷信息，幫助你定位問題。如果問題依然存在，可以嘗試卸載並重新安裝Valet：

 valet uninstall
composer global remove laravel/valet
# 確保刪除~/.config/valet 目錄rm -rf ~/.config/valet
# 然後重新執行安裝步驟composer global require laravel/valet
valet install

這幾乎是“萬能藥”，能解決大多數疑難雜症，因為它清除了所有舊的配置並重新構建。

Valet如何支持Laravel、WordPress等主流PHP框架和CMS？

Valet對主流PHP框架和CMS的支持，是我選擇它的一個重要原因。它內置了多種“驅動”（drivers），能夠自動識別項目類型並進行相應的配置，這省去了大量的手動調整。

當你把一個Laravel項目放到Valet管理的目錄下（比如通過valet park ），Valet會自動識別這是一個Laravel應用。你訪問your-laravel-project.test時，Valet會智能地將請求路由到Laravel項目的public目錄，並啟動Laravel的請求生命週期。你不需要做任何額外配置，就像魔法一樣。

對於WordPress也是如此。 Valet有一個專門的WordPress驅動。當你把一個WordPress安裝目錄放到valet park的目錄下，Valet就能識別它，並正確地處理WordPress的URL重寫規則（比如漂亮的固定鏈接）。我經常用Valet來快速搭建臨時的WordPress開發環境，進行主題或插件開發測試，效率非常高。

除了Laravel和WordPress，Valet還支持許多其他框架和CMS，包括Symfony、Zend Framework、Statamic、Jigsaw等等。這種開箱即用的兼容性，讓開發者可以專注於代碼本身，而不是環境配置。

從性能角度看，Valet由於其輕量級的設計，表現非常出色。 Nginx作為Web服務器，在處理靜態文件和高並發請求方面有著天然優勢，而PHP FPM則能高效地管理PHP進程。這一切都在本地運行，資源佔用極小，對於MacBook用戶來說，這意味著更長的電池續航和更安靜的風扇。我個人感覺，Valet在本地開發環境中的響應速度，比那些基於Apache的集成環境要快不少，尤其是在同時跑好幾個項目的時候。它能自動啟用HTTPS（通過valet secure命令），這對於本地開發需要模擬生產環境的HTTPS行為時，也提供了極大的便利。

以上是如何使用Valet在Mac搭建PHP環境 MacOS下快速PHP站點部署方式的詳細內容。更多資訊請關注PHP中文網其他相關文章！