README

这是一个 Symfony 4 项目的骨架。

--- ✂ --------------------------------------------------------------------------

骨架安装（完成时删除此部分）

composer create-project itk-dev/symfony-4-skeleton my-itk-dev-project

骨架安装后

• 编辑 .env 并定义 COMPOSE_PROJECT_NAME 变量。
• 编辑 $header 在 .php_cs.dist。
• 编辑 README.md（删除可选部分并描述您的实际项目）。

建议的包

Doctrine:

composer require symfony/orm-pack
composer require --dev symfony/maker-bundle

在 .env.dev 中设置 DATABASE_URL

DATABASE_URL=mysql://db:db@mariadb:3306/db

EasyAdminBundle:

composer require admin

EasyAdmin 扩展:

composer require alterphp/easyadmin-extension-bundle

API Platform:

composer require api

Encore

composer require encore

添加检查资产的工具

yarn add --dev eslint eslint-config-standard eslint-plugin-import eslint-plugin-node eslint-plugin-promise eslint-plugin-standard
yarn add --dev stylelint stylelint-config-recommended-scss stylelint-scss

将这些行添加到 package.json 中的 scripts

        "check-coding-standards/stylelint": "stylelint --config=.stylelintrc.js 'assets/**/*.scss'",
        "check-coding-standards/scss": "yarn run check-coding-standards/stylelint",
        "check-coding-standards/eslint": "eslint --config .eslintrc.js 'assets/**/*.js'",
        "check-coding-standards/js": "yarn run check-coding-standards/eslint",
        "check-coding-standards": "yarn run check-coding-standards/scss; yarn run check-coding-standards/js",
        "apply-coding-standards/stylelint": "stylelint --config=.stylelintrc.js 'assets/**/*.scss' --fix",
        "apply-coding-standards/scss": "yarn run apply-coding-standards/stylelint",
        "apply-coding-standards/eslint": "eslint --config .eslintrc.js 'assets/**/*.js' --fix",
        "apply-coding-standards/js": "yarn run apply-coding-standards/eslint",
        "apply-coding-standards": "yarn run apply-coding-standards/scss; yarn run apply-coding-standards/js"

另请参阅

• Encore 与 Bootstrap
• Bootstrap 4 表单主题

--- ✂ --------------------------------------------------------------------------

开场表演

docker-compose pull
docker-compose up -d

在您的默认浏览器中打开网站

open http://$(docker-compose port nginx 80)

编码规范

使用 PHP Coding Standards Fixer 和 PHP_CodeSniffer 检查 Symfony 编码规范

composer check-coding-standards

应用 Symfony 编码规范

composer apply-coding-standards

Twig（实验性）

使用 Twigcs 检查 Twig 模板

composer check-coding-standards/twigcs

--- ✂ ---（如果不使用 encore，请删除此部分）----------------------------

资产（SCSS 和 JavaScript）

检查所有资产的编码规范

yarn check-coding-standards

检查 SCSS 文件的编码规范

yarn check-coding-standards/scss

检查 JavaScript 文件的编码规范

yarn check-coding-standards/js

将编码规范应用于所有资产

yarn apply-coding-standards

将编码规范应用于 SCSS 文件

yarn apply-coding-standards/scss

将编码规范应用于 JavaScript 文件

yarn apply-coding-standards/js

--- ✂ --------------------------------------------------------------------------