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 以"开发"模式运行

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.

运行应用程序

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

$ 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,它将产生以下结果。

结果

欢迎页面

这是在开发环境中运行 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 主页。