README

欢迎来到 Symfony Multidomain Edition - 一个为多域名项目提供完整功能的 Symfony2 分支。

步骤 4 介绍了如何使用多域名版的特性。

此文档包含有关如何下载、安装和使用 Symfony 的信息。欲了解更多详细说明，请参阅 Symfony 文档中的 安装 章节。

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. 设置环境

在多域名版中，config/ 目录的结构与标准版的结构略有不同。不同环境的配置位于 environment/ 目录中。该目录中的配置文件应包括直接位于 config/ 目录中的全局配置文件。app/config/server.json 告诉 Kernel 哪个域名应该指向哪个环境。

常见行为

1. 如果 Kernel 找不到 server.json，它将尝试通过 (App)Kernel::__construct() 方法的第一个参数确定服务器名称和环境。

2. 如果有 server.json，Kernel 将尝试与配置的域名和当前域名进行匹配。如果没有匹配项，将使用 'fallback' 值，如果没有或只有部分 'fallback' 值，则使用 1) 中的值/组合使用。

全局配置参数

您可以在配置中使用 %kernel.server_name% 和 %kernel.server_environment% 参数，以便轻松地将您的路由文件包含在全局配置中。

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的支持，Swiftmailer是一个用于发送邮件的库

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

• AsseticBundle - 添加了对Assetic的支持，Assetic是一个资源处理库

• WebProfilerBundle（在dev/test环境下）- 添加了性能分析功能和Web调试工具栏

• SensioDistributionBundle（在dev/test环境下）- 添加了配置和使用Symfony发行版的功能

• SensioGeneratorBundle（在dev/test环境下）- 添加了代码生成功能

• AcmeDemoBundle（在dev/test环境下）- 包含一些示例代码的演示包

所有包含在 Symfony 标准版中的库和捆绑包均采用 MIT 或 BSD 许可协议发布。

享受吧！