カスタム Valet ドライバー

独自の Valet 「ドライバー」を作成して、Valet が本来サポートしていない他のフレームワークまたは CMS 上で実行される PHP アプリケーションにサービスを提供できます。 Valet をインストールすると、SampleValetDriver.php ファイルを含むディレクトリ ~/.config/valet/Drivers が作成されます。このファイルには、カスタム ドライバーの作成方法を示すサンプル ドライバー実装が含まれています。ドライバーを作成するには、serves、isStaticFile、および frontControllerPath の 3 つのメソッドを実装するだけで済みます。

3 つのメソッドはすべて、$sitePath、$siteName、および $uri の値をパラメーターとして受け入れます。 $sitePath は、サイトにサービスを提供するマシン上の完全修飾パスです。たとえば、/Users/Lisa/Sites/my-project です。 $siteName は、ドメイン (my-project) の「ホスト」/「サイト名」の部分です。 $uri は受信リクエスト URL (/foo/bar) です。

カスタム Valet ドライバーが完成したら、FrameworkValetDriver.php 命名規則を使用して、それを ~/.config/valet/Drivers ディレクトリに配置します。たとえば、WordPress 用のカスタム バレット ドライバーを作成した場合、ファイル名は 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 Method

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} を返す必要があります。受信リクエスト そして、isStaticFile メソッドは、リクエスト URI が / ではなく、true が返された場合にのみ呼び出されます。

メソッド

このメソッドは、アプリケーションの完全な「フロント コントローラー」を返す必要があります。修飾されたパス。通常は「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 コマンド