README

#CssFixerBundle

此包封装了csscombjs，并为您的项目添加了CSS代码样式验证

###要求

必须将npm可执行文件添加到PATH

###安装

####1) 在您的composer.json文件中添加依赖项

{
    "require-dev": {
        "fdevs/css-fixer-bundle": "~1.0"
    }
}

您只需要此包进行开发，因此请使用composer.json文件的require-dev部分。

####2) 使用composer将包安装到您的项目中

composer update fdevs/css-fixer-bundle

####3) 将包添加到您的AppKernel.php文件中

// app/AppKernel.php

public function registerBundles()
{
    // ...
    if (in_array($this->getEnvironment(), array('dev', 'test'))) {
        $bundles[] = new FDevs\CssFixerBundle\FDevsCssFixerBundle();
        // ...
    }
    // ...
}

与之前一样，仅在dev环境中注册此包，这样它就不会在prod环境中消耗内存。

在这里，FDevsCssFixerBundle已准备好使用。其默认配置允许它检查位于src文件夹内的所有your包。

###使用示例

验证.css文件

此包具有控制台命令

app/console fdevs:cs:css-fixer

或其别名

app/console code-style:css-fixer

默认情况下，它在lint模式下运行，只显示不符合代码样式约定的文件。

您可以使用以下选项

--fix (-f) # force css fixer to fix files, not just show mistakes
--verbose (-v) # show additional messages and list of checked files and fixed ones

如何查看所有配置选项及其默认值

要查看所有可用选项及其值示例，您可以使用标准控制台命令

app/console config:dump-reference f_devs_css_fixer

它将显示您快速理解和自定义包以满足您需求的必要信息。

将包定制到自己的需求和代码样式约定

包在其配置中有3个主要部分

• include - 您可以在这里添加您想检查.css文件的包。
• exclude - 您可以在这里添加不想检查的包列表。
• rules - 您可以在这里为csscomb修复器设置超过20个选项中的每一个。

配置示例

f_devs_css_fixer:
    include:
        - FDevsFirstBundle
        - FDevsSecondBundle
    exclude:
        - AcmeDemoBundle
    rules:
        space_before_opening_brace: 1
        space_before_closing_brace: "\n"
    # other rules you want to change

包的优先级如下（从低到高）

• 所有您的包（如果既没有提供include也没有提供exclude，则将检查所有您的包）
• include（如果提供，则替换所有）
• exclude（将包从所有或include中删除）