CakePHP DebugKit 项目启动与配置教程

1. 项目目录结构及介绍

CakePHP DebugKit 提供了一个调试工具条和增强的调试工具，用于 CakePHP 应用程序。以下是项目的目录结构及其简要介绍：

cakephp-debug_kit/
├── .github/               # GitHub 工作流程和配置文件
├── .phive/                # Phive 配置文件
├── config/                # 配置文件和目录
├── docs/                  # 文档目录
├── src/                   # 核心代码目录
├── templates/             # 视图模板文件
├── tests/                 # 测试用例目录
├── webroot/               # Web 根目录，通常包含公共文件
├── .editorconfig           # 编辑器配置文件
├── .eslintrc.json         # ESLint 配置文件
├── .gitattributes          # Git 属性文件
├── .gitignore             # Git 忽略文件
├── Dockerfile             # Docker 容器配置文件
├── LICENSE.txt            # 许可证文件
├── README.md              # 项目自述文件
├── composer.json          # Composer 配置文件
├── docs.Dockerfile        # 文档 Docker 配置文件
├── package.json           # Node.js 包配置文件
├── phpcs.xml              # PHP Coding Standards 配置文件
├── phpstan-baseline.neon  # PHPStan 基线配置文件
├── phpstan.neon           # PHPStan 配置文件
├── phpunit.xml.dist        # PHPUnit 配置文件
├── psalm-baseline.xml      # Psalm 基线配置文件
└── psalm.xml              # Psalm 配置文件

2. 项目的启动文件介绍

项目的启动主要依赖于 CakePHP 框架。在开始使用 DebugKit 前，你需要确保已经安装了 CakePHP 并且正确配置了环境。

DebugKit 的加载通常在 CakePHP 的插件管理脚本中进行，如下所示：

// bin/cake.php 或其他启动脚本中
bin/cake plugin load DebugKit --only-debug

这条命令会在开发环境中加载 DebugKit 插件。

3. 项目的配置文件介绍

DebugKit 的配置文件主要位于 config 目录下。以下是主要的配置文件及其作用：

• config/app.php：这是 CakePHP 的主配置文件，你可以在这里配置 DebugKit 以及其他插件的设置。
• config/bootstrap.php： CakePHP 的引导文件，用于加载插件和执行一些初始化操作。
• config/debug_kit.php：DebugKit 的配置文件，你可以在这里自定义工具条的行为和显示选项。

例如，你可以在 config/app.php 中设置 DebugKit 的安全顶级域名（TLD）：

// config/app.php
Configure::write('DebugKit.safeTld', ['local', 'dev', 'test']);

此外，如果你使用了授权插件并希望 DebugKit 在未经授权的情况下也能工作，你可以在配置文件中设置忽略授权检查：

// config/app.php
Configure::write('DebugKit.ignoreAuthorization', true);

确保在修改配置文件后重新启动你的应用程序，以使更改生效。