README

Web 应用程序启动工具包

重要说明：随着 SF4 的发布，Symfony 团队决定退役 Silex。这意味着，它将不再支持任何新的 SF4 特性。因此，从现在开始，我建议使用新的 SF4 进行长期项目，因为我无法为此模板/启动工具包添加任何新的（SF4）功能。然而，我可能在不久的将来准备一个类似的 SF4 启动工具包，请耐心等待。

适用于小型或中型应用的简单 Web 应用程序模板。包含

用户系统
- 登录
- 注销
- 注册
- 重置密码
- 基本资料
- 设置/编辑资料
- 更改密码
基本用户角色系统 - 可以为每个用户分配角色
管理
- 用户
  - 查看
  - 编辑
  - 切换/模拟
  - 删除
- 用户操作
- 帖子
工具
- 邮件预览 - 您可以在编辑邮件模板时查看这些模板（无需为每次更改发送测试邮件给自己）
- 数据库备份 - 备份和恢复您的数据库架构
错误/异常跟踪 - 将异常/错误直接保存到数据库，并在发生错误时发送电子邮件
统计信息
设置

需求 & 工具 & 助手

PHP > 7.0
Composer
Bower
PHP Coding Standards Fixer（可选）

设置/开发

导航到您的 Web 目录： cd /var/www
创建一个新项目：composer create-project bobalazek/web-application-starter-kit myapp --no-scripts
在应用内部导航：cd myapp
配置数据库（以及可能的其他内容，如果您想的话） - 将 app/configs/global-local.example.php 复制/克隆到 app/configs/global-local.php 并在那里设置配置。或者，您也可以用 .env.example 进行同样的操作，如果您只想更改基本设置（数据库配置 & 环境）。
运行以下命令
- composer install
- bin/console orm:schema-tool:update --force（安装数据库架构）
- bower update（安装前端依赖 - 如果您尚未安装，您需要先安装 Bower）
- bin/console application:database:hydrate-data（填充一些数据）
您已完成！开始开发！

数据库

我们使用 Doctrine 数据库
导航到您的项目目录： cd /var/www/myapp
检查实体：bin/console orm:info（可选）
更新架构：bin/console orm:schema-tool:update --force
数据库已更新！

部署

我们使用Deployer
在deployer/config.php和deployer/hosts.php中设置您的配置
运行dep deploy qa（或您想要的任何环境）
应用程序已部署到您的服务器！

应用程序名称

您应该在以下文件中替换实际应用程序的名称

README.md
bower.json
composer.json
phpunit.xml
app/configs/global.php

管理员登录

使用bin/console application:database:hydrate-data命令，您将默认激活2个用户（您可以在app/fixtures/users.php文件中更改）

管理员用户（具有管理员权限）
- 用户名：admin或admin@myapp.com
- 密码：test
测试用户（具有默认用户权限）
- 用户名：test或test@myapp.com
- 密码：test

命令

bin/console application:environment:prepare - 将创建全局本地文件global-local.php和开发本地文件development-local.php（如果不存在）
bin/console application:database:hydrate-data [-r|--remove-existing-data] - 将使用一些基本数据填充表，例如：2个用户和6个角色（--remove-existing-data标志将在重新填充之前截断所有表）
bin/console application:storage:prepare - 将准备所有存储（var/）文件夹，例如：缓存、日志、会话等。
bin/console application:translations:prepare - 将所有未翻译的字符串准备到单独的（app/locales/{locale}/messages_untranslated.yml）文件中。接受地区参数（默认为'en_US' - 用法：bin/console application:translations:prepare --locale de_DE或bin/console application:translations:prepare -l de_DE）

其他命令

php-cs-fixer fix . - 如果您想在每次提交之前修复代码。您需要安装PHP Coding Standards Fixer
bin/simple-phpunit - 运行您的PHPUnit测试

模块/组件

如果您想在这个系统中创建一个新的组件/模块，请执行以下操作（在这种情况下，会员区域的帖子）

创建一个新的Controller Provider（例如src/Application/ControllerProvider/MembersArea/PostsControllerProvider.php - 复数形式）
- 绑定以下路由
  - 概览/列表
    - 路由名称：members-area.posts
    - 路由模式/URL：(空白)
    - 路由控制器方法：PostsController::indexAction
  - 新建
    - 路由名称：members-area.posts.new
    - 路由模式/URL：/new
    - 路由控制器方法：PostsController::newAction
  - 详细信息
    - 路由名称：members-area.posts.detail
    - 路由模式/URL：/{id}
    - 路由控制器方法：PostsController::detailAction
  - 编辑
    - 路由名称：members-area.posts.edit
    - 路由模式/URL：/{id}/edit
    - 路由控制器方法：PostsController::editAction
  - 删除
    - 路由名称：members-area.posts.remove
    - 路由模式/URL：/{id}/remove
    - 路由控制器方法：PostsController::removeAction
创建一个新的控制器（src/Application/Controller/MembersArea/PostsController.php - 复数）
- 具有以下方法
  - PostsController::listAction
  - PostsController::newAction
  - PostsController::detailAction
  - PostsController::editAction
  - PostsController::removeAction
将控制器提供者的路由挂载到路由（app/core/routes.php）
创建一个新的实体（src/Application/Entity/PostEntity.php - 单数）
创建一个新的存储库（src/Application/Repository/PostRepository.php - 单数）
创建一个新的表单类型（src/Application/Form/Type/PostType.php - 单数）
创建模板
- app/templates/contents/members-area/posts/（复数）
  - list.html.twig
  - detail.html.twig
  - new.html.twig
  - edit.html.twig
  - remove.html.twig
  - _form.html.twig（仅将此包含在编辑和新模板中，因此您无需两次编写相同的表单 - 如果更复杂）

文件结构

app/
- configs/ => 所有基本配置资料（+验证）
- core/ => 核心文件，如提供者、路由、中间件和定义
- fixtures/ => 用于填充数据库
- locales/ => 用于翻译
- templates/ => 所有twig模板
bin/
- console
src/
- Application/
  - Command/
  - Controller/
  - ControllerProvider/
  - Doctrine/ => Silex的某些Doctrine修复
  - Entity/ => 所有实体/模型
  - Form/
  - Provider/
  - Repository/
  - Tool/
  - Twig/
web/
- assets/
  - images/
  - javascripts/
  - uploads/ => 用于上传
  - vendor/ => Bower依赖
- index.php