ZanPHP 框架安装与使用教程

1. 项目目录结构及介绍

ZanPHP的目录结构如下：

zanphp/
|-- app/                # 应用逻辑代码
|   |-- controller/     # 控制器目录
|   |-- model/          # 模型目录
|   |-- view/           # 视图目录
|   `-- config/         # 应用配置文件
|-- public/             # 公共可访问目录，通常作为Web服务器的根目录
|   `-- index.php        # 入口文件
|-- vendor/             # 第三方依赖包
|-- .gitignore          # Git 忽略文件配置
|-- README.md           # 项目简介
|-- changelog.txt       # 更新日志
|-- index.php           # 主入口文件
|-- license.txt         # 许可证文件
`-- etc/                 # 一些全局配置和脚本
    `-- config.php       # 全局框架配置

• app/ : 存放应用程序的代码，包括控制器、模型、视图和配置。
• public/ : 面向用户的目录，放置静态资源和入口文件。
• vendor/ : 通过Composer管理的第三方库。
• .gitignore : Git忽略文件列表，避免将不必要的文件加入版本控制。
• README.md : 项目说明文档。
• changelog.txt : 更新历史记录。
• index.php : 用于引导应用的前端入口文件。
• license.txt : 许可协议文件。
• etc/config.php : 框架级别的全局配置文件。

2. 项目的启动文件介绍

public/index.php

这是对外公开的入口文件，它负责加载框架的基础环境并初始化请求处理流程：

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

// 初始化 ZanPHP 框架
use Zan\Framework\Bootstrap;
Bootstrap::init();

这个文件首先引入了Composer自动加载器，然后通过Zan\Framework\Bootstrap::init();启动ZanPHP框架。

etc/config.php

全局配置文件，可以定义框架运行时的一些参数，例如数据库连接、缓存设置等。配置项是键值对的形式，可以根据需要进行修改以适应你的应用程序。

示例配置文件可能包括以下内容：

return [
    'database' => [
        'default' => 'mysql',
        'connections' => [
            'mysql' => [
                'host' => '127.0.0.1',
                'port' => 3306,
                'username' => 'root',
                'password' => '',
                'dbname' => 'testdb',
                'charset' => 'utf8mb4'
            ]
        ]
    ],
    'session' => [
        'handler' => '\Zan\Framework\Store\Handler\File',
        'config' => [
            'path' => '/tmp/sessions',
            'lifetime' => 86400,
        ]
    ]
];

3. 项目的配置文件介绍

除了全局配置文件etc/config.php之外，ZanPHP允许你在app/config中定义特定于应用的配置文件。这些文件在应用启动时会被合并到全局配置中，覆盖相应的默认配置。

例如，你可以创建一个app/config/db.php来覆盖全局的数据库配置，内容如下：

return [
    'database' => [
        'connections' => [
            'mysql' => [
                'host' => 'localhost',
                'port' => 3306,
                'username' => 'your_user',
                'password' => 'your_password',
                'dbname' => 'your_dbname',
                'charset' => 'utf8mb4'
            ]
        ]
    ]
];

在这个例子中，mysql连接的配置将被app/config/db.php中的设置覆盖。

完成上述步骤后，你已经了解了ZanPHP的基本结构和配置方式，接下来可以按照项目需求编写业务代码并部署到生产环境中。