README

这是官方安装程序，用于启动基于20steps Bricks平台的全新项目。

安装安装程序

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

Linux和Mac OS X

$ sudo curl -LsS https://bricks.20steps.de/downloads/installer -o /usr/local/bin/bricks
$ sudo chmod a+x /usr/local/bin/bricks

Windows

c:\> php -r "file_put_contents('bricks', file_get_contents('https://bricks.20steps.de/downloads/installer'));"

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

c:\> php bricks

如果您希望创建全局的命令，请执行以下操作：

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

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

不使用安装程序进行安装

如果您无法使用Bricks安装程序，则可以使用现代PHP应用程序使用的依赖关系管理器Composer创建Bricks应用程序。

如果您在计算机上未安装Composer，请先全局安装Composer。

然后，执行create-project命令以创建基于最新稳定版本的Bricks新应用程序

composer create-project 20steps/bricks-platform-standard-edition my_project_name

要创建基于最新非稳定版本的Bricks新应用程序，请执行

composer create-project 20steps/bricks-platform-standard-edition my_project_name dev-master

使用安装程序

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

执行new命令，并仅以项目名称作为唯一参数

# Linux, Mac OS X
$ bricks new my_project

# Windows
c:\> php bricks new my_project

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

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

# Linux, Mac OS X
$ bricks new my_project lts

# Windows
c:\> php bricks new my_project lts

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

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

# Linux, Mac OS X
$ bricks new my_project 2.8

# Windows
c:\> php bricks new my_project 2.8

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

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

# Linux, Mac OS X
$ bricks new my_project 2.8.1

# Windows
c:\> php bricks new my_project 2.8.1

5. 安装Bricks演示应用程序

Bricks演示是一个使用官方Bricks最佳实践开发的参考应用程序

# Linux, Mac OS X
$ bricks demo

# Windows
c:\> php bricks demo

更新安装程序

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

# Linux, Mac OS X
$ bricks self-update

# Windows
c:\> php bricks self-update

注意

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

故障排除

Windows系统中的SSL和证书问题

如果您在使用Windows系统上的Bricks安装程序时遇到任何与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

作者

• Helmut Hoffer von Ankershoffen (hhva@20steps.de)

赞助商

20steps - 数字全服务精品店