README

生成简单网站的最小项目。

安装 Dotkernel light

• 安装 Dotkernel light
  • Composer
  • 选择 Dotkernel light 安装的目标路径
  • 安装 Dotkernel light
  • 配置 - 首次运行
  • 测试（运行中）

工具

Dotkernel light 接口已在 npm v10.0.4 和 Node.js v20.11.0 下进行了测试。

Composer

安装说明

• Composer 安装 - Linux/Unix/OSX
• Composer 安装 - Windows

如果您之前从未使用过 Composer，请确保您已阅读 Composer 文档中的 Composer 基本用法 部分

选择 Dotkernel light 的安装路径

示例

• 绝对路径 /var/www/dk
• 或相对路径 dk（相当于 ./dk）

安装 Dotkernel light

选择好 Dotkernel light 的路径（在以下示例中，将使用 dk），让我们继续安装。

使用 git clone 安装 Dotkernel light

此方法确保即使尚未发布，也会安装默认分支。运行以下命令

git clone https://github.com/dotkernel/light.git .

必须单独安装依赖项，通过运行此命令

composer install

设置脚本会提示一些配置设置，例如以下内容

Please select which config file you wish to inject 'Laminas\HttpHandlerRunner\ConfigProvider' into:
  [0] Do not inject
  [1] config/config.php
  Make your selection (default is 1):

简单地选择 [0] 不注入，因为 Dotkernel 包含自己的 configProvider，它已经包含了提示的配置。

如果您选择 [1] config/config.php，则将注入 Laminas 的 ConfigProvider。

下一个问题是

是否记住此选项以用于同一类型的其他包？（Y/n）

您应输入 y 并按 Enter 键。

配置 - 首次运行

• 将 config/autoload/local.php.dist 复制为 config/autoload/local.php

开发模式

运行此命令以通过将调试标志设置为 true 和将配置缓存设置为 off 启用 dev 模式。它还会确保清除任何现有的配置缓存。

composer development-enable

• 如果尚未完成，请从 config/autoload/development.local.php.dist 中删除 .dist 扩展名。

NPM 命令

要安装依赖项到 node_modules 目录，请运行此命令。

npm install

• 如果 npm install 失败，这可能是由于 npm 的用户权限导致的。建议您通过 Node Version Manager 安装 npm。

watch 命令编译组件，然后监视文件。当其中一个文件更改时，它会重新编译。

npm run watch

所有更新完成后，此命令将本地编译资源，压缩它们，并为生产做好准备。

npm run prod

运行应用程序

我们建议在 WSL 中运行您的应用程序

• 请确保您已将 WSL 安装在您的系统上
• 目前我们为 AlmaLinux9 提供了发行版实现
• 按照所选发行版推荐的方式安装应用程序到虚拟主机
• 将 config/autoload/local.php 中的 $baseUrl 设置为虚拟主机的地址
• 通过在浏览器中打开虚拟主机地址来运行应用程序

您应该看到 Dotkernel light 欢迎页面。

注意

• 如果您遇到一些缺失服务的异常或错误，请尝试运行以下命令：

sudo php bin/clear-config-cache.php

如果存在 config-cache.php 文件，那么配置将会被加载，不管 config/autoload/mezzio.global.php 中的 ConfigAggregator::ENABLE_CACHE 是否启用。