dotkernel / admin
Dotkernel Admin Application
Installs: 124
Dependents: 0
Suggesters: 0
Security: 0
Stars: 30
Watchers: 8
Forks: 5
Open Issues: 9
Language:CSS
Type:project
Requires
- php: ~8.2.0 || ~8.3.0
- ext-gettext: *
- dotkernel/dot-cache: ^4.0
- dotkernel/dot-cli: ^3.5.0
- dotkernel/dot-controller: ^3.4.3
- dotkernel/dot-data-fixtures: ^1.1.3
- dotkernel/dot-dependency-injection: ^1.0
- dotkernel/dot-errorhandler: ^4.0.0
- dotkernel/dot-flashmessenger: ^3.4.2
- dotkernel/dot-geoip: ^3.6.0
- dotkernel/dot-helpers: ^3.4.2
- dotkernel/dot-mail: ^4.1.1
- dotkernel/dot-navigation: ^3.4.2
- dotkernel/dot-rbac-guard: ^3.4.2
- dotkernel/dot-session: ^5.6.0
- dotkernel/dot-twigrenderer: 3.4.3
- friendsofphp/proxy-manager-lts: ^1.0.16
- laminas/laminas-component-installer: ^3.4.0
- laminas/laminas-config-aggregator: ^1.14.0
- laminas/laminas-i18n: ^2.26.0
- laminas/laminas-math: ^3.7.0
- mezzio/mezzio: ^3.18.0
- mezzio/mezzio-authorization-rbac: ^1.7.0
- mezzio/mezzio-cors: ^1.11.1
- mezzio/mezzio-fastroute: ^3.11.0
- ramsey/uuid-doctrine: ^2.1.0
- roave/psr-container-doctrine: ^5.2.2
Requires (Dev)
- filp/whoops: ^2.15.4
- laminas/laminas-coding-standard: ^2.5.0
- laminas/laminas-development-mode: ^3.12.0
- laminas/laminas-http: ^2.19.0
- mezzio/mezzio-tooling: ^2.9.0
- phpunit/phpunit: ^10.5.9
- roave/security-advisories: dev-latest
- vimeo/psalm: ^5.20.0
- vincentlanglet/twig-cs-fixer: ^3.0
- 5.0.x-dev
- 5.0.3
- 5.0.2
- 5.0.1
- 5.0.0
- 4.3.1
- 4.3.0
- 4.2.0
- 4.1.0
- 4.0.x-dev
- 4.0.1
- 4.0.0
- 3.2.1
- 3.2.0
- 3.1.2
- 3.1.1
- 3.1.0
- 3.0.x-dev
- 3.0.0
- 2.0.x-dev
- v2.0.0
- 1.0.x-dev
- v1.0.2
- v1.0.1
- v1.0.0
- 0.4.2
- 0.4.1
- 0.4.0
- 0.3.1
- 0.3.0
- 0.2.2
- 0.2.1
- 0.2.0
- 0.1.1
- 0.1.0
- dev-issue-317
- dev-issue-322
- dev-issue-316
- dev-issue-320
- dev-issue-304
- dev-issue-311
- dev-issue-303
- dev-issue-212
- dev-laminas-ci
- dev-issue-251
- dev-issue212
- dev-issue-210
This package is auto-updated.
Last update: 2024-12-12 10:18:43 UTC
README
DotKernel web starter package suitable for admin applications.
Installing DotKernel admin
Tools
DotKernel can be installed through a single command that utilizes Composer. Because of that,
Composer is required to install DotKernel admin
.
Composer
Installation instructions:
If you have never used composer before make sure you read the
Composer Basic Usage
section in Composer's documentation
Choosing an installation path for DotKernel admin
Example:
- absolute path
/var/www/dk-admin
- or relative path
dk-admin
(equivalent with./dk-admin
)
Installing DotKernel admin
After choosing the path for DotKernel (dk-admin
will be used for the remainder of this example) it must be installed.
There are two installation methods.
I. Installing DotKernel admin
using composer
please use the below CLI commands in terminal, do NOT use the PhpStorm buttons
The advantage of using this command is that it runs through the whole installation process. Run the following command:
composer create-project dotkernel/admin -s dev dk
The above command downloads the admin
package, then downloads and installs the dependencies
.
The setup script prompts for some configuration settings, for example the lines below:
Please select which config file you wish to inject 'Laminas\Diactoros\ConfigProvider' into:
[0] Do not inject
[1] config/config.php
Make your selection (default is 1):
Simply select [0] Do not inject
, because DotKernel includes its own configProvider which already contains the prompted
configurations.
If you choose [1] config/config.php
Laminas's ConfigProvider
from session
will be injected.
The next question is:
Remember this option for other packages of the same type? (y/N)
Type y
here, and hit enter
II. Installing DotKernel admin
using git clone
This method requires more manual input, but it ensures that the default branch is installed, even if it is not released. Run the following command:
git clone https://github.com/dotkernel/admin.git .
The dependencies have to be installed separately, by running this command
composer install
Just like for II Installing DotKernel admin using composer
(see above), the setup asks for configuration settings
regarding injections (type 0
and hit enter
) and a confirmation to use this setting for other packages (type y
and
hit enter
)
Configuration - First Run
- Remove the
.dist
extension from the filesconfig/autoload/local.php.dist
- Edit
config/autoload/local.php
according to your dev machine and fill in thedatabase
configuration
Run the migrations and seeds with these commands:
php bin/doctrine-migrations migrate
php bin/doctrine fixtures:execute
-
If you use
composer create-project
, the project will go into development mode automatically after installing. The development mode status can be checked and toggled by using these composer commands:composer development-status composer development-enable composer development-disable
-
If not already done on installation, remove the
.dist
extension fromconfig/autoload/development.global.php.dist
. This will enable dev mode by turning debug flag totrue
and turning configuration caching tooff
. It will also make sure that any existing config cache is cleared.
Charset recommendation: utf8mb4_general_ci
Manage GeoLite2 database
You can download/update a specific GeoLite2 database, by running the following command:
php bin/cli.php geoip:synchronize -d {DATABASE}
Where {DATABASE} takes one of the following values: asn
, city
, country
.
You can download/update all GeoLite2 databases at once, by running the following command:
php bin/cli.php geoip:synchronize
The output should be similar to the below, displaying per
row: database identifier
: previous build datetime
-> current build datetime
.
asn: n/a -> 2021-07-01 02:09:34
city: n/a -> 2021-07-01 02:09:20
country: n/a -> 2021-07-01 02:05:12
Get help for this command by running:
php bin/cli.php help geoip:synchronize
Tip: If you setup the synchronizer command as a cronjob, you can add the -q|--quiet
option, and it will output
data only if an error has occurred.
NPM Commands
To install dependencies into the node_modules
directory run this command.
npm install
If npm install
fails, this could be caused by user permissions of npm. Recommendation is to install npm
through Node Version Manager
.
The watch command compiles the components then watches the files and recompiles when one of them changes.
npm run watch
After all updates are done, this command compiles the assets locally, minifies them and makes them ready for production.
npm run prod
Authorization Guards
The packages responsible for restricting access to certain parts of the application are dot-rbac-guard and dot-rbac. These packages work together to create an infrastructure that is customizable and diversified to manage user access to the platform by specifying the type of role the user has.
The authorization.global.php
file provides multiple configurations specifying multiple roles as well as the types of
permissions to which these roles have access.
'roles' => [
'superuser' => [
'permissions' => [
'authenticated',
'edit',
'delete',
//etc..
]
],
'admin' => [
'permissions' => [
'authenticated',
//etc..
]
]
]
The authorization-guards.global.php
file provides configuration to restrict access to certain actions based on the
permissions defined in authorization.global.php
so basically we have to add the permissions in the dot-rbac
configuration file first to specify the action restriction permissions.
'rules' => [
[
'route' => 'account',
'actions' => [//list of actions to apply , or empty array for all actions
'unregister',
'avatar',
'details',
'changePassword'
],
'permissions' => ['authenticated']
],
[
'route' => 'admin',
'actions' => [
'deleteAccount'
],
'permissions' => [
'delete'
//list of roles to allow
]
]
]
Testing (Running)
Note: Do not enable dev mode in production
-
Run the following command in your project's directory to start PHPs built-in server:
php -S 0.0.0.0:8080 -t public
Running command
composer serve
will do the exact same, but the above is faster.
0.0.0.0
means that the server is open to all incoming connections
127.0.0.1
means that the server can only be accessed locally (localhost only)
8080
the port on which the server is started (the listening port for the server)
NOTE: If you are still getting exceptions or errors regarding some missing services, try running the following command
php bin/clear-config-cache.php
If
config-cache.php
is present that config will be loaded regardless of theConfigAggregator::ENABLE_CACHE
inconfig/autoload/mezzio.global.php
- Open a web browser and visit
http://localhost:8080/
You should see the DotKernel admin
login page.
If you ran the migrations you will have an admin user in the database with the following credentials:
- User:
admin
- Password:
dotadmin
NOTE:
-
Production only: Make sure you modify the default admin credentials.
-
Development only:
session.cookie_secure
does not work locally so make sure you modify yourlocal.php
, as per the following:return [ 'session_config' => [ 'cookie_secure' => false, ] ];
Do not change this in local.php.dist
as well because this value should remain true
on production.