sabbottlabs/laravel-adminerneo

Laravel integration for AdminerNeo v5, a modern database management tool

v1.0.4 2025-02-09 08:42 UTC

Requires

• php: ^8.2
• ext-pdo: *
• laravel/framework: ^10.0|^11.0
• sabbottlabs/laravel-adminerneo-builder: ^1.0.0

Apache-2.0, GPL-2.0-only

• Stephen Abbott

• database
• mysql
• sqlite
• pgsql
• management
• mssql
• laravel11
• adminerneo

README

Laravel integration for AdminerNeo v5, a modern database management tool.

Installation

1. Install via Composer:

composer require sabbottlabs/laravel-adminerneo

1. Publish assets:

php artisan vendor:publish --tag=adminerneo

1. Register Middleware in bootstrap/app.php:

->withMiddleware(function (Middleware $middleware) {
    $middleware->alias([
        'adminerneo' => \SabbottLabs\AdminerNeo\Http\Middleware\AdminerNeoMiddleware::class,
    ]);
})

1. Add environment variables (optional):

ADMINERNEO_ENABLED=true
ADMINERNEO_ROUTE_PREFIX=adminerneo

Updating

After updating the package via Composer, you should republish the assets:

# Republish only assets
php artisan vendor:publish --tag=adminerneo-assets --force

# Republish everything (including config)
php artisan vendor:publish --tag=adminerneo --force

Note: The --force flag will overwrite existing files. Make sure to backup any customizations. Make sure to:

• Backup any customizations
• Save any custom plugins you want to keep
• Note that some plugins may be incompatible with newer versions

Plugin Management

The update process automatically removes old plugins to prevent compatibility issues. If you have custom plugins:

1. Back them up before updating
2. Test compatibility with the new version
3. Reinstall only compatible plugins after update

Content Security Policy (CSP)

AdminerNeo requires specific CSP headers to function properly. The package sets these by default, but you may need to adjust them if:

• You have existing CSP middleware
• You see browser console warnings
• You need to customize security policies

Note: Browser console may show CSP warnings due to 'strict-dynamic' and nonce usage. These warnings are expected and don't affect functionality.

Configuration

See config/adminerneo.php for all configuration options.