Clockwork是一个用于PHP开发调试的Chrome扩展工具，该扩展工具在chrome浏览器的开发者工具中新增了一个名为Clockwork的面板，用于显示所有对调试和分析PHP代码有用的信息，这些信息包括请求、头、get/post数据、cookies、Session、数据库查询、路由、运行时间、日志等等。
说明
开发过 Rails 程序的朋友应该熟悉 RailsPanel , 是的 Clockwork 是 RailsPanel 的 PHP 版本.
Clockwork 由两个部分组成:
安装
首先安装 Chrome 插件 Clockwork , 然后照着 Github 项目 的 readme 安装服务器端的.
composer require itsgoingd/clockwork
使用
// Logging data to Clockwork can be done using the helper function, which even supports logging multiple values at once
clock(User::first(), auth()->user(), $username)
// If you want to specify a log level, you can use the long-form call
clock()->info("User {$username} logged in!")
Clockwork adds some general application runtime timeline events for you by default.
To add a custom event to the timeline, you'll need to start an event with an unique name and description first.
clock()->startEvent('twitter-api-call', "Loading users latest tweets via Twitter API")
After executing the tracked block of code, you can end the event, using it's unique name.
clock()->endEvent('twitter-api-call')
Events that are not stopped explicitly will simply finish when the application runtime ends.
Route::get('test', function () {
clock('log1', ['lwj' => 'thc']);
clock()->info("User logged in!");
clock()->startEvent('event_name', 'LaravelAcademy.org'); //事件名称，显示在Timeline中
clock('Message text.'); //在Clockwork的log中显示'Message text.'
logger('Message text.'); //也Clockwork的log中显示'Message text.'
clock(array('hello' => 'world')); //以json方式在log中显示数组
//如果对象实现了__toString()方法则在log中显示对应字符串，
//如果对象实现了toArray方法则显示对应json格式数据，
//如果都没有则将对象转化为数组并显示对应json格式数据
// clock(new Object());
clock()->endEvent('event_name');
});
通过 chrome 的 console 的 Clockwork
Chrome 插件端
How does it work?
详情请见 这里.
简单点解释呢, 如下:
Server side
服务器端收集数据, 并把数据整理为 json 格式输出, 每一次的请求都是有一个独立的 id, 通过 HTTP header 传输给 Chrome 插件, 如下面这两个是这一次返回的 header :
X-Clockwork-Id:1408631499.2148.1282148919
X-Clockwork-Version:1.5
Chrome 插件
Chrome 插件端, 通过上面传输过来的 X-Clockwork-Id header , 按照以下规则, 拼接 URL
/__clockwork/{id}
在此例子中, 得出
http://localhost:8000/__clockwork/1408631499.2148.1282148919
访问以上 URL 可以获取到 服务器端产生的 json 文件, 内容见这个 Gits.
Chrome 插件端拿到 json 数据以后, 就开始解析, 渲染到 console 里面啦.
