1 |
dashley |
38 |
<?php |
2 |
|
|
// |
3 |
|
|
//******************************************************************************** |
4 |
|
|
//Copyright (C) 2015 David T. Ashley |
5 |
|
|
//******************************************************************************** |
6 |
|
|
//This program or source file is free software; you can redistribute it and/or |
7 |
|
|
//modify it under the terms of the GNU General Public License as published by |
8 |
|
|
//the Free Software Foundation; either version 2 of the License, or (at your |
9 |
|
|
//option) any later version. |
10 |
|
|
// |
11 |
|
|
//This program or source file is distributed in the hope that it will |
12 |
|
|
//be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of |
13 |
|
|
//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
14 |
|
|
//GNU General Public License for more details. |
15 |
|
|
// |
16 |
|
|
//You may have received a copy of the GNU General Public License |
17 |
|
|
//along with this program; if not, write to the Free Software |
18 |
|
|
//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
19 |
|
|
//******************************************************************************** |
20 |
|
|
//This defines a simple PHP class to make it easier to implement a page statistic |
21 |
|
|
//that indicates how much CPU time was used by a page or a portion of a page. |
22 |
|
|
//The statistics are not always straightforward because each load of a page |
23 |
|
|
//may just add more used time to the same process. Stats must be obtained |
24 |
|
|
//by subtraction. |
25 |
|
|
// |
26 |
|
|
//The basic strategy is that a clock is constructed then may be alternatively |
27 |
|
|
//started, stopped, and polled. It is necessary to stop a clock before |
28 |
|
|
//polling it. |
29 |
|
|
// |
30 |
|
|
class Cpuusagestatclock |
31 |
|
|
{ |
32 |
|
|
//The fields below are updated each time the clock is stopped. |
33 |
|
|
var $utime_s; |
34 |
|
|
//The seconds portion of the amount of user time consumed. |
35 |
|
|
var $utime_m; |
36 |
|
|
//The microseconds portion of the amount of user time consumed. |
37 |
|
|
var $stime_s; |
38 |
|
|
//The seconds portion of the amount of system time consumed. |
39 |
|
|
var $stime_m; |
40 |
|
|
//The microseconds portion of the amount of system time consumed. |
41 |
|
|
|
42 |
|
|
//The following fields are analogous to the ones above, except they |
43 |
|
|
//hold time snapshot values from when the clock was most recently |
44 |
|
|
//started. |
45 |
|
|
var $ss_utime_s; |
46 |
|
|
var $ss_utime_m; |
47 |
|
|
var $ss_stime_s; |
48 |
|
|
var $ss_stime_m; |
49 |
|
|
|
50 |
|
|
//This is the constructor function. |
51 |
|
|
function Cpuusagestatclock() |
52 |
|
|
{ |
53 |
|
|
//All that is required at construction is to set the cumulative |
54 |
|
|
//values to zero. |
55 |
|
|
$this->utime_s = 0; |
56 |
|
|
$this->utime_m = 0; |
57 |
|
|
$this->stime_s = 0; |
58 |
|
|
$this->stime_m = 0; |
59 |
|
|
} |
60 |
|
|
|
61 |
|
|
//This starts the clock. This just records a static time usage mark. |
62 |
|
|
function start() |
63 |
|
|
{ |
64 |
|
|
//Get the snapshot from the system. |
65 |
|
|
$snapshot = getrusage(); |
66 |
|
|
|
67 |
|
|
//Record the values of interest. |
68 |
|
|
$this->ss_utime_s = $snapshot["ru_utime.tv_sec"]; |
69 |
|
|
$this->ss_utime_m = $snapshot["ru_utime.tv_usec"]; |
70 |
|
|
$this->ss_stime_s = $snapshot["ru_stime.tv_sec"]; |
71 |
|
|
$this->ss_stime_m = $snapshot["ru_stime.tv_usec"]; |
72 |
|
|
} |
73 |
|
|
|
74 |
|
|
|
75 |
|
|
//This stops the clock. This calculates the used time and adds it in to |
76 |
|
|
//the totals. |
77 |
|
|
function stop() |
78 |
|
|
{ |
79 |
|
|
//Get the snapshot from the system. |
80 |
|
|
$snapshot = getrusage(); |
81 |
|
|
|
82 |
|
|
//Calculate and add in the elapsed user time usage since the snapshot. |
83 |
|
|
$this->utime_s += ($snapshot["ru_utime.tv_sec"] - $this->ss_utime_s); |
84 |
|
|
$this->utime_m += ($snapshot["ru_utime.tv_usec"] - $this->ss_utime_m); |
85 |
|
|
while ($this->utime_m < 0) |
86 |
|
|
{ |
87 |
|
|
$this->utime_m += 1000000; |
88 |
|
|
$this->utime_s--; |
89 |
|
|
} |
90 |
|
|
|
91 |
|
|
//Calculate and add in the elapsed system time usage since the snapshot. |
92 |
|
|
$this->stime_s += ($snapshot["ru_stime.tv_sec"] - $this->ss_stime_s); |
93 |
|
|
$this->stime_m += ($snapshot["ru_stime.tv_usec"] - $this->ss_stime_m); |
94 |
|
|
while ($this->stime_m < 0) |
95 |
|
|
{ |
96 |
|
|
$this->stime_m += 1000000; |
97 |
|
|
$this->stime_s--; |
98 |
|
|
} |
99 |
|
|
} |
100 |
|
|
|
101 |
|
|
//This returns the user time microseconds elapsed of a stopped clock, with no padding. |
102 |
|
|
function utime_raw_us() |
103 |
|
|
{ |
104 |
|
|
return($this->utime_m); |
105 |
|
|
} |
106 |
|
|
|
107 |
|
|
//This returns the user time microseconds elapsed of a stopped clock, padded |
108 |
|
|
//with leading zeros to be six digits long. |
109 |
|
|
function utime_formatted_us() |
110 |
|
|
{ |
111 |
|
|
$rv = $this->utime_raw_us(); |
112 |
|
|
|
113 |
|
|
while(strlen($rv) < 6) |
114 |
|
|
$rv = "0" . $rv; |
115 |
|
|
|
116 |
|
|
return($rv); |
117 |
|
|
} |
118 |
|
|
|
119 |
|
|
//This returns the system time microseconds elapsed of a stopped clock, with no padding. |
120 |
|
|
function stime_raw_us() |
121 |
|
|
{ |
122 |
|
|
return($this->stime_m); |
123 |
|
|
} |
124 |
|
|
|
125 |
|
|
//This returns the system time microseconds elapsed of a stopped clock, padded |
126 |
|
|
//with leading zeros to be six digits long. |
127 |
|
|
function stime_formatted_us() |
128 |
|
|
{ |
129 |
|
|
$rv = $this->stime_raw_us(); |
130 |
|
|
|
131 |
|
|
while(strlen($rv) < 6) |
132 |
|
|
$rv = "0" . $rv; |
133 |
|
|
|
134 |
|
|
return($rv); |
135 |
|
|
} |
136 |
|
|
|
137 |
|
|
//This returns the total time microseconds elapsed of a stopped clock, with no padding. |
138 |
|
|
function ttime_raw_us() |
139 |
|
|
{ |
140 |
|
|
$rv = $this->stime_m + $this->utime_m; |
141 |
|
|
|
142 |
|
|
if ($rv >= 1000000) |
143 |
|
|
$rv -= 1000000; |
144 |
|
|
|
145 |
|
|
return($rv); |
146 |
|
|
} |
147 |
|
|
|
148 |
|
|
//This returns the total time microseconds elapsed of a stopped clock, padded |
149 |
|
|
//with leading zeros to be six digits long. |
150 |
|
|
function ttime_formatted_us() |
151 |
|
|
{ |
152 |
|
|
$rv = $this->ttime_raw_us(); |
153 |
|
|
|
154 |
|
|
while(strlen($rv) < 6) |
155 |
|
|
$rv = "0" . $rv; |
156 |
|
|
|
157 |
|
|
return($rv); |
158 |
|
|
} |
159 |
|
|
|
160 |
|
|
//This returns the user time seconds elapsed of a stopped clock. |
161 |
|
|
function utime_s() |
162 |
|
|
{ |
163 |
|
|
return($this->utime_s); |
164 |
|
|
} |
165 |
|
|
|
166 |
|
|
//This returns the system time seconds elapsed of a stopped clock. |
167 |
|
|
function stime_s() |
168 |
|
|
{ |
169 |
|
|
return($this->stime_s); |
170 |
|
|
} |
171 |
|
|
|
172 |
|
|
//This returns the total time seconds elapsed of a stopped clock. |
173 |
|
|
function ttime_s() |
174 |
|
|
{ |
175 |
|
|
$rv = $this->stime_s + $this->utime_s; |
176 |
|
|
|
177 |
|
|
$us_total = $this->stime_m + $this->utime_m; |
178 |
|
|
|
179 |
|
|
if ($us_total >= 1000000) |
180 |
|
|
$rv++; |
181 |
|
|
|
182 |
|
|
return($rv); |
183 |
|
|
} |
184 |
|
|
|
185 |
|
|
//This returns the standard string for a footer of a web page. No HTML formatting tags |
186 |
|
|
//are included. |
187 |
|
|
function std_web_page_cpu_time_usage_footer() |
188 |
|
|
{ |
189 |
|
|
return |
190 |
|
|
( |
191 |
|
|
"This page required approximately " |
192 |
|
|
. |
193 |
|
|
$this->ttime_s() |
194 |
|
|
. |
195 |
|
|
"." |
196 |
|
|
. |
197 |
|
|
Substr($this->ttime_formatted_us(), 0, 2) |
198 |
|
|
. |
199 |
|
|
"s (" |
200 |
|
|
. |
201 |
|
|
$this->stime_s() |
202 |
|
|
. |
203 |
|
|
"." |
204 |
|
|
. |
205 |
|
|
Substr($this->stime_formatted_us(), 0, 2) |
206 |
|
|
. |
207 |
|
|
"s system, " |
208 |
|
|
. |
209 |
|
|
$this->utime_s() |
210 |
|
|
. |
211 |
|
|
"." |
212 |
|
|
. |
213 |
|
|
Substr($this->utime_formatted_us(), 0, 2) |
214 |
|
|
. |
215 |
|
|
"s user) of CPU time on the server to generate." |
216 |
|
|
); |
217 |
|
|
} |
218 |
|
|
} |
219 |
|
|
?> |