1. WIKI教程
2. 学习FuelPHP
3. FuelPHP - 安装

FuelPHP - 安装

本章介绍如何在您的计算机上安装FuelPHP框架。 FuelPHP安装非常简单方便。 您有两种方法来创建FuelPHP应用程序 -

• 第一种方法是使用名为Oil FuelPHP工具进行Command line安装。

• 第二种方法是Composer based安装。 FuelPHP使用Composer ，无论是用于安装还是用于包依赖，因此请确保在继续该过程之前在本地安装composer。

让我们在后续章节中逐一详细介绍每种方法。

系统需求 (System Requirements)

在迁移到安装之前，必须满足以下系统要求。

Web服务器（以下任何一种）

• WAMP（Windows）
• Microsoft IIS（Windows）
• LAMP（Linux）
• MAMP（Macintosh）
• XAMP（多平台）
• Nginx（多平台）
• PHP内置开发Web服务器（多平台）

浏览器支持（以下任何一种）

• IE（Internet Explorer 8+）
• Firefox
• 谷歌浏览器
• Safari

PHP compatibility - PHP 5.3或更高版本。 要获得最大收益，请使用最新版本。

让我们使用PHP的内置开发Web服务器来完成本教程。 内置的开发Web服务器易于启动，并且非常适合理解FuelPHP Web应用程序的基础知识，而不会涉及Web服务器和配置世界的复杂性。

Command Line Installation

FuelPHP的命令行安装非常简单，最多需要五分钟。

安装油包

Oil是FuelPHP框架提供的一个特殊包/命令，用于执行FuelPHP应用程序开发所需的许多任务，包括安装，开发和测试应用程序。

要安装Oil软件包，请打开shell并运行以下命令 -

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

该命令使用curl下载并安装油包。 该命令将显示类似于以下信息的结果，并最终安装油包。

 % 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是否可用并检查版本，请使用以下命令 -

$ cd HelloWorld
$ php oil -v

上面的命令产生以下结果 -

Fuel: 1.8 running in "development" mode

Oil Help Command

要获取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-based Installation

以下命令用于使用Composer安装FuelPHP。

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

Git存储库克隆

要将最新的开发版本安装为本地git存储库克隆，请使用以下命令。

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

运行应用程序

移动到项目目录公用文件夹，使用生成服务器使用以下命令运行应用程序。

$ 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 http://localhost:8080
Document root is /Users/workspace/php-fuel/HelloWorld/public
Press Ctrl-C to quit.

现在，请求URL， http://localhost:8080 ，它将产生以下结果。

结果 (Result)

这是在开发环境中运行FuelPHP应用程序的最简单方法。 如果在生产环境中以这种方式创建应用程序，则会遇到安全问题。 建议的方法是设置虚拟主机配置。 下一节将介绍apache Web服务器。

设置虚拟主机

访问FuelPHP应用程序是更安全的方式。 要设置虚拟主机，您需要将apache虚拟主机文件链接到您的应用程序。 在Intranet应用程序的情况下，将系统主机文件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主页。