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>

Arquivo de host do sistema

Agora, adicione uma entrada de host à sua máquina usando o seguinte comando.

sudo vi /etc/hosts

Em seguida, adicione a seguinte linha ao final do arquivo.

127.0.0.1 hello.app

Para disponibilizar todas as mudanças, reinicie seu servidor Apache e solicite o url, http://hello.app. Ele produz a página inicial do FuelPHP.