PHPackages                             tbela99/css - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing & Serialization](/categories/parsing)
4. /
5. tbela99/css

ActiveLibrary[Parsing & Serialization](/categories/parsing)

tbela99/css
===========

A CSS parser and minifier written in PHP

v0.3.10(3y ago)154403[3 issues](https://github.com/tbela99/css/issues)[1 PRs](https://github.com/tbela99/css/pulls)MITPHPPHP >=8.0CI failing

Since Dec 22Pushed 6mo ago1 watchersCompare

[ Source](https://github.com/tbela99/css)[ Packagist](https://packagist.org/packages/tbela99/css)[ Docs](https://github.com/tbela99/css)[ RSS](/packages/tbela99-css/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (10)Dependencies (3)Versions (39)Used By (0)

CSS (A CSS parser and minifier written in PHP)

---

[![CI](https://github.com/tbela99/css/actions/workflows/php.yml/badge.svg)](https://github.com/tbela99/css/actions/workflows/php.yml) [![Current version](https://camo.githubusercontent.com/caea0f195bf6ea367e244024b158c89e116ed6423996db5ff1f70338ae6bfff2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64796e616d69632f6a736f6e3f6c6162656c3d63757272656e7425323076657273696f6e2671756572793d76657273696f6e2675726c3d68747470732533412532462532467261772e67697468756275736572636f6e74656e742e636f6d2532467462656c6139392532466373732532466d61737465722532467061636b6167652e6a736f6e)](https://camo.githubusercontent.com/caea0f195bf6ea367e244024b158c89e116ed6423996db5ff1f70338ae6bfff2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64796e616d69632f6a736f6e3f6c6162656c3d63757272656e7425323076657273696f6e2671756572793d76657273696f6e2675726c3d68747470732533412532462532467261772e67697468756275736572636f6e74656e742e636f6d2532467462656c6139392532466373732532466d61737465722532467061636b6167652e6a736f6e) [![Packagist](https://camo.githubusercontent.com/63599717e4e0f51712bf2d6e872e205dfa4130a7701b1b5c8610d671d55986f5/68747470733a2f2f706f7365722e707567782e6f72672f7462656c6139392f6373732f646f776e6c6f616473)](https://packagist.org/packages/tbela99/css) [![Documentation](https://camo.githubusercontent.com/c6dca9152d74b91cb66abf150c35b6746a6209bbaa0346e9cf515bc0b1e31a2a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64796e616d69632f6a736f6e3f6c6162656c3d646f63756d656e746174696f6e2671756572793d76657273696f6e2675726c3d68747470732533412532462532467261772e67697468756275736572636f6e74656e742e636f6d2532467462656c6139392532466373732532466d61737465722532467061636b6167652e6a736f6e)](https://tbela99.github.io/css) [![Known Vulnerabilities](https://camo.githubusercontent.com/d0fff9b79a1492258382ffc2e43269276a8003fe02a4ca957f55ec284e3bfe1d/68747470733a2f2f736e796b2e696f2f746573742f6769746875622f7462656c6139392f677a69702f62616467652e737667)](https://snyk.io/test/github/tbela99/css)

A CSS parser, beautifier and minifier written in PHP. It supports the following features

Features
--------

[](#features)

- multibyte characters encoding
- sourcemap
- multiprocessing: process large CSS input very fast
- CSS Nesting module
- partially implemented CSS Syntax module level 3
- partial CSS validation
- CSS colors module level 4
- parse and render CSS
- optimize css:
    - merge duplicate rules
    - remove duplicate declarations
    - remove empty rules
    - compute css shorthand (margin, padding, outline, border-radius, font, background)
    - process @import document to reduce the number of HTTP requests
    - remove @charset directive
- query api with xpath like or class name syntax
- traverser api to transform the css and ast
- command line utility

Installation
------------

[](#installation)

install using [Composer](https://getcomposer.org/)

### PHP version >= 8.0

[](#php-version--80)

```
$ composer require tbela99/css
```

### PHP version >= 5.6

[](#php-version--56)

```
$ composer require "tbela99/css:dev-php56-backport"
```

Requirements
------------

[](#requirements)

- PHP version >= 8.0 on master branch.
- PHP version >= 5.6 supported in [this branch](https://github.com/tbela99/css/tree/php56-backport)
- mbstring extension

Usage:
------

[](#usage)

```
h1 {
  color: green;
  color: blue;
  color: black;
}

h1 {
  color: #000;
  color: aliceblue;
}
```

PHP Code

```
use \TBela\CSS\Parser;

$parser = new Parser();

$parser->setContent('
h1 {
  color: green;
  color: blue;
  color: black;
}

h1 {
  color: #000;
  color: aliceblue;
}');

echo $parser->parse();
```

Result

```
h1 {
  color: #f0f8ff;
}
```

Parse the css file and generate the AST

```
use \TBela\CSS\Parser;
use \TBela\CSS\Renderer;

$parser = new Parser($css);
$element = $parser->parse();

// append an existing css file
$parser->append('https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css');

// append css string
$parser->appendContent($css_string);

// pretty print css
$css = (string) $element;

// minified output
$renderer = new Renderer([
  'compress' => true,
  'convert_color' => 'hex',
  'css_level' => 4,
  'sourcemap' => true,
  'allow_duplicate_declarations' => false
  ]);

// fast
$css = $renderer->renderAst($parser);
// or
$css = $renderer->renderAst($parser->getAst());
// slow
$css = $renderer->render($element);

// generate sourcemap -> css/all.css.map
$renderer->save($element, 'css/all.css');

// save as json
file_put_contents('style.json', json_encode($element));
```

Load the AST and generate css code

```
use \TBela\CSS\Renderer;
// fastest way to render css
$beautify = (new Renderer())->renderAst($parser->setContent($css)->getAst());
// or
$beautify = (new Renderer())->renderAst($parser->setContent($css));

// or
$css = (new Renderer())->renderAst(json_decode(file_get_contents('style.json')));
```

```
use \TBela\CSS\Renderer;

$ast = json_decode(file_get_contents('style.json'));

$renderer = new Renderer([
    'convert_color' => true,
    'compress' => true, // minify the output
    'remove_empty_nodes' => true // remove empty css classes
]);

$css = $renderer->renderAst($ast);
```

Sourcemap generation
--------------------

[](#sourcemap-generation)

```
$renderer = new Renderer([
  'sourcemap' => true
  ]);

// call save and specify the file name
// generate sourcemap -> css/all.css.map
$renderer->save($element, 'css/all.css');
```

The CSS Query API
-----------------

[](#the-css-query-api)

Example: get all background and background-image declarations that contain an image url

```
$element = Element::fromUrl('https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css');

foreach ($element->query('[@name=background][@value*="url("]|[@name=background-image][@value*="url("]') as $p) {

    echo "$p\n";
}
```

result

```
.form-select {
 background-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c
/svg%3e")
}
.form-check-input:checked[type=checkbox] {
 background-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10l3 3l6-6'/%3e%3c/s
vg%3e")
}

...
```

Example: Extract Font-src declaration

CSS source

```
@font-face {
  font-family: "Bitstream Vera Serif Bold";
  src: url("/static/styles/libs/font-awesome/fonts/fontawesome-webfont.fdf491ce5ff5.woff");
}

body {
  background-color: green;
  color: #fff;
  font-family: Arial, Helvetica, sans-serif;
}
h1 {
  color: #fff;
  font-size: 50px;
  font-family: Arial, Helvetica, sans-serif;
  font-weight: bold;
}

@media print {
  @font-face {
    font-family: MaHelvetica;
    src: local("Helvetica Neue Bold"), local("HelveticaNeue-Bold"),
      url(MgOpenModernaBold.ttf);
    font-weight: bold;
  }
  body {
    font-family: "Bitstream Vera Serif Bold", serif;
  }
  p {
    font-size: 12px;
    color: #000;
    text-align: left;
  }

  @font-face {
    font-family: Arial, MaHelvetica;
    src: local("Helvetica Neue Bold"), local("HelveticaNeue-Bold"),
      url(MgOpenModernaBold.ttf);
    font-weight: bold;
  }
}
```

PHP source

```
use \TBela\CSS\Parser;

$parser = new Parser();

$parser->setContent($css);

$stylesheet = $parser->parse();

// get @font-face nodes by class names
$nodes = $stylesheet->queryByClassNames('@font-face, .foo .bar');

// or

// get all src properties in a @font-face rule
$nodes = $stylesheet->query('@font-face/src');

echo implode("\n", array_map('trim', $nodes));
```

result

```
@font-face {
  src: url("/static/styles/libs/font-awesome/fonts/fontawesome-webfont.fdf491ce5ff5.woff");
}
@media print {
  @font-face {
    src: local("Helvetica Neue Bold"), local("HelveticaNeue-Bold"),
      url(MgOpenModernaBold.ttf);
  }
}
@media print {
  @font-face {
    src: local("Helvetica Neue Bold"), local("HelveticaNeue-Bold"),
      url(MgOpenModernaBold.ttf);
  }
}
```

render optimized css

```
$stylesheet->setChildren(array_map(function ($node) { return $node->copy()->getRoot(); }, $nodes));
$stylesheet->deduplicate();

echo $stylesheet;
```

result

```
@font-face {
  src: url(/static/styles/libs/font-awesome/fonts/fontawesome-webfont.fdf491ce5ff5.woff)
}
@media print {
 @font-face {
   src: local("Helvetica Neue Bold"), local(HelveticaNeue-Bold), url(MgOpenModernaBold.ttf)
 }
}
```

CSS Nesting
-----------

[](#css-nesting)

```
table.colortable {
  & td {
    text-align:center;
    &.c { text-transform:uppercase }
    &:first-child, &:first-child + td { border:1px solid black }
  }

& th {
text-align:center;
background:black;
color:white;
}
}
```

render CSS nesting

```
use TBela\CSS\Parser;

echo new Parser($css);
```

result

```
table.colortable {
 & td {
  text-align: center;
  &.c {
   text-transform: uppercase
  }
  &:first-child,
  &:first-child+td {
   border: 1px solid #000
  }
 }
 & th {
  text-align: center;
  background: #000;
  color: #fff
 }
}
```

convert nesting CSS to older representation

```
use TBela\CSS\Parser;
use \TBela\CSS\Renderer;

$renderer = new Renderer( ['legacy_rendering' => true]);
echo $renderer->renderAst(new Parser($css));
```

result

```
table.colortable td {
 text-align: center
}
table.colortable td.c {
 text-transform: uppercase
}
table.colortable td:first-child,
table.colortable td:first-child+td {
 border: 1px solid #000
}
table.colortable th {
 text-align: center;
 background: #000;
 color: #fff
}
```

The Traverser Api
-----------------

[](#the-traverser-api)

The traverser will iterate over all the nodes and process them with the callbacks provided. It will return a new tree Example using ast

```
use TBela\CSS\Ast\Traverser;
use TBela\CSS\Parser;
use TBela\CSS\Renderer;

$parser = (new Parser())->load('ast/media.css');
$traverser = new Traverser();
$renderer = new Renderer(['remove_empty_nodes' => true]);

$ast = $parser->getAst();

// remove @media print
$traverser->on('enter', function ($node) {

    if ($node->type == 'AtRule' && $node->name == 'media' && $node->value == 'print') {

        return Traverser::IGNORE_NODE;
    }
});

$newAst = $traverser->traverse($ast);
echo $renderer->renderAst($newAst);
```

Example using an Element instance

```
use TBela\CSS\Ast\Traverser;
use TBela\CSS\Parser;
use TBela\CSS\Renderer;

$parser = (new Parser())->load('ast/media.css');
$traverser = new Traverser();
$renderer = new Renderer(['remove_empty_nodes' => true]);

$element = $parser->parse();

// remove @media print
$traverser->on('enter', function ($node) {

    if ($node->type == 'AtRule' && $node->name == 'media' && $node->value == 'print') {

        return Traverser::IGNORE_NODE;
    }
});

$newElement = $traverser->traverse($element);
echo $renderer->renderAst($newElement);
```

Build a CSS Document
--------------------

[](#build-a-css-document)

```
use \TBela\CSS\Element\Stylesheet;

$stylesheet = new Stylesheet();

$rule = $stylesheet->addRule('div');

$rule->addDeclaration('background-color', 'white');
$rule->addDeclaration('color', 'black');

echo $stylesheet;
```

output

```
div {
  background-color: #fff;
  color: #000;
}
```

```
$media = $stylesheet->addAtRule('media', 'print');
$media->append($rule);
```

output

```
@media print {
  div {
    background-color: #fff;
    color: #000;
  }
}
```

```
$div = $stylesheet->addRule('div');

$div->addDeclaration('max-width', '100%');
$div->addDeclaration('border-width', '0px');
```

output

```
@media print {
  div {
    background-color: #fff;
    color: #000;
  }
}
div {
  max-width: 100%;
  border-width: 0;
}
```

```
$media->append($div);
```

output

```
@media print {
  div {
    background-color: #fff;
    color: #000;
  }
  div {
    max-width: 100%;
    border-width: 0;
  }
}
```

```
$stylesheet->insert($div, 0);
```

output

```
div {
  max-width: 100%;
  border-width: 0;
}
@media print {
  div {
    background-color: #fff;
    color: #000;
  }
}
```

Adding existing css

```
// append css string
$stylesheet->appendCss($css_string);
// append css file
$stylesheet->append('style/main.css');
// append url
$stylesheet->append('https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.3/css/brands.min.css');
```

Performance
-----------

[](#performance)

### Utility methods

[](#utility-methods)

The renderer class provides utility methods to format css data

```
$css = \TBela\CSS\Renderer::fromFile($url_or_file, $renderOptions = [], $parseOptions = []);
#
$css = \TBela\CSS\Renderer::fromString($css, $renderOptions = [], $parseOptions = []);
```

### Manual parsing and rendering

[](#manual-parsing-and-rendering)

parsing and rendering ast is 3x faster than parsing an element.

```
use \TBela\CSS\Element\Parser;
use \TBela\CSS\Element\Renderer;

$parser = new Parser($css);

// parse and render
echo (string) $parser;

// or render minified css
$renderer = new Renderer(['compress' => true]);

echo $renderer->renderAst($parser);
# or
echo $renderer->renderAst($parser->getAst());
# or
// slower - will build a stylesheet object
echo $renderer->render($parser->parse());
```

Parser Options
--------------

[](#parser-options)

- flatten\_import: process @import directive and import the content into the css document. default to false.
- allow\_duplicate\_rules: allow duplicated rules. By default, duplicate rules except @font-face are merged
- allow\_duplicate\_declarations: allow duplicated declarations in the same rule.
- capture\_errors: silently capture parse error if true, otherwise throw a parse exception. Default to true

Renderer Options
----------------

[](#renderer-options)

- remove\_comments: remove comments.
- preserve\_license: preserve comments starting with '/\*!'
- compress: minify output, will also remove comments
- remove\_empty\_nodes: do not render empty css nodes
- compute\_shorthand: compute shorthand declaration
- charset: preserve @charset. default to false
- glue: the line separator character. default to '\\n'
- indent: character used to pad lines in css, default to a space character
- convert\_color: convert colors to a format between *hex*, *hsl*, *rgb*, *hwb* and *device-cmyk*
- css\_level: produce CSS color level 3 or 4. default to *4*
- allow\_duplicate\_declarations: allow duplicate declarations.
- legacy\_rendering: convert nesting css. default false

Command line utility
--------------------

[](#command-line-utility)

the command line utility is located at './cli/css-parser'

```
$ ./cli/css-parser -h

Usage:
$ css-parser [OPTIONS] [PARAMETERS]

-v, --version	print version number
-h	print help
--help	print extended help

Parse options:

-e, --capture-errors                    	ignore parse error

-f, --file                              	input css file or url

-m, --flatten-import                    	process @import

-I, --input-format                      	input format: json (ast), serialize (PHP serialized ast)

-d, --parse-allow-duplicate-declarations	allow duplicate declaration

-p, --parse-allow-duplicate-rules       	allow duplicate rule

-P, --parse-children-process            	maximum children process

-M, --parse-multi-processing            	enable multi-processing parser

Render options:

-a, --ast                                	dump ast as JSON

-S, --charset                            	remove @charset

-c, --compress                           	minify output

-u, --compute-shorthand                  	compute shorthand properties

-t, --convert-color                      	convert colors

-l, --css-level                          	css color module

-G, --legacy-rendering                   	convert nested css syntax

-o, --output                             	output file name

-F, --output-format                      	output export format. string (css), json (ast), serialize (PHP serialized ast), json-array, serialize-array, requires --input-format

-L, --preserve-license                   	preserve license comments

-C, --remove-comments                    	remove comments

-E, --remove-empty-nodes                 	remove empty nodes

-r, --render-allow-duplicate-declarations	render duplicate declarations

-R, --render-multi-processing            	enable multi-processing renderer

-s, --sourcemap                          	generate sourcemap, requires --file
```

### Minify inline css

[](#minify-inline-css)

```
$ ./cli/css-parser 'a, div {display:none} b {}' -c
#
$ echo 'a, div {display:none} b {}' | ./cli/css-parser -c
```

### Minify css file

[](#minify-css-file)

```
$ ./cli/css-parser -f nested.css -c
#
$ ./cli/css-parser -f 'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.3/css/brands.min.css' -c
```

### Dump ast

[](#dump-ast)

```
$ ./cli/css-parser -f nested.css -f 'https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.5.0/css/bootstrap.min.css' -c -a
#
$ ./cli/css-parser 'a, div {display:none} b {}' -c -a
#
$ echo 'a, div {display:none} b {}' | ./cli/css-parser -c -a
```

The full [documentation](https://tbela99.github.io/css) can be found [here](https://tbela99.github.io/css)

---

Thanks to [Jetbrains](https://jetbrains.com) for providing a free PhpStorm license

This was originally a PHP port of

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance42

Moderate activity, may be stable

Popularity26

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 97.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~29 days

Recently: every ~16 days

Total

35

Last Release

1373d ago

PHP version history (4 changes)0.1-alphaPHP >=5.6.0

0.1-beta3PHP >=7

0.1-beta5PHP >=7.4

V0.3.6PHP >=8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/58517?v=4)[Thierry Bela Nanga](/maintainers/tbela99)[@tbela99](https://github.com/tbela99)

---

Top Contributors

[![tbela99](https://avatars.githubusercontent.com/u/58517?v=4)](https://github.com/tbela99 "tbela99 (477 commits)")[![ImgBotApp](https://avatars.githubusercontent.com/u/31427850?v=4)](https://github.com/ImgBotApp "ImgBotApp (11 commits)")

---

Tags

astbeautifiercompressorcsscss-nestingcss-parserminifierparserphpphp-css-beautifyphp-css-minifierphp-css-parsersourcemapphpparsercssminifierstylesheetastcss parserbeautifier

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/tbela99-css/health.svg)

```
[![Health](https://phpackages.com/badges/tbela99-css/health.svg)](https://phpackages.com/packages/tbela99-css)
```

###  Alternatives

[sabberworm/php-css-parser

Parser for CSS Files written in PHP

1.8k204.2M72](/packages/sabberworm-php-css-parser)[atanamo/php-codeshift

A PHP code transformation toolkit based on 'PHP-Parser'

32159.6k1](/packages/atanamo-php-codeshift)[corveda/php-sandbox

A PHP library that can be used to run PHP code in a sandboxed environment

23790.9k2](/packages/corveda-php-sandbox)[hexydec/htmldoc

A token based HTML document parser and minifier. Minify HTML documents including inline CSS, Javascript, and SVG's on the fly. Extract document text, attributes, and fragments. Full test suite.

2610.8k4](/packages/hexydec-htmldoc)[butschster/proto-parser

Proto parser is a library for parsing Protocol Buffers files into AST

581.2k](/packages/butschster-proto-parser)[leonelquinteros/php-toml

PHP parser for TOML language ( https://github.com/toml-lang/toml )

276.8k](/packages/leonelquinteros-php-toml)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)