安装指南

安装指南

1. 部署文件

将安装包解压到 Web 根目录，确保 Nginx/Apache 的站点根目录指向项目根目录（index.php 所在目录）。

/var/www/moyu/          ← 站点根目录
├── index.php           ← Web 入口
├── .htaccess
├── core/               ← 应用代码 + vendor（已包含依赖）
├── static/             ← 前端静态资源
├── avatar/
└── upload/

2. 设置目录权限

chmod -R 775 core/runtime assets avatar upload
chown -R www:www core/runtime assets avatar upload

宝塔面板用户：在文件管理中将 core/runtime、assets、avatar、upload 四个目录权限设为 755，所有者设为 www。

3. Web 服务器配置

Nginx：

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/moyu;
    index index.php;
    charset utf-8;
    client_max_body_size 12M;

    # 禁止访问隐藏文件
    location ~ /\. {
        deny all;
    }

    # 禁止上传目录执行 PHP
    location ~* ^/(avatar|upload)/.*\.php$ {
        deny all;
    }

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Apache：

项目自带 .htaccess，确保启用 mod_rewrite：

a2enmod rewrite

VirtualHost 中设置 AllowOverride All。

4. 运行安装向导

浏览器访问 http://your-domain.com/install，按向导完成安装：

1. 环境检测 — 自动检查 PHP 版本、扩展、目录权限
2. 数据库配置 — 填写数据库连接信息，支持一键测试连接
3. 管理员账号 — 设置管理员用户名、邮箱、密码
4. 执行安装 — 自动创建数据库表、写入配置、生成 .env

安装完成后自动跳转到首页。安装向导会生成 .env 文件并写入 INSTALLED=1 标记，再次访问 /install 会自动跳转。

安装完成后建议删除 core/modules/install/ 目录。

5. 生产环境优化

编辑 index.php，关闭调试模式：

defined('YII_DEBUG') or define('YII_DEBUG', false);
defined('YII_ENV') or define('YII_ENV', 'prod');