Fresns 开源程序

深色模式

宝塔面板配置教程 ​

环境安装 ​

宝塔面板 -> 软件商城 -> 运行环境

软件版本 ​

  • 安装了 Nginx 或者 Apache
  • 安装了 PHP-8.2 或者 PHP-8.3
  • 安装了 MySQL 5.7 或者 MySQL 8.0

推荐方案 ​

  • Web 环境推荐 Nginx
  • PHP 推荐 8.3
  • MySQL 推荐 8.4

PHP 配置 ​

宝塔面板 -> 软件商城 -> 运行环境

PHP 扩展 ​

  • PHP 扩展安装了 fileinfo

PHP 扩展

PHP 函数 ​

  • PHP 函数启用了 symlink, putenv, proc_open, shell_exec, pcntl_signal, pcntl_alarm, pcntl_async_signals, passthru

PHP 函数

PHP 超时限制 ​

  • 为了避免插件依赖下载超时，或者前端大文件上传等使用场景，需加大 PHP 超时限制。

PHP 超时限制

网站配置 ​

宝塔面板 -> 网站

网站目录 ​

  • 网站目录为 Fresns 项目根目录
  • 运行目录指定为 /public
  • 不要开启：防跨站攻击(open_basedir)

public

URL 重写 ​

URL

PHP 版本 ​

  • 不低于 PHP 8.2

PHP

Composer 版本 ​

  • 不低于 Composer 2.5

Composer

PHP 命令行版本 ​

  • 选择 PHP-81 或者 PHP-82

PHP Cli

数据库配置 ​

字符集 ​

  • 必须为 utf8mb4

MySQL Character Set

排序规则 ​

  • MySQL 5.7 推荐 utf8mb4_unicode_520_ci
  • MySQL 8.0 推荐 utf8mb4_0900_ai_ci

为了兼顾 MySQL 5.7 版本，所以主程序中默认为 utf8mb4_unicode_520_ci 排序规则，当 .env 文件中未配置排序规则时，主程序使用默认项；如果你使用 utf8mb4_0900_ai_ci 或者其他排序规则，请在 .env 文件中新增配置项定义新规则。

Fresns 安装成功后才会生成 .env 文件，所以未安装前，项目根目录没有这个文件。

php
# 数据库排序规则
DB_COLLATION=utf8mb4_0900_ai_ci

MySQL Collation

目录权限 ​

宝塔面板 -> 文件

  • 确认 Fresns 项目所有子目录均是 775 或者 755 权限
  • 确认所有子目录权限所有者均是 www 权限
  • 如果你不确定，或者一个一个目录的查看比较费时，那么可以选择批量重置权限

Folder Ownership

定时任务 ​

宝塔面板 -> 计划任务

Crontab

sh
# 任务配置
su -c "cd /你的项目路径 && php artisan schedule:run >> /dev/null 2>&1" -s /bin/sh 所有者

# 示例
su -c "cd /www/wwwroot/fresns && php artisan schedule:run >> /dev/null 2>&1" -s /bin/sh www

队列 ​

配置说明

  • 如果你安装的插件需要「队列」功能（详情请咨询插件开发者），可参考以下教程为主程序配置队列功能。
  • 没有特别说明的插件，默认就是用不到队列功能；如果用到，插件开发者一定会说明。
  • 如果用不到，可以忽略不用配置。

1、新增 .env 配置项 ​

  • Fresns 安装成功后才会生成 .env 文件，所以未安装前，项目根目录没有这个文件。
  • .env 配置文件新增队列配置
php
# 队列连接方式
QUEUE_CONNECTION=redis

# redis 配置
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
REDIS_QUEUE=fresns
  • 队列连接方式：
    • sync 同步执行队列，无需额外配置
    • redis 使用 PHP 扩展 redis 缓存器驱动队列
    • database 使用数据库驱动队列，无需额外配置
    • beanstalkd 使用分布式内存队列系统，适用于大型项目
    • sqs 使用 AWS sqs 驱动队列，需配置 AWS 密钥，适用于大型项目

推荐 redis 或 database，不配置则默认为 sync

env

redis

2、安装队列管理工具 Supervisor ​

Supervisor

3、配置队列进程 ​

Supervisor

sh
# 进程启动命令
php artisan queue:work

进程重启说明 ​

  • 如果插件升级后需要重置队列进程，打开 Supervisor 管理器，找到 Fresns 队列进程，操作「重启」即可。
  • 详情请查看插件升级说明，如果升级有要求则操作重启，没要求可忽略。