https://github.com/firephp/firephp-for-browser-devtools
FirePHP for Browser Developer Tools (Web Extension)
https://github.com/firephp/firephp-for-browser-devtools
chrome-extension devtools-extension firefox-extension firephp php
Last synced: 3 months ago
JSON representation
FirePHP for Browser Developer Tools (Web Extension)
- Host: GitHub
- URL: https://github.com/firephp/firephp-for-browser-devtools
- Owner: firephp
- Created: 2016-10-02T09:20:56.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-11T08:17:15.000Z (over 2 years ago)
- Last Synced: 2025-04-12T02:25:56.498Z (3 months ago)
- Topics: chrome-extension, devtools-extension, firefox-extension, firephp, php
- Language: JavaScript
- Homepage: http://firephp.org
- Size: 7.41 MB
- Stars: 41
- Watchers: 4
- Forks: 3
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
FirePHP for Browser Developer Tools [](https://github.com/firephp/firephp-for-browser-devtools/actions?query=workflow%3ABuild)
===================================
This project holds the [FirePHP Tool](http://firephp.org) in the form of a Browser Extension compatible with:
* Mozilla Firefox - https://developer.mozilla.org/en-US/Add-ons/WebExtensions
* Google Chrome - https://developer.chrome.com/extensions
* Brave - (runs Google Chrome extensions)
> Log from PHP to Browser Developer Tools via HTTP Response Headers.
Supported protocols:
* FirePHP (Wildfire based)
* [Chrome Logger](https://craig.is/writing/chrome-logger/techspecs)
For a list of supported server libraries see [http://firephp.org](http://firephp.org).
Preview
-------
Install
=======
## Published
* Firefox: [addons.mozilla.org/en-US/firefox/addon/firephp](https://addons.mozilla.org/en-US/firefox/addon/firephp/)
* Chrome & Brave: [chrome.google.com/webstore/detail/firephp/ikfbpappjhegehjflebknjbhdocbgkdi](https://chrome.google.com/webstore/detail/firephp/ikfbpappjhegehjflebknjbhdocbgkdi)
## Local
* [Firefox & Chrome unpacked](https://github.com/firephp/firephp-for-browser-devtools/releases) (downloads do **NOT** auto-update)
## Source
Requirements (tested on macOS):
* [bash 4](https://www.gnu.org/software/bash/) - GNU Bash
* [nvm](https://github.com/creationix/nvm) - Node Version Manager
Build from source:
nvm use 14.2.0
npm install
npm run build
*Load unpacked Addon* from `dist/firephp.build.*/` into Firefox, Chrome or Brave.
Run from source:
**Status: DEV - The development experience is still work in progress!**
nvm use 14.2.0
npm install
npm run dev
## Notes for build reviewers
* Releases for this extension are built using [github.com/pinf-to/to.pinf.org.mozilla.web-ext](https://github.com/pinf-to/to.pinf.org.mozilla.web-ext).
* The tool provides a runtime framework for browser extensions as well as a build tool.
* The build is controlled by `./#!inf.json`.
* The following `./dist/firephp.build` files hold extension specific code and are built from `./src` by the build tool:
* `scripts/background.js` - webext **background.page** code
* `scripts/devtools/dist/index.js` - webext **devtools_page** code
* `scripts/devtools/dist/*.rep.*` - generated from `src/*.rep.js`
* `skin`
* `manifest.json`
* The following `./dist/firephp.build` files belong to the runtime framework and are generated by the build tool:
* `devtools-page.js`
* `devtools-page.html`
* `background.js`
* `background.html`
* `lib.js`
* `default.css`
* `scripts/devtools/dist/index.loader.js`
* `scripts/devtools/dist/index.html`
* `run.config.json`
* The following `./dist/firephp.build` files are supporting libraries provisioned by the build tool:
* `scripts/devtools/dist/dist/jquery3.min.js` - https://code.jquery.com/jquery-3.5.0.min.js
* `scripts/devtools/dist/dist/jsonrep.js` - https://github.com/jsonrep/jsonrep
* `scripts/devtools/dist/dist/riot.csp.js` - https://github.com/riot/riot
* `scripts/devtools/dist/dist/reps/insight.rep.js` - https://github.com/insight/insight.domplate.reps
* `scripts/devtools/dist/dist/reps/insight.domplate.reps/` - https://github.com/insight/insight.domplate.reps
* `scripts/devtools/dist/fireconsole.rep.*` - https://github.com/fireconsole/fireconsole.rep.js
* `lib/codemirror` - https://github.com/codemirror/codemirror
* `lib/github.com~pinf~pinf-for-mozilla-web-ext/` - https://github.com/pinf/pinf-for-mozilla-web-ext
* `lib/eventemitter3.js` - https://github.com/primus/EventEmitter3
Release
=======
1. Increment **major**, **minor**, or **patch** version in `package.json`
2. To **preview**, push **branch** and verify [build](https://github.com/firephp/firephp-for-browser-devtools/actions) (will append `[]` to extension name/version)
3. To **release**, merge to **master**, `git tag v` and push (will build a release for distribution and upload to [releases](https://github.com/firephp/firephp-for-browser-devtools/releases))
5. Download releases
6. Upload to https://addons.mozilla.org/en-US/developers/
7. Upload to https://chrome.google.com/u/2/webstore/devconsole
Provenance
==========
Copyright © 2016-2020 [Christoph Dorn](http://christophdorn.com).
Licensed under the [Open Software License (OSL 3.0)](https://opensource.org/licenses/OSL-3.0).
Contributions must be licensed under the [Academic Free License (AFL 3.0)](https://opensource.org/licenses/AFL-3.0).
Learn about the OSL & AFL Licenses [here](http://rosenlaw.com/OSL3.0-explained.htm).
```
Open Software License (OSL) 3.0
You are free to:
Use Commercially, Distribute, Modify, Use Patents, Use Privately
Under the following terms:
Disclose source, License and copyright notice, Network use is distribution, Same license
You cannot:
Use trademark, Hold liable, Claim warranty
```
```
Academic Free License (AFL) 3.0
You are free to:
Use Commercially, Distribute, Modify, Use Patents, Use Privately
Under the following terms:
License and copyright notice
You cannot:
Use trademark, Hold liable, Claim warranty
```
> Well-crafted Contributions are Welcome.
**INTENDED USE:** The *Logic and Code contained within* forms a **Developer Tool** and is intended to operate as part of a *Web Software Development Toolchain* on which a *Production System* operates indirectly. It is **NOT INTENDED FOR USE IN HIGH-LOAD ENVIRONMENTS** as there is *little focus on Runtime Optimization* in order to *maximize API Utility, Compatibility and Flexibility*.
If you *need more* than what is contained within, study the Code, understand the Logic, and build your *Own Implementation* that is *API Compatible*. Share it with others who follow the same *Logic* and *API Contract* specified within. This Community of Users may want to use Your Work in their own *Software Development Toolchains*.