{"id":31785450,"url":"https://github.com/filaforge/filament-database-viewer","last_synced_at":"2026-01-20T16:36:13.936Z","repository":{"id":310710865,"uuid":"1040959734","full_name":"filaforge/filament-database-viewer","owner":"filaforge","description":"Filament plugin for database viewing and exploration","archived":false,"fork":false,"pushed_at":"2025-08-19T23:31:53.000Z","size":241,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-23T15:54:56.676Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/filaforge.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-19T19:07:18.000Z","updated_at":"2025-08-19T21:37:31.000Z","dependencies_parsed_at":"2025-08-19T20:35:05.642Z","dependency_job_id":"ef8422ba-0d23-4bf7-97e6-cab53f947c8d","html_url":"https://github.com/filaforge/filament-database-viewer","commit_stats":null,"previous_names":["filaforge/filament-database-viewer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/filaforge/filament-database-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-database-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-database-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-database-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-database-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/filaforge","download_url":"https://codeload.github.com/filaforge/filament-database-viewer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-database-viewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279003716,"owners_count":26083610,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-10T11:55:12.320Z","updated_at":"2025-10-10T11:55:14.990Z","avatar_url":"https://github.com/filaforge.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Filaforge Database Viewer\n\nA powerful Filament plugin that provides a comprehensive database viewing and exploration interface directly in your admin panel.\n\n## Features\n\n- **Table Browser**: Navigate through all database tables and views\n- **Data Viewer**: View table contents with pagination and sorting\n- **Schema Explorer**: Examine table structure, columns, and relationships\n- **Search \u0026 Filter**: Find specific data with advanced filtering options\n- **Export Capabilities**: Download table data in multiple formats\n- **Relationship Mapping**: Visualize table relationships and foreign keys\n- **Query Builder**: Simple query interface for data exploration\n- **Performance Monitoring**: Track query execution times\n- **Multi-Database Support**: Work with multiple database connections\n\n## Installation\n\n### 1. Install via Composer\n\n```bash\ncomposer require filaforge/database-viewer\n```\n\n### 2. Publish \u0026 Migrate\n\n```bash\n# Publish provider groups (config, views, migrations)\nphp artisan vendor:publish --provider=\"Filaforge\\\\DatabaseViewer\\\\Providers\\\\DatabaseViewerServiceProvider\"\n\n# Run migrations\nphp artisan migrate\n```\n\n### 3. Register Plugin\n\nAdd the plugin to your Filament panel provider:\n\n```php\nuse Filament\\Panel;\n\npublic function panel(Panel $panel): Panel\n{\n    return $panel\n        // ... other configuration\n        -\u003eplugin(\\Filaforge\\DatabaseViewer\\DatabaseViewerPlugin::make());\n}\n```\n\n## Setup\n\n### Configuration\n\nThe plugin will automatically:\n- Publish configuration files to `config/database-viewer.php`\n- Publish view files to `resources/views/vendor/database-viewer/`\n- Publish migration files to `database/migrations/`\n- Register necessary routes and middleware\n\n### Database Configuration\n\nConfigure the viewer in the published config file:\n\n```php\n// config/database-viewer.php\nreturn [\n    'connections' =\u003e ['mysql', 'pgsql', 'sqlite'],\n    'max_rows_per_page' =\u003e 100,\n    'enable_search' =\u003e true,\n    'enable_export' =\u003e true,\n    'allowed_operations' =\u003e ['SELECT', 'SHOW', 'DESCRIBE'],\n    'cache_results' =\u003e true,\n    'cache_ttl' =\u003e 300, // 5 minutes\n];\n```\n\n### Environment Variables\n\nAdd these to your `.env` file if needed:\n\n```env\nDB_VIEWER_ENABLED=true\nDB_VIEWER_MAX_ROWS=100\nDB_VIEWER_CACHE_TTL=300\n```\n\n## Usage\n\n### Accessing the Database Viewer\n\n1. Navigate to your Filament admin panel\n2. Look for the \"Database Viewer\" menu item\n3. Start exploring your database structure\n\n### Browsing Tables\n\n1. **Select Connection**: Choose the database connection to explore\n2. **Browse Tables**: View all available tables and views\n3. **View Structure**: Examine table columns, types, and constraints\n4. **Explore Data**: Browse table contents with pagination\n5. **Search Data**: Use search and filter options to find specific records\n\n### Data Exploration\n\n1. **Table Navigation**: Switch between different tables\n2. **Column Information**: View column details, types, and constraints\n3. **Data Sorting**: Sort data by any column\n4. **Pagination**: Navigate through large datasets\n5. **Export Data**: Download table data in CSV, JSON, or Excel format\n\n### Advanced Features\n\n- **Relationship View**: See foreign key relationships between tables\n- **Query Builder**: Build simple queries to explore data\n- **Schema Export**: Export table schemas for documentation\n- **Performance Stats**: Monitor query performance and execution times\n\n## Troubleshooting\n\n### Common Issues\n\n- **Permission denied**: Ensure the user has database read access\n- **Slow performance**: Check pagination settings and enable caching\n- **Missing tables**: Verify database connection and user permissions\n- **Memory issues**: Reduce max_rows_per_page setting\n\n### Debug Steps\n\n1. Check the plugin configuration:\n```bash\nphp artisan config:show database-viewer\n```\n\n2. Verify routes are registered:\n```bash\nphp artisan route:list | grep database-viewer\n```\n\n3. Test database connectivity:\n```bash\nphp artisan tinker\n# Test database connection manually\n```\n\n4. Check database permissions:\n```bash\n# Verify the database user has SELECT privileges\n```\n\n5. Clear caches:\n```bash\nphp artisan optimize:clear\n```\n\n6. Check logs for errors:\n```bash\ntail -f storage/logs/laravel.log\n```\n\n### Performance Optimization\n\n- Enable result caching in configuration\n- Use appropriate pagination limits\n- Optimize database indexes for frequently viewed columns\n- Consider read-only database connections for viewing\n\n## Security Considerations\n\n### Access Control\n\n- **Role-based permissions**: Restrict access to authorized users only\n- **Read-only access**: Use database users with SELECT privileges only\n- **Connection isolation**: Separate viewing connections from application connections\n- **Audit logging**: Track all database viewing activities\n\n### Best Practices\n\n- Never expose database viewer to public users\n- Use dedicated database users with minimal permissions\n- Regularly review and update access controls\n- Monitor and log all database access\n- Implement query timeouts to prevent long-running queries\n\n## Uninstall\n\n### 1. Remove Plugin Registration\n\nRemove the plugin from your panel provider:\n```php\n// remove -\u003eplugin(\\Filaforge\\DatabaseViewer\\DatabaseViewerPlugin::make())\n```\n\n### 2. Roll Back Migrations (Optional)\n\n```bash\nphp artisan migrate:rollback\n# or roll back specific published files if needed\n```\n\n### 3. Remove Published Assets (Optional)\n\n```bash\nrm -f config/database-viewer.php\nrm -rf resources/views/vendor/database-viewer\n```\n\n### 4. Remove Package and Clear Caches\n\n```bash\ncomposer remove filaforge/database-viewer\nphp artisan optimize:clear\n```\n\n## Support\n\n- **Documentation**: [GitHub Repository](https://github.com/filaforge/database-viewer)\n- **Issues**: [GitHub Issues](https://github.com/filaforge/database-viewer/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/filaforge/database-viewer/discussions)\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## License\n\nThis plugin is open-sourced software licensed under the [MIT license](LICENSE).\n\n---\n\n**Made with ❤️ by the Filaforge Team**\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilaforge%2Ffilament-database-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffilaforge%2Ffilament-database-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilaforge%2Ffilament-database-viewer/lists"}