README

==================================

欢迎使用持勒 CMS - 这是一个基于 Symfony2 的全功能 CMS (内容管理系统)，您可以用它作为您网站的基本框架。

基于 https://github.com/Kunstmaan/KunstmaanBundlesStandardEdition

设置

要设置一个新项目，您需要执行以下操作

安装依赖项
启动 docker
在 docker 内设置站点

安装依赖项

要安装 helder-cms 的依赖项，请运行

mkdir <KlantNaam>
cd <KlantNaam>
php composer.phar create-project bureaublauwgeel/helder-cms website --no-install

这将下载一个基本的骨架。

启动 docker

启动 Docker Quickstart Terminal 并转到项目目录

cd website

启动 docker 环境

docker-compose --project-name <KlantNaam> up -d

这将启动一个 mysql 实例和一个 PHP/Apache 实例

要停止 docker 环境，请运行

docker-compose --project-name <KlantNaam> down

在 docker 内设置站点

进入 docker PHP/Apache 设置...

docker exec -t -i -u www-data <KlantNaam>_php-apache_1 /bin/bash

... 并运行 shell 脚本以设置项目

cd /var/www
bash shell-tools/setup_project.sh <KlantNaam> // is CamelCase

默认情况下，网站将在 http://192.168.99.100/app_dev.php 上可用

组件

环境

此设置需要以下组件

PHP 版本 5.6.x
MySQL 版本 5.5.x
NodeJS 版本 4
NPM 版本 2.2
Apache 版本 2.4 Ubuntu 14.04
Ruby 版本 1.9 Ubuntu 14.04
Elasticsearch 版本 2.3.x
Ubuntu 14.04

OTAP

请指定此项目的 OTAP 环境。包括服务器和 URL

开发
- URL: .dev
- URL 管理环境: .dev/...
测试
- .bbgtest.nl
- URL 管理环境: .bbgtest.nl/...
  - 客户端特定凭证
- 服务器：FQDN
- 环境的基本认证
  - 客户端特定
验收
- .bbgaccept.nl
- URL 管理环境: .bbgaccept.nl/...
  - 客户端特定凭证
- 服务器：FQDN
- 环境的基本认证
  - 客户端特定
生产
- URL 管理环境: /...
- 服务器：FQDN

Jenkins

请提供 Jenkins 环境的 URL...

客户端特定捆绑包

此项目使用以下客户端特定捆绑包

请列出所有客户端特定捆绑包
请列出所有客户端特定捆绑包
请列出所有客户端特定捆绑包
...

工具

Shell 工具

Shell 工具有助于在开发过程中自动化某些常见操作。可用的 shell 工具有

create_migration.sh // 创建 doctrine 迁移
reload_fixtures.sh // 重新加载固定数据
setup_project.sh // 默认项目设置，只运行一次！
reload_project.sh // 重新加载完整的项目设置！

它们位于 shell-tools 文件夹中。

Gulp 工具链

Gulp 工具自动化以下过程

SASS 文件编译为 CSS 文件
压缩 CSS 文件
JavaScript 源文件编译为目标 JavaScript 文件。
压缩 JavaScript 文件
它复制默认项目所需的图片
它复制项目图标文件所需的文件
它复制项目字体文件所需的文件

源文件位于 src/<KlantNaam>/WebsiteBundle/Resources/

目标文件位于 web/frontend/ (见 .groundcontrolrc)

在开发过程中，您可以使用 node_modules/.bin/gulp watch 编译即时更改。

要生成新的构建，请运行 node_modules/.bin/gulp build。

您可以从您的客户端系统或Docker实例中运行此命令。首选解决方案是在客户端系统上运行它，因为它使用您的Mac通知系统。

phpStorm中的PHP支持

您需要在phpStorm中启用PHP支持。要启用它，请执行以下步骤

打开首选项对话框，点击“语言和框架”下的PHP节点。
选择PHP解释器

phpStorm中的PHPUnit

在phpStorm中，PHPUnit通过Composer依赖管理器自动加载autoload.php。PHPUnit包含在composer.json中

    "require-dev": {
        ...
        "phpunit/phpunit": "5.5.*"
    },

要使它适用于您的项目，请执行以下步骤

打开首选项对话框，点击“语言和框架”下的PHP节点下的PHPUnit。
在打开的PHPUnit页面上，选择使用composer自动加载器，并指定autoload.php的位置，位于项目中的app/autoload.php。

要运行单元测试，右键单击app/phpunit.xml.dist并选择运行

Docker中的PHPUnit

您还可以在Docker中运行PHPUnit。要执行测试，运行

cd /var/www
./vendor/phpunit/phpunit/phpunit -c app/phpunit.xml.dist

或

./var/www/vendor/phpunit/phpunit/phpunit -c /var/www/app/phpunit.xml.dist

办公蓝黄 / 持勒-CMS

维护者

详细信息