环境要求

目录

• 功能说明
• 设计思路
• 环境要求详情
• 常见问题

---

1. 功能说明

概述

本文档详细说明 Niucloud 系统运行所需的环境要求，包括服务器配置、软件版本、依赖组件等。

适用场景

• 系统部署前的环境准备
• 开发环境搭建
• 生产环境配置
• 服务器选购参考

---

2. 设计思路

技术选型

组件	最低版本	推荐版本	说明
PHP	8.0	8.0	后端运行环境
MySQL	5.7	8.0+	数据存储
Redis	5.0	6.0+	缓存服务
Nginx	1.18	1.20+	Web服务器

---

3. 环境要求详情

3.1 服务器配置

最低配置

配置项	要求
CPU	2核
内存	4GB
硬盘	50GB SSD
带宽	3Mbps

推荐配置

配置项	要求
CPU	4核
内存	8GB
硬盘	100GB SSD
带宽	5Mbps

3.2 PHP 环境

必需扩展

- PDO
- PDO_MySQL
- Redis
- Mbstring
- OpenSSL
- JSON
- Fileinfo
- GD / Imagick
- Zip
- XML
- BCMath
- Curl

PHP 配置建议

; php.ini 推荐配置
memory_limit = 512M
upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 300
max_input_vars = 3000
date.timezone = Asia/Shanghai

3.3 MySQL 配置

推荐配置

; my.cnf 推荐配置
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_general_ci
max_connections = 500
innodb_buffer_pool_size = 1G
innodb_log_file_size = 256M

3.4 Nginx 配置

伪静态规则

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
        break;
    }
}

3.5 目录权限

项目根目录需要以下权限：
- runtime/      777
- public/upload/ 777
- public/static/ 755
- app/          755
- config/       755

3.6 开发环境工具

工具	用途	下载地址
Git	版本控制	https://git-scm.com
Composer	PHP依赖管理	https://getcomposer.org
Node.js	前端构建	https://nodejs.org
NPM	前端依赖管理	随Node.js安装

---

4. 常见问题

Q1: PHP 扩展安装失败

问题现象： 安装 PHP 扩展时提示找不到或安装失败。

解决方案：

# Ubuntu/Debian
sudo apt-get install php8.0-redis php8.0-gd php8.0-zip

# CentOS
sudo yum install php-redis php-gd php-zip

# 重启 PHP 服务
sudo systemctl restart php-fpm

Q2: 上传文件大小限制

问题现象： 上传大文件时提示文件过大。

解决方案： 修改 php.ini 中的以下配置：

upload_max_filesize = 50M
post_max_size = 50M

Q3: 内存不足错误

问题现象： 运行过程中出现 Allowed memory size exhausted 错误。

解决方案：

; 增加 PHP 内存限制
memory_limit = 512M

; 或者修改代码中的临时内存限制
ini_set('memory_limit', '512M');

---

修订记录

版本	日期	修订人	修订内容
v1.0	2026-04-08	Niucloud Team	初始版本