# Teanary Web Install

**Repository Path**: teanary/web_install

## Basic Information

- **Project Name**: Teanary Web Install
- **Description**: 这是一个独立的 Web 安装器，用于 Teanary 项目的快速安装配置。
- **Primary Language**: PHP
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: https://teanary.com/zh_CN/index.html
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-25
- **Last Updated**: 2026-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Teanary Web 安装器

这是一个独立的 Web 安装器，用于 Teanary 项目的快速安装配置。

## 📦 使用方法

### 1. 复制到项目

将整个 `web_install` 目录复制到项目的 `public` 目录下：

```bash
# 在项目根目录执行
cp -r web_install public/install
```

### 2. 配置 Web 服务器

确保 `public/index.php` 中有以下检查逻辑（如果还没有）：

```php
// 检查是否存在安装目录，如果存在则跳转到安装器
if (is_dir(__DIR__.'/install')) {
    header('Location: /install/');
    exit;
}
```

### 3. 访问安装器

在浏览器中访问：`http://your-domain.com/install/`

## 🚀 安装步骤

安装器包含 4 个步骤：

1. **环境检查** - 检查 PHP 版本、扩展、Composer 依赖、Redis、Meilisearch
2. **权限检查** - 检查目录和文件权限
3. **配置信息** - 填写数据库、Redis、Meilisearch、邮件等配置
4. **执行安装** - 生成 .env 文件、运行数据库迁移、清理缓存

## 📋 功能特点

- ✅ 全屏自适应多列布局
- ✅ 环境自动检测（PHP、扩展、服务）
- ✅ 权限检查和修复指导
- ✅ 完整的配置项支持
- ✅ 数据库连接测试
- ✅ 自动生成 .env 文件
- ✅ 自动运行数据库迁移
- ✅ 安装完成后可自动删除安装目录

## ⚙️ 配置项

安装器支持以下配置：

- **应用配置**: 名称、URL、环境、调试模式
- **数据库配置**: MySQL 连接信息
- **Redis 配置**: 缓存和会话存储（可选）
- **Meilisearch 配置**: 全文搜索（可选）
- **邮件配置**: SMTP 设置（可选）
- **其他配置**: 队列驱动、缓存驱动、会话驱动

## 🔒 安全提示

安装完成后，建议删除 `public/install` 目录以确保安全：

```bash
rm -rf public/install
```

或者使用安装器提供的自动删除功能。

## 📝 注意事项

1. 确保项目根目录有写权限（用于创建 .env 文件）
2. 确保 `storage` 和 `bootstrap/cache` 目录可写
3. 确保已运行 `composer install` 安装依赖
4. Redis 和 Meilisearch 是可选的，未配置时将使用数据库替代

## 🛠️ 故障排除

如果遇到问题，安装器会提供详细的错误信息和解决方案。常见问题：

- **环境检查失败**: 查看错误提示，按照说明安装缺失的扩展或服务
- **权限检查失败**: 使用提供的命令修复目录权限
- **数据库连接失败**: 检查数据库服务是否运行，验证连接信息
- **安装失败**: 查看错误日志，按照故障排除指南操作

## 📄 许可证

与主项目保持一致。