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. filaforge/filament-database-viewer

ActiveLibrary

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

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

v1.0.0(8mo ago)092MITPHPPHP >=8.1

Since Aug 19Pushed 8mo 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 1mo 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 & 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 & 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

34

—

LowBetter than 77% of packages

Maintenance62

Regular maintenance activity

Popularity13

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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

262d ago

Major Versions

0.1.2 → v1.0.02025-08-19

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7ccd0e302c517e0c6bc2b4ef05008e5beb1621bf5a64b17b82cdceb19566389?d=identicon)[filaforge](/maintainers/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

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[guava/filament-modal-relation-managers

Allows you to embed relation managers inside filament modals.

7565.0k4](/packages/guava-filament-modal-relation-managers)[a2insights/filament-saas

Filament Saas for A2Insights

161.1k](/packages/a2insights-filament-saas)[tapp/filament-webhook-client

Add a Filament resource and a policy for Spatie Webhook client

1120.2k](/packages/tapp-filament-webhook-client)[jeffersongoncalves/filament-topbar

A simple yet effective Filament plugin that automatically adds a customized topbar to your Filament admin panel. This plugin enhances your Filament panel's user experience by replacing the default topbar component with an improved version that displays navigation and user interface elements in strategic locations.

171.2k](/packages/jeffersongoncalves-filament-topbar)

PHPackages © 2026

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