Das Beispiel in diesem Artikel beschreibt, wie man eine Seite mit Symfony2 erstellt. Teilen Sie es als Referenz mit allen. Die Details lauten wie folgt:
Das Erstellen einer Seite in Symfony2 erfordert nur zwei Schritte:
1 Erstellen Sie eine Route: Die Route definiert den URI Ihrer Seite (z. B. /about) und gibt den auszuführenden Controller (PHP-Funktion) an. Wenn die URL der eingehenden Anfrage mit dieser Route übereinstimmt, führt Symfony2 den angegebenen Controller aus.
2. Erstellen Sie einen Controller: Der Controller ist eine PHP-Funktion, die die eingehende Anfrage akzeptiert und in ein Symfony2-Antwortobjekt umwandelt.
Diese einfache Implementierung gefällt uns, weil sie zur Funktionsweise des Webs passt. Jede Webinteraktion beginnt mit einer HTTP-Anfrage, und es ist die Aufgabe der Anwendung, die Anfrage einfach zu interpretieren und eine entsprechende HTTP-Antwort zurückzugeben. Symfony2 folgt diesem Prinzip und stellt Ihnen die Werkzeuge zur Verfügung, um sicherzustellen, dass Ihre Anwendung auch bei zunehmender Benutzerzahl und zunehmender Komplexität gut organisiert bleibt.
„Hallo Symfony2“-Seite
Beginnen wir mit dem klassischen „Hallo, Welt“-Programm. Wenn wir fertig sind, kann der Benutzer ein Hallo erhalten, indem er die folgende URL besucht:
http://localhost/app_dev.php/hello/Symfony
Tatsächlich können Sie Symfony für Begrüßungen in einen anderen Namen ändern. Um diese Seite zu erstellen, müssen wir nur zwei einfache Schritte ausführen:
In diesem Tutorial wird davon ausgegangen, dass Sie Symfony2 heruntergeladen und den Webserver konfiguriert haben. Die obige URL geht davon aus, dass localhost auf Ihr neues Symfony2-Projekt verweist. Einzelheiten zur Installation finden Sie unter Symfony2 installieren.
Ein Bundle erstellen
Bevor Sie beginnen, müssen Sie ein Bundle erstellen. In Symfony2 entspricht Bundle einem Plug-In und der gesamte Code in Ihrer Anwendung muss in Bundle platziert werden. Ein Bundle ist lediglich ein Verzeichnis (mit einem PHP-Namespace), dessen Inhalt sich auf eine bestimmte Funktion bezieht (siehe Bundle-System). Führen Sie den folgenden Befehl aus, um das AcmeStudyBundle (das in diesem Kapitel erstellte Spiel) zu erstellen.
php app/console Acme/StudyBundle[/]
Als nächstes wurden die folgenden Anweisungen zur Datei app/autoloader.php hinzugefügt, um sicherzustellen, dass der Acme-Namespace gebootet wird (siehe Kapitel zum automatischen Laden). :
$loader->registerNamespaces(array( 'Acme' => __DIR__.'/../src', // ... ));
Initialisieren Sie abschließend das Bundle in der Methode registerBundles() der Datei app/AppKernel.php.
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
// ...
new Acme\StudyBundle\AcmeStudyBundle(),
);
// ...
return $bundles;
}
Jetzt haben Sie Ihr Bundle eingerichtet und können Ihre Anwendung in Ihrem Bundle erstellen.
Eine Route erstellen
Standardmäßig wird die Routing-Konfigurationsdatei von Symfony2 im Verzeichnis app/config/routing.yml abgelegt. Alle Konfigurationsdateien in Symfony2 können auch im PHP- oder XML-Format geschrieben werden.
# app/config/routing.yml
homepage:
pattern: /
defaults: { _controller: FrameworkBundle:Default:index }
hello:
resource: "@AcmeStudyBundle/Resources/config/routing.yml"
Die ersten paar Zeilen der Routing-Konfigurationsdatei definieren den Code, den der Benutzer aufruft, um die Ressource „/“ (Homepage) anzufordern Interessanter ist der letzte Teil, der andere Routing-Konfigurationsdateien importiert, die sich im AcmeStudyBundle befinden.
# src/Acme/StudyBundle/Resources/config/routing.yml
hello:
pattern: /hello/{name}
defaults: { _controller: AcmeStudyBundle:Hello:index }
Die Route besteht aus zwei grundlegenden Teilen. Das Muster bestimmt, welcher URI mit dieser Route übereinstimmt, und das Standardarray gibt den auszuführenden Controller an. Der Platzhalter {name} im Muster ist ein Platzhalter, der angibt, dass ein URI wie /hello/Ryan, /hello/Fabien oder ein ähnlicher mit dieser Route übereinstimmt. Der Platzhalterparameter {name} wird auch an den Controller gesendet, damit wir seinen Wert zur Begrüßung des Benutzers verwenden können.
Das Routing-System verfügt über viele erstaunliche Funktionen beim Erstellen leistungsstarker und flexibler URL-Strukturen für Anwendungen. Weitere Informationen finden Sie unter „Symfony2-Studiennotizen: Detaillierte Erläuterung des System-Routings“
Erstellen von Controllern
Wenn ein URI wie /hello/Ryan von der Anwendung verarbeitet wird, wird die Hallo-Route abgeglichen und der AcmeStudyBundle:Hello:index-Controller wird über das Symfony2-Framework ausgeführt. Der zweite Schritt beim Erstellen der Seite besteht darin, diesen Controller zu erstellen
Ein Controller ist eigentlich nichts anderes als eine PHP-Funktion, die Sie über Symfony2 erstellen und ausführen. Dieser benutzerdefinierte Anwendungscode verwendet die Anforderungsinformationen zum Erstellen und Alles vorbereiten. Erfordert Ressourcen. Mit Ausnahme einiger fortgeschrittener Fälle ist die endgültige Ausgabe des Controllers dieselbe: ein Antwortobjekt.
// src/Acme/StudyBundle/Controller/HelloController.php
namespace Acme\StudyBundle\Controller;
use Symfony\Component\HttpFoundation\Response;
class HelloController
{
public function indexAction($name)
{
return new Response('<html><body>Hello '.$name.'!</body></html>');
}
}
Der Controller ist sehr einfach. Er erstellt ein neues Antwortobjekt. Der erste Parameter des Objekts ist der Antwortinhalt, den es zurückgibt (in diesem Fall). Beispiel ist eine kleine HTML-Seite).
Herzlichen Glückwunsch, direkt nach dem Erstellen einer Route und eines Controllers haben Sie eine voll funktionsfähige Seite! Wenn Ihre Einstellungen korrekt sind, kann Ihre Anwendung Sie begrüßen:
http://localhost/app_dev.php/hello/Ryan
Ein optionaler, aber häufig verwendeter Schritt besteht darin, eine Vorlage zu erstellen.
Controller sind der Haupteintrag und Schlüsselbestandteil beim Erstellen einer Seite. Weitere Informationen finden Sie im Kapitel „Controller“.
Vorlagen erstellen
Mit Vorlagen können Sie Ihre gesamte Präsentation (d. h. HTML-Code) in einer einzigen Datei zusammenfassen und verschiedene Abschnitte des Seitenlayouts wiederverwenden. Der folgende Code verwendet eine Vorlage, um den HTML-Code im Controller zu ersetzen.
// src/Acme/StudyBundle/Controller/HelloController.php
namespace Acme\StudyBundle\Controller;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
class HelloController extends Controller
{
public function indexAction($name)
{
return $this->render('AcmeStudyBundle:Hello:index.html.twig', array('name' => $name));
// 渲染PHP模板
// return $this->render('AcmeStudyBundle:Hello:index.html.php', array('name' => $name));
}
}
Um die render()-Methode verwenden zu können, müssen Sie die Controller-Klasse erben, die Verknüpfungsmethoden für einige häufige Aufgaben hinzufügt. Die
render()-Methode erstellt ein Response-Objekt, das mit spezifischem Inhalt gefüllt und über eine Vorlage gerendert wird. Wie bei anderen Controllern erhalten Sie am Ende ein Response-Objekt.
注意，这里有两种不同渲染模板的例子，缺省情况下，Symfony2支持两种渲染模板的方式：传统的PHP模板和简洁强大的Twig模板。你可以随意选择使用其中的一种，也可以在同一项目中混用它们，这都不成问题。
控制器渲染AcmeStudyBundle:Hello:index.html.twig模板，该模板使用以下命名约定：
Bundle名:Controller名:Template名
在本例中，AcmeStudyBundle是Bundle名，Hello是控制器，index.html.twig是模板名。
{# src/Acme/StudyBundle/Resources/views/Hello/index.html.twig #}
{% extends '::layout.html.twig' %}
{% block body %}
Hello {{ name }}!
{% endblock %}
让我们一行行地来：
第2行：extends定义了一个父模板，模板明确定义了一个将被替换的布局文件；
第4行：block表示其中的内容将会替换掉名为body的block，如我们所知，它在最终渲染时将负责layout.html.twig中名为body的block的渲染。
父模板::layout.html.twig省略了它的bundle名和控制器名（所以用两个冒号::代替），这意味着该模板在bundle外面，在app目录中。
{# app/Resources/views/layout.html.twig #}
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>{% block title %}Hello Application{% endblock %}</title>
</head>
<body>
{% block body %}{% endblock %}
</body>
</html>
基本模板文件定义了HTML布局，并用我们在index.html.twig模板中定义的名为body的区块渲染。这里还定义了一个名为title的区块，我们也可以选择在index.html.twig模板中定义。由于我们没有在子模板中定义title区块，所以它还是使用缺省值”Hello Application”。
模板在渲染和组织页面内容方面的功能非常强大，它可以是HTML标识语言、CSS代码或者控制器可能需要返回的东东。模板引擎只是达到目标的手段。每个控制器的目标是返回一个Response对象，模板虽然强大，但它却是可选的，它只是为Response对象创建内容的工具而已。
目录结构
经过前面几段的学习，你已经理解了在Symfony2中创建和渲染页面的步骤，也开始明白了Symfony2的组织和结构，在本章的最后，你将学会在哪儿找到和放置不同类型的文件以及为什么这样做。
虽然Symfony2的目录结构相当灵活，但在缺省状态下，Symfony2还是有着相同的、被推荐的基本目录结构：
app/ : 该目录包含应用程序配置；
src/ : 所有项目的PHP代码都保存在该目录下；
vendor/ : 根据约定放置所有供应商的库文件；
web/ : 这是web根目录，包括一些公众可以访问的文件。
WEB目录
web根目录是所有静态的、公共文件的家目录，包括图像、样式表和javascript文件，这里也是前端控制器所在的地方。
// web/app.php require_once __DIR__.'/../app/bootstrap.php'; require_once __DIR__.'/../app/AppKernel.php'; use Symfony\Component\HttpFoundation\Request; $kernel = new AppKernel('prod', false); $kernel->handle(Request::createFromGlobals())->send();
前端控制器（在这里是app.php）其实是一个PHP文件，在使用Symfony2应用程序时执行。它的功能就是使用内核类AppKernel，让应用程序自举。
使用前端控制器意味着要比使用传统的纯PHP程序有着更为灵活多变的URL，当使用前端控制器时，URL格式如下所示：
http://localhost/app.php/hello/Ryan
前端控制器app.php被执行，URI（/hello/Ryan）通过路由配置被内部路由。如果使用Apache的重写规则，你可以在不指定app.php的情况下强制执行它：
http://localhost/hello/Ryan
虽然前端控制器在处理请求时必不可少，但你很少会去修改甚至想到它，我们只是在环境一章中简要地提及它。
应用程序（app）目录
正如你在前端控制器所看到的那样，AppKernel类是整个应用程序的主入口，它负责所有的配置，它被保存在app/目录中。
这个类必须实现三个方法，这些方法是Symfony2需要让应用程序了解的。你甚至在一开始就无须担心这些方法，因为Symfony2会智能地为你填充它们：
1、registerBundles(): 返回所有需要在应用程序中运行的bundle数组 (参见Bundle系统 )；
2、registerContainerConfiguration(): 引导应用程序的主配置资源文件 (参见应用程序配置章节)；
3、registerRootDir(): 返回app根目录 (缺省是 app/)
在日常开发中，你会经常用到app/目录，你会在app/config/目录中修改配置和路由文件（参见应用程序配置），也会使用app/cache/目录做为应用程序的缓存目录、使用app/logs/目录做为日志目录、使用app/Resources/目录做为应用程序级别的资源目录。在下面的章节中你将会学到更多关于这些目录的内容。
自动加载
当应用程序自举时，将包含一个特殊的文件：app/autoload.php。该文件负责自动加载src/和vender/目录中的所有文件。
因为有自动加载器，你永远无须为使用include或require语句担心。Symfony2利用类的名称空间确定它的位置，并自动加载包含你所需的类文件。
$loader->registerNamespaces(array( 'Acme' => __DIR__.'/../src', // ... ));
在这个配置中，Symfony2将查找src/目录下Acme名称空间（假想公司的名称空间）的所有类。为了能够自动加载，Class Name文件和Path必须遵循同一模式：
Class Name:
Acme\StudyBundle\Controller\HelloController
Path:
src/Acme/StudyBundle/Controller/HelloController.php
app/autoload.php配置自动加载器在不同的目录查找不同的PHP名称空间，也可以在必要时自定义。有关自动加载器的更多情况，参见如何自动加载类。
源（src）目录
简而言之，src/目录包括所有在应用程序中运行的PHP代码。实际上在开发时，大部分工作都是在该目录下完成的。缺省情况下，src/目录是空的，当你开始进行开发时，你将开始填充bundle所在的目录，该目录包含你应用程序的代码。
然而bundle究竟是什么呢？
Bundle系统
Bundle与其它软件中的插件类似，但比它们更好。关键的不同点在于在Symfony2中什么都是bundle，包括框架的核心功能和你为应用程序所写的代码。在Symfony2中，Bundle是一类公民，这让使用第三方Bundle的预建功能包或发布你自己的Bundle变得十分灵活。它也可以使你很容易地选择应用程序所需功能，并用你自己的方式去优化它们。
Bundle简单来说就是在一个目录里用来实现单一功能的结构化文件集。你可以创建BlogBundle、ForumBundle或用户管理的Bundle（许多都已经以开源Bundle的形式存在）。每个目录都包含与功能相关的内容，如PHP文件、模板、样式表、Javascripts、测试等。每个Bundle都包含某种功能的方方面面，而每种功能都必须在Bundle中实现。
应用程序由在AppKernel类中的registerBundles()方法中定义的Bundle组成：
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
new Symfony\Bundle\SecurityBundle\SecurityBundle(),
new Symfony\Bundle\TwigBundle\TwigBundle(),
new Symfony\Bundle\MonologBundle\MonologBundle(),
new Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle(),
new Symfony\Bundle\DoctrineBundle\DoctrineBundle(),
new Symfony\Bundle\AsseticBundle\AsseticBundle(),
new Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle(),
new JMS\SecurityExtraBundle\JMSSecurityExtraBundle(),
// register your bundles
new Acme\StudyBundle\AcmeStudyBundle(),
);
if (in_array($this->getEnvironment(), array('dev', 'test'))) {
$bundles[] = new Symfony\Bundle\WebProfilerBundle\WebProfilerBundle();
}
return $bundles;
}
通过registerBundles()方法，你就拥有了应用程序所有Bundles的全部控制权（包含Symfony2的核心Bundle）
无论Bundle在什么地方，它都可以被Symfony2自动加载。举个例子，如果AcmeStudyBundle放在src/Acme目录中，请确保Acme的名称空间被添加到app/autoload.php文件中，并映射到src/目录，这样它就可以被Symfony2自动加载了。
创建Bundle
为了向你展示Bundle系统是如何之简单，让我们创建一个名为AcmeTestBundle的新Bundle，并激活它。
首先，创建一个src/Acme/TestBundle/ 目录，并添加一个名为AcmeTestBundle.php的新文件：
// src/Acme/TestBundle/AcmeTestBundle.php
namespace Acme\TestBundle;
use Symfony\Component\HttpKernel\Bundle\Bundle;
class AcmeTestBundle extends Bundle
{
}
AcmeTestBundle遵循Bundle命名约定
这个空类仅仅只是我们需要创建新Bundle的一部分。虽然是空的，但这个类已经足够强大，并能够用来自定义Bundle的行为。
现在我们已经创建了我们的Bundle，我们需要通过Appkernel类激活它：
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
// ...
// register your bundles
new Acme\TestBundle\AcmeTestBundle(),
);
// ...
return $bundles;
}
虽然目前它还不能做任何事情，但AcmeTestBundle现在已经可以使用了。
同样方便的是，Symfony也提供命令行接口去生成Bundle的基本框架
php app/console init:bundle "Acme\TestBundle" src
生成的Bundle框架包括一个基本控制器、模板和可自定义的路由资源。接下来我们将会讨论更多的Symfony2命令行工具。
无论何时，创建一个新的Bundle或使用第三方Bundle，都是需要确保该Bundle在registerBundles()中被激活。
Bundle的目录结构
Bundle的目录结构是简单而灵活的。缺省状态下，Bundle系统遵循Symfony2所有Bundle之间保持代码一致性的约定集。让我们看看AcmeStudyoverBundle，因为它包含了Bundle的大多数元素：
1、Controller/目录：包含该Bundle的控制器（如：HelloController.php）；
2、Resources/config/目录：配置目录，包括路由配置（如：routing.yml）；
3、Resources/views/目录：通过控制器名组织的模板（如：Hello/index.html.twig）；
4、Resources/public/目录：包含web资源（图片、样式表等），并被拷贝或软链接到项目的web/目录；
5、Tests/目录：存放该Bundle的所有测试。
根据Bundle实现的功能，它可小可大，它只包含你所需要的文件。
你在本书中还将学习到如何持久化对象到数据库、创建和验证表单、翻译你的应用程序和编写测试等等，它们在Bundle中都有自己的位置和所扮演的角色。
应用程序配置
应用程序由代表应用程序所有功能和特征的Bundle集构成。每个Bundle都可以通过YAML、XML或PHP编写的配置文件来自定义。缺省情况下，主配置文件放置在app/config/目录中，被命名为config.yml、config.xml或config.php，这取决于你所使用的格式：
# app/config/config.yml
framework:
charset: UTF-8
secret: xxxxxxxxxx
form: true
csrf_protection: true
router: { resource: "%kernel.root_dir%/config/routing.yml" }
validation: { annotations: true }
templating: { engines: ['twig'] } #assets_version: SomeVersionScheme
session:
default_locale: en
lifetime: 3600
auto_start: true
# Twig Configuration
twig:
debug: %kernel.debug%
strict_variables: %kernel.debug%
我们将在下一节环境中展示如何准确地选择要引导的文件/格式。
每一个顶级条目，如framework或twig都被配置成一个特定的Bundle。例如，framework被配置成Symfony2的核心FrameworkBundle，并包含路由、模板和其它核心系统的配置。
现在别担心配置文件中各段中的特定配置选项，配置文件缺省值都是合理的。当你浏览Symfony2的各部分时，你将学到每个部分的特定配置选项。
配置格式
纵观整个章节，所有的配置示例都用三种格式（YAML、XML和PHP）展示。它们每个都有自己的优缺点，以下是三种格式的说明：
1、YAML：简单、干净和易读
2、XML：有时比YAML更强大且支持IDE的自动完成
3、PHP：非常强大，但与标准配置格式相比易读性差
环境
应用程序可以在不同的环境中运行。不同的环境共享相同的PHP代码（由前端控制 器区分），但却有着完全不同的配置。开发环境记录警告和错误，而生产环境只记录错误。在开发环境中一些文件在每次请求之后被重构，而在生产环境中却被缓存 。所有的环境都在同一机制中生活。
虽然创建新的环境是容易的，但Symfony2项目通常会从三个环境开始（开发、测试和生产）。通过在你浏览器中改变前端控制器，你可以很方便地让应用程序在不同的环境中切换。要将应用程序切换到开发环境，只需要通过开发前端控制器去访问应用程序即可。
http://localhost/app_dev.php/hello/Ryan
如果你想看看你的应用程序在生产环境中的表现 ，可以调用生产前端控制器：
http://localhost/app.php/hello/Ryan
如果你打开 web/app.php文件，你将发现它已经很明确地被配置成使用生产环境：
$kernel = new AppCache(new AppKernel('prod', false));
你可以为一个新的环境创建一个新的前端控制器，只需要拷贝该文件，并将prod修改成其它值。
因为生产环境是为速度优化的，配置、路由和Twig模板都被编译成纯的PHP类，同时被缓存 。在生产环境中改变视图时，你需要清除这些缓存文件，从而让它们重构：
rm -rf app/cache/*
当进行自动测试时使用测试环境，它并不能从浏览器直接访问。参见测试章节以得到更多细节。
环境配置
AppKernel类负责加载你所选的配置文件：
// app/AppKernel.php
public function registerContainerConfiguration(LoaderInterface $loader)
{
$loader->load(__DIR__.'/config/config_'.$this->getEnvironment().'.yml');
}
我们已经知道.yml扩展名可以转换成.xml或.php，只要你喜欢使用XML或PHP来写配置。注意每种环境也可以加载它们自己的配置文件。下面是为生产环境准备的配置文件。
# app/config/config_dev.yml
imports:
- { resource: config.yml }
framework:
router: { resource: "%kernel.root_dir%/config/routing_dev.yml" }
profiler: { only_exceptions: false }
web_profiler:
toolbar: true
intercept_redirects: true
zend:
logger:
priority: debug
path: %kernel.logs_dir%/%kernel.environment%.log
import关键词与PHP格式中include语句一样，都是首先引导主配置文件（config.yml），文件的其它部分是为了增长的日志和其它有利于开发环境的设置而对缺省配置进行的调整。
在生产环境和测试环境都遵循同样一个模型：每个环境导入基本配置文件，然后修改它们的配置值去适应特殊环境的需要。
小结
恭喜你，你现在已经明白了Symfony2的基本原理，并惊喜地发现它是那样的方便灵活。尽管有许多的功能，但我们可以牢记以下几个基本点：
1、创建页面需要三个步骤，包括路由、控制器和模板（可选）；
2、每个应用程序都应该包含四个目录：web/（web资源和前端控制器）、app/（配置）、src/（你的Bundle）和vendor/（第三方代码）；
3、Symfony2的每个功能（包括Symfony2框架核心）都被组织进一个Bundle，Bundle是该功能的结构化文件集；
4、每个Bundle的配置都存放在app/config目录中，可以使用YAML、XML和PHP编写；
5、通过不同的前端控制器（如：app.php或app_dev.php）和配置文件，每种环境都可以被访问。
希望本文所述对大家基于Symfony框架的PHP程序设计有所帮助。
更多Symfony2创建页面实例详解相关文章请关注PHP中文网！
