Apache 部署

前提条件

• Apache 2.4+
• 已启用 mod_rewrite 模块

配置步骤

1. 站点根目录

将站点根目录（DocumentRoot）指向 public/ 文件夹：

<VirtualHost *:80>
    ServerName your-domain.com
    DocumentRoot /path/to/project/public

    <Directory /path/to/project/public>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

2. .htaccess 配置

系统已自带 public/.htaccess 文件，内容如下：

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ index.php?s=/$1 [QSA,PT,L]
</IfModule>

说明

这段规则的含义：如果请求的不是真实存在的目录或文件，就转发给 index.php 处理。静态文件（JS/CSS/图片）和文档站目录不受影响。

phpStudy 配置

1. 打开 phpStudy Pro
2. 切换 Web 服务器为 Apache
3. 网站 → 创建网站 → 根目录选择 public/
4. 确保 PHP 版本为 8.0+
5. 重启 Apache

常见问题

问题	解决方案
页面空白或 500 错误	检查 mod_rewrite 是否启用
.htaccess 不生效	确认 AllowOverride All 已设置
登录后"未授权"	Apache 默认传递 Authorization 头，一般无需额外配置

下一步

• 安装步骤 → 继续安装系统
• 部署问题 FAQ → 更多部署常见问题