neilime/php-css-lint
Powerful & memory efficient CSS linter for PHP
v7.2.0
2.0M downloads/mo
#4626 most downloaded on Packagist
neilime/php-css-lint
What this package is like to depend on
Last release 4 months ago
24 Apr 2026
Ships fairly regularly
a new release about every 6 weeks
Some releases are documented
notes for 10 of 25 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
25 releases · first in 2017
4 releases in the last 12 months
see the full history below
Release timeline
25 releases · Jan 2017 to Apr 2026Releases
latest 25-
v7.2.024 Apr 2026Release notes
Open source →Release Summary
CSS referential data has been updated, improving linting coverage for current CSS rules.
Data URLs are now correctly handled during property parsing, improving validation reliability.Internal changes include GitHub Actions dependency updates and test adjustments required by CSS rule updates.
Breaking change(s)
There is no breaking change.
What's Changed
- feat: update CSS Referential by @github-actions[bot] in #185
- build(deps): bump the github-actions-dependencies group across 2 directories with 3 updates by @dependabot[bot] in #186
- feat: update CSS Referential by @github-actions[bot] in #187
- build(deps): bump the github-actions-dependencies group across 2 directories with 1 update by @dependabot[bot] in #188
- feat: update CSS Referential by @github-actions[bot] in #189
- build(deps): bump the github-actions-dependencies group across 1 directory with 6 updates by @dependabot[bot] in #190
- feat: update CSS Referential by @github-actions[bot] in #191
- feat: update CSS Referential by @github-actions[bot] in #192
- test: fix failing test due to css rule update by @neilime in #194
- build(deps): bump the github-actions-dependencies group across 1 directory with 4 updates by @dependabot[bot] in #193
- feat: update CSS Referential by @github-actions[bot] in #195
- build(deps): bump the github-actions-dependencies group across 1 directory with 2 updates by @dependabot[bot] in #196
- feat: update CSS Referential by @github-actions[bot] in #197
- feat: update CSS Referential by @github-actions[bot] in #198
- test: fix failing test due to CSS rule update by @neilime in #199
- build(deps): bump actions/download-artifact from 8.0.0 to 8.0.1 in the github-actions-dependencies group across 1 directory by @dependabot[bot] in #200
- feat: update CSS Referential by @github-actions[bot] in #201
- build(deps): bump the github-actions-dependencies group across 2 directories with 3 updates by @dependabot[bot] in #202
- build(deps): bump the github-actions-dependencies group across 1 directory with 5 updates by @dependabot[bot] in #203
- feat: update CSS Referential by @github-actions[bot] in #204
- feat: update CSS Referential by @github-actions[bot] in #206
- build(deps): bump the github-actions-dependencies group across 2 directories with 9 updates by @dependabot[bot] in #208
- fix: handle data URLs in property parsing by @Copilot in #210
Full Changelog: v7.1.0...v7.2.0
-
v7.1.013 Jan 2026Release notes
Open source →Release Summary
Updated CSS referential to improve lint coverage and accuracy.
Internal: development dependencies now allow Symfony ^7.2 alongside ^6.4, easing installs on Symfony 7 projects with no change to production code.
Breaking change(s)
There is no breaking change.
What's Changed
- feat: update CSS Referential by @github-actions[bot] in #182
- feat: add Symfony ^7.2 support to dev dependencies by @Copilot in #184
Full Changelog: v7.0.0...v7.1.0
-
v7.0.022 Dec 2025Release notes
Open source →Release Summary
Add support for PHP 8.5.
CSS Referential was updated, expanding support and accuracy for rule validation.
Internal: dependencies and CI were refreshed for maintenance.
Breaking change(s)
Drop support for PHP 8.1 ; Minimum supported PHP version is now 8.2.
What's Changed
- build(deps): bump the github-actions-dependencies group with 2 updates by @dependabot[bot] in #167
- feat: update CSS Referential by @github-actions[bot] in #168
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.89 to ^3.90 in /tools by @dependabot[bot] in #170
- build(deps): bump the github-actions-dependencies group with 3 updates by @dependabot[bot] in #169
- build(deps): bump the github-actions-dependencies group with 3 updates by @dependabot[bot] in #171
- feat: update CSS Referential by @github-actions[bot] in #172
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.90 to ^3.91 in /tools by @dependabot[bot] in #174
- build(deps): bump the github-actions-dependencies group with 4 updates by @dependabot[bot] in #173
- build(deps): bump the github-actions-dependencies group with 7 updates by @dependabot[bot] in #175
- build(deps): bump the github-actions-dependencies group with 3 updates by @dependabot[bot] in #176
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.91 to ^3.92 in /tools by @dependabot[bot] in #177
- feat: update CSS Referential by @github-actions[bot] in #178
- feat!: upgrade for php 8.5 by @neilime in #179
Full Changelog: v6.2.1...v7.0.0
-
v6.2.109 Nov 2025Release notes
Open source →Release Summary
Updated the CSS Referential dataset to the latest rules across multiple runs to improve lint coverage and accuracy.
Fixed the CSS referential scraper with a retry and rate-limiting strategy to gracefully handle 429 responses.Internal: refreshed CI and tooling dependencies (GitHub Actions, actions/cache, codecov, ci-github-common) and developer utilities (php-cs-fixer, rector, guzzle) to keep the pipeline stable and maintainable.
Breaking change(s)
There is no breaking change.
What's Changed
- build(deps): bump codecov/codecov-action from 5.4.3 to 5.5.0 in the github-actions-dependencies group by @dependabot[bot] in #148
- build(deps-dev): update guzzlehttp/guzzle requirement from ^7.9 to ^7.10 in the dev-dependencies group across 1 directory by @dependabot[bot] in #149
- feat: update CSS Referential by @github-actions[bot] in #150
- build(deps): bump codecov/codecov-action from 5.5.0 to 5.5.1 in the github-actions-dependencies group by @dependabot[bot] in #151
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.86 to ^3.87 in /tools by @dependabot[bot] in #152
- feat: update CSS Referential by @github-actions[bot] in #153
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.87 to ^3.88 in /tools by @dependabot[bot] in #155
- build(deps): bump actions/cache from 4.2.4 to 4.3.0 in the github-actions-dependencies group by @dependabot[bot] in #154
- fix: implement retry strategy and rate limiting for CSS referential scraper to handle 429 responses by @Copilot in #157
- build(deps): bump hoverkraft-tech/ci-github-common from 0.24.0 to 0.26.0 in the github-actions-dependencies group by @dependabot[bot] in #158
- feat: update CSS Referential by @github-actions[bot] in #159
- build(deps): update rector/rector requirement from ^2.1 to ^2.2 in /tools by @dependabot[bot] in #160
- build(deps): bump hoverkraft-tech/ci-github-common from 0.26.0 to 0.27.0 in the github-actions-dependencies group by @dependabot[bot] in #161
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.88 to ^3.89 in /tools by @dependabot[bot] in #162
- feat: update CSS Referential by @github-actions[bot] in #163
- build(deps): bump the github-actions-dependencies group with 2 updates by @dependabot[bot] in #164
- build(deps): bump the github-actions-dependencies group with 2 updates by @dependabot[bot] in #165
- feat: update CSS Referential by @github-actions[bot] in #166
Full Changelog: v6.2.0...v6.2.1
-
v6.2.019 Aug 2025Release notes
Open source →Release Summary
CSS Referential updated to the latest version, improving rule coverage and consistency.
Internal: dependency maintenance across tools (php-cs-fixer in /tools) and CI pipelines (ci-github-common and grouped GitHub Actions updates); no user-facing fixes.
Breaking change(s)
There is no breaking change.
What's Changed
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.80 to ^3.82 in /tools by @dependabot[bot] in #135
- feat: update CSS Referential by @github-actions[bot] in #136
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.82 to ^3.84 in /tools by @dependabot[bot] in #138
- build(deps): bump hoverkraft-tech/ci-github-common from 0.23.0 to 0.23.1 in the github-actions-dependencies group by @dependabot[bot] in #137
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.84 to ^3.85 in /tools by @dependabot[bot] in #140
- feat: update CSS Referential by @github-actions[bot] in #139
- feat: update CSS Referential by @github-actions[bot] in #141
- build(deps): bump the github-actions-dependencies group with 2 updates by @dependabot[bot] in #142
- feat: update CSS Referential by @github-actions[bot] in #143
- build(deps): bump the github-actions-dependencies group with 2 updates by @dependabot[bot] in #145
- feat: update CSS Referential by @github-actions[bot] in #146
- build(deps): bump hoverkraft-tech/ci-github-common from 0.23.1 to 0.24.0 in the github-actions-dependencies group by @dependabot[bot] in #147
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.85 to ^3.86 in /tools by @dependabot[bot] in #144
Full Changelog: v6.1.0...v6.2.0
-
v6.1.007 Jul 2025Release notes
Open source →Release Summary
This release adds an updated CSS Referential feature. It also fixes documentation to reflect current Linter usage. Under the tools scope, dependencies for rector/rector and friendsofphp/php-cs-fixer have been updated.
Breaking change(s)
There are no breaking changes.
What's Changed
- build(deps): update rector/rector requirement from ^2.0 to ^2.1 in /tools by @dependabot in #129
- fix(docs): update Linter usage by @neilime in #131
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.75 to ^3.76 in /tools by @dependabot in #132
- build(deps): update friendsofphp/php-cs-fixer requirement from ^3.76 to ^3.80 in /tools by @dependabot in #134
- feat: update CSS Referential by @github-actions in #133
Full Changelog: v6.0.1...v6.1.0
-
v6.0.124 Jun 2025Release notes
Open source →Release Summary
This release includes a bug fix to the CSS parser for improved handling of
@font-faceat-rule names, ensuring correct parsing by removing trailing brace characters. Dependency updates have been applied to maintain tool stability and compatibility, including upgrades tophpstan/phpstanfrom^2.0to^2.1andhoverkraft-tech/ci-github-commonfrom0.22.3to0.23.0.No breaking changes were introduced in this release.
What's Changed
- build(deps): update phpstan/phpstan requirement from ^2.0 to ^2.1 in /tools by @dependabot in #125
- fix(parser): @font-face at-rule name parsing by removing trailing brace character by @copilot-swe-agent in #126
- build(deps): bump hoverkraft-tech/ci-github-common from 0.22.3 to 0.23.0 in the github-actions-dependencies group by @dependabot in #128
New Contributors
- @copilot-swe-agent made their first contribution in #126
Full Changelog: v6.0.0...v6.0.1
-
v6.0.018 Jun 2025Release notes
Open source →Release Summary
Four updates in this release:
- 🛠 Build: Updated the Codecov GitHub Action dependency from 5.4.2 to 5.4.3 in the
github-actions-dependenciesgroup, addressing minor version improvements. - 🎉 Feature: Refreshed the CSS referential definitions to keep up with the latest CSS features.
- ⚠️ Breaking change: Parsing logic is now completely separate from linting logic—this affects any integrations expecting combined behavior.
- ⚠️ Breaking change: Introduced a new output formatter interface; existing consumers must implement or adjust to the new formatter API.
Breaking changes
-
Parser–linter separation (/feat!/)
The parsing mechanism has been extracted and can now be used independently of the linting stage. Integrations relying on the previous unified parser‑lint workflow may break and need to be updated to explicitly invoke both stages in sequence. -
Output formatter added (/feat!/)
A dedicated formatter layer has been added for lint output. Users must now provide or select a formatter compatible with the new interface, or adjust existing code to supply the required formatter component.
🆕 New Features
- Updated CSS referential data was integrated, improving CSS validity checks.
- New output formatter enhances flexibility in rendering lint results.
🐛 Bug Fixes & Maintenance
- Bumped
codecov/codecov-actionfrom v5.4.2 to v5.4.3 to apply latest CI improvements.
Let me know if you'd like the detailed changes from any of these pull requests!
What's Changed
- build(deps): bump codecov/codecov-action from 5.4.2 to 5.4.3 in the github-actions-dependencies group by @dependabot in #121
- feat: update CSS Referential by @github-actions in #122
- feat!: separate parsing from linting by @neilime in #123
- feat!: add output formatter by @neilime in #124
New Contributors
- @github-actions made their first contribution in #122
Full Changelog: v5.0.0...v6.0.0
- 🛠 Build: Updated the Codecov GitHub Action dependency from 5.4.2 to 5.4.3 in the
-
v5.0.013 May 2025Release notes
Open source →Release Summary
This release introduces support for the latest CSS properties based on W3C and MDN standards, enhancing compatibility and accuracy in linting. Additionally, the tool now supports PHP 8.4, ensuring forward compatibility with the upcoming PHP version.
Breaking changes
- The linter now strictly aligns with CSS properties defined by W3C and MDN. This may result in previous custom or non-standard property usages being flagged as invalid. More details in #119
- The internal code has been refactored, it can result to breaking change for code extending this
CssLintlibrary
What's Changed
- feat!: supports CSS properties from W3C and MDN by @neilime in #119
- feat: add support for PHP 8.4 by @yt-topicus in #105
Full Changelog: v4.1.2...v5.0.0
-
v4.1.201 May 2025Release notes
Open source →Release Summary
This release includes dependency updates and a bug fix. The GitHub Actions dependency
hoverkraft-tech/ci-github-commonwas upgraded incrementally from0.22.0to0.22.3to ensure improved CI stability and security. Additionally, a bug was fixed to support semicolons in@import urlstatements during linting, improving CSS compatibility.No breaking changes introduced in this release.
What's Changed
- build(deps): bump hoverkraft-tech/ci-github-common from 0.22.0 to 0.22.2 in the github-actions-dependencies group by @dependabot in #114
- build(deps): bump hoverkraft-tech/ci-github-common from 0.22.2 to 0.22.3 in the github-actions-dependencies group by @dependabot in #115
- fix(lint): support semicolon in import url by @neilime in #117
Full Changelog: v4.1.1...v4.1.2
-
v4.1.114 Apr 2025Nothing published for this version
-
v4.1.020 Feb 2025Nothing published for this version
-
v4.0.015 Nov 2024Nothing published for this version
-
v3.2.019 Jun 2023Nothing published for this version
-
v3.1.323 Sep 2022Nothing published for this version
-
v3.1.224 Jun 2022Nothing published for this version
-
v3.1.103 Jun 2022Nothing published for this version
-
v3.1.009 Apr 2022Nothing published for this version
-
v3.0.004 Mar 2021Nothing published for this version
-
v2.2.009 Jul 2020Nothing published for this version
-
v2.1.008 Nov 2019Nothing published for this version
-
v2.0.009 Oct 2019Nothing published for this version
-
v1.1.009 Apr 2018Nothing published for this version
-
v1.0.101 Apr 2018Nothing published for this version
-
1.0.018 Jan 2017Nothing published for this version