xref: /netbsd-src/external/cddl/dtracetoolkit/dist/Php/Readme (revision c29d51755812ace2e87aeefdb06cb2b4dac7087a)
1Php - DTracing PHP
2
3   These scripts trace the PHP programming language, and require the PHP
4   DTrace extension module to be installed and enabled.
5
6   The PHP DTrace provider was written by Wes Furlong, and is available
7   for download both as source and in binary form. The easiest instructions
8   are currently at,
9
10	http://blogs.sun.com/shanti/entry/dtrace_support_for_php
11
12   which were written for Solaris and the coolstack distribution of PHP.
13   The steps are roughly,
14
15	1. Download the extension library from the URL above
16	2. Copy the library to your php/extensions/* directory
17	3. Edit your php.ini and add,
18		extension="dtrace.so"
19
20   The website with the PHP DTrace provider source is,
21
22	http://pecl.php.net/package/DTrace
23
24   Here you can fetch the source to build the library yourself, especially
25   if Solaris binaries from the previous URL aren't going to work for you.
26
27   Since the DTrace PHP provider may be developed further, there is a chance
28   that it has changed slightly by the time you are reading this, causing
29   these scripts to either break or behave oddly. Firstly, check for newer
30   versions of the DTraceToolkit; if it hasn't been updated and you need
31   to use these scripts immediately, then updating them shouldn't take
32   too long. The following was the state of the provider when these scripts
33   were written - check for changes and update the scripts accordingly,
34
35	provider php {
36	    probe function-entry(function, file, lineno)
37	    probe function-return(function, file, lineno)
38	};
39
40