FuelPHP - Installation

Ce chapitre explique comment installer le framework FuelPHP sur votre machine. L'installation de FuelPHP est très simple et facile. Vous avez deux méthodes pour créer des applications FuelPHP -

  • La première méthode est Command line installation à l'aide de l'outil FuelPHP appelé Oil.

  • La deuxième méthode est Composer basedinstallation. Utilisations de FuelPHPComposer, à la fois pour l'installation et pour les dépendances de package, assurez-vous donc que le composeur est installé localement avant de poursuivre le processus.

Passons en revue chacune des méthodes une par une en détail dans les sections suivantes.

Configuration requise

Avant de passer à l'installation, les exigences système suivantes doivent être satisfaites.

Serveur Web (l'un des éléments suivants)

  • WAMP (Windows)
  • Microsoft IIS (Windows)
  • LAMPE (Linux)
  • MAMP (Macintosh)
  • XAMP (multi-plateforme)
  • Nginx (multi-plateforme)
  • Serveur Web de développement intégré PHP (Multi-plateforme)

Prise en charge du navigateur (l'un des éléments suivants)

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

PHP compatibility- PHP 5.3 ou version ultérieure. Pour en tirer le meilleur parti, utilisez la dernière version.

Utilisons le serveur Web de développement intégré de PHP pour ce didacticiel. Le serveur Web de développement intégré est facile à démarrer et tout à fait adéquat pour comprendre les bases de l'application Web FuelPHP sans entrer dans la complexité du monde du serveur Web et des configurations.

Installation en ligne de commande

L'installation en ligne de commande de FuelPHP est très simple et prend au maximum cinq minutes.

Installer le paquet d'huile

Oil est un package / commande spécial fourni par le framework FuelPHP pour effectuer de nombreuses tâches nécessaires au développement de l'application FuelPHP, y compris l'installation, le développement et le test de l'application.

Pour installer le Oil package, ouvrez un shell et exécutez la commande suivante -

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

La commande utilise curl pour télécharger et installer le package d'huile. La commande affichera un résultat similaire aux informations suivantes et installera enfin le package d'huile.

% 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

Créer un nouveau projet

Pour créer un nouveau projet en utilisant Oil, utilisez la commande suivante -

oil create <project_name>

Créons un nouveau projet nommé «HelloWorld» à l'aide de la commande suivante.

oil create HelloWorld

Maintenant, vous pouvez voir une réponse similaire à la suivante et enfin créer une simple application FuelPHP squelette.

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

Version d'huile

Pour tester si l'huile est disponible et pour vérifier la version, utilisez la commande suivante -

$ cd HelloWorld
$ php oil -v

La commande ci-dessus produit le résultat suivant -

Fuel: 1.8 running in "development" mode

Commande d'aide à l'huile

Pour obtenir la documentation d'aide de base de Oil, utilisez la commande suivante -

$ php oil help

La commande ci-dessus affichera la documentation d'aide similaire au résultat suivant -

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

À partir de maintenant, vous avez une idée de la façon d'installer le carburant utilisant de l'huile. Passons en revue l'installation basée sur le compositeur dans la section suivante.

Installation basée sur Composer

La commande suivante est utilisée pour installer FuelPHP à l'aide de Composer.

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

Clones du référentiel Git

Pour installer la dernière version de développement en tant que clones de référentiel git local, utilisez la commande suivante.

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

Exécution de l'application

Accédez au dossier public du répertoire du projet, exécutez l'application à l'aide du serveur de production avec la commande suivante.

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

Il produit la réponse suivante.

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.

Maintenant, demandez l'URL, http://localhost:8080 et cela produira le résultat suivant.

Résultat

C'est le moyen le plus simple d'exécuter l'application FuelPHP dans l'environnement de développement. Si vous créez votre application de cette manière dans l'environnement de production, vous serez confronté à des problèmes de sécurité. La méthode recommandée consiste à configurer une configuration d'hôte virtuel. Il est expliqué pour le serveur Web Apache dans la section suivante.

Configuration d'un hôte virtuel

C'est un moyen plus sûr d'accéder à l'application FuelPHP. Pour configurer un hôte virtuel, vous devez lier le fichier d'hôte virtuel apache à votre application. Dans le cas d'une application intranet, redirigez l'URL du fichier hôte système vers l'hôte virtuel.

Fichier hôte virtuel

Ouvrez l'hôte virtuel et ajoutez les modifications suivantes.

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

Fichier hôte système

Maintenant, ajoutez une entrée d'hôte à votre machine à l'aide de la commande suivante.

sudo vi /etc/hosts

Ensuite, ajoutez la ligne suivante à la fin du fichier.

127.0.0.1 hello.app

Pour rendre toutes les modifications disponibles, redémarrez votre serveur Apache et demandez l'url, http://hello.app. Il produit la page d'accueil FuelPHP.