# 快速开始

本文介绍如何在本地搭建 YwxApp 开发环境并运行第一个页面。

## 环境要求

| 项目 | 要求 |
| --- | --- |
| PHP | >= 8.0（推荐 8.3） |
| 数据库 | MySQL 5.7+ / MariaDB 10.3+ |
| Composer | 2.x |
| 扩展 | pdo_mysql、mbstring、openssl、fileinfo、zip |

## 安装步骤

### 1. 获取代码并安装依赖

```bash
git clone <仓库地址> ywxapp
cd ywxapp
composer install
```

### 2. 配置环境变量

复制示例配置并按实际情况修改：

```bash
cp .env.example .env
```

关键配置项：

```ini
APP_DEBUG = true

[DATABASE]
TYPE     = mysql
HOSTNAME = 127.0.0.1
DATABASE = ywxapp
USERNAME = root
PASSWORD = 
HOSTPORT = 3306
PREFIX   = wxapp_
```

### 3. 导入数据库

将 `install.sql` 导入到你创建的数据库中，或访问安装向导按提示完成。

### 4. 配置 Web 服务器

将站点根目录指向 `public/`，并配置伪静态。

**Nginx**：

```nginx
location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
    }
}
```

**Apache**：`public/.htaccess` 已内置规则，确保开启 `mod_rewrite`。

### 5. 本地快速启动

若暂时不配置 Web 服务器，可用 PHP 内置服务器：

```bash
php think run -p 8000
```

访问 `http://127.0.0.1:8000` 即可看到展示官网首页。

## 目录权限

以下目录需要可写权限：

```
runtime/
public/uploads/
addon/
config/
```

Linux 下执行：

```bash
chmod -R 755 runtime public/uploads addon config
```

## 常用命令

```bash
# 创建插件脚手架
php think addon:make demo -a build

# 安装 / 开发模式安装插件
php think addon:manage demo -a develop

# 刷新插件后台菜单
php think addon:manage demo -a refresh-menu

# 插件健康体检
php think addon:health --detail
```

## 下一步

- [插件开发指南](addon/development)：编写你的第一个插件
- [支付钩子机制](pay/hooks)：了解事件驱动的扩展方式
- [自定义命令清单](cli/commands)：查看全部 CLI 工具