Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mrclay/minify

Combines. minifies, and serves CSS or Javascript files
https://github.com/mrclay/minify

Last synced: 27 days ago
JSON representation

Combines. minifies, and serves CSS or Javascript files

Awesome Lists containing this project

README 

        
## Minify is no longer regularly maintained



The original authors no longer recommend using Minify, especially previous versions, which were not designed to handle modern JS and CSS syntax. Instead, use an up-to-date performance measurement tool like [Lighthouse](https://developer.chrome.com/docs/lighthouse/overview) and follow its recommendations.



In 2010, Minify offered a fine improvement for some websites, but browsers and HTTP servers are now much better, and Minify may offer only a marginal performance benefit in narrow cases. Also both JS and CSS now change rapidly, and new syntaxes are likely to lead to broken code being served through Minify.



## About



Minify is an HTTP server for JS and CSS assets. It compresses and combines files

and serves it with appropriate headers, allowing conditional GET or long-Expires.



| *Before* | ![7 requests](http://mrclay.org/wp-content/uploads/2008/09/fiddler_before.png) |

|----------|-----------------------------------------------------------------|

| *After*  | ![2 requests](http://mrclay.org/wp-content/uploads/2008/09/fiddler_after.png)  |



The stats above are from a [brief walkthrough](http://mrclay.org/index.php/2008/09/19/minify-21-on-mrclayorg/) which shows how easy it is to set up Minify on an existing site. It eliminated 5 HTTP requests and reduced JS/CSS bandwidth by 70%.



Relative URLs in CSS files are rewritten to compensate for being served from a different directory.



## Static file serving



Version 3 allows [serving files directly from the filesystem](static/README.md) for much better performance. We encourage you to try this feature.



## Support



Post to the [Google Group](http://groups.google.com/group/minify).



## Installation



See the [install guide](docs/Install.wiki.md).



## Configuration & Usage



(Using 2.x? [Here are the 2.x docs](https://github.com/mrclay/minify/tree/2.x/docs).)



See the [user guide](docs/UserGuide.wiki.md).



Minify also comes with a [URI Builder application](docs/BuilderApp.wiki.md) that can help you write URLs

for use with Minify or configure groups of files.



See the [cookbook](docs/CookBook.wiki.md) for more advanced options for minification.



More [docs are available](docs).



## Unit Testing



1. Install dev deps via Composer: `composer install`

1. `composer test` or `phpunit`



## Warnings



* Minify is designed for efficiency, but, for very high traffic sites, it will probably serve files slower than your HTTPd due to the CGI overhead of PHP. See the [FAQ](docs/FAQ.wiki.md#how-fast-is-it) and [CookBook](docs/CookBook.wiki.md) for more info.

* If you combine a lot of CSS, watch out for [IE's 4096 selectors-per-file limit](http://stackoverflow.com/a/9906889/3779), affects IE 6 through 9.

* Minify *should* work fine with files encoded in UTF-8 or other 8-bit encodings like ISO 8859/Windows-1252. By default Minify appends ";charset=utf-8" to the Content-Type headers it sends.



## Acknowledgments



Minify was inspired by [jscsscomp](http://code.google.com/p/jscsscomp/) by Maxim Martynyuk and by the article [Supercharged JavaScript](http://www.hunlock.com/blogs/Supercharged_Javascript) by Patrick Hunlock.



The [JSMin library](http://www.crockford.com/javascript/jsmin.html) used for JavaScript minification was originally written by Douglas Crockford and was [ported to PHP](https://github.com/mrclay/jsmin-php) by Ryan Grove specifically for use in Minify.