YF-Exam-Lite 项目启动与配置教程

1. 项目目录结构及介绍

yf-exam-lite 的目录结构如下：

yf-exam-lite/
├── app/                 # 应用程序目录
│   ├── common/          # 公共模块
│   ├── controllers/     # 控制器目录
│   ├── models/          # 模型目录
│   ├── services/        # 服务层目录
│   └── views/           # 视图目录
├── config/              # 配置文件目录
├── database/            # 数据库迁移文件和SQL文件
├── public/              # 公共静态资源目录
│   ├── css/             # CSS样式文件
│   ├── images/          # 图片文件
│   └── js/              # JavaScript文件
├── routes/              # 路由文件目录
├── storage/             # 存储目录，包含日志、缓存等
│   ├── logs/            # 日志文件
│   └── framework/       # 框架存储文件
├── tests/               # 测试文件目录
├── .gitignore           # Git忽略文件
├── composer.json        # Composer配置文件
├── .env.example         # 环境变量示例文件
└── index.php            # 项目入口文件

• app/：存放应用程序的核心代码，包括控制器、模型、服务以及视图。
• config/：包含项目的配置文件，如数据库连接、应用程序设置等。
• database/：包含数据库迁移脚本和SQL文件，用于管理数据库结构。
• public/：存放静态资源，如CSS、JavaScript和图像文件。
• routes/：定义应用程序的路由和控制器。
• storage/：用于存储日志、缓存和其他框架生成的文件。
• tests/：包含项目的测试文件。
• .gitignore：指定Git应该忽略的文件和目录。
• composer.json：管理项目的依赖。
• .env.example：提供环境变量设置的示例。
• index.php：项目入口文件，用于启动应用程序。

2. 项目的启动文件介绍

项目的启动文件是 index.php，它负责初始化应用程序并加载必要的组件。以下是 index.php 的基本内容：

<?php

require __DIR__ . '/vendor/autoload.php';

// 使用Dotenv库加载.env文件中的环境变量
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();

// 初始化应用程序
$app = new App\Application();

// 运行应用程序
$app->run();

• 第一行加载了自动加载文件，这是通过Composer管理的。
• 第二行创建了一个Dotenv实例，用于加载项目根目录中的 .env 文件，这允许你通过环境变量来配置应用程序。
• 第三行创建了一个 App\Application 实例。
• 第四行调用 run 方法来启动应用程序。

3. 项目的配置文件介绍

配置文件位于 config/ 目录中，主要包括以下文件：

• app.php：包含应用程序的基本配置，如时区设置、语言、键等。
• database.php：配置数据库连接信息，包括数据库类型、主机、数据库名称、用户名和密码。
• filesystem.php：配置文件系统，如本地文件存储、云存储服务等。
• mail.php：配置邮件服务，包括SMTP服务器、端口、邮箱账号等。
• queue.php：配置队列服务，如数据库、Redis等。

以 database.php 为例，其内容可能如下：

return [
    'connections' => [
        'sqlite' => [
            'driver' => 'sqlite',
            'database' => env('DB_DATABASE', database_path('database.sqlite')),
            'prefix' => '',
        ],
        'mysql' => [
            'driver' => 'mysql',
            'host' => env('DB_HOST', '127.0.0.1'),
            'port' => env('DB_PORT', '3306'),
            'database' => env('DB_DATABASE', 'yf_exam_lite'),
            'username' => env('DB_USERNAME', 'root'),
            'password' => env('DB_PASSWORD', ''),
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
            'prefix' => '',
            'strict' => true,
            'engine' => null,
        ],
        // 其他数据库连接...
    ],
];

在这个配置文件中，你可以看到使用了 env 函数来加载 .env 文件中的环境变量，这是配置不同环境（本地、测试、生产）的一种便捷方式。