Velstore生产部署终极指南Vite构建、环境配置与性能避坑清单【免费下载链接】velstoreFree and open-source multi-vendor Laravel eCommerce solution that is fully customizable and ready to use.项目地址: https://gitcode.com/gh_mirrors/ve/velstoreVelstore 是一款免费开源的多商户 Laravel 电商解决方案支持多语言、PayPal/Stripe 支付和完整的商家/顾客面板。本文带你完成一次从零到上线的生产部署先做 Vite 前端构建再逐项配置生产环境最后用一份避坑清单排查最常见故障。1️⃣ 部署前准备3个硬性环境要求在动手之前先确认服务器满足以下要求参考项目 composer.json 与 CI 配置依赖最低版本说明PHP8.1推荐 8.3需启用mbstring、bcmath、pdo_mysql扩展数据库MySQL 8.0项目默认连接驱动为mysqlNode.js npm18用于 Vite 5 前端资源构建 后端框架为 Laravel 10前端采用 Blade Vite配置见 vite.config.js因此服务器必须能执行npm run build。2️⃣ 一键安装命令install:velstore 帮你省了80%的步骤Velstore 提供了专门的安装命令实现在 app/Console/Commands/Velstore.php它会一次性完成数据迁移、创建管理员账号、选择应用语言、安装 npm 依赖、生成APP_KEY、创建存储软链接。步骤如下# 1. 创建项目 composer create-project velstorelabs/velstore cd velstore # 2. 准备环境变量如缺少 .env 则从示例复制 cp .env.example .env # 3. 创建 MySQL 数据库并修改 .env 中的数据库凭据 # DB_DATABASE / DB_USERNAME / DB_PASSWORD # 4. 一键安装--with-import 会导入示例商品、品牌、菜单等演示数据 php artisan install:velstore --with-import执行过程中会提示选择应用语言en / es / fr / de选择后会写入.env的APP_LOCALE。⚠️注意该命令会创建一个默认管理员账号adminexample.com密码为abc123。生产环境上线后必须第一时间修改密码这是最常见的安全隐患之一。3️⃣ Vite 前端构建生产环境千万别用 npm run dev很多新手部署 Velstore 遇到页面样式全挂报错Vite manifest not found——原因就是只跑了开发模式。Vite 开发模式npm run dev会启动一个本地监听服务器生产环境根本用不了必须执行一次性的构建命令npm install # 安装前端依赖 npm run build # 构建产物输出到 public/build/构建完成后Laravel 通过public/build/manifest.json找到打包好的 JS/CSS 文件。package.json 中build脚本对应的就是vite build。前端资源清单定义在 vite.config.js 中包含后台的 SCSS/JS 和前台 xylo 主题的全部样式脚本一次构建全部搞定。4️⃣ .env 生产环境配置清单.env.example 里的默认值全部是开发友好设置上生产前请按此清单逐项修改# —— 应用基础 —— APP_ENVproduction APP_DEBUGfalse APP_URLhttps://your-domain.com # —— 数据库 —— DB_CONNECTIONmysql DB_HOST127.0.0.1 DB_PORT3306 DB_DATABASEvelstore DB_USERNAME你的用户名 DB_PASSWORD你的密码 # —— 生产推荐的存储/会话/队列驱动需安装 Redis—— CACHE_DRIVERredis SESSION_DRIVERredis QUEUE_CONNECTIONredis为什么这样改APP_DEBUGfalse关闭调试页防止报错时向访客泄露代码路径与数据库信息APP_URL影响所有绝对 URL邮件链接、storage图片地址必须填真实域名APP_KEY安装命令已自动生成切勿直接复制 .env.example 里的示例密钥CACHE/SESSION/QUEUE默认filesync适合本地开发生产环境建议切到 Redis.env中已预留REDIS_HOST等配置QUEUE_CONNECTION切到redis后才能使用异步任务5️⃣ 性能优化一行命令开启全部缓存Laravel 生产部署的标准三件套缓存可以显著减少每次请求的配置加载开销composer install --no-dev --optimize-autoloader # 生产依赖 php artisan config:cache # 缓存配置 php artisan route:cache # 缓存路由 php artisan view:cache # 预编译 Blade 模板 php artisan optimize # 上述命令的聚合版 php artisan storage:link # 创建 public/storage 软链接其中storage:link特别关键所有商品图片、商家头像都存在storage/app/public下不建软链接前台图片就全是裂图链接配置见 config/filesystems.php。目录权限检查Web 服务用户需可写chmod -R 775 storage bootstrap/cache6️⃣ Web 服务器配置要点站点根目录指向public/而不是项目根目录——这是 Laravel 应用的铁律index.php入口就在 public/index.phpNginx/Apache 均需开启 HTTPS并拦截/storage与/build静态资源的 PHP 解析若用队列异步处理订单、发邮件等任务用 Supervisor 常驻php artisan queue:work7️⃣ 性能避坑清单这6个坑占生产故障的九成#现象原因解决办法1报错Vite manifest not found未构建前端 / 误用npm run dev生产环境执行npm run build2商品图片显示裂图缺少存储软链接执行php artisan storage:link3报错页直接暴露代码路径APP_DEBUGtrue未关闭设为false并清配置缓存4改完.env不生效配置已被缓存执行php artisan config:clear5邮件/任务不执行队列仍是sync或 mail 未配置切换QUEUE_CONNECTION配置MAIL_*6站点可被匿名登录默认管理员adminexample.com / abc123上线后立即修改后台密码8️⃣ 部署后自检5分钟验证清单✅ 前台首页 200 正常商品列表/分类/品牌页面无样式错乱✅ 访问/admin登录后台商品、订单、Banner 管理入口正常✅ 商品图片、轮播图均能加载验证 storage 软链接✅ 用测试金额走一单 PayPal 或 Stripe 支付流程网关配置参考 config/services.php✅ 浏览器 F12 检查无 500 错误、无 debug 信息泄露✅ 确认.env文件权限为640且不在public/目录内可被访问小结Velstore 的生产部署核心就四步改.env→npm run build→ 开缓存 建软链接 → 改默认密码。按上面的避坑清单逐项过一遍90% 的部署故障都能提前拦截。祝你的多商户商城顺利上线【免费下载链接】velstoreFree and open-source multi-vendor Laravel eCommerce solution that is fully customizable and ready to use.项目地址: https://gitcode.com/gh_mirrors/ve/velstore创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Velstore生产部署终极指南：Vite构建、环境配置与性能避坑清单
Velstore生产部署终极指南Vite构建、环境配置与性能避坑清单【免费下载链接】velstoreFree and open-source multi-vendor Laravel eCommerce solution that is fully customizable and ready to use.项目地址: https://gitcode.com/gh_mirrors/ve/velstoreVelstore 是一款免费开源的多商户 Laravel 电商解决方案支持多语言、PayPal/Stripe 支付和完整的商家/顾客面板。本文带你完成一次从零到上线的生产部署先做 Vite 前端构建再逐项配置生产环境最后用一份避坑清单排查最常见故障。1️⃣ 部署前准备3个硬性环境要求在动手之前先确认服务器满足以下要求参考项目 composer.json 与 CI 配置依赖最低版本说明PHP8.1推荐 8.3需启用mbstring、bcmath、pdo_mysql扩展数据库MySQL 8.0项目默认连接驱动为mysqlNode.js npm18用于 Vite 5 前端资源构建 后端框架为 Laravel 10前端采用 Blade Vite配置见 vite.config.js因此服务器必须能执行npm run build。2️⃣ 一键安装命令install:velstore 帮你省了80%的步骤Velstore 提供了专门的安装命令实现在 app/Console/Commands/Velstore.php它会一次性完成数据迁移、创建管理员账号、选择应用语言、安装 npm 依赖、生成APP_KEY、创建存储软链接。步骤如下# 1. 创建项目 composer create-project velstorelabs/velstore cd velstore # 2. 准备环境变量如缺少 .env 则从示例复制 cp .env.example .env # 3. 创建 MySQL 数据库并修改 .env 中的数据库凭据 # DB_DATABASE / DB_USERNAME / DB_PASSWORD # 4. 一键安装--with-import 会导入示例商品、品牌、菜单等演示数据 php artisan install:velstore --with-import执行过程中会提示选择应用语言en / es / fr / de选择后会写入.env的APP_LOCALE。⚠️注意该命令会创建一个默认管理员账号adminexample.com密码为abc123。生产环境上线后必须第一时间修改密码这是最常见的安全隐患之一。3️⃣ Vite 前端构建生产环境千万别用 npm run dev很多新手部署 Velstore 遇到页面样式全挂报错Vite manifest not found——原因就是只跑了开发模式。Vite 开发模式npm run dev会启动一个本地监听服务器生产环境根本用不了必须执行一次性的构建命令npm install # 安装前端依赖 npm run build # 构建产物输出到 public/build/构建完成后Laravel 通过public/build/manifest.json找到打包好的 JS/CSS 文件。package.json 中build脚本对应的就是vite build。前端资源清单定义在 vite.config.js 中包含后台的 SCSS/JS 和前台 xylo 主题的全部样式脚本一次构建全部搞定。4️⃣ .env 生产环境配置清单.env.example 里的默认值全部是开发友好设置上生产前请按此清单逐项修改# —— 应用基础 —— APP_ENVproduction APP_DEBUGfalse APP_URLhttps://your-domain.com # —— 数据库 —— DB_CONNECTIONmysql DB_HOST127.0.0.1 DB_PORT3306 DB_DATABASEvelstore DB_USERNAME你的用户名 DB_PASSWORD你的密码 # —— 生产推荐的存储/会话/队列驱动需安装 Redis—— CACHE_DRIVERredis SESSION_DRIVERredis QUEUE_CONNECTIONredis为什么这样改APP_DEBUGfalse关闭调试页防止报错时向访客泄露代码路径与数据库信息APP_URL影响所有绝对 URL邮件链接、storage图片地址必须填真实域名APP_KEY安装命令已自动生成切勿直接复制 .env.example 里的示例密钥CACHE/SESSION/QUEUE默认filesync适合本地开发生产环境建议切到 Redis.env中已预留REDIS_HOST等配置QUEUE_CONNECTION切到redis后才能使用异步任务5️⃣ 性能优化一行命令开启全部缓存Laravel 生产部署的标准三件套缓存可以显著减少每次请求的配置加载开销composer install --no-dev --optimize-autoloader # 生产依赖 php artisan config:cache # 缓存配置 php artisan route:cache # 缓存路由 php artisan view:cache # 预编译 Blade 模板 php artisan optimize # 上述命令的聚合版 php artisan storage:link # 创建 public/storage 软链接其中storage:link特别关键所有商品图片、商家头像都存在storage/app/public下不建软链接前台图片就全是裂图链接配置见 config/filesystems.php。目录权限检查Web 服务用户需可写chmod -R 775 storage bootstrap/cache6️⃣ Web 服务器配置要点站点根目录指向public/而不是项目根目录——这是 Laravel 应用的铁律index.php入口就在 public/index.phpNginx/Apache 均需开启 HTTPS并拦截/storage与/build静态资源的 PHP 解析若用队列异步处理订单、发邮件等任务用 Supervisor 常驻php artisan queue:work7️⃣ 性能避坑清单这6个坑占生产故障的九成#现象原因解决办法1报错Vite manifest not found未构建前端 / 误用npm run dev生产环境执行npm run build2商品图片显示裂图缺少存储软链接执行php artisan storage:link3报错页直接暴露代码路径APP_DEBUGtrue未关闭设为false并清配置缓存4改完.env不生效配置已被缓存执行php artisan config:clear5邮件/任务不执行队列仍是sync或 mail 未配置切换QUEUE_CONNECTION配置MAIL_*6站点可被匿名登录默认管理员adminexample.com / abc123上线后立即修改后台密码8️⃣ 部署后自检5分钟验证清单✅ 前台首页 200 正常商品列表/分类/品牌页面无样式错乱✅ 访问/admin登录后台商品、订单、Banner 管理入口正常✅ 商品图片、轮播图均能加载验证 storage 软链接✅ 用测试金额走一单 PayPal 或 Stripe 支付流程网关配置参考 config/services.php✅ 浏览器 F12 检查无 500 错误、无 debug 信息泄露✅ 确认.env文件权限为640且不在public/目录内可被访问小结Velstore 的生产部署核心就四步改.env→npm run build→ 开缓存 建软链接 → 改默认密码。按上面的避坑清单逐项过一遍90% 的部署故障都能提前拦截。祝你的多商户商城顺利上线【免费下载链接】velstoreFree and open-source multi-vendor Laravel eCommerce solution that is fully customizable and ready to use.项目地址: https://gitcode.com/gh_mirrors/ve/velstore创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考