README

先决条件

请确保您已安装 Node.js 和包管理器 Yarn。

步骤 1: 下载组件

打开命令行控制台，进入您的项目目录，然后执行以下命令以下载此组件的最新稳定版本

$ composer require --dev orkestra/setup-bundle

此命令要求您全局安装 Composer，具体请参阅 Composer 文档中的安装章节。

步骤 2: 启用组件

然后，将组件添加到项目中 app/AppKernel.php 文件中已注册的组件列表中来启用它

<?php
// app/AppKernel.php
// ...

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        // ...
        if (in_array($this->getEnvironment(), array('dev'), true)) {
            // ...
            $bundles[] = new Orkestra\Bundles\SetupBundle\OrkestraSetupBundle();
        }

        return $bundles;
    }

    // ...
}

可用命令

Nanobox

$ php bin/console setup:nanobox

为您的项目创建一个 Nanobox 环境。请确保添加 Nanobox DNS 条目以及 evar SYMFONY_ENV。同时，在您的 app/AppKernel.php 中启用组件 Doctrine\Bundle\MigrationsBundle\DoctrineMigrationsBundle。

调整您的 parameters.yml 文件以包含以下值

database_host: '%env(DATA_DB_HOST)%'
database_port: null
database_name: gonano
database_user: '%env(DATA_DB_USER)%'
database_password: '%env(DATA_DB_PASS)%'

CKEditor

$ php bin/console setup:ckeditor

安装 CKEditor 组件和默认工具栏配置。这将还调整 boxfile.yml 以确保 CKEditor 资产在部署时安装。

请确保在 app/config/config.yml 中导入 merges/ckeditor.yml 并在您的 app/AppKernel.php 中启用组件 Ivory\CKEditorBundle\IvoryCKEditorBundle。

之后，安装开发环境的 CKEditor 资产

$ php bin/console ckeditor:install web/bundles/ivoryckeditor

MailHog

$ php bin/console setup:mailhog

使用所需配置文件安装 MailHog 并在您的 Nanobox 环境中添加反向代理，以便在 URL /mailbox（除生产环境外）访问 MailHog。

请确保从 config.yml 和 config_test.yml 中删除默认的 swiftmailer 选项，并为希望使用的每个环境导入 merges/mailhog.yml。将 merges/mail_prod.yml 导入您的 config_prod.yml。此外，添加两个 Nanobox evars MAIL_USER 和 MAIL_PASS，以便在线环境需要通过身份验证来访问邮箱。

Memcached

配置 Symfony 使用 memcached 处理会话和 Doctrine 缓存。

请确保为希望使用的每个环境导入 merges/memcached.yml。

$ php bin/console setup:memcached

命名空间会话

$ php bin/console setup:session

配置 Symfony 使用命名空间会话。

请确保为希望使用的每个环境导入 merges/session.yml。

Webpack/Encore

$ php bin/console setup:webpack --bootstrap 3 # Includes Bootstrap v3
$ php bin/console setup:webpack --bootstrap 4 # Includes Bootstrap v4

安装 Webpack/Encore 和默认 Webpack 配置。这还包括默认的 Bootstrap 和 Font-Awesome 样式表和脚本。

请确保在 app/config/config.yml 中导入 merges/webpack.yml。

在开发期间，您可以通过运行 node_modules/.bin/encore dev --watch 来实时编译您的资产。