[文档]Teanary外贸电商系统现在有WEB安装器了
Teanary Web 安装器
这是一个独立的 Web 安装器,用于 Teanary 项目的快速安装配置。
📦 使用方法
1. 复制到项目
将整个 web_install 目录复制到项目的 public 目录下:
# 在项目根目录执行
cp -r web_install public/install
2. 配置 Web 服务器
确保 public/index.php 中有以下检查逻辑(如果还没有):
// 检查是否存在安装目录,如果存在则跳转到安装器
if (is_dir(__DIR__.'/install')) {
header('Location: /install/');
exit;
}
3. 访问安装器
在浏览器中访问:http://your-domain.com/install/
🚀 安装步骤
安装器包含 4 个步骤:
环境检查 - 检查 PHP 版本、扩展、Composer 依赖、Redis、Meilisearch
权限检查 - 检查目录和文件权限
配置信息 - 填写数据库、Redis、Meilisearch、邮件等配置
执行安装 - 生成 .env 文件、运行数据库迁移、清理缓存
📋 功能特点
✅ 全屏自适应多列布局
✅ 环境自动检测(PHP、扩展、服务)
✅ 权限检查和修复指导
✅ 完整的配置项支持
✅ 数据库连接测试
✅ 自动生成 .env 文件
✅ 自动运行数据库迁移
✅ 安装完成后可自动删除安装目录
⚙️ 配置项
安装器支持以下配置:
应用配置: 名称、URL、环境、调试模式
数据库配置: MySQL 连接信息
Redis 配置: 缓存和会话存储(可选)
Meilisearch 配置: 全文搜索(可选)
邮件配置: SMTP 设置(可选)
其他配置: 队列驱动、缓存驱动、会话驱动
🔒 安全提示
安装完成后,建议删除 public/install 目录以确保安全:
rm -rf public/install
或者使用安装器提供的自动删除功能。
📝 注意事项
确保项目根目录有写权限(用于创建 .env 文件)
确保
storage和bootstrap/cache目录可写确保已运行
composer install安装依赖Redis 和 Meilisearch 是可选的,未配置时将使用数据库替代
🛠️ 故障排除
如果遇到问题,安装器会提供详细的错误信息和解决方案。常见问题:
环境检查失败: 查看错误提示,按照说明安装缺失的扩展或服务
权限检查失败: 使用提供的命令修复目录权限
数据库连接失败: 检查数据库服务是否运行,验证连接信息
安装失败: 查看错误日志,按照故障排除指南操作
本作品采用《CC 协议》,转载必须注明作者和本文链接
关于 LearnKu
我不想在核心代码中维护只使用一次的代码,所以单独的抽了一个仓库 :grin: