Download the PHP package netresearch/nr-bug-reporter without Composer

On this page you can find all versions of the php package netresearch/nr-bug-reporter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package nr-bug-reporter

Bug Reporter for TYPO3

A TYPO3 backend extension that turns an error into a prefilled bug report on the originating package's own upstream GitHub tracker — plus a proactive "Report an issue" item in the backend toolbar that captures the current context.

Status: beta / MVP. The attribution engine is unit-tested and both backend features have been verified live in booted TYPO3 14.3.2 (PHP 8.5) and 13.4.30 (PHP 8.3) DDEV instances (see Verification). Not yet hardened for TER release (no functional/E2E test suite, no PHPStan or Rector configuration, and no RST docs yet).

What it does

Two entry points, one engine:

  1. Error-triggered (developer-facing). In Development application context, an uncaught exception renders the normal TYPO3 debug page with a "Report this bug" banner: the error is attributed to the third-party Composer package that most likely caused it, and the banner links to a prefilled issue on that package's GitHub tracker. If attribution is uncertain or the package is not on GitHub, the banner says so instead of filing a wrong report.
  2. Proactive (editor/developer-facing). A toolbar item (next to clear-cache/user) opens a dropdown showing the current module/URL, the last captured error (with a one-click GitHub link when one was resolved), and a short trail of recent backend actions. It offers a prefilled report to an admin-configured repository, or copy-to-clipboard text when none is configured.

Both share the attribution engine: map a stack frame to its owning package, resolve that package's upstream GitHub tracker, and gate whether a one-click report is actually appropriate.

Install

Targets TYPO3 13.4 LTS + 14.3 LTS, PHP 8.2–8.5, Composer-mode installs.

How attribution works

Input is the exception's [getFile(), …getTrace()] assembled as {file, class} frames, innermost→ outermost. The engine:

  1. Resolves each frame to its owning package — class FQCN first (PSR-4 namespace → package), file path second. (Class-first is what makes trait methods resolve to the consuming package.)
  2. Walks innermost→outermost; the first extension / non-infra-library frame wins (extension = high, library = medium), skipping TYPO3 core, infrastructure libs (symfony/doctrine/psr/…), and the reporter itself. A candidate reached through a PSR-14/PSR-15 dispatcher is demoted to low confidence (a passive listener/middleware is rarely the real culprit).
  3. Falls back to root-cause frames when the exception was re-wrapped ($previous chain).

Tracker resolution is a 4-tier chain (composer.json support.issues → support.source/homepage → composer.lock/installed.json VCS source url → curated map), GitHub-host gated, handling both https:// and SSH ([email protected]:owner/repo.git) forms.

A ReportPolicy then gates whether to offer an actionable button: it withholds for low/core/none confidence, traces shorter than 3 frames, and config/author-error exceptions — so robust resolution cannot amplify an attribution mistake into a harmful public issue.

Validation: the attribution engine

The engine was built spike-first and adversarially tested. The dev harness (CLI, runnable without a TYPO3 boot — see below) reports:

The CLI harness (bin/, fixtures/) is a local dev tool: it reads a sibling TYPO3 core checkout for a real package index, so it is not portable CI. The portable, self-contained tests live in Tests/Unit/ (PHPUnit, no TYPO3 runtime required).

Layout

Verification

Verified live in booted DDEV instances — TYPO3 14.3.2 / PHP 8.5 (primary) and 13.4.30 / PHP 8.3, Development context:

Found and fixed during the live install: the exception handler must be registered in config/system/additional.php — ext_localconf.php runs after TYPO3 reads the handler class, so a registration there is silently ignored. (The proactive toolbar is unaffected — it uses DI.)

Known limitations

Governance and policies

This extension follows the organisation-wide Netresearch policies:

Checks that run on every pull request in this repository:

No exception is recorded: composer.json has no config.audit.ignore entry.

Security

What data the extension collects, where it goes, which credentials it uses (none), who can create a report, and what users can and cannot expect in terms of security is in docs/SECURITY-ASSURANCE.md. Report vulnerabilities privately as described in the organisation's SECURITY.md, not in a public issue. A change that adds or removes a security control updates that document.

License

GPL-2.0-or-later


All versions of nr-bug-reporter with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
typo3/cms-core Version ^13.4 || ^14.3
typo3/cms-backend Version ^13.4 || ^14.3
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package netresearch/nr-bug-reporter contains the following files

Loading the files please wait ...