安裝 · laravel 5.4

[TOC] [TOC] [TOC] [TOC] <article><h1>Laravel 安裝指南</h1><ul><li><a href="#installation">安裝</a><ul><li><a href="#server-requirements">服務器要求</a></li><li><a href="#installing-laravel">安裝 Laravel</a></li><li><a href="#configuration">配置</a></li></ul></li><li><a href="#web-server-configuration">Web 服務器配置</a><ul><li><a href="#pretty-urls">優雅鏈接</a></li></ul></li></ul><p><a name="installation"></a></p><h2><a href="#installation">安裝</a></h2><blockquote class="has-icon video"><p><div class="flag"><span class="svg"><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="68.9px" height="59.9px" viewBox="0 0 68.9 59.9" enable-background="new 0 0 68.9 59.9" xml:space="preserve"><path fill="#FFFFFF" d="M63.7 0H5.3C2.4 0 0 2.4 0 5.3v49.3c0 2.9 2.4 5.3 5.3 5.3h58.3c2.9 0 5.3-2.4 5.3-5.3V5.3C69 2.4 66.6 0 63.7 0zM5.3 4h58.3c0.7 0 1.3 0.6 1.3 1.3V48H4V5.3C4 4.6 4.6 4 5.3 4zM13 52v4h-2v-4H13zM17 52h2v4h-2V52zM23 52h2v4h-2V52zM29 52h2v4h-2V52zM35 52h2v4h-2V52zM41 52h2v4h-2V52zM4 54.7V52h3v4H5.3C4.6 56 4 55.4 4 54.7zM63.7 56H47v-4h18v2.7C65 55.4 64.4 56 63.7 56zM26 38.7c0.3 0.2 0.7 0.3 1 0.3 0.4 0 0.7-0.1 1-0.3l17-10c0.6-0.4 1-1 1-1.7s-0.4-1.4-1-1.7l-17-10c-0.6-0.4-1.4-0.4-2 0s-1 1-1 1.7v20C25 37.7 25.4 38.4 26 38.7zM29 20.5L40.1 27 29 33.5V20.5z"></path></svg></span></div> 你是一個喜歡看視頻的學習者么？ Laracasts 為剛剛使用這個框架的新手們提供了一個 <a href="https://laracasts.com/series/laravel-from-scratch-2017">免費、深入的 Laravel視頻</a> 。這是一個開始你學習之途的好地方。</p></blockquote><p><a name="server-requirements"></a></p><h3>服務器要求</h3><p>Laravel 框架會有一些系統上的要求。當然，這些要求在 <a href="/docs/5.4/homestead">Laravel Homestead</a> 虛擬機上都已經完全配置好了。所以，非常推薦你使用 Homestead 作為你的本地 Laravel 開發環境。</p><p>然而，如果你沒有使用 Homestead ，你需要確保你的服務器上安裝了下面的幾個拓展：</p><div class="content-list"><ul><li>PHP >= 5.6.4</li><li>OpenSSL PHP Extension</li><li>PDO PHP Extension</li><li>Mbstring PHP Extension</li><li>Tokenizer PHP Extension</li><li>XML PHP Extension</li></ul></div><blockquote><p>譯者注：強烈推薦使用 Homestead 作為開發環境，尤其是新手，可以避免很多不必要的麻煩。線上環境可以參考 <a href="https://github.com/laravel/settler/blob/master/scripts/provision.sh">Homestead 的環境部署腳本</a> 進行部署。</p></blockquote><p><a name="installing-laravel"></a></p><h3>安裝 Laravel</h3><p>Laravel 使用 <a href="https://getcomposer.org">Composer</a> 來管理代碼依賴。所以，在使用 Laravel 之前，請先確認你的電腦上安裝了 Composer。</p><h4>通過 Laravel 安裝工具</h4><p>首先，使用 Composer 下載 Laravel 安裝包：</p><pre class=" language-php"><code class=" language-php">composer <span class="token keyword">global</span> <span class="token keyword">require</span> <span class="token string">"laravel/installer"</span></code></pre><p>請確定你已將 <code class=" language-php"><span class="token operator">~</span><span class="token operator">/</span><span class="token punctuation">.</span>composer<span class="token operator">/</span>vendor<span class="token operator">/</span>bin</code> 路徑加到 PATH，只有這樣系統才能找到 <code class=" language-php">laravel</code> 的執行文件。</p><p>一旦安裝完成，就可以使用 <code class=" language-php">laravel <span class="token keyword">new</span></code> 命令在指定目錄創建一個新的 Laravel 項目，例如：<code class=" language-php">laravel <span class="token keyword">new</span> <span class="token class-name">blog</span></code> 將會在當前目錄下創建一個叫 <code class=" language-php">blog</code> 的目錄，此目錄里面存放著新安裝的 Laravel 和代碼依賴。這個方法的安裝速度比通過 Composer 安裝要快上許多：</p><pre class=" language-php"><code class=" language-php">laravel <span class="token keyword">new</span> <span class="token class-name">blog</span></code></pre><p>因為代碼依賴是直接一起打包安裝的。</p><h4>通過 Composer Create-Project</h4><p>除此之外，你也可以通過 Composer 在命令行運行 <code class=" language-php">create<span class="token operator">-</span>project</code> 命令來安裝 Laravel：</p><pre class=" language-php"><code class=" language-php">composer create<span class="token operator">-</span>project <span class="token operator">--</span>prefer<span class="token operator">-</span>dist laravel<span class="token operator">/</span>laravel blog</code></pre><h4>本地開發服務器</h4><p>如果你在本地安裝了 PHP，你可能希望像運行 PHP 內置的開發服務器一樣來訪問自己的應用程序，你可以使用 <code class=" language-php">serve</code> Artisan 命令來啟動一個本地開發服務器，這樣你就可以在 <code class=" language-php">http<span class="token punctuation">:</span><span class="token operator">/</span><span class="token operator">/</span>localhost<span class="token punctuation">:</span><span class="token number">8000</span></code> 來訪問它。</p><pre class=" language-php"><code class=" language-php">php artisan serve</code></pre><p>不過有更健壯的本地開發選項可用，比如 <a href="/docs/5.4/homestead">Homestead</a> 和 <a href="/docs/5.4/valet">Valet</a>。</p><p><a name="configuration"></a></p><h3>配置</h3><h4>入口目錄</h4><p>在安裝 Laravel 之后，你需要配置你的 Web 服務器的根目錄為 <code class=" language-php"><span class="token keyword">public</span></code> 目錄。這個目錄的 <code class=" language-php">index<span class="token punctuation">.</span>php</code> 文件作為所有 HTTP 請求進入應用的前端處理器。</p><h4>配置文件</h4><p>Laravel 框架所有的配置文件都存放在 <code class=" language-php">config</code> 目錄下。每個選項都被加入文檔，所以你可以自由的瀏覽文件，輕松的熟悉你的選項。</p><h4>目錄權限</h4><p>安裝 Laravel 之后，你需要配置一些權限。 <code class=" language-php">storage</code> 和 <code class=" language-php">bootstrap<span class="token operator">/</span>cache</code> 目錄應該允許你的 Web 服務器寫入，否則 Laravel 將無法寫入。如果你使用 <a href="/docs/5.4/homestead">Homestead</a> 虛擬機，這些權限應該已經被設置好了。</p><h4>應用程序密鑰</h4><p>在你安裝完 Laravel 后，首先需要做的事情是設置一個隨機字符串的密鑰。假設你是通過 Composer 或是 Laravel 安裝工具安裝的 Laravel，那么這個密鑰已經通過 <code class=" language-php">key<span class="token punctuation">:</span>generate</code> 命令幫你設置完成。</p><p>通常這個密鑰會有 32 字符長。這個密鑰可以被設置在 .env 環境文件中。如果你還沒將 .env.example 文件重命名為 .env，那么你現在應該去設置下。<strong>如果你沒有設置應用程序密鑰，你的用戶 Session 和其他加密數據將不安全！</strong></p><h4>額外配置</h4><p>Laravel 幾乎不需做任何其它設置就可以馬上使用，但是建議你先瀏覽 <code class=" language-php">config<span class="token operator">/</span>app<span class="token punctuation">.</span>php</code> 文件和對應的文檔，這里面包含著一些選項，如 <code class=" language-php">時區</code> 和 <code class=" language-php">語言環境</code>，你可以根據應用程序的情況來修改。</p><p>你也可以設置 Laravel 的幾個附加組件，像是：</p><ul><li><a href="/docs/5.4/cache#configuration">緩存</a></li><li><a href="/docs/5.4/database#configuration">數據庫</a></li><li><a href="/docs/5.4/session#configuration">Session</a></li></ul><p>一旦 Laravel 安裝完成，你應該立即 <a href="/docs/5.4/installation#environment-configuration">設置本機環境</a>。</p><p><a name="web-server-configuration"></a></p><h2><a href="#web-server-configuration">Web 服務器配置</a></h2><p><a name="pretty-urls"></a></p><h3>優雅鏈接</h3><h4>Apache</h4><p>Laravel 框架通過 <code class=" language-php"><span class="token keyword">public</span><span class="token operator">/</span><span class="token punctuation">.</span>htaccess</code> 文件來讓 URL 不需要 <code class=" language-php">index<span class="token punctuation">.</span>php</code> 即可訪問。在 Apache 啟用 Laravel 之前，請確認是否有開啟 mod_rewrite 模塊，以便 <code class=" language-php"><span class="token punctuation">.</span>htaccess</code> 文件發揮作用。</p><p>如果 Laravel 附帶的 .htaccess 文件在 Apache 中無法使用的話，請嘗試下方的做法：</p><pre class=" language-php"><code class=" language-php">Options <span class="token operator">+</span>FollowSymLinks RewriteEngine On RewriteCond <span class="token operator">%</span><span class="token punctuation">{</span><span class="token constant">REQUEST_FILENAME</span><span class="token punctuation">}</span> <span class="token operator">!</span><span class="token operator">-</span>d RewriteCond <span class="token operator">%</span><span class="token punctuation">{</span><span class="token constant">REQUEST_FILENAME</span><span class="token punctuation">}</span> <span class="token operator">!</span><span class="token operator">-</span>f RewriteRule <span class="token operator">^</span> index<span class="token punctuation">.</span>php <span class="token punctuation">[</span>L<span class="token punctuation">]</span></code></pre><h4>Nginx</h4><p>如果你使用 Nginx ，在你的網站配置中加入下述代碼將會轉發所有的請求到 <code class=" language-php">index<span class="token punctuation">.</span>php</code> 前端控制器。</p><pre class=" language-php"><code class=" language-php">location <span class="token operator">/</span> <span class="token punctuation">{</span> try_files <span class="token variable">$uri</span> <span class="token variable">$uri</span><span class="token operator">/</span> <span class="token operator">/</span>index<span class="token punctuation">.</span>php<span class="token operator">?</span><span class="token variable">$query_string</span><span class="token punctuation">;</span> <span class="token punctuation">}</span></code></pre><p>當然如果你使用了 <a href="/docs/5.4/homestead">Homestead</a> 或者 <a href="/docs/5.4/valet">Valet</a> 的話，它會自動的幫你設置好優雅鏈接。</p></article>