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 主页。