FuelPHP - Instalação

Este capítulo explica como instalar o framework FuelPHP em sua máquina. A instalação do FuelPHP é muito simples e fácil. Você tem dois métodos para criar aplicativos FuelPHP -

O primeiro método é Command line instalação usando a ferramenta FuelPHP chamada Oil.
O segundo método é Composer basedinstalação. FuelPHP usaComposer, tanto para instalação quanto para dependências de pacote, portanto, certifique-se de que o composer esteja instalado localmente antes de continuar o processo.

Vamos examinar cada um dos métodos, um por um, em detalhes nas seções subsequentes.

Requisitos de sistema

Antes de passar para a instalação, os seguintes requisitos de sistema devem ser satisfeitos.

Servidor da Web (qualquer um dos seguintes)

WAMP (Windows)
Microsoft IIS (Windows)
LAMP (Linux)
MAMP (Macintosh)
XAMP (multiplataforma)
Nginx (multiplataforma)
Servidor da web de desenvolvimento embutido em PHP (multiplataforma)

Suporte ao navegador (qualquer um dos seguintes)

IE (Internet Explorer 8+)
Firefox
Google Chrome
Safari

PHP compatibility- PHP 5.3 ou posterior. Para obter o máximo benefício, use a versão mais recente.

Vamos usar o servidor web de desenvolvimento embutido do PHP para este tutorial. O servidor web de desenvolvimento embutido é fácil de iniciar, bem como bastante adequado para entender os fundamentos da aplicação web FuelPHP sem entrar na complexidade do mundo do servidor web e configurações.

Instalação de linha de comando

A instalação da linha de comando do FuelPHP é muito fácil e leva no máximo cinco minutos.

Instale o pacote de óleo

Oil é um pacote / comando especial fornecido pelo framework FuelPHP para fazer muitas tarefas necessárias no desenvolvimento de um aplicativo FuelPHP, incluindo instalação, desenvolvimento e teste do aplicativo.

Para instalar o Oil pacote, abra um shell e execute o seguinte comando -

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

O comando usa curl para baixar e instalar o pacote de óleo. O comando mostrará um resultado semelhante às informações a seguir e, finalmente, instalará o pacote de óleo.

% 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

Crie um novo projeto

Para criar um novo projeto usando Oil, use o seguinte comando -

oil create <project_name>

Vamos criar um novo projeto chamado “HelloWorld” usando o seguinte comando.

oil create HelloWorld

Agora, você pode ver uma resposta semelhante à seguinte e, finalmente, criar um aplicativo de esqueleto simples para 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

Versão do óleo

Para testar se o óleo está disponível e verificar a versão, use o seguinte comando -

$ cd HelloWorld
$ php oil -v

O comando acima produz o seguinte resultado -

Fuel: 1.8 running in "development" mode

Comando de ajuda de óleo

Para obter a documentação de ajuda básica do Oil, use o seguinte comando -

$ php oil help

O comando acima irá mostrar a documentação de ajuda semelhante ao seguinte resultado -

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

A partir de agora, você tem uma ideia de como instalar Combustível com Óleo. Vamos examinar a instalação baseada no composer na próxima seção.

Instalação baseada no Composer

O seguinte comando é usado para instalar o FuelPHP usando o Composer.

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

Clones de repositório Git

Para instalar a versão de desenvolvimento mais recente como clones do repositório git local, use o seguinte comando.

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

Executando o aplicativo

Mova para a pasta pública do diretório do projeto, execute o aplicativo usando o servidor de produção com o seguinte comando.

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

Ele produz a seguinte resposta.

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.

Agora, solicite o URL, http://localhost:8080 e produzirá o seguinte resultado.

Resultado

Esta é a maneira mais simples de executar o aplicativo FuelPHP no ambiente de desenvolvimento. Se você criar seu aplicativo dessa maneira no ambiente de produção, terá problemas de segurança. A maneira recomendada é definir uma configuração de host virtual. É explicado para o servidor web apache na próxima seção.

Configurando um Host Virtual

É uma maneira mais segura de acessar o aplicativo FuelPHP. Para configurar um host virtual, você precisa vincular o arquivo de host virtual do Apache ao seu aplicativo. No caso do aplicativo de intranet, redirecione a URL do arquivo do host do sistema para o host virtual.

Arquivo de host virtual

Abra o host virtual e adicione as seguintes alterações.

<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>