Sourcemint
Where code meets community
About
Feedback
ALPHA
UID github.com/firephp/firephp/ Stream 1 Author cadorn
Namespace github.com/firephp Name firephp Version 1.0.0b1rc6 Date 1321310596
FirePHP 1.0
CC BY-NC-SA 2.5
© Christoph Dorn
powered by PINF Docs

Configuring FirePHP via constants is the easiest and fastest way to get setup with much of what FirePHP 1.0 has to offer. If more configuration freedom or all advanced FirePHP 1.0 + DeveloperCompanion features are needed configuration via files should be used. See Install for a comparison.

Configuring

Configuring FirePHP involves two steps for every installation on a different URL and client combination:

  1. Obtain an Authorization Key for the Installation URL from the client. See Authorizing.
  2. Insert the Authorization Key into the code below and place the code at the top of the bootstrap file before any application code is run.

The Insight configuration constants:

define('INSIGHT_IPS', '*');
define('INSIGHT_AUTHKEYS', '<Authorization Key>');
define('INSIGHT_PATHS', dirname(__FILE__));
define('INSIGHT_SERVER_PATH', '/<ServerScript.php>');

  • The INSIGHT_IPS constant lists all client IP Addresses (or prefixes) that are allowed to access FirePHP.

  • The INSIGHT_AUTHKEYS constant lists all client Authorization Keys that are allowed to access FirePHP. See Authorizing for how to obtain an Authorization Key from the client.

  • The INSIGHT_PATHS constant lists all root paths accessible by FirePHP that may be sent to the client.

  • The INSIGHT_SERVER_PATH constant must point to a script (relative to the document root) that includes FirePHP and is used to fetch data from the server. It may point to any existing script in your application as FirePHP will terminate the request after it has responded accordingly.

    For example, if an application is hosted at http://example.com/application/, the INSIGHT_SERVER_PATH constant must be set to /application/.

Keep INSIGHT_IPS as specific as possible!

If you allow ALL (*) for BOTH INSIGHT_IPS and INSIGHT_AUTHKEYS ANYONE will be able to access your application internals!

Multiple ips, authkeys or paths may be separated by comma.

Including

Include FirePHP right after configuring it.

If using the phar archive

require_once('phar://.../firephp.phar/FirePHP/Init.php');

Three dots (...) denotes a path that needs to be replaced.

If using the extracted zip archive

require_once('/<Extracted Zip Archive>/lib/FirePHP/Init.php');

Instead of using an absolute path to the /<Extracted Zip Archive>/lib folder it may be placed on the include path.

FirePHP Procedural API: FB::*

To get access to the FirePHP Procedural API as well as the Insight API replace FirePHP/Init.php with FirePHP/FB.php above.
Sourcemint by Christoph Dorn. Copyright 2011 Christoph Dorn. All rights reserved.

Homepage: Sourcemint.com

Status

Sourcemint is incomplete ALPHA technology and continuously evolving in sync with underlying and related projects. Production ready aspects will be documented and made available in time. Your Feedback is welcome and appreciated!

Who

Sourcemint is one of the results of intense focus by Christoph Dorn over the past several years and continuous exploration throughout Christoph's interest in software development over the past 15+ years.

Sourcemint is the love child of one person guided by the voices of passionate developers at the top of their game who are leading the industry into a new era of software development.

What

Sourcemint is an integral part of Christoph's work intended to realize his dream of one global toolchain under which components may be arbitrarily combined into maintainable mission critical systems by providing an all-encompassing and organized package repository from which consistent and autonomic systems may be built.

Sourcemint provides an automated software building and integration service as well as an intelligent software delivery network to distribute built software to all deployed systems and Internet users.

This means an arbitrary (code, configuration, network, ...) change may be made to a software system which can then be automatically built, tested, distributed and deployed. Every change constitutes a completely new system made possible by the fact that changes, any changes, are cheap and fully tested in every way before going live.

Just imagine what this means in your daily work.

Why

Automated software builds, continuous integration processes, streamlined issue trackers, community supported software, source control, online collaboration and automated cloud deployment have wet our appetite but hardly scratch the surface of what it actually means to have a completely automated production cycle from idea to delivery. The full potential is only realized once these separate solutions addressing different areas work together harmoniously.

What has been missing is new ways of looking at how to build software.

How

Christoph's work provides a new way to build software that is not necessarily new in the sense of ideas or technology but rather arrangement and timing. Christoph has through exploration and experimentation distilled current cutting edge technology, knowledge and wisdom into a toolchain platform called PINF available open source under the MIT license to realize a new breed of software.

Imagine software and systems that just work and are a pleasure to maintain.

Sourcemint is built entirely on PINF, as is all of Christoph's work, and can be used by any developer to tap into the power of the PINF approach to build open source or commercial libraries, frameworks, applications, systems and services.

Christoph's hope is that PINF and related projects will provide a foundation for developers to cooperate more widely and experiment with new ideas by eliminating some of the major constraints imposed by traditional toolchains. Traditional toolchains create systems that typically rot because they are practically impossible to refactor. We need a toolchain such as PINF which has refactorability designed into its core.

Let's create software that breathes with life and is in large part self-sustaining!

You

Join Christoph in his mission to help you, the developer, and help yourself by broadly applying the tools and approaches you know work to all of your work. Lean on PINF, your mind is begging you. Learn it, teach others, and let your inspiration soar!

Follow Sourcemint and PINF on twitter to watch for news of cutting-edge tools, tutorials and services coming online. You can also follow Christoph's work directly.