Fresns 核心安装要求汇总

Fresns 是一款基于 PHP 和关系型数据库的开源社交社区软件，对服务器环境有明确要求。以下是它的核心安装要求汇总：

🖥️ 环境要求

• Web 服务器：Nginx、Apache、Caddy 或 IIS 均可。

• PHP 版本：8.2 或更高版本（官网最新要求）。

• 软件包管理器：必须使用 Composer 2.5 或更高版本。

• 数据库：支持 MySQL (5.7+)、MariaDB (10.3+)、PostgreSQL (11+)、SQL Server (2017+) 或 SQLite (3.35+)。

⚙️ PHP 扩展与函数

除了环境检查通常需要的扩展（如 mbstring, fileinfo, opcache）外，Fresns 依赖一些特定的 PHP 函数来执行安装和后续维护：

• 必须启用的函数：symlink, putenv, proc_open, shell_exec, passthru。

• 队列相关函数：pcntl_signal, pcntl_alarm, pcntl_async_signals（若不使用异步队列，通常可跳过）。

📂 Web 服务器配置关键点

• 运行目录：网站的运行目录必须指向 Fresns 的 /public 目录。

• URL 重写：必须配置伪静态规则，将所有请求导向 public/index.php。切勿将 index.php 移动到根目录，否则会导致敏感文件暴露。

• 数据库字符集：创建数据库时，字符集必须选择 utf8mb4。

💡 安装提示

Fresns 是前后端分离架构，主程序仅提供服务端。安装时，你需要通过浏览器访问 /install 路径，或在终端执行 php artisan fresns:install 来完成初始化。