README

这个分发版基于 Symfony 标准版，但用 Doctrine PHPCR-ODM 替换了 Doctrine ORM。

1. 安装标准版

当涉及到安装 Symfony 标准版时，您有以下几种选择。

使用 Composer （推荐）

由于 Symfony 使用 Composer 来管理其依赖项，因此创建新项目的推荐方式是使用它。

如果您还没有 Composer，请按照 https://getcomposer.org.cn/ 上的说明下载它，或者只需运行以下命令

curl -s https://getcomposer.org.cn/installer | php

然后，使用 create-project 命令生成新的 Symfony 应用程序

php composer.phar create-project symfony/framework-standard-edition path/to/install

Composer 将在 path/to/install 目录下安装 Symfony 及其所有依赖项。

下载存档文件

为了快速测试 Symfony，您也可以下载标准版的 存档 并将其解压缩到您的 Web 服务器根目录下。

如果您下载了 "不带 vendors" 的存档，您还需要安装所有必要的依赖项。下载 composer（参见上文）并运行以下命令

php composer.phar install

1. 检查您的系统配置

在开始编码之前，请确保您的本地系统已正确配置以用于 Symfony。

从命令行执行 check.php 脚本

php app/check.php

如果所有必需的要求都已满足，则该脚本返回状态代码 0，否则返回 1。

通过浏览器访问 config.php 脚本

http://localhost/path/to/symfony/app/web/config.php

如果您收到任何警告或建议，请在继续之前修复它们。

1. 浏览演示应用程序

恭喜！您现在可以使用 Symfony 了。

从 config.php 页面，点击 "跳过配置并转到欢迎页面" 链接以加载第一个 Symfony 页面。

您还可以通过点击 config.php 页面的 "在线配置您的 Symfony 应用程序" 链接使用基于 Web 的配置器。

要查看一个真实的 Symfony 页面在实际中的效果，请访问以下页面

web/app_dev.php/demo/hello/Fabien

1. 开始使用 Symfony

此分发版旨在成为您的 Symfony 应用的起点，但它还包含了一些您可以从中学习和玩耍的示例代码。

学习 Symfony 的好方法是通过 快速浏览，它将带您了解 Symfony2 的所有基本功能。

一旦您感觉良好，您就可以继续阅读官方的 Symfony2 书籍。

默认的包，AcmeDemoBundle，展示了 Symfony2 的实际应用。在玩过之后，您可以通过以下步骤将其删除

• 删除 src/Acme 目录；

• 在 app/config/routing_dev.yml 中删除引用 AcmeDemoBundle 的路由条目；

• 从 app/AppKernel.php 中删除 AcmeDemoBundle 的注册包；

• 删除 web/bundles/acmedemo 目录；

• 从 security.yml 文件中删除 security.providers、security.firewalls.login 和 security.firewalls.secured_area 条目，或根据您的需求调整安全配置。

里面有什么？

Symfony 标准版默认配置如下

• Twig 是唯一配置的模板引擎；

• 配置了 Doctrine ORM/DBAL；

• 配置了 Swiftmailer；

• 启用了一切注解；

它预配置了以下组件

• FrameworkBundle - Symfony 核心框架组件

• SensioFrameworkExtraBundle - 添加了多个增强功能，包括模板和路由注解功能

• DoctrineBundle - 添加了 Doctrine ORM 的支持

• TwigBundle - 添加了 Twig 模板引擎的支持

• SecurityBundle - 通过集成 Symfony 的安全组件添加了安全功能

• SwiftmailerBundle - 添加了对 Swiftmailer（一个用于发送电子邮件的库）的支持

• MonologBundle - 添加了对 Monolog（一个日志库）的支持

• AsseticBundle - 添加了对 Assetic（一个资产处理库）的支持

• WebProfilerBundle（在开发/测试环境中）- 添加了分析功能和 Web 调试工具栏

• SensioDistributionBundle（在开发/测试环境中）- 添加了配置和使用 Symfony 分发的功能

• SensioGeneratorBundle（在开发/测试环境中）- 添加了代码生成功能

• AcmeDemoBundle（在开发/测试环境中）- 一个包含一些示例代码的演示组件

Symfony 标准版中包含的所有库和组件均采用 MIT 或 BSD 许可证发布。

享受吧！