phpThumbOf – настраиваемый выходной фильтр для MODx Revolution, позволяющий использовать phpThumb с любыми адресами излбражений, заданными в плейсхолдере.
Системные требования
- MODxRevolution 2.0.4 или более новая версия
- PHP5 или более новая версия
История создания
phpThumbOf написан Шоном МакКорником как безопасный выходной фильтр phpThumb, первый релиз выпущен 3 ноября 2010.
Загрузка
Фильтр может быть загружен с помощью менеджера MODx Revolution, используя Package Management, или из хранилища дополнений MODx.
Атрибуты
- w = ширина (в пикселах)
- h = высота (в пикселах)
- zc = Кадрирование при масштабировании. “1” включает кадрирование при масштабировании.
Примеры использования
Изменение размера изображения на 120 x 120 пикселов
|
|
Создание миниатюры размером 300x300, с кадрированием при масштабировании
|
|
|
| |
Если используете TV, выходной тип TV должен быть 'text'. |
phpthumbof облададет не только вышеприведенными свойствами, документацию по phpThumb можно найти, используя Google.
Использование AmazonS3
phpThumbOf может использовать Amazon S3 для хранения кэшированных изображений вместо их хранения их локально. Также вы можете использовать Amazon CloudFront content delivery network для обслуживания этих изображений. Сначала вам нужно создать аккаунт на Amazon AWS и создать контейнер для его использования в phpThumbOf. Для использования CloudFront, создайте рассылку CloudFront для использования с данным контейнером, а также создайте поддомен, если вы хотите использовать его.
Используйте нижеприведенные системные параметры для настройки phpThumbOf при использовании Amazon S3. Эти параметры могут быть аннулированы при вызове phpThumbOf как сниппета, и в вызове могут быть заданы иные параметры, параметры также могут быть аннулированы при использовании набора свойств.
|
Имя системных установок |
Ключ |
Описание |
|
|
Amazon S3 Bucket |
phpthumbof.s3_bucket |
Имя контейнера Amazon S3, который вы планируете использовать с phpThumbOf. |
|
| |
|
|
|
|
Amazon S3 CacheTime |
4phpthumbof.s3_cache_time |
Время хранения в кэше, в часах, миниатюр изображений для Amazon S3. Более старые миниатюры буду автоматически регенерированы, когда phpThumbOf будет вызван некэшируемым. Если плагин phpThumbOfCacheManager будет подключен, то это удалит все миниатюры Amazon S3 при очистке кэша сайта. |
|
|
Использование PHP get_headers для проверки измененной даты. |
phpthumbof.s3_headers_check |
Если задано "Yes", то phpThumbOf будет использовать use PHP's get_headers для проверки измененной даты S3 thumbos. По умолчанию это задано как "No", что подразумевает, что phpThumbOf будет использовать Amazon S3 get_object_url, что намного быстрее. Переключите это в положение “Оn” если имеются проблемы с кэшированием |
|
|
Amazon S3 HostAlias |
phpthumbof.s3_host_alias |
Если вы используете CNAME или другой псевдоним для изменения домена сервиса S3, введите его здесь (без замыкающего слэша). Если вы используете Amazon CloudFront для доставки контента, введите используемый домен для CloudFront доставки. Это может быть домен вашей CloudFront рассылки, или домен, который вы используете в качестве псевдонима этой рассылки. |
|
|
Amazon S3 Key |
phpthumbof.s3_key |
Введите здесь ID ключа доступа вашего Amazon S3 аккаунта, который вы можете найти на странице Security Credentials в вашем аккаунте Amazon S3. |
|
|
Amazon S3 BucketPath |
phpthumbof.s3_path |
Путь к вашему контейнеру Amazon S3, куда вы планируете кэшировать файлы. |
|
|
Amazon S3 SecretKey |
phpthumbof.s3_secret_key |
Введите здесь Secret Access Key вашего аккаунта Amazon S3t, его можно найти на странице Security Credentials. |
|
|
UseAmazon S3 |
phpthumbof.use_s3 |
После того, как вы сконфигурировали все вышеуказанные параметры, задайте этот параметр как "Yes" для использования вашего контейнера Amazon S3 для хранения кэшированных миниатюр.1111111 |
|
Если место для хранения не является проблемой или вы используете много различных динамически создаваемых миниатюр, вы можете отключить плагин phpThumbOfCacheManager при использовании Amazon S3 для повышения производительности. После того, как кэш сайта будет очищен или phpThumbOf будет вызван некешируемым, phpThumbOf проверит, существуют ли миниатюры на AmazonS3 перед тем, как регенерировать их. phpThumbOf будет регенерировать кэшированные миниатюры, если будет вызван некэшируемым и если миниатюры будут старше, чем задано настройках Amazon S3 Cache Time.
Устранение неполадок
- Убедитесь, что "assets/components/phpthumbof/cache" директория создана и заданы права на запись для PHP
- Убедитесь, что установлен и включен ImageMagick при инсталляции PHP
- Если ваш host использует symlinks для создания структуры директорий, убедитесь, что symlinks верны, правильный путь в core/config/config.inc.php4
