{"id":20103149,"url":"https://github.com/dotkernel/light","last_synced_at":"2025-09-20T23:32:31.321Z","repository":{"id":257805290,"uuid":"863984268","full_name":"dotkernel/light","owner":"dotkernel","description":"Minimal project to generate a simple website. Simple application using Mezzio microframework and Laminas components.","archived":false,"fork":false,"pushed_at":"2025-01-09T13:54:04.000Z","size":424,"stargazers_count":4,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"1.0","last_synced_at":"2025-01-09T14:56:37.996Z","etag":null,"topics":["laminas","mezzio","psr-15"],"latest_commit_sha":null,"homepage":"https://light.dotkernel.net/","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/dotkernel.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-27T09:23:36.000Z","updated_at":"2024-12-19T06:18:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"aae525cb-ce99-415d-82ca-cb7657cd9800","html_url":"https://github.com/dotkernel/light","commit_stats":null,"previous_names":["dotkernel/light"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dotkernel%2Flight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dotkernel%2Flight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dotkernel%2Flight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dotkernel%2Flight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dotkernel","download_url":"https://codeload.github.com/dotkernel/light/tar.gz/refs/heads/1.0","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233694819,"owners_count":18715507,"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","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":["laminas","mezzio","psr-15"],"created_at":"2024-11-13T17:34:27.982Z","updated_at":"2025-09-20T23:32:31.314Z","avatar_url":"https://github.com/dotkernel.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dotkernel Light\n\nDotkernel Light is a PSR-15 compliant application (skeleton) using Mezzio microframework and Laminas components.\nIt's designed as a minimal project to generate a simple website, like a presentation site.\n\n\u003e Check out our [demo](https://light.dotkernel.net/).\n\n## Documentation\n\nDocumentation is available at: https://docs.dotkernel.org/light-documentation/\n\n## Badges\n\n![OSS Lifecycle](https://img.shields.io/osslifecycle/dotkernel/light)\n![PHP from Packagist (specify version)](https://img.shields.io/packagist/php-v/dotkernel/light/1.1.1)\n\n[![GitHub issues](https://img.shields.io/github/issues/dotkernel/light)](https://github.com/dotkernel/light/issues)\n[![GitHub forks](https://img.shields.io/github/forks/dotkernel/light)](https://github.com/dotkernel/light/network)\n[![GitHub stars](https://img.shields.io/github/stars/dotkernel/light)](https://github.com/dotkernel/light/stargazers)\n[![GitHub license](https://img.shields.io/github/license/dotkernel/light)](https://github.com/dotkernel/light/blob/1.0/LICENSE)\n\n[![Continuous Integration](https://github.com/dotkernel/light/actions/workflows/continuous-integration.yml/badge.svg?branch=1.0)](https://github.com/dotkernel/light/actions/workflows/continuous-integration.yml)\n[![codecov](https://codecov.io/gh/dotkernel/light/graph/badge.svg?token=UpVJ5ELvfZ)](https://codecov.io/gh/dotkernel/light)\n[![Qodana](https://github.com/dotkernel/light/actions/workflows/qodana_code_quality.yml/badge.svg)](https://github.com/dotkernel/light/actions/workflows/qodana_code_quality.yml)\n\n[![PHPStan](https://github.com/dotkernel/light/actions/workflows/static-analysis.yml/badge.svg?branch=1.0)](https://github.com/dotkernel/light/actions/workflows/static-analysis.yml)\n![PHPstan Level](https://img.shields.io/badge/PHPStan-level%208-brightgreen)\n\n## Installing Dotkernel `light`\n\n- [Installing Dotkernel `light`](#installing-dotkernel-light)\n    - [Composer](#composer)\n    - [Choose a destination path for Dotkernel `light` installation](#choosing-an-installation-path-for-dotkernel-light)\n    - [Installing Dotkernel light](#installing-dotkernel-light)\n    - [Testing (Running)](#running-the-application)\n\n## Tools\n\nDotkernel light interface has been tested with npm v10.0.4 and Node.js v20.11.0.\n\n### Composer\n\nInstallation instructions:\n\n- [Composer Installation -  Linux/Unix/OSX](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx)\n- [Composer Installation - Windows](https://getcomposer.org/doc/00-intro.md#installation-windows)\n\n\u003e If you have never used composer before make sure you read the [`Composer Basic Usage`](https://getcomposer.org/doc/01-basic-usage.md) section in Composer's documentation\n\n## Choosing an installation path for Dotkernel `light`\n\nExample:\n\n- absolute path `/var/www/dk`\n- or relative path `dk` (equivalent with `./dk`)\n\n## Installing Dotkernel `light`\n\nAfter you choose the path for Dotkernel light (`dk` will be used for the remainder of this example), let's move onto installation.\n\n### Installing Dotkernel `light` using git clone\n\nThis method ensures that the default branch is installed, even if it is not released. Run the following command:\n\n```shell\ngit clone https://github.com/dotkernel/light.git .\n```\n\nThe dependencies have to be installed separately, by running this command:\n\n```shell\ncomposer install\n```\n\nThe setup script prompts for some configuration settings, for example the lines below:\n\n```shell\nPlease select which config file you wish to inject 'Laminas\\HttpHandlerRunner\\ConfigProvider' into:\n  [0] Do not inject\n  [1] config/config.php\n  Make your selection (default is 1):\n```\n\nSimply select `[0] Do not inject`, because Dotkernel includes its own configProvider which already contains the prompted configurations.\n\nIf you choose `[1] config/config.php` Laminas's `ConfigProvider` will be injected.\n\nThe next question is:\n\n`Remember this option for other packages of the same type? (Y/n)`\n\nYou should enter `y` and press `Enter`.\n\n## Development mode\n\nRun this command to enable dev mode by turning debug flag to `true` and turning configuration caching to `off`. It will also make sure that any existing config cache is cleared.\n\n```shell\ncomposer development-enable\n```\n\n- If not already done, remove the `.dist` extension from `config/autoload/development.local.php.dist`.\n\n## Bundling Static Modules\n\n\u003e Prerequisite software: Node.js v20 (minimum supported version)\n\nTo install dependencies into the `node_modules` directory run this command.\n\n```shell\nnpm install\n```\n\nIf `npm install` fails, this could be caused by user permissions of npm.\nWe recommend installing npm through `Node Version Manager`.\n\n\u003e You can skip the next step until you make changes in the `src/App/assets` folder\n\nThe build command compiles the components from the `src/App/assets` folder into the `public` folder.\n\n\u003e This command overwrites existing files in the `public` folder.\n\n```shell\nnpm run build\n```  \n\n## Running the application\n\nWe recommend running your applications in WSL:\n\n- make sure you have [WSL](https://github.com/dotkernel/development/blob/main/wsl/README.md) installed on your system\n- currently we provide a distro implementations for [AlmaLinux9](https://github.com/dotkernel/development/blob/main/wsl/os/almalinux9/README.md)\n- install the application in a virtualhost as recommended by the chosen distro\n- set `$baseUrl` in **config/autoload/local.php** to the address of the virtualhost\n- run the application by opening the virtualhost address in your browser\n\nYou should see the `Dotkernel light` welcome page.\n\n**NOTE:**\n\n- If you are getting exceptions or errors regarding some missing services, try running the following command:\n\n```shell\nsudo php bin/clear-config-cache.php\n```\n\n\u003e If `config-cache.php` is present that config will be loaded regardless of the `ConfigAggregator::ENABLE_CACHE` in `config/autoload/mezzio.global.php`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdotkernel%2Flight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdotkernel%2Flight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdotkernel%2Flight/lists"}