FuelPHP - 安裝

本章介紹如何在你的機器上安裝 FuelPHP 框架。FuelPHP 的安裝非常簡單易行。你有兩種方法可以建立 FuelPHP 應用程式：

第一種方法是使用名為 **Oil** 的 FuelPHP 工具進行 **命令列** 安裝。
第二種方法是基於 **Composer** 的安裝。FuelPHP 使用 **Composer** 進行安裝和管理包依賴，因此請確保在繼續操作之前已本地安裝 Composer。

讓我們在後續章節中詳細介紹每種方法。

系統要求

在開始安裝之前，必須滿足以下系統要求。

Web 伺服器（以下任一）：

WAMP (Windows)
Microsoft IIS (Windows)
LAMP (Linux)
MAMP (Macintosh)
XAMP (跨平臺)
Nginx (跨平臺)
PHP 內建開發 Web 伺服器 (跨平臺)

瀏覽器支援（以下任一）：

IE (Internet Explorer 8+)
Firefox
Google Chrome
Safari

**PHP 相容性** - PHP 5.3 或更高版本。為了獲得最佳效果，請使用最新版本。

在本教程中，我們將使用 PHP 的內建開發 Web 伺服器。內建開發 Web 伺服器易於啟動，並且足以理解 FuelPHP Web 應用程式的基礎知識，而無需深入瞭解 Web 伺服器和配置的複雜性。

命令列安裝

FuelPHP 的命令列安裝非常簡單，最多隻需五分鐘。

安裝 Oil 包

Oil 是 FuelPHP 框架提供的一個特殊包/命令，用於執行 FuelPHP 應用程式開發中所需的許多工，包括安裝、開發和測試應用程式。

要安裝 **Oil** 包，請開啟 shell 並執行以下命令：

sudo curl https://get.fuelphp.com/oil | sh

此命令使用 curl 下載並安裝 oil 包。該命令將顯示類似於以下資訊的結果，並最終安裝 oil 包。

 % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current 
                                 Dload  Upload   Total   Spent    Left  Speed 
100   479  100   479    0     0    353      0  0:00:01  0:00:01 --:--:--   353

建立新專案

要使用 Oil 建立新專案，請使用以下命令：

oil create <project_name>

讓我們使用以下命令建立一個名為“HelloWorld”的新專案。

oil create HelloWorld

現在，您將看到類似於以下的響應，並最終建立一個簡單的 FuelPHP 應用程式框架。

composer create-project fuel/fuel HelloWorld 
Installing fuel/fuel (1.8.0.1) 
   - Installing fuel/fuel (1.8.0.1) 
      Loading from cache  

Created project in HelloWorld  

Loading composer repositories with package information 
Updating dependencies (including require-dev) 
   - Installing composer/installers (v1.3.0) 
      Loading from cache
   - Installing fuelphp/upload (2.0.6) 
      Loading from cache  
   - Installing michelf/php-markdown (1.4.0) 
      Loading from cache  
   - Installing psr/log (1.0.2) 
      Loading from cache  
   - Installing monolog/monolog (1.18.2) 
      Loading from cache  
   - Installing phpseclib/phpseclib (2.0.0) 
      Loading from cache  
   - Installing fuel/core (1.8.0.4) 
      Loading from cache  
   - Installing fuel/auth (1.8.0.4) 
      Loading from cache  
   - Installing fuel/email (1.8.0.4) 
      Loading from cache  
   - Installing fuel/oil (1.8.0.4) 
      Loading from cache  
   - Installing fuel/orm (1.8.0.1) 
      Loading from cache  
   - Installing fuel/parser (1.8.0.4) 
      Loading from cache  
   - Installing fuel/docs (1.8.0.4) 
      Loading from cache
   ……………. 
   …………….  
   Writing lock file
   Generating autoload files

Oil 版本

要測試 Oil 是否可用並檢查版本，請使用以下命令：

$ cd HelloWorld
$ php oil -v

以上命令將產生以下結果：

Fuel: 1.8 running in "development" mode

Oil 幫助命令

要獲取 Oil 的基本幫助文件，請使用以下命令：

$ php oil help

以上命令將顯示類似於以下結果的幫助文件：

Usage: 
   php oil [cell|console|generate|package|refine|help|server|test]  
Runtime options: 
   -f, [--force]    # Overwrite files that already exist 
   -s, [--skip]     # Skip files that already exist 
   -q, [--quiet]    # Supress status output 
   -t, [--speak]    # Speak errors in a robot voice  
Description:   
   The 'oil' command can be used in several ways to facilitate quick development, help 
   with testing your application and for running Tasks.  
Environment: 
   If you want to specify a specific environment oil has to run in, overload the 
   environment variable on the commandline: FUEL_ENV=staging php oil <commands>
More information: 
   You can pass the parameter "help" to each of the defined command to get 
   information about that specific command: php oil package help  
Documentation:   
   http://docs.fuelphp.com/packages/oil/intro.html

目前，您已經瞭解瞭如何使用 Oil 安裝 Fuel。讓我們在下一節中介紹基於 Composer 的安裝。

基於 Composer 的安裝

以下命令用於使用 Composer 安裝 FuelPHP。

$ composer create-project fuel/fuel --prefer-dist.

Git 倉庫克隆

要將最新的開發版本安裝為本地 Git 倉庫克隆，請使用以下命令。

$ composer create-project fuel/fuel:dev-1.9/develop --prefer-source.

執行應用程式

移動到專案目錄的 public 資料夾，使用以下命令執行生產伺服器上的應用程式。

$ cd path/to/HelloWorld/public
$ php -S localhost:8080 index.php

它會產生以下響應。

PHP 5.5.31 Development Server started at Sun May 21 12:26:10 2017
Listening on https://:8080
Document root is /Users/workspace/php-fuel/HelloWorld/public
Press Ctrl-C to quit.

現在，請求 URL，**https://:8080**，它將產生以下結果。

結果

這是在開發環境中執行 FuelPHP 應用程式的最簡單方法。如果您在生產環境中以這種方式建立應用程式，將會面臨安全問題。推薦的方法是設定虛擬主機配置。下一節將針對 Apache Web 伺服器進行說明。

設定虛擬主機

這是訪問 FuelPHP 應用程式更安全的方法。要設定虛擬主機，您需要將 Apache 虛擬主機檔案連結到您的應用程式。對於內聯網應用程式，請將系統主機檔案 URL 重定向到虛擬主機。

虛擬主機檔案

開啟虛擬主機並新增以下更改。

<VirtualHost *:80> 
   ServerName hello.app 
   DocumentRoot /path/to/public 
   SetEnv FUEL_ENV “development”
   
   <Directory /path/to/public> 
      DirectoryIndex index.php 
      AllowOverride All 
      Order allow,deny 
      Allow from all 
   </Directory> 
</VirtualHost>

系統主機檔案

現在，使用以下命令向您的機器新增主機條目。

sudo vi /etc/hosts

然後，將以下行新增到檔案的末尾。

127.0.0.1 hello.app

要使所有更改生效，請重新啟動 Apache 伺服器並請求 url，**http://hello.app**。它將顯示 FuelPHP 首頁。

列印頁面