UID	github.com/firephp/firephp/			Stream	1	Author	cadorn
Namespace	github.com/firephp	Name	firephp	Version	1.0.0b1rc6	Date	1321310596

It is assumed you have DeveloperCompanion installed.

Activating Insight

Insight is the intelligence system used by FirePHP to gather and send information to the client. It must be activated for this to happen.

NOTE: DeveloperCompanion currently always activates Insight no matter the state of Firebug or the panels within it.

You must also authorize Insight for each hostname. See Authorizing.

Activation on a hostname basis is planned.

Authorizing Insight

Insight must be authorized for each hostname <-> client pair for the server to send data to the client.

To log messages to the Firebug Console you must have Insight activated, authorized and Firebug's Console and Net Panels enabled.

Messages logged to the page target will show up in the console. See: FirePHP::to('<target>') in the API Reference.

If Firebug is not open or the Console or Net panels are not enabled, messages will show up in the Companion Console.

To inspect a request you need to load it into the Companion. There are several ways to do that:

The debug data is always tracked (if Insight is activated and authorized) but needs to be loaded into the companion to be viewable.

Companion Workspace Request Table
When the Workspace for an application is open in DeveloperCompanion all requests are displayed in the Requests Table. Double-click on a request to load it into the Request Inspector.
x-insight URL Parameter
Append x-insight=inspect to any GET or POST URL.
CODE: {"lang":"php"}
```
// GET or POST URL parameter
...?x-insight=inspect
```
x-insight HTTP Request Header
Set an x-insight: inspect HTTP header on the request.
CODE: {"lang":"php"}
```
// HTTP Request Header
x-insight: inspect
```
x-insight HTTP Response Header
Set an x-insight: inspect HTTP header for the response.
CODE: {"lang":"php"}
```
header('x-insight: inspect');
```

PHP Code Trigger

Trigger an inspect from the PHP script.

CODE: {"lang":"php"}

$console = FirePHP::to('page')->console();
$console->show();
// or
$controller = FirePHP::to('controller');
$controller->triggerInspect();

See Insight/Control API for more information.