FuelPHP - Instalación

Este capítulo explica cómo instalar el framework FuelPHP en su máquina. La instalación de FuelPHP es muy simple y fácil. Tiene dos métodos para crear aplicaciones FuelPHP:

  • El primer método es Command line instalación usando la herramienta FuelPHP llamada Oil.

  • El segundo método es Composer basedinstalación. Usos de FuelPHPComposer, tanto para la instalación como para las dependencias de paquetes, así que asegúrese de que el compositor esté instalado localmente antes de continuar con el proceso.

Repasemos cada uno de los métodos uno por uno en detalle en las secciones siguientes.

Requisitos del sistema

Antes de pasar a la instalación, deben cumplirse los siguientes requisitos del sistema.

Servidor web (cualquiera de los siguientes)

  • WAMP (Windows)
  • Microsoft IIS (Windows)
  • LÁMPARA (Linux)
  • MAMP (Macintosh)
  • XAMP (multiplataforma)
  • Nginx (multiplataforma)
  • Servidor web de desarrollo PHP incorporado (multiplataforma)

Compatibilidad con navegador (cualquiera de los siguientes)

  • IE (Internet Explorer 8+)
  • Firefox
  • Google Chrome
  • Safari

PHP compatibility- PHP 5.3 o posterior. Para obtener el máximo beneficio, utilice la última versión.

Usemos el servidor web de desarrollo incorporado de PHP para este tutorial. El servidor web de desarrollo integrado es fácil de iniciar y bastante adecuado para comprender los conceptos básicos de la aplicación web FuelPHP sin entrar en la complejidad del mundo del servidor web y las configuraciones.

Instalación de la línea de comandos

La instalación de la línea de comandos de FuelPHP es muy fácil y toma un máximo de cinco minutos.

Instale el paquete de aceite

Oil es un paquete / comando especial proporcionado por el marco de FuelPHP para realizar muchas tareas necesarias en el desarrollo de la aplicación FuelPHP, incluida la instalación, el desarrollo y la prueba de la aplicación.

Para instalar el Oil paquete, abra un shell y ejecute el siguiente comando:

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

El comando usa curl para descargar e instalar el paquete de aceite. El comando mostrará un resultado similar a la siguiente información y finalmente instalará el paquete de aceite.

% 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

Crear un proyecto nuevo

Para crear un nuevo proyecto usando Oil, use el siguiente comando:

oil create <project_name>

Creemos un nuevo proyecto llamado "HelloWorld" usando el siguiente comando.

oil create HelloWorld

Ahora, puede ver una respuesta similar a la siguiente y finalmente crear una aplicación esqueleto simple de 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

Versión de aceite

Para probar si hay aceite disponible y verificar la versión, use el siguiente comando:

$ cd HelloWorld
$ php oil -v

El comando anterior produce el siguiente resultado:

Fuel: 1.8 running in "development" mode

Comando de ayuda de aceite

Para obtener la documentación de ayuda básica de Oil, utilice el siguiente comando:

$ php oil help

El comando anterior mostrará la documentación de ayuda similar al siguiente 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 ahora, tiene una idea de cómo instalar combustible usando aceite. Repasemos la instalación basada en compositor en la siguiente sección.

Instalación basada en Composer

El siguiente comando se usa para instalar FuelPHP usando Composer.

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

Clones del repositorio de Git

Para instalar la última versión de desarrollo como clones del repositorio de git local, use el siguiente comando.

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

Ejecutando la Aplicación

Vaya a la carpeta pública del directorio del proyecto, ejecute la aplicación usando el servidor de producción con el siguiente comando.

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

Produce la siguiente respuesta.

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.

Ahora, solicite la URL, http://localhost:8080 y producirá el siguiente resultado.

Resultado

Esta es la forma más sencilla de ejecutar la aplicación FuelPHP en el entorno de desarrollo. Si crea su aplicación de esta manera en el entorno de producción, enfrentará problemas de seguridad. La forma recomendada es establecer una configuración de host virtual. Se explica para el servidor web apache en la siguiente sección.

Configuración de un host virtual

Es una forma más segura de acceder a la aplicación FuelPHP. Para configurar un host virtual, debe vincular el archivo de host virtual de Apache a su aplicación. En el caso de una aplicación de intranet, redirija la URL del archivo de host del sistema al host virtual.

Archivo de host virtual

Abra el host virtual y agregue los siguientes cambios.

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

Archivo de host del sistema

Ahora, agregue una entrada de host a su máquina usando el siguiente comando.

sudo vi /etc/hosts

Luego, agregue la siguiente línea al final del archivo.

127.0.0.1 hello.app

Para que todos los cambios estén disponibles, reinicie su servidor Apache y solicite la URL, http://hello.app. Produce la página de inicio de FuelPHP.