有赞云有容器应用PHP框架安装与使用指南

一、项目的目录结构及介绍

一个基于yz-cloud-boot的标准应用程序的目录结构通常如下所示：

|-- composer.json       # 用户工程的 composer.json 文件
|-- config/
|   |-- env.php         # 环境变量定义，主要定义 `YZCLOUD_BOOT_APP_DIR` 来指定应用根目录
|   |-- routes.php      # 路由配置文件
|   |-- beps.php        # 业务扩展点配置文件
|   |-- meps.php        # 消息扩展点配置文件
|-- src/                # 用户工程的主要源代码目录
|   |-- Bep             # 业务扩展点实现（可按需自定义）
|   |-- Mep             # 消息扩展点实现（可按需自定义）
|   |-- Controller      # 控制器（可自定义）
|   |-- ...             # 其他用户自定义的工程目录
|-- templates/          # 视图模板文件目录
|-- vendor/            # Composer 下载的第三方组件目录

其中：

• config 目录包含了所有重要的配置文件。
• src 是程序核心逻辑的存放地。
• templates 存放了视图模板。
• vendor 通过Composer管理的所有第三方库。

二、项目的启动文件介绍

虽然yz-cloud-boot没有明确指出具体的启动文件名，但通常在src或项目根目录中有一个入口文件，如index.php或bootstrap.php，用于加载框架并初始化应用环境。这个文件负责引入composer autoloader，初始化YZCloudBoot，以及设置基本的运行环境参数。

示例启动文件代码可能如下：

// 引入 Composer 自动加载
require __DIR__ . '/../vendor/autoload.php';

// 初始化框架
\YouzanCloudBoot\Bootstrap::init();

// 添加路由或其他初始化操作
// ...

// 启动应用
\YouzanCloudBoot\Kernel::run();

实际名称和路径可能会有所不同，具体取决于开发者的设计偏好。

三、项目的配置文件介绍

config目录下的配置文件解释如下：

• env.php: 定义环境变量，例如指定应用根目录，这是一个全局性的配置，用于基础环境变量的设定。
• routes.php: 路由配置，定义请求URL如何映射到控制器的具体方法。这是应用的核心配置之一。
• beps.php 和 meps.php: 分别为业务扩展点和消息扩展点的配置，这些点允许开发者在不修改核心代码的情况下添加或调整功能行为，增强应用灵活性和可维护性。

以上配置文件通过键值对的方式组织数据，通常是数组形式，在框架初始化时被读取并应用至整个应用环境中。使用env.php等文件进行配置可以避免硬编码，使应用程序更易于管理和部署。

---

本文档是基于https://github.com/youzan/yz-cloud-boot项目的内容编写的通用指南，旨在帮助新加入者快速理解并投入使用yz-cloud-boot框架。