115 lines
2.0 KiB
Markdown
115 lines
2.0 KiB
Markdown
# 快速开始
|
||
|
||
本文介绍如何在本地搭建 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 工具
|