快速开始

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

环境要求

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

安装步骤

1. 获取代码并安装依赖

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

2. 配置环境变量

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

cp .env.example .env

关键配置项：

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：

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

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

5. 本地快速启动

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

php think run -p 8000

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

目录权限

以下目录需要可写权限：

runtime/
public/uploads/
addon/
config/

Linux 下执行：

chmod -R 755 runtime public/uploads addon config

常用命令

# 创建插件脚手架
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

下一步

插件开发指南：编写你的第一个插件
支付钩子机制：了解事件驱动的扩展方式
自定义命令清单：查看全部 CLI 工具

2.0 KiB Raw Permalink Blame History Unescape Escape