PHPackages                             hgists/lumener - 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. hgists/lumener

ActiveLibrary

hgists/lumener
==============

Adminer/Adminer Editor for Lumen/Laravel 5.\*

v1.1(7y ago)1160MITPHPPHP >=5.5.0

Since Apr 28Pushed 7y ago1 watchersCompare

[ Source](https://github.com/HeshamMeneisi/Lumener)[ Packagist](https://packagist.org/packages/hgists/lumener)[ RSS](/packages/hgists-lumener/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (3)Dependencies (6)Versions (4)Used By (0)

Lumener
=======

[](#lumener)

[![Scrutinizer Code Quality](https://camo.githubusercontent.com/b6f2c4cdb1a89283d280472225d988aa0f117bdf807aec148e9659d3339c2989/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f48657368616d4d656e656973692f4c756d656e65722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/HeshamMeneisi/Lumener/?branch=master)[![Build Status](https://camo.githubusercontent.com/e7a0c32c42e833197018bac79163824792d1de3e332225ec89eebd40c11c8edf/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f48657368616d4d656e656973692f4c756d656e65722f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/HeshamMeneisi/Lumener/build-status/master)[![Latest Packagist Version](https://camo.githubusercontent.com/e8dbed16fa9d4fca3d858f15036eb6e553a6b40907392843cdc24c48b6831f46/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f676e6a656e6d2f736572766572726571636865636b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/hgists/lumener)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

[Adminer](https://www.adminer.org) is a full-featured database management tool written in PHP. This package integrates the adminer interface into your Lumen or Laravel project by acting as a wrapper and taking care of incompatibility issues. Lumener also provides means to update, stylize or extend adminer through the artisan commands.

This was initially forked from [leung/laravel-adminer](https://github.com/lhq0826/adminer-for-laravel). The package was developed and tested using Lumen. So, Laravel support is untested (Although no changes should break it). Feel free to test on Laravel and open issues and/or submit a pull request!

Requirements
------------

[](#requirements)

### General

[](#general)

- guzzlehttp/guzzle

### Lumen

[](#lumen)

- illuminate/cookie
- illuminate/session

---

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

[](#installation)

```
# Install package
composer require hgists/lumener
# Download latest Adminer
php artisan lumener:update
# [Optional] Apply theme
php artisan lumener:stylize
```

For Lumen or Laravel 5.4 or older, see the next section.

---

Provider
--------

[](#provider)

The provider will automatically create any required roots and enable the artisan commands.

### Lumen

[](#lumen-1)

open your `bootstrap/app.php` and add this line anywhere before `return $app;`

```
$app->register(\Lumener\LumenerServiceProvider::class);
```

### Laravel ≤ 5.4

[](#laravel--54)

Open your `config/app.php` and add this line in providers section

```
Lumener\LumenerServiceProvider::class
```

### Laravel 5.5+

[](#laravel-55)

Auto package discovery should add the provider.

---

Config
------

[](#config)

You don't need to create a config file as all configuration parameters have a fallback value. You can follow the following instructions to customize the configuration.

- Create a `config/lumener.php` file or use `php artisan vendor:publish` (Laravel only)
- For **Lumen**, you must also add the following line to `bootstrap/app.php` before `return $app;`

```
$app->configure('lumener');
```

---

Artisan Commands
----------------

[](#artisan-commands)

### Updating Adminer

[](#updating-adminer)

```
php artisan lumener:update [OPTIONAL --force]
```

You can configure your composer.json to do this after each commit:

```
"scripts": {
    "post-install-cmd": [
        "php artisan lumener:update"
    ],
    "post-update-cmd": [
        "php artisan lumener:update"
    ]
}
```

You can also create a route to update lumener with the action `\Lumener\Controllers\LumenerController@update`.

### Themes

[](#themes)

```
php artisan lumener:stylize [OPTIONAL --file] [OPTIONAL --url]
```

#### Default

[](#default)

If no arguments provided, this command will install the default theme already packed in with Lumener: [Material Design for Adminer](https://github.com/arcs-/Adminer-Material-Theme)

```
php artisan lumener:stylize
```

[![alt text](https://camo.githubusercontent.com/3ff37a054b36216ccb8f9cf4259eead8ff12318d/68747470733a2f2f7374696c6c682e6172742f70726f6a6563742f61646d696e65722f707265766965772e706e67 "Logo Title Text 1")](https://camo.githubusercontent.com/3ff37a054b36216ccb8f9cf4259eead8ff12318d/68747470733a2f2f7374696c6c682e6172742f70726f6a6563742f61646d696e65722f707265766965772e706e67)

For more themes, check the [Adminer](https://www.adminer.org/#extras) website.

#### File

[](#file)

```
php artisan lumener:stylize --file=/home/Downloads/adminer.css
```

#### URL

[](#url)

```
php artisan lumener:stylize --url=https://raw.githubusercontent.com/vrana/adminer/master/designs/lucas-sandery/adminer.css
```

For themes containing images/JavaScript you will have to copy the files manually to your `public` path.

### Plugins

[](#plugins)

Install or update any [plugin](https://www.adminer.org/en/plugins/) given its path or url.

```
php artisan lumener:plugin [OPTIONAL --file] [OPTIONAL --url]
```

Plugins must be enabled in `config('lumener.adminer.plugins.enabled')`. Refer to the config section.

#### Default

[](#default-1)

If no arguments provided, this command will install the `plugin.php` file which is required for any plugins to run.

```
php artisan lumener:plugin
```

#### File

[](#file-1)

```
php artisan lumener:plugin --file=/home/Downloads/designer.php
```

#### URL

[](#url-1)

```
php artisan lumener:plugin --url=https://raw.github.com/vrana/adminer/master/plugins/database-hide.php
```

---

Extensions
----------

[](#extensions)

Adminer supports [Extensions](https://www.adminer.org/en/extension/). In fact, Lumener takes advantage of quite a few extension functions. However, more extensions can be added using another user-defined class. This can be done all while preserving the original Lumener extensions, unless a conflict arises. Please take some time to check `src/logic/adminer_object` before writing your own extensions to be aware of potential conflicts.

To add your own extensions, set `config('lumener.adminer.extension_file')`.

```
"adminer" => [
    ...
    "extension_file" => base_path("app/Logic/LumenerExtension.php")
    ...
]
```

**Example file:**

```