自訂 Valet 驅動程式

你可以編寫你自己的 Valet『驅動』來為 Valet 原本不支援的其它框架或 CMS 上運行的 PHP 應用程式提供服務。當你安裝 Valet 時，會建立一個包含 SampleValetDriver.php 檔案的 ~/.config/valet/Drivers 目錄。該文件包含一個範例驅動程式實現，演示如何編寫一個自訂的驅動程式。寫驅動程式只需要你去實作三個方法：serves，isStaticFile 和 frontControllerPath。

這三個方法都接受 $sitePath，$siteName 和 $uri 值作為參數。 $sitePath 是你的機器上提供網站的完全限定路徑。例如 /Users/Lisa/Sites/my-project。 $siteName 是網域（my-project）的『主機』/『網站名稱』部分。 $uri 是即將到來的請求 URL（/foo/bar）。

一旦你完成你的自訂 Valet 驅動，使用 FrameworkValetDriver.php 命名約定將它放置在 ~/.config/valet/Drivers 目錄中。例如，如果你為 WordPress 寫了一個自訂的 valet 驅動，你的檔案名稱應該是 WordPressValetDriver.php。

我們來看看自訂的 Valet 驅動程式應該實現的每種方法的範例實作。

serves 方法

如果你的驅動程式應當處理即將到來的請求時，serves 方法應該回傳true。否則，此方法應傳回 false。因此，在此方法中，你應該你企圖確定給定的 $sitePath 是否包含你嘗試提供的類型的項目。

例如，讓我們假裝正在寫一個 WordPressValetDriver。我們的serves 方法可能看起來如下：

/**
 * 确定驱动程序是否满足请求。
 *
 * @param  string  $sitePath
 * @param  string  $siteName
 * @param  string  $uri
 * @return bool
 */
 public function serves($sitePath, $siteName, $uri){ 
    return is_dir($sitePath.'/wp-admin');
    }

#isStaticFile 方法

isStaticFile 應確定即將到來的請求是否針對一個『靜態』文件，例如：圖片和樣式表。如果檔案是靜態的，此方法應傳回靜態檔案在磁碟上的完全限定路徑。如果即將到來的請求不是針對一個靜態文件，這個方法應該返回false：

/**
 * 确定即将到来的请求是否针对静态文件。
 *
 * @param  string  $sitePath
 * @param  string  $siteName
 * @param  string  $uri
 * @return string|false
 */public function isStaticFile($sitePath, $siteName, $uri){ 
    if (file_exists($staticFilePath = $sitePath.'/public/'.$uri)) { 
           return $staticFilePath;   
            } 
           return false;
        }

{note} 如果serves 方法對即將到來的請求且請求URI 不是/ 傳回true 時，才會呼叫isStaticFile 方法。

frontControllerPath 方法

#frontControllerPath 方法應該會傳回你的應用程式的『前端控制器』完全限定的路徑，它通常是你的『index.php』檔案或等效的檔案：

/**
 * 获取对应用程序的前端控制器的完全解析路径。
 *
 * @param  string  $sitePath
 * @param  string  $siteName
 * @param  string  $uri
 * @return string
 */
 public function frontControllerPath($sitePath, $siteName, $uri){
     return $sitePath.'/public/index.php';
     }

本機驅動

如果你想為單一應用程式自訂 Valet 驅動程序，在應用程式的根目錄下建立一個 LocalValetDriver.php 檔案。你的自訂驅動程式可以擴展ValetDriver 基類或繼承一個現有的應用程式的特定驅動程序，例如：LaravelValetDriver：

class LocalValetDriver extends LaravelValetDriver{   
    /**
     * 确定驱动程序是否满足请求。
     *
     * @param  string  $sitePath
     * @param  string  $siteName
     * @param  string  $uri
     * @return bool
     */ 
      public function serves($sitePath, $siteName, $uri){ 
             return true;    
             }    
    /**
     * 获取对应用程序的前端控制器的完全解析路径。
     *
     * @param  string  $sitePath
     * @param  string  $siteName
     * @param  string  $uri
     * @return string
     */
     public function frontControllerPath($sitePath, $siteName, $uri){    
         return $sitePath.'/public_html/index.php';  
           }
    }

其它Valet 指令