Valet · laravel 5.4

<article><h1>Laravel 的開發環境 Valet</h1><ul><li><a href="#introduction">簡介</a><ul><li><a href="#valet-or-homestead">選擇 Valet 還是 Homestead</a></li></ul></li><li><a href="#installation">安裝</a><ul><li><a href="#upgrading">升級</a></li></ul></li><li><a href="#serving-sites">服務站點</a><ul><li><a href="#the-park-command">「Park」命令</a></li><li><a href="#the-link-command">「Link」命令</a></li><li><a href="#securing-sites">通過TLS讓站點更安全</a></li></ul></li><li><a href="#sharing-sites">分享站點</a></li><li><a href="#custom-valet-drivers">自定義 Valet 驅動</a></li><li><a href="#other-valet-commands">其他 Valet 命令</a></li></ul><a name="introduction"></a><h2><a href="#introduction">簡介</a></h2>Valet 是為 Mac 提供的極簡主義開發環境，沒有 Vagrant ，也無需 <code class=" language-php">/etc/hosts</code> 文件，甚至可以使用本地隧道公開共享你的站點。Yeah, we like it too.Laravel Valet 會在你的 Mac 上將 <a href="https://www.nginx.com/">Nginx</a> 設置為隨系統啟動后臺運行，然后使用 <a href="https://en.wikipedia.org/wiki/Dnsmasq">DnsMasq</a> ， Valet 將所有的請求代理到 <code class=" language-php">*.dev</code> 域名并指向本地安裝的站點目錄。換句話說，一個速度極快的 Laravel 開發環境僅僅需要占用 7MB 內存。 Valet 并不是想要替代 Vagrant 或者 Homestead，只是提供另外一種選擇，更加靈活、方便、以及占用更小的內存。開箱即用， Valet 為我們提供以下軟件和工具支持，然而不僅限于此：<div class="content-list"><ul><li><a href="https://laravel.com">Laravel</a></li><li><a href="https://lumen.laravel.com">Lumen</a></li><li><a href="https://symfony.com">Symfony</a></li><li><a href="https://framework.zend.com">Zend</a></li><li><a href="https://cakephp.org">CakePHP 3</a></li><li><a href="https://wordpress.org">WordPress</a></li><li><a href="https://roots.io/bedrock/">Bedrock</a></li><li><a href="https://craftcms.com">Craft</a></li><li><a href="https://statamic.com">Statamic</a></li><li><a href="http://jigsaw.tighten.co">Jigsaw</a></li><li>Static HTML</li></ul></div>當然，你還可以通過 <a href="#custom-valet-drivers">自定義驅動</a> 來擴展 Valet.<a name="valet-or-homestead"></a><h3>選擇 Valet 還是 Homestead</h3>正如你所知道的， Laravel 提供另外一個開發環境 <a href="/docs/5.4/homestead">Homestead</a> ， Homestead 和 Valet 不同之處在于兩者的目標受眾和本地開發方式。 Homestead 提供一個完整的包含自動化配置 Nginx 的 Ubuntu 虛擬機。如果你需要一個完整的虛擬化 Linux 開發環境或者是使用 Windows / Linux 操作系統，那么 Homestead 無疑是最佳選擇。Valet 只支持 Mac ，并且要求本地安裝 PHP 和數據庫服務器，這可以通過使用 <a href="http://brew.sh/">Homebrew</a> 命令 <code class=" language-php">brew install php71</code> 和 <code class=" language-php">brew install mysql</code> 輕松實現。 Valet 通過最小的資源消耗提供一個本地極速開發環境，如果你只需要 PHP / MySQL 而不是完整的虛擬化開發環境，那么 Valet 將是最好的選擇。Valet 和 Homestead 都是配置你本地 Laravel 開發環境的好幫手。選擇使用哪一個取決于你的個人喜好和團隊需求。<a name="installation"></a><h2><a href="#installation">安裝</a></h2>Valet 要求 macOS 和 <a href="http://brew.sh/">Homebrew</a> 安裝之前，你需要確保沒有其他程序如 Apache 或者 Nginx 占用你本地機器的 80 端口。安裝步驟如下：<div class="content-list"><ul><li>安裝或更新 <a href="http://brew.sh/">Homebrew</a> 到最新版本，使用命令 <code class=" language-php">brew update</code></li><li>使用命令 <code class=" language-php">brew install homebrew/php/php71</code> 安裝 PHP 7.1 。</li><li>通過 <code class=" language-php">composer global require laravel/valet</code> 命令安裝 Valet 。請確定 <code class=" language-php">~/.composer/vendor/bin</code> 存在于你的系統環境變量「PATH」中。</li><li>運行 <code class=" language-php">valet install</code> 命令。它將會配置并安裝 Valet 和 DnsMasq ，并且將 Valet 的進程注冊為隨系統啟動</li></ul></div>一旦你完成 Valet 安裝，嘗試使用像 <code class=" language-php">ping foobar.dev</code> 這樣的命令在終端 ping 任意的 <code class=" language-php">*.dev</code> 域名。如果 Valet 正常安裝你會看到來自 <code class=" language-php">127.0.0.1</code> 的響應Valet 將會在每次系統啟動時自動啟動，而不需要你每次運行 <code class=" language-php">valet start</code> 或 <code class=" language-php">valet install</code>。<h4>使用其他的頂級域名</h4>默認情況下， Valet 使用 <code class=" language-php">.dev</code> 頂級域名。如果你喜歡其他域名，可以使用 <code class=" language-php">valet domain tld-name</code> 命令。例如，如果你想要使用 <code class=" language-php">.app</code> 來代替 <code class=" language-php">.dev</code> ，運行 <code class=" language-php">valet domain app</code> 然后 Valet 會自動使用 <code class=" language-php">*.app</code> 來為你的項目命名。<h4>數據庫</h4>如果你需要一個數據庫，可以使用 <code class=" language-php">brew install mariadb</code> 命令試一試 MySQL 。你可以使用 host 為 <code class=" language-php">127.0.0.1</code> ，用戶名 <code class=" language-php">root</code> ，密碼為空進行數據庫連接。<a name="upgrading"></a><h3>升級</h3>你可以使用 <code class=" language-php">composer global update</code> 命令升級你的 Valet 程序，升級之后，最好使用 <code class=" language-php">valet install</code> 命令更新 Valet 的配置文件。<h4>升級到 Valet 2.0</h4>Valet 2.0 將 Valet 的底層 Web 服務從 Caddy 切換到了 Nginx 。在你升級到這個版本之前你應該運行下面的命令來停止并卸載已經啟動的 Caddy 進程：<pre class=" language-php"><code class=" language-php">valet stop valet uninstall</code></pre>接下來，你應該升級到 Valet 的最新版本。取決于你安裝 Valet 的方式，這通常通過 Git 或 Composer 來實現。如果你是通過 Composer 安裝的 Valet 你應該使用下面的命令來更新到最新的主版本：<pre class=" language-php"><code class=" language-php">composer global require laravel/valet</code></pre>當新的 Valet 源代碼下載好了之后，你應該運行 <code class=" language-php">install</code> 命令：<pre class=" language-php"><code class=" language-php">valet install valet restart</code></pre>在升級之后，它需要 re-park 或 re-link 你的站點。<a name="serving-sites"></a><h2><a href="#serving-sites">服務站點</a></h2>當 Valet 安裝完成，你就可以啟動服務站點。 Valet 為此提供了兩個命令：<code class=" language-php">park</code> 和 <code class=" language-php">link</code><a name="the-park-command"></a><code class=" language-php">park</code> 命令<div class="content-list"><ul><li>在你的 Mac 中創建一個新的目錄，例如 <code class=" language-php">mkdir ~/Sites</code> 。然后 <code class=" language-php">cd ~/Sites</code> 并且運行 <code class=" language-php">valet park</code> 。這個命令將在當前所在目錄作為 Web 根目錄， Valet 將會在這個目錄中搜索站點。</li><li>接下來，在這個目錄中創建一個新的 Laravel 站點： <code class=" language-php">laravel new blog</code> 。</li><li>在瀏覽器中訪問 <code class=" language-php">http://blog.dev</code> 。</li></ul></div>這就是我們所要做的全部工作。現在，所有在 Site 目錄中的 Laravel 項目都可以通過 <code class=" language-php">http://folder-name.dev</code> 這種方式訪問，是不是很方便。<a name="the-link-command"></a><code class=" language-php">link</code> 命令link 命令也被用來服務你的 Laravel 站點。這個命令在你想要在目錄中提供單個站點是很有用。<div class="content-list"><ul><li>要使用這個命令，在你的終端中切換到你的某個項目并運行 <code class=" language-php">valet link app-name</code> 。 Valet 將會在 <code class=" language-php">~/.valet/Sites</code> 中創建一個符號鏈接并指向當前工作目錄。</li><li>運行完 <code class=" language-php">link</code> 命令, 你可以在瀏覽器中通過 <code class=" language-php">http://app-name.dev</code> 來訪問站點。</li></ul></div>要查看所有的鏈接目錄，運行 <code class=" language-php">valet links</code> 命令。你也可以通過 <code class=" language-php">valet unlink app-name</code> 來刪除符號鏈接。<blockquote class="has-icon tip"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="56.6px" height="87.5px" viewBox="0 0 56.6 87.5" enable-background="new 0 0 56.6 87.5" xml:space="preserve"><path fill="#FFFFFF" d="M28.7 64.5c-1.4 0-2.5-1.1-2.5-2.5v-5.7 -5V41c0-1.4 1.1-2.5 2.5-2.5s2.5 1.1 2.5 2.5v10.1 5 5.8C31.2 63.4 30.1 64.5 28.7 64.5zM26.4 0.1C11.9 1 0.3 13.1 0 27.7c-0.1 7.9 3 15.2 8.2 20.4 0.5 0.5 0.8 1 1 1.7l3.1 13.1c0.3 1.1 1.3 1.9 2.4 1.9 0.3 0 0.7-0.1 1.1-0.2 1.1-0.5 1.6-1.8 1.4-3l-2-8.4 -0.4-1.8c-0.7-2.9-2-5.7-4-8 -1-1.2-2-2.5-2.7-3.9C5.8 35.3 4.7 30.3 5.4 25 6.7 14.5 15.2 6.3 25.6 5.1c13.9-1.5 25.8 9.4 25.8 23 0 4.1-1.1 7.9-2.9 11.2 -0.8 1.4-1.7 2.7-2.7 3.9 -2 2.3-3.3 5-4 8L41.4 53l-2 8.4c-0.3 1.2 0.3 2.5 1.4 3 0.3 0.2 0.7 0.2 1.1 0.2 1.1 0 2.2-0.8 2.4-1.9l3.1-13.1c0.2-0.6 0.5-1.2 1-1.7 5-5.1 8.2-12.1 8.2-19.8C56.4 12 42.8-1 26.4 0.1zM43.7 69.6c0 0.5-0.1 0.9-0.3 1.3 -0.4 0.8-0.7 1.6-0.9 2.5 -0.7 3-2 8.6-2 8.6 -1.3 3.2-4.4 5.5-7.9 5.5h-4.1H28h-0.5 -3.6c-3.5 0-6.7-2.4-7.9-5.7l-0.1-0.4 -1.8-7.8c-0.4-1.1-0.8-2.1-1.2-3.1 -0.1-0.3-0.2-0.5-0.2-0.9 0.1-1.3 1.3-2.1 2.6-2.1H41C42.4 67.5 43.6 68.2 43.7 69.6zM37.7 72.5H26.9c-4.2 0-7.2 3.9-6.3 7.9 0.6 1.3 1.8 2.1 3.2 2.1h4.1 0.5 0.5 3.6c1.4 0 2.7-0.8 3.2-2.1L37.7 72.5z"></path></svg></div> 你可以通過使用 <code class=" language-php">valet link</code> 將多個（子）域名指向同一個應用，要添加子域名或其它域名到應用，可以在應用目錄下運行 <code class=" language-php">valet link subdomain.app-name</code> 。</blockquote><a name="securing-sites"></a>通過TLS讓站點更安全默認的情況下， Valet 通過純 HTTP 協議服務網站。然而，如果你想利用 HTTP/2 提供加密的 TLS ，你可以使用 <code class=" language-php">secure</code> 命令。例如，你有一個站點 <code class=" language-php">laravel.dev</code> ，可以使用以下命令讓其更安全：<pre class=" language-php"><code class=" language-php">valet secure laravel</code></pre>想恢復一個站點到普通的 HTTP 使用 <code class=" language-php">unsecure 命令</code>，這個命令可以去除 secure 增加的安全加密：<pre class=" language-php"><code class=" language-php">valet unsecure laravel</code></pre><a name="sharing-sites"></a><h2><a href="#sharing-sites">分享站點</a></h2>Valet 還提供一個命令將本地站點分享給其他人，這不需要任何額外安裝軟件即可實現。要分享站點，在你的終端中切換到站點目錄使用 <code class=" language-php">valet share</code> 命令。這會生成一個可以公開訪問的 URL 并插入你的剪切板，以便你直接粘貼到瀏覽器，就是這么簡單。要停止分享站點，使用 <code class=" language-php">Control + C</code> 快捷組合鍵即可。<blockquote class="has-icon note"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></div> <code class=" language-php">valet share</code> 目前尚不支持分享使用 <code class=" language-php">valet secure</code> 命令進行安全處理的站點。</blockquote><a name="custom-valet-drivers"></a><h2><a href="#custom-valet-drivers">自定義 Valet 驅動</a></h2>你可以編寫自定義的 Valet 「驅動」運行非原生支持的其他 PHP 框架或 CMS 。安裝完 Valet 時會創建一個 <code class=" language-php">~/.valet/Drivers</code> 目錄，該目錄中有一個 <code class=" language-php">SampleValetDriver.php</code> 文件。這個文件中簡單演示如何編寫自定義驅動。編寫驅動只需要實現三個方法： <code class=" language-php">serves</code> ，<code class=" language-php">isStaticFile</code> 和 <code class=" language-php">frontControllerPath</code> 。這三個方法都接收 <code class=" language-php">$sitePath</code> ，<code class=" language-php">$siteName</code> 和 <code class=" language-php">$uri</code> 作為參數。 <code class=" language-php">$sitePath</code> 表示站點的絕對路徑，例如 <code class=" language-php">/Users/Lisa/Sites/my-project</code> 。 <code class=" language-php">$siteName</code> 表示站點的「host」/ 「站點名稱」部分，如 (<code class=" language-php">my-project</code>) 。 <code class=" language-php">$uri</code> 則是輸入的請求 URI，如 (<code class=" language-php">/foo/bar</code>) 。編寫好你的自定義 Valet 驅動，將其放到 <code class=" language-php">~/.valet/Drivers</code> 目錄并遵循 <code class=" language-php">FrameworkValetDriver.php</code> 這種命名規范。例如，如果編寫一個自定義的 WordPress 驅動，對應的文件名稱應是 <code class=" language-php">WordPressValetDriver.php</code> 。下面我們來具體討論并演示自定義 Valet 驅動需要實現的三個方法。<h4><code class=" language-php">serves</code> 方法</h4>如果自定義驅動要繼續處理輸入請求， <code class=" language-php">serves</code> 方法應該返回 <code class=" language-php">true</code> ，否則該方法返回 <code class=" language-php">false</code> 。因此，這個方法應該判斷給定的 <code class=" language-php">$sitePath</code> 是否是包含你服務項目的類型。例如，假設我們編寫的是 <code class=" language-php">WordPressValetDriver</code> 。那么對應的 serves 方法如下：<pre class=" language-php"><code class=" language-php">/** * 判斷驅動服務請求 * * @param string $sitePath * @param string $siteName * @param string $uri * @return bool */ public function serves($sitePath, $siteName, $uri) { return is_dir($sitePath.'/wp-admin'); }</code></pre><h4><code class=" language-php">isStaticFile</code> 方法</h4><code class=" language-php">isStaticFile</code> 應該判斷進入的請求是否是靜態文件，例如圖片或者樣式文件，如果文件是靜態的，該方法會返回磁盤上的絕對路徑，否則返回 <code class=" language-php">false</code>:<pre class=" language-php"><code class=" language-php">/** * 判斷請求內容是否是靜態文件。 * * @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; }</code></pre><blockquote class="has-icon note"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></div> <code class=" language-php">isStaticFile</code> 方法只有在 <code class=" language-php">serves</code> 方法返回 <code class=" language-php">true</code> 并且請求 URI 不是 <code class=" language-php">/</code> 才會被調用。</blockquote><h4><code class=" language-php">frontControllerPath</code> 方法</h4><code class=" language-php">frontControllerPath</code> 方法應該返回「前端控制器」的絕對路徑，通常是你的「index.php」文件或其他同等文件:<pre class=" language-php"><code class=" language-php">/** * 獲取應用前端控制器絕對路徑。 * * @param string $sitePath * @param string $siteName * @param string $uri * @return string */ public function frontControllerPath($sitePath, $siteName, $uri) { return $sitePath.'/public/index.php'; }</code></pre><a name="other-valet-commands"></a><h2><a href="#other-valet-commands">其他 Valet 命令</a></h2><table><thead><tr><th>命令</th><th>描述</th></tr></thead><tbody><tr><td><code class=" language-php">valet forget</code></td><td>在某個站點根路徑運行該命令可在根目錄列表中移除該目錄</td></tr><tr><td><code class=" language-php">valet paths</code></td><td>查看所有站點根路徑</td></tr><tr><td><code class=" language-php">valet restart</code></td><td>重啟</td></tr><tr><td><code class=" language-php">valet start</code></td><td>啟動</td></tr><tr><td><code class=" language-php">valet stop</code></td><td>停止</td></tr><tr><td><code class=" language-php">valet uninstall</code></td><td>卸載</td></tr></tbody></table><h2>譯者署名</h2><table><thead><tr><th>用戶名</th><th>頭像</th><th>職能</th><th>簽名</th></tr></thead><tbody><tr><td><a href="https://laravel-china.org/users/1232">@lybc</a></td><td><img class="avatar-66 rm-style" src="https://dn-phphub.qbox.me/uploads/avatars/1232_1469434413.jpg?imageView2/1/w/100/h/100"></td><td>翻譯</td><td>有用是有趣的前提</td></tr></tbody></table></article>