1. 创建你的项目

    如果你还没有设置,请先创建一个新的 Symfony 项目。最常见的方法是使用 Symfony 安装程序

    终端
    symfony new --webapp my-projectcd my-project
  2. 安装 Webpack Encore

    安装 Webpack Encore,它负责构建您的资产。更多信息请参考 文档

    终端
    composer require symfony/webpack-encore-bundle
  3. 安装 Tailwind CSS

    使用 npm 安装 tailwindcss 及其依赖项,以及 postcss-loader,然后运行初始化命令生成 tailwind.config.jspostcss.config.js 文件。

    终端
    npm install -D tailwindcss postcss postcss-loader autoprefixernpx tailwindcss init -p
  4. 启用 PostCSS 支持

    在您的 webpack.config.js 文件中,启用 PostCSS 加载器。更多信息请参考 文档

    webpack.config.js
    Encore
      // ...
      .enablePostCssLoader()
    ;
    
  5. 配置模板路径

    在您的 tailwind.config.js 文件中添加所有模板文件的路径。

    tailwind.config.js
    /** @type {import('tailwindcss').Config} */
    module.exports = {
      content: [
        "./assets/**/*.js",
        "./templates/**/*.html.twig",
      ],
      theme: {
        extend: {},
      },
      plugins: [],
    }
    
  6. 在 CSS 中添加 Tailwind 指令

    在您的 ./assets/styles/app.css 文件中添加 Tailwind 的每个层的 @tailwind 指令。

    app.css
    @tailwind base;
    @tailwind components;
    @tailwind utilities;
  7. 启动构建过程

    使用 npm run watch 运行构建过程。

    终端
    npm run watch
  8. 开始在您的项目中使用 Tailwind

    确保您的编译后的 CSS 包含在 <head> 中,然后开始使用 Tailwind 的实用程序类来为您的内容设置样式。

    base.html.twig
    <!doctype html>
    <html>
    <head>
      <meta charset="utf-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      {% block stylesheets %}
        {{ encore_entry_link_tags('app') }}
      {% endblock %}
    </head>
    <body>
      <h1 class="text-3xl font-bold underline">
        Hello world!
      </h1>
    </body>
    </html>