Download the PHP package dmitrynaum/sam without Composer
On this page you can find all versions of the php package dmitrynaum/sam. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download dmitrynaum/sam
More information about dmitrynaum/sam
Files in dmitrynaum/sam
Package sam
Short Description Simple assset manager
License MIT
Homepage https://github.com/DmitryNaum/SAM
Informations about the package sam
SAM - Simple Asset Manager
Это простой asset manager для управления js и css файлами.
Возможности
- Объединять разные css и js файлы в один
- Сжимать css и js (минифицировать)
- Контролировать кэш браузера
- Компилировать asset`ы на лету в Development окружении
- Использовать удаленные js и css (например с CDN)
- Работа с inline css и js
Установка
Использование
В корне проекта должен находится файл настроек sam.json
в котором описаны все необходимые для SAM`а параметры
Пример sam.json
Asset файлы сохраняются в папку которая указана в rootDir
+assetBasePath
. Т.е. asset app.css
из примера
выше будет сохранен в public/build/app.css
Компиляция
Есть несколько режимов компиляции asset`ов.
-
Простая компиляция. SAM просто соберет все asset`ы
-
Компиляция с минификацией. Asset`ы будут собраны и минифицированы
-
Компиляция с заморозкой. Asset`ы будут собраны и в название результирующих файлов будут добавлены их хэши. Это помогает избежать проблем с кэшем браузера
- Компиляция с минификацией и заморозкой.
Также компилятору asset`ов можно указать путь до sam.json
.
Рендеринг
Для того что бы добавить asset в шаблон Вашего сайта, выполните 2 простые команды
Рендеринг с атрибутами
Удаленные ресурсы
Для использования удаленных js и css файлов Вы можете воспользоваться методами Dmitrynaum\SAM\Asset::useRemoteJs()
и Dmitrynaum\SAM\Asset::useRemoteCss()
.
SAM не будет их нигде кэшировать, он просто обернет ссылки на ресурсы в соответствующие HTML теги
inline css & js
Компиляция на лету
Для удобной разработки в SAM`е предусмотрена возможность компилировать asset`ы на лету без лишних движений.
Для этого Вам необходимо в коде Вашего приложения в Development окружении сообщить SAM`у что он должен работать в development режиме, и запустить встроенный веб сервер SAM`а.
После чего все asset`ы будут доступны по адресу http://127.0.0.1:8090?asset=asset_name
и каждый раз при запросе необходимого asset`а они будут компилироваться на лету.
ВНИМАНИЕ!
Не используйте встроенный сервер SAM`а в Production окружении. Это не безопасно!
All versions of sam with dependencies
matthiasmullie/minify Version 1.3.*
symfony/console Version >=2.5.0
symfony/process Version >=2.5.0