Code

Initial revision
[rrdtool-all.git] / contrib / php3 / README
2 PHP bindings for RRD Tool.
4         Contained herein are bindings to allow you to interface
5 php scripts with RRD tool directly via RRD tool's 'librrd' library,
6 thus avoiding the need to use system() calls to the rrdtool binary.
8         RRD Tool is an AMAZING package of tools to faciliate
9 the easy storage, retrieval, and graphing of statistics (usually
10 but not limited to bit/byte counts from routers, switches, and 
11 hubs).  It was written by the author of MRTG, Tobias Oetiker
12 (oetiker@ee.ethz.ch).  The primary web site for RRD Tool is:
13 http://www.caida.org/Tools/RRDtool
16 Reason I wrote this:  Wanted to use PHP to create fairly real-time / 
17 dynamic web pages w/ RRD tool, but the only way was to use system()
18 and popen() with PHP, since there was no direct interface to RRD
19 Tool from PHP.  The fork()ing would have been slow and tedious
20 so that was pretty much out of the question.  I could have used the 
21 Perl library (RRDs) to interface ePerl, or mod_perl, or even 
22 'rrdcgi', but I didn't really want to.  I wanted to use PHP and
23 there was nothing to change my mind.
26 You are free to redistribute the source provided my name is
27 kept at the top of the source files as credit for the original
28 author.  I make no warranties to the usability of this software,
29 nor I am responsible if your machine explodes (although it 
30 shouldn't).
33 BUGS:
34      There might be some.  Let me know: joeym@inficad.com.  
35 Patches to fix bugs you find are more welcome than simple
36 reports of bugs (I don't have a lot of time to maintain
37 this code).
40 http://netmon.inficad.com/php3_rrdtool/
42 Joey Miller, <joeym@inficad.com>, SkyLynx / Inficad Communications,
43 2/12/2000