一、部署前准备
1. 系统要求
- 服务器环境：Linux（推荐CentOS 7+/Ubuntu 20.04+）或Windows Server 2016+。
- 数据库：MySQL 5.7+ 或 MariaDB 10.3+（需支持InnoDB引擎）。
- Web服务器：Nginx/Apache（推荐Nginx，性能更优）。
- 编程语言：PHP 7.4+（需安装GD库、PDO、MBString等扩展）。
- 其他依赖：Redis（缓存）、Composer（PHP依赖管理）、Node.js（前端构建，如Vue/React）。
2. 源码获取
- 确认源码完整性：检查是否包含`/app`、`/public`、`/config`等核心目录。
- 验证许可证：确保源码授权合法，避免侵权风险。
二、环境配置步骤
1. 服务器部署
- Linux环境（以CentOS为例）：
```bash
安装必要工具
yum install -y wget curl unzip git
安装PHP及扩展
yum install -y php php-mysqlnd php-gd php-mbstring php-pdo php-redis
安装MySQL
yum install -y mariadb-server
systemctl start mariadb
mysql_secure_installation 设置密码
```
- Windows环境：
通过XAMPP/WAMP一键安装PHP+MySQL+Apache，或手动配置IIS+PHP。
2. 数据库配置
- 创建数据库及用户：
```sql
CREATE DATABASE fresh_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER fresh_user@localhost IDENTIFIED BY your_password;
GRANT ALL PRIVILEGES ON fresh_db.* TO fresh_user@localhost;
FLUSH PRIVILEGES;
```
3. Web服务器配置
- Nginx示例（`/etc/nginx/conf.d/fresh.conf`）：
```nginx
server {
listen 80;
server_name yourdomain.com;
root /var/www/fresh/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
}
}
```
三、源码部署流程
1. 上传源码
- 将源码解压至Web目录（如`/var/www/fresh`）。
- 确保目录权限正确：
```bash
chown -R www-data:www-data /var/www/fresh Ubuntu
chown -R apache:apache /var/www/fresh CentOS
```
2. 安装依赖
- 进入项目目录，运行Composer安装：
```bash
cd /var/www/fresh
composer install --no-dev --optimize-autoloader
```
3. 配置环境文件
- 复制`.env.example`为`.env`，修改关键配置：
```env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=fresh_db
DB_USERNAME=fresh_user
DB_PASSWORD=your_password
```
4. 生成应用密钥
```bash
php artisan key:generate
```
5. 执行数据库迁移
```bash
php artisan migrate --seed 迁移并填充测试数据
```
四、常见问题及解决
1. 500 Internal Server Error
- 检查`storage/logs/laravel.log`获取具体错误。
- 常见原因：
- 目录权限不足（确保`storage`和`bootstrap/cache`可写）。
- PHP扩展缺失（如`pdo_mysql`）。
- 数据库连接失败（检查`.env`配置）。
2. 白屏或样式缺失
- 运行前端构建命令（如Vue项目）：
```bash
npm install && npm run build
```
- 确保Nginx/Apache配置指向`public`目录。
3. 性能优化建议
- 启用OPcache加速PHP执行。
- 配置Redis作为缓存和会话存储。
- 使用CDN加速静态资源。
五、进阶配置
1. 支付接口对接
- 修改`.env`中的支付配置（如支付宝、微信支付）：
```env
ALIPAY_APP_ID=your_app_id
WECHAT_PAY_MCH_ID=your_mch_id
```
2. 定时任务（Cron）
- 添加Laravel调度任务到系统Cron：
```bash
* * * * * cd /var/www/fresh && php artisan schedule:run >> /dev/null 2>&1
```
3. HTTPS配置
- 使用Lets Encrypt免费证书：
```bash
certbot --nginx -d yourdomain.com
```
六、官方支持渠道
- 文档中心：访问万象生鲜软件的官方文档（如`docs.wanxiang.com`）。
- 社区论坛：在GitHub Issues或官方论坛提交问题。
- 技术支持：联系万象官方客服（电话/邮件/在线工单）。
提示：部署前建议备份数据库和源码，生产环境务必关闭调试模式（`.env`中`APP_DEBUG=false`）。如遇复杂问题，可提供具体错误日志进一步分析。
广告
