# zwebtemplate

**Repository Path**: calvinwilliams/zwebtemplate

## Basic Information

- **Project Name**: zwebtemplate
- **Description**: a template for zlang web application
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-04
- **Last Updated**: 2025-01-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 关于zwebtemplate

[`zwebtemplate`](https://gitee.com/calvinwilliams/zwebtemplate)是一个开源项目，它包含了一个快速成型的`zlang`语言的Web框架，还包含了一个小型的Web应用网站“家庭书籍管理系统”。它具体包含：

1. Web框架：一个完整的启动函数`main.z`、一个常用全局对象 `global.z`、一个工具对象库`util.z`、一个常用拦截器库`intercept.z`、以及一个页码控制器对象`page_control.z`；
2. Web应用：一个初具规模的用户模块`user.z`（用户注册、用户登录、用户登出、用户认证）；
3. Web应用：一个书籍管理模块`book.z`；

### 开发者可以通过这个开源项目：

1. 感受一个用`zlang`实现的Web框架和运行机制；

2. 学习如何用`zlang`开发Web应用；

3. 作为一个Web应用网站种子，成长成自己的网站；

### 项目目录说明：

​	`zlang`源码文件都放在`src/`目录里；

​	`HTML/JS/CSS文件`或`HTML模板文件`都放在`www/`目录里；

​	数据库采用`MySQL`，其DDL放在`sql/`目录里，数据放在`data/`目录里（可以直接执行.sql或通过zdbtools导入.xlsx）；

### 安装说明：

​	在.profile里设置环境变量并生效

```
export DBTYPE=MYSQL
export DBHOST=localhost
export DBPORT=3306
export DBUSER=zwebtemplate
export DBPASS=zwebtemplate
export DBNAME=zwebtemplatedb
```

​	安装数据库、导入表结构和表数据

​	启动Web应用网站

```
$ zlang src/main.z
```

​	打开浏览器，访问网站

```
http://(ip):8080/
```