README

markenstuermer/t3adminer adds Adminer to the TYPO3 backend as a compact database maintenance module. The extension is intended for trusted technical users who need quick access to the TYPO3 database without adding a separate database administration application to the project.

The TYPO3 extension key is markenstuermer_t3adminer.

Compatibility

Installation

Install the package in a TYPO3 project:

composer require markenstuermer/t3adminer

For local package development, add this repository as a Composer path repository in the host project and require the development version:

composer require markenstuermer/t3adminer:@dev

After installation, clear TYPO3 caches and open the Adminer backend module as a system maintainer.

Configuration

The extension configuration controls access and file locations:

• IPaccess: optional comma-separated allowlist for client IP addresses.
• applyDevIpMask: additionally enforce TYPO3's global devIPmask.
• exportDirectory: target directory for database exports.
• uploadDir: directory used for Adminer upload/import actions.

Relative paths are resolved from the document root where applicable. Keep export and upload locations outside public download workflows when possible.

Security Notes

Adminer gives direct database access. Use this module only in projects where system maintainer access is tightly controlled. In staging or production contexts, configure IP restrictions and avoid leaving database export files in publicly reachable locations.

Development

Install dependencies:

composer install

Common checks:

composer lint
composer qa
composer refactoring
composer test

composer lint covers Composer metadata, PHP syntax, PHP style, debug markers, TypoScript files if present, and PHPCS checks. composer qa runs PHPStan and PHPMD. composer refactoring runs Rector in dry-run mode. Test scripts look for future *Test.php files in Tests/Unit and Tests/Functional. Local tool configuration lives in Build/QA/.

Releases

Do not set a Composer version field. Package releases should be created with Git tags. The TYPO3 ext_emconf.php version starts at 1.0.0 and is independent from TYPO3 major versions.

Credits

This extension is based on the original jigal/t3adminer extension. Thanks to Jigal van Hemert and all previous contributors for their work on the TYPO3 Adminer integration.