安装
本章介绍如何在您的计算机上安装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主页。