README

这是基于Symfony全栈框架启动新项目的官方安装程序。安装程序仅与Symfony 2和3兼容。

创建Symfony 4项目

此安装程序与Symfony 4及其更高版本不兼容。相反，请使用Composer，并按以下方式创建您的Symfony 4项目

$ composer create-project symfony/skeleton my_project_name

有关更多详细信息，请参阅官方Symfony文档中的Symfony安装文章。

安装安装程序

此步骤仅在您第一次使用安装程序时需要

Linux和Mac OS X

$ sudo curl -LsS https://symfony.ac.cn/installer -o /usr/local/bin/symfony
$ sudo chmod a+x /usr/local/bin/symfony

Windows

c:\> php -r "file_put_contents('symfony', file_get_contents('https://symfony.ac.cn/installer'));"

将下载的symfony文件移动到您的项目目录，并按以下方式执行它

c:\> php symfony

如果您想创建一个全局的symfony命令，请执行以下操作

c:\> (echo @ECHO OFF & echo php "%~dp0symfony" %*) > symfony.bat

然后，将这两个文件（symfony和symfony.bat）移动到您的执行路径中的任何位置。现在您可以在系统上的任何位置运行symfony命令。

使用安装程序

1. 使用最新稳定版本的Symfony启动新项目

执行new命令，并将项目名称作为唯一参数提供

# Linux, Mac OS X
$ symfony new my_project

# Windows
c:\> php symfony new my_project

2. 使用最新的Symfony LTS（长期支持）版本启动新项目

执行new命令，将项目名称作为第一个参数，并将lts作为第二个参数提供。安装程序将自动选择可用的最新LTS（长期支持）版本

# Linux, Mac OS X
$ symfony new my_project lts

# Windows
c:\> php symfony new my_project lts

3. 基于特定的Symfony分支启动新项目

执行new命令，将项目名称作为第一个参数，并将分支号作为第二个参数提供。安装程序将自动选择给定分支可用的最新版本

# Linux, Mac OS X
$ symfony new my_project 2.8

# Windows
c:\> php symfony new my_project 2.8

4. 基于特定的Symfony版本启动新项目

执行new命令，将项目名称作为第一个参数，并将确切的Symfony版本作为第二个参数提供

# Linux, Mac OS X
$ symfony new my_project 2.8.1

# Windows
c:\> php symfony new my_project 2.8.1

5. 安装Symfony演示应用程序

Symfony Demo是一个使用官方Symfony最佳实践开发的参考应用程序

# Linux, Mac OS X
$ symfony demo

# Windows
c:\> php symfony demo

更新安装程序

Symfony Installer的新版本定期发布。要更新您的安装程序版本，请执行以下命令

# Linux, Mac OS X
$ symfony self-update

# Windows
c:\> php symfony self-update

注意

如果您的系统需要使用代理服务器下载内容，安装程序会尝试从HTTP_PROXY和http_proxy环境变量猜测最佳代理设置。在执行Symfony Installer之前，请确保其中任何一个已设置。

故障排除

Windows系统上的SSL和证书问题

如果在Windows系统上使用Symfony Installer时遇到任何与SSL或安全证书相关的错误

1. 请检查您的php.ini配置文件中是否已启用OpenSSL扩展

; make sure that the following line is uncommented
extension=php_openssl.dll

1. 请检查包含安全证书的文件路径是否存在，并已在php.ini中定义

openssl.cafile=C:/path/to/cacert.pem

如果您无法在系统中的任何位置找到cacert.pem文件，您可以安全地从cURL项目的官方网站下载：[http://curl.haxx.se/ca/cacert.pem](http://curl.haxx.se/ca/cacert.pem)