PHPackages                             filaforge/filament-database-viewer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database &amp; ORM](/categories/database)
4. /
5. filaforge/filament-database-viewer

ActiveLibrary[Database &amp; ORM](/categories/database)

filaforge/filament-database-viewer
==================================

Database viewer plugin: Database viewer with table browser and data explorer

v1.0.0(10mo ago)01771MITPHPPHP &gt;=8.1

Since Aug 19Pushed 10mo agoCompare

[ Source](https://github.com/filaforge/filament-database-viewer)[ Packagist](https://packagist.org/packages/filaforge/filament-database-viewer)[ Docs](https://github.com/filaforge/database-viewer)[ RSS](/packages/filaforge-filament-database-viewer/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (3)Versions (5)Used By (0)

Filaforge Database Viewer
=========================

[](#filaforge-database-viewer)

A powerful Filament plugin that provides a comprehensive database viewing and exploration interface directly in your admin panel.

Features
--------

[](#features)

- **Table Browser**: Navigate through all database tables and views
- **Data Viewer**: View table contents with pagination and sorting
- **Schema Explorer**: Examine table structure, columns, and relationships
- **Search &amp; Filter**: Find specific data with advanced filtering options
- **Export Capabilities**: Download table data in multiple formats
- **Relationship Mapping**: Visualize table relationships and foreign keys
- **Query Builder**: Simple query interface for data exploration
- **Performance Monitoring**: Track query execution times
- **Multi-Database Support**: Work with multiple database connections

Installation
------------

[](#installation)

### 1. Install via Composer

[](#1-install-via-composer)

```
composer require filaforge/database-viewer
```

### 2. Publish &amp; Migrate

[](#2-publish--migrate)

```
# Publish provider groups (config, views, migrations)
php artisan vendor:publish --provider="Filaforge\\DatabaseViewer\\Providers\\DatabaseViewerServiceProvider"

# Run migrations
php artisan migrate
```

### 3. Register Plugin

[](#3-register-plugin)

Add the plugin to your Filament panel provider:

```
use Filament\Panel;

public function panel(Panel $panel): Panel
{
    return $panel
        // ... other configuration
        ->plugin(\Filaforge\DatabaseViewer\DatabaseViewerPlugin::make());
}
```

Setup
-----

[](#setup)

### Configuration

[](#configuration)

The plugin will automatically:

- Publish configuration files to `config/database-viewer.php`
- Publish view files to `resources/views/vendor/database-viewer/`
- Publish migration files to `database/migrations/`
- Register necessary routes and middleware

### Database Configuration

[](#database-configuration)

Configure the viewer in the published config file:

```
// config/database-viewer.php
return [
    'connections' => ['mysql', 'pgsql', 'sqlite'],
    'max_rows_per_page' => 100,
    'enable_search' => true,
    'enable_export' => true,
    'allowed_operations' => ['SELECT', 'SHOW', 'DESCRIBE'],
    'cache_results' => true,
    'cache_ttl' => 300, // 5 minutes
];
```

### Environment Variables

[](#environment-variables)

Add these to your `.env` file if needed:

```
DB_VIEWER_ENABLED=true
DB_VIEWER_MAX_ROWS=100
DB_VIEWER_CACHE_TTL=300
```

Usage
-----

[](#usage)

### Accessing the Database Viewer

[](#accessing-the-database-viewer)

1. Navigate to your Filament admin panel
2. Look for the "Database Viewer" menu item
3. Start exploring your database structure

### Browsing Tables

[](#browsing-tables)

1. **Select Connection**: Choose the database connection to explore
2. **Browse Tables**: View all available tables and views
3. **View Structure**: Examine table columns, types, and constraints
4. **Explore Data**: Browse table contents with pagination
5. **Search Data**: Use search and filter options to find specific records

### Data Exploration

[](#data-exploration)

1. **Table Navigation**: Switch between different tables
2. **Column Information**: View column details, types, and constraints
3. **Data Sorting**: Sort data by any column
4. **Pagination**: Navigate through large datasets
5. **Export Data**: Download table data in CSV, JSON, or Excel format

### Advanced Features

[](#advanced-features)

- **Relationship View**: See foreign key relationships between tables
- **Query Builder**: Build simple queries to explore data
- **Schema Export**: Export table schemas for documentation
- **Performance Stats**: Monitor query performance and execution times

Troubleshooting
---------------

[](#troubleshooting)

### Common Issues

[](#common-issues)

- **Permission denied**: Ensure the user has database read access
- **Slow performance**: Check pagination settings and enable caching
- **Missing tables**: Verify database connection and user permissions
- **Memory issues**: Reduce max\_rows\_per\_page setting

### Debug Steps

[](#debug-steps)

1. Check the plugin configuration:

```
php artisan config:show database-viewer
```

2. Verify routes are registered:

```
php artisan route:list | grep database-viewer
```

3. Test database connectivity:

```
php artisan tinker
# Test database connection manually
```

4. Check database permissions:

```
# Verify the database user has SELECT privileges
```

5. Clear caches:

```
php artisan optimize:clear
```

6. Check logs for errors:

```
tail -f storage/logs/laravel.log
```

### Performance Optimization

[](#performance-optimization)

- Enable result caching in configuration
- Use appropriate pagination limits
- Optimize database indexes for frequently viewed columns
- Consider read-only database connections for viewing

Security Considerations
-----------------------

[](#security-considerations)

### Access Control

[](#access-control)

- **Role-based permissions**: Restrict access to authorized users only
- **Read-only access**: Use database users with SELECT privileges only
- **Connection isolation**: Separate viewing connections from application connections
- **Audit logging**: Track all database viewing activities

### Best Practices

[](#best-practices)

- Never expose database viewer to public users
- Use dedicated database users with minimal permissions
- Regularly review and update access controls
- Monitor and log all database access
- Implement query timeouts to prevent long-running queries

Uninstall
---------

[](#uninstall)

### 1. Remove Plugin Registration

[](#1-remove-plugin-registration)

Remove the plugin from your panel provider:

```
// remove ->plugin(\Filaforge\DatabaseViewer\DatabaseViewerPlugin::make())
```

### 2. Roll Back Migrations (Optional)

[](#2-roll-back-migrations-optional)

```
php artisan migrate:rollback
# or roll back specific published files if needed
```

### 3. Remove Published Assets (Optional)

[](#3-remove-published-assets-optional)

```
rm -f config/database-viewer.php
rm -rf resources/views/vendor/database-viewer
```

### 4. Remove Package and Clear Caches

[](#4-remove-package-and-clear-caches)

```
composer remove filaforge/database-viewer
php artisan optimize:clear
```

Support
-------

[](#support)

- **Documentation**: [GitHub Repository](https://github.com/filaforge/database-viewer)
- **Issues**: [GitHub Issues](https://github.com/filaforge/database-viewer/issues)
- **Discussions**: [GitHub Discussions](https://github.com/filaforge/database-viewer/discussions)

Contributing
------------

[](#contributing)

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

License
-------

[](#license)

This plugin is open-sourced software licensed under the [MIT license](LICENSE).

---

**Made with ❤️ by the Filaforge Team**

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance54

Moderate activity, may be stable

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

307d ago

Major Versions

0.1.2 → v1.0.02025-08-19

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/226258563?v=4)[FilaForge](/maintainers/filaforge)[@filaforge](https://github.com/filaforge)

---

Top Contributors

[![blhk0532](https://avatars.githubusercontent.com/u/221689993?v=4)](https://github.com/blhk0532 "blhk0532 (5 commits)")

---

Tags

laravelplatformfilament

### Embed Badge

![Health badge](/badges/filaforge-filament-database-viewer/health.svg)

```
[![Health](https://phpackages.com/badges/filaforge-filament-database-viewer/health.svg)](https://phpackages.com/packages/filaforge-filament-database-viewer)
```

###  Alternatives

[spatie/laravel-medialibrary

Associate files with Eloquent models

6.1k41.3M596](/packages/spatie-laravel-medialibrary)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3913.7k](/packages/rawilk-profile-filament-plugin)[clickbar/laravel-magellan

This package provides functionality for working with the postgis extension in Laravel.

438834.4k1](/packages/clickbar-laravel-magellan)[relaticle/custom-fields

User Defined Custom Fields for Laravel Filament

16445.8k](/packages/relaticle-custom-fields)[stephenjude/filament-jetstream

A Laravel starter kit built with Filament inspired by Jetstream.

17758.9k2](/packages/stephenjude-filament-jetstream)[stephenjude/filament-two-factor-authentication

Filament Two Factor Authentication: Google 2FA + Passkey Authentication

84192.9k7](/packages/stephenjude-filament-two-factor-authentication)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
