https://github.com/mrclay/minify

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

Last synced: 3 months ago
JSON representation

Combines. minifies, and serves CSS or Javascript files

• Host: GitHub
• URL: https://github.com/mrclay/minify
• Owner: mrclay
• License: bsd-3-clause
• Created: 2011-06-25T05:52:15.000Z (almost 13 years ago)
• Default Branch: master
• Last Pushed: 2024-01-04T06:29:08.000Z (6 months ago)
• Last Synced: 2024-04-02T19:45:08.189Z (3 months ago)
• Language: PHP
• Homepage:
• Size: 1.69 MB
• Stars: 2,996
• Watchers: 151
• Forks: 473
• Open Issues: 57
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Lists

• php-awesome - Minify - JS 和 CSS 压缩工具 (类库 / 前端相关)
• awesome-stars - minify - Combines. minifies, and serves CSS or Javascript files (PHP)

README

        
# Welcome to Minify!

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.