安装指南

本指南将帮助您在本地环境安装逍遥图库系统。

环境准备

1. 安装 PHP

确保您的系统已安装 PHP 8.0 或更高版本。

# 检查 PHP 版本
php -v

# 输出示例
PHP 8.2.0 (cli) ...

必需的 PHP 扩展

  • mysqli / pdo_mysql - 数据库连接
  • gd / imagick - 图片处理
  • curl - HTTP 请求
  • mbstring - 多字节字符串
  • openssl - 加密
  • fileinfo - 文件类型检测
  • json - JSON 处理
# 查看已安装的扩展
php -m

2. 安装 MySQL

# 检查 MySQL 版本
mysql --version

# 输出示例
mysql Ver 8.0.32 ...

3. 安装 Composer

# 检查 Composer 版本
composer --version

# 如果未安装，请访问
# https://getcomposer.org/download/

4. 安装 Redis（可选）

Redis 用于缓存优化，如果不使用可以跳过。

# 检查 Redis 版本
redis-server --version

安装步骤

步骤 1：获取代码

方式一：Git 克隆（推荐）

git clone https://gitee.com/sinma/zeaya.git photo-gallery
cd photo-gallery

方式二：下载压缩包

  1. 访问 Gitee 仓库
  2. 点击「克隆/下载」→「下载 ZIP」
  3. 解压到目标目录

步骤 2：安装依赖

# 进入项目目录
cd photo-gallery

# 安装 Composer 依赖
composer install

# 如果网络慢，可以使用国内镜像
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
composer install

步骤 3：配置环境

# 复制环境配置文件（如果存在）
cp .env.example .env

# 或者直接编辑 .env 文件

编辑 .env 文件，配置数据库信息：

APP_DEBUG = false

# 数据库配置
DB_TYPE = mysql
DB_HOST = 127.0.0.1
DB_NAME = photo_gallery
DB_USER = root
DB_PASS = your_password
DB_PORT = 3306
DB_CHARSET = utf8mb4

# 内置服务器配置
SERVER_HOST = 0.0.0.0
SERVER_PORT = 8080
SERVER_ROOT = .

步骤 4：创建数据库

# 登录 MySQL
mysql -u root -p

# 创建数据库
CREATE DATABASE photo_gallery DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 退出
exit;

步骤 5：导入数据表

# 导入主数据库结构
mysql -u root -p photo_gallery < database/migrations/create_tables.sql

# 导入软删除字段（可选）
mysql -u root -p photo_gallery < database/migrations/add_soft_delete_to_photos.sql

步骤 6：设置目录权限

Linux/Mac

# 设置运行时目录权限
chmod -R 755 runtime
chmod -R 755 storage

# 如果需要上传功能
mkdir -p storage/photos
chmod -R 755 storage/photos

Windows

Windows 系统通常不需要设置权限，跳过此步骤。

步骤 7：启动服务器

# 启动开发服务器
php think run

# 输出示例
ThinkPHP Development server is started on http://0.0.0.0:8080/
Document root is D:\work\zeaya\photo-gallery
Press Ctrl-C to quit.

步骤 8：访问系统

打开浏览器访问：http://localhost:8080

验证安装

功能检查清单

  • [ ] 首页正常显示
  • [ ] 能够注册新用户
  • [ ] 能够登录系统
  • [ ] 能够上传图片
  • [ ] 能够创建相册
  • [ ] 发现页正常显示

常见问题

1. 页面显示 404

原因：URL 重写未生效

解决：

  • 检查 .htaccess 文件是否存在
  • 确认 Apache 的 AllowOverride All 配置

2. 静态资源加载失败

原因：路径配置问题

解决：

  • 确认运行目录为项目根目录
  • 检查 static/ 目录是否存在

3. 数据库连接失败

原因：配置信息错误

解决：

  • 检查 .env 中的数据库配置
  • 确认 MySQL 服务已启动
  • 测试数据库连接：mysql -u root -p

4. 图片上传失败

原因：目录权限或 PHP 配置

解决：

# 检查目录权限
chmod -R 777 storage

# 检查 PHP 配置
php -i | grep upload_max_filesize
# 如果太小，修改 php.ini：
# upload_max_filesize = 10M
# post_max_size = 20M

升级方法

从源码升级

# 备份当前代码
cp -r photo-gallery photo-gallery-backup

# 拉取最新代码
cd photo-gallery
git pull origin main

# 更新依赖
composer update

# 检查数据库迁移
# 查看 database/migrations/ 目录是否有新文件

注意事项

  1. 备份数据 - 升级前务必备份数据库和上传文件
  2. 检查配置 - 新版本可能有新的配置项
  3. 清除缓存 - 升级后执行 php think clear

下一步

安装完成后，请继续阅读：