Installer et configurer le framework Symfony
Bienvenue sur Symfony ! Démarrer un nouveau projet Symfony est simple et votre premier programme Symfony fonctionnel peut être configuré en quelques minutes.
Pour faciliter la création de nouveaux programmes, Symfony fournit un programme d'installation, le télécharger est votre première étape.
Installer Symfony Installer ¶
Utiliser Symfony Installer est la seule méthode recommandée pour créer un nouveau projet Symfony. Le programme d'installation n'est qu'un programme php. Vous ne devez l'installer qu'une seule fois pour créer un nombre illimité de programmes Symfony.
Le programme d'installation nécessite php5.4 ou supérieur. Si vous utilisez toujours l'ancien PHP 5.3, vous ne pouvez pas utiliser le programme d'installation Symfony.
Si vous utilisez une solution packagée telle que WAMP, XAMP ou MAMP, veuillez vérifier si elle utilise une version récente de PHP. Vous pouvez utiliser la commande suivante sur la ligne de commande pour vérifier la version PHP :
$ php --version
Selon le système d'exploitation, la méthode d'installation de l'installateur Symfony est également différente.
Systèmes Linux et MAC OS X ¶
Ouvrez l'outil de ligne de commande et exécutez la commande suivante :
$ sudo curl -LsS https://symfony.com/installer -o /usr/local/bin/symfony $ sudo chmod a+x /usr/local/bin/symfony
Cela créera une commande Symfony globale sur votre système.
Système Windows ¶
Sous Windows, exécutez la commande suivante :
c:\>php -r "readfile('http://symfony.com/installer');" > symfonyIl téléchargera un fichier symfony, puis déplacera ce fichier vers le dossier où vous souhaitez créer le projet Symfony, via Les commandes suivantes peuvent guider diverses installations : symfony文件，然后把这文件移动到你想创建Symfony项目的文件夹里，通过下述命令可引导各种安装：
c:\>move symfony c:\projects c:\projects\> php symfony
创建Symfony程序 ¶
当Symfony安装器被设置好之后，使用全新命令new来创建Symfony项目：
# Linux, Mac OS X $ symfony new my_project_name # Windows c:\> cd projects/ c:\projects\> php symfony new my_project_name
这命令创建了一个新的my_project_name
# use the most recent version in any Symfony branch 不同分支的最新版本 $symfony new my_project_name 2.8 $symfony new my_project_name 3.0 # use a specific Symfony version 指定版本 $symfony new my_project_name 2.7.3$ symfony new my_project_name 2.8.1 # use a beta or RC version (useful for testing new Symfony versions) 新版可用于测试 $symfony new my_project 3.0.0-BETA1$ symfony new my_project 2.7.0-RC1
Créer un programme Symfony ¶
new pour créer un projet Symfony : $ symfony new my_project_name lts
my_project_name, qui contient un nouveau projet basé sur la dernière version stable du programme Symfony. De plus, l'installateur vérifiera également si votre système possède les exigences techniques pour exécuter les programmes Symfony. Si ce n'est pas le cas, vous verrez une liste d'exigences pour « ce qui doit être modifié ». Faites exécuter votre programme sur une version Symfony spécifique ¶
Si vous devez exécuter le projet sur une version Symfony spécifique, utilisez la commande new avec le Deux paramètres facultatifs : new命令的同时附带第二个可选参数：
$ composer create-project symfony/framework-standard-edition my_project_name
安装器还支持一个特殊版本lts，即最新的长期维护版本Symfony LTS version
$ composer create-project symfony/framework-standard-edition my_project_name "3.0.*"
参考Symfony发布进程来深入理解为何有多种框架版本存在，以及哪种更适合你的项目。
不使用安装器来创建Symfony程序 ¶
如果你仍然在用php5.3，或者你因某种原因不能执行安装器，你可以基于composer来安装Symfony。
Composer是个依赖管理器，被现代php程序广泛使用，它也可用于安装Symfony框架。如果你不需要全局安装composer，请往下看。
全局安装Composer ¶
请参考全局安装Composer。
用Composer创建Symfony程序 ¶
若你已安装过Composer，执行create-project命令来创建基于稳定版本的Symfony程序：
$ cd my_project_name/ $ php bin/console server:run
若需指定版本，提供版本号作为create-project的第二个参数
http://localhost:8000/config.php
如果你的网络连接很慢，你可能会认为Composer没有做任何事。这时，请在前述命令中添加-vvv旗标，以输出Composer正在做的每一件事的细节。
运行Symfony ¶
在开发时，Symfony利用了PHP内置的web服务器。因此，运行Symfony程序关乎项目所在目录并执行如下命令：
$ cd my_project_name/ $ composer update
然后，打开浏览器访问http://localhost:8000/
$ php bin/console security:checkL'installateur prend également en charge une version spéciale
lts, qui est la dernière version de maintenance à long terme de Symfony version LTS# Linux, Mac OS X $ symfony demo # Windows c:\projects\> php symfony demo
Référencez le processus de publication de Symfony pour mieux comprendre pourquoi plusieurs versions de framework existent et laquelle est la mieux adaptée à votre projet. Créer des programmes Symfony sans utiliser l'installateur ¶
Si vous utilisez toujours php5.3, ou si vous ne pouvez pas exécuter l'installateur pour une raison quelconque, vous pouvez l'installer en fonction du compositeur Symfony .
Installer Composer globalement ¶Veuillez vous référer à Installer Composer globalement.
create-project pour créer un programme Symfony basé sur la version stable : #🎜🎜#$ cd my_project_name/ $ composer install#🎜🎜# Si vous devez spécifier la version, indiquez le numéro de version comme
create-projectLe deuxième paramètre de #🎜🎜#rrreee#🎜🎜#-vvv à la commande précédente pour afficher les détails de tout ce que Composer fait. #🎜🎜##🎜🎜##🎜🎜#Exécutez Symfony ¶
#🎜🎜# dans Lors du développement, Symfony tire parti du serveur Web intégré à PHP. Par conséquent, l'exécution du programme Symfony dépend du répertoire où se trouve le projet et exécutez la commande suivante : #🎜🎜#rrreee#🎜🎜# Ensuite, ouvrez le navigateur et visitez lehttp://localhost:8000/< /code> lien, et vous verrez la page d'accueil de Symfony : #🎜🎜##🎜🎜##🎜🎜##🎜🎜##🎜🎜#En plus de la page d'accueil, vous pouvez également voir des pages vierges et des pages d'erreur, qui sont généralement causés par une mauvaise configuration des autorisations du répertoire. Selon votre système d'exploitation, il existe plusieurs solutions. Ceci est expliqué dans la section « Définition des autorisations ». #🎜🎜##🎜🎜##🎜🎜##🎜🎜#Le serveur intégré PHP n'existe qu'en php5.4 et supérieur. S'il s'agit d'une ancienne version de PHP, vous devez configurer un hôte virtuel (#🎜🎜#Virtual Host#🎜🎜#) pour le projet Symfony sur le serveur web du système d'exploitation. #🎜🎜##🎜🎜##🎜🎜#La commande server:run ne convient qu'à la phase de développement. Si vous utilisez un serveur web traditionnel tel qu'Apache ou Nginx, référez-vous à l'article Configurer un serveur web. server:run命令只适合于开发阶段。如果你使用传统的web服务器比如Apache或Nginx，参考配置web服务器这篇文章。
检查Symfony运行环境的配置 ¶
Symfony程序内置了一个服务器环境检查器，用来显示有关设置是否适合于Symfony。访问下面链接即可检查：
rrreee如果显示有问题，在继续使用Symfony之前修复它们。
更新Symfony程序 ¶
至此，你已创建了可以立即投入开发的全功能Symfony项目。Symfony程序依赖的是大量外部类库，它们可以下载到vendor/目录下，并且被Composer进行排他管理。
频繁更新这些三方类库是最佳实践，可以防止bug和漏洞。执行Composer的update
Vérifiez la configuration de l'environnement d'exécution de Symfony ¶
Le programme Symfony dispose d'un vérificateur d'environnement de serveur intégré pour montrer si les paramètres pertinents sont adaptés à Symfony. Vérifiez-le en visitant le lien ci-dessous : rrreee
S'il y a des problèmes d'affichage, corrigez-les avant de continuer à utiliser Symfony. À ce stade, vous avez créé un projet Symfony entièrement fonctionnel qui peut être mis en développement immédiatement. Les programmes Symfony s'appuient sur un grand nombre de bibliothèques de classes externes, téléchargeables dans le répertoire vendor/ et gérées exclusivement par Composer. 🎜La mise à jour fréquente de ces bibliothèques tierces est une bonne pratique pour éviter les bugs et les vulnérabilités. Exécutez la commande update de Composer pour les mettre à jour tous en même temps : 🎜rrreee🎜Selon la complexité du projet, cette méthode de mise à jour prendra plusieurs minutes. 🎜🎜🎜🎜Symfony fournit également une commande pour vérifier si les dépendances du projet contiennent des vulnérabilités de sécurité majeures connues : 🎜rrreee🎜Exécuter régulièrement cette commande est une bonne habitude, car ces immunités peuvent être mises à jour ou remplacées le plus rapidement possible. Faible dépendance. 🎜🎜🎜Installez le programme de démonstration Symfony ¶
Le programme de démonstration Symfony est entièrement fonctionnel et démontre l'approche de développement recommandée. Il est conçu comme un outil d'apprentissage pour les débutants Symfony, avec des commentaires détaillés et des conseils utiles dans le code source.
Pour télécharger le programme de démonstration, depuis n'importe où sur votre système, exécutez la commande demo de l'installateur Symfony : demo命令：
rrreee一旦下载完毕，进入symfony_demo目录，并运行PHP内置web server，执行php bin/console server:run命令，然后访问浏览器的http://localhost:8000链接，即可开始使用Symfony演示程序。
安装Symfony分发包 ¶
Symfony项目的“分发包”，是指全功能的程序，包括了Symfony核心类库，一组必备的bundles，一套合理的目录结构，以及一些默认的配置。实际上，当你按之前的介绍创建了Symfony程序之后，你已经下载了由Symfony提供的默认分发包——被称为Symfony标准版（Symfony Standard Edition）。
Symfony标准版，是目前最普及的分发，也是Symfony开发者的首选。不过，Symfony社区也提供了其他分发包供你选择使用。
Symfony CMF标准版是需要Symfony CMF的首选分发包，CMF是基于Symfony的开源项目，方便开发者向框架添加CMS（内容管理系统）功能。
Symfony REST Edition展示了如何构建一个RESTFul API程序，该分发整合了FOSRestBundle和其他几个关联bundles。
使用源码控制 ¶
如果你正使用Git这样的版本控制系统，你可以安全提交你的全部项目代码。这是因为Symfony程序中已经包含了一个专门准备给Symfony的.gitignore文件。
对于把你的项目代码托管到Git“究竟有多好”的介绍，参考如何创建和存储一个Symfony项目到Git中。
检查版本化的Symfony程序 ¶
当你使用Composer来管理程序的依赖时，推荐在提交代码到宝库时，忽略掉整个的vendor文件夹。这意味着当你从Git宝库中查看Symfony程序时，里面是没有vendor目录的，当然整个程序也是难以启动的。
若要令程序运行，检查Symfony程序，然后执行install这个Composer命令，下载和安装程序所需的全部依赖：
rrreee为何Composer知道要安装哪个特殊的依赖？这是因为当Symfony程序被提交到宝库时，composer.json和composer.lock文件也被提交。这两个文件告诉了Composer在安装Symfony时需要哪些依赖（及其特定版本）。
开始开发 ¶
现在你有了一个全功能的Symfony程序，可以开始开发了！你的分发包中包含了一些样例代码 - 查看程序中的README.mdrrreee
Une fois téléchargé, allez dans le répertoire symfony_demo et exécutez PHP a un serveur Web intégré, exécutez la commande php bin/console server:run, puis accédez au lien http://localhost:8000 du navigateur pour commencer à utiliser Symfony programme de démonstration. 🎜🎜Installer le package de distribution Symfony ¶🎜🎜Le « package de distribution » du projet Symfony fait référence à un programme complet, comprenant la bibliothèque de classes de base Symfony, un ensemble de bundles nécessaires, une structure de répertoires raisonnable et quelques configurations par défaut. En fait, lorsque vous créez le programme Symfony comme décrit ci-dessus, vous avez téléchargé le package de distribution par défaut fourni par Symfony - appelé Symfony Standard Edition (Symfony Standard Edition). 🎜🎜Symfony Standard Edition est actuellement la distribution la plus populaire et le premier choix des développeurs Symfony. Cependant, la communauté Symfony propose également d'autres packages de distribution parmi lesquels vous pouvez choisir. 🎜- 🎜Symfony CMF Standard Edition est le package de distribution préféré qui nécessite Symfony CMF est un projet open source basé sur Symfony, qui permet aux développeurs d'ajouter des fonctions CMS (système de gestion de contenu) au framework. 🎜
- 🎜Symfony REST Edition montre comment créer un programme API RESTFul Cette distribution intègre FOSRestBundle et plusieurs autres bundles associés. 🎜
🎜Utilisez le contrôle du code source ¶🎜🎜Si vous utilisez un système de contrôle de version comme Git, vous pouvez soumettre en toute sécurité tout le code de votre projet. En effet, le programme Symfony contient déjà un fichier .gitignore spécialement préparé pour Symfony. 🎜🎜Pour une introduction à la qualité de l'hébergement du code de votre projet dans Git, consultez Comment créer et stocker un projet Symfony dans Git. 🎜Vérifier les programmes Symfony versionnés ¶
🎜Lorsque vous utilisez Composer pour gérer les dépendances de programmes, il est recommandé d'ignorer l'intégralité du dossier vendor lors de la soumission du code au référentiel. Cela signifie que lorsque vous affichez le programme Symfony à partir du référentiel Git, il ne contient aucun répertoire vendor et, bien sûr, l'ensemble du programme est difficile à démarrer. 🎜🎜Pour exécuter le programme, vérifiez le programme Symfony, puis exécutez la commande install Composer pour télécharger et installer toutes les dépendances requises pour le programme : 🎜rrreee🎜Pourquoi Composer sait-il quelle dépendance spéciale utiliser installer? En effet, lorsqu'un programme Symfony est soumis au référentiel, les fichiers composer.json et composer.lock sont également soumis. Ces deux fichiers indiquent à Composer quelles dépendances (et leurs versions spécifiques) sont requises lors de l'installation de Symfony. 🎜🎜Commencez à développer ¶🎜🎜Maintenant que vous disposez d'un programme Symfony entièrement fonctionnel, vous êtes prêt à commencer à développer ! Votre package de distribution comprend des exemples de code - consultez le fichier README.md dans le programme (ouvert avec le Bloc-notes) pour plus de détails sur les routines du package de distribution. 🎜Si vous êtes nouveau sur Symfony, reportez-vous à Création de votre première page Symfony, où vous pourrez apprendre à créer des pages, modifier les configurations et tout ce que vous souhaitez faire dans votre nouveau programme.
