[Laravel 學習筆記] 安裝 Laravel 教學

本系列 Laravel 教學筆記將參酌 Laravel 4 From Scratch、Laravel 5 From Scratch、Laravel  官網和 Laravel 中文官網 相關資訊進行撰寫（以 Laravel 4 From Scratch 為主）。本篇將記錄安裝 Laravel 教學。

Laravel 是一個 PHP 網頁應用程式框架，其優雅的語法、模版引擎和強大的 Routing 功能讓開發者可以更輕鬆的撰寫富健壯性的網站應用程式。

在安裝 Laravel 之前我們必須先安裝 Composer (Composer 是一 PHP 套件相依管理系統，使用 JSON 格式撰寫，而欲安裝的 PHP 相關套件可以在 Packagist 搜尋到)

安裝 Composer PHAR (PHP archive)有幾種方式，我們選擇安裝在 Global，這樣就可以在任何地方使用。安裝指令如下，將下載下來的檔案遷移(mv)到 /usr/local/bin/composer 後可以讓它在 terminal 直接輸入 composer 使用，而不用輸入 php composer.phar。

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

如果是 Mac 系統也可以使用 homebrew 進行安裝

brew update
brew tap homebrew/dupes
brew tap homebrew/php
brew install composer

在安裝完 Composer 後可以在打開的 terminal 中輸入 Composer ，若沒有出現錯誤並顯示相關指令訊息就算安裝成功囉！

為了測試 Composer 的相關功能，我們可以先建立一個測試資料夾：

mkdir composer-demo
cd composer-demo

在安裝完 Composer 後可以在打開的 terminal 中輸入 Composer ，若沒有出現錯誤並顯示相關指令訊息就算安裝成功囉！我們在使用 faker 這個套件(提供假資料方便做資料庫 seeding或是寫測試時相當方便)當做功能測試。

使用方法如下(fzaninotto 是 vendor 名稱/ faker 是 package 名稱)： 

composer require fzaninotto/faker 

下完指令後將產生 composer.json(專案相關資訊，包含所引入的檔案和版本)、composer.lock(限定安裝的套件版本，安裝指定版本會以此為優先) 和 vendor 資料夾，相關 require 資訊也寫在 composer.json 檔案中：

{
    "require": {
        "fzaninotto/faker": "~1.4"
    }
}

接下來透過下述指令就可以讀取 composer.json 資訊進行套件安裝進入vendor 和 autoload files 中

composer install 

由於 autoload files 已經處理了 namespace 問題，在使用套件也十分方便，可以透過創一個 index.php 示範檔案並引入 autoload 就可以使用套件囉(Faker套件使用說明可以看這)：
<?php
require 'vendor/autoload.php';
$faker = Faker\Factory::create();
echo $faker->name;
?>
接著在 terminal 中輸入就會看見產生的假資料啦：

php index.php

若需要 update 套件版本和重新更新 composer.lock 檔案就可以使用：

composer update

That's it ! 有關 Composer 基礎使用是這樣，若有問題可以參考官方網站文件，接下來我們回到 Laravel 的安裝教學上面。

首先，我們使用 composer 安裝 laravel 到整個系統中：

composer global require "laravel/installer=~1.1"

記得要將 ~/.composer/vendor/bin 放置到$PATH環境變數中，根據你的作業系統可能會有所不同(可能是 ~/.bash_profile、~/.bashrc 或 ~/.zshrc)，也可以使用以下指令： 

export PATH="~/.composer/vendor/bin"

這樣一來安裝整個系統都可以使用 laravel 指令進行操作！

若你想建立新的 Laravel 專案，可以輸入以下指令(兩種都可以，但 composer 的指令可以使用較新版本)，就可以建立新的專案啦(專案中應用程式開發多半使用 app 目錄，裡面包含了 views（視圖）、controllers（控制器） 還有 models（模型） 等目錄。而設定檔則存在 app/config 這個目錄中)

laravel new project-name

也可以使用 composer 建立新的 Laravel 專案

composer create-project laravel/laravel project-name github-branch

若成功建立裝案就可以移動到資料夾中在 terminal 輸入以下指令，若成功可以看到 Laravel development server started on http://localhost:8000 訊息 (ctrl + c 可跳)：

php artisan serve 

此時開啟瀏覽器輸入 http://localhost:8000，若沒問題就可以看到安裝成功畫面啦，接下來就準備開發成為網頁藝術家吧(Artisan)！

因會需要用到 Mcrypt PHP extension，若是遇到 Mcrypt PHP extension required. 安裝問題可以參考。此外，Laravel 框架有一個目錄需要額外設置權限：app/storage 需要讓網頁伺服器有寫入的權限。That's it ! 接下來我們要講解如何設置開發環境。

參考文件：
1. Laravel 中文官網
2. Laravel  官網
3. Laravel 4 From Scratch
4. Laravel 5 From Scratch
5. In Laravel how to use snake case for database table columns and camel case for model attributes
6. Laravel安裝教學
7. Shengyou Fan