<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Introduction</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="book.phpdbg.html">phpdbg</a></div>
<div class="next" style="text-align: right; float: right;"><a href="phpdbg.setup.html">Installing/Configuring</a></div>
<div class="up"><a href="book.phpdbg.html">phpdbg</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="intro.phpdbg" class="preface">
<h1 class="title">Introduction</h1>
<p class="para">
Implemented as a SAPI module, phpdbg can exert complete control over the
environment without impacting the functionality or performance of your code.
</p>
<p class="para">
phpdbg aims to be a lightweight, powerful, easy to use debugging platform for PHP.
It offers the following features:
<ul class="itemizedlist">
<li class="listitem">
<span class="simpara">Step-Through Debugging</span>
</li>
<li class="listitem">
<span class="simpara">Flexible Breakpoints (Class Method, Function, File:Line, Address, Opcode)</span>
</li>
<li class="listitem">
<span class="simpara">Easy Access to PHP with built-in eval()</span>
</li>
<li class="listitem">
<span class="simpara">Userland API</span>
</li>
<li class="listitem">
<span class="simpara">SAPI Agnostic - Easily Integrated</span>
</li>
<li class="listitem">
<span class="simpara">PHP Configuration File Support</span>
</li>
<li class="listitem">
<span class="simpara">JIT Super Globals - Set Your Own !!</span>
</li>
<li class="listitem">
<span class="simpara">Optional readline Support - Comfortable Terminal Operation</span>
</li>
<li class="listitem">
<span class="simpara">Easy Operation - See Help :)</span>
</li>
</ul>
</p>
<p class="para">
<table class="doctable table">
<caption><strong>Command line options</strong></caption>
<thead>
<tr>
<th>Option</th>
<th>Example Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td>-c</td>
<td>-c/my/php.ini</td>
<td>
Set php.ini file to load
</td>
</tr>
<tr>
<td>-d</td>
<td>-dmemory_limit=4G</td>
<td>
Set a php.ini directive
</td>
</tr>
<tr>
<td>-n</td>
<td class="empty"> </td>
<td>
Disable default php.ini
</td>
</tr>
<tr>
<td>-q</td>
<td class="empty"> </td>
<td>
Suppress welcome banner
</td>
</tr>
<tr>
<td>-v</td>
<td class="empty"> </td>
<td>
Enable oplog output
</td>
</tr>
<tr>
<td>-b</td>
<td class="empty"> </td>
<td>
Disable color
</td>
</tr>
<tr>
<td>-i</td>
<td>-imy.init</td>
<td>
Set .phpdbginit file
</td>
</tr>
<tr>
<td>-I</td>
<td class="empty"> </td>
<td>
Ignore default .phpdbginit
</td>
</tr>
<tr>
<td>-O</td>
<td>-Omy.oplog</td>
<td>
Set oplog output file
</td>
</tr>
<tr>
<td>-r</td>
<td class="empty"> </td>
<td>
Run execution context
</td>
</tr>
<tr>
<td>-rr</td>
<td class="empty"> </td>
<td>
Run execution context and quit after execution (not respecting breakpoints)
</td>
</tr>
<tr>
<td>-e</td>
<td class="empty"> </td>
<td>
Generate extended information for debugger/profiler
</td>
</tr>
<tr>
<td>-E</td>
<td class="empty"> </td>
<td>
Enable step through eval, careful!
</td>
</tr>
<tr>
<td>-s</td>
<td>-s=, -s=foo</td>
<td>
Read code to execute from stdin with an optional delimiter
</td>
</tr>
<tr>
<td>-S</td>
<td>-Scli</td>
<td>
Override SAPI name, careful!
</td>
</tr>
<tr>
<td class="empty"> </td>
<td class="empty"> </td>
<td>
<p class="para">
</p>
</td>
</tr>
<tr>
<td>-l</td>
<td>-l4000</td>
<td>
Setup remote console ports
</td>
</tr>
<tr>
<td>-a</td>
<td>-a192.168.0.3</td>
<td>
Setup remote console bind address
</td>
</tr>
<tr>
<td>-x</td>
<td class="empty"> </td>
<td>
Enable xml output (instead of normal text output)
</td>
</tr>
<tr>
<td>-p</td>
<td>-p, -p=func, -p*</td>
<td>
Output opcodes and quit
</td>
</tr>
<tr>
<td>-h</td>
<td class="empty"> </td>
<td>
Print the help overview
</td>
</tr>
<tr>
<td>-V</td>
<td class="empty"> </td>
<td>
Print version number
</td>
</tr>
<tr>
<td>--</td>
<td>-- arg1 arg2</td>
<td>
Use to delimit phpdbg arguments and php $argv; append any $argv argument after it
</td>
</tr>
</tbody>
</table>
</p>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="book.phpdbg.html">phpdbg</a></div>
<div class="next" style="text-align: right; float: right;"><a href="phpdbg.setup.html">Installing/Configuring</a></div>
<div class="up"><a href="book.phpdbg.html">phpdbg</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
