README

在 ZF2 控制器和视图中使用的常用工具。

Zend Framework 2 视图助手

• less() 将 LESS 文件转换为 CSS
• js() 获取版本化的 js 文件
• dateFormat() 以不同的、常用的格式格式化日期
• percent() 快速计算百分比

MQUtil\Collector\Milq

ZendDeveloperTools 收集器列出环境、时区和默认locale

MQUtil\Log\Writer\Doctrine

Doctrine 日志写入器

MQUtil\Service\ShortUrl

使用 Google urlshortener API 的 URL 缩略器。

MQUtil\Service\Paginator

非常简单且易于使用的分页类

MQUtil\Service\Iterator

支持 prevItem 的超简单且易于使用的迭代类

安装

1. 运行 php composer.phar require milqmedia/mq-util:dev-master
2. 将 MQUtil 添加到启用模块列表中
3. 在模板中使用 less 或 js 视图助手

用法

Less & JS 助手

$this->headLink()->setStylesheet($this->basePath($this->less('less/site.less')))
$this->headScript()->setFile({$this->basePath($this->js('jquery')))

百分比视图助手

$this->percent($total, $count, $reverse = false);

• $total: 总项目数
• $count: 要计算百分比的项数
• $reverse: 返回剩余百分比而不是计算出的百分比

DateFormat 视图助手

$this->dateFormat($date)->dayName();

可用方法

• forumDate: 如果是今天，则返回 "H:i"，如果是今年，则返回 "d-m H:i"，否则返回 "d-m-y H:i"
• ago: 返回自给定日期以来的秒数、分钟数、小时数、天数等。
• dayName($short = false): 给定日期的星期名称，如果 short 为 true，则星期名称为简短格式，例如 Sun。
• monthName: 给定日期的月份名称

MQUtil\Collector\Milq

将收集器添加到 zdt 配置文件中

array(
    'zenddevelopertools' => array(
        'profiler' => array(
            'collectors' => array('milq' => 'MQUtil\Collector\Milq'),
        ),
    )

并将模板添加到工具栏中

array(
    'zenddevelopertools' => array(
        'toolbar' => array(
          'entries'       => array(
	          'milq' => 'zend-developer-tools/toolbar/milq',
	        ),
	      )
	   )
)

MQUtil\Log\Writer\Doctrine

将软件包根目录中的 Log.php.dist 文件复制到您的实体目录。如有必要，更改命名空间。

使用方法如下

$this->getServiceLocator()->get('Zend\Log\Logger')->err("error")

MQUtil\Service\ShortUrl

配置您的 Google API 密钥

return array(
	'google_short_url' => array(
		'apiKey' => '<key>',
	)
);

使用方法如下

$shortUrlApi = $this->getServiceLocator()->get('MQUtil\Service\ShortUrl');
$response = $shortUrlApi->shortenUrl('http://google.com');

如果成功，响应将如下所示

{
 "kind": "urlshortener#url",
 "id": "http://goo.gl/fbsS",
 "longUrl": "http://www.google.com/"
}

MQUtil\Service\Paginator

创建一个新的分页对象

$paginator = $this->getServiceLocator()->get('MQUtil\Service\Paginator')->getPaginator($numberOfItems, $numberOfItemsPerPage, $currentPage);

可用方法

$paginator->next();
$paginator->prev();
$paginator->current();
$paginator->total();
$paginator->offsetStart();
$paginator->isLastPage();

MQUtil\Service\Iterator

创建一个新的迭代对象

$iterator = $this->getServiceLocator()->get('MQUtil\Service\Iterator')->getIterator($array, $currentItem);

可用方法

$iterator->hasNext();
$iterator->nextItem();
$iterator->hasPrev();
$iterator->prevItem();
$iterator->currentItem();
$iterator->isLastItem();

开发

...

贡献

1. 将其分支 ( https://github.com/milqmedia/mq-util/fork )
2. 创建您的功能分支 (git checkout -b my-new-feature)
3. 提交您的更改 (git commit -am '添加一些功能')
4. 推送到分支 (git push origin my-new-feature)
5. 创建一个新的拉取请求