建立 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/

應該就可以看到這個熱騰騰剛建立的網站了。預設首頁會是這樣:

如果你沒有伺服器,也可以使用 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 檔 [1]。

將 zip 檔解壓縮到你的網頁目錄,並且更改成你想要的目錄名稱。這個目錄目前只包含 Laravel 的主程式,所以我們還必須下載它的相依套件。

安裝相依套件

在終端機中,使用 cd 指令進入這個目錄,ls 指令會看到 composer.json,這個檔案就是要告訴 composer 要下載哪些相依套件。在目錄中執行 composer install ,就會開始下載安裝相依的套件,請保持網路連線,這會需要一些時間。之後如果要更新,可以輸入 composer update。