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.