ZanHTTP Boilerplate 搭建与使用教程

本教程将指导您了解并设置基于 zanhttp-boilerplate 的项目。这是一个由有赞开发的基础框架，用于快速构建 HTTP 服务。让我们一起探索其关键组件。

1. 项目目录结构及介绍

在克隆或下载项目后，您会看到以下基本目录结构：

zanhttp-boilerplate/
├── config/         # 配置文件夹
│   └── default.php # 默认配置文件
├── src/             # 业务代码目录
├── public/          # 公共资源文件夹
└── bootstrap.php    # 启动文件

• config/: 包含项目的所有配置文件，default.php 是默认的全局配置。
• src/: 存放应用程序的核心代码，通常包括控制器、模型和服务等。
• public/: 用于存放静态资源，如CSS、JavaScript文件以及Web应用的入口点。
• bootstrap.php: 应用程序的入口文件，包含了初始化设置和加载必要组件。

2. 项目启动文件介绍

bootstrap.php 文件是整个项目的起点，它负责加载必要的组件，初始化环境并执行应用程序。下面是一般步骤：

<?php
// 加载 composer 自动加载文件
require __DIR__ . '/../vendor/autoload.php';

// 初始化配置
$config = require __DIR__ . '/../config/default.php';
// 创建并启动 Swoole 服务器实例
$serv = new \Swoole\Http\Server("0.0.0.0", 9501);
// 注册服务器事件处理函数
...

$serv->start();

在这个文件中，您可以配置服务器监听的 IP 和端口，注册事件处理器，以及进行其他初始化操作。

3. 项目的配置文件介绍

config/default.php 是项目的主要配置文件，其中定义了应用的行为。例如，数据库连接、缓存设置等。这是一个示例配置：

return [
    // 数据库配置
    'db' => [
        'host'     => 'localhost',
        'port'     => 3306,
        'username' => 'root',
        'password' => 'your_password',
        'database' => 'your_database',
    ],
    // 缓存配置
    'cache' => [
        'type'  => 'redis', // 使用 Redis 作为缓存
        'host'  => '127.0.0.1',
        'port'  => 6379,
        ...
    ],
    // ...其他配置项...
];

根据您的需求，您可以在此文件中添加、删除或修改配置项。也可以通过不同的环境变量来区分不同环境下的配置。

至此，您已大致了解 zanhttp-boilerplate 项目的基本构成和运行方式。现在，您可以根据这个基础开始构建自己的服务。祝你好运！