> For the complete documentation index, see [llms.txt](https://tony915.gitbook.io/laravel-4-2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tony915.gitbook.io/laravel-4-2/into-laravel/install-laravel.md). # 建立 Laravel 專案 建立 Laravel 專案有 3 種方式，可以擇一使用： * 使用 Laravel Installer * 使用 Composer Create-Project * 手動下載 ## 1. 使用 Laravel Installer Laravel Installer 只需要安裝一次，之後就可以直接使用它來建立專案。首先，使用 composer 來下載 Laravel Installer，在終端機中執行以下指令： ``` composer global require "laravel/installer=~1.1" ``` 執行完畢後，會將 laravel 工具指令安裝在 **\~/.composer/vendor/bin** 目錄之下，記得把這個路徑加入你的 PATH 中，之後就能使用這個指令。 ### 如何將 Laravel Installer 加入 PATH 在終端機輸入 vim \~/.bash\_profile 指令，會打開設定檔， 在上面可能會有 0 到多行的 export ... 的命令，直接接在最後一行之下，輸入(記得先按下 i 來切換為編輯模式)： ``` export PATH=/Users/你的使用者名稱/.composer/vendor/bin:$PATH ``` 這樣就會把剛才安裝的 laravel 指令目錄，加到原有 PATH 的前面。完成以後按 esc 輸入 :wq 存檔離開。把終端機關閉後重開，在終端機下輸入 ``` echo $PATH ``` 應該可以看到剛才加入的目錄路徑。 ### 建立 Laravel 專案／網站 接下來就可以使用 laravel 指令來建立專案／網站了，這裡的 Laravel 專案等於一個網站。切換到你想存放網站的目錄下(通常會是 Apache 伺服器的網站目錄)，假設你想要建立的網站名稱為 blog，在終端機中輸入： ``` laravel new blog ``` 如此就會建立一個名為 blog 的網站(需要網路連線，可能會需要一點時間才會完成)。這個方法除了第一次需安裝指令外，使用上是最快速的，是比較推薦的方法。 ### 開啟網站 如果你的 Laravel 專案建立在伺服器的網站目錄下，這時候在瀏覽器中輸入網址： ``` http://localhost/blog/public/ ``` 應該就可以看到這個熱騰騰剛建立的網站了。預設首頁會是這樣： ![](https://2143920249-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M48rwYB4_KhIVG8EBhp%2F-M49JjoezbujiTyFIL6l%2F-M49SNWybIALnDVHzSyl%2Flaravel_you_have_arrived.png?alt=media\&token=490dc59b-b7b4-4c60-b843-71d4f1ce4aa7) 如果你沒有伺服器，也可以使用 Laravel 內建的伺服器。 ### 使用 Laravel 內建的伺服器 首先，進入剛才建立的 blog 網站目錄，輸入指令： ``` php artisan serve ``` 接著在瀏覽器上輸入它給的網址： ``` http://localhost:8000 ``` 就可以看到網站了。這個終端機必須保持開啟，如果要結束伺服器的話，請輸入 Ctrl + C 就會關閉。 ## 2. 使用 Composer Create-Project 你也可以直接使用 Composer 來建立網站。指令如下： ``` composer create-project laravel/laravel 你的網站名稱 --prefer-dist ``` 這個指令會直接下載並安裝一個 Laravel 網站的副本，存放在 "你的網站名稱" 目錄之下。 ## 3. 手動建立 前面 2 個方法都是透過指令來操作，你也可以直接到 [Laravel repository from GitHub 下載 Laravel zip 檔 ](https://github.com/laravel/laravel/archive/master.zip)\[1]。 將 zip 檔解壓縮到你的網頁目錄，並且更改成你想要的目錄名稱。這個目錄目前只包含 Laravel 的主程式，所以我們還必須下載它的相依套件。 ### 安裝相依套件 在終端機中，使用 cd 指令進入這個目錄，ls 指令會看到 composer.json，這個檔案就是要告訴 composer 要下載哪些相依套件。在目錄中執行 composer install ，就會開始下載安裝相依的套件，請保持網路連線，這會需要一些時間。之後如果要更新，可以輸入 composer update。 * \[1]